straddle 0.1.0.pre.alpha.1

data/rbi/straddle/models/customer_address_v1.rbi

@@ -0,0 +1,71 @@
+# typed: strong
+
+module Straddle
+  module Models
+    class CustomerAddressV1 < Straddle::Internal::Type::BaseModel
+      OrHash =
+        T.type_alias do
+          T.any(Straddle::CustomerAddressV1, Straddle::Internal::AnyHash)
+        end
+
+      # Primary address line (e.g., street, PO Box).
+      sig { returns(String) }
+      attr_accessor :address1
+
+      # City, district, suburb, town, or village.
+      sig { returns(String) }
+      attr_accessor :city
+
+      # Two-letter state code.
+      sig { returns(String) }
+      attr_accessor :state
+
+      # Zip or postal code.
+      sig { returns(String) }
+      attr_accessor :zip
+
+      # Secondary address line (e.g., apartment, suite, unit, or building).
+      sig { returns(T.nilable(String)) }
+      attr_accessor :address2
+
+      # An object containing the customer's address. This is optional, but if provided,
+      # all required fields must be present.
+      sig do
+        params(
+          address1: String,
+          city: String,
+          state: String,
+          zip: String,
+          address2: T.nilable(String)
+        ).returns(T.attached_class)
+      end
+      def self.new(
+        # Primary address line (e.g., street, PO Box).
+        address1:,
+        # City, district, suburb, town, or village.
+        city:,
+        # Two-letter state code.
+        state:,
+        # Zip or postal code.
+        zip:,
+        # Secondary address line (e.g., apartment, suite, unit, or building).
+        address2: nil
+      )
+      end
+
+      sig do
+        override.returns(
+          {
+            address1: String,
+            city: String,
+            state: String,
+            zip: String,
+            address2: T.nilable(String)
+          }
+        )
+      end
+      def to_hash
+      end
+    end
+  end
+end

data/rbi/straddle/models/customer_create_params.rbi

@@ -0,0 +1,542 @@
+# typed: strong
+
+module Straddle
+  module Models
+    class CustomerCreateParams < Straddle::Internal::Type::BaseModel
+      extend Straddle::Internal::Type::RequestParameters::Converter
+      include Straddle::Internal::Type::RequestParameters
+
+      OrHash =
+        T.type_alias do
+          T.any(Straddle::CustomerCreateParams, Straddle::Internal::AnyHash)
+        end
+
+      sig { returns(Straddle::DeviceUnmaskedV1) }
+      attr_reader :device
+
+      sig { params(device: Straddle::DeviceUnmaskedV1::OrHash).void }
+      attr_writer :device
+
+      # The customer's email address.
+      sig { returns(String) }
+      attr_accessor :email
+
+      # Full name of the individual or business name.
+      sig { returns(String) }
+      attr_accessor :name
+
+      # The customer's phone number in E.164 format. Mobile number is preferred.
+      sig { returns(String) }
+      attr_accessor :phone
+
+      sig { returns(Straddle::CustomerCreateParams::Type::OrSymbol) }
+      attr_accessor :type
+
+      # An object containing the customer's address. **This is optional.** If used, all
+      # required fields must be present.
+      sig { returns(T.nilable(Straddle::CustomerAddressV1)) }
+      attr_reader :address
+
+      sig do
+        params(address: T.nilable(Straddle::CustomerAddressV1::OrHash)).void
+      end
+      attr_writer :address
+
+      # An object containing the customer's compliance profile. **This is optional.** If
+      # all required fields must be present for the appropriate customer type.
+      sig do
+        returns(
+          T.nilable(
+            T.any(
+              Straddle::CustomerCreateParams::ComplianceProfile::IndividualComplianceProfile,
+              Straddle::CustomerCreateParams::ComplianceProfile::BusinessComplianceProfile
+            )
+          )
+        )
+      end
+      attr_accessor :compliance_profile
+
+      sig { returns(T.nilable(Straddle::CustomerCreateParams::Config)) }
+      attr_reader :config
+
+      sig do
+        params(config: Straddle::CustomerCreateParams::Config::OrHash).void
+      end
+      attr_writer :config
+
+      # Unique identifier for the customer in your database, used for cross-referencing
+      # between Straddle and your systems.
+      sig { returns(T.nilable(String)) }
+      attr_accessor :external_id
+
+      # Up to 20 additional user-defined key-value pairs. Useful for storing additional
+      # information about the customer in a structured format.
+      sig { returns(T.nilable(T::Hash[Symbol, String])) }
+      attr_accessor :metadata
+
+      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 :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(
+          device: Straddle::DeviceUnmaskedV1::OrHash,
+          email: String,
+          name: String,
+          phone: String,
+          type: Straddle::CustomerCreateParams::Type::OrSymbol,
+          address: T.nilable(Straddle::CustomerAddressV1::OrHash),
+          compliance_profile:
+            T.nilable(
+              T.any(
+                Straddle::CustomerCreateParams::ComplianceProfile::IndividualComplianceProfile::OrHash,
+                Straddle::CustomerCreateParams::ComplianceProfile::BusinessComplianceProfile::OrHash
+              )
+            ),
+          config: Straddle::CustomerCreateParams::Config::OrHash,
+          external_id: T.nilable(String),
+          metadata: T.nilable(T::Hash[Symbol, String]),
+          correlation_id: String,
+          request_id: String,
+          straddle_account_id: String,
+          request_options: Straddle::RequestOptions::OrHash
+        ).returns(T.attached_class)
+      end
+      def self.new(
+        device:,
+        # The customer's email address.
+        email:,
+        # Full name of the individual or business name.
+        name:,
+        # The customer's phone number in E.164 format. Mobile number is preferred.
+        phone:,
+        type:,
+        # An object containing the customer's address. **This is optional.** If used, all
+        # required fields must be present.
+        address: nil,
+        # An object containing the customer's compliance profile. **This is optional.** If
+        # all required fields must be present for the appropriate customer type.
+        compliance_profile: nil,
+        config: nil,
+        # Unique identifier for the customer in your database, used for cross-referencing
+        # between Straddle and your systems.
+        external_id: nil,
+        # Up to 20 additional user-defined key-value pairs. Useful for storing additional
+        # information about the customer in a structured format.
+        metadata: nil,
+        correlation_id: nil,
+        request_id: nil,
+        straddle_account_id: nil,
+        request_options: {}
+      )
+      end
+
+      sig do
+        override.returns(
+          {
+            device: Straddle::DeviceUnmaskedV1,
+            email: String,
+            name: String,
+            phone: String,
+            type: Straddle::CustomerCreateParams::Type::OrSymbol,
+            address: T.nilable(Straddle::CustomerAddressV1),
+            compliance_profile:
+              T.nilable(
+                T.any(
+                  Straddle::CustomerCreateParams::ComplianceProfile::IndividualComplianceProfile,
+                  Straddle::CustomerCreateParams::ComplianceProfile::BusinessComplianceProfile
+                )
+              ),
+            config: Straddle::CustomerCreateParams::Config,
+            external_id: T.nilable(String),
+            metadata: T.nilable(T::Hash[Symbol, String]),
+            correlation_id: String,
+            request_id: String,
+            straddle_account_id: String,
+            request_options: Straddle::RequestOptions
+          }
+        )
+      end
+      def to_hash
+      end
+
+      module Type
+        extend Straddle::Internal::Type::Enum
+
+        TaggedSymbol =
+          T.type_alias { T.all(Symbol, Straddle::CustomerCreateParams::Type) }
+        OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+        INDIVIDUAL =
+          T.let(:individual, Straddle::CustomerCreateParams::Type::TaggedSymbol)
+        BUSINESS =
+          T.let(:business, Straddle::CustomerCreateParams::Type::TaggedSymbol)
+        UNKNOWN =
+          T.let(:unknown, Straddle::CustomerCreateParams::Type::TaggedSymbol)
+
+        sig do
+          override.returns(
+            T::Array[Straddle::CustomerCreateParams::Type::TaggedSymbol]
+          )
+        end
+        def self.values
+        end
+      end
+
+      # An object containing the customer's compliance profile. **This is optional.** If
+      # all required fields must be present for the appropriate customer type.
+      module ComplianceProfile
+        extend Straddle::Internal::Type::Union
+
+        Variants =
+          T.type_alias do
+            T.any(
+              Straddle::CustomerCreateParams::ComplianceProfile::IndividualComplianceProfile,
+              Straddle::CustomerCreateParams::ComplianceProfile::BusinessComplianceProfile
+            )
+          end
+
+        class IndividualComplianceProfile < Straddle::Internal::Type::BaseModel
+          OrHash =
+            T.type_alias do
+              T.any(
+                Straddle::CustomerCreateParams::ComplianceProfile::IndividualComplianceProfile,
+                Straddle::Internal::AnyHash
+              )
+            end
+
+          # Date of birth (YYYY-MM-DD). Required for Patriot Act-compliant KYC verification.
+          sig { returns(T.nilable(Date)) }
+          attr_accessor :dob
+
+          # Social Security Number (format XXX-XX-XXXX). Required for Patriot Act-compliant
+          # KYC verification.
+          sig { returns(T.nilable(String)) }
+          attr_accessor :ssn
+
+          # Individual PII data required to trigger Patriot Act compliant KYC verification.
+          sig do
+            params(dob: T.nilable(Date), ssn: T.nilable(String)).returns(
+              T.attached_class
+            )
+          end
+          def self.new(
+            # Date of birth (YYYY-MM-DD). Required for Patriot Act-compliant KYC verification.
+            dob:,
+            # Social Security Number (format XXX-XX-XXXX). Required for Patriot Act-compliant
+            # KYC verification.
+            ssn:
+          )
+          end
+
+          sig do
+            override.returns({ dob: T.nilable(Date), ssn: T.nilable(String) })
+          end
+          def to_hash
+          end
+        end
+
+        class BusinessComplianceProfile < Straddle::Internal::Type::BaseModel
+          OrHash =
+            T.type_alias do
+              T.any(
+                Straddle::CustomerCreateParams::ComplianceProfile::BusinessComplianceProfile,
+                Straddle::Internal::AnyHash
+              )
+            end
+
+          # Employer Identification Number (format XX-XXXXXXX). Required for Patriot
+          # Act-compliant KYB verification.
+          sig { returns(T.nilable(String)) }
+          attr_accessor :ein
+
+          # Official registered business name as listed with the IRS. This value will be
+          # matched against the 'legal_business name'.
+          sig { returns(T.nilable(String)) }
+          attr_accessor :legal_business_name
+
+          # A list of people related to the company. Only valid where customer type is
+          # 'business'.
+          sig do
+            returns(
+              T.nilable(
+                T::Array[
+                  Straddle::CustomerCreateParams::ComplianceProfile::BusinessComplianceProfile::Representative
+                ]
+              )
+            )
+          end
+          attr_accessor :representatives
+
+          # Official business website URL. Optional but recommended for enhanced KYB.
+          sig { returns(T.nilable(String)) }
+          attr_accessor :website
+
+          # Business registration data required to trigger Patriot Act compliant KYB
+          # verification.
+          sig do
+            params(
+              ein: T.nilable(String),
+              legal_business_name: T.nilable(String),
+              representatives:
+                T.nilable(
+                  T::Array[
+                    Straddle::CustomerCreateParams::ComplianceProfile::BusinessComplianceProfile::Representative::OrHash
+                  ]
+                ),
+              website: T.nilable(String)
+            ).returns(T.attached_class)
+          end
+          def self.new(
+            # Employer Identification Number (format XX-XXXXXXX). Required for Patriot
+            # Act-compliant KYB verification.
+            ein:,
+            # Official registered business name as listed with the IRS. This value will be
+            # matched against the 'legal_business name'.
+            legal_business_name:,
+            # A list of people related to the company. Only valid where customer type is
+            # 'business'.
+            representatives: nil,
+            # Official business website URL. Optional but recommended for enhanced KYB.
+            website: nil
+          )
+          end
+
+          sig do
+            override.returns(
+              {
+                ein: T.nilable(String),
+                legal_business_name: T.nilable(String),
+                representatives:
+                  T.nilable(
+                    T::Array[
+                      Straddle::CustomerCreateParams::ComplianceProfile::BusinessComplianceProfile::Representative
+                    ]
+                  ),
+                website: T.nilable(String)
+              }
+            )
+          end
+          def to_hash
+          end
+
+          class Representative < Straddle::Internal::Type::BaseModel
+            OrHash =
+              T.type_alias do
+                T.any(
+                  Straddle::CustomerCreateParams::ComplianceProfile::BusinessComplianceProfile::Representative,
+                  Straddle::Internal::AnyHash
+                )
+              end
+
+            sig { returns(String) }
+            attr_accessor :name
+
+            sig { returns(T.nilable(String)) }
+            attr_accessor :email
+
+            sig { returns(T.nilable(String)) }
+            attr_accessor :phone
+
+            sig do
+              params(
+                name: String,
+                email: T.nilable(String),
+                phone: T.nilable(String)
+              ).returns(T.attached_class)
+            end
+            def self.new(name:, email: nil, phone: nil)
+            end
+
+            sig do
+              override.returns(
+                {
+                  name: String,
+                  email: T.nilable(String),
+                  phone: T.nilable(String)
+                }
+              )
+            end
+            def to_hash
+            end
+          end
+        end
+
+        sig do
+          override.returns(
+            T::Array[
+              Straddle::CustomerCreateParams::ComplianceProfile::Variants
+            ]
+          )
+        end
+        def self.variants
+        end
+      end
+
+      class Config < Straddle::Internal::Type::BaseModel
+        OrHash =
+          T.type_alias do
+            T.any(
+              Straddle::CustomerCreateParams::Config,
+              Straddle::Internal::AnyHash
+            )
+          end
+
+        sig do
+          returns(
+            T.nilable(
+              Straddle::CustomerCreateParams::Config::ProcessingMethod::OrSymbol
+            )
+          )
+        end
+        attr_reader :processing_method
+
+        sig do
+          params(
+            processing_method:
+              Straddle::CustomerCreateParams::Config::ProcessingMethod::OrSymbol
+          ).void
+        end
+        attr_writer :processing_method
+
+        sig do
+          returns(
+            T.nilable(
+              Straddle::CustomerCreateParams::Config::SandboxOutcome::OrSymbol
+            )
+          )
+        end
+        attr_reader :sandbox_outcome
+
+        sig do
+          params(
+            sandbox_outcome:
+              Straddle::CustomerCreateParams::Config::SandboxOutcome::OrSymbol
+          ).void
+        end
+        attr_writer :sandbox_outcome
+
+        sig do
+          params(
+            processing_method:
+              Straddle::CustomerCreateParams::Config::ProcessingMethod::OrSymbol,
+            sandbox_outcome:
+              Straddle::CustomerCreateParams::Config::SandboxOutcome::OrSymbol
+          ).returns(T.attached_class)
+        end
+        def self.new(processing_method: nil, sandbox_outcome: nil)
+        end
+
+        sig do
+          override.returns(
+            {
+              processing_method:
+                Straddle::CustomerCreateParams::Config::ProcessingMethod::OrSymbol,
+              sandbox_outcome:
+                Straddle::CustomerCreateParams::Config::SandboxOutcome::OrSymbol
+            }
+          )
+        end
+        def to_hash
+        end
+
+        module ProcessingMethod
+          extend Straddle::Internal::Type::Enum
+
+          TaggedSymbol =
+            T.type_alias do
+              T.all(
+                Symbol,
+                Straddle::CustomerCreateParams::Config::ProcessingMethod
+              )
+            end
+          OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+          INLINE =
+            T.let(
+              :inline,
+              Straddle::CustomerCreateParams::Config::ProcessingMethod::TaggedSymbol
+            )
+          BACKGROUND =
+            T.let(
+              :background,
+              Straddle::CustomerCreateParams::Config::ProcessingMethod::TaggedSymbol
+            )
+          SKIP =
+            T.let(
+              :skip,
+              Straddle::CustomerCreateParams::Config::ProcessingMethod::TaggedSymbol
+            )
+
+          sig do
+            override.returns(
+              T::Array[
+                Straddle::CustomerCreateParams::Config::ProcessingMethod::TaggedSymbol
+              ]
+            )
+          end
+          def self.values
+          end
+        end
+
+        module SandboxOutcome
+          extend Straddle::Internal::Type::Enum
+
+          TaggedSymbol =
+            T.type_alias do
+              T.all(
+                Symbol,
+                Straddle::CustomerCreateParams::Config::SandboxOutcome
+              )
+            end
+          OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+          STANDARD =
+            T.let(
+              :standard,
+              Straddle::CustomerCreateParams::Config::SandboxOutcome::TaggedSymbol
+            )
+          VERIFIED =
+            T.let(
+              :verified,
+              Straddle::CustomerCreateParams::Config::SandboxOutcome::TaggedSymbol
+            )
+          REJECTED =
+            T.let(
+              :rejected,
+              Straddle::CustomerCreateParams::Config::SandboxOutcome::TaggedSymbol
+            )
+          REVIEW =
+            T.let(
+              :review,
+              Straddle::CustomerCreateParams::Config::SandboxOutcome::TaggedSymbol
+            )
+
+          sig do
+            override.returns(
+              T::Array[
+                Straddle::CustomerCreateParams::Config::SandboxOutcome::TaggedSymbol
+              ]
+            )
+          end
+          def self.values
+          end
+        end
+      end
+    end
+  end
+end

data/rbi/straddle/models/customer_delete_params.rbi

@@ -0,0 +1,62 @@
+# typed: strong
+
+module Straddle
+  module Models
+    class CustomerDeleteParams < Straddle::Internal::Type::BaseModel
+      extend Straddle::Internal::Type::RequestParameters::Converter
+      include Straddle::Internal::Type::RequestParameters
+
+      OrHash =
+        T.type_alias do
+          T.any(Straddle::CustomerDeleteParams, 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 :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,
+          request_id: String,
+          straddle_account_id: String,
+          request_options: Straddle::RequestOptions::OrHash
+        ).returns(T.attached_class)
+      end
+      def self.new(
+        correlation_id: nil,
+        request_id: nil,
+        straddle_account_id: nil,
+        request_options: {}
+      )
+      end
+
+      sig do
+        override.returns(
+          {
+            correlation_id: String,
+            request_id: String,
+            straddle_account_id: String,
+            request_options: Straddle::RequestOptions
+          }
+        )
+      end
+      def to_hash
+      end
+    end
+  end
+end