straddle 0.4.0 → 1.0.0

data/lib/straddle/models/embed/organization_v1.rb

@@ -1,121 +0,0 @@
-# frozen_string_literal: true
-
-module Straddle
-  module Models
-    module Embed
-      # @see Straddle::Resources::Embed::Organizations#create
-      class OrganizationV1 < Straddle::Internal::Type::BaseModel
-        # @!attribute data
-        #
-        #   @return [Straddle::Models::Embed::OrganizationV1::Data]
-        required :data, -> { Straddle::Embed::OrganizationV1::Data }
-
-        # @!attribute meta
-        #   Metadata about the API request, including an identifier and timestamp.
-        #
-        #   @return [Straddle::Models::ResponseMetadata]
-        required :meta, -> { Straddle::ResponseMetadata }
-
-        # @!attribute response_type
-        #   Indicates the structure of the returned content.
-        #
-        #   - "object" means the `data` field contains a single JSON object.
-        #   - "array" means the `data` field contains an array of objects.
-        #   - "error" means the `data` field contains an error object with details of the
-        #     issue.
-        #   - "none" means no data is returned.
-        #
-        #   @return [Symbol, Straddle::Models::Embed::OrganizationV1::ResponseType]
-        required :response_type, enum: -> { Straddle::Embed::OrganizationV1::ResponseType }
-
-        # @!method initialize(data:, meta:, response_type:)
-        #   Some parameter documentations has been truncated, see
-        #   {Straddle::Models::Embed::OrganizationV1} for more details.
-        #
-        #   @param data [Straddle::Models::Embed::OrganizationV1::Data]
-        #
-        #   @param meta [Straddle::Models::ResponseMetadata] Metadata about the API request, including an identifier and timestamp.
-        #
-        #   @param response_type [Symbol, Straddle::Models::Embed::OrganizationV1::ResponseType] Indicates the structure of the returned content.
-
-        # @see Straddle::Models::Embed::OrganizationV1#data
-        class Data < Straddle::Internal::Type::BaseModel
-          # @!attribute id
-          #   Straddle's unique identifier for the organization.
-          #
-          #   @return [String]
-          required :id, String
-
-          # @!attribute created_at
-          #   Timestamp of when the organization was created.
-          #
-          #   @return [Time]
-          required :created_at, Time
-
-          # @!attribute name
-          #   The name of the organization.
-          #
-          #   @return [String]
-          required :name, String
-
-          # @!attribute updated_at
-          #   Timestamp of the most recent update to the organization.
-          #
-          #   @return [Time]
-          required :updated_at, Time
-
-          # @!attribute external_id
-          #   Unique identifier for the organization 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 organization in a structured format.
-          #
-          #   @return [Hash{Symbol=>String, nil}, nil]
-          optional :metadata, Straddle::Internal::Type::HashOf[String, nil?: true], nil?: true
-
-          # @!method initialize(id:, created_at:, name:, updated_at:, external_id: nil, metadata: nil)
-          #   Some parameter documentations has been truncated, see
-          #   {Straddle::Models::Embed::OrganizationV1::Data} for more details.
-          #
-          #   @param id [String] Straddle's unique identifier for the organization.
-          #
-          #   @param created_at [Time] Timestamp of when the organization was created.
-          #
-          #   @param name [String] The name of the organization.
-          #
-          #   @param updated_at [Time] Timestamp of the most recent update to the organization.
-          #
-          #   @param external_id [String, nil] Unique identifier for the organization in your database, used for cross-referenc
-          #
-          #   @param metadata [Hash{Symbol=>String, nil}, nil] Up to 20 additional user-defined key-value pairs. Useful for storing additional
-        end
-
-        # Indicates the structure of the returned content.
-        #
-        # - "object" means the `data` field contains a single JSON object.
-        # - "array" means the `data` field contains an array of objects.
-        # - "error" means the `data` field contains an error object with details of the
-        #   issue.
-        # - "none" means no data is returned.
-        #
-        # @see Straddle::Models::Embed::OrganizationV1#response_type
-        module ResponseType
-          extend Straddle::Internal::Type::Enum
-
-          OBJECT = :object
-          ARRAY = :array
-          ERROR = :error
-          NONE = :none
-
-          # @!method self.values
-          #   @return [Array<Symbol>]
-        end
-      end
-    end
-  end
-end

data/lib/straddle/models/embed/representative.rb

@@ -1,360 +0,0 @@
-# frozen_string_literal: true
-
-module Straddle
-  module Models
-    module Embed
-      # @see Straddle::Resources::Embed::Representatives#create
-      class Representative < Straddle::Internal::Type::BaseModel
-        # @!attribute data
-        #
-        #   @return [Straddle::Models::Embed::Representative::Data]
-        required :data, -> { Straddle::Embed::Representative::Data }
-
-        # @!attribute meta
-        #   Metadata about the API request, including an identifier and timestamp.
-        #
-        #   @return [Straddle::Models::ResponseMetadata]
-        required :meta, -> { Straddle::ResponseMetadata }
-
-        # @!attribute response_type
-        #   Indicates the structure of the returned content.
-        #
-        #   - "object" means the `data` field contains a single JSON object.
-        #   - "array" means the `data` field contains an array of objects.
-        #   - "error" means the `data` field contains an error object with details of the
-        #     issue.
-        #   - "none" means no data is returned.
-        #
-        #   @return [Symbol, Straddle::Models::Embed::Representative::ResponseType]
-        required :response_type, enum: -> { Straddle::Embed::Representative::ResponseType }
-
-        # @!method initialize(data:, meta:, response_type:)
-        #   Some parameter documentations has been truncated, see
-        #   {Straddle::Models::Embed::Representative} for more details.
-        #
-        #   @param data [Straddle::Models::Embed::Representative::Data]
-        #
-        #   @param meta [Straddle::Models::ResponseMetadata] Metadata about the API request, including an identifier and timestamp.
-        #
-        #   @param response_type [Symbol, Straddle::Models::Embed::Representative::ResponseType] Indicates the structure of the returned content.
-
-        # @see Straddle::Models::Embed::Representative#data
-        class Data < Straddle::Internal::Type::BaseModel
-          # @!attribute id
-          #   Unique identifier for the representative.
-          #
-          #   @return [String]
-          required :id, String
-
-          # @!attribute account_id
-          #   The unique identifier of the account this representative is associated with.
-          #
-          #   @return [String]
-          required :account_id, String
-
-          # @!attribute created_at
-          #   Timestamp of when the representative was created.
-          #
-          #   @return [Time]
-          required :created_at, Time
-
-          # @!attribute dob
-          #   The date of birth of the representative, in ISO 8601 format (YYYY-MM-DD).
-          #
-          #   @return [Date]
-          required :dob, Date
-
-          # @!attribute email
-          #   The email address of the representative.
-          #
-          #   @return [String, nil]
-          required :email, String, nil?: true
-
-          # @!attribute first_name
-          #   The first name of the representative.
-          #
-          #   @return [String]
-          required :first_name, String
-
-          # @!attribute last_name
-          #   The last name of the representative.
-          #
-          #   @return [String]
-          required :last_name, String
-
-          # @!attribute mobile_number
-          #   The mobile phone number of the representative.
-          #
-          #   @return [String]
-          required :mobile_number, String
-
-          # @!attribute name
-          #
-          #   @return [String]
-          required :name, String
-
-          # @!attribute relationship
-          #
-          #   @return [Straddle::Models::Embed::Representative::Data::Relationship]
-          required :relationship, -> { Straddle::Embed::Representative::Data::Relationship }
-
-          # @!attribute ssn_last4
-          #   The last 4 digits of the representative's Social Security Number.
-          #
-          #   @return [String]
-          required :ssn_last4, String
-
-          # @!attribute status
-          #   The current status of the representative.
-          #
-          #   @return [Symbol, Straddle::Models::Embed::Representative::Data::Status]
-          required :status, enum: -> { Straddle::Embed::Representative::Data::Status }
-
-          # @!attribute status_detail
-          #
-          #   @return [Straddle::Models::Embed::Representative::Data::StatusDetail]
-          required :status_detail, -> { Straddle::Embed::Representative::Data::StatusDetail }
-
-          # @!attribute updated_at
-          #   Timestamp of the most recent update to the representative.
-          #
-          #   @return [Time]
-          required :updated_at, Time
-
-          # @!attribute external_id
-          #   Unique identifier for the representative 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 represetative in a structured format.
-          #
-          #   @return [Hash{Symbol=>String}, nil]
-          optional :metadata, Straddle::Internal::Type::HashOf[String], nil?: true
-
-          # @!attribute phone
-          #
-          #   @return [String, nil]
-          optional :phone, String, nil?: true
-
-          # @!attribute user_id
-          #   The unique identifier of the user account associated with this representative,
-          #   if applicable.
-          #
-          #   @return [String, nil]
-          optional :user_id, String, nil?: true
-
-          # @!method initialize(id:, account_id:, created_at:, dob:, email:, first_name:, last_name:, mobile_number:, name:, relationship:, ssn_last4:, status:, status_detail:, updated_at:, external_id: nil, metadata: nil, phone: nil, user_id: nil)
-          #   Some parameter documentations has been truncated, see
-          #   {Straddle::Models::Embed::Representative::Data} for more details.
-          #
-          #   @param id [String] Unique identifier for the representative.
-          #
-          #   @param account_id [String] The unique identifier of the account this representative is associated with.
-          #
-          #   @param created_at [Time] Timestamp of when the representative was created.
-          #
-          #   @param dob [Date] The date of birth of the representative, in ISO 8601 format (YYYY-MM-DD).
-          #
-          #   @param email [String, nil] The email address of the representative.
-          #
-          #   @param first_name [String] The first name of the representative.
-          #
-          #   @param last_name [String] The last name of the representative.
-          #
-          #   @param mobile_number [String] The mobile phone number of the representative.
-          #
-          #   @param name [String]
-          #
-          #   @param relationship [Straddle::Models::Embed::Representative::Data::Relationship]
-          #
-          #   @param ssn_last4 [String] The last 4 digits of the representative's Social Security Number.
-          #
-          #   @param status [Symbol, Straddle::Models::Embed::Representative::Data::Status] The current status of the representative.
-          #
-          #   @param status_detail [Straddle::Models::Embed::Representative::Data::StatusDetail]
-          #
-          #   @param updated_at [Time] Timestamp of the most recent update to the representative.
-          #
-          #   @param external_id [String, nil] Unique identifier for the representative in your database, used for cross-refere
-          #
-          #   @param metadata [Hash{Symbol=>String}, nil] Up to 20 additional user-defined key-value pairs. Useful for storing additional
-          #
-          #   @param phone [String, nil]
-          #
-          #   @param user_id [String, nil] The unique identifier of the user account associated with this representative, i
-
-          # @see Straddle::Models::Embed::Representative::Data#relationship
-          class Relationship < Straddle::Internal::Type::BaseModel
-            # @!attribute control
-            #   Whether the representative has significant responsibility to control, manage, or
-            #   direct the organization. One representative must be identified under the control
-            #   prong for each legal entity.
-            #
-            #   @return [Boolean]
-            required :control, Straddle::Internal::Type::Boolean
-
-            # @!attribute owner
-            #   Whether the representative owns any percentage of of the equity interests of the
-            #   legal entity.
-            #
-            #   @return [Boolean]
-            required :owner, Straddle::Internal::Type::Boolean
-
-            # @!attribute primary
-            #   Whether the person is authorized as the primary representative of the account.
-            #   This is the person chosen by the business to provide information about
-            #   themselves, general information about the account, and who consented to the
-            #   services agreement.
-            #
-            #   There can be only one primary representative for an account at a time.
-            #
-            #   @return [Boolean]
-            required :primary, Straddle::Internal::Type::Boolean
-
-            # @!attribute percent_ownership
-            #   The percentage of ownership the representative has. Required if 'Owner' is true.
-            #
-            #   @return [Float, nil]
-            optional :percent_ownership, Float, nil?: true
-
-            # @!attribute title
-            #   The job title of the representative.
-            #
-            #   @return [String, nil]
-            optional :title, String, nil?: true
-
-            # @!method initialize(control:, owner:, primary:, percent_ownership: nil, title: nil)
-            #   Some parameter documentations has been truncated, see
-            #   {Straddle::Models::Embed::Representative::Data::Relationship} for more details.
-            #
-            #   @param control [Boolean] Whether the representative has significant responsibility to control, manage, or
-            #
-            #   @param owner [Boolean] Whether the representative owns any percentage of of the equity interests of the
-            #
-            #   @param primary [Boolean] Whether the person is authorized as the primary representative of the account. T
-            #
-            #   @param percent_ownership [Float, nil] The percentage of ownership the representative has. Required if 'Owner' is true.
-            #
-            #   @param title [String, nil] The job title of the representative.
-          end
-
-          # The current status of the representative.
-          #
-          # @see Straddle::Models::Embed::Representative::Data#status
-          module Status
-            extend Straddle::Internal::Type::Enum
-
-            CREATED = :created
-            ONBOARDING = :onboarding
-            ACTIVE = :active
-            REJECTED = :rejected
-            INACTIVE = :inactive
-
-            # @!method self.values
-            #   @return [Array<Symbol>]
-          end
-
-          # @see Straddle::Models::Embed::Representative::Data#status_detail
-          class StatusDetail < Straddle::Internal::Type::BaseModel
-            # @!attribute code
-            #   A machine-readable code for the specific status, useful for programmatic
-            #   handling.
-            #
-            #   @return [String]
-            required :code, String
-
-            # @!attribute message
-            #   A human-readable message describing the current status.
-            #
-            #   @return [String]
-            required :message, String
-
-            # @!attribute reason
-            #   A machine-readable identifier for the specific status, useful for programmatic
-            #   handling.
-            #
-            #   @return [Symbol, Straddle::Models::Embed::Representative::Data::StatusDetail::Reason]
-            required :reason, enum: -> { Straddle::Embed::Representative::Data::StatusDetail::Reason }
-
-            # @!attribute source
-            #   Identifies the origin of the status change (e.g., `watchtower`). This helps in
-            #   tracking the cause of status updates.
-            #
-            #   @return [Symbol, Straddle::Models::Embed::Representative::Data::StatusDetail::Source]
-            required :source, enum: -> { Straddle::Embed::Representative::Data::StatusDetail::Source }
-
-            # @!method initialize(code:, message:, reason:, source:)
-            #   Some parameter documentations has been truncated, see
-            #   {Straddle::Models::Embed::Representative::Data::StatusDetail} for more details.
-            #
-            #   @param code [String] A machine-readable code for the specific status, useful for programmatic handlin
-            #
-            #   @param message [String] A human-readable message describing the current status.
-            #
-            #   @param reason [Symbol, Straddle::Models::Embed::Representative::Data::StatusDetail::Reason] A machine-readable identifier for the specific status, useful for programmatic h
-            #
-            #   @param source [Symbol, Straddle::Models::Embed::Representative::Data::StatusDetail::Source] Identifies the origin of the status change (e.g., `watchtower`). This helps in t
-
-            # A machine-readable identifier for the specific status, useful for programmatic
-            # handling.
-            #
-            # @see Straddle::Models::Embed::Representative::Data::StatusDetail#reason
-            module Reason
-              extend Straddle::Internal::Type::Enum
-
-              UNVERIFIED = :unverified
-              IN_REVIEW = :in_review
-              PENDING = :pending
-              STUCK = :stuck
-              VERIFIED = :verified
-              FAILED_VERIFICATION = :failed_verification
-              DISABLED = :disabled
-              NEW = :new
-
-              # @!method self.values
-              #   @return [Array<Symbol>]
-            end
-
-            # Identifies the origin of the status change (e.g., `watchtower`). This helps in
-            # tracking the cause of status updates.
-            #
-            # @see Straddle::Models::Embed::Representative::Data::StatusDetail#source
-            module Source
-              extend Straddle::Internal::Type::Enum
-
-              WATCHTOWER = :watchtower
-
-              # @!method self.values
-              #   @return [Array<Symbol>]
-            end
-          end
-        end
-
-        # Indicates the structure of the returned content.
-        #
-        # - "object" means the `data` field contains a single JSON object.
-        # - "array" means the `data` field contains an array of objects.
-        # - "error" means the `data` field contains an error object with details of the
-        #   issue.
-        # - "none" means no data is returned.
-        #
-        # @see Straddle::Models::Embed::Representative#response_type
-        module ResponseType
-          extend Straddle::Internal::Type::Enum
-
-          OBJECT = :object
-          ARRAY = :array
-          ERROR = :error
-          NONE = :none
-
-          # @!method self.values
-          #   @return [Array<Symbol>]
-        end
-      end
-    end
-  end
-end

data/lib/straddle/models/embed/representative_create_params.rb

@@ -1,176 +0,0 @@
-# frozen_string_literal: true
-
-module Straddle
-  module Models
-    module Embed
-      # @see Straddle::Resources::Embed::Representatives#create
-      class RepresentativeCreateParams < Straddle::Internal::Type::BaseModel
-        extend Straddle::Internal::Type::RequestParameters::Converter
-        include Straddle::Internal::Type::RequestParameters
-
-        # @!attribute account_id
-        #   The unique identifier of the account this representative is associated with.
-        #
-        #   @return [String]
-        required :account_id, String
-
-        # @!attribute dob
-        #   Date of birth for the representative in ISO 8601 format (YYYY-MM-DD).
-        #
-        #   @return [Date]
-        required :dob, Date
-
-        # @!attribute email
-        #   The company email address of the representative.
-        #
-        #   @return [String]
-        required :email, String
-
-        # @!attribute first_name
-        #   The first name of the representative.
-        #
-        #   @return [String]
-        required :first_name, String
-
-        # @!attribute last_name
-        #   The last name of the representative.
-        #
-        #   @return [String]
-        required :last_name, String
-
-        # @!attribute mobile_number
-        #   The mobile phone number of the representative.
-        #
-        #   @return [String]
-        required :mobile_number, String
-
-        # @!attribute relationship
-        #
-        #   @return [Straddle::Models::Embed::RepresentativeCreateParams::Relationship]
-        required :relationship, -> { Straddle::Embed::RepresentativeCreateParams::Relationship }
-
-        # @!attribute ssn_last4
-        #   The last 4 digits of the representative's Social Security Number.
-        #
-        #   @return [String]
-        required :ssn_last4, String
-
-        # @!attribute external_id
-        #   Unique identifier for the representative 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 represetative in a structured format.
-        #
-        #   @return [Hash{Symbol=>String}, nil]
-        optional :metadata, Straddle::Internal::Type::HashOf[String], nil?: true
-
-        # @!attribute correlation_id
-        #
-        #   @return [String, nil]
-        optional :correlation_id, String
-
-        # @!attribute idempotency_key
-        #
-        #   @return [String, nil]
-        optional :idempotency_key, String
-
-        # @!attribute request_id
-        #
-        #   @return [String, nil]
-        optional :request_id, String
-
-        # @!method initialize(account_id:, dob:, email:, first_name:, last_name:, mobile_number:, relationship:, ssn_last4:, external_id: nil, metadata: nil, correlation_id: nil, idempotency_key: nil, request_id: nil, request_options: {})
-        #   Some parameter documentations has been truncated, see
-        #   {Straddle::Models::Embed::RepresentativeCreateParams} for more details.
-        #
-        #   @param account_id [String] The unique identifier of the account this representative is associated with.
-        #
-        #   @param dob [Date] Date of birth for the representative in ISO 8601 format (YYYY-MM-DD).
-        #
-        #   @param email [String] The company email address of the representative.
-        #
-        #   @param first_name [String] The first name of the representative.
-        #
-        #   @param last_name [String] The last name of the representative.
-        #
-        #   @param mobile_number [String] The mobile phone number of the representative.
-        #
-        #   @param relationship [Straddle::Models::Embed::RepresentativeCreateParams::Relationship]
-        #
-        #   @param ssn_last4 [String] The last 4 digits of the representative's Social Security Number.
-        #
-        #   @param external_id [String, nil] Unique identifier for the representative in your database, used for cross-refere
-        #
-        #   @param metadata [Hash{Symbol=>String}, nil] Up to 20 additional user-defined key-value pairs. Useful for storing additional
-        #
-        #   @param correlation_id [String]
-        #
-        #   @param idempotency_key [String]
-        #
-        #   @param request_id [String]
-        #
-        #   @param request_options [Straddle::RequestOptions, Hash{Symbol=>Object}]
-
-        class Relationship < Straddle::Internal::Type::BaseModel
-          # @!attribute control
-          #   Whether the representative has significant responsibility to control, manage, or
-          #   direct the organization. One representative must be identified under the control
-          #   prong for each legal entity.
-          #
-          #   @return [Boolean]
-          required :control, Straddle::Internal::Type::Boolean
-
-          # @!attribute owner
-          #   Whether the representative owns any percentage of of the equity interests of the
-          #   legal entity.
-          #
-          #   @return [Boolean]
-          required :owner, Straddle::Internal::Type::Boolean
-
-          # @!attribute primary
-          #   Whether the person is authorized as the primary representative of the account.
-          #   This is the person chosen by the business to provide information about
-          #   themselves, general information about the account, and who consented to the
-          #   services agreement.
-          #
-          #   There can be only one primary representative for an account at a time.
-          #
-          #   @return [Boolean]
-          required :primary, Straddle::Internal::Type::Boolean
-
-          # @!attribute percent_ownership
-          #   The percentage of ownership the representative has. Required if 'Owner' is true.
-          #
-          #   @return [Float, nil]
-          optional :percent_ownership, Float, nil?: true
-
-          # @!attribute title
-          #   The job title of the representative.
-          #
-          #   @return [String, nil]
-          optional :title, String, nil?: true
-
-          # @!method initialize(control:, owner:, primary:, percent_ownership: nil, title: nil)
-          #   Some parameter documentations has been truncated, see
-          #   {Straddle::Models::Embed::RepresentativeCreateParams::Relationship} for more
-          #   details.
-          #
-          #   @param control [Boolean] Whether the representative has significant responsibility to control, manage, or
-          #
-          #   @param owner [Boolean] Whether the representative owns any percentage of of the equity interests of the
-          #
-          #   @param primary [Boolean] Whether the person is authorized as the primary representative of the account. T
-          #
-          #   @param percent_ownership [Float, nil] The percentage of ownership the representative has. Required if 'Owner' is true.
-          #
-          #   @param title [String, nil] The job title of the representative.
-        end
-      end
-    end
-  end
-end

data/lib/straddle/models/embed/representative_get_params.rb

@@ -1,34 +0,0 @@
-# frozen_string_literal: true
-
-module Straddle
-  module Models
-    module Embed
-      # @see Straddle::Resources::Embed::Representatives#get
-      class RepresentativeGetParams < Straddle::Internal::Type::BaseModel
-        extend Straddle::Internal::Type::RequestParameters::Converter
-        include Straddle::Internal::Type::RequestParameters
-
-        # @!attribute representative_id
-        #
-        #   @return [String]
-        required :representative_id, String
-
-        # @!attribute correlation_id
-        #
-        #   @return [String, nil]
-        optional :correlation_id, String
-
-        # @!attribute request_id
-        #
-        #   @return [String, nil]
-        optional :request_id, String
-
-        # @!method initialize(representative_id:, correlation_id: nil, request_id: nil, request_options: {})
-        #   @param representative_id [String]
-        #   @param correlation_id [String]
-        #   @param request_id [String]
-        #   @param request_options [Straddle::RequestOptions, Hash{Symbol=>Object}]
-      end
-    end
-  end
-end