@seamapi/nextlove-sdk-generator 1.5.5 → 1.5.7

package/src/lib/generate-ruby-sdk/ruby-client.ts

@@ -1,3 +1,5 @@
+import endpoints_returning_deprecated_action_attempt from "lib/endpoints-returning-deprecated-action-attempt.js"
+
 export type RubyClientMethodParameter = {
   name: string
   required?: boolean | undefined
@@ -8,18 +10,26 @@ export type RubyClientMethod = {
   method_name: string
   path: string
   parameters: RubyClientMethodParameter[]
-  return_resource: string
+  return_resource: string | null
   return_path: string
 }
 
+type ChildClientIdentifier = {
+  client_name: string
+  namespace: string
+}
+
 export class RubyClient {
   methods: RubyClientMethod[] = []
+  child_client_identifiers: ChildClientIdentifier[]
 
   constructor(
     public pascal_name: string,
-    public snake_name: string
+    public snake_name: string,
+    child_client_identifiers: ChildClientIdentifier[]
   ) {
     this.methods = []
+    this.child_client_identifiers = child_client_identifiers
   }
 
   addMethod(method: RubyClientMethod) {
@@ -43,13 +53,30 @@ export class RubyClient {
    */
   serialize() {
     return [
+      `# frozen_string_literal: true`,
+      ``,
       `module Seam`,
       `  module Clients`,
       `    class ${this.pascal_name} < BaseClient`,
+      ...this.child_client_identifiers.map(({ client_name, namespace }) =>
+        [
+          `def ${namespace}`,
+          `  @${namespace} ||= Seam::Clients::${client_name}.new(self)`,
+          `end`,
+          ``,
+        ]
+          .flatMap((s) => `      ${s}`)
+          .join("\n")
+      ),
       ...this.methods.map(
         ({ method_name, path, parameters, return_resource, return_path }) => {
+          const is_action_attempt_client = this.pascal_name === "ActionAttempts"
+          const can_method_poll_action_attempt =
+            !endpoints_returning_deprecated_action_attempt.includes(path) &&
+            !is_action_attempt_client &&
+            return_resource === "ActionAttempt"
+
           return [
-            " ",
             `def ${method_name}(${parameters
               .sort(
                 (a, b) =>
@@ -58,18 +85,26 @@ export class RubyClient {
               )
               .map((p) => `${p.name}${p.required ? "" : ": nil"}`)
               .join(", ")})`,
-            `  request_seam_object(`,
+            `  ${can_method_poll_action_attempt ? "action_attempt = " : ""}${
+              return_resource ? "request_seam_object" : "request_seam"
+            }(`,
             `    :post,`,
             `    "${path}",`,
-            `    ${return_resource},`,
-            `    '${return_path}',`,
+            return_resource ? `    Seam::${return_resource},` : [],
+            return_path ? `    '${return_path}',` : [],
             `    body: {${parameters
               .map((p) => `${p.name}: ${p.name}`)
               .join(", ")}}.compact`,
             `  )`,
+            `  ${
+              can_method_poll_action_attempt
+                ? "action_attempt.wait_until_finished\n        action_attempt"
+                : ""
+            }`,
             `end`,
+            ``,
           ]
-            .map((s) => `        ${s}`)
+            .flatMap((s) => `      ${s}`)
             .join("\n")
         }
       ),

package/src/lib/generate-ruby-sdk/templates/.rspec.template.ts

@@ -0,0 +1,3 @@
+export default () => `--format documentation
+--color
+--require spec_helper`

package/src/lib/generate-ruby-sdk/templates/.ruby-version.template.ts

@@ -0,0 +1 @@
+export default () => `3.0.4`

package/src/lib/generate-ruby-sdk/templates/base_resource.rb.template.ts

@@ -29,12 +29,12 @@ module Seam
     end
 
     def inspect
-      "<#{self.class.name}:#{"0x00%x" % (object_id << 1)}\n" + # rubocop:disable Style/StringConcatenation, Style/FormatString
+      "<#{self.class.name}:#{"0x00%x" % (object_id << 1)}\\n" + # rubocop:disable Style/StringConcatenation, Style/FormatString
         instance_variables
           .map { |k| k.to_s.sub("@", "") }
           .filter { |k| k != "data" and k != "client" and respond_to? k }
           .map { |k| "  #{k}=#{send(k).inspect}" }
-          .join("\n") + ">"
+          .join("\\n") + ">"
     end
 
     def self.date_accessor(*attrs)

package/src/lib/generate-ruby-sdk/templates/client.rb.template.ts

@@ -1,73 +1,62 @@
-export default () => `# frozen_string_literal: true
-
-module Seam
-  class Client
-    attr_accessor :api_key, :base_uri, :debug
-
-    def initialize(api_key: nil, base_uri: "https://connect.getseam.com", debug: false)
-      @api_key = api_key || ENV.fetch("SEAM_API_KEY", nil)
-      @base_uri = base_uri
-      @debug = debug
-
-      raise ArgumentError, "SEAM_API_KEY not found in environment, and api_key not provided" unless @api_key
-    end
-
-    def health
-      request_seam(:get, "/health")
-    end
-
-    def locks
-      @locks ||= Seam::Clients::Locks.new(self)
-    end
-
-    def devices
-      @devices ||= Seam::Clients::Devices.new(self)
-    end
-
-    def unmanaged_devices
-      @unmanaged_devices ||= Seam::Clients::UnmanagedDevices.new(self)
-    end
-
-    def action_attempts
-      @action_attempts ||= Seam::Clients::ActionAttempts.new(self)
-    end
-
-    def access_codes
-      @access_codes ||= Seam::Clients::AccessCodes.new(self)
-    end
-
-    def connect_webviews
-      @connect_webviews ||= Seam::Clients::ConnectWebviews.new(self)
-    end
-
-    def connected_accounts
-      @connected_accounts ||= Seam::Clients::ConnectedAccounts.new(self)
-    end
-
-    def workspaces
-      @workspaces ||= Seam::Clients::Workspaces.new(self)
-    end
-
-    def events
-      @events ||= Seam::Clients::Events.new(self)
-    end
-
-    def request_seam_object(method, path, klass, inner_object, config = {})
-      response = request_seam(method, path, config)
-
-      data = response[inner_object]
-
-      klass.load_from_response(data, self)
-    end
-
-    def request_seam(method, path, config = {})
-      Seam::Request.new(
-        api_key: api_key,
-        base_uri: base_uri,
-        debug: debug
-      ).perform(
-        method, path, config
-      )
-    end
-  end
-end`
+import { pascalCase } from "change-case"
+
+export default (resource_client_names: string[]) => {
+  const resource_client_defs = resource_client_names
+    .map((client_name) => {
+      return `
+      def ${client_name}
+        @${client_name} ||= Seam::Clients::${pascalCase(client_name)}.new(self)
+      end
+      `
+    })
+    .join("")
+
+  return `# frozen_string_literal: true
+
+  module Seam
+    class Client
+      attr_accessor :api_key, :base_uri, :debug
+  
+      def initialize(api_key: nil, base_uri: "https://connect.getseam.com", debug: false)
+        @api_key = api_key || ENV.fetch("SEAM_API_KEY", nil)
+        @base_uri = base_uri
+        @debug = debug
+  
+        raise ArgumentError, "SEAM_API_KEY not found in environment, and api_key not provided" unless @api_key
+      end
+      ${resource_client_defs}
+  
+      # @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(self)
+      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(self)
+      end
+  
+      def request_seam_object(method, path, klass, inner_object, config = {})
+        response = request_seam(method, path, config)
+  
+        data = response[inner_object]
+  
+        klass.load_from_response(data, self)
+      end
+  
+      def request_seam(method, path, config = {})
+        Seam::Request.new(
+          api_key: api_key,
+          base_uri: base_uri,
+          debug: debug
+        ).perform(
+          method, path, config
+        )
+      end
+    end
+  end`
+}

package/src/lib/generate-ruby-sdk/templates/request.rb.template.ts

@@ -45,7 +45,7 @@ module Seam
       code = response.status.code
 
       if code >= 400 && code < 500 && (err = response.parse["error"])
-        msg = "Api Error #{err["type"]}\nrequest_id: #{err["request_id"]}\n#{err["message"]}"
+        msg = "Api Error #{err["type"]}\\nrequest_id: #{err["request_id"]}\\n#{err["message"]}"
       end
 
       raise Error.new(msg, code, response)

package/src/lib/generate-ruby-sdk/templates/resource_error.rb.template.ts

@@ -3,5 +3,7 @@ export default () => `# frozen_string_literal: true
 module Seam
   class ResourceError < BaseResource
     attr_accessor :error_code, :message
+
+    date_accessor :created_at
   end
 end`

package/src/lib/generate-ruby-sdk/templates/resource_warning.rb.template.ts

@@ -3,5 +3,7 @@ export default () => `# frozen_string_literal: true
 module Seam
   class ResourceWarning < BaseResource
     attr_accessor :warning_code, :message
+
+    date_accessor :created_at
   end
 end`

package/src/lib/generate-ruby-sdk/templates/seamapi.gemspec.template.ts

@@ -6,7 +6,7 @@ Gem::Specification.new do |spec|
   spec.name = "seamapi"
   spec.version = Seam::VERSION
   spec.author = "Seam Labs, Inc."
-  spec.email = "support@getseam.com"
+  spec.email = "devops@getseam.com"
 
   spec.summary = "Seam API Ruby SDK"
   spec.description = "Official interface to the Seam Connect API."
@@ -26,7 +26,7 @@ Gem::Specification.new do |spec|
   spec.files = Dir["lib/**/*.rb"]
   spec.files += Dir["[A-Z]*"]
 
-  spec.add_dependency "http", "~> 5.0.0"
+  spec.add_dependency "http", "~> 5.0"
 
   spec.add_development_dependency "bundler", "~> 2.0"
   spec.add_development_dependency "gem-release", "~> 2.2"

package/src/lib/generate-ruby-sdk/templates/snippets/action-attempt-helpers-template.ts

@@ -0,0 +1,27 @@
+export default () => `SLEEP_TIME = 0.2
+    MAX_ATTEMPTS = 10
+
+    def wait_until_finished
+      attempts = 0
+      while @status == "pending"
+        update!
+        sleep(SLEEP_TIME)
+        attempts += 1
+      end
+
+      raise "Timed out waiting for action attempt to finish" if attempts >= MAX_ATTEMPTS
+
+      self
+    end
+
+    def update!
+      response = @client.request_seam(
+        :post,
+        "/action_attempts/get",
+        body: {
+          action_attempt_id: action_attempt_id
+        }
+      )
+
+      update_from_response(response["action_attempt"])
+    end`

package/src/lib/generate-ruby-sdk/templates/snippets/resource.rb.template.ts

@@ -1,3 +1,5 @@
+import actionAttemptHelpersTemplate from "./action-attempt-helpers-template.js"
+
 export default ({
   pascal_name,
   attrs,
@@ -6,19 +8,42 @@ export default ({
   pascal_name: string
   attrs: string[]
   date_attrs: string[]
-}) => `# frozen_string_literal: true
+}) => {
+  const no_error_warning_attrs = attrs.filter(
+    (attr) => attr !== "errors" && attr !== "warnings"
+  )
+  const has_warnings_attr = attrs.includes("warnings")
+  const has_errors_attr = attrs.includes("errors")
+
+  const attr_accessors = no_error_warning_attrs
+    .map((attr) => `:${attr}`)
+    .join(", ")
+  const date_accessors =
+    date_attrs.length > 0
+      ? `date_accessor ${date_attrs.map((attr) => `:${attr}`).join(", ")}`
+      : ""
+
+  const resource_errors_support = has_errors_attr
+    ? "include Seam::ResourceErrorsSupport"
+    : ""
+  const resource_warnings_support = has_warnings_attr
+    ? "include Seam::ResourceWarningsSupport"
+    : ""
+
+  const is_action_attempt_resource = pascal_name === "ActionAttempt"
+
+  return `# frozen_string_literal: true
 
 module Seam
   class ${pascal_name} < BaseResource
-    attr_reader ${attrs.map((attr) => `:${attr}`).join(", ")}
+    attr_accessor ${attr_accessors}
+
+    ${date_accessors}
 
-    ${
-      date_attrs.length > 0
-        ? `date_accessor ${date_attrs.map((attr) => `:${attr}`).join(", ")}`
-        : ""
-    }
+    ${resource_errors_support}
+    ${resource_warnings_support}
 
-    include Seam::ResourceErrorsSupport
-    include Seam::ResourceWarningsSupport
+      ${is_action_attempt_resource ? actionAttemptHelpersTemplate() : ""}
   end
 end`
+}

package/src/lib/generate-ruby-sdk/templates/spec_helper.rb.template.ts

@@ -0,0 +1,28 @@
+export default () => `# frozen_string_literal: true
+
+require "simplecov"
+require "simplecov-console"
+
+SimpleCov.start
+
+require "seamapi"
+require "webmock/rspec"
+
+require_relative "support/helpers"
+
+SimpleCov.formatter = SimpleCov::Formatter::MultiFormatter.new([
+  SimpleCov::Formatter::HTMLFormatter,
+  SimpleCov::Formatter::Console
+])
+
+RSpec.configure do |config|
+  config.example_status_persistence_file_path = ".rspec_status"
+
+  config.disable_monkey_patching!
+
+  config.expect_with :rspec do |c|
+    c.syntax = :expect
+  end
+
+  config.include Helpers
+end`

package/src/lib/generate-ruby-sdk/templates/support-helpers.rb.template.ts

@@ -0,0 +1,11 @@
+export default () => `# frozen_string_literal: true
+
+module Helpers
+  def stub_seam_request(method, path, response, status: 200, headers: {})
+    stub_request(
+      method,
+      "https://connect.getseam.com#{path}"
+    ).to_return(status: status, body: response.to_json,
+      headers: {"Content-Type" => "application/json"}.merge(headers))
+  end
+end`

package/src/lib/generate-ruby-sdk/templates/version.rb.template.ts

@@ -1,5 +1,5 @@
 export default () => `# frozen_string_literal: true
 
 module Seam
-  VERSION = "1.11.2"
+  VERSION = "1.16.1"
 end`

package/src/lib/openapi/map-parent-to-children-resource.ts

@@ -1,8 +1,6 @@
 import type { Route } from "lib/types.js"
 
-const mapParentToChildrenResources = (
-  routes: Route[]
-): Record<string, string[]> =>
+const mapParentToChildResources = (routes: Route[]): Record<string, string[]> =>
   routes.reduce((acc: Record<string, string[]>, route) => {
     if (!route.post?.["x-fern-sdk-group-name"]) return acc
 
@@ -25,4 +23,4 @@ const mapParentToChildrenResources = (
     return acc
   }, {})
 
-export default mapParentToChildrenResources
+export default mapParentToChildResources