method-ruby 0.1.0 → 0.2.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 2e068b7ca8fa084e3f314ff86e8507db58a583b7a2076cd77e10373f561f7c9a
-  data.tar.gz: 2eee4e545445481460c3fa9e4b8ea97114da65e6e7c1972279e0b092b6181d3d
+  metadata.gz: 8b9d519f69c09942e49a7fcb629dedc274791b2c0e2bcbee6ed8120df18b81a8
+  data.tar.gz: 5c7fb487cbe80a21564bdda872bb46a3f6fae432a3b78c99f8cd00f018833d2b
 SHA512:
-  metadata.gz: 74ba3ce8e2efe937dc7f36573716c58f16fecf3cdc770b356c36aad36bfa2098e23c3aa4aa478aedd61e13568c5f483ea6277f7c83f9a2526ee5e5b9512d670b
-  data.tar.gz: a516af91e1c1b2cb25a946e49f97f82553c7012a11bd02b28b9e44b6eabcfc45d6bd60a3292479197819b1b7b7ff098e0297aff826d3bcb3b6e178a42fbf0410
+  metadata.gz: d712efc74e4b21a8da2625c354238ad25d1857faaf705430b6ab4d426da2c2b52f592ff33d2ed0fd9fa1cfd1730d1e8d0204faf0b84742b1801d84399ae5e9f8
+  data.tar.gz: b360342a25264e5c2d745ff7425271d388451a304692b9b842ca974ba87c1a45f4105975204d4e707f42502f8967a050aedb3a50455574fd51cb960e193cd724

data/CHANGELOG.md

@@ -1,5 +1,56 @@
 # Changelog
 
+## 0.2.1 (2026-05-14)
+
+Full Changelog: [v0.2.0...v0.2.1](https://github.com/MethodFi/method-ruby/compare/v0.2.0...v0.2.1)
+
+### Bug Fixes
+
+* **client:** elide content type header on requests without body ([ef9b0f8](https://github.com/MethodFi/method-ruby/commit/ef9b0f8fd16d52422dd4c39d39aec462fd643f3f))
+
+## 0.2.0 (2026-05-13)
+
+Full Changelog: [v0.1.0...v0.2.0](https://github.com/MethodFi/method-ruby/compare/v0.1.0...v0.2.0)
+
+### Features
+
+* **api:** api update ([af47da2](https://github.com/MethodFi/method-ruby/commit/af47da2508d3d342bc54332f173b79cf6f3b7c0a))
+* **api:** api update ([8e5e770](https://github.com/MethodFi/method-ruby/commit/8e5e7700b243158b84ff008f88977be67da1d943))
+* **api:** api update ([6c0df5d](https://github.com/MethodFi/method-ruby/commit/6c0df5d2c85d3d83b408d52efbb5c21439231eba))
+* **api:** api update ([b9615f5](https://github.com/MethodFi/method-ruby/commit/b9615f58e4eb8cd3bab01897575af11cf0cbd048))
+* **api:** api update ([647b0de](https://github.com/MethodFi/method-ruby/commit/647b0dee6a6ee0677d2290fdde4f08b523036ab6))
+* **api:** api update ([2a711e4](https://github.com/MethodFi/method-ruby/commit/2a711e40fc4f2c57c438f46f1a4139f9484e4471))
+* **api:** api update ([ff3b691](https://github.com/MethodFi/method-ruby/commit/ff3b691ccb7ab25f25eab458879197e77f8e62b6))
+* **api:** api update ([4e03102](https://github.com/MethodFi/method-ruby/commit/4e03102efcbcb3df274e7f859fb769730d0d849d))
+* **api:** api update ([04aa1fd](https://github.com/MethodFi/method-ruby/commit/04aa1fd04ae509df329eddeb4941d95befd86976))
+* **api:** api update ([3b62162](https://github.com/MethodFi/method-ruby/commit/3b62162c31e1da0a2e1102254833be89fadd4155))
+* **api:** api update ([b3b05fb](https://github.com/MethodFi/method-ruby/commit/b3b05fbda2d3b0b0e2572857e7a555e2372f13ee))
+* **api:** api update ([38069d4](https://github.com/MethodFi/method-ruby/commit/38069d48a88364363cfbf32b8c847b85ec739a2c))
+* **api:** api update ([87a323c](https://github.com/MethodFi/method-ruby/commit/87a323c95e9f757c81ad8bc63612394e38ce4218))
+* **api:** api update ([4e25055](https://github.com/MethodFi/method-ruby/commit/4e250553e6345f32b513402559917feff3b6e209))
+* **api:** api update ([6596062](https://github.com/MethodFi/method-ruby/commit/65960627a2c0813bddeb21c62a4a5cf002b86e3e))
+* **api:** api update ([2b771ec](https://github.com/MethodFi/method-ruby/commit/2b771ecbd9a188e752448d1535c808f8d028d388))
+* **api:** api update ([873818c](https://github.com/MethodFi/method-ruby/commit/873818c32f806b0cd96e7e870394ef7b08b3d236))
+* **api:** api update ([1dede0a](https://github.com/MethodFi/method-ruby/commit/1dede0aa6ca01d236e73ca7bb8de6230700b72fe))
+* support setting headers via env ([ad03068](https://github.com/MethodFi/method-ruby/commit/ad030687e0169b7f637870e650cd13522234edd1))
+
+
+### Bug Fixes
+
+* align path encoding with RFC 3986 section 3.3 ([7b0b9d4](https://github.com/MethodFi/method-ruby/commit/7b0b9d43594afdd587b18c6dbe6db3be4452df5b))
+* **internal:** correct multipart form field name encoding ([c7b9785](https://github.com/MethodFi/method-ruby/commit/c7b978541da04e71fb0d63a1021fd8c2bbdc65ff))
+* multipart encoding for file arrays ([493e837](https://github.com/MethodFi/method-ruby/commit/493e837a26e7e4cc17f284df866240072f0cd25c))
+* variable name typo ([0db6efb](https://github.com/MethodFi/method-ruby/commit/0db6efbf698718e8da7880565b538777bcda08cc))
+
+
+### Chores
+
+* **ci:** skip lint on metadata-only changes ([3630cb6](https://github.com/MethodFi/method-ruby/commit/3630cb625ff5bc5b6066369771607ac498cf4bc7))
+* **ci:** support opting out of skipping builds on metadata-only commits ([85a9e3b](https://github.com/MethodFi/method-ruby/commit/85a9e3bdbc1b07e54b60227eeabe813de996ddc3))
+* **internal:** more robust bootstrap script ([c5035cb](https://github.com/MethodFi/method-ruby/commit/c5035cb92e9123285a105e48af46865b237efdc0))
+* **internal:** tweak CI branches ([a5fed29](https://github.com/MethodFi/method-ruby/commit/a5fed29124705ccb337ba08d949a2bbe937a62da))
+* **internal:** update gitignore ([1870bcd](https://github.com/MethodFi/method-ruby/commit/1870bcdfe862c6a215c20aec3eafd8639a4f3c08))
+
 ## 0.1.0 (2026-03-11)
 
 Full Changelog: [v0.0.1...v0.1.0](https://github.com/MethodFi/method-ruby/compare/v0.0.1...v0.1.0)

data/README.md

@@ -8,8 +8,8 @@ It is generated with [Stainless](https://www.stainless.com/).
 
 Use the Method MCP Server to enable AI assistants to interact with this API, allowing them to explore endpoints, make test requests, and use documentation to help integrate this SDK into your application.
 
-[![Add to Cursor](https://cursor.com/deeplink/mcp-install-dark.svg)](https://cursor.com/en-US/install-mcp?name=%40methodfi%2Fmethod-node-mcp&config=eyJjb21tYW5kIjoibnB4IiwiYXJncyI6WyIteSIsIkBtZXRob2RmaS9tZXRob2Qtbm9kZS1tY3AiXSwiZW52Ijp7Ik1FVEhPRF9BUElfS0VZIjoiTXkgQVBJIEtleSJ9fQ)
-[![Install in VS Code](https://img.shields.io/badge/_-Add_to_VS_Code-blue?style=for-the-badge&logo=data:image/svg%2bxml;base64,PHN2ZyB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmciIGZpbGw9Im5vbmUiIHZpZXdCb3g9IjAgMCA0MCA0MCI+PHBhdGggZmlsbD0iI0VFRSIgZmlsbC1ydWxlPSJldmVub2RkIiBkPSJNMzAuMjM1IDM5Ljg4NGEyLjQ5MSAyLjQ5MSAwIDAgMS0xLjc4MS0uNzNMMTIuNyAyNC43OGwtMy40NiAyLjYyNC0zLjQwNiAyLjU4MmExLjY2NSAxLjY2NSAwIDAgMS0xLjA4Mi4zMzggMS42NjQgMS42NjQgMCAwIDEtMS4wNDYtLjQzMWwtMi4yLTJhMS42NjYgMS42NjYgMCAwIDEgMC0yLjQ2M0w3LjQ1OCAyMCA0LjY3IDE3LjQ1MyAxLjUwNyAxNC41N2ExLjY2NSAxLjY2NSAwIDAgMSAwLTIuNDYzbDIuMi0yYTEuNjY1IDEuNjY1IDAgMCAxIDIuMTMtLjA5N2w2Ljg2MyA1LjIwOUwyOC40NTIuODQ0YTIuNDg4IDIuNDg4IDAgMCAxIDEuODQxLS43MjljLjM1MS4wMDkuNjk5LjA5MSAxLjAxOS4yNDVsOC4yMzYgMy45NjFhMi41IDIuNSAwIDAgMSAxLjQxNSAyLjI1M3YuMDk5LS4wNDVWMzMuMzd2LS4wNDUuMDk1YTIuNTAxIDIuNTAxIDAgMCAxLTEuNDE2IDIuMjU3bC04LjIzNSAzLjk2MWEyLjQ5MiAyLjQ5MiAwIDAgMS0xLjA3Ny4yNDZabS43MTYtMjguOTQ3LTExLjk0OCA5LjA2MiAxMS45NTIgOS4wNjUtLjAwNC0xOC4xMjdaIi8+PC9zdmc+)](https://vscode.stainless.com/mcp/%7B%22name%22%3A%22%40methodfi%2Fmethod-node-mcp%22%2C%22command%22%3A%22npx%22%2C%22args%22%3A%5B%22-y%22%2C%22%40methodfi%2Fmethod-node-mcp%22%5D%2C%22env%22%3A%7B%22METHOD_API_KEY%22%3A%22My%20API%20Key%22%7D%7D)
+[![Add to Cursor](https://cursor.com/deeplink/mcp-install-dark.svg)](https://cursor.com/en-US/install-mcp?name=%40methodfi%2Fmethod-node-mcp&config=eyJjb21tYW5kIjoibnB4IiwiYXJncyI6WyIteSIsIkBtZXRob2RmaS9tZXRob2Qtbm9kZS1tY3AiXSwiZW52Ijp7Ik1FVEhPRF9BUElfS0VZIjoiTXkgQVBJIEtleSIsIk1FVEhPRF9PUEFMX1RPS0VOIjoiTXkgT3BhbCBUb2tlbiJ9fQ)
+[![Install in VS Code](https://img.shields.io/badge/_-Add_to_VS_Code-blue?style=for-the-badge&logo=data:image/svg%2bxml;base64,PHN2ZyB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmciIGZpbGw9Im5vbmUiIHZpZXdCb3g9IjAgMCA0MCA0MCI+PHBhdGggZmlsbD0iI0VFRSIgZmlsbC1ydWxlPSJldmVub2RkIiBkPSJNMzAuMjM1IDM5Ljg4NGEyLjQ5MSAyLjQ5MSAwIDAgMS0xLjc4MS0uNzNMMTIuNyAyNC43OGwtMy40NiAyLjYyNC0zLjQwNiAyLjU4MmExLjY2NSAxLjY2NSAwIDAgMS0xLjA4Mi4zMzggMS42NjQgMS42NjQgMCAwIDEtMS4wNDYtLjQzMWwtMi4yLTJhMS42NjYgMS42NjYgMCAwIDEgMC0yLjQ2M0w3LjQ1OCAyMCA0LjY3IDE3LjQ1MyAxLjUwNyAxNC41N2ExLjY2NSAxLjY2NSAwIDAgMSAwLTIuNDYzbDIuMi0yYTEuNjY1IDEuNjY1IDAgMCAxIDIuMTMtLjA5N2w2Ljg2MyA1LjIwOUwyOC40NTIuODQ0YTIuNDg4IDIuNDg4IDAgMCAxIDEuODQxLS43MjljLjM1MS4wMDkuNjk5LjA5MSAxLjAxOS4yNDVsOC4yMzYgMy45NjFhMi41IDIuNSAwIDAgMSAxLjQxNSAyLjI1M3YuMDk5LS4wNDVWMzMuMzd2LS4wNDUuMDk1YTIuNTAxIDIuNTAxIDAgMCAxLTEuNDE2IDIuMjU3bC04LjIzNSAzLjk2MWEyLjQ5MiAyLjQ5MiAwIDAgMS0xLjA3Ny4yNDZabS43MTYtMjguOTQ3LTExLjk0OCA5LjA2MiAxMS45NTIgOS4wNjUtLjAwNC0xOC4xMjdaIi8+PC9zdmc+)](https://vscode.stainless.com/mcp/%7B%22name%22%3A%22%40methodfi%2Fmethod-node-mcp%22%2C%22command%22%3A%22npx%22%2C%22args%22%3A%5B%22-y%22%2C%22%40methodfi%2Fmethod-node-mcp%22%5D%2C%22env%22%3A%7B%22METHOD_API_KEY%22%3A%22My%20API%20Key%22%2C%22METHOD_OPAL_TOKEN%22%3A%22My%20Opal%20Token%22%7D%7D)
 
 > Note: You may need to set environment variables in your MCP client.
 
@@ -26,7 +26,7 @@ To use this gem, install via Bundler by adding the following to your application
 <!-- x-release-please-start-version -->
 
 ```ruby
-gem "method-ruby", "~> 0.1.0"
+gem "method-ruby", "~> 0.2.1"
 ```
 
 <!-- x-release-please-end -->
@@ -42,7 +42,7 @@ method = MethodRuby::Client.new(
   environment: "sandbox" # or "production" | "dev"; defaults to "production"
 )
 
-entities = method.entities.list
+entities = method.entities.list(method_version: "2025-12-01")
 
 puts(entities.data)
 ```
@@ -53,7 +53,7 @@ When the library is unable to connect to the API, or if the API returns a non-su
 
 ```ruby
 begin
-  entity = method.entities.list
+  entity = method.entities.list(method_version: "2025-12-01")
 rescue MethodRuby::Errors::APIConnectionError => e
   puts("The server could not be reached")
   puts(e.cause)  # an underlying Exception, likely raised within `net/http`
@@ -96,7 +96,7 @@ method = MethodRuby::Client.new(
 )
 
 # Or, configure per-request:
-method.entities.list(request_options: {max_retries: 5})
+method.entities.list(method_version: "2025-12-01", request_options: {max_retries: 5})
 ```
 
 ### Timeouts
@@ -110,7 +110,7 @@ method = MethodRuby::Client.new(
 )
 
 # Or, configure per-request:
-method.entities.list(request_options: {timeout: 5})
+method.entities.list(method_version: "2025-12-01", request_options: {timeout: 5})
 ```
 
 On timeout, `MethodRuby::Errors::APITimeoutError` is raised.
@@ -142,6 +142,7 @@ Note: the `extra_` parameters of the same name overrides the documented paramete
 ```ruby
 entities =
   method.entities.list(
+    method_version: "2025-12-01",
     request_options: {
       extra_query: {my_query_parameter: value},
       extra_body: {my_body_parameter: value},
@@ -187,17 +188,17 @@ This library provides comprehensive [RBI](https://sorbet.org/docs/rbi) definitio
 You can provide typesafe request parameters like so:
 
 ```ruby
-method.entities.list
+method.entities.list(method_version: "2025-12-01")
 ```
 
 Or, equivalently:
 
 ```ruby
 # Hashes work, but are not typesafe:
-method.entities.list
+method.entities.list(method_version: "2025-12-01")
 
 # You can also splat a full Params class:
-params = MethodRuby::EntityListParams.new
+params = MethodRuby::EntityListParams.new(method_version: "2025-12-01")
 method.entities.list(**params)
 ```
 
@@ -206,25 +207,25 @@ method.entities.list(**params)
 Since this library does not depend on `sorbet-runtime`, it cannot provide [`T::Enum`](https://sorbet.org/docs/tenum) instances. Instead, we provide "tagged symbols" instead, which is always a primitive at runtime:
 
 ```ruby
-# :"2024-04-04"
-puts(MethodRuby::EntityCreateParams::MethodVersion::METHOD_VERSION_2024_04_04)
+# :active
+puts(MethodRuby::EntityListParams::Status::ACTIVE)
 
-# Revealed type: `T.all(MethodRuby::EntityCreateParams::MethodVersion, Symbol)`
-T.reveal_type(MethodRuby::EntityCreateParams::MethodVersion::METHOD_VERSION_2024_04_04)
+# Revealed type: `T.all(MethodRuby::EntityListParams::Status, Symbol)`
+T.reveal_type(MethodRuby::EntityListParams::Status::ACTIVE)
 ```
 
 Enum parameters have a "relaxed" type, so you can either pass in enum constants or their literal value:
 
 ```ruby
 # Using the enum constants preserves the tagged type information:
-method.entities.create(
-  method_version: MethodRuby::EntityCreateParams::MethodVersion::METHOD_VERSION_2024_04_04,
+method.entities.list(
+  status: MethodRuby::EntityListParams::Status::ACTIVE,
   # …
 )
 
 # Literal values are also permissible:
-method.entities.create(
-  method_version: :"2024-04-04",
+method.entities.list(
+  status: :active,
   # …
 )
 ```

data/lib/method_ruby/client.rb

@@ -25,16 +25,67 @@ module MethodRuby
       }
     # rubocop:enable Style/MutableConstant
 
-    # API key-based authentication. Include your API key as a Bearer token.
+    # Secret key for API authentication. Use your team's secret key as the Bearer
+    # token.
     # @return [String]
     attr_reader :api_key
 
-    # Entities represent your application's end-users. An Entity is the legal holder
-    # of an Account and can be either an individual or a corporation.
+    # Opal token for Opal session endpoints.
+    # @return [String, nil]
+    attr_reader :opal_token
+
+    # Individuals, corporations, and receive-only entities
     # @return [MethodRuby::Resources::Entities]
     attr_reader :entities
 
-    # API health check endpoint.
+    # Financial accounts (ACH, liability, clearing, debit card)
+    # @return [MethodRuby::Resources::Accounts]
+    attr_reader :accounts
+
+    # Method-managed accounts
+    # @return [MethodRuby::Resources::ManagedAccounts]
+    attr_reader :managed_accounts
+
+    # Merchant directory
+    # @return [MethodRuby::Resources::Merchants]
+    attr_reader :merchants
+
+    # ACH and clearing payments
+    # @return [MethodRuby::Resources::Payments]
+    attr_reader :payments
+
+    # Downloadable reports
+    # @return [MethodRuby::Resources::Reports]
+    attr_reader :reports
+
+    # @return [MethodRuby::Resources::Simulate]
+    attr_reader :simulate
+
+    # Team and API key management
+    # @return [MethodRuby::Resources::Teams]
+    attr_reader :teams
+
+    # Webhook subscriptions
+    # @return [MethodRuby::Resources::Webhooks]
+    attr_reader :webhooks
+
+    # Webhook event log
+    # @return [MethodRuby::Resources::Events]
+    attr_reader :events
+
+    # Request forwarding with sensitive data injection
+    # @return [MethodRuby::Resources::ForwardingRequests]
+    attr_reader :forwarding_requests
+
+    # Secure secret storage
+    # @return [MethodRuby::Resources::Secrets]
+    attr_reader :secrets
+
+    # Card product definitions
+    # @return [MethodRuby::Resources::CardProducts]
+    attr_reader :card_products
+
+    # Health check endpoint
     # @return [MethodRuby::Resources::Ping]
     attr_reader :ping
 
@@ -44,13 +95,22 @@ module MethodRuby
     #
     # @return [Hash{String=>String}]
     private def auth_headers(security:)
-      {bearer_auth:}.slice(*security.keys).values.reduce({}, :merge)
+      {auth_opal_token:, secret_key:}.slice(*security.keys).values.reduce({}, :merge)
     end
 
     # @api private
     #
     # @return [Hash{String=>String}]
-    private def bearer_auth
+    private def auth_opal_token
+      return {} if @opal_token.nil?
+
+      {"authorization" => "Bearer #{@opal_token}"}
+    end
+
+    # @api private
+    #
+    # @return [Hash{String=>String}]
+    private def secret_key
       return {} if @api_key.nil?
 
       {"authorization" => "Bearer #{@api_key}"}
@@ -58,8 +118,10 @@ module MethodRuby
 
     # Creates and returns a new client for interacting with the API.
     #
-    # @param api_key [String, nil] API key-based authentication. Include your API key as a Bearer token. Defaults
-    # to `ENV["METHOD_API_KEY"]`
+    # @param api_key [String, nil] Secret key for API authentication. Use your team's secret key as the Bearer
+    # token. Defaults to `ENV["METHOD_API_KEY"]`
+    #
+    # @param opal_token [String, nil] Opal token for Opal session endpoints.
     #
     # @param environment [:production, :sandbox, :dev, nil] Specifies the environment to use for the API.
     #
@@ -81,6 +143,7 @@ module MethodRuby
     # @param max_retry_delay [Float]
     def initialize(
       api_key: ENV["METHOD_API_KEY"],
+      opal_token: nil,
       environment: nil,
       base_url: ENV["METHOD_BASE_URL"],
       max_retries: self.class::DEFAULT_MAX_RETRIES,
@@ -97,17 +160,44 @@ module MethodRuby
         raise ArgumentError.new("api_key is required, and can be set via environ: \"METHOD_API_KEY\"")
       end
 
+      headers = {}
+      custom_headers_env = ENV["METHOD_CUSTOM_HEADERS"]
+      unless custom_headers_env.nil?
+        parsed = {}
+        custom_headers_env.split("\n").each do |line|
+          colon = line.index(":")
+          unless colon.nil?
+            parsed[line[0...colon].strip] = line[(colon + 1)..].strip
+          end
+        end
+        headers = parsed.merge(headers)
+      end
+
       @api_key = api_key.to_s
+      @opal_token = opal_token&.to_s
 
       super(
         base_url: base_url,
         timeout: timeout,
         max_retries: max_retries,
         initial_retry_delay: initial_retry_delay,
-        max_retry_delay: max_retry_delay
+        max_retry_delay: max_retry_delay,
+        headers: headers
       )
 
       @entities = MethodRuby::Resources::Entities.new(client: self)
+      @accounts = MethodRuby::Resources::Accounts.new(client: self)
+      @managed_accounts = MethodRuby::Resources::ManagedAccounts.new(client: self)
+      @merchants = MethodRuby::Resources::Merchants.new(client: self)
+      @payments = MethodRuby::Resources::Payments.new(client: self)
+      @reports = MethodRuby::Resources::Reports.new(client: self)
+      @simulate = MethodRuby::Resources::Simulate.new(client: self)
+      @teams = MethodRuby::Resources::Teams.new(client: self)
+      @webhooks = MethodRuby::Resources::Webhooks.new(client: self)
+      @events = MethodRuby::Resources::Events.new(client: self)
+      @forwarding_requests = MethodRuby::Resources::ForwardingRequests.new(client: self)
+      @secrets = MethodRuby::Resources::Secrets.new(client: self)
+      @card_products = MethodRuby::Resources::CardProducts.new(client: self)
       @ping = MethodRuby::Resources::Ping.new(client: self)
     end
   end

data/lib/method_ruby/internal/transport/base_client.rb

@@ -293,7 +293,7 @@ module MethodRuby
             auth_headers(
               security: req.fetch(
                 :security,
-                {bearer_auth: true}
+                {auth_opal_token: true, secret_key: true}
               )
             ),
             req[:headers].to_h,
@@ -325,6 +325,8 @@ module MethodRuby
               MethodRuby::Internal::Util.deep_merge(*[req[:body], opts[:extra_body]].compact)
             end
 
+          headers.delete("content-type") if body.nil?
+
           url = MethodRuby::Internal::Util.join_parsed_uri(
             @base_url_components,
             {**req, path: path, query: query}
@@ -458,7 +460,7 @@ module MethodRuby
         # Execute the request specified by `req`. This is the method that all resource
         # methods call into.
         #
-        # @overload request(method, path, query: {}, headers: {}, body: nil, unwrap: nil, page: nil, stream: nil, model: MethodRuby::Internal::Type::Unknown, security: {bearer_auth: true}, options: {})
+        # @overload request(method, path, query: {}, headers: {}, body: nil, unwrap: nil, page: nil, stream: nil, model: MethodRuby::Internal::Type::Unknown, security: {auth_opal_token: true, secret_key: true}, options: {})
         #
         # @param method [Symbol]
         #
@@ -572,7 +574,7 @@ module MethodRuby
               page: T.nilable(T::Class[MethodRuby::Internal::Type::BasePage[MethodRuby::Internal::Type::BaseModel]]),
               stream: T.nilable(T::Class[T.anything]),
               model: T.nilable(MethodRuby::Internal::Type::Converter::Input),
-              security: T.nilable({bearer_auth: T::Boolean}),
+              security: T.nilable({auth_opal_token: T::Boolean, secret_key: T::Boolean}),
               options: T.nilable(MethodRuby::RequestOptions::OrHash)
             }
           end

data/lib/method_ruby/internal/type/union.rb

@@ -4,6 +4,17 @@ module MethodRuby
   module Internal
     module Type
       # @api private
+      #
+      # @example
+      #   # `entity` is a `MethodRuby::Entity`
+      #   case entity
+      #   when MethodRuby::Entity::EntityIndividualResource
+      #     puts(entity.id)
+      #   when MethodRuby::Entity::EntityCorporationResource
+      #     puts(entity.created_at)
+      #   else
+      #     puts(entity)
+      #   end
       module Union
         include MethodRuby::Internal::Type::Converter
         include MethodRuby::Internal::Util::SorbetRuntimeSupport

data/lib/method_ruby/internal/util.rb

@@ -157,7 +157,7 @@ module MethodRuby
           in Hash | nil => coerced
             coerced
           else
-            message = "Expected a #{Hash} or #{MethodRuby::Internal::Type::BaseModel}, got #{data.inspect}"
+            message = "Expected a #{Hash} or #{MethodRuby::Internal::Type::BaseModel}, got #{input.inspect}"
             raise ArgumentError.new(message)
           end
         end
@@ -237,6 +237,11 @@ module MethodRuby
         end
       end
 
+      # @type [Regexp]
+      #
+      # https://www.rfc-editor.org/rfc/rfc3986.html#section-3.3
+      RFC_3986_NOT_PCHARS = /[^A-Za-z0-9\-._~!$&'()*+,;=:@]+/
+
       class << self
         # @api private
         #
@@ -247,6 +252,15 @@ module MethodRuby
           "#{uri.scheme}://#{uri.host}#{":#{uri.port}" unless uri.port == uri.default_port}"
         end
 
+        # @api private
+        #
+        # @param path [String, Integer]
+        #
+        # @return [String]
+        def encode_path(path)
+          path.to_s.gsub(MethodRuby::Internal::Util::RFC_3986_NOT_PCHARS) { ERB::Util.url_encode(_1) }
+        end
+
         # @api private
         #
         # @param path [String, Array<String>]
@@ -259,7 +273,7 @@ module MethodRuby
           in []
             ""
           in [String => p, *interpolations]
-            encoded = interpolations.map { ERB::Util.url_encode(_1) }
+            encoded = interpolations.map { encode_path(_1) }
             format(p, *encoded)
           end
         end
@@ -571,16 +585,15 @@ module MethodRuby
           y << "Content-Disposition: form-data"
 
           unless key.nil?
-            name = ERB::Util.url_encode(key.to_s)
-            y << "; name=\"#{name}\""
+            y << "; name=\"#{key}\""
           end
 
           case val
           in MethodRuby::FilePart unless val.filename.nil?
-            filename = ERB::Util.url_encode(val.filename)
+            filename = encode_path(val.filename)
             y << "; filename=\"#{filename}\""
           in Pathname | IO
-            filename = ERB::Util.url_encode(::File.basename(val.to_path))
+            filename = encode_path(::File.basename(val.to_path))
             y << "; filename=\"#{filename}\""
           else
           end
@@ -597,6 +610,7 @@ module MethodRuby
         #
         # @return [Array(String, Enumerable<String>)]
         private def encode_multipart_streaming(body)
+          # rubocop:disable Style/CaseEquality
           # RFC 1521 Section 7.2.1 says we should have 70 char maximum for boundary length
           boundary = SecureRandom.urlsafe_base64(46)
 
@@ -606,7 +620,7 @@ module MethodRuby
             in Hash
               body.each do |key, val|
                 case val
-                in Array if val.all? { primitive?(_1) }
+                in Array if val.all? { primitive?(_1) || MethodRuby::Internal::Type::FileInput === _1 }
                   val.each do |v|
                     write_multipart_chunk(y, boundary: boundary, key: key, val: v, closing: closing)
                   end
@@ -622,6 +636,7 @@ module MethodRuby
 
           fused_io = fused_enum(strio) { closing.each(&:call) }
           [boundary, fused_io]
+          # rubocop:enable Style/CaseEquality
         end
 
         # @api private