straddle 0.2.0 → 0.3.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: bd6a208e41cae35818c5b73da6eea68f300efe8558ca6e148ce0b6564a89a9ea
-  data.tar.gz: 8c4db4234dfd2f4991d261c31dfd6cc98baefafb3b42b137858abc054477f128
+  metadata.gz: 3e5e80a1c1b53b3a5f149984bc7e7fbb1ae782caee1a4c9683ffcb96559733a7
+  data.tar.gz: 376d8c6d7ee586b2d7e61dad2947fae516565306f9ad6d4754273c38568bfa8d
 SHA512:
-  metadata.gz: 1439876ed4778c79dd1088bed876cf236f441c616f4b67e229e1e2854b0535b02a0db5f1fa0ab6190b0ae8e1f268ae8a7d330ef6c3e5c84ae4bc6fdf4707185a
-  data.tar.gz: 29c6b8fc541b1a42da83ebbfb372bb6a2fd6aabb6b2803277f11c40fd4c2933afed19e11ecfc87b37590ccd444e031ec58780f95c4d2ed5a1bdfd44b9ef3a55c
+  metadata.gz: 57024a8ac2cbc21595f1d7eb0896f367273cda63b109d206fe0ef5168f8eb9c91bf47550c509c5b74bac8ff745366678acd1a433566d67278cc780c4698f1a24
+  data.tar.gz: 7128242298fe0136fdbaa3b3e87ead934ba990d6bf99aed938229b034cd90e903a8fb51989dd8cd89c1eb53ae9d70411547aad962c7812898e966fde32292bc3

data/CHANGELOG.md

@@ -1,5 +1,28 @@
 # Changelog
 
+## 0.3.0 (2025-11-16)
+
+Full Changelog: [v0.2.0...v0.3.0](https://github.com/straddleio/straddle-ruby/compare/v0.2.0...v0.3.0)
+
+### Features
+
+* **api:** manual updates ([c048e53](https://github.com/straddleio/straddle-ruby/commit/c048e539bb7e3851302e4ddbd166a58fb593a52b))
+* **docs:** Preliminary update to SDK Spec ([8d573e9](https://github.com/straddleio/straddle-ruby/commit/8d573e9c1d39e407dae8a1ec8cc716c0e86a8b46))
+* handle thread interrupts in the core HTTP client ([0e8ff22](https://github.com/straddleio/straddle-ruby/commit/0e8ff229d3f4e5bb905f807338896f8999cc1f44))
+
+
+### Bug Fixes
+
+* absolutely qualified uris should always override the default ([9ec59a0](https://github.com/straddleio/straddle-ruby/commit/9ec59a081f213bbef52a0deb0e05229f047ec4b3))
+* better thread safety via early initializing SSL store during HTTP client creation ([44dd717](https://github.com/straddleio/straddle-ruby/commit/44dd7179fdf7a912e6c0df4016cd7976ceaaa3f9))
+* should not reuse buffers for `IO.copy_stream` interop ([ab1134b](https://github.com/straddleio/straddle-ruby/commit/ab1134bebd96319b18959ef961f303b7fa92cf18))
+
+
+### Chores
+
+* bump dependency version and update sorbet types ([19ed027](https://github.com/straddleio/straddle-ruby/commit/19ed0274aeb5f8303d0170817a1520591c6e484b))
+* ignore linter error for tests having large collections ([bc64eef](https://github.com/straddleio/straddle-ruby/commit/bc64eefa88be0777031542098b605f2677a8c29f))
+
 ## 0.2.0 (2025-10-08)
 
 Full Changelog: [v0.1.1...v0.2.0](https://github.com/straddleio/straddle-ruby/compare/v0.1.1...v0.2.0)

data/README.md

@@ -17,7 +17,7 @@ To use this gem, install via Bundler by adding the following to your application
 <!-- x-release-please-start-version -->
 
 ```ruby
-gem "straddle", "~> 0.2.0"
+gem "straddle", "~> 0.3.0"
 ```
 
 <!-- x-release-please-end -->

data/lib/straddle/internal/transport/base_client.rb

@@ -201,7 +201,8 @@ module Straddle
             self.class::PLATFORM_HEADERS,
             {
               "accept" => "application/json",
-              "content-type" => "application/json"
+              "content-type" => "application/json",
+              "user-agent" => user_agent
             },
             headers
           )
@@ -219,6 +220,11 @@ module Straddle
         # @return [Hash{String=>String}]
         private def auth_headers = {}
 
+        # @api private
+        #
+        # @return [String]
+        private def user_agent = "#{self.class.name}/Ruby #{Straddle::VERSION}"
+
         # @api private
         #
         # @return [String]

data/lib/straddle/internal/transport/pooled_net_requester.rb

@@ -16,10 +16,11 @@ module Straddle
         class << self
           # @api private
           #
+          # @param cert_store [OpenSSL::X509::Store]
           # @param url [URI::Generic]
           #
           # @return [Net::HTTP]
-          def connect(url)
+          def connect(cert_store:, url:)
             port =
               case [url.port, url.scheme]
               in [Integer, _]
@@ -33,6 +34,8 @@ module Straddle
             Net::HTTP.new(url.host, port).tap do
               _1.use_ssl = %w[https wss].include?(url.scheme)
               _1.max_retries = 0
+
+              (_1.cert_store = cert_store) if _1.use_ssl?
             end
           end
 
@@ -102,7 +105,7 @@ module Straddle
           pool =
             @mutex.synchronize do
               @pools[origin] ||= ConnectionPool.new(size: @size) do
-                self.class.connect(url)
+                self.class.connect(cert_store: @cert_store, url: url)
               end
             end
 
@@ -128,40 +131,48 @@ module Straddle
           url, deadline = request.fetch_values(:url, :deadline)
 
           req = nil
-          eof = false
           finished = false
-          closing = nil
 
           # rubocop:disable Metrics/BlockLength
           enum = Enumerator.new do |y|
             next if finished
 
             with_pool(url, deadline: deadline) do |conn|
-              req, closing = self.class.build_request(request) do
-                self.class.calibrate_socket_timeout(conn, deadline)
-              end
-
-              self.class.calibrate_socket_timeout(conn, deadline)
-              unless conn.started?
-                conn.keep_alive_timeout = self.class::KEEP_ALIVE_TIMEOUT
-                conn.start
-              end
+              eof = false
+              closing = nil
+              ::Thread.handle_interrupt(Object => :never) do
+                ::Thread.handle_interrupt(Object => :immediate) do
+                  req, closing = self.class.build_request(request) do
+                    self.class.calibrate_socket_timeout(conn, deadline)
+                  end
 
-              self.class.calibrate_socket_timeout(conn, deadline)
-              conn.request(req) do |rsp|
-                y << [req, rsp]
-                break if finished
-
-                rsp.read_body do |bytes|
-                  y << bytes.force_encoding(Encoding::BINARY)
-                  break if finished
+                  self.class.calibrate_socket_timeout(conn, deadline)
+                  unless conn.started?
+                    conn.keep_alive_timeout = self.class::KEEP_ALIVE_TIMEOUT
+                    conn.start
+                  end
 
                   self.class.calibrate_socket_timeout(conn, deadline)
+                  conn.request(req) do |rsp|
+                    y << [req, rsp]
+                    break if finished
+
+                    rsp.read_body do |bytes|
+                      y << bytes.force_encoding(Encoding::BINARY)
+                      break if finished
+
+                      self.class.calibrate_socket_timeout(conn, deadline)
+                    end
+                    eof = true
+                  end
+                end
+              ensure
+                begin
+                  conn.finish if !eof && conn&.started?
+                ensure
+                  closing&.call
                 end
-                eof = true
               end
-            ensure
-              conn.finish if !eof && conn&.started?
             end
           rescue Timeout::Error
             raise Straddle::Errors::APITimeoutError.new(url: url, request: req)
@@ -174,8 +185,6 @@ module Straddle
           body = Straddle::Internal::Util.fused_enum(enum, external: true) do
             finished = true
             loop { enum.next }
-          ensure
-            closing&.call
           end
           [Integer(response.code), response, body]
         end
@@ -186,6 +195,7 @@ module Straddle
         def initialize(size: self.class::DEFAULT_MAX_CONNECTIONS)
           @mutex = Mutex.new
           @size = size
+          @cert_store = OpenSSL::X509::Store.new.tap(&:set_default_paths)
           @pools = {}
         end
 

data/lib/straddle/internal/util.rb

@@ -346,8 +346,9 @@ module Straddle
           base_path, base_query = lhs.fetch_values(:path, :query)
           slashed = base_path.end_with?("/") ? base_path : "#{base_path}/"
 
-          parsed_path, parsed_query = parse_uri(rhs.fetch(:path)).fetch_values(:path, :query)
-          override = URI::Generic.build(**rhs.slice(:scheme, :host, :port), path: parsed_path)
+          merged = {**parse_uri(rhs.fetch(:path)), **rhs.except(:path, :query)}
+          parsed_path, parsed_query = merged.fetch_values(:path, :query)
+          override = URI::Generic.build(**merged.slice(:scheme, :host, :port), path: parsed_path)
 
           joined = URI.join(URI::Generic.build(lhs.except(:path, :query)), slashed, override)
           query = deep_merge(
@@ -473,10 +474,9 @@ module Straddle
         # @return [Enumerable<String>]
         def writable_enum(&blk)
           Enumerator.new do |y|
-            buf = String.new
             y.define_singleton_method(:write) do
-              self << buf.replace(_1)
-              buf.bytesize
+              self << _1.dup
+              _1.bytesize
             end
 
             blk.call(y)

data/lib/straddle/models/bridge/link_bank_account_params.rb

@@ -36,6 +36,13 @@ module Straddle
         #   @return [Straddle::Models::Bridge::LinkBankAccountParams::Config, nil]
         optional :config, -> { Straddle::Bridge::LinkBankAccountParams::Config }
 
+        # @!attribute external_id
+        #   Unique identifier for the paykey in your database, used for cross-referencing
+        #   between Straddle and your systems.
+        #
+        #   @return [String, nil]
+        optional :external_id, String, nil?: true
+
         # @!attribute metadata
         #   Up to 20 additional user-defined key-value pairs. Useful for storing additional
         #   information about the paykey in a structured format.
@@ -63,7 +70,7 @@ module Straddle
         #   @return [String, nil]
         optional :straddle_account_id, String
 
-        # @!method initialize(account_number:, account_type:, customer_id:, routing_number:, config: nil, metadata: nil, correlation_id: nil, idempotency_key: nil, request_id: nil, straddle_account_id: nil, request_options: {})
+        # @!method initialize(account_number:, account_type:, customer_id:, routing_number:, config: nil, external_id: nil, metadata: nil, correlation_id: nil, idempotency_key: nil, request_id: nil, straddle_account_id: nil, request_options: {})
         #   Some parameter documentations has been truncated, see
         #   {Straddle::Models::Bridge::LinkBankAccountParams} for more details.
         #
@@ -77,6 +84,8 @@ module Straddle
         #
         #   @param config [Straddle::Models::Bridge::LinkBankAccountParams::Config]
         #
+        #   @param external_id [String, nil] Unique identifier for the paykey in your database, used for cross-referencing be
+        #
         #   @param metadata [Hash{Symbol=>String}, nil] Up to 20 additional user-defined key-value pairs. Useful for storing additional
         #
         #   @param correlation_id [String]
@@ -100,14 +109,33 @@ module Straddle
         end
 
         class Config < Straddle::Internal::Type::BaseModel
+          # @!attribute processing_method
+          #
+          #   @return [Symbol, Straddle::Models::Bridge::LinkBankAccountParams::Config::ProcessingMethod, nil]
+          optional :processing_method,
+                   enum: -> { Straddle::Bridge::LinkBankAccountParams::Config::ProcessingMethod }
+
           # @!attribute sandbox_outcome
           #
           #   @return [Symbol, Straddle::Models::Bridge::LinkBankAccountParams::Config::SandboxOutcome, nil]
           optional :sandbox_outcome, enum: -> { Straddle::Bridge::LinkBankAccountParams::Config::SandboxOutcome }
 
-          # @!method initialize(sandbox_outcome: nil)
+          # @!method initialize(processing_method: nil, sandbox_outcome: nil)
+          #   @param processing_method [Symbol, Straddle::Models::Bridge::LinkBankAccountParams::Config::ProcessingMethod]
           #   @param sandbox_outcome [Symbol, Straddle::Models::Bridge::LinkBankAccountParams::Config::SandboxOutcome]
 
+          # @see Straddle::Models::Bridge::LinkBankAccountParams::Config#processing_method
+          module ProcessingMethod
+            extend Straddle::Internal::Type::Enum
+
+            INLINE = :inline
+            BACKGROUND = :background
+            SKIP = :skip
+
+            # @!method self.values
+            #   @return [Array<Symbol>]
+          end
+
           # @see Straddle::Models::Bridge::LinkBankAccountParams::Config#sandbox_outcome
           module SandboxOutcome
             extend Straddle::Internal::Type::Enum
@@ -115,6 +143,7 @@ module Straddle
             STANDARD = :standard
             ACTIVE = :active
             REJECTED = :rejected
+            REVIEW = :review
 
             # @!method self.values
             #   @return [Array<Symbol>]

data/lib/straddle/models/bridge/link_create_paykey_params.rb

@@ -26,6 +26,13 @@ module Straddle
         #   @return [Straddle::Models::Bridge::LinkCreatePaykeyParams::Config, nil]
         optional :config, -> { Straddle::Bridge::LinkCreatePaykeyParams::Config }
 
+        # @!attribute external_id
+        #   Unique identifier for the paykey in your database, used for cross-referencing
+        #   between Straddle and your systems.
+        #
+        #   @return [String, nil]
+        optional :external_id, String, nil?: true
+
         # @!attribute metadata
         #   Up to 20 additional user-defined key-value pairs. Useful for storing additional
         #   information about the paykey in a structured format.
@@ -53,7 +60,7 @@ module Straddle
         #   @return [String, nil]
         optional :straddle_account_id, String
 
-        # @!method initialize(customer_id:, quiltt_token:, config: nil, metadata: nil, correlation_id: nil, idempotency_key: nil, request_id: nil, straddle_account_id: nil, request_options: {})
+        # @!method initialize(customer_id:, quiltt_token:, config: nil, external_id: nil, metadata: nil, correlation_id: nil, idempotency_key: nil, request_id: nil, straddle_account_id: nil, request_options: {})
         #   Some parameter documentations has been truncated, see
         #   {Straddle::Models::Bridge::LinkCreatePaykeyParams} for more details.
         #
@@ -63,6 +70,8 @@ module Straddle
         #
         #   @param config [Straddle::Models::Bridge::LinkCreatePaykeyParams::Config]
         #
+        #   @param external_id [String, nil] Unique identifier for the paykey in your database, used for cross-referencing be
+        #
         #   @param metadata [Hash{Symbol=>String}, nil] Up to 20 additional user-defined key-value pairs. Useful for storing additional
         #
         #   @param correlation_id [String]
@@ -76,14 +85,33 @@ module Straddle
         #   @param request_options [Straddle::RequestOptions, Hash{Symbol=>Object}]
 
         class Config < Straddle::Internal::Type::BaseModel
+          # @!attribute processing_method
+          #
+          #   @return [Symbol, Straddle::Models::Bridge::LinkCreatePaykeyParams::Config::ProcessingMethod, nil]
+          optional :processing_method,
+                   enum: -> { Straddle::Bridge::LinkCreatePaykeyParams::Config::ProcessingMethod }
+
           # @!attribute sandbox_outcome
           #
           #   @return [Symbol, Straddle::Models::Bridge::LinkCreatePaykeyParams::Config::SandboxOutcome, nil]
           optional :sandbox_outcome, enum: -> { Straddle::Bridge::LinkCreatePaykeyParams::Config::SandboxOutcome }
 
-          # @!method initialize(sandbox_outcome: nil)
+          # @!method initialize(processing_method: nil, sandbox_outcome: nil)
+          #   @param processing_method [Symbol, Straddle::Models::Bridge::LinkCreatePaykeyParams::Config::ProcessingMethod]
           #   @param sandbox_outcome [Symbol, Straddle::Models::Bridge::LinkCreatePaykeyParams::Config::SandboxOutcome]
 
+          # @see Straddle::Models::Bridge::LinkCreatePaykeyParams::Config#processing_method
+          module ProcessingMethod
+            extend Straddle::Internal::Type::Enum
+
+            INLINE = :inline
+            BACKGROUND = :background
+            SKIP = :skip
+
+            # @!method self.values
+            #   @return [Array<Symbol>]
+          end
+
           # @see Straddle::Models::Bridge::LinkCreatePaykeyParams::Config#sandbox_outcome
           module SandboxOutcome
             extend Straddle::Internal::Type::Enum
@@ -91,6 +119,7 @@ module Straddle
             STANDARD = :standard
             ACTIVE = :active
             REJECTED = :rejected
+            REVIEW = :review
 
             # @!method self.values
             #   @return [Array<Symbol>]

data/lib/straddle/models/bridge/link_create_paykey_response.rb

@@ -109,6 +109,13 @@ module Straddle
           #   @return [Time, nil]
           optional :expires_at, Time, nil?: true
 
+          # @!attribute external_id
+          #   Unique identifier for the paykey in your database, used for cross-referencing
+          #   between Straddle and your systems.
+          #
+          #   @return [String, nil]
+          optional :external_id, String, nil?: true
+
           # @!attribute institution_name
           #   Name of the financial institution.
           #
@@ -127,7 +134,7 @@ module Straddle
           #   @return [Straddle::Models::Bridge::LinkCreatePaykeyResponse::Data::StatusDetails, nil]
           optional :status_details, -> { Straddle::Models::Bridge::LinkCreatePaykeyResponse::Data::StatusDetails }
 
-          # @!method initialize(id:, config:, created_at:, label:, paykey:, source:, status:, updated_at:, balance: nil, bank_data: nil, customer_id: nil, expires_at: nil, institution_name: nil, metadata: nil, status_details: nil)
+          # @!method initialize(id:, config:, created_at:, label:, paykey:, source:, status:, updated_at:, balance: nil, bank_data: nil, customer_id: nil, expires_at: nil, external_id: nil, institution_name: nil, metadata: nil, status_details: nil)
           #   Some parameter documentations has been truncated, see
           #   {Straddle::Models::Bridge::LinkCreatePaykeyResponse::Data} for more details.
           #
@@ -155,6 +162,8 @@ module Straddle
           #
           #   @param expires_at [Time, nil] Expiration date and time of the paykey, if applicable.
           #
+          #   @param external_id [String, nil] Unique identifier for the paykey in your database, used for cross-referencing be
+          #
           #   @param institution_name [String, nil] Name of the financial institution.
           #
           #   @param metadata [Hash{Symbol=>String}, nil] Up to 20 additional user-defined key-value pairs. Useful for storing additional
@@ -163,15 +172,34 @@ module Straddle
 
           # @see Straddle::Models::Bridge::LinkCreatePaykeyResponse::Data#config
           class Config < Straddle::Internal::Type::BaseModel
+            # @!attribute processing_method
+            #
+            #   @return [Symbol, Straddle::Models::Bridge::LinkCreatePaykeyResponse::Data::Config::ProcessingMethod, nil]
+            optional :processing_method,
+                     enum: -> { Straddle::Models::Bridge::LinkCreatePaykeyResponse::Data::Config::ProcessingMethod }
+
             # @!attribute sandbox_outcome
             #
             #   @return [Symbol, Straddle::Models::Bridge::LinkCreatePaykeyResponse::Data::Config::SandboxOutcome, nil]
             optional :sandbox_outcome,
                      enum: -> { Straddle::Models::Bridge::LinkCreatePaykeyResponse::Data::Config::SandboxOutcome }
 
-            # @!method initialize(sandbox_outcome: nil)
+            # @!method initialize(processing_method: nil, sandbox_outcome: nil)
+            #   @param processing_method [Symbol, Straddle::Models::Bridge::LinkCreatePaykeyResponse::Data::Config::ProcessingMethod]
             #   @param sandbox_outcome [Symbol, Straddle::Models::Bridge::LinkCreatePaykeyResponse::Data::Config::SandboxOutcome]
 
+            # @see Straddle::Models::Bridge::LinkCreatePaykeyResponse::Data::Config#processing_method
+            module ProcessingMethod
+              extend Straddle::Internal::Type::Enum
+
+              INLINE = :inline
+              BACKGROUND = :background
+              SKIP = :skip
+
+              # @!method self.values
+              #   @return [Array<Symbol>]
+            end
+
             # @see Straddle::Models::Bridge::LinkCreatePaykeyResponse::Data::Config#sandbox_outcome
             module SandboxOutcome
               extend Straddle::Internal::Type::Enum
@@ -179,6 +207,7 @@ module Straddle
               STANDARD = :standard
               ACTIVE = :active
               REJECTED = :rejected
+              REVIEW = :review
 
               # @!method self.values
               #   @return [Array<Symbol>]

data/lib/straddle/models/bridge/link_create_tan_params.rb

@@ -36,6 +36,13 @@ module Straddle
         #   @return [Straddle::Models::Bridge::LinkCreateTanParams::Config, nil]
         optional :config, -> { Straddle::Bridge::LinkCreateTanParams::Config }
 
+        # @!attribute external_id
+        #   Unique identifier for the paykey in your database, used for cross-referencing
+        #   between Straddle and your systems.
+        #
+        #   @return [String, nil]
+        optional :external_id, String, nil?: true
+
         # @!attribute metadata
         #   Up to 20 additional user-defined key-value pairs. Useful for storing additional
         #   information about the paykey in a structured format.
@@ -63,7 +70,7 @@ module Straddle
         #   @return [String, nil]
         optional :straddle_account_id, String
 
-        # @!method initialize(account_type:, customer_id:, routing_number:, tan:, config: nil, metadata: nil, correlation_id: nil, idempotency_key: nil, request_id: nil, straddle_account_id: nil, request_options: {})
+        # @!method initialize(account_type:, customer_id:, routing_number:, tan:, config: nil, external_id: nil, metadata: nil, correlation_id: nil, idempotency_key: nil, request_id: nil, straddle_account_id: nil, request_options: {})
         #   Some parameter documentations has been truncated, see
         #   {Straddle::Models::Bridge::LinkCreateTanParams} for more details.
         #
@@ -77,6 +84,8 @@ module Straddle
         #
         #   @param config [Straddle::Models::Bridge::LinkCreateTanParams::Config]
         #
+        #   @param external_id [String, nil] Unique identifier for the paykey in your database, used for cross-referencing be
+        #
         #   @param metadata [Hash{Symbol=>String}, nil] Up to 20 additional user-defined key-value pairs. Useful for storing additional
         #
         #   @param correlation_id [String]
@@ -100,14 +109,32 @@ module Straddle
         end
 
         class Config < Straddle::Internal::Type::BaseModel
+          # @!attribute processing_method
+          #
+          #   @return [Symbol, Straddle::Models::Bridge::LinkCreateTanParams::Config::ProcessingMethod, nil]
+          optional :processing_method, enum: -> { Straddle::Bridge::LinkCreateTanParams::Config::ProcessingMethod }
+
           # @!attribute sandbox_outcome
           #
           #   @return [Symbol, Straddle::Models::Bridge::LinkCreateTanParams::Config::SandboxOutcome, nil]
           optional :sandbox_outcome, enum: -> { Straddle::Bridge::LinkCreateTanParams::Config::SandboxOutcome }
 
-          # @!method initialize(sandbox_outcome: nil)
+          # @!method initialize(processing_method: nil, sandbox_outcome: nil)
+          #   @param processing_method [Symbol, Straddle::Models::Bridge::LinkCreateTanParams::Config::ProcessingMethod]
           #   @param sandbox_outcome [Symbol, Straddle::Models::Bridge::LinkCreateTanParams::Config::SandboxOutcome]
 
+          # @see Straddle::Models::Bridge::LinkCreateTanParams::Config#processing_method
+          module ProcessingMethod
+            extend Straddle::Internal::Type::Enum
+
+            INLINE = :inline
+            BACKGROUND = :background
+            SKIP = :skip
+
+            # @!method self.values
+            #   @return [Array<Symbol>]
+          end
+
           # @see Straddle::Models::Bridge::LinkCreateTanParams::Config#sandbox_outcome
           module SandboxOutcome
             extend Straddle::Internal::Type::Enum
@@ -115,6 +142,7 @@ module Straddle
             STANDARD = :standard
             ACTIVE = :active
             REJECTED = :rejected
+            REVIEW = :review
 
             # @!method self.values
             #   @return [Array<Symbol>]

data/lib/straddle/models/bridge/link_create_tan_response.rb

@@ -109,6 +109,13 @@ module Straddle
           #   @return [Time, nil]
           optional :expires_at, Time, nil?: true
 
+          # @!attribute external_id
+          #   Unique identifier for the paykey in your database, used for cross-referencing
+          #   between Straddle and your systems.
+          #
+          #   @return [String, nil]
+          optional :external_id, String, nil?: true
+
           # @!attribute institution_name
           #   Name of the financial institution.
           #
@@ -127,7 +134,7 @@ module Straddle
           #   @return [Straddle::Models::Bridge::LinkCreateTanResponse::Data::StatusDetails, nil]
           optional :status_details, -> { Straddle::Models::Bridge::LinkCreateTanResponse::Data::StatusDetails }
 
-          # @!method initialize(id:, config:, created_at:, label:, paykey:, source:, status:, updated_at:, balance: nil, bank_data: nil, customer_id: nil, expires_at: nil, institution_name: nil, metadata: nil, status_details: nil)
+          # @!method initialize(id:, config:, created_at:, label:, paykey:, source:, status:, updated_at:, balance: nil, bank_data: nil, customer_id: nil, expires_at: nil, external_id: nil, institution_name: nil, metadata: nil, status_details: nil)
           #   Some parameter documentations has been truncated, see
           #   {Straddle::Models::Bridge::LinkCreateTanResponse::Data} for more details.
           #
@@ -155,6 +162,8 @@ module Straddle
           #
           #   @param expires_at [Time, nil] Expiration date and time of the paykey, if applicable.
           #
+          #   @param external_id [String, nil] Unique identifier for the paykey in your database, used for cross-referencing be
+          #
           #   @param institution_name [String, nil] Name of the financial institution.
           #
           #   @param metadata [Hash{Symbol=>String}, nil] Up to 20 additional user-defined key-value pairs. Useful for storing additional
@@ -163,15 +172,34 @@ module Straddle
 
           # @see Straddle::Models::Bridge::LinkCreateTanResponse::Data#config
           class Config < Straddle::Internal::Type::BaseModel
+            # @!attribute processing_method
+            #
+            #   @return [Symbol, Straddle::Models::Bridge::LinkCreateTanResponse::Data::Config::ProcessingMethod, nil]
+            optional :processing_method,
+                     enum: -> { Straddle::Models::Bridge::LinkCreateTanResponse::Data::Config::ProcessingMethod }
+
             # @!attribute sandbox_outcome
             #
             #   @return [Symbol, Straddle::Models::Bridge::LinkCreateTanResponse::Data::Config::SandboxOutcome, nil]
             optional :sandbox_outcome,
                      enum: -> { Straddle::Models::Bridge::LinkCreateTanResponse::Data::Config::SandboxOutcome }
 
-            # @!method initialize(sandbox_outcome: nil)
+            # @!method initialize(processing_method: nil, sandbox_outcome: nil)
+            #   @param processing_method [Symbol, Straddle::Models::Bridge::LinkCreateTanResponse::Data::Config::ProcessingMethod]
             #   @param sandbox_outcome [Symbol, Straddle::Models::Bridge::LinkCreateTanResponse::Data::Config::SandboxOutcome]
 
+            # @see Straddle::Models::Bridge::LinkCreateTanResponse::Data::Config#processing_method
+            module ProcessingMethod
+              extend Straddle::Internal::Type::Enum
+
+              INLINE = :inline
+              BACKGROUND = :background
+              SKIP = :skip
+
+              # @!method self.values
+              #   @return [Array<Symbol>]
+            end
+
             # @see Straddle::Models::Bridge::LinkCreateTanResponse::Data::Config#sandbox_outcome
             module SandboxOutcome
               extend Straddle::Internal::Type::Enum
@@ -179,6 +207,7 @@ module Straddle
               STANDARD = :standard
               ACTIVE = :active
               REJECTED = :rejected
+              REVIEW = :review
 
               # @!method self.values
               #   @return [Array<Symbol>]

data/lib/straddle/models/bridge/link_plaid_params.rb

@@ -26,6 +26,13 @@ module Straddle
         #   @return [Straddle::Models::Bridge::LinkPlaidParams::Config, nil]
         optional :config, -> { Straddle::Bridge::LinkPlaidParams::Config }
 
+        # @!attribute external_id
+        #   Unique identifier for the paykey in your database, used for cross-referencing
+        #   between Straddle and your systems.
+        #
+        #   @return [String, nil]
+        optional :external_id, String, nil?: true
+
         # @!attribute metadata
         #   Up to 20 additional user-defined key-value pairs. Useful for storing additional
         #   information about the paykey in a structured format.
@@ -53,7 +60,7 @@ module Straddle
         #   @return [String, nil]
         optional :straddle_account_id, String
 
-        # @!method initialize(customer_id:, plaid_token:, config: nil, metadata: nil, correlation_id: nil, idempotency_key: nil, request_id: nil, straddle_account_id: nil, request_options: {})
+        # @!method initialize(customer_id:, plaid_token:, config: nil, external_id: nil, metadata: nil, correlation_id: nil, idempotency_key: nil, request_id: nil, straddle_account_id: nil, request_options: {})
         #   Some parameter documentations has been truncated, see
         #   {Straddle::Models::Bridge::LinkPlaidParams} for more details.
         #
@@ -63,6 +70,8 @@ module Straddle
         #
         #   @param config [Straddle::Models::Bridge::LinkPlaidParams::Config]
         #
+        #   @param external_id [String, nil] Unique identifier for the paykey in your database, used for cross-referencing be
+        #
         #   @param metadata [Hash{Symbol=>String}, nil] Up to 20 additional user-defined key-value pairs. Useful for storing additional
         #
         #   @param correlation_id [String]
@@ -76,14 +85,32 @@ module Straddle
         #   @param request_options [Straddle::RequestOptions, Hash{Symbol=>Object}]
 
         class Config < Straddle::Internal::Type::BaseModel
+          # @!attribute processing_method
+          #
+          #   @return [Symbol, Straddle::Models::Bridge::LinkPlaidParams::Config::ProcessingMethod, nil]
+          optional :processing_method, enum: -> { Straddle::Bridge::LinkPlaidParams::Config::ProcessingMethod }
+
           # @!attribute sandbox_outcome
           #
           #   @return [Symbol, Straddle::Models::Bridge::LinkPlaidParams::Config::SandboxOutcome, nil]
           optional :sandbox_outcome, enum: -> { Straddle::Bridge::LinkPlaidParams::Config::SandboxOutcome }
 
-          # @!method initialize(sandbox_outcome: nil)
+          # @!method initialize(processing_method: nil, sandbox_outcome: nil)
+          #   @param processing_method [Symbol, Straddle::Models::Bridge::LinkPlaidParams::Config::ProcessingMethod]
           #   @param sandbox_outcome [Symbol, Straddle::Models::Bridge::LinkPlaidParams::Config::SandboxOutcome]
 
+          # @see Straddle::Models::Bridge::LinkPlaidParams::Config#processing_method
+          module ProcessingMethod
+            extend Straddle::Internal::Type::Enum
+
+            INLINE = :inline
+            BACKGROUND = :background
+            SKIP = :skip
+
+            # @!method self.values
+            #   @return [Array<Symbol>]
+          end
+
           # @see Straddle::Models::Bridge::LinkPlaidParams::Config#sandbox_outcome
           module SandboxOutcome
             extend Straddle::Internal::Type::Enum
@@ -91,6 +118,7 @@ module Straddle
             STANDARD = :standard
             ACTIVE = :active
             REJECTED = :rejected
+            REVIEW = :review
 
             # @!method self.values
             #   @return [Array<Symbol>]