modern_treasury 0.1.0.pre.alpha.15 → 0.1.0.pre.alpha.17

data/rbi/lib/modern_treasury/resources/virtual_accounts.rbi

@@ -3,47 +3,80 @@
 module ModernTreasury
   module Resources
     class VirtualAccounts
+      # create virtual_account
       sig do
         params(
           internal_account_id: String,
           name: String,
-          account_details: T::Array[ModernTreasury::Models::VirtualAccountCreateParams::AccountDetail],
+          account_details: T::Array[
+            T.any(
+              ModernTreasury::Models::VirtualAccountCreateParams::AccountDetail,
+              ModernTreasury::Internal::AnyHash
+            )
+          ],
           counterparty_id: String,
           credit_ledger_account_id: String,
           debit_ledger_account_id: String,
           description: String,
-          ledger_account: ModernTreasury::Models::VirtualAccountCreateParams::LedgerAccount,
+          ledger_account: T.any(
+            ModernTreasury::Models::VirtualAccountCreateParams::LedgerAccount,
+            ModernTreasury::Internal::AnyHash
+          ),
           metadata: T::Hash[Symbol, String],
-          routing_details: T::Array[ModernTreasury::Models::VirtualAccountCreateParams::RoutingDetail],
-          request_options: T.nilable(T.any(ModernTreasury::RequestOptions, T::Hash[Symbol, T.anything]))
+          routing_details: T::Array[
+            T.any(
+              ModernTreasury::Models::VirtualAccountCreateParams::RoutingDetail,
+              ModernTreasury::Internal::AnyHash
+            )
+          ],
+          request_options: T.nilable(T.any(ModernTreasury::RequestOptions, ModernTreasury::Internal::AnyHash))
         )
           .returns(ModernTreasury::Models::VirtualAccount)
       end
       def create(
+        # The ID of the internal account that this virtual account is associated with.
         internal_account_id:,
+        # The name of the virtual account.
         name:,
+        # An array of account detail objects.
         account_details: nil,
+        # The ID of the counterparty that the virtual account belongs to.
         counterparty_id: nil,
+        # The ID of a credit normal ledger account. When money leaves the virtual account,
+        # this ledger account will be credited. Must be accompanied by a
+        # debit_ledger_account_id if present.
         credit_ledger_account_id: nil,
+        # The ID of a debit normal ledger account. When money enters the virtual account,
+        # this ledger account will be debited. Must be accompanied by a
+        # credit_ledger_account_id if present.
         debit_ledger_account_id: nil,
+        # An optional description for internal use.
         description: nil,
+        # Specifies a ledger account object that will be created with the virtual account.
+        # The resulting ledger account is linked to the virtual account for auto-ledgering
+        # IPDs.
         ledger_account: nil,
+        # Additional data represented as key-value pairs. Both the key and value must be
+        # strings.
         metadata: nil,
+        # An array of routing detail objects.
         routing_details: nil,
         request_options: {}
-      )
-      end
-
+      ); end
+      # get virtual_account
       sig do
         params(
           id: String,
-          request_options: T.nilable(T.any(ModernTreasury::RequestOptions, T::Hash[Symbol, T.anything]))
+          request_options: T.nilable(T.any(ModernTreasury::RequestOptions, ModernTreasury::Internal::AnyHash))
         )
           .returns(ModernTreasury::Models::VirtualAccount)
       end
-      def retrieve(id, request_options: {})
-      end
-
+      def retrieve(
+        # Virtual Acccount ID
+        id,
+        request_options: {}
+      ); end
+      # update virtual_account
       sig do
         params(
           id: String,
@@ -51,20 +84,21 @@ module ModernTreasury
           ledger_account_id: String,
           metadata: T::Hash[Symbol, String],
           name: T.nilable(String),
-          request_options: T.nilable(T.any(ModernTreasury::RequestOptions, T::Hash[Symbol, T.anything]))
+          request_options: T.nilable(T.any(ModernTreasury::RequestOptions, ModernTreasury::Internal::AnyHash))
         )
           .returns(ModernTreasury::Models::VirtualAccount)
       end
       def update(
+        # Virtual Acccount ID
         id,
         counterparty_id: nil,
+        # The ledger account that you'd like to link to the virtual account.
         ledger_account_id: nil,
         metadata: nil,
         name: nil,
         request_options: {}
-      )
-      end
-
+      ); end
+      # Get a list of virtual accounts.
       sig do
         params(
           after_cursor: T.nilable(String),
@@ -72,33 +106,37 @@ module ModernTreasury
           internal_account_id: String,
           metadata: T::Hash[Symbol, String],
           per_page: Integer,
-          request_options: T.nilable(T.any(ModernTreasury::RequestOptions, T::Hash[Symbol, T.anything]))
+          request_options: T.nilable(T.any(ModernTreasury::RequestOptions, ModernTreasury::Internal::AnyHash))
         )
-          .returns(ModernTreasury::Page[ModernTreasury::Models::VirtualAccount])
+          .returns(ModernTreasury::Internal::Page[ModernTreasury::Models::VirtualAccount])
       end
       def list(
         after_cursor: nil,
         counterparty_id: nil,
         internal_account_id: nil,
+        # For example, if you want to query for records with metadata key `Type` and value
+        # `Loan`, the query would be `metadata%5BType%5D=Loan`. This encodes the query
+        # parameters.
         metadata: nil,
         per_page: nil,
         request_options: {}
-      )
-      end
-
+      ); end
+      # delete virtual_account
       sig do
         params(
           id: String,
-          request_options: T.nilable(T.any(ModernTreasury::RequestOptions, T::Hash[Symbol, T.anything]))
+          request_options: T.nilable(T.any(ModernTreasury::RequestOptions, ModernTreasury::Internal::AnyHash))
         )
           .returns(ModernTreasury::Models::VirtualAccount)
       end
-      def delete(id, request_options: {})
-      end
-
-      sig { params(client: ModernTreasury::Client).void }
-      def initialize(client:)
-      end
+      def delete(
+        # Virtual Acccount ID
+        id,
+        request_options: {}
+      ); end
+      # @api private
+      sig { params(client: ModernTreasury::Client).returns(T.attached_class) }
+      def self.new(client:); end
     end
   end
 end

data/rbi/lib/modern_treasury/version.rbi

@@ -1,5 +1,5 @@
 # typed: strong
 
 module ModernTreasury
-  VERSION = "0.1.0-alpha.15"
+  VERSION = T.let(T.unsafe(nil), String)
 end

data/sig/modern_treasury/client.rbs

@@ -1,5 +1,5 @@
 module ModernTreasury
-  class Client < ModernTreasury::BaseClient
+  class Client < ModernTreasury::Internal::Transport::BaseClient
     DEFAULT_MAX_RETRIES: 2
 
     DEFAULT_TIMEOUT_IN_SECONDS: Float
@@ -86,17 +86,21 @@ module ModernTreasury
 
     attr_reader legal_entity_associations: ModernTreasury::Resources::LegalEntityAssociations
 
+    def ping: (
+      ?request_options: ModernTreasury::request_opts
+    ) -> ModernTreasury::Models::PingResponse
+
     private def auth_headers: -> ::Hash[String, String]
 
     def initialize: (
-      base_url: String?,
-      api_key: String?,
-      organization_id: String?,
-      max_retries: Integer,
-      timeout: Float,
-      initial_retry_delay: Float,
-      max_retry_delay: Float,
-      idempotency_header: String
+      ?api_key: String?,
+      ?organization_id: String?,
+      ?base_url: String?,
+      ?max_retries: Integer,
+      ?timeout: Float,
+      ?initial_retry_delay: Float,
+      ?max_retry_delay: Float,
+      ?idempotency_header: String
     ) -> void
   end
 end

data/sig/modern_treasury/errors.rbs

@@ -1,98 +1,101 @@
 module ModernTreasury
-  class Error < StandardError
-    attr_reader cause: StandardError?
-  end
-
-  class ConversionError < ModernTreasury::Error
-  end
-
-  class APIError < ModernTreasury::Error
-    attr_reader url: URI::Generic
-
-    attr_reader status: Integer?
-
-    attr_reader body: top?
-
-    def initialize: (
-      url: URI::Generic,
-      status: Integer?,
-      body: Object?,
-      request: nil,
-      response: nil,
-      message: String?
-    ) -> void
-  end
-
-  class APIConnectionError < ModernTreasury::APIError
-    def initialize: (
-      url: URI::Generic,
-      status: nil,
-      body: nil,
-      request: nil,
-      response: nil,
-      message: String?
-    ) -> void
-  end
-
-  class APITimeoutError < ModernTreasury::APIConnectionError
-    def initialize: (
-      url: URI::Generic,
-      status: nil,
-      body: nil,
-      request: nil,
-      response: nil,
-      message: String?
-    ) -> void
-  end
-
-  class APIStatusError < ModernTreasury::APIError
-    def self.for: (
-      url: URI::Generic,
-      status: Integer,
-      body: Object?,
-      request: nil,
-      response: nil
-    ) -> instance
-
-    def initialize: (
-      url: URI::Generic,
-      status: Integer,
-      body: Object?,
-      request: nil,
-      response: nil,
-      message: String?
-    ) -> void
-  end
-
-  class BadRequestError < ModernTreasury::APIStatusError
-    HTTP_STATUS: 400
-  end
-
-  class AuthenticationError < ModernTreasury::APIStatusError
-    HTTP_STATUS: 401
-  end
-
-  class PermissionDeniedError < ModernTreasury::APIStatusError
-    HTTP_STATUS: 403
-  end
-
-  class NotFoundError < ModernTreasury::APIStatusError
-    HTTP_STATUS: 404
-  end
-
-  class ConflictError < ModernTreasury::APIStatusError
-    HTTP_STATUS: 409
-  end
-
-  class UnprocessableEntityError < ModernTreasury::APIStatusError
-    HTTP_STATUS: 422
-  end
-
-  class RateLimitError < ModernTreasury::APIStatusError
-    HTTP_STATUS: 429
-  end
-
-  class InternalServerError < ModernTreasury::APIStatusError
-    HTTP_STATUS: Range[Integer]
+  module Errors
+    class Error < StandardError
+      attr_accessor cause: StandardError?
+    end
+
+    class ConversionError < ModernTreasury::Errors::Error
+    end
+
+    class APIError < ModernTreasury::Errors::Error
+      attr_accessor url: URI::Generic
+
+      attr_accessor status: Integer?
+
+      attr_accessor body: top?
+
+      def initialize: (
+        url: URI::Generic,
+        ?status: Integer?,
+        ?body: Object?,
+        ?request: nil,
+        ?response: nil,
+        ?message: String?
+      ) -> void
+    end
+
+    class APIConnectionError < ModernTreasury::Errors::APIError
+      def initialize: (
+        url: URI::Generic,
+        ?status: nil,
+        ?body: nil,
+        ?request: nil,
+        ?response: nil,
+        ?message: String?
+      ) -> void
+    end
+
+    class APITimeoutError < ModernTreasury::Errors::APIConnectionError
+      def initialize: (
+        url: URI::Generic,
+        ?status: nil,
+        ?body: nil,
+        ?request: nil,
+        ?response: nil,
+        ?message: String?
+      ) -> void
+    end
+
+    class APIStatusError < ModernTreasury::Errors::APIError
+      def self.for: (
+        url: URI::Generic,
+        status: Integer,
+        body: Object?,
+        request: nil,
+        response: nil,
+        ?message: String?
+      ) -> instance
+
+      def initialize: (
+        url: URI::Generic,
+        status: Integer,
+        body: Object?,
+        request: nil,
+        response: nil,
+        ?message: String?
+      ) -> void
+    end
+
+    class BadRequestError < ModernTreasury::Errors::APIStatusError
+      HTTP_STATUS: 400
+    end
+
+    class AuthenticationError < ModernTreasury::Errors::APIStatusError
+      HTTP_STATUS: 401
+    end
+
+    class PermissionDeniedError < ModernTreasury::Errors::APIStatusError
+      HTTP_STATUS: 403
+    end
+
+    class NotFoundError < ModernTreasury::Errors::APIStatusError
+      HTTP_STATUS: 404
+    end
+
+    class ConflictError < ModernTreasury::Errors::APIStatusError
+      HTTP_STATUS: 409
+    end
+
+    class UnprocessableEntityError < ModernTreasury::Errors::APIStatusError
+      HTTP_STATUS: 422
+    end
+
+    class RateLimitError < ModernTreasury::Errors::APIStatusError
+      HTTP_STATUS: 429
+    end
+
+    class InternalServerError < ModernTreasury::Errors::APIStatusError
+      HTTP_STATUS: Range[Integer]
+    end
   end
 end

data/sig/modern_treasury/internal/page.rbs

@@ -0,0 +1,19 @@
+module ModernTreasury
+  module Internal
+    class Page[Elem] < ::Array[Elem]
+      include ModernTreasury::Internal::Type::BasePage[Elem]
+
+      attr_accessor per_page: Integer
+
+      attr_accessor after_cursor: String
+
+      def next_page?: -> bool
+
+      def next_page: -> self
+
+      def auto_paging_each: { (Elem arg0) -> void } -> void
+
+      def inspect: -> String
+    end
+  end
+end

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

@@ -0,0 +1,110 @@
+module ModernTreasury
+  module Internal
+    module Transport
+      class BaseClient
+        type request_components =
+          {
+            method: Symbol,
+            path: String | ::Array[String],
+            query: ::Hash[String, (::Array[String] | String)?]?,
+            headers: ::Hash[String, (String
+            | Integer
+            | ::Array[(String | Integer)?])?]?,
+            body: top?,
+            unwrap: Symbol?,
+            page: Class?,
+            stream: Class?,
+            model: ModernTreasury::Internal::Type::Converter::input?,
+            options: ModernTreasury::request_opts?
+          }
+
+        type request_input =
+          {
+            method: Symbol,
+            url: URI::Generic,
+            headers: ::Hash[String, String],
+            body: top,
+            max_retries: Integer,
+            timeout: Float
+          }
+
+        MAX_REDIRECTS: 20
+
+        PLATFORM_HEADERS: ::Hash[String, String]
+
+        def self.validate!: (
+          ModernTreasury::Internal::Transport::BaseClient::request_components req
+        ) -> void
+
+        def self.should_retry?: (
+          Integer status,
+          headers: ::Hash[String, String]
+        ) -> bool
+
+        def self.follow_redirect: (
+          ModernTreasury::Internal::Transport::BaseClient::request_input request,
+          status: Integer,
+          response_headers: ::Hash[String, String]
+        ) -> ModernTreasury::Internal::Transport::BaseClient::request_input
+
+        def self.reap_connection!: (
+          Integer | ModernTreasury::Errors::APIConnectionError status,
+          stream: Enumerable[String]?
+        ) -> void
+
+        # @api private
+        attr_accessor requester: ModernTreasury::Internal::Transport::PooledNetRequester
+
+        def initialize: (
+          base_url: String,
+          ?timeout: Float,
+          ?max_retries: Integer,
+          ?initial_retry_delay: Float,
+          ?max_retry_delay: Float,
+          ?headers: ::Hash[String, (String
+          | Integer
+          | ::Array[(String | Integer)?])?],
+          ?idempotency_header: String?
+        ) -> void
+
+        private def auth_headers: -> ::Hash[String, String]
+
+        private def generate_idempotency_key: -> String
+
+        private def build_request: (
+          ModernTreasury::Internal::Transport::BaseClient::request_components req,
+          ModernTreasury::request_options opts
+        ) -> ModernTreasury::Internal::Transport::BaseClient::request_input
+
+        private def retry_delay: (
+          ::Hash[String, String] headers,
+          retry_count: Integer
+        ) -> Float
+
+        private def send_request: (
+          ModernTreasury::Internal::Transport::BaseClient::request_input request,
+          redirect_count: Integer,
+          retry_count: Integer,
+          send_retry_header: bool
+        ) -> [Integer, top, Enumerable[String]]
+
+        def request: (
+          Symbol method,
+          String | ::Array[String] path,
+          ?query: ::Hash[String, (::Array[String] | String)?]?,
+          ?headers: ::Hash[String, (String
+          | Integer
+          | ::Array[(String | Integer)?])?]?,
+          ?body: top?,
+          ?unwrap: Symbol?,
+          ?page: Class?,
+          ?stream: Class?,
+          ?model: ModernTreasury::Internal::Type::Converter::input?,
+          ?options: ModernTreasury::request_opts?
+        ) -> top
+
+        def inspect: -> String
+      end
+    end
+  end
+end

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

@@ -0,0 +1,41 @@
+module ModernTreasury
+  module Internal
+    module Transport
+      class PooledNetRequester
+        type request =
+          {
+            method: Symbol,
+            url: URI::Generic,
+            headers: ::Hash[String, String],
+            body: top,
+            deadline: Float
+          }
+
+        KEEP_ALIVE_TIMEOUT: 30
+
+        def self.connect: (URI::Generic url) -> top
+
+        def self.calibrate_socket_timeout: (top conn, Float deadline) -> void
+
+        def self.build_request: (
+          ModernTreasury::Internal::Transport::PooledNetRequester::request request
+        ) {
+          (String arg0) -> void
+        } -> top
+
+        private def with_pool: (
+          URI::Generic url,
+          deadline: Float
+        ) {
+          (top arg0) -> void
+        } -> void
+
+        def execute: (
+          ModernTreasury::Internal::Transport::PooledNetRequester::request request
+        ) -> [Integer, top, Enumerable[String]]
+
+        def initialize: (?size: Integer) -> void
+      end
+    end
+  end
+end

data/sig/modern_treasury/internal/type/array_of.rbs

@@ -0,0 +1,38 @@
+module ModernTreasury
+  module Internal
+    module Type
+      class ArrayOf[Elem]
+        include ModernTreasury::Internal::Type::Converter
+
+        def self.[]: (
+          ::Hash[Symbol, top]
+          | ^-> ModernTreasury::Internal::Type::Converter::input
+          | ModernTreasury::Internal::Type::Converter::input type_info,
+          ?::Hash[Symbol, top] spec
+        ) -> instance
+
+        def ===: (top other) -> bool
+
+        def ==: (top other) -> bool
+
+        def coerce: (
+          ::Array[top] | top value,
+          state: ModernTreasury::Internal::Type::Converter::state
+        ) -> (::Array[top] | top)
+
+        def dump: (::Array[top] | top value) -> (::Array[top] | top)
+
+        def item_type: -> Elem
+
+        def nilable?: -> bool
+
+        def initialize: (
+          ::Hash[Symbol, top]
+          | ^-> ModernTreasury::Internal::Type::Converter::input
+          | ModernTreasury::Internal::Type::Converter::input type_info,
+          ?::Hash[Symbol, top] spec
+        ) -> void
+      end
+    end
+  end
+end