seam 2.135.0 → 2.137.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 63f28be81d1f91aac1e7e4a985619c5373c3c8f2cd5c9cb2c912353d5d11d784
-  data.tar.gz: 4b7a897a7b5baee78d66aa0041b5acbedb8dcf58360ffba672ec4f3d2ef16d41
+  metadata.gz: 127b82c7a575d44523d96d4f7abeb7f6e2c08a0ef31f0578fe1e215a197cbbd5
+  data.tar.gz: b7f55dea5261cbb03284de35dd1a1905db3f7caeacf31d64a25082882b5a1349
 SHA512:
-  metadata.gz: 64a11203850219014f1547cef7ddef4c6e5c0bd031e30f5bb5cd395307d9a62124adbf683adb85031e363289e12255c34b10afa68fb326bee673a614daf4f410
-  data.tar.gz: '09abde1c8cdcbd5dc21c0b823e704d940de7a3ef2fc80c9bb2ecf7cc0c59ae8c4d4adec11557b82735533a6ce335f504b1267f26a403ad8680c5cca49e6bd7b6'
+  metadata.gz: 33585716bb7d6d70c7936e5abd084414574eb9204a0ad728b57e94790972b5cc4a552ba145cf95c43d718eaae3febafd6ca3c52ebae88eba889f516e8d2af489
+  data.tar.gz: 153856dcd1afc01426ca4a6f00951c3231ae265963c1978c6ec5017d7b9e3a61269e91621f3d46ff01a50257422a8ec95d73a85d9739c6a8c82a93af0d13c50f

data/Gemfile.lock

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

data/README.md

@@ -32,7 +32,8 @@ accurate and fully typed.
     - [Resume pagination](#resume-pagination)
     - [Iterate over all resources](#iterate-over-all-resources)
     - [Return all resources across all pages as a list](#return-all-resources-across-all-pages-as-a-list)
-  - [Interacting with Multiple Workspaces](#interacting-with-multiple-workspaces)
+  - [Requests without a Workspace in scope](#requests-without-a-workspace-in-scope)
+    - [Personal Access Token](#personal-access-token-1)
   - [Webhooks](#webhooks)
   - [Advanced Usage](#advanced-usage)
     - [Additional Options](#additional-options)
@@ -120,6 +121,9 @@ Obtain one from the Seam Console.
 A workspace ID must be provided when using this method and all requests will be scoped to that workspace.
 
 ```ruby
+# Set the `SEAM_PERSONAL_ACCESS_TOKEN` and `SEAM_WORKSPACE_ID` environment variables
+seam = Seam.new
+
 # Pass as an option to the constructor
 seam = Seam.new(
   personal_access_token: "your-personal-access-token",
@@ -314,18 +318,30 @@ paginator = seam.create_paginator(seam.devices.method(:list), {limit: 20})
 all_devices = paginator.flatten_to_list
 ```
 
-### Interacting with Multiple Workspaces
+### Requests without a Workspace in scope
+
+Some Seam API endpoints do not require a workspace in scope.
+The `Seam::Http::WithoutWorkspace` client is not bound to a specific workspace
+and may use those endpoints with a personal access token authentication method.
 
-Some Seam API endpoints interact with multiple workspaces. The `Seam::Http::SeamMultiWorkspace` client is not bound to a specific workspace and may use those endpoints with a personal access token authentication method.
+#### Personal Access Token
 
-A Personal Access Token is scoped to a Seam Console user. Obtain one from the Seam Console.
+A Personal Access Token is scoped to a Seam Console user.
+Obtain one from the Seam Console.
 
 ```ruby
-# Pass as an option to the constructor
-seam = Seam::Http::SeamMultiWorkspace.new(personal_access_token: "your-personal-access-token")
+# Set the `SEAM_PERSONAL_ACCESS_TOKEN` environment variable
+seam = Seam::Http::WithoutWorkspace.new
+
+# Pass as a keyword argument to the constructor
+seam = Seam::Http::WithoutWorkspace.new(
+  personal_access_token: "your-personal-access-token"
+)
 
 # Use the factory method
-seam = Seam::Http::SeamMultiWorkspace.from_personal_access_token("your-personal-access-token")
+seam = Seam::Http::WithoutWorkspace.from_personal_access_token(
+  "your-personal-access-token"
+)
 
 # List workspaces authorized for this Personal Access Token
 workspaces = seam.workspaces.list

data/lib/seam/auth.rb

@@ -86,7 +86,7 @@ module Seam
         }
       end
 
-      def self.get_auth_headers_for_multi_workspace_personal_access_token(personal_access_token)
+      def self.get_auth_headers_for_without_workspace_personal_access_token(personal_access_token)
         if Auth.jwt?(personal_access_token)
           raise SeamInvalidTokenError.new(
             "A JWT cannot be used as a personal_access_token"

data/lib/seam/{http_multi_workspace.rb → http_without_workspace.rb}

@@ -11,15 +11,19 @@ require_relative "routes/routes"
 
 module Seam
   module Http
-    class MultiWorkspace
+    class WithoutWorkspace
       attr_reader :client, :defaults
 
-      def initialize(personal_access_token:, endpoint: nil, wait_for_action_attempt: true, timeout: nil,
+      def initialize(personal_access_token: nil, 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)
+
+        options = Http::Options.parse_without_workspace_options(personal_access_token: personal_access_token,
+          endpoint: endpoint)
+        @endpoint = options[:endpoint]
+        @auth_headers = options[:auth_headers]
+
         @client = Http::Request.create_faraday_client(@endpoint, @auth_headers, faraday_options,
           faraday_retry_options, timeout: timeout)
       end
@@ -36,7 +40,8 @@ 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, timeout: nil, 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,

data/lib/seam/parse_options.rb

@@ -7,7 +7,9 @@ module Seam
   module Http
     module Options
       def self.parse_options(api_key: nil, personal_access_token: nil, workspace_id: nil, endpoint: nil)
-        api_key ||= ENV["SEAM_API_KEY"] if personal_access_token.nil?
+        api_key ||= get_api_key_from_env(personal_access_token)
+        personal_access_token ||= get_personal_access_token_from_env(api_key)
+        workspace_id ||= ENV["SEAM_WORKSPACE_ID"]
 
         auth_headers = Http::Auth.get_auth_headers(
           api_key: api_key,
@@ -18,6 +20,48 @@ module Seam
 
         {auth_headers: auth_headers, endpoint: endpoint}
       end
+
+      def self.parse_without_workspace_options(personal_access_token: nil, endpoint: nil)
+        personal_access_token ||= ENV["SEAM_PERSONAL_ACCESS_TOKEN"]
+
+        if personal_access_token.nil?
+          raise SeamInvalidOptionsError.new(
+            "Must specify a personal_access_token. " \
+            "Attempted reading configuration from the environment, " \
+            "but the environment variable SEAM_PERSONAL_ACCESS_TOKEN is not set."
+          )
+        end
+
+        auth_headers = Http::Auth.get_auth_headers_for_without_workspace_personal_access_token(personal_access_token)
+        endpoint = Http::Options.get_endpoint(endpoint)
+
+        {auth_headers: auth_headers, endpoint: endpoint}
+      end
+
+      # A personal access token passed as an option takes precedence over the
+      # environment, so the environment is not consulted when one is given.
+      def self.get_api_key_from_env(personal_access_token)
+        return nil unless personal_access_token.nil?
+
+        api_key = ENV["SEAM_API_KEY"]
+
+        if api_key && ENV["SEAM_PERSONAL_ACCESS_TOKEN"]
+          raise SeamInvalidOptionsError.new(
+            "Both SEAM_API_KEY and SEAM_PERSONAL_ACCESS_TOKEN environment variables are defined. " \
+            "Please use only one authentication method."
+          )
+        end
+
+        api_key
+      end
+
+      # An api_key, whether passed as an option or read from the environment,
+      # takes precedence, so the environment is not consulted when one is set.
+      def self.get_personal_access_token_from_env(api_key)
+        return nil unless api_key.nil?
+
+        ENV["SEAM_PERSONAL_ACCESS_TOKEN"]
+      end
     end
   end
 end

data/lib/seam/version.rb

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

data/lib/seam.rb

@@ -2,7 +2,7 @@
 
 require_relative "seam/lts_version"
 require_relative "seam/http"
-require_relative "seam/http_multi_workspace"
+require_relative "seam/http_without_workspace"
 require_relative "seam/webhook"
 require_relative "seam/wait_for_action_attempt"
 

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: seam
 version: !ruby/object:Gem::Version
-  version: 2.135.0
+  version: 2.137.0
 platform: ruby
 authors:
 - Seam Labs, Inc.
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-08-12 00:00:00.000000000 Z
+date: 2026-08-13 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: faraday
@@ -196,8 +196,8 @@ files:
 - lib/seam/defaults.rb
 - lib/seam/helpers/action_attempt.rb
 - lib/seam/http.rb
-- lib/seam/http_multi_workspace.rb
 - lib/seam/http_single_workspace.rb
+- lib/seam/http_without_workspace.rb
 - lib/seam/lts_version.rb
 - lib/seam/options.rb
 - lib/seam/paginator.rb