straddle 0.1.0.pre.alpha.1

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

@@ -0,0 +1,89 @@
+# frozen_string_literal: true
+
+module Straddle
+  module Models
+    module Embed
+      # @see Straddle::Resources::Embed::Organizations#list
+      class OrganizationListParams < Straddle::Internal::Type::BaseModel
+        extend Straddle::Internal::Type::RequestParameters::Converter
+        include Straddle::Internal::Type::RequestParameters
+
+        # @!attribute external_id
+        #   List organizations by their external ID.
+        #
+        #   @return [String, nil]
+        optional :external_id, String
+
+        # @!attribute name
+        #   List organizations by name (partial match supported).
+        #
+        #   @return [String, nil]
+        optional :name, String
+
+        # @!attribute page_number
+        #   Results page number. Starts at page 1.
+        #
+        #   @return [Integer, nil]
+        optional :page_number, Integer
+
+        # @!attribute page_size
+        #   Page size. Max value: 1000
+        #
+        #   @return [Integer, nil]
+        optional :page_size, Integer
+
+        # @!attribute sort_by
+        #   Sort By.
+        #
+        #   @return [String, nil]
+        optional :sort_by, String
+
+        # @!attribute sort_order
+        #   Sort Order.
+        #
+        #   @return [Symbol, Straddle::Models::Embed::OrganizationListParams::SortOrder, nil]
+        optional :sort_order, enum: -> { Straddle::Embed::OrganizationListParams::SortOrder }
+
+        # @!attribute correlation_id
+        #
+        #   @return [String, nil]
+        optional :correlation_id, String
+
+        # @!attribute request_id
+        #
+        #   @return [String, nil]
+        optional :request_id, String
+
+        # @!method initialize(external_id: nil, name: nil, page_number: nil, page_size: nil, sort_by: nil, sort_order: nil, correlation_id: nil, request_id: nil, request_options: {})
+        #   @param external_id [String] List organizations by their external ID.
+        #
+        #   @param name [String] List organizations by name (partial match supported).
+        #
+        #   @param page_number [Integer] Results page number. Starts at page 1.
+        #
+        #   @param page_size [Integer] Page size. Max value: 1000
+        #
+        #   @param sort_by [String] Sort By.
+        #
+        #   @param sort_order [Symbol, Straddle::Models::Embed::OrganizationListParams::SortOrder] Sort Order.
+        #
+        #   @param correlation_id [String]
+        #
+        #   @param request_id [String]
+        #
+        #   @param request_options [Straddle::RequestOptions, Hash{Symbol=>Object}]
+
+        # Sort Order.
+        module SortOrder
+          extend Straddle::Internal::Type::Enum
+
+          ASC = :asc
+          DESC = :desc
+
+          # @!method self.values
+          #   @return [Array<Symbol>]
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,120 @@
+# frozen_string_literal: true
+
+module Straddle
+  module Models
+    module Embed
+      class OrganizationPagedV1 < Straddle::Internal::Type::BaseModel
+        # @!attribute data
+        #
+        #   @return [Array<Straddle::Models::Embed::OrganizationPagedV1::Data>]
+        required :data, -> { Straddle::Internal::Type::ArrayOf[Straddle::Embed::OrganizationPagedV1::Data] }
+
+        # @!attribute meta
+        #   Metadata about the API request, including an identifier, timestamp, and
+        #   pagination details.
+        #
+        #   @return [Straddle::Models::PagedResponseMetadata]
+        required :meta, -> { Straddle::PagedResponseMetadata }
+
+        # @!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::OrganizationPagedV1::ResponseType]
+        required :response_type, enum: -> { Straddle::Embed::OrganizationPagedV1::ResponseType }
+
+        # @!method initialize(data:, meta:, response_type:)
+        #   Some parameter documentations has been truncated, see
+        #   {Straddle::Models::Embed::OrganizationPagedV1} for more details.
+        #
+        #   @param data [Array<Straddle::Models::Embed::OrganizationPagedV1::Data>]
+        #
+        #   @param meta [Straddle::Models::PagedResponseMetadata] Metadata about the API request, including an identifier, timestamp, and paginati
+        #
+        #   @param response_type [Symbol, Straddle::Models::Embed::OrganizationPagedV1::ResponseType] Indicates the structure of the returned content.
+
+        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::OrganizationPagedV1::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::OrganizationPagedV1#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/organization_v1.rb

@@ -0,0 +1,121 @@
+# 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

@@ -0,0 +1,351 @@
+# 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 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, 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 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