brand.dev 0.6.0 → 0.8.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 01b317f9acb3113358073f005ff31643703c16777fc8752e69bc19ec56fecb1a
-  data.tar.gz: 670ba8cf1d6e745e01337e301ade43b415d60b8260c3545652fe7131f000e880
+  metadata.gz: b2a777226800e59bc4e2049b62764ebe941bb521595593edb0b046969fd37d82
+  data.tar.gz: 3491f48a0bf45538ad64d0eeb21897a181c60c64d4eaa78987c1f86802b2ea59
 SHA512:
-  metadata.gz: 4d283a5947b0a3697afde17e94e0f019cb2f5001ba5c2d73bc867f8463327bc76a1e965d5669549d37264a64ffc8e0e8c5ceed24e11a5a02f50e9872bd0e3f24
-  data.tar.gz: 1b546ff6476dd2a14b69c4359e4fe45617007803986e142c772b3cb6f56c393d58d790510b6aee30a85862bd9f7d7fbcb6c9ed7c8b697d2000da8e54020a90ae
+  metadata.gz: e019fe296386830d0bd10ac02f2720a27a568b6553f9dab0f94e11a52f75b29d8ab9dded416615a1236b32daa00df4d862393dc18c146836449f54594417130e
+  data.tar.gz: 247ba3c2617791ee32a412d1547bf7b54723d04ccc979c9fe28ee74d6d2d989f238280763c299e0e410b06c6d280e9c2f3f296d5c41b10ba050a6df56707e469

data/CHANGELOG.md

@@ -1,5 +1,47 @@
 # Changelog
 
+## 0.8.0 (2025-10-08)
+
+Full Changelog: [v0.7.0...v0.8.0](https://github.com/brand-dot-dev/ruby-sdk/compare/v0.7.0...v0.8.0)
+
+### Features
+
+* **api:** api update ([fa5a65e](https://github.com/brand-dot-dev/ruby-sdk/commit/fa5a65e269ef946b97bf9fe7f0e9f8dd1239b4e3))
+* **api:** api update ([3c4ec01](https://github.com/brand-dot-dev/ruby-sdk/commit/3c4ec013b262955a26bc2a86100a07b0a28c8e9e))
+* **api:** api update ([e4977c6](https://github.com/brand-dot-dev/ruby-sdk/commit/e4977c64436d23aee0fee29e2a72d912c09e626f))
+
+
+### Bug Fixes
+
+* always send `filename=...` for multipart requests where a file is expected ([7135624](https://github.com/brand-dot-dev/ruby-sdk/commit/713562474e8ec92fde52cde5329f45c88ba0c594))
+* coroutine leaks from connection pool ([a6e3480](https://github.com/brand-dot-dev/ruby-sdk/commit/a6e348070e779b39f9b80b0ec2fbc9f05910b4b4))
+
+## 0.7.0 (2025-09-27)
+
+Full Changelog: [v0.6.0...v0.7.0](https://github.com/brand-dot-dev/ruby-sdk/compare/v0.6.0...v0.7.0)
+
+### Features
+
+* **api:** api update ([1e777a7](https://github.com/brand-dot-dev/ruby-sdk/commit/1e777a71af3ff2e5f0cad6223d05bfcc183fc2fd))
+* expose response headers for both streams and errors ([569c645](https://github.com/brand-dot-dev/ruby-sdk/commit/569c645d77a1432570f2d47ac33c4b30197be2ef))
+
+
+### Bug Fixes
+
+* shorten multipart boundary sep to less than RFC specificed max length ([a2e1171](https://github.com/brand-dot-dev/ruby-sdk/commit/a2e11713038013930d3b5b44d4665326e7bafece))
+
+
+### Performance Improvements
+
+* faster code formatting ([d65a43b](https://github.com/brand-dot-dev/ruby-sdk/commit/d65a43b02c1ebe517f7119c984a540e435fc2a03))
+
+
+### Chores
+
+* allow fast-format to use bsd sed as well ([88e0856](https://github.com/brand-dot-dev/ruby-sdk/commit/88e0856c917a0bb60e062fafe6a04753c8fb8059))
+* do not install brew dependencies in ./scripts/bootstrap by default ([d067d3a](https://github.com/brand-dot-dev/ruby-sdk/commit/d067d3a622289a081516f2565b3bbd420586e8ac))
+* **internal:** codegen related update ([2629fa5](https://github.com/brand-dot-dev/ruby-sdk/commit/2629fa5004386cd943bbba2da8635b10593fcdca))
+
 ## 0.6.0 (2025-09-14)
 
 Full Changelog: [v0.5.0...v0.6.0](https://github.com/brand-dot-dev/ruby-sdk/compare/v0.5.0...v0.6.0)

data/README.md

@@ -17,7 +17,7 @@ To use this gem, install via Bundler by adding the following to your application
 <!-- x-release-please-start-version -->
 
 ```ruby
-gem "brand.dev", "~> 0.6.0"
+gem "brand.dev", "~> 0.8.0"
 ```
 
 <!-- x-release-please-end -->

data/lib/brand_dev/errors.rb

@@ -40,6 +40,9 @@ module BrandDev
       # @return [Integer, nil]
       attr_accessor :status
 
+      # @return [Hash{String=>String}, nil]
+      attr_accessor :headers
+
       # @return [Object, nil]
       attr_accessor :body
 
@@ -47,13 +50,15 @@ module BrandDev
       #
       # @param url [URI::Generic]
       # @param status [Integer, nil]
+      # @param headers [Hash{String=>String}, nil]
       # @param body [Object, nil]
       # @param request [nil]
       # @param response [nil]
       # @param message [String, nil]
-      def initialize(url:, status: nil, body: nil, request: nil, response: nil, message: nil)
+      def initialize(url:, status: nil, headers: nil, body: nil, request: nil, response: nil, message: nil)
         @url = url
         @status = status
+        @headers = headers
         @body = body
         @request = request
         @response = response
@@ -74,6 +79,7 @@ module BrandDev
       #
       # @param url [URI::Generic]
       # @param status [nil]
+      # @param headers [Hash{String=>String}, nil]
       # @param body [nil]
       # @param request [nil]
       # @param response [nil]
@@ -81,6 +87,7 @@ module BrandDev
       def initialize(
         url:,
         status: nil,
+        headers: nil,
         body: nil,
         request: nil,
         response: nil,
@@ -95,6 +102,7 @@ module BrandDev
       #
       # @param url [URI::Generic]
       # @param status [nil]
+      # @param headers [Hash{String=>String}, nil]
       # @param body [nil]
       # @param request [nil]
       # @param response [nil]
@@ -102,6 +110,7 @@ module BrandDev
       def initialize(
         url:,
         status: nil,
+        headers: nil,
         body: nil,
         request: nil,
         response: nil,
@@ -116,21 +125,24 @@ module BrandDev
       #
       # @param url [URI::Generic]
       # @param status [Integer]
+      # @param headers [Hash{String=>String}, nil]
       # @param body [Object, nil]
       # @param request [nil]
       # @param response [nil]
       # @param message [String, nil]
       #
       # @return [self]
-      def self.for(url:, status:, body:, request:, response:, message: nil)
-        kwargs = {
-          url: url,
-          status: status,
-          body: body,
-          request: request,
-          response: response,
-          message: message
-        }
+      def self.for(url:, status:, headers:, body:, request:, response:, message: nil)
+        kwargs =
+          {
+            url: url,
+            status: status,
+            headers: headers,
+            body: body,
+            request: request,
+            response: response,
+            message: message
+          }
 
         case status
         in 400
@@ -162,15 +174,17 @@ module BrandDev
       #
       # @param url [URI::Generic]
       # @param status [Integer]
+      # @param headers [Hash{String=>String}, nil]
       # @param body [Object, nil]
       # @param request [nil]
       # @param response [nil]
       # @param message [String, nil]
-      def initialize(url:, status:, body:, request:, response:, message: nil)
+      def initialize(url:, status:, headers:, body:, request:, response:, message: nil)
         message ||= {url: url.to_s, status: status, body: body}
         super(
           url: url,
           status: status,
+          headers: headers,
           body: body,
           request: request,
           response: response,

data/lib/brand_dev/file_part.rb

@@ -38,18 +38,21 @@ module BrandDev
     def to_yaml(*a) = read.to_yaml(*a)
 
     # @param content [Pathname, StringIO, IO, String]
-    # @param filename [String, nil]
+    # @param filename [Pathname, String, nil]
     # @param content_type [String, nil]
     def initialize(content, filename: nil, content_type: nil)
-      @content = content
+      @content_type = content_type
       @filename =
-        case content
-        in Pathname
-          filename.nil? ? content.basename.to_path : ::File.basename(filename)
+        case [filename, (@content = content)]
+        in [String | Pathname, _]
+          ::File.basename(filename)
+        in [nil, Pathname]
+          content.basename.to_path
+        in [nil, IO]
+          content.to_path
         else
-          filename.nil? ? nil : ::File.basename(filename)
+          filename
         end
-      @content_type = content_type
     end
   end
 end

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

@@ -47,7 +47,7 @@ module BrandDev
           # @api private
           #
           # @param status [Integer]
-          # @param headers [Hash{String=>String}, Net::HTTPHeader]
+          # @param headers [Hash{String=>String}]
           #
           # @return [Boolean]
           def should_retry?(status, headers:)
@@ -85,7 +85,7 @@ module BrandDev
           #
           # @param status [Integer]
           #
-          # @param response_headers [Hash{String=>String}, Net::HTTPHeader]
+          # @param response_headers [Hash{String=>String}]
           #
           # @return [Hash{Symbol=>Object}]
           def follow_redirect(request, status:, response_headers:)
@@ -378,6 +378,7 @@ module BrandDev
           rescue BrandDev::Errors::APIConnectionError => e
             status = e
           end
+          headers = BrandDev::Internal::Util.normalized_headers(response&.each_header&.to_h)
 
           case status
           in ..299
@@ -390,7 +391,7 @@ module BrandDev
           in 300..399
             self.class.reap_connection!(status, stream: stream)
 
-            request = self.class.follow_redirect(request, status: status, response_headers: response)
+            request = self.class.follow_redirect(request, status: status, response_headers: headers)
             send_request(
               request,
               redirect_count: redirect_count + 1,
@@ -399,9 +400,9 @@ module BrandDev
             )
           in BrandDev::Errors::APIConnectionError if retry_count >= max_retries
             raise status
-          in (400..) if retry_count >= max_retries || !self.class.should_retry?(status, headers: response)
+          in (400..) if retry_count >= max_retries || !self.class.should_retry?(status, headers: headers)
             decoded = Kernel.then do
-              BrandDev::Internal::Util.decode_content(response, stream: stream, suppress_error: true)
+              BrandDev::Internal::Util.decode_content(headers, stream: stream, suppress_error: true)
             ensure
               self.class.reap_connection!(status, stream: stream)
             end
@@ -409,6 +410,7 @@ module BrandDev
             raise BrandDev::Errors::APIStatusError.for(
               url: url,
               status: status,
+              headers: headers,
               body: decoded,
               request: nil,
               response: response
@@ -485,19 +487,21 @@ module BrandDev
             send_retry_header: send_retry_header
           )
 
-          decoded = BrandDev::Internal::Util.decode_content(response, stream: stream)
+          headers = BrandDev::Internal::Util.normalized_headers(response.each_header.to_h)
+          decoded = BrandDev::Internal::Util.decode_content(headers, stream: stream)
           case req
           in {stream: Class => st}
             st.new(
               model: model,
               url: url,
               status: status,
+              headers: headers,
               response: response,
               unwrap: unwrap,
               stream: decoded
             )
           in {page: Class => page}
-            page.new(client: self, req: req, headers: response, page_data: decoded)
+            page.new(client: self, req: req, headers: headers, page_data: decoded)
           else
             unwrapped = BrandDev::Internal::Util.dig(decoded, unwrap)
             BrandDev::Internal::Type::Converter.coerce(model, unwrapped)

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

@@ -134,9 +134,9 @@ module BrandDev
 
           # rubocop:disable Metrics/BlockLength
           enum = Enumerator.new do |y|
-            with_pool(url, deadline: deadline) do |conn|
-              next if finished
+            next if finished
 
+            with_pool(url, deadline: deadline) do |conn|
               req, closing = self.class.build_request(request) do
                 self.class.calibrate_socket_timeout(conn, deadline)
               end
@@ -149,7 +149,7 @@ module BrandDev
 
               self.class.calibrate_socket_timeout(conn, deadline)
               conn.request(req) do |rsp|
-                y << [conn, req, rsp]
+                y << [req, rsp]
                 break if finished
 
                 rsp.read_body do |bytes|
@@ -160,6 +160,8 @@ module BrandDev
                 end
                 eof = true
               end
+            ensure
+              conn.finish if !eof && conn&.started?
             end
           rescue Timeout::Error
             raise BrandDev::Errors::APITimeoutError.new(url: url, request: req)
@@ -168,16 +170,11 @@ module BrandDev
           end
           # rubocop:enable Metrics/BlockLength
 
-          conn, _, response = enum.next
+          _, response = enum.next
           body = BrandDev::Internal::Util.fused_enum(enum, external: true) do
             finished = true
-            tap do
-              enum.next
-            rescue StopIteration
-              nil
-            end
+            loop { enum.next }
           ensure
-            conn.finish if !eof && conn&.started?
             closing&.call
           end
           [Integer(response.code), response, body]

data/lib/brand_dev/internal/type/base_page.rb

@@ -39,7 +39,7 @@ module BrandDev
         #
         # @param client [BrandDev::Internal::Transport::BaseClient]
         # @param req [Hash{Symbol=>Object}]
-        # @param headers [Hash{String=>String}, Net::HTTPHeader]
+        # @param headers [Hash{String=>String}]
         # @param page_data [Object]
         def initialize(client:, req:, headers:, page_data:)
           @client = client

data/lib/brand_dev/internal/type/file_input.rb

@@ -82,17 +82,20 @@ module BrandDev
           #
           # @return [Pathname, StringIO, IO, String, Object]
           def dump(value, state:)
-            # rubocop:disable Lint/DuplicateBranch
             case value
+            in StringIO | String
+              # https://datatracker.ietf.org/doc/html/rfc7578#section-4.2
+              # while not required, a filename is recommended, and in practice many servers do expect this
+              BrandDev::FilePart.new(value, filename: "upload")
             in IO
               state[:can_retry] = false
+              value.to_path.nil? ? BrandDev::FilePart.new(value, filename: "upload") : value
             in BrandDev::FilePart if value.content.is_a?(IO)
               state[:can_retry] = false
+              value
             else
+              value
             end
-            # rubocop:enable Lint/DuplicateBranch
-
-            value
           end
 
           # @api private

data/lib/brand_dev/internal/util.rb

@@ -566,7 +566,8 @@ module BrandDev
         #
         # @return [Array(String, Enumerable<String>)]
         private def encode_multipart_streaming(body)
-          boundary = SecureRandom.urlsafe_base64(60)
+          # RFC 1521 Section 7.2.1 says we should have 70 char maximum for boundary length
+          boundary = SecureRandom.urlsafe_base64(46)
 
           closing = []
           strio = writable_enum do |y|
@@ -647,7 +648,7 @@ module BrandDev
         #
         # Assumes each chunk in stream has `Encoding::BINARY`.
         #
-        # @param headers [Hash{String=>String}, Net::HTTPHeader]
+        # @param headers [Hash{String=>String}]
         # @param stream [Enumerable<String>]
         # @param suppress_error [Boolean]
         #

data/lib/brand_dev/models/brand_retrieve_params.rb

@@ -39,12 +39,19 @@ module BrandDev
 
       # @!attribute ticker
       #   Stock ticker symbol to retrieve brand data for (e.g., 'AAPL', 'GOOGL', 'BRK.A').
-      #   Must be 1-6 characters, letters/numbers/dots only. Cannot be used with domain or
-      #   name parameters.
+      #   Must be 1-15 characters, letters/numbers/dots only. Cannot be used with domain
+      #   or name parameters.
       #
       #   @return [String, nil]
       optional :ticker, String
 
+      # @!attribute ticker_exchange
+      #   Optional stock exchange for the ticker. Only used when ticker parameter is
+      #   provided. Defaults to assume ticker is American if not specified.
+      #
+      #   @return [Symbol, BrandDev::Models::BrandRetrieveParams::TickerExchange, nil]
+      optional :ticker_exchange, enum: -> { BrandDev::BrandRetrieveParams::TickerExchange }
+
       # @!attribute timeout_ms
       #   Optional timeout in milliseconds for the request. If the request takes longer
       #   than this value, it will be aborted with a 408 status code. Maximum allowed
@@ -53,7 +60,7 @@ module BrandDev
       #   @return [Integer, nil]
       optional :timeout_ms, Integer
 
-      # @!method initialize(domain: nil, force_language: nil, max_speed: nil, name: nil, ticker: nil, timeout_ms: nil, request_options: {})
+      # @!method initialize(domain: nil, force_language: nil, max_speed: nil, name: nil, ticker: nil, ticker_exchange: nil, timeout_ms: nil, request_options: {})
       #   Some parameter documentations has been truncated, see
       #   {BrandDev::Models::BrandRetrieveParams} for more details.
       #
@@ -67,6 +74,8 @@ module BrandDev
       #
       #   @param ticker [String] Stock ticker symbol to retrieve brand data for (e.g., 'AAPL', 'GOOGL', 'BRK.A').
       #
+      #   @param ticker_exchange [Symbol, BrandDev::Models::BrandRetrieveParams::TickerExchange] Optional stock exchange for the ticker. Only used when ticker parameter is provi
+      #
       #   @param timeout_ms [Integer] Optional timeout in milliseconds for the request. If the request takes longer th
       #
       #   @param request_options [BrandDev::RequestOptions, Hash{Symbol=>Object}]
@@ -132,6 +141,88 @@ module BrandDev
         # @!method self.values
         #   @return [Array<Symbol>]
       end
+
+      # Optional stock exchange for the ticker. Only used when ticker parameter is
+      # provided. Defaults to assume ticker is American if not specified.
+      module TickerExchange
+        extend BrandDev::Internal::Type::Enum
+
+        AMEX = :AMEX
+        AMS = :AMS
+        AQS = :AQS
+        ASX = :ASX
+        ATH = :ATH
+        BER = :BER
+        BME = :BME
+        BRU = :BRU
+        BSE = :BSE
+        BUD = :BUD
+        BUE = :BUE
+        BVC = :BVC
+        CBOE = :CBOE
+        CNQ = :CNQ
+        CPH = :CPH
+        DFM = :DFM
+        DOH = :DOH
+        DUB = :DUB
+        DUS = :DUS
+        DXE = :DXE
+        EGX = :EGX
+        FSX = :FSX
+        HAM = :HAM
+        HEL = :HEL
+        HKSE = :HKSE
+        HOSE = :HOSE
+        ICE = :ICE
+        IOB = :IOB
+        IST = :IST
+        JKT = :JKT
+        JNB = :JNB
+        JPX = :JPX
+        KLS = :KLS
+        KOE = :KOE
+        KSC = :KSC
+        KUW = :KUW
+        LIS = :LIS
+        LSE = :LSE
+        MCX = :MCX
+        MEX = :MEX
+        MIL = :MIL
+        MUN = :MUN
+        NASDAQ = :NASDAQ
+        NEO = :NEO
+        NSE = :NSE
+        NYSE = :NYSE
+        NZE = :NZE
+        OSL = :OSL
+        OTC = :OTC
+        PAR = :PAR
+        PNK = :PNK
+        PRA = :PRA
+        RIS = :RIS
+        SAO = :SAO
+        SAU = :SAU
+        SES = :SES
+        SET = :SET
+        SGO = :SGO
+        SHH = :SHH
+        SHZ = :SHZ
+        SIX = :SIX
+        STO = :STO
+        STU = :STU
+        TAI = :TAI
+        TAL = :TAL
+        TLV = :TLV
+        TSX = :TSX
+        TSXV = :TSXV
+        TWO = :TWO
+        VIE = :VIE
+        WSE = :WSE
+        XETRA = :XETRA
+
+        # @!method self.values
+        #   @return [Array<Symbol>]
+      end
     end
   end
 end

data/lib/brand_dev/models/brand_styleguide_params.rb

@@ -17,8 +17,8 @@ module BrandDev
       # @!attribute prioritize
       #   Optional parameter to prioritize screenshot capture for styleguide extraction.
       #   If 'speed', optimizes for faster capture with basic quality. If 'quality',
-      #   optimizes for higher quality with longer wait times. Defaults to 'speed' if not
-      #   provided.
+      #   optimizes for higher quality with longer wait times. Defaults to 'quality' if
+      #   not provided.
       #
       #   @return [Symbol, BrandDev::Models::BrandStyleguideParams::Prioritize, nil]
       optional :prioritize, enum: -> { BrandDev::BrandStyleguideParams::Prioritize }
@@ -45,8 +45,8 @@ module BrandDev
 
       # Optional parameter to prioritize screenshot capture for styleguide extraction.
       # If 'speed', optimizes for faster capture with basic quality. If 'quality',
-      # optimizes for higher quality with longer wait times. Defaults to 'speed' if not
-      # provided.
+      # optimizes for higher quality with longer wait times. Defaults to 'quality' if
+      # not provided.
       module Prioritize
         extend BrandDev::Internal::Type::Enum
 

data/lib/brand_dev/resources/brand.rb

@@ -9,7 +9,7 @@ module BrandDev
       # Retrieve brand information using one of three methods: domain name, company
       # name, or stock ticker symbol. Exactly one of these parameters must be provided.
       #
-      # @overload retrieve(domain: nil, force_language: nil, max_speed: nil, name: nil, ticker: nil, timeout_ms: nil, request_options: {})
+      # @overload retrieve(domain: nil, force_language: nil, max_speed: nil, name: nil, ticker: nil, ticker_exchange: nil, timeout_ms: nil, request_options: {})
       #
       # @param domain [String] Domain name to retrieve brand data for (e.g., 'example.com', 'google.com'). Cann
       #
@@ -21,6 +21,8 @@ module BrandDev
       #
       # @param ticker [String] Stock ticker symbol to retrieve brand data for (e.g., 'AAPL', 'GOOGL', 'BRK.A').
       #
+      # @param ticker_exchange [Symbol, BrandDev::Models::BrandRetrieveParams::TickerExchange] Optional stock exchange for the ticker. Only used when ticker parameter is provi
+      #
       # @param timeout_ms [Integer] Optional timeout in milliseconds for the request. If the request takes longer th
       #
       # @param request_options [BrandDev::RequestOptions, Hash{Symbol=>Object}, nil]

data/lib/brand_dev/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module BrandDev
-  VERSION = "0.6.0"
+  VERSION = "0.8.0"
 end

data/rbi/brand_dev/errors.rbi

@@ -33,6 +33,9 @@ module BrandDev
       sig { returns(T.nilable(Integer)) }
       attr_accessor :status
 
+      sig { returns(T.nilable(T::Hash[String, String])) }
+      attr_accessor :headers
+
       sig { returns(T.nilable(T.anything)) }
       attr_accessor :body
 
@@ -41,6 +44,7 @@ module BrandDev
         params(
           url: URI::Generic,
           status: T.nilable(Integer),
+          headers: T.nilable(T::Hash[String, String]),
           body: T.nilable(Object),
           request: NilClass,
           response: NilClass,
@@ -50,6 +54,7 @@ module BrandDev
       def self.new(
         url:,
         status: nil,
+        headers: nil,
         body: nil,
         request: nil,
         response: nil,
@@ -70,6 +75,7 @@ module BrandDev
         params(
           url: URI::Generic,
           status: NilClass,
+          headers: T.nilable(T::Hash[String, String]),
           body: NilClass,
           request: NilClass,
           response: NilClass,
@@ -79,6 +85,7 @@ module BrandDev
       def self.new(
         url:,
         status: nil,
+        headers: nil,
         body: nil,
         request: nil,
         response: nil,
@@ -93,6 +100,7 @@ module BrandDev
         params(
           url: URI::Generic,
           status: NilClass,
+          headers: T.nilable(T::Hash[String, String]),
           body: NilClass,
           request: NilClass,
           response: NilClass,
@@ -102,6 +110,7 @@ module BrandDev
       def self.new(
         url:,
         status: nil,
+        headers: nil,
         body: nil,
         request: nil,
         response: nil,
@@ -116,13 +125,22 @@ module BrandDev
         params(
           url: URI::Generic,
           status: Integer,
+          headers: T.nilable(T::Hash[String, String]),
           body: T.nilable(Object),
           request: NilClass,
           response: NilClass,
           message: T.nilable(String)
         ).returns(T.attached_class)
       end
-      def self.for(url:, status:, body:, request:, response:, message: nil)
+      def self.for(
+        url:,
+        status:,
+        headers:,
+        body:,
+        request:,
+        response:,
+        message: nil
+      )
       end
 
       sig { returns(Integer) }
@@ -133,13 +151,22 @@ module BrandDev
         params(
           url: URI::Generic,
           status: Integer,
+          headers: T.nilable(T::Hash[String, String]),
           body: T.nilable(Object),
           request: NilClass,
           response: NilClass,
           message: T.nilable(String)
         ).returns(T.attached_class)
       end
-      def self.new(url:, status:, body:, request:, response:, message: nil)
+      def self.new(
+        url:,
+        status:,
+        headers:,
+        body:,
+        request:,
+        response:,
+        message: nil
+      )
       end
     end
 

data/rbi/brand_dev/file_part.rbi

@@ -27,7 +27,7 @@ module BrandDev
     sig do
       params(
         content: T.any(Pathname, StringIO, IO, String),
-        filename: T.nilable(String),
+        filename: T.nilable(T.any(Pathname, String)),
         content_type: T.nilable(String)
       ).returns(T.attached_class)
     end