Migrate Ruby SDK route generation to Metalsmith-based codegen (#524)

Replace the @seamapi/nextlove-sdk-generator pipeline with the Metalsmith +
Handlebars + @seamapi/blueprint architecture used by seamapi/javascript-http
and seamapi/docs.

The blueprint drives route/endpoint/namespace iteration; the raw OpenAPI spec
is still consulted wherever the previous generator derived output from data the
blueprint normalizes differently. Those spots, and the verbatim helper ports
that back them, are marked with TODO/TEMPORARY banners so they can migrate to
blueprint once the generated output is allowed to change.

Generated output under lib/seam/routes is byte-identical after `rake format`.

- Add codegen/ (smith entry, Metalsmith plugin, layout context builders,
  Handlebars templates/partials, and TEMPORARY parity helpers)
- Pin @seamapi/blueprint 0.55.0, add @seamapi/smith and change-case; drop
  @seamapi/nextlove-sdk-generator and del
- Add tsconfig.json, eslint.config.ts, .prettierignore; wire typecheck/lint
  scripts; gitignore the generated root CODEGEN.md
- Remove generate-routes.js


Claude-Session: https://claude.ai/code/session_016XEpBuyVgLx5jvB4zygya6

Co-authored-by: Claude <noreply@anthropic.com>

Author: razor-x

.gitignore

@@ -5,6 +5,9 @@
 # For more details, visit the project page:
 # https://github.com/github/gitignore
 
+# Codegen
+CODEGEN.md
+
 # rspec failure tracking
 .rspec_status
 

.prettierignore

@@ -0,0 +1,4 @@
+# Prettier exceptions
+
+*.hbs
+CODEGEN.md

codegen/content/CODEGEN.md

@@ -0,0 +1 @@
+# Codegen

codegen/index.ts

@@ -0,0 +1 @@
+export default null

codegen/layouts/client.hbs

@@ -0,0 +1,26 @@
+# frozen_string_literal: true
+{{#if importActionAttempt}}
+
+require "seam/helpers/action_attempt"
+{{/if}}
+
+module Seam
+  module Clients
+    class {{className}}
+      def initialize(client:, defaults:)
+        @client = client
+        @defaults = defaults
+      end
+{{#each childClients}}
+
+      def {{namespace}}
+        @{{namespace}} ||= Seam::Clients::{{clientName}}.new(client: @client, defaults: @defaults)
+      end
+{{/each}}
+{{#each methods}}
+
+{{> client-method}}
+{{/each}}
+    end
+  end
+end

codegen/layouts/default.hbs

@@ -0,0 +1 @@
+{{contents}}

codegen/layouts/imports.hbs

@@ -0,0 +1,8 @@
+# frozen_string_literal: true
+
+{{#each customImports}}
+{{this}}
+{{/each}}
+{{#each requires}}
+require_relative "{{this}}"
+{{/each}}

codegen/layouts/partials/client-method.hbs

@@ -0,0 +1,17 @@
+      def {{name}}{{#if hasSignature}}({{signatureParams}}){{/if}}
+        {{#if usesRes}}res = {{/if}}@client.post("{{path}}"{{#if hasParams}}, {{bodyParams}}.compact{{/if}})
+{{#if isResource}}
+
+        Seam::Resources::{{returnResource}}.load_from_response(res.body["{{returnPath}}"])
+{{/if}}
+{{#if isPoll}}
+
+        wait_for_action_attempt = wait_for_action_attempt.nil? ? @defaults.wait_for_action_attempt : wait_for_action_attempt
+
+        Helpers::ActionAttempt.decide_and_wait(Seam::Resources::ActionAttempt.load_from_response(res.body["{{returnPath}}"]), @client, wait_for_action_attempt)
+{{/if}}
+{{#if isNil}}
+
+        nil
+{{/if}}
+      end

codegen/layouts/resource.hbs

@@ -0,0 +1,22 @@
+# frozen_string_literal: true
+
+module Seam
+  module Resources
+    class {{className}} < BaseResource
+      attr_accessor {{attrAccessors}}
+{{#if hasDateAccessors}}
+
+      date_accessor {{dateAccessors}}
+{{/if}}
+{{#if hasSupportModules}}
+
+{{#if includeErrorsSupport}}
+      include Seam::Resources::ResourceErrorsSupport
+{{/if}}
+{{#if includeWarningsSupport}}
+      include Seam::Resources::ResourceWarningsSupport
+{{/if}}
+{{/if}}
+    end
+  end
+end

codegen/layouts/routes.hbs

@@ -0,0 +1,32 @@
+# frozen_string_literal: true
+
+module Seam
+  module Routes
+{{#each routeClients}}
+    def {{name}}
+      @{{name}} ||= Seam::Clients::{{className}}.new(client: @client, defaults: @defaults)
+    end
+
+{{/each}}
+    # @deprecated Please use {#devices.unmanaged} instead.
+    def unmanaged_devices
+      warn "[DEPRECATION] 'unmanaged_devices' is deprecated. Please use 'devices.unmanaged' instead."
+
+      @unmanaged_devices ||= Seam::Clients::DevicesUnmanaged.new(client: @client, defaults: @defaults)
+    end
+
+    # @deprecated Please use {#access_codes.unmanaged} instead.
+    def unmanaged_access_codes
+      warn "[DEPRECATION] 'unmanaged_access_codes' is deprecated. Please use 'access_codes.unmanaged' instead."
+
+      @unmanaged_access_codes ||= Seam::Clients::AccessCodesUnmanaged.new(client: @client, defaults: @defaults)
+    end
+
+    private
+
+    def initialize_routes(client:, defaults:)
+      @client = client
+      @defaults = defaults
+    end
+  end
+end