straddle 0.1.0.pre.alpha.1

data/lib/straddle/models.rb

@@ -0,0 +1,149 @@
+# frozen_string_literal: true
+
+module Straddle
+  [Straddle::Internal::Type::BaseModel, *Straddle::Internal::Type::BaseModel.subclasses].each do |cls|
+    cls.define_sorbet_constant!(:OrHash) { T.type_alias { T.any(cls, Straddle::Internal::AnyHash) } }
+  end
+
+  Straddle::Internal::Util.walk_namespaces(Straddle::Models).each do |mod|
+    case mod
+    in Straddle::Internal::Type::Enum | Straddle::Internal::Type::Union
+      mod.constants.each do |name|
+        case mod.const_get(name)
+        in true | false
+          mod.define_sorbet_constant!(:TaggedBoolean) { T.type_alias { T::Boolean } }
+          mod.define_sorbet_constant!(:OrBoolean) { T.type_alias { T::Boolean } }
+        in Integer
+          mod.define_sorbet_constant!(:TaggedInteger) { T.type_alias { Integer } }
+          mod.define_sorbet_constant!(:OrInteger) { T.type_alias { Integer } }
+        in Float
+          mod.define_sorbet_constant!(:TaggedFloat) { T.type_alias { Float } }
+          mod.define_sorbet_constant!(:OrFloat) { T.type_alias { Float } }
+        in Symbol
+          mod.define_sorbet_constant!(:TaggedSymbol) { T.type_alias { Symbol } }
+          mod.define_sorbet_constant!(:OrSymbol) { T.type_alias { T.any(Symbol, String) } }
+        else
+        end
+      end
+    else
+    end
+  end
+
+  Straddle::Internal::Util.walk_namespaces(Straddle::Models)
+                          .lazy
+                          .grep(Straddle::Internal::Type::Union)
+                          .each do |mod|
+    const = :Variants
+    next if mod.sorbet_constant_defined?(const)
+
+    mod.define_sorbet_constant!(const) { T.type_alias { mod.to_sorbet_type } }
+  end
+
+  Bridge = Straddle::Models::Bridge
+
+  BridgeInitializeParams = Straddle::Models::BridgeInitializeParams
+
+  BridgeTokenV1 = Straddle::Models::BridgeTokenV1
+
+  ChargeCancelParams = Straddle::Models::ChargeCancelParams
+
+  ChargeCreateParams = Straddle::Models::ChargeCreateParams
+
+  ChargeGetParams = Straddle::Models::ChargeGetParams
+
+  ChargeHoldParams = Straddle::Models::ChargeHoldParams
+
+  ChargeReleaseParams = Straddle::Models::ChargeReleaseParams
+
+  ChargeUnmaskParams = Straddle::Models::ChargeUnmaskParams
+
+  ChargeUpdateParams = Straddle::Models::ChargeUpdateParams
+
+  ChargeV1 = Straddle::Models::ChargeV1
+
+  CustomerAddressV1 = Straddle::Models::CustomerAddressV1
+
+  CustomerCreateParams = Straddle::Models::CustomerCreateParams
+
+  CustomerDeleteParams = Straddle::Models::CustomerDeleteParams
+
+  CustomerDetailsV1 = Straddle::Models::CustomerDetailsV1
+
+  CustomerGetParams = Straddle::Models::CustomerGetParams
+
+  CustomerListParams = Straddle::Models::CustomerListParams
+
+  CustomerRefreshReviewParams = Straddle::Models::CustomerRefreshReviewParams
+
+  Customers = Straddle::Models::Customers
+
+  CustomerSummaryPagedV1 = Straddle::Models::CustomerSummaryPagedV1
+
+  CustomerUnmaskedParams = Straddle::Models::CustomerUnmaskedParams
+
+  CustomerUnmaskedV1 = Straddle::Models::CustomerUnmaskedV1
+
+  CustomerUpdateParams = Straddle::Models::CustomerUpdateParams
+
+  CustomerV1 = Straddle::Models::CustomerV1
+
+  DeviceInfoV1 = Straddle::Models::DeviceInfoV1
+
+  DeviceUnmaskedV1 = Straddle::Models::DeviceUnmaskedV1
+
+  Embed = Straddle::Models::Embed
+
+  FundingEventGetParams = Straddle::Models::FundingEventGetParams
+
+  FundingEventListParams = Straddle::Models::FundingEventListParams
+
+  FundingEventSummaryItemV1 = Straddle::Models::FundingEventSummaryItemV1
+
+  FundingEventSummaryPagedV1 = Straddle::Models::FundingEventSummaryPagedV1
+
+  PagedResponseMetadata = Straddle::Models::PagedResponseMetadata
+
+  PaykeyCancelParams = Straddle::Models::PaykeyCancelParams
+
+  PaykeyDetailsV1 = Straddle::Models::PaykeyDetailsV1
+
+  PaykeyGetParams = Straddle::Models::PaykeyGetParams
+
+  PaykeyListParams = Straddle::Models::PaykeyListParams
+
+  PaykeyRevealParams = Straddle::Models::PaykeyRevealParams
+
+  PaykeySummaryPagedV1 = Straddle::Models::PaykeySummaryPagedV1
+
+  PaykeyUnmaskedParams = Straddle::Models::PaykeyUnmaskedParams
+
+  PaykeyUnmaskedV1 = Straddle::Models::PaykeyUnmaskedV1
+
+  PaykeyV1 = Straddle::Models::PaykeyV1
+
+  PaymentListParams = Straddle::Models::PaymentListParams
+
+  PaymentSummaryPagedV1 = Straddle::Models::PaymentSummaryPagedV1
+
+  PayoutCancelParams = Straddle::Models::PayoutCancelParams
+
+  PayoutCreateParams = Straddle::Models::PayoutCreateParams
+
+  PayoutGetParams = Straddle::Models::PayoutGetParams
+
+  PayoutHoldParams = Straddle::Models::PayoutHoldParams
+
+  PayoutReleaseParams = Straddle::Models::PayoutReleaseParams
+
+  PayoutUnmaskParams = Straddle::Models::PayoutUnmaskParams
+
+  PayoutUpdateParams = Straddle::Models::PayoutUpdateParams
+
+  PayoutV1 = Straddle::Models::PayoutV1
+
+  ReportCreateTotalCustomersByStatusParams = Straddle::Models::ReportCreateTotalCustomersByStatusParams
+
+  ResponseMetadata = Straddle::Models::ResponseMetadata
+
+  StatusDetailsV1 = Straddle::Models::StatusDetailsV1
+end

data/lib/straddle/request_options.rb

@@ -0,0 +1,77 @@
+# frozen_string_literal: true
+
+module Straddle
+  # Specify HTTP behaviour to use for a specific request. These options supplement
+  # or override those provided at the client level.
+  #
+  # When making a request, you can pass an actual {RequestOptions} instance, or
+  # simply pass a Hash with symbol keys matching the attributes on this class.
+  class RequestOptions < Straddle::Internal::Type::BaseModel
+    # @api private
+    #
+    # @param opts [Straddle::RequestOptions, Hash{Symbol=>Object}]
+    #
+    # @raise [ArgumentError]
+    def self.validate!(opts)
+      case opts
+      in Straddle::RequestOptions | Hash
+        opts.to_h.each_key do |k|
+          unless fields.include?(k)
+            raise ArgumentError.new("Request `opts` keys must be one of #{fields.keys}, got #{k.inspect}")
+          end
+        end
+      else
+        raise ArgumentError.new("Request `opts` must be a Hash or RequestOptions, got #{opts.inspect}")
+      end
+    end
+
+    # @!attribute idempotency_key
+    #   Idempotency key to send with request and all associated retries. Will only be
+    #   sent for write requests.
+    #
+    #   @return [String, nil]
+    optional :idempotency_key, String
+
+    # @!attribute extra_query
+    #   Extra query params to send with the request. These are `.merge`’d into any
+    #   `query` given at the client level.
+    #
+    #   @return [Hash{String=>Array<String>, String, nil}, nil]
+    optional :extra_query, Straddle::Internal::Type::HashOf[Straddle::Internal::Type::ArrayOf[String]]
+
+    # @!attribute extra_headers
+    #   Extra headers to send with the request. These are `.merged`’d into any
+    #   `extra_headers` given at the client level.
+    #
+    #   @return [Hash{String=>String, nil}, nil]
+    optional :extra_headers, Straddle::Internal::Type::HashOf[String, nil?: true]
+
+    # @!attribute extra_body
+    #   Extra data to send with the request. These are deep merged into any data
+    #   generated as part of the normal request.
+    #
+    #   @return [Object, nil]
+    optional :extra_body, Straddle::Internal::Type::HashOf[Straddle::Internal::Type::Unknown]
+
+    # @!attribute max_retries
+    #   Maximum number of retries to attempt after a failed initial request.
+    #
+    #   @return [Integer, nil]
+    optional :max_retries, Integer
+
+    # @!attribute timeout
+    #   Request timeout in seconds.
+    #
+    #   @return [Float, nil]
+    optional :timeout, Float
+
+    # @!method initialize(values = {})
+    #   Returns a new instance of RequestOptions.
+    #
+    #   @param values [Hash{Symbol=>Object}]
+
+    define_sorbet_constant!(:OrHash) do
+      T.type_alias { T.any(Straddle::RequestOptions, Straddle::Internal::AnyHash) }
+    end
+  end
+end

data/lib/straddle/resources/bridge/link.rb

@@ -0,0 +1,204 @@
+# frozen_string_literal: true
+
+module Straddle
+  module Resources
+    class Bridge
+      class Link
+        # Some parameter documentations has been truncated, see
+        # {Straddle::Models::Bridge::LinkBankAccountParams} for more details.
+        #
+        # Use Bridge to create a new paykey using a bank routing and account number as the
+        # source. This endpoint allows you to create a secure payment token linked to a
+        # specific bank account.
+        #
+        # @overload bank_account(account_number:, account_type:, customer_id:, routing_number:, config: nil, metadata: nil, correlation_id: nil, request_id: nil, straddle_account_id: nil, request_options: {})
+        #
+        # @param account_number [String] Body param: The bank account number.
+        #
+        # @param account_type [Symbol, Straddle::Models::Bridge::LinkBankAccountParams::AccountType] Body param:
+        #
+        # @param customer_id [String] Body param: Unique identifier of the related customer object.
+        #
+        # @param routing_number [String] Body param: The routing number of the bank account.
+        #
+        # @param config [Straddle::Models::Bridge::LinkBankAccountParams::Config] Body param:
+        #
+        # @param metadata [Hash{Symbol=>String}, nil] Body param: Up to 20 additional user-defined key-value pairs. Useful for storing
+        #
+        # @param correlation_id [String] Header param: Optional client generated identifier to trace and debug a series o
+        #
+        # @param request_id [String] Header param: Optional client generated identifier to trace and debug a request.
+        #
+        # @param straddle_account_id [String] Header param: For use by platforms to specify an account id and set scope of a r
+        #
+        # @param request_options [Straddle::RequestOptions, Hash{Symbol=>Object}, nil]
+        #
+        # @return [Straddle::Models::PaykeyV1]
+        #
+        # @see Straddle::Models::Bridge::LinkBankAccountParams
+        def bank_account(params)
+          parsed, options = Straddle::Bridge::LinkBankAccountParams.dump_request(params)
+          header_params =
+            {
+              correlation_id: "correlation-id",
+              request_id: "request-id",
+              straddle_account_id: "straddle-account-id"
+            }
+          @client.request(
+            method: :post,
+            path: "v1/bridge/bank_account",
+            headers: parsed.slice(*header_params.keys).transform_keys(header_params),
+            body: parsed.except(*header_params.keys),
+            model: Straddle::PaykeyV1,
+            options: options
+          )
+        end
+
+        # Some parameter documentations has been truncated, see
+        # {Straddle::Models::Bridge::LinkCreatePaykeyParams} for more details.
+        #
+        # Creates a new paykey using a Quiltt token as the source. This endpoint allows
+        # you to create a secure payment token linked to a bank account authenticated
+        # through Quiltt.
+        #
+        # @overload create_paykey(customer_id:, quiltt_token:, config: nil, metadata: nil, correlation_id: nil, request_id: nil, straddle_account_id: nil, request_options: {})
+        #
+        # @param customer_id [String] Body param: Unique identifier of the related customer object.
+        #
+        # @param quiltt_token [String] Body param: Quiltt processor token generated by your application for use with th
+        #
+        # @param config [Straddle::Models::Bridge::LinkCreatePaykeyParams::Config] Body param:
+        #
+        # @param metadata [Hash{Symbol=>String}, nil] Body param: Up to 20 additional user-defined key-value pairs. Useful for storing
+        #
+        # @param correlation_id [String] Header param: Optional client generated identifier to trace and debug a series o
+        #
+        # @param request_id [String] Header param: Optional client generated identifier to trace and debug a request.
+        #
+        # @param straddle_account_id [String] Header param: For use by platforms to specify an account id and set scope of a r
+        #
+        # @param request_options [Straddle::RequestOptions, Hash{Symbol=>Object}, nil]
+        #
+        # @return [Straddle::Models::Bridge::LinkCreatePaykeyResponse]
+        #
+        # @see Straddle::Models::Bridge::LinkCreatePaykeyParams
+        def create_paykey(params)
+          parsed, options = Straddle::Bridge::LinkCreatePaykeyParams.dump_request(params)
+          header_params =
+            {
+              correlation_id: "correlation-id",
+              request_id: "request-id",
+              straddle_account_id: "straddle-account-id"
+            }
+          @client.request(
+            method: :post,
+            path: "v1/bridge/quiltt",
+            headers: parsed.slice(*header_params.keys).transform_keys(header_params),
+            body: parsed.except(*header_params.keys),
+            model: Straddle::Models::Bridge::LinkCreatePaykeyResponse,
+            options: options
+          )
+        end
+
+        # Some parameter documentations has been truncated, see
+        # {Straddle::Models::Bridge::LinkCreateTanParams} for more details.
+        #
+        # @overload create_tan(account_type:, customer_id:, routing_number:, tan:, config: nil, metadata: nil, correlation_id: nil, request_id: nil, straddle_account_id: nil, request_options: {})
+        #
+        # @param account_type [Symbol, Straddle::Models::Bridge::LinkCreateTanParams::AccountType] Body param:
+        #
+        # @param customer_id [String] Body param: Unique identifier of the related customer object.
+        #
+        # @param routing_number [String] Body param: Bank routing number.
+        #
+        # @param tan [String] Body param: Tokenized account number.
+        #
+        # @param config [Straddle::Models::Bridge::LinkCreateTanParams::Config] Body param:
+        #
+        # @param metadata [Hash{Symbol=>String}, nil] Body param: Up to 20 additional user-defined key-value pairs. Useful for storing
+        #
+        # @param correlation_id [String] Header param: Optional client generated identifier to trace and debug a series o
+        #
+        # @param request_id [String] Header param: Optional client generated identifier to trace and debug a request.
+        #
+        # @param straddle_account_id [String] Header param: For use by platforms to specify an account id and set scope of a r
+        #
+        # @param request_options [Straddle::RequestOptions, Hash{Symbol=>Object}, nil]
+        #
+        # @return [Straddle::Models::Bridge::LinkCreateTanResponse]
+        #
+        # @see Straddle::Models::Bridge::LinkCreateTanParams
+        def create_tan(params)
+          parsed, options = Straddle::Bridge::LinkCreateTanParams.dump_request(params)
+          header_params =
+            {
+              correlation_id: "correlation-id",
+              request_id: "request-id",
+              straddle_account_id: "straddle-account-id"
+            }
+          @client.request(
+            method: :post,
+            path: "v1/bridge/tan",
+            headers: parsed.slice(*header_params.keys).transform_keys(header_params),
+            body: parsed.except(*header_params.keys),
+            model: Straddle::Models::Bridge::LinkCreateTanResponse,
+            options: options
+          )
+        end
+
+        # Some parameter documentations has been truncated, see
+        # {Straddle::Models::Bridge::LinkPlaidParams} for more details.
+        #
+        # Use Bridge to create a new paykey using a Plaid token as the source. This
+        # endpoint allows you to create a secure payment token linked to a bank account
+        # authenticated through Plaid.
+        #
+        # @overload plaid(customer_id:, plaid_token:, config: nil, metadata: nil, correlation_id: nil, request_id: nil, straddle_account_id: nil, request_options: {})
+        #
+        # @param customer_id [String] Body param: Unique identifier of the related customer object.
+        #
+        # @param plaid_token [String] Body param: Plaid processor token generated by your application for use with the
+        #
+        # @param config [Straddle::Models::Bridge::LinkPlaidParams::Config] Body param:
+        #
+        # @param metadata [Hash{Symbol=>String}, nil] Body param: Up to 20 additional user-defined key-value pairs. Useful for storing
+        #
+        # @param correlation_id [String] Header param: Optional client generated identifier to trace and debug a series o
+        #
+        # @param request_id [String] Header param: Optional client generated identifier to trace and debug a request.
+        #
+        # @param straddle_account_id [String] Header param: For use by platforms to specify an account id and set scope of a r
+        #
+        # @param request_options [Straddle::RequestOptions, Hash{Symbol=>Object}, nil]
+        #
+        # @return [Straddle::Models::PaykeyV1]
+        #
+        # @see Straddle::Models::Bridge::LinkPlaidParams
+        def plaid(params)
+          parsed, options = Straddle::Bridge::LinkPlaidParams.dump_request(params)
+          header_params =
+            {
+              correlation_id: "correlation-id",
+              request_id: "request-id",
+              straddle_account_id: "straddle-account-id"
+            }
+          @client.request(
+            method: :post,
+            path: "v1/bridge/plaid",
+            headers: parsed.slice(*header_params.keys).transform_keys(header_params),
+            body: parsed.except(*header_params.keys),
+            model: Straddle::PaykeyV1,
+            options: options
+          )
+        end
+
+        # @api private
+        #
+        # @param client [Straddle::Client]
+        def initialize(client:)
+          @client = client
+        end
+      end
+    end
+  end
+end

data/lib/straddle/resources/bridge.rb

@@ -0,0 +1,58 @@
+# frozen_string_literal: true
+
+module Straddle
+  module Resources
+    class Bridge
+      # @return [Straddle::Resources::Bridge::Link]
+      attr_reader :link
+
+      # Some parameter documentations has been truncated, see
+      # {Straddle::Models::BridgeInitializeParams} for more details.
+      #
+      # Use this endpoint to generate a session token for use in the Bridge widget.
+      #
+      # @overload initialize_(customer_id:, config: nil, correlation_id: nil, request_id: nil, straddle_account_id: nil, request_options: {})
+      #
+      # @param customer_id [String] Body param: The Straddle generated unique identifier of the `customer` to create
+      #
+      # @param config [Straddle::Models::BridgeInitializeParams::Config] Body param:
+      #
+      # @param correlation_id [String] Header param: Optional client generated identifier to trace and debug a series o
+      #
+      # @param request_id [String] Header param: Optional client generated identifier to trace and debug a request.
+      #
+      # @param straddle_account_id [String] Header param: For use by platforms to specify an account id and set scope of a r
+      #
+      # @param request_options [Straddle::RequestOptions, Hash{Symbol=>Object}, nil]
+      #
+      # @return [Straddle::Models::BridgeTokenV1]
+      #
+      # @see Straddle::Models::BridgeInitializeParams
+      def initialize_(params)
+        parsed, options = Straddle::BridgeInitializeParams.dump_request(params)
+        header_params =
+          {
+            correlation_id: "correlation-id",
+            request_id: "request-id",
+            straddle_account_id: "straddle-account-id"
+          }
+        @client.request(
+          method: :post,
+          path: "v1/bridge/initialize",
+          headers: parsed.slice(*header_params.keys).transform_keys(header_params),
+          body: parsed.except(*header_params.keys),
+          model: Straddle::BridgeTokenV1,
+          options: options
+        )
+      end
+
+      # @api private
+      #
+      # @param client [Straddle::Client]
+      def initialize(client:)
+        @client = client
+        @link = Straddle::Resources::Bridge::Link.new(client: client)
+      end
+    end
+  end
+end