finch-api 0.1.0.pre.alpha.42 → 0.1.0.pre.alpha.43

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 4c32e72ea931e34f2871dbbe26a5e9b8f982b7f0e5860e6b17c5010e9ff47227
-  data.tar.gz: 669ac3b1466d752079bcd7340c64a8e17207979062bae697730434f7354b4c8b
+  metadata.gz: 39e45309b04809464e51d02f94daf61eb2a64ef5b019b80805983e384368f98d
+  data.tar.gz: 3bd650890941c404e755310d77f0b19978c6631f4ea90fc52cda596e3da9f1d7
 SHA512:
-  metadata.gz: d77928853c5d38991e7ca5c2689ffaf46283452d2afcfd1ffbaad9d7c0702b81b40ea4444f46b2ed5a3601788c3b9d44cbe9ec30cc1f82eb0859dd4c268d8a57
-  data.tar.gz: caa81c919ae35ba0e3971c922d580773dd71e2c6feb849dbc2d1350fa36ecea5a01d3eaeabf142e2ae04cdd6166783c79efd8980613d635d21905a2c55751a06
+  metadata.gz: b3c234051d8f5f1293d96495bcf6775676459dd8630f5a033f2289d086a0e0c5b2c837f467fbd385944de11c2d9f404f1f86bf22c31dfa3282646f3b7be50fc1
+  data.tar.gz: 802ae3e3654d7bb558a9ea5f9aac2b89ffe2b2f360428b6748211cee71611a87d1ec906dfeb9f03c7ee7704c71b107bc26bca73c1e328084fc022e8df94a9782

data/CHANGELOG.md

@@ -1,5 +1,70 @@
 # Changelog
 
+## 0.1.0-alpha.43 (2026-06-16)
+
+Full Changelog: [v0.1.0-alpha.42...v0.1.0-alpha.43](https://github.com/Finch-API/finch-api-ruby/compare/v0.1.0-alpha.42...v0.1.0-alpha.43)
+
+### Features
+
+* **api:** add per endpoint security ([ac937c1](https://github.com/Finch-API/finch-api-ruby/commit/ac937c138291704137a33d18cea1571d2e6f96ca))
+* **api:** add register benefits method ([89807f1](https://github.com/Finch-API/finch-api-ruby/commit/89807f1e708599cb05875e3f17aae5048ea7f583))
+* **api:** api update ([d67143c](https://github.com/Finch-API/finch-api-ruby/commit/d67143ccd5299f0f6e67e9bb2fb0e6088f52f5d6))
+* **api:** api update ([9e8d805](https://github.com/Finch-API/finch-api-ruby/commit/9e8d805da92b732b225c58454d1a1938448733ba))
+* **api:** api update ([2a1f82f](https://github.com/Finch-API/finch-api-ruby/commit/2a1f82f3af8070b630bb9ba9f10cd9b6f91a02eb))
+* **api:** api update ([d0d32b0](https://github.com/Finch-API/finch-api-ruby/commit/d0d32b0861ed65a60d1636da5cc37c5052ca7e28))
+* **api:** api update ([ee649a8](https://github.com/Finch-API/finch-api-ruby/commit/ee649a8915029f8bce8e676d7af80bbfe5846c61))
+* **api:** api update ([4496981](https://github.com/Finch-API/finch-api-ruby/commit/44969816152b1033dc51052723d552de315c6c9d))
+* **api:** api update ([8ff38e4](https://github.com/Finch-API/finch-api-ruby/commit/8ff38e4aeb774f2ec8f5be0692c787652a72b88f))
+* **api:** api update ([04d90f0](https://github.com/Finch-API/finch-api-ruby/commit/04d90f03077ba6b6459e3a1ecbb41baffd1e9eb5))
+* **api:** change auth to npm to oidc ([de40fd7](https://github.com/Finch-API/finch-api-ruby/commit/de40fd771fe09e381c1439f3c9efd1c5d075572c))
+* **api:** manual updates ([7a3e05f](https://github.com/Finch-API/finch-api-ruby/commit/7a3e05f0e143eb5fdaf5589b29a7cf223bc4a763))
+* **client:** add webhook support ([f4ad88e](https://github.com/Finch-API/finch-api-ruby/commit/f4ad88e63dcec2d9c6f9b64e9f10aa01a34c2af4))
+* support setting headers via env ([d563eb5](https://github.com/Finch-API/finch-api-ruby/commit/d563eb54c98253fff9a54c05632c7f4c19f1616c))
+
+
+### Bug Fixes
+
+* **aliases:** resolve broken types for alias methods with pagination ([f591bd3](https://github.com/Finch-API/finch-api-ruby/commit/f591bd32e12660e3104486b7b5297d6bf2dfc613))
+* align path encoding with RFC 3986 section 3.3 ([0a99d63](https://github.com/Finch-API/finch-api-ruby/commit/0a99d63c11aa9516a7cac12937d35972c9638f32))
+* **api:** remove invalid transform config ([826feaa](https://github.com/Finch-API/finch-api-ruby/commit/826feaab2ca5d0afd202b196f5da0910c029a591))
+* **client:** always add content-length to post body, even when empty ([66e8f66](https://github.com/Finch-API/finch-api-ruby/commit/66e8f668ba49f9959bd0067d4161d972ebad46ee))
+* **client:** elide content type header on requests without body ([d087396](https://github.com/Finch-API/finch-api-ruby/commit/d087396167b6ad3cbe79acef1745955a844a8933))
+* **client:** loosen json header parsing ([7bc3e65](https://github.com/Finch-API/finch-api-ruby/commit/7bc3e6509545d52948558cc20180865f09e946dc))
+* **client:** send content-type header for requests with an omitted optional body ([4286c51](https://github.com/Finch-API/finch-api-ruby/commit/4286c51395109aa33a0642f5fc0d73ed15f05b95))
+* **docs:** fix mcp installation instructions for remote servers ([8022436](https://github.com/Finch-API/finch-api-ruby/commit/8022436ca504321dffdb8eedabc0c9ee82e0bf45))
+* **internal:** correct multipart form field name encoding ([76c688f](https://github.com/Finch-API/finch-api-ruby/commit/76c688f93a7a6bf6827baa4b1b06ad715826c491))
+* multipart encoding for file arrays ([13e7bc1](https://github.com/Finch-API/finch-api-ruby/commit/13e7bc161a931d7a13128cb32d4bd2cc859784b4))
+* properly mock time in ruby ci tests ([86ece75](https://github.com/Finch-API/finch-api-ruby/commit/86ece75b5fefd736c827c70dc7b6140ec67fdf35))
+* **tests:** skip broken date validation test ([2ee41c8](https://github.com/Finch-API/finch-api-ruby/commit/2ee41c81ef9707aa7180723a283789a5bbaa041d))
+* variable name typo ([09ceda2](https://github.com/Finch-API/finch-api-ruby/commit/09ceda237d92712263d0942f1deb8654afc18071))
+
+
+### Chores
+
+* **ci:** skip lint on metadata-only changes ([b8e66d9](https://github.com/Finch-API/finch-api-ruby/commit/b8e66d9232c428b9c4104bf5c6ce6673690afa2a))
+* **ci:** skip uploading artifacts on stainless-internal branches ([1229fe8](https://github.com/Finch-API/finch-api-ruby/commit/1229fe85090c9c58caeb17b10434a8923fe2dcb2))
+* **ci:** support opting out of skipping builds on metadata-only commits ([f892be4](https://github.com/Finch-API/finch-api-ruby/commit/f892be499c5676f466ac47676d4106bb67f52f77))
+* **docs:** remove www prefix ([57bc88c](https://github.com/Finch-API/finch-api-ruby/commit/57bc88cdd60bfec535752170ffeeebe157a0bfce))
+* fix custom code ([3d5cf2f](https://github.com/Finch-API/finch-api-ruby/commit/3d5cf2fde4f02b8b29d07e2ccb98117ddfc75f74))
+* **internal:** codegen related update ([796b4db](https://github.com/Finch-API/finch-api-ruby/commit/796b4dba769b768e65dcff3921257f098d6ff9df))
+* **internal:** codegen related update ([a021ffb](https://github.com/Finch-API/finch-api-ruby/commit/a021ffb4eec64de459cb22c27b4c7c4592003d21))
+* **internal:** more robust bootstrap script ([6be623f](https://github.com/Finch-API/finch-api-ruby/commit/6be623fd1d3ddf902856844d74be66cf00b84195))
+* **internal:** tweak CI branches ([c0b42bc](https://github.com/Finch-API/finch-api-ruby/commit/c0b42bcd72ff06cf71fec9a98856c12043b5cfe2))
+* **internal:** update gitignore ([a315475](https://github.com/Finch-API/finch-api-ruby/commit/a3154752a39a30ad3cb8aac78b2d473c3bb86dcf))
+* **tests:** bump steady to v0.19.4 ([93617aa](https://github.com/Finch-API/finch-api-ruby/commit/93617aad24e3c174e12dfdf2de4bad5cce0aeb2f))
+* **tests:** bump steady to v0.19.5 ([424035c](https://github.com/Finch-API/finch-api-ruby/commit/424035c08a1d4c56c3b1118cd1071bc1cbaad28a))
+* **tests:** bump steady to v0.19.6 ([b832805](https://github.com/Finch-API/finch-api-ruby/commit/b8328058d1e51765ee48832897ebf00984272323))
+* **tests:** bump steady to v0.19.7 ([fe2f5fb](https://github.com/Finch-API/finch-api-ruby/commit/fe2f5fb484c9684d6586106172cd984f17e914c1))
+* **tests:** bump steady to v0.20.1 ([6fb5f11](https://github.com/Finch-API/finch-api-ruby/commit/6fb5f11fe816634a6ea3267f5c10831b2f5a1058))
+* **tests:** bump steady to v0.20.2 ([a37acc5](https://github.com/Finch-API/finch-api-ruby/commit/a37acc5ccb90a944a7bb903befbf8a5faa60a32e))
+* **tests:** bump steady to v0.22.1 ([582e669](https://github.com/Finch-API/finch-api-ruby/commit/582e669ac39599bd86c77b66c2bafcd0b4204ace))
+* update mock server docs ([47876a8](https://github.com/Finch-API/finch-api-ruby/commit/47876a8821367b8d730229c8bf401bc92907d4f0))
+
+
+### Refactors
+
+* **tests:** switch from prism to steady ([e294a79](https://github.com/Finch-API/finch-api-ruby/commit/e294a795e94df460394978881960bbc067181a7e))
+
 ## 0.1.0-alpha.42 (2026-01-16)
 
 Full Changelog: [v0.1.0-alpha.41...v0.1.0-alpha.42](https://github.com/Finch-API/finch-api-ruby/compare/v0.1.0-alpha.41...v0.1.0-alpha.42)

data/README.md

@@ -8,8 +8,8 @@ It is generated with [Stainless](https://www.stainless.com/).
 
 Use the Finch 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=%40tryfinch%2Ffinch-api-mcp&config=eyJjb21tYW5kIjoibnB4IiwiYXJncyI6WyIteSIsIkB0cnlmaW5jaC9maW5jaC1hcGktbWNwIl19)
-[![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%40tryfinch%2Ffinch-api-mcp%22%2C%22command%22%3A%22npx%22%2C%22args%22%3A%5B%22-y%22%2C%22%40tryfinch%2Ffinch-api-mcp%22%5D%7D)
+[![Add to Cursor](https://cursor.com/deeplink/mcp-install-dark.svg)](https://cursor.com/en-US/install-mcp?name=%40tryfinch%2Ffinch-api-mcp&config=eyJjb21tYW5kIjoibnB4IiwiYXJncyI6WyIteSIsIkB0cnlmaW5jaC9maW5jaC1hcGktbWNwIl0sImVudiI6eyJGSU5DSF9BQ0NFU1NfVE9LRU4iOiJNeSBBY2Nlc3MgVG9rZW4iLCJGSU5DSF9DTElFTlRfSUQiOiI0YWIxNWU1MS0xMWFkLTQ5ZjQtYWNhZS1mMzQzYjc3OTQzNzUiLCJGSU5DSF9DTElFTlRfU0VDUkVUIjoiTXkgQ2xpZW50IFNlY3JldCIsIkZJTkNIX1dFQkhPT0tfU0VDUkVUIjoiTXkgV2ViaG9vayBTZWNyZXQifX0)
+[![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%40tryfinch%2Ffinch-api-mcp%22%2C%22command%22%3A%22npx%22%2C%22args%22%3A%5B%22-y%22%2C%22%40tryfinch%2Ffinch-api-mcp%22%5D%2C%22env%22%3A%7B%22FINCH_ACCESS_TOKEN%22%3A%22My%20Access%20Token%22%2C%22FINCH_CLIENT_ID%22%3A%224ab15e51-11ad-49f4-acae-f343b7794375%22%2C%22FINCH_CLIENT_SECRET%22%3A%22My%20Client%20Secret%22%2C%22FINCH_WEBHOOK_SECRET%22%3A%22My%20Webhook%20Secret%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 "finch-api", "~> 0.1.0.pre.alpha.42"
+gem "finch-api", "~> 0.1.0.pre.alpha.43"
 ```
 
 <!-- x-release-please-end -->

data/lib/finch_api/client.rb

@@ -24,6 +24,9 @@ module FinchAPI
     # @return [String, nil]
     attr_reader :client_secret
 
+    # @return [String, nil]
+    attr_reader :webhook_secret
+
     # @return [FinchAPI::Resources::AccessTokens]
     attr_reader :access_tokens
 
@@ -56,11 +59,11 @@ module FinchAPI
 
     # @api private
     #
+    # @param security [Hash{Symbol=>Boolean}]
+    #
     # @return [Hash{String=>String}]
-    private def auth_headers
-      return bearer_auth unless bearer_auth.empty?
-      return basic_auth unless basic_auth.empty?
-      {}
+    private def auth_headers(security:)
+      {bearer_auth:, basic_auth:}.slice(*security.keys).values.reduce({}, :merge)
     end
 
     # @api private
@@ -90,6 +93,8 @@ module FinchAPI
     #
     # @param access_token [String, nil]
     #
+    # @param webhook_secret [String, nil] Defaults to `ENV["FINCH_WEBHOOK_SECRET"]`
+    #
     # @param base_url [String, nil] Override the default base URL for the API, e.g.,
     # `"https://api.example.com/v2/"`. Defaults to `ENV["FINCH_BASE_URL"]`
     #
@@ -104,6 +109,7 @@ module FinchAPI
       client_id: ENV["FINCH_CLIENT_ID"],
       client_secret: ENV["FINCH_CLIENT_SECRET"],
       access_token: nil,
+      webhook_secret: ENV["FINCH_WEBHOOK_SECRET"],
       base_url: ENV["FINCH_BASE_URL"],
       max_retries: self.class::DEFAULT_MAX_RETRIES,
       timeout: self.class::DEFAULT_TIMEOUT_IN_SECONDS,
@@ -115,10 +121,22 @@ module FinchAPI
       headers = {
         "finch-api-version" => "2020-09-17"
       }
+      custom_headers_env = ENV["FINCH_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
 
       @client_id = client_id&.to_s
       @client_secret = client_secret&.to_s
       @access_token = access_token&.to_s
+      @webhook_secret = webhook_secret&.to_s
 
       super(
         base_url: base_url,

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

@@ -31,7 +31,19 @@ module FinchAPI
           #
           # @raise [ArgumentError]
           def validate!(req)
-            keys = [:method, :path, :query, :headers, :body, :unwrap, :page, :stream, :model, :options]
+            keys = [
+              :method,
+              :path,
+              :query,
+              :headers,
+              :body,
+              :unwrap,
+              :page,
+              :stream,
+              :model,
+              :security,
+              :options
+            ]
             case req
             in Hash
               req.each_key do |k|
@@ -252,6 +264,8 @@ module FinchAPI
         #
         #   @option req [FinchAPI::Internal::Type::Converter, Class, nil] :model
         #
+        #   @option req [Hash{Symbol=>Boolean}, nil] :security
+        #
         # @param opts [Hash{Symbol=>Object}] .
         #
         #   @option opts [String, nil] :idempotency_key
@@ -276,7 +290,12 @@ module FinchAPI
 
           headers = FinchAPI::Internal::Util.normalized_headers(
             @headers,
-            auth_headers,
+            auth_headers(
+              security: req.fetch(
+                :security,
+                {bearer_auth: true, basic_auth: true}
+              )
+            ),
             req[:headers].to_h,
             opts[:extra_headers].to_h
           )
@@ -306,6 +325,11 @@ module FinchAPI
               FinchAPI::Internal::Util.deep_merge(*[req[:body], opts[:extra_body]].compact)
             end
 
+          # Generated methods always pass `req[:body]` for operations that define a
+          # request body, so only elide the content-type header when the operation
+          # has no body at all, not when an optional body param was omitted.
+          headers.delete("content-type") if body.nil? && !req.key?(:body)
+
           url = FinchAPI::Internal::Util.join_parsed_uri(
             @base_url_components,
             {**req, path: path, query: query}
@@ -439,7 +463,7 @@ module FinchAPI
         # 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: FinchAPI::Internal::Type::Unknown, options: {})
+        # @overload request(method, path, query: {}, headers: {}, body: nil, unwrap: nil, page: nil, stream: nil, model: FinchAPI::Internal::Type::Unknown, security: {bearer_auth: true, basic_auth: true}, options: {})
         #
         # @param method [Symbol]
         #
@@ -459,6 +483,8 @@ module FinchAPI
         #
         # @param model [FinchAPI::Internal::Type::Converter, Class, nil]
         #
+        # @param security [Hash{Symbol=>Boolean}, nil]
+        #
         # @param options [FinchAPI::RequestOptions, Hash{Symbol=>Object}, nil] .
         #
         #   @option options [String, nil] :idempotency_key
@@ -551,6 +577,7 @@ module FinchAPI
               page: T.nilable(T::Class[FinchAPI::Internal::Type::BasePage[FinchAPI::Internal::Type::BaseModel]]),
               stream: T.nilable(T::Class[T.anything]),
               model: T.nilable(FinchAPI::Internal::Type::Converter::Input),
+              security: T.nilable({bearer_auth: T::Boolean, basic_auth: T::Boolean}),
               options: T.nilable(FinchAPI::RequestOptions::OrHash)
             }
           end

data/lib/finch_api/internal/transport/pooled_net_requester.rb

@@ -75,7 +75,7 @@ module FinchAPI
 
             case body
             in nil
-              nil
+              req["content-length"] ||= 0 unless req["transfer-encoding"]
             in String
               req["content-length"] ||= body.bytesize.to_s unless req["transfer-encoding"]
               req.body_stream = FinchAPI::Internal::Util::ReadIOAdapter.new(body, &blk)

data/lib/finch_api/internal/util.rb

@@ -157,7 +157,7 @@ module FinchAPI
           in Hash | nil => coerced
             coerced
           else
-            message = "Expected a #{Hash} or #{FinchAPI::Internal::Type::BaseModel}, got #{data.inspect}"
+            message = "Expected a #{Hash} or #{FinchAPI::Internal::Type::BaseModel}, got #{input.inspect}"
             raise ArgumentError.new(message)
           end
         end
@@ -237,6 +237,11 @@ module FinchAPI
         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 FinchAPI
           "#{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(FinchAPI::Internal::Util::RFC_3986_NOT_PCHARS) { ERB::Util.url_encode(_1) }
+        end
+
         # @api private
         #
         # @param path [String, Array<String>]
@@ -259,7 +273,7 @@ module FinchAPI
           in []
             ""
           in [String => p, *interpolations]
-            encoded = interpolations.map { ERB::Util.url_encode(_1) }
+            encoded = interpolations.map { encode_path(_1) }
             format(p, *encoded)
           end
         end
@@ -485,11 +499,42 @@ module FinchAPI
       end
 
       # @type [Regexp]
-      JSON_CONTENT = %r{^application/(?:vnd(?:\.[^.]+)*\+)?json(?!l)}
+      JSON_CONTENT = %r{^application/(?:[a-zA-Z0-9.-]+\+)?json(?!l)}
       # @type [Regexp]
       JSONL_CONTENT = %r{^application/(:?x-(?:n|l)djson)|(:?(?:x-)?jsonl)}
 
       class << self
+        # @api private
+        #
+        # @param query [Hash{Symbol=>Object}]
+        #
+        # @return [Hash{Symbol=>Object}]
+        def encode_query_params(query)
+          out = {}
+          query.each { write_query_param_element!(out, _1, _2) }
+          out
+        end
+
+        # @api private
+        #
+        # @param collection [Hash{Symbol=>Object}]
+        # @param key [String]
+        # @param element [Object]
+        #
+        # @return [nil]
+        private def write_query_param_element!(collection, key, element)
+          case element
+          in Hash
+            element.each do |name, value|
+              write_query_param_element!(collection, "#{key}[#{name}]", value)
+            end
+          in Array
+            collection["#{key}[]"] = element.map(&:to_s)
+          else
+            collection[key] = element.to_s
+          end
+        end
+
         # @api private
         #
         # @param y [Enumerator::Yielder]
@@ -540,16 +585,15 @@ module FinchAPI
           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 FinchAPI::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
@@ -566,6 +610,7 @@ module FinchAPI
         #
         # @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)
 
@@ -575,7 +620,7 @@ module FinchAPI
             in Hash
               body.each do |key, val|
                 case val
-                in Array if val.all? { primitive?(_1) }
+                in Array if val.all? { primitive?(_1) || FinchAPI::Internal::Type::FileInput === _1 }
                   val.each do |v|
                     write_multipart_chunk(y, boundary: boundary, key: key, val: v, closing: closing)
                   end
@@ -591,6 +636,7 @@ module FinchAPI
 
           fused_io = fused_enum(strio) { closing.each(&:call) }
           [boundary, fused_io]
+          # rubocop:enable Style/CaseEquality
         end
 
         # @api private

data/lib/finch_api/models/account_disconnect_entity_params.rb

@@ -0,0 +1,22 @@
+# frozen_string_literal: true
+
+module FinchAPI
+  module Models
+    # @see FinchAPI::Resources::Account#disconnect_entity
+    class AccountDisconnectEntityParams < FinchAPI::Internal::Type::BaseModel
+      extend FinchAPI::Internal::Type::RequestParameters::Converter
+      include FinchAPI::Internal::Type::RequestParameters
+
+      # @!attribute entity_ids
+      #   Array of entity UUIDs to disconnect. At least one entity ID must be provided.
+      #
+      #   @return [Array<String>]
+      required :entity_ids, FinchAPI::Internal::Type::ArrayOf[String]
+
+      # @!method initialize(entity_ids:, request_options: {})
+      #   @param entity_ids [Array<String>] Array of entity UUIDs to disconnect. At least one entity ID must be provided.
+      #
+      #   @param request_options [FinchAPI::RequestOptions, Hash{Symbol=>Object}]
+    end
+  end
+end

data/lib/finch_api/models/base_webhook_event.rb

@@ -28,7 +28,13 @@ module FinchAPI
       #   @return [String, nil]
       optional :connection_id, String
 
-      # @!method initialize(account_id:, company_id:, connection_id: nil)
+      # @!attribute entity_id
+      #   Unique Finch id of the entity for which data has been updated.
+      #
+      #   @return [String, nil]
+      optional :entity_id, String
+
+      # @!method initialize(account_id:, company_id:, connection_id: nil, entity_id: nil)
       #   Some parameter documentations has been truncated, see
       #   {FinchAPI::Models::BaseWebhookEvent} for more details.
       #
@@ -37,6 +43,8 @@ module FinchAPI
       #   @param company_id [String] [DEPRECATED] Unique Finch ID of the company for which data has been updated. Use
       #
       #   @param connection_id [String] Unique Finch ID of the connection associated with the webhook event.
+      #
+      #   @param entity_id [String] Unique Finch id of the entity for which data has been updated.
     end
   end
 end

data/lib/finch_api/models/connect/session_new_params.rb

@@ -21,7 +21,9 @@ module FinchAPI
         required :customer_name, String
 
         # @!attribute products
-        #   The Finch products to request access to
+        #   The Finch products to request access to. Use `benefits` to access deductions
+        #   endpoints — `deduction` is a deprecated alias that is still accepted but should
+        #   not be combined with `benefits`.
         #
         #   @return [Array<Symbol, FinchAPI::Models::Connect::SessionNewParams::Product>]
         required :products,
@@ -72,7 +74,7 @@ module FinchAPI
         #
         #   @param customer_name [String] Name of the customer
         #
-        #   @param products [Array<Symbol, FinchAPI::Models::Connect::SessionNewParams::Product>] The Finch products to request access to
+        #   @param products [Array<Symbol, FinchAPI::Models::Connect::SessionNewParams::Product>] The Finch products to request access to. Use `benefits` to access deductions end
         #
         #   @param customer_email [String, nil] Email address of the customer
         #
@@ -88,7 +90,6 @@ module FinchAPI
         #
         #   @param request_options [FinchAPI::RequestOptions, Hash{Symbol=>Object}]
 
-        # The Finch products that can be requested during the Connect flow.
         module Product
           extend FinchAPI::Internal::Type::Enum
 
@@ -101,6 +102,7 @@ module FinchAPI
           INDIVIDUAL = :individual
           PAYMENT = :payment
           PAY_STATEMENT = :pay_statement
+          RECORDKEEPING = :recordkeeping
           SSN = :ssn
 
           # @!method self.values

data/lib/finch_api/models/connect/session_reauthenticate_params.rb

@@ -22,7 +22,9 @@ module FinchAPI
         optional :minutes_to_expire, Integer
 
         # @!attribute products
-        #   The products to request access to (optional for reauthentication)
+        #   The products to request access to (optional for reauthentication). Use
+        #   `benefits` to access deductions endpoints — `deduction` is a deprecated alias
+        #   that is still accepted but should not be combined with `benefits`.
         #
         #   @return [Array<Symbol, FinchAPI::Models::Connect::SessionReauthenticateParams::Product>, nil]
         optional :products,
@@ -45,13 +47,12 @@ module FinchAPI
         #
         #   @param minutes_to_expire [Integer] The number of minutes until the session expires (defaults to 43,200, which is 30
         #
-        #   @param products [Array<Symbol, FinchAPI::Models::Connect::SessionReauthenticateParams::Product>, nil] The products to request access to (optional for reauthentication)
+        #   @param products [Array<Symbol, FinchAPI::Models::Connect::SessionReauthenticateParams::Product>, nil] The products to request access to (optional for reauthentication). Use `benefits
         #
         #   @param redirect_uri [String, nil] The URI to redirect to after the Connect flow is completed
         #
         #   @param request_options [FinchAPI::RequestOptions, Hash{Symbol=>Object}]
 
-        # The Finch products that can be requested during the Connect flow.
         module Product
           extend FinchAPI::Internal::Type::Enum
 
@@ -64,6 +65,7 @@ module FinchAPI
           INDIVIDUAL = :individual
           PAYMENT = :payment
           PAY_STATEMENT = :pay_statement
+          RECORDKEEPING = :recordkeeping
           SSN = :ssn
 
           # @!method self.values

data/lib/finch_api/models/create_access_token_response.rb

@@ -80,7 +80,14 @@ module FinchAPI
       #   @return [String, nil]
       optional :customer_id, String, nil?: true
 
-      # @!method initialize(access_token:, client_type:, connection_id:, connection_type:, entity_ids:, products:, provider_id:, token_type:, account_id: nil, company_id: nil, customer_id: nil)
+      # @!attribute customer_name
+      #   The name of your customer you provided to Finch when a connect session was
+      #   created for this connection
+      #
+      #   @return [String, nil]
+      optional :customer_name, String, nil?: true
+
+      # @!method initialize(access_token:, client_type:, connection_id:, connection_type:, entity_ids:, products:, provider_id:, token_type:, account_id: nil, company_id: nil, customer_id: nil, customer_name: nil)
       #   Some parameter documentations has been truncated, see
       #   {FinchAPI::Models::CreateAccessTokenResponse} for more details.
       #
@@ -105,6 +112,8 @@ module FinchAPI
       #   @param company_id [String] [DEPRECATED] Use `connection_id` to identify the connection instead of this comp
       #
       #   @param customer_id [String, nil] The ID of your customer you provided to Finch when a connect session was created
+      #
+      #   @param customer_name [String, nil] The name of your customer you provided to Finch when a connect session was creat
 
       # The type of application associated with a token.
       #

data/lib/finch_api/models/disconnect_entity_response.rb

@@ -0,0 +1,17 @@
+# frozen_string_literal: true
+
+module FinchAPI
+  module Models
+    # @see FinchAPI::Resources::Account#disconnect_entity
+    class DisconnectEntityResponse < FinchAPI::Internal::Type::BaseModel
+      # @!attribute status
+      #   If the request is successful, Finch will return "success" (HTTP 200 status).
+      #
+      #   @return [String]
+      required :status, String
+
+      # @!method initialize(status:)
+      #   @param status [String] If the request is successful, Finch will return "success" (HTTP 200 status).
+    end
+  end
+end