method-ruby 0.1.0 → 0.2.0

data/rbi/method_ruby/resources/forwarding_requests.rbi

@@ -0,0 +1,77 @@
+# typed: strong
+
+module MethodRuby
+  module Resources
+    # Request forwarding with sensitive data injection
+    class ForwardingRequests
+      # Creates a new forwarding request that proxies an HTTP request to a third-party
+      # endpoint with sensitive data injection.
+      #
+      # Forwarding-specific validation and execution failures are returned in the
+      # standard error envelope. Common forwarding `sub_type` values include
+      # `URL_NOT_ALLOWED`, `INVALID_METHOD`, `BODY_JSON_INVALID`, `BINDING_NOT_FOUND`,
+      # `FORWARDED_REQUEST_NETWORK_ERROR`, and `FORWARDED_REQUEST_TIMEOUT`.
+      sig do
+        params(
+          bindings: T::Hash[Symbol, String],
+          body: String,
+          headers: T::Hash[Symbol, String],
+          method_: MethodRuby::ForwardingRequestCreateParams::Method::OrSymbol,
+          url: String,
+          method_version:
+            MethodRuby::ForwardingRequestCreateParams::MethodVersion::OrSymbol,
+          metadata: T.nilable(T.anything),
+          idempotency_key: String,
+          request_options: MethodRuby::RequestOptions::OrHash
+        ).returns(MethodRuby::Models::ForwardingRequestCreateResponse)
+      end
+      def create(
+        # Body param: Key-value map of secret bindings to inject into the request.
+        bindings:,
+        # Body param: Body to send with the forwarded request.
+        body:,
+        # Body param: HTTP headers to include in the forwarded request.
+        headers:,
+        # Body param: HTTP method to use.
+        method_:,
+        # Body param: The destination URL for the forwarded request.
+        url:,
+        # Header param: API version to use for this request. This spec targets
+        # `2025-12-01`. The SDK sets this header automatically.
+        method_version:,
+        # Body param: Optional metadata to attach to the forwarding request.
+        metadata: nil,
+        # Header param: Idempotency key for safely retrying a write request. Reuse the
+        # same value when retrying the same logical operation to avoid creating duplicate
+        # side effects.
+        idempotency_key: nil,
+        request_options: {}
+      )
+      end
+
+      # Returns a single forwarding request by its identifier.
+      sig do
+        params(
+          id: String,
+          method_version:
+            MethodRuby::ForwardingRequestRetrieveParams::MethodVersion::OrSymbol,
+          request_options: MethodRuby::RequestOptions::OrHash
+        ).returns(MethodRuby::Models::ForwardingRequestRetrieveResponse)
+      end
+      def retrieve(
+        # Unique identifier for the forwarding request.
+        id,
+        # API version to use for this request. This spec targets `2025-12-01`. The SDK
+        # sets this header automatically.
+        method_version:,
+        request_options: {}
+      )
+      end
+
+      # @api private
+      sig { params(client: MethodRuby::Client).returns(T.attached_class) }
+      def self.new(client:)
+      end
+    end
+  end
+end

data/rbi/method_ruby/resources/managed_accounts/transactions.rbi

@@ -0,0 +1,52 @@
+# typed: strong
+
+module MethodRuby
+  module Resources
+    class ManagedAccounts
+      # Method-managed accounts
+      class Transactions
+        # Returns a paginated list of transactions for a specific managed account.
+        sig do
+          params(
+            macc_id: String,
+            method_version:
+              MethodRuby::ManagedAccounts::TransactionListParams::MethodVersion::OrSymbol,
+            from_date: Date,
+            page: Integer,
+            page_cursor: String,
+            page_limit: Integer,
+            to_date: Date,
+            request_options: MethodRuby::RequestOptions::OrHash
+          ).returns(
+            MethodRuby::Models::ManagedAccounts::TransactionListResponse
+          )
+        end
+        def list(
+          # Path param: Unique identifier for the managed account.
+          macc_id,
+          # Header param: API version to use for this request. This spec targets
+          # `2025-12-01`. The SDK sets this header automatically.
+          method_version:,
+          # Query param: Filter results from this date (inclusive, YYYY-MM-DD format).
+          from_date: nil,
+          # Query param: Page number for pagination (1-indexed).
+          page: nil,
+          # Query param: Cursor for cursor-based pagination. Use the value from
+          # `Pagination-Page-Cursor-Next` or `Pagination-Page-Cursor-Prev` response headers.
+          page_cursor: nil,
+          # Query param: Number of items per page.
+          page_limit: nil,
+          # Query param: Filter results to this date (inclusive, YYYY-MM-DD format).
+          to_date: nil,
+          request_options: {}
+        )
+        end
+
+        # @api private
+        sig { params(client: MethodRuby::Client).returns(T.attached_class) }
+        def self.new(client:)
+        end
+      end
+    end
+  end
+end

data/rbi/method_ruby/resources/managed_accounts.rbi

@@ -0,0 +1,52 @@
+# typed: strong
+
+module MethodRuby
+  module Resources
+    # Method-managed accounts
+    class ManagedAccounts
+      # Method-managed accounts
+      sig { returns(MethodRuby::Resources::ManagedAccounts::Transactions) }
+      attr_reader :transactions
+
+      # Returns a single managed account by its identifier.
+      sig do
+        params(
+          macc_id: String,
+          method_version:
+            MethodRuby::ManagedAccountRetrieveParams::MethodVersion::OrSymbol,
+          request_options: MethodRuby::RequestOptions::OrHash
+        ).returns(MethodRuby::Models::ManagedAccountRetrieveResponse)
+      end
+      def retrieve(
+        # Unique identifier for the managed account.
+        macc_id,
+        # API version to use for this request. This spec targets `2025-12-01`. The SDK
+        # sets this header automatically.
+        method_version:,
+        request_options: {}
+      )
+      end
+
+      # Returns all managed accounts for the team.
+      sig do
+        params(
+          method_version:
+            MethodRuby::ManagedAccountListParams::MethodVersion::OrSymbol,
+          request_options: MethodRuby::RequestOptions::OrHash
+        ).returns(MethodRuby::Models::ManagedAccountListResponse)
+      end
+      def list(
+        # API version to use for this request. This spec targets `2025-12-01`. The SDK
+        # sets this header automatically.
+        method_version:,
+        request_options: {}
+      )
+      end
+
+      # @api private
+      sig { params(client: MethodRuby::Client).returns(T.attached_class) }
+      def self.new(client:)
+      end
+    end
+  end
+end

data/rbi/method_ruby/resources/merchants.rbi

@@ -0,0 +1,54 @@
+# typed: strong
+
+module MethodRuby
+  module Resources
+    # Merchant directory
+    class Merchants
+      # Returns a single merchant by its identifier.
+      sig do
+        params(
+          mch_id: String,
+          method_version:
+            MethodRuby::MerchantRetrieveParams::MethodVersion::OrSymbol,
+          request_options: MethodRuby::RequestOptions::OrHash
+        ).returns(MethodRuby::Models::MerchantRetrieveResponse)
+      end
+      def retrieve(
+        # Unique identifier for the merchant.
+        mch_id,
+        # API version to use for this request. This spec targets `2025-12-01`. The SDK
+        # sets this header automatically.
+        method_version:,
+        request_options: {}
+      )
+      end
+
+      # Returns a list of merchants from the Method merchant directory.
+      sig do
+        params(
+          method_version:
+            MethodRuby::MerchantListParams::MethodVersion::OrSymbol,
+          name: String,
+          type: MethodRuby::MerchantListParams::Type::OrSymbol,
+          request_options: MethodRuby::RequestOptions::OrHash
+        ).returns(MethodRuby::Models::MerchantListResponse)
+      end
+      def list(
+        # Header param: API version to use for this request. This spec targets
+        # `2025-12-01`. The SDK sets this header automatically.
+        method_version:,
+        # Query param: Search merchants by name.
+        name: nil,
+        # Query param: Filter merchants by account type.
+        type: nil,
+        request_options: {}
+      )
+      end
+
+      # @api private
+      sig { params(client: MethodRuby::Client).returns(T.attached_class) }
+      def self.new(client:)
+      end
+    end
+  end
+end

data/rbi/method_ruby/resources/payments/reversals.rbi

@@ -0,0 +1,86 @@
+# typed: strong
+
+module MethodRuby
+  module Resources
+    class Payments
+      # Reversals for payments
+      class Reversals
+        # Retrieves a specific reversal for a payment by its unique identifier.
+        sig do
+          params(
+            reversal_id: String,
+            payment_id: String,
+            method_version:
+              MethodRuby::Payments::ReversalRetrieveParams::MethodVersion::OrSymbol,
+            request_options: MethodRuby::RequestOptions::OrHash
+          ).returns(MethodRuby::Models::Payments::ReversalRetrieveResponse)
+        end
+        def retrieve(
+          # Path param: Unique identifier for the reversal.
+          reversal_id,
+          # Path param: Unique identifier for the payment.
+          payment_id:,
+          # Header param: API version to use for this request. This spec targets
+          # `2025-12-01`. The SDK sets this header automatically.
+          method_version:,
+          request_options: {}
+        )
+        end
+
+        # Updates a payment reversal. Currently supports updating the reversal status.
+        sig do
+          params(
+            reversal_id: String,
+            payment_id: String,
+            method_version:
+              MethodRuby::Payments::ReversalUpdateParams::MethodVersion::OrSymbol,
+            status: String,
+            idempotency_key: String,
+            request_options: MethodRuby::RequestOptions::OrHash
+          ).returns(MethodRuby::Models::Payments::ReversalUpdateResponse)
+        end
+        def update(
+          # Path param: Unique identifier for the reversal.
+          reversal_id,
+          # Path param: Unique identifier for the payment.
+          payment_id:,
+          # Header param: API version to use for this request. This spec targets
+          # `2025-12-01`. The SDK sets this header automatically.
+          method_version:,
+          # Body param: Updated status for the reversal.
+          status: nil,
+          # Header param: Idempotency key for safely retrying a write request. Reuse the
+          # same value when retrying the same logical operation to avoid creating duplicate
+          # side effects.
+          idempotency_key: nil,
+          request_options: {}
+        )
+        end
+
+        # Returns a list of all reversals associated with a specific payment.
+        sig do
+          params(
+            payment_id: String,
+            method_version:
+              MethodRuby::Payments::ReversalListParams::MethodVersion::OrSymbol,
+            request_options: MethodRuby::RequestOptions::OrHash
+          ).returns(MethodRuby::Models::Payments::ReversalListResponse)
+        end
+        def list(
+          # Unique identifier for the payment.
+          payment_id,
+          # API version to use for this request. This spec targets `2025-12-01`. The SDK
+          # sets this header automatically.
+          method_version:,
+          request_options: {}
+        )
+        end
+
+        # @api private
+        sig { params(client: MethodRuby::Client).returns(T.attached_class) }
+        def self.new(client:)
+        end
+      end
+    end
+  end
+end

data/rbi/method_ruby/resources/payments.rbi

@@ -0,0 +1,177 @@
+# typed: strong
+
+module MethodRuby
+  module Resources
+    # ACH and clearing payments
+    class Payments
+      # Reversals for payments
+      sig { returns(MethodRuby::Resources::Payments::Reversals) }
+      attr_reader :reversals
+
+      # Creates a new payment to transfer funds from a source account to a destination
+      # account.
+      sig do
+        params(
+          amount: Integer,
+          description: String,
+          destination: String,
+          source: String,
+          method_version:
+            MethodRuby::PaymentCreateParams::MethodVersion::OrSymbol,
+          dry_run: T::Boolean,
+          fee: MethodRuby::PaymentCreateParams::Fee::OrHash,
+          metadata: T.nilable(T::Hash[Symbol, T.anything]),
+          reversal_account: String,
+          idempotency_key: String,
+          request_options: MethodRuby::RequestOptions::OrHash
+        ).returns(MethodRuby::Models::PaymentCreateResponse)
+      end
+      def create(
+        # Body param: Payment amount in cents.
+        amount:,
+        # Body param: Human-readable description for the payment.
+        description:,
+        # Body param: The destination account ID.
+        destination:,
+        # Body param: The source account ID.
+        source:,
+        # Header param: API version to use for this request. This spec targets
+        # `2025-12-01`. The SDK sets this header automatically.
+        method_version:,
+        # Body param: Validate the payment request without moving funds.
+        dry_run: nil,
+        # Body param: Optional fee configuration for the payment.
+        fee: nil,
+        # Body param: Arbitrary key-value metadata attached to the resource.
+        metadata: nil,
+        # Body param: Account ID to use for the reversal leg of the payment, if
+        # applicable.
+        reversal_account: nil,
+        # Header param: Idempotency key for safely retrying a write request. Reuse the
+        # same value when retrying the same logical operation to avoid creating duplicate
+        # side effects.
+        idempotency_key: nil,
+        request_options: {}
+      )
+      end
+
+      # Retrieves a payment by its unique identifier.
+      sig do
+        params(
+          payment_id: String,
+          method_version:
+            MethodRuby::PaymentRetrieveParams::MethodVersion::OrSymbol,
+          expand: T::Array[MethodRuby::PaymentRetrieveParams::Expand::OrSymbol],
+          request_options: MethodRuby::RequestOptions::OrHash
+        ).returns(MethodRuby::Models::PaymentRetrieveResponse)
+      end
+      def retrieve(
+        # Path param: Unique identifier for the payment.
+        payment_id,
+        # Header param: API version to use for this request. This spec targets
+        # `2025-12-01`. The SDK sets this header automatically.
+        method_version:,
+        # Query param: Expand payment source or destination accounts inline. Nested
+        # account expansion is supported for latest verification sessions on the source or
+        # destination.
+        expand: nil,
+        request_options: {}
+      )
+      end
+
+      # Returns a paginated list of payments. Results can be filtered by status, type,
+      # accounts, holders, reversal, and date range.
+      sig do
+        params(
+          method_version:
+            MethodRuby::PaymentListParams::MethodVersion::OrSymbol,
+          acc_id: String,
+          destination: String,
+          destination_holder_id: String,
+          expand: T::Array[MethodRuby::PaymentListParams::Expand::OrSymbol],
+          from_date: Date,
+          holder_id: String,
+          page: Integer,
+          page_cursor: String,
+          page_limit: Integer,
+          reversal_id: String,
+          source: String,
+          source_holder_id: String,
+          status: MethodRuby::PaymentListParams::Status::OrSymbol,
+          to_date: Date,
+          type: MethodRuby::PaymentListParams::Type::OrSymbol,
+          request_options: MethodRuby::RequestOptions::OrHash
+        ).returns(MethodRuby::Models::PaymentListResponse)
+      end
+      def list(
+        # Header param: API version to use for this request. This spec targets
+        # `2025-12-01`. The SDK sets this header automatically.
+        method_version:,
+        # Query param: Filter payments by either the source or destination account ID.
+        acc_id: nil,
+        # Query param: Filter payments by destination account ID.
+        destination: nil,
+        # Query param: Filter payments by destination entity ID.
+        destination_holder_id: nil,
+        # Query param: Expand payment source or destination accounts inline. Nested
+        # account expansion is supported for latest verification sessions on the source or
+        # destination.
+        expand: nil,
+        # Query param: Filter results from this date (inclusive, YYYY-MM-DD format).
+        from_date: nil,
+        # Query param: Filter payments by either the source or destination entity ID.
+        holder_id: nil,
+        # Query param: Page number for pagination (1-indexed).
+        page: nil,
+        # Query param: Cursor for cursor-based pagination. Use the value from
+        # `Pagination-Page-Cursor-Next` or `Pagination-Page-Cursor-Prev` response headers.
+        page_cursor: nil,
+        # Query param: Number of items per page.
+        page_limit: nil,
+        # Query param: Filter payments by reversal ID.
+        reversal_id: nil,
+        # Query param: Filter payments by source account ID.
+        source: nil,
+        # Query param: Filter payments by source entity ID.
+        source_holder_id: nil,
+        # Query param: Filter payments by status.
+        status: nil,
+        # Query param: Filter results to this date (inclusive, YYYY-MM-DD format).
+        to_date: nil,
+        # Query param: Filter payments by payment type.
+        type: nil,
+        request_options: {}
+      )
+      end
+
+      # Cancels a pending payment. Only payments with a `pending` status can be
+      # canceled.
+      sig do
+        params(
+          payment_id: String,
+          method_version:
+            MethodRuby::PaymentDeleteParams::MethodVersion::OrSymbol,
+          idempotency_key: String,
+          request_options: MethodRuby::RequestOptions::OrHash
+        ).returns(MethodRuby::Models::PaymentDeleteResponse)
+      end
+      def delete(
+        # Unique identifier for the payment.
+        payment_id,
+        # API version to use for this request. This spec targets `2025-12-01`. The SDK
+        # sets this header automatically.
+        method_version:,
+        # Idempotency key for safely retrying a write request. Reuse the same value when
+        # retrying the same logical operation to avoid creating duplicate side effects.
+        idempotency_key: nil,
+        request_options: {}
+      )
+      end
+
+      # @api private
+      sig { params(client: MethodRuby::Client).returns(T.attached_class) }
+      def self.new(client:)
+      end
+    end
+  end
+end

data/rbi/method_ruby/resources/ping.rbi

@@ -2,15 +2,21 @@
 
 module MethodRuby
   module Resources
-    # API health check endpoint.
+    # Health check endpoint
     class Ping
-      # Returns the API health status and version.
+      # Returns a simple health check response for authenticated API clients.
       sig do
-        params(request_options: MethodRuby::RequestOptions::OrHash).returns(
-          MethodRuby::Models::PingCheckResponse
-        )
+        params(
+          method_version: MethodRuby::PingCheckParams::MethodVersion::OrSymbol,
+          request_options: MethodRuby::RequestOptions::OrHash
+        ).returns(MethodRuby::Models::PingCheckResponse)
       end
-      def check(request_options: {})
+      def check(
+        # API version to use for this request. This spec targets `2025-12-01`. The SDK
+        # sets this header automatically.
+        method_version:,
+        request_options: {}
+      )
       end
 
       # @api private

data/rbi/method_ruby/resources/reports/download.rbi

@@ -0,0 +1,34 @@
+# typed: strong
+
+module MethodRuby
+  module Resources
+    class Reports
+      # Downloadable reports
+      class Download
+        # Returns the completed report as a CSV file attachment.
+        sig do
+          params(
+            report_id: String,
+            method_version:
+              MethodRuby::Reports::DownloadRetrieveParams::MethodVersion::OrSymbol,
+            request_options: MethodRuby::RequestOptions::OrHash
+          ).returns(StringIO)
+        end
+        def retrieve(
+          # Unique identifier for the report.
+          report_id,
+          # API version to use for this request. This spec targets `2025-12-01`. The SDK
+          # sets this header automatically.
+          method_version:,
+          request_options: {}
+        )
+        end
+
+        # @api private
+        sig { params(client: MethodRuby::Client).returns(T.attached_class) }
+        def self.new(client:)
+        end
+      end
+    end
+  end
+end

data/rbi/method_ruby/resources/reports.rbi

@@ -0,0 +1,62 @@
+# typed: strong
+
+module MethodRuby
+  module Resources
+    # Downloadable reports
+    class Reports
+      # Downloadable reports
+      sig { returns(MethodRuby::Resources::Reports::Download) }
+      attr_reader :download
+
+      # Creates a new report of the specified type. The report will be generated
+      # asynchronously and can be downloaded once its status is `completed`.
+      sig do
+        params(
+          type: MethodRuby::ReportCreateParams::Type::OrSymbol,
+          method_version:
+            MethodRuby::ReportCreateParams::MethodVersion::OrSymbol,
+          idempotency_key: String,
+          request_options: MethodRuby::RequestOptions::OrHash
+        ).returns(MethodRuby::Models::ReportCreateResponse)
+      end
+      def create(
+        # Body param: The type of report to generate.
+        type:,
+        # Header param: API version to use for this request. This spec targets
+        # `2025-12-01`. The SDK sets this header automatically.
+        method_version:,
+        # Header param: Idempotency key for safely retrying a write request. Reuse the
+        # same value when retrying the same logical operation to avoid creating duplicate
+        # side effects.
+        idempotency_key: nil,
+        request_options: {}
+      )
+      end
+
+      # Returns a single report by its identifier. Use this to check the status of a
+      # report before downloading.
+      sig do
+        params(
+          report_id: String,
+          method_version:
+            MethodRuby::ReportRetrieveParams::MethodVersion::OrSymbol,
+          request_options: MethodRuby::RequestOptions::OrHash
+        ).returns(MethodRuby::Models::ReportRetrieveResponse)
+      end
+      def retrieve(
+        # Unique identifier for the report.
+        report_id,
+        # API version to use for this request. This spec targets `2025-12-01`. The SDK
+        # sets this header automatically.
+        method_version:,
+        request_options: {}
+      )
+      end
+
+      # @api private
+      sig { params(client: MethodRuby::Client).returns(T.attached_class) }
+      def self.new(client:)
+      end
+    end
+  end
+end