straddle 0.2.0 → 0.3.0

data/rbi/straddle/models/paykeys/review_refresh_review_params.rbi

@@ -0,0 +1,76 @@
+# typed: strong
+
+module Straddle
+  module Models
+    module Paykeys
+      class ReviewRefreshReviewParams < Straddle::Internal::Type::BaseModel
+        extend Straddle::Internal::Type::RequestParameters::Converter
+        include Straddle::Internal::Type::RequestParameters
+
+        OrHash =
+          T.type_alias do
+            T.any(
+              Straddle::Paykeys::ReviewRefreshReviewParams,
+              Straddle::Internal::AnyHash
+            )
+          end
+
+        sig { returns(T.nilable(String)) }
+        attr_reader :correlation_id
+
+        sig { params(correlation_id: String).void }
+        attr_writer :correlation_id
+
+        sig { returns(T.nilable(String)) }
+        attr_reader :idempotency_key
+
+        sig { params(idempotency_key: String).void }
+        attr_writer :idempotency_key
+
+        sig { returns(T.nilable(String)) }
+        attr_reader :request_id
+
+        sig { params(request_id: String).void }
+        attr_writer :request_id
+
+        sig { returns(T.nilable(String)) }
+        attr_reader :straddle_account_id
+
+        sig { params(straddle_account_id: String).void }
+        attr_writer :straddle_account_id
+
+        sig do
+          params(
+            correlation_id: String,
+            idempotency_key: String,
+            request_id: String,
+            straddle_account_id: String,
+            request_options: Straddle::RequestOptions::OrHash
+          ).returns(T.attached_class)
+        end
+        def self.new(
+          correlation_id: nil,
+          idempotency_key: nil,
+          request_id: nil,
+          straddle_account_id: nil,
+          request_options: {}
+        )
+        end
+
+        sig do
+          override.returns(
+            {
+              correlation_id: String,
+              idempotency_key: String,
+              request_id: String,
+              straddle_account_id: String,
+              request_options: Straddle::RequestOptions
+            }
+          )
+        end
+        def to_hash
+        end
+      end
+    end
+  end
+end

data/rbi/straddle/models/payment_summary_paged_v1.rbi

@@ -132,6 +132,10 @@ module Straddle
         sig { params(status_details: Straddle::StatusDetailsV1::OrHash).void }
         attr_writer :status_details
 
+        # Trace ids.
+        sig { returns(T::Hash[Symbol, String]) }
+        attr_accessor :trace_ids
+
         # The time the `charge` or `payout` was last updated.
         sig { returns(Time) }
         attr_accessor :updated_at
@@ -178,6 +182,7 @@ module Straddle
               Straddle::PaymentSummaryPagedV1::Data::PaymentType::OrSymbol,
             status: Straddle::PaymentSummaryPagedV1::Data::Status::OrSymbol,
             status_details: Straddle::StatusDetailsV1::OrHash,
+            trace_ids: T::Hash[Symbol, String],
             updated_at: Time,
             customer_details: Straddle::CustomerDetailsV1::OrHash,
             effective_at: T.nilable(Time),
@@ -213,6 +218,8 @@ module Straddle
           status:,
           # Details about the current status of the `charge` or `payout`.
           status_details:,
+          # Trace ids.
+          trace_ids:,
           # The time the `charge` or `payout` was last updated.
           updated_at:,
           # Information about the customer associated with the charge or payout.
@@ -246,6 +253,7 @@ module Straddle
               status:
                 Straddle::PaymentSummaryPagedV1::Data::Status::TaggedSymbol,
               status_details: Straddle::StatusDetailsV1,
+              trace_ids: T::Hash[Symbol, String],
               updated_at: Time,
               customer_details: Straddle::CustomerDetailsV1,
               effective_at: T.nilable(Time),

data/rbi/straddle/models.rbi

@@ -35,8 +35,6 @@ module Straddle
 
   CustomerListParams = Straddle::Models::CustomerListParams
 
-  CustomerRefreshReviewParams = Straddle::Models::CustomerRefreshReviewParams
-
   Customers = Straddle::Models::Customers
 
   CustomerSummaryPagedV1 = Straddle::Models::CustomerSummaryPagedV1
@@ -75,7 +73,7 @@ module Straddle
 
   PaykeyRevealParams = Straddle::Models::PaykeyRevealParams
 
-  PaykeyReviewParams = Straddle::Models::PaykeyReviewParams
+  Paykeys = Straddle::Models::Paykeys
 
   PaykeySummaryPagedV1 = Straddle::Models::PaykeySummaryPagedV1
 
@@ -83,6 +81,8 @@ module Straddle
 
   PaykeyUnmaskedV1 = Straddle::Models::PaykeyUnmaskedV1
 
+  PaykeyUpdateBalanceParams = Straddle::Models::PaykeyUpdateBalanceParams
+
   PaykeyV1 = Straddle::Models::PaykeyV1
 
   PaymentListParams = Straddle::Models::PaymentListParams

data/rbi/straddle/resources/bridge/link.rbi

@@ -15,6 +15,7 @@ module Straddle
             customer_id: String,
             routing_number: String,
             config: Straddle::Bridge::LinkBankAccountParams::Config::OrHash,
+            external_id: T.nilable(String),
             metadata: T.nilable(T::Hash[Symbol, String]),
             correlation_id: String,
             idempotency_key: String,
@@ -34,6 +35,9 @@ module Straddle
           routing_number:,
           # Body param:
           config: nil,
+          # Body param: Unique identifier for the paykey in your database, used for
+          # cross-referencing between Straddle and your systems.
+          external_id: nil,
           # Body param: Up to 20 additional user-defined key-value pairs. Useful for storing
           # additional information about the paykey in a structured format.
           metadata: nil,
@@ -59,6 +63,7 @@ module Straddle
             customer_id: String,
             quiltt_token: String,
             config: Straddle::Bridge::LinkCreatePaykeyParams::Config::OrHash,
+            external_id: T.nilable(String),
             metadata: T.nilable(T::Hash[Symbol, String]),
             correlation_id: String,
             idempotency_key: String,
@@ -75,6 +80,9 @@ module Straddle
           quiltt_token:,
           # Body param:
           config: nil,
+          # Body param: Unique identifier for the paykey in your database, used for
+          # cross-referencing between Straddle and your systems.
+          external_id: nil,
           # Body param: Up to 20 additional user-defined key-value pairs. Useful for storing
           # additional information about the paykey in a structured format.
           metadata: nil,
@@ -100,6 +108,7 @@ module Straddle
             routing_number: String,
             tan: String,
             config: Straddle::Bridge::LinkCreateTanParams::Config::OrHash,
+            external_id: T.nilable(String),
             metadata: T.nilable(T::Hash[Symbol, String]),
             correlation_id: String,
             idempotency_key: String,
@@ -119,6 +128,9 @@ module Straddle
           tan:,
           # Body param:
           config: nil,
+          # Body param: Unique identifier for the paykey in your database, used for
+          # cross-referencing between Straddle and your systems.
+          external_id: nil,
           # Body param: Up to 20 additional user-defined key-value pairs. Useful for storing
           # additional information about the paykey in a structured format.
           metadata: nil,
@@ -144,6 +156,7 @@ module Straddle
             customer_id: String,
             plaid_token: String,
             config: Straddle::Bridge::LinkPlaidParams::Config::OrHash,
+            external_id: T.nilable(String),
             metadata: T.nilable(T::Hash[Symbol, String]),
             correlation_id: String,
             idempotency_key: String,
@@ -160,6 +173,9 @@ module Straddle
           plaid_token:,
           # Body param:
           config: nil,
+          # Body param: Unique identifier for the paykey in your database, used for
+          # cross-referencing between Straddle and your systems.
+          external_id: nil,
           # Body param: Up to 20 additional user-defined key-value pairs. Useful for storing
           # additional information about the paykey in a structured format.
           metadata: nil,

data/rbi/straddle/resources/bridge.rbi

@@ -11,6 +11,7 @@ module Straddle
         params(
           customer_id: String,
           config: Straddle::BridgeInitializeParams::Config::OrHash,
+          external_id: T.nilable(String),
           correlation_id: String,
           idempotency_key: String,
           request_id: String,
@@ -24,6 +25,9 @@ module Straddle
         customer_id:,
         # Body param:
         config: nil,
+        # Body param: Unique identifier for the paykey in your database, used for
+        # cross-referencing between Straddle and your systems.
+        external_id: nil,
         # Header param: Optional client generated identifier to trace and debug a series
         # of requests.
         correlation_id: nil,

data/rbi/straddle/resources/customers/review.rbi

@@ -68,6 +68,33 @@ module Straddle
         )
         end
 
+        # Updates the decision of a customer's identity validation. This endpoint allows
+        # you to modify the outcome of a customer decision and is useful for correcting or
+        # updating the status of a customer's verification.
+        sig do
+          params(
+            id: String,
+            correlation_id: String,
+            idempotency_key: String,
+            request_id: String,
+            straddle_account_id: String,
+            request_options: Straddle::RequestOptions::OrHash
+          ).returns(Straddle::CustomerV1)
+        end
+        def refresh_review(
+          id,
+          # Optional client generated identifier to trace and debug a series of requests.
+          correlation_id: nil,
+          # Optional client generated value to use for idempotent requests.
+          idempotency_key: nil,
+          # Optional client generated identifier to trace and debug a request.
+          request_id: nil,
+          # For use by platforms to specify an account id and set scope of a request.
+          straddle_account_id: nil,
+          request_options: {}
+        )
+        end
+
         # @api private
         sig { params(client: Straddle::Client).returns(T.attached_class) }
         def self.new(client:)

data/rbi/straddle/resources/customers.rbi

@@ -257,33 +257,6 @@ module Straddle
       )
       end
 
-      # Updates the decision of a customer's identity validation. This endpoint allows
-      # you to modify the outcome of a customer decision and is useful for correcting or
-      # updating the status of a customer's verification.
-      sig do
-        params(
-          id: String,
-          correlation_id: String,
-          idempotency_key: String,
-          request_id: String,
-          straddle_account_id: String,
-          request_options: Straddle::RequestOptions::OrHash
-        ).returns(Straddle::CustomerV1)
-      end
-      def refresh_review(
-        id,
-        # Optional client generated identifier to trace and debug a series of requests.
-        correlation_id: nil,
-        # Optional client generated value to use for idempotent requests.
-        idempotency_key: nil,
-        # Optional client generated identifier to trace and debug a request.
-        request_id: nil,
-        # For use by platforms to specify an account id and set scope of a request.
-        straddle_account_id: nil,
-        request_options: {}
-      )
-      end
-
       # Retrieves the unmasked details, including PII, of an existing customer. Supply
       # the unique customer ID that was returned from your 'create customer' request,
       # and Straddle will return the corresponding customer information. This endpoint

data/rbi/straddle/resources/embed/linked_bank_accounts.rbi

@@ -101,9 +101,13 @@ module Straddle
               Straddle::Embed::LinkedBankAccountListParams::Level::OrSymbol,
             page_number: Integer,
             page_size: Integer,
+            purpose:
+              Straddle::Embed::LinkedBankAccountListParams::Purpose::OrSymbol,
             sort_by: String,
             sort_order:
               Straddle::Embed::LinkedBankAccountListParams::SortOrder::OrSymbol,
+            status:
+              Straddle::Embed::LinkedBankAccountListParams::Status::OrSymbol,
             correlation_id: String,
             request_id: String,
             request_options: Straddle::RequestOptions::OrHash
@@ -122,10 +126,16 @@ module Straddle
           page_number: nil,
           # Query param: Page size. Max value: 1000
           page_size: nil,
+          # Query param: The purpose of the linked bank accounts to return. Possible values:
+          # 'charges', 'payouts', 'billing'.
+          purpose: nil,
           # Query param: Sort By.
           sort_by: nil,
           # Query param: Sort Order.
           sort_order: nil,
+          # Query param: The status of the linked bank accounts to return. Possible values:
+          # 'created', 'onboarding', 'active', 'inactive', 'rejected'.
+          status: nil,
           # Header param: Optional client generated identifier to trace and debug a series
           # of requests.
           correlation_id: nil,

data/rbi/straddle/resources/funding_events.rbi

@@ -13,6 +13,7 @@ module Straddle
           event_type: Straddle::FundingEventListParams::EventType::OrSymbol,
           page_number: Integer,
           page_size: Integer,
+          search_text: T.nilable(String),
           sort_by: Straddle::FundingEventListParams::SortBy::OrSymbol,
           sort_order: Straddle::FundingEventListParams::SortOrder::OrSymbol,
           trace_number: T.nilable(String),
@@ -43,6 +44,8 @@ module Straddle
         page_number: nil,
         # Query param: Results page size. Max value: 1000
         page_size: nil,
+        # Query param: Search text.
+        search_text: nil,
         # Query param: The field to sort the results by.
         sort_by: nil,
         # Query param: The order in which to sort the results.

data/rbi/straddle/resources/paykeys/review.rbi

@@ -0,0 +1,94 @@
+# typed: strong
+
+module Straddle
+  module Resources
+    class Paykeys
+      class Review
+        # Update the status of a paykey when in review status
+        sig do
+          params(
+            id: String,
+            status: Straddle::Paykeys::ReviewDecisionParams::Status::OrSymbol,
+            correlation_id: String,
+            idempotency_key: String,
+            request_id: String,
+            straddle_account_id: String,
+            request_options: Straddle::RequestOptions::OrHash
+          ).returns(Straddle::PaykeyV1)
+        end
+        def decision(
+          # Path param:
+          id,
+          # Body param:
+          status:,
+          # Header param: Optional client generated identifier to trace and debug a series
+          # of requests.
+          correlation_id: nil,
+          # Header param: Optional client generated value to use for idempotent requests.
+          idempotency_key: nil,
+          # Header param: Optional client generated identifier to trace and debug a request.
+          request_id: nil,
+          # Header param: For use by platforms to specify an account id and set scope of a
+          # request.
+          straddle_account_id: nil,
+          request_options: {}
+        )
+        end
+
+        # Get additional details about a paykey.
+        sig do
+          params(
+            id: String,
+            correlation_id: String,
+            request_id: String,
+            straddle_account_id: String,
+            request_options: Straddle::RequestOptions::OrHash
+          ).returns(Straddle::Models::Paykeys::ReviewGetResponse)
+        end
+        def get(
+          id,
+          # Optional client generated identifier to trace and debug a series of requests.
+          correlation_id: nil,
+          # Optional client generated identifier to trace and debug a request.
+          request_id: nil,
+          # For use by platforms to specify an account id and set scope of a request.
+          straddle_account_id: nil,
+          request_options: {}
+        )
+        end
+
+        # Updates the decision of a paykey's review validation. This endpoint allows you
+        # to refresh the outcome of a paykey's decision and is useful for correcting or
+        # updating the status of a paykey's verification.
+        sig do
+          params(
+            id: String,
+            correlation_id: String,
+            idempotency_key: String,
+            request_id: String,
+            straddle_account_id: String,
+            request_options: Straddle::RequestOptions::OrHash
+          ).returns(Straddle::PaykeyV1)
+        end
+        def refresh_review(
+          id,
+          # Optional client generated identifier to trace and debug a series of requests.
+          correlation_id: nil,
+          # Optional client generated value to use for idempotent requests.
+          idempotency_key: nil,
+          # Optional client generated identifier to trace and debug a request.
+          request_id: nil,
+          # For use by platforms to specify an account id and set scope of a request.
+          straddle_account_id: nil,
+          request_options: {}
+        )
+        end
+
+        # @api private
+        sig { params(client: Straddle::Client).returns(T.attached_class) }
+        def self.new(client:)
+        end
+      end
+    end
+  end
+end

data/rbi/straddle/resources/paykeys.rbi

@@ -3,6 +3,9 @@
 module Straddle
   module Resources
     class Paykeys
+      sig { returns(Straddle::Resources::Paykeys::Review) }
+      attr_reader :review
+
       # Returns a list of paykeys associated with a Straddle account. This endpoint
       # supports advanced sorting and filtering options.
       sig do
@@ -130,54 +133,49 @@ module Straddle
       )
       end
 
-      # Update the status of a paykey when in review status
+      # Retrieves the unmasked details of an existing paykey. Supply the unique paykey
+      # `id` and Straddle will return the corresponding paykey record, including the
+      # unmasked bank account details. This endpoint needs to be enabled by Straddle for
+      # your account and should only be used when absolutely necessary.
       sig do
         params(
           id: String,
-          status: Straddle::PaykeyReviewParams::Status::OrSymbol,
           correlation_id: String,
-          idempotency_key: String,
           request_id: String,
           straddle_account_id: String,
           request_options: Straddle::RequestOptions::OrHash
-        ).returns(Straddle::PaykeyV1)
+        ).returns(Straddle::PaykeyUnmaskedV1)
       end
-      def review(
-        # Path param:
+      def unmasked(
         id,
-        # Body param:
-        status:,
-        # Header param: Optional client generated identifier to trace and debug a series
-        # of requests.
+        # Optional client generated identifier to trace and debug a series of requests.
         correlation_id: nil,
-        # Header param: Optional client generated value to use for idempotent requests.
-        idempotency_key: nil,
-        # Header param: Optional client generated identifier to trace and debug a request.
+        # Optional client generated identifier to trace and debug a request.
         request_id: nil,
-        # Header param: For use by platforms to specify an account id and set scope of a
-        # request.
+        # For use by platforms to specify an account id and set scope of a request.
         straddle_account_id: nil,
         request_options: {}
       )
       end
 
-      # Retrieves the unmasked details of an existing paykey. Supply the unique paykey
-      # `id` and Straddle will return the corresponding paykey record, including the
-      # unmasked bank account details. This endpoint needs to be enabled by Straddle for
-      # your account and should only be used when absolutely necessary.
+      # Updates the balance of a paykey. This endpoint allows you to refresh the balance
+      # of a paykey.
       sig do
         params(
           id: String,
           correlation_id: String,
+          idempotency_key: String,
           request_id: String,
           straddle_account_id: String,
           request_options: Straddle::RequestOptions::OrHash
-        ).returns(Straddle::PaykeyUnmaskedV1)
+        ).returns(Straddle::PaykeyV1)
       end
-      def unmasked(
+      def update_balance(
         id,
         # Optional client generated identifier to trace and debug a series of requests.
         correlation_id: nil,
+        # Optional client generated value to use for idempotent requests.
+        idempotency_key: nil,
         # Optional client generated identifier to trace and debug a request.
         request_id: nil,
         # For use by platforms to specify an account id and set scope of a request.

data/sig/straddle/internal/transport/base_client.rbs

@@ -87,6 +87,8 @@ module Straddle
 
         private def auth_headers: -> ::Hash[String, String]
 
+        private def user_agent: -> String
+
         private def generate_idempotency_key: -> String
 
         private def build_request: (

data/sig/straddle/internal/transport/pooled_net_requester.rbs

@@ -17,7 +17,10 @@ module Straddle
 
         DEFAULT_MAX_CONNECTIONS: Integer
 
-        def self.connect: (URI::Generic url) -> top
+        def self.connect: (
+          cert_store: OpenSSL::X509::Store,
+          url: URI::Generic
+        ) -> top
 
         def self.calibrate_socket_timeout: (top conn, Float deadline) -> void
 

data/sig/straddle/models/bridge/link_bank_account_params.rbs

@@ -8,6 +8,7 @@ module Straddle
           customer_id: String,
           routing_number: String,
           config: Straddle::Bridge::LinkBankAccountParams::Config,
+          external_id: String?,
           metadata: ::Hash[Symbol, String]?,
           correlation_id: String,
           idempotency_key: String,
@@ -34,6 +35,8 @@ module Straddle
           Straddle::Bridge::LinkBankAccountParams::Config
         ) -> Straddle::Bridge::LinkBankAccountParams::Config
 
+        attr_accessor external_id: String?
+
         attr_accessor metadata: ::Hash[Symbol, String]?
 
         attr_reader correlation_id: String?
@@ -58,6 +61,7 @@ module Straddle
           customer_id: String,
           routing_number: String,
           ?config: Straddle::Bridge::LinkBankAccountParams::Config,
+          ?external_id: String?,
           ?metadata: ::Hash[Symbol, String]?,
           ?correlation_id: String,
           ?idempotency_key: String,
@@ -72,6 +76,7 @@ module Straddle
           customer_id: String,
           routing_number: String,
           config: Straddle::Bridge::LinkBankAccountParams::Config,
+          external_id: String?,
           metadata: ::Hash[Symbol, String]?,
           correlation_id: String,
           idempotency_key: String,
@@ -93,10 +98,17 @@ module Straddle
 
         type config =
           {
+            processing_method: Straddle::Models::Bridge::LinkBankAccountParams::Config::processing_method,
             sandbox_outcome: Straddle::Models::Bridge::LinkBankAccountParams::Config::sandbox_outcome
           }
 
         class Config < Straddle::Internal::Type::BaseModel
+          attr_reader processing_method: Straddle::Models::Bridge::LinkBankAccountParams::Config::processing_method?
+
+          def processing_method=: (
+            Straddle::Models::Bridge::LinkBankAccountParams::Config::processing_method
+          ) -> Straddle::Models::Bridge::LinkBankAccountParams::Config::processing_method
+
           attr_reader sandbox_outcome: Straddle::Models::Bridge::LinkBankAccountParams::Config::sandbox_outcome?
 
           def sandbox_outcome=: (
@@ -104,14 +116,28 @@ module Straddle
           ) -> Straddle::Models::Bridge::LinkBankAccountParams::Config::sandbox_outcome
 
           def initialize: (
+            ?processing_method: Straddle::Models::Bridge::LinkBankAccountParams::Config::processing_method,
             ?sandbox_outcome: Straddle::Models::Bridge::LinkBankAccountParams::Config::sandbox_outcome
           ) -> void
 
           def to_hash: -> {
+            processing_method: Straddle::Models::Bridge::LinkBankAccountParams::Config::processing_method,
             sandbox_outcome: Straddle::Models::Bridge::LinkBankAccountParams::Config::sandbox_outcome
           }
 
-          type sandbox_outcome = :standard | :active | :rejected
+          type processing_method = :inline | :background | :skip
+
+          module ProcessingMethod
+            extend Straddle::Internal::Type::Enum
+
+            INLINE: :inline
+            BACKGROUND: :background
+            SKIP: :skip
+
+            def self?.values: -> ::Array[Straddle::Models::Bridge::LinkBankAccountParams::Config::processing_method]
+          end
+
+          type sandbox_outcome = :standard | :active | :rejected | :review
 
           module SandboxOutcome
             extend Straddle::Internal::Type::Enum
@@ -119,6 +145,7 @@ module Straddle
             STANDARD: :standard
             ACTIVE: :active
             REJECTED: :rejected
+            REVIEW: :review
 
             def self?.values: -> ::Array[Straddle::Models::Bridge::LinkBankAccountParams::Config::sandbox_outcome]
           end