seam 2.133.1 → 2.134.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 9cd822a95811c14500048401893ba903d42e4a5431bcfe6a038955beca50e22e
-  data.tar.gz: a4d7c7e7059b9cfb3a3a61395e9bb38d9f0768f3a8f389e3082d77ae3824e0ed
+  metadata.gz: f3ffafcdfdbb5c40dc150484a2e283d55bf1cdd7685f0158a660c303c9719553
+  data.tar.gz: b9300c82c89d2c4b8056fdcb0b1cbb87c50c4df006de3fd8b06831b01d42930e
 SHA512:
-  metadata.gz: 7b3078763143b252d99050c2397f6c71bd242d7971b95a514f104f3293a98a82b5369bde44e973051b4d36cd35491a542370bb8ba456813cbc418fe0a885981b
-  data.tar.gz: e2137dc8e0fa70965c73b9c92249ad067e5dfb0395bb8a4c7ed8346e7d6f7848dfff3ccf90e4e41268c4e634e5a643dbef6735274f9daab310736f3ff13a72b7
+  metadata.gz: f0c5dc998b88e2b814f86a386bdfe02ef41e31d95f07963a54e7ccbb8bb245ae8911896580f507d785abfef25f14b9d504ac1c437857390047174a4a0f6fc715
+  data.tar.gz: 7b37c256db254e40232840de248352a00c84d9bda655e244708784a405d498446f4ae4b91d4544323419e6f535781ba965a65b712b434da978814a09476bc743

data/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    seam (2.133.1)
+    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/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/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: true)
-      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: true)
+    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,7 +17,7 @@ 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: {})
+        wait_for_action_attempt: true, timeout: nil, faraday_options: {}, faraday_retry_options: {})
         @defaults = Seam::DeepHashAccessor.new({"wait_for_action_attempt" => wait_for_action_attempt})
 
         # A client carries its own endpoint and authorization, so the auth
@@ -28,7 +28,8 @@ module Seam
           @endpoint = options[:endpoint]
           @auth_headers = options[:auth_headers]
 
-          Http::Request.create_faraday_client(@endpoint, @auth_headers, faraday_options, faraday_retry_options)
+          Http::Request.create_faraday_client(@endpoint, @auth_headers, faraday_options, faraday_retry_options,
+            timeout: timeout)
         end
 
         initialize_routes(client: @client, defaults: @defaults)
@@ -42,14 +43,14 @@ module Seam
         Paginator.new(request, params)
       end
 
-      def self.from_api_key(api_key, endpoint: nil, wait_for_action_attempt: true, 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: true, 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.1"
+  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: true)
-    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: true)
-    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.1
+  version: 2.134.0
 platform: ruby
 authors:
 - Seam Labs, Inc.
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-08-06 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