seam 2.133.0 → 2.134.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: bb7fca448b6ccc8cda4ea8b19365646faea00d731221a22ac5bcc04a9448965c
-  data.tar.gz: cadee3c19b14602929d12e388fc9af7e88294734ece88b64eb4d81ed0159f206
+  metadata.gz: f3ffafcdfdbb5c40dc150484a2e283d55bf1cdd7685f0158a660c303c9719553
+  data.tar.gz: b9300c82c89d2c4b8056fdcb0b1cbb87c50c4df006de3fd8b06831b01d42930e
 SHA512:
-  metadata.gz: 610f1ddc0fa62ef6957bbdcad5ddc093f1a4a29a7d758f2df29eae8e8eee7dc323a59efff675f140a0e2d6d4f7c6fe3041610b6b379fedc09241ba35c420242d
-  data.tar.gz: 195a1e34533e3d32b846b42aad0aba9e61e5fed7f208b98074fbbf517fa611956781ad526cbb0faae8068f45d00670c839ee8d0cf779b651a6415ee0a77dc2f1
+  metadata.gz: f0c5dc998b88e2b814f86a386bdfe02ef41e31d95f07963a54e7ccbb8bb245ae8911896580f507d785abfef25f14b9d504ac1c437857390047174a4a0f6fc715
+  data.tar.gz: 7b37c256db254e40232840de248352a00c84d9bda655e244708784a405d498446f4ae4b91d4544323419e6f535781ba965a65b712b434da978814a09476bc743

data/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    seam (2.133.0)
+    seam (2.134.0)
       faraday (~> 2.7)
       faraday-retry (~> 2.2)
       svix (~> 1.30)

data/README.md

@@ -37,6 +37,7 @@ accurate and fully typed.
   - [Advanced Usage](#advanced-usage)
     - [Additional Options](#additional-options)
     - [Setting the endpoint](#setting-the-endpoint)
+    - [Setting the request timeout](#setting-the-request-timeout)
     - [Configuring the Faraday Client](#configuring-the-faraday-client)
     - [Using the Faraday Client](#using-the-faraday-client)
     - [Overriding the Client](#overriding-the-client)
@@ -381,6 +382,7 @@ the constructor takes some advanced options that affect behavior.
 seam = Seam.new(
   api_key: "your-api-key",
   endpoint: "https://example.com",
+  timeout: 30,
   faraday_options: {},
   faraday_retry_options: {}
 )
@@ -392,6 +394,7 @@ these options may be passed in as keyword arguments.
 ```ruby
 seam = Seam.from_api_key("some-api-key",
   endpoint: "https://example.com",
+  timeout: 30,
   faraday_options: {},
   faraday_retry_options: {})
 ```
@@ -403,6 +406,27 @@ e.g., testing or proxy setups. This option corresponds to the [Faraday](https://
 
 Either pass the `endpoint` option, or set the `SEAM_ENDPOINT` environment variable.
 
+#### Setting the request timeout
+
+Requests time out after 30 seconds by default.
+Pass the `timeout` option, in seconds, to override this:
+
+```ruby
+seam = Seam.new(api_key: "your-api-key", timeout: 60)
+```
+
+The value sets both the Faraday `timeout` and `open_timeout`.
+Either may be set independently via `faraday_options`, which takes precedence:
+
+```ruby
+seam = Seam.new(
+  api_key: "your-api-key",
+  faraday_options: {request: {timeout: 60, open_timeout: 5}}
+)
+```
+
+A request that exceeds the timeout raises `Faraday::TimeoutError`.
+
 #### Configuring the Faraday Client
 
 The Faraday client and retry behavior may be configured with custom initiation options

data/Rakefile

@@ -5,10 +5,7 @@ require "rspec/core/rake_task"
 require "standard/rake"
 
 RSpec::Core::RakeTask.new(:spec) do |t|
-  t.pattern = [
-    "spec/**/*_spec.rb",
-    "lib/seam/*_spec.rb"
-  ]
+  t.pattern = "spec/**/*_spec.rb"
 end
 
 task default: %i[lint test]

data/lib/seam/deep_hash_accessor.rb

@@ -13,6 +13,10 @@ module Seam
       instance_variable_get(:"@#{key}")
     end
 
+    def to_h
+      @data
+    end
+
     private
 
     def create_accessor_methods

data/lib/seam/{default_endpoint.rb → defaults.rb}

@@ -2,4 +2,6 @@
 
 module Seam
   DEFAULT_ENDPOINT = "https://connect.getseam.com"
+
+  DEFAULT_TIMEOUT = 30
 end

data/lib/seam/helpers/action_attempt.rb

@@ -6,14 +6,23 @@ module Seam
   module Helpers
     module ActionAttempt
       def self.decide_and_wait(action_attempt, client, wait_for_action_attempt)
-        if wait_for_action_attempt == true
-          return wait_until_finished(action_attempt, client)
-        elsif wait_for_action_attempt.is_a?(Hash)
-          return wait_until_finished(action_attempt, client, timeout: wait_for_action_attempt[:timeout],
-            polling_interval: wait_for_action_attempt[:polling_interval])
-        end
+        return wait_until_finished(action_attempt, client) if wait_for_action_attempt == true
 
-        action_attempt
+        options = wait_options(wait_for_action_attempt)
+        return action_attempt if options.nil?
+
+        wait_until_finished(action_attempt, client, timeout: options[:timeout],
+          polling_interval: options[:polling_interval])
+      end
+
+      # The client wraps its defaults in a DeepHashAccessor, so the hash form of
+      # this option reaches here as an accessor when it comes from the client
+      # and as a plain Hash when it comes from the method call.
+      def self.wait_options(wait_for_action_attempt)
+        case wait_for_action_attempt
+        when Hash then wait_for_action_attempt
+        when Seam::DeepHashAccessor then wait_for_action_attempt.to_h
+        end
       end
 
       def self.wait_until_finished(action_attempt, client, timeout: nil, polling_interval: nil)

data/lib/seam/http.rb

@@ -8,13 +8,14 @@ module Seam
       Http::SingleWorkspace.new(**args)
     end
 
-    def self.from_api_key(api_key, endpoint: nil, wait_for_action_attempt: false)
-      Http::SingleWorkspace.from_api_key(api_key, endpoint: endpoint, wait_for_action_attempt: wait_for_action_attempt)
+    def self.from_api_key(api_key, endpoint: nil, wait_for_action_attempt: true, timeout: nil)
+      Http::SingleWorkspace.from_api_key(api_key, endpoint: endpoint, wait_for_action_attempt: wait_for_action_attempt,
+        timeout: timeout)
     end
 
-    def self.from_personal_access_token(personal_access_token, workspace_id, endpoint: nil, wait_for_action_attempt: false)
+    def self.from_personal_access_token(personal_access_token, workspace_id, endpoint: nil, wait_for_action_attempt: true, timeout: nil)
       Http::SingleWorkspace.from_personal_access_token(personal_access_token, workspace_id, endpoint: endpoint,
-        wait_for_action_attempt: wait_for_action_attempt)
+        wait_for_action_attempt: wait_for_action_attempt, timeout: timeout)
     end
 
     class ApiError < StandardError

data/lib/seam/http_multi_workspace.rb

@@ -14,14 +14,14 @@ module Seam
     class MultiWorkspace
       attr_reader :client, :defaults
 
-      def initialize(personal_access_token:, endpoint: nil, wait_for_action_attempt: true, faraday_options: {},
-        faraday_retry_options: {})
+      def initialize(personal_access_token:, endpoint: nil, wait_for_action_attempt: true, timeout: nil,
+        faraday_options: {}, faraday_retry_options: {})
         @wait_for_action_attempt = wait_for_action_attempt
         @defaults = {"wait_for_action_attempt" => wait_for_action_attempt}
         @endpoint = Http::Options.get_endpoint(endpoint)
         @auth_headers = Http::Auth.get_auth_headers_for_multi_workspace_personal_access_token(personal_access_token)
         @client = Http::Request.create_faraday_client(@endpoint, @auth_headers, faraday_options,
-          faraday_retry_options)
+          faraday_retry_options, timeout: timeout)
       end
 
       def self.lts_version
@@ -36,11 +36,12 @@ module Seam
         @workspaces ||= WorkspacesProxy.new(Seam::Clients::Workspaces.new(client: @client, defaults: @defaults))
       end
 
-      def self.from_personal_access_token(personal_access_token, endpoint: nil, wait_for_action_attempt: true, faraday_options: {}, faraday_retry_options: {})
+      def self.from_personal_access_token(personal_access_token, endpoint: nil, wait_for_action_attempt: true, timeout: nil, faraday_options: {}, faraday_retry_options: {})
         new(
           personal_access_token: personal_access_token,
           endpoint: endpoint,
           wait_for_action_attempt: wait_for_action_attempt,
+          timeout: timeout,
           faraday_options: faraday_options,
           faraday_retry_options: faraday_retry_options
         )

data/lib/seam/http_single_workspace.rb

@@ -17,14 +17,20 @@ module Seam
       attr_reader :client, :defaults
 
       def initialize(client: nil, api_key: nil, personal_access_token: nil, workspace_id: nil, endpoint: nil,
-        wait_for_action_attempt: true, faraday_options: {}, faraday_retry_options: {})
-        options = Http::Options.parse_options(api_key: api_key, personal_access_token: personal_access_token,
-          workspace_id: workspace_id, endpoint: endpoint)
-        @endpoint = options[:endpoint]
-        @auth_headers = options[:auth_headers]
+        wait_for_action_attempt: true, timeout: nil, faraday_options: {}, faraday_retry_options: {})
         @defaults = Seam::DeepHashAccessor.new({"wait_for_action_attempt" => wait_for_action_attempt})
-        @client = client || Http::Request.create_faraday_client(@endpoint, @auth_headers, faraday_options,
-          faraday_retry_options)
+
+        # A client carries its own endpoint and authorization, so the auth
+        # options are only parsed when one has to be built.
+        @client = client || begin
+          options = Http::Options.parse_options(api_key: api_key, personal_access_token: personal_access_token,
+            workspace_id: workspace_id, endpoint: endpoint)
+          @endpoint = options[:endpoint]
+          @auth_headers = options[:auth_headers]
+
+          Http::Request.create_faraday_client(@endpoint, @auth_headers, faraday_options, faraday_retry_options,
+            timeout: timeout)
+        end
 
         initialize_routes(client: @client, defaults: @defaults)
       end
@@ -37,14 +43,14 @@ module Seam
         Paginator.new(request, params)
       end
 
-      def self.from_api_key(api_key, endpoint: nil, wait_for_action_attempt: false, faraday_options: {}, faraday_retry_options: {})
+      def self.from_api_key(api_key, endpoint: nil, wait_for_action_attempt: true, timeout: nil, faraday_options: {}, faraday_retry_options: {})
         new(api_key: api_key, endpoint: endpoint, wait_for_action_attempt: wait_for_action_attempt,
-          faraday_options: faraday_options, faraday_retry_options: faraday_retry_options)
+          timeout: timeout, faraday_options: faraday_options, faraday_retry_options: faraday_retry_options)
       end
 
-      def self.from_personal_access_token(personal_access_token, workspace_id, endpoint: nil, wait_for_action_attempt: false, faraday_options: {}, faraday_retry_options: {})
+      def self.from_personal_access_token(personal_access_token, workspace_id, endpoint: nil, wait_for_action_attempt: true, timeout: nil, faraday_options: {}, faraday_retry_options: {})
         new(personal_access_token: personal_access_token, workspace_id: workspace_id, endpoint: endpoint,
-          wait_for_action_attempt: wait_for_action_attempt, faraday_options: faraday_options, faraday_retry_options: faraday_retry_options)
+          wait_for_action_attempt: wait_for_action_attempt, timeout: timeout, faraday_options: faraday_options, faraday_retry_options: faraday_retry_options)
       end
     end
   end

data/lib/seam/options.rb

@@ -1,6 +1,6 @@
 # frozen_string_literal: true
 
-require_relative "default_endpoint"
+require_relative "defaults"
 
 module Seam
   module Http

data/lib/seam/request.rb

@@ -2,6 +2,7 @@
 
 require "faraday"
 require "faraday/retry"
+require_relative "defaults"
 require_relative "lts_version"
 require_relative "version"
 require_relative "paginator"
@@ -9,10 +10,15 @@ require_relative "paginator"
 module Seam
   module Http
     module Request
-      def self.create_faraday_client(endpoint, auth_headers, faraday_options = {}, faraday_retry_options = {})
+      def self.create_faraday_client(endpoint, auth_headers, faraday_options = {}, faraday_retry_options = {},
+        timeout: nil)
+        timeout ||= Seam::DEFAULT_TIMEOUT
+
         default_options = {
           url: endpoint,
-          headers: auth_headers.merge(default_headers)
+          headers: auth_headers.merge(default_headers),
+          # open_timeout bounds the connect phase, which timeout does not cover.
+          request: {timeout: timeout, open_timeout: timeout}
         }
 
         options = deep_merge(default_options, faraday_options)

data/lib/seam/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Seam
-  VERSION = "2.133.0"
+  VERSION = "2.134.0"
 end

data/lib/seam.rb

@@ -11,12 +11,13 @@ module Seam
     Seam::Http.new(**args)
   end
 
-  def self.from_api_key(api_key, endpoint: nil, wait_for_action_attempt: false)
-    Seam::Http.from_api_key(api_key, endpoint: endpoint, wait_for_action_attempt: wait_for_action_attempt)
+  def self.from_api_key(api_key, endpoint: nil, wait_for_action_attempt: true, timeout: nil)
+    Seam::Http.from_api_key(api_key, endpoint: endpoint, wait_for_action_attempt: wait_for_action_attempt,
+      timeout: timeout)
   end
 
-  def self.from_personal_access_token(personal_access_token, workspace_id, endpoint: nil, wait_for_action_attempt: false)
-    Seam::Http.from_personal_access_token(personal_access_token, workspace_id, endpoint: endpoint, wait_for_action_attempt: wait_for_action_attempt)
+  def self.from_personal_access_token(personal_access_token, workspace_id, endpoint: nil, wait_for_action_attempt: true, timeout: nil)
+    Seam::Http.from_personal_access_token(personal_access_token, workspace_id, endpoint: endpoint, wait_for_action_attempt: wait_for_action_attempt, timeout: timeout)
   end
 
   def self.lts_version

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: seam
 version: !ruby/object:Gem::Version
-  version: 2.133.0
+  version: 2.134.0
 platform: ruby
 authors:
 - Seam Labs, Inc.
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-07-29 00:00:00.000000000 Z
+date: 2026-08-11 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: faraday
@@ -193,7 +193,7 @@ files:
 - lib/seam/auth.rb
 - lib/seam/base_resource.rb
 - lib/seam/deep_hash_accessor.rb
-- lib/seam/default_endpoint.rb
+- lib/seam/defaults.rb
 - lib/seam/helpers/action_attempt.rb
 - lib/seam/http.rb
 - lib/seam/http_multi_workspace.rb