brand.dev 0.7.0 → 0.9.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: f50feda932f54681e729abf32d227a1d656a0361750ea41e5ea71443d70a0a93
-  data.tar.gz: 315072b49cec6b6f60f68e863c0edbcda4862a24fdbd10530f405a70c6415f56
+  metadata.gz: 5c3a1280a9319221f78b5222ea27eede67bbd8ad055c7335f7bdd1fe88d86cee
+  data.tar.gz: 4179a6c3be67216d7ca3f461067208c875df78b0cd487f86559c86ca200650ea
 SHA512:
-  metadata.gz: ebf3e3c91166e69f34ab3e0fba78df2b579bebb323d3a8d5591ad871ab11a16f071d78f5af44912093d8e6a78d02d9077a5f09dd2091d53473cdd36f992322f7
-  data.tar.gz: c1d51e7e7d3dec11a1c46995b8d9277d68502b590900f16377a9f1a5e3e180db2e66e07c35971c178604f8aead837434b608661aa53b33eedf0143e8ddde5b13
+  metadata.gz: 06d6d103252a35cdb4cb5f4307b1948ece2af6e7bf15454ab2e430d874a2ecf09d166e6299b8913f6d1740785a67f3307d088f978bd577a964425c235d7f1223
+  data.tar.gz: 601b21ade9ddc88febd299d2b57f6c85b4fd0ae2a568ce5c8fd47972b63c0e2709fc4e4db38260b11c1c43566d3b13d81a26c5d72fd65b7df46d270333cb7f96

data/CHANGELOG.md

@@ -1,5 +1,40 @@
 # Changelog
 
+## 0.9.0 (2025-10-24)
+
+Full Changelog: [v0.8.0...v0.9.0](https://github.com/brand-dot-dev/ruby-sdk/compare/v0.8.0...v0.9.0)
+
+### Features
+
+* handle thread interrupts in the core HTTP client ([1148b44](https://github.com/brand-dot-dev/ruby-sdk/commit/1148b44345308fa59a566bc0257a330a5a90bf2e))
+
+
+### Bug Fixes
+
+* absolutely qualified uris should always override the default ([c5d7b82](https://github.com/brand-dot-dev/ruby-sdk/commit/c5d7b820e8b615d3dc838680253491a505012103))
+* should not reuse buffers for `IO.copy_stream` interop ([bd29b0a](https://github.com/brand-dot-dev/ruby-sdk/commit/bd29b0a85f00ce0cc2c95caba81f5b5e53dd1d9e))
+
+
+### Chores
+
+* ignore linter error for tests having large collections ([3e192fb](https://github.com/brand-dot-dev/ruby-sdk/commit/3e192fb1c4ed321949bc73076da40577daae1279))
+
+## 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)

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.7.0"
+gem "brand.dev", "~> 0.9.0"
 ```
 
 <!-- x-release-please-end -->

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/pooled_net_requester.rb

@@ -128,37 +128,47 @@ module BrandDev
           url, deadline = request.fetch_values(:url, :deadline)
 
           req = nil
-          eof = false
           finished = false
-          closing = nil
 
           # rubocop:disable Metrics/BlockLength
           enum = Enumerator.new do |y|
-            with_pool(url, deadline: deadline) do |conn|
-              next if finished
-
-              req, closing = self.class.build_request(request) do
-                self.class.calibrate_socket_timeout(conn, deadline)
-              end
-
-              self.class.calibrate_socket_timeout(conn, deadline)
-              unless conn.started?
-                conn.keep_alive_timeout = self.class::KEEP_ALIVE_TIMEOUT
-                conn.start
-              end
+            next if finished
 
-              self.class.calibrate_socket_timeout(conn, deadline)
-              conn.request(req) do |rsp|
-                y << [conn, req, rsp]
-                break if finished
+            with_pool(url, deadline: deadline) do |conn|
+              eof = false
+              closing = nil
+              ::Thread.handle_interrupt(Object => :never) do
+                ::Thread.handle_interrupt(Object => :immediate) do
+                  req, closing = self.class.build_request(request) do
+                    self.class.calibrate_socket_timeout(conn, deadline)
+                  end
 
-                rsp.read_body do |bytes|
-                  y << bytes.force_encoding(Encoding::BINARY)
-                  break if finished
+                  self.class.calibrate_socket_timeout(conn, deadline)
+                  unless conn.started?
+                    conn.keep_alive_timeout = self.class::KEEP_ALIVE_TIMEOUT
+                    conn.start
+                  end
 
                   self.class.calibrate_socket_timeout(conn, deadline)
+                  conn.request(req) do |rsp|
+                    y << [req, rsp]
+                    break if finished
+
+                    rsp.read_body do |bytes|
+                      y << bytes.force_encoding(Encoding::BINARY)
+                      break if finished
+
+                      self.class.calibrate_socket_timeout(conn, deadline)
+                    end
+                    eof = true
+                  end
+                end
+              ensure
+                begin
+                  conn.finish if !eof && conn&.started?
+                ensure
+                  closing&.call
                 end
-                eof = true
               end
             end
           rescue Timeout::Error
@@ -168,17 +178,10 @@ 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
-          ensure
-            conn.finish if !eof && conn&.started?
-            closing&.call
+            loop { enum.next }
           end
           [Integer(response.code), response, body]
         end

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

@@ -346,8 +346,9 @@ module BrandDev
           base_path, base_query = lhs.fetch_values(:path, :query)
           slashed = base_path.end_with?("/") ? base_path : "#{base_path}/"
 
-          parsed_path, parsed_query = parse_uri(rhs.fetch(:path)).fetch_values(:path, :query)
-          override = URI::Generic.build(**rhs.slice(:scheme, :host, :port), path: parsed_path)
+          merged = {**parse_uri(rhs.fetch(:path)), **rhs.except(:path, :query)}
+          parsed_path, parsed_query = merged.fetch_values(:path, :query)
+          override = URI::Generic.build(**merged.slice(:scheme, :host, :port), path: parsed_path)
 
           joined = URI.join(URI::Generic.build(lhs.except(:path, :query)), slashed, override)
           query = deep_merge(
@@ -473,10 +474,9 @@ module BrandDev
         # @return [Enumerable<String>]
         def writable_enum(&blk)
           Enumerator.new do |y|
-            buf = String.new
             y.define_singleton_method(:write) do
-              self << buf.replace(_1)
-              buf.bytesize
+              self << _1.dup
+              _1.bytesize
             end
 
             blk.call(y)

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/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.7.0"
+  VERSION = "0.9.0"
 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

data/rbi/brand_dev/models/brand_retrieve_params.rbi

@@ -54,14 +54,31 @@ module BrandDev
       attr_writer :name
 
       # 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.
       sig { returns(T.nilable(String)) }
       attr_reader :ticker
 
       sig { params(ticker: String).void }
       attr_writer :ticker
 
+      # Optional stock exchange for the ticker. Only used when ticker parameter is
+      # provided. Defaults to assume ticker is American if not specified.
+      sig do
+        returns(
+          T.nilable(BrandDev::BrandRetrieveParams::TickerExchange::OrSymbol)
+        )
+      end
+      attr_reader :ticker_exchange
+
+      sig do
+        params(
+          ticker_exchange:
+            BrandDev::BrandRetrieveParams::TickerExchange::OrSymbol
+        ).void
+      end
+      attr_writer :ticker_exchange
+
       # 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
       # value is 300000ms (5 minutes).
@@ -79,6 +96,8 @@ module BrandDev
           max_speed: T::Boolean,
           name: String,
           ticker: String,
+          ticker_exchange:
+            BrandDev::BrandRetrieveParams::TickerExchange::OrSymbol,
           timeout_ms: Integer,
           request_options: BrandDev::RequestOptions::OrHash
         ).returns(T.attached_class)
@@ -99,9 +118,12 @@ module BrandDev
         # parameters.
         name: nil,
         # 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.
         ticker: nil,
+        # Optional stock exchange for the ticker. Only used when ticker parameter is
+        # provided. Defaults to assume ticker is American if not specified.
+        ticker_exchange: nil,
         # 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
         # value is 300000ms (5 minutes).
@@ -119,6 +141,8 @@ module BrandDev
             max_speed: T::Boolean,
             name: String,
             ticker: String,
+            ticker_exchange:
+              BrandDev::BrandRetrieveParams::TickerExchange::OrSymbol,
             timeout_ms: Integer,
             request_options: BrandDev::RequestOptions
           }
@@ -407,6 +431,389 @@ module BrandDev
         def self.values
         end
       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
+
+        TaggedSymbol =
+          T.type_alias do
+            T.all(Symbol, BrandDev::BrandRetrieveParams::TickerExchange)
+          end
+        OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+        AMEX =
+          T.let(
+            :AMEX,
+            BrandDev::BrandRetrieveParams::TickerExchange::TaggedSymbol
+          )
+        AMS =
+          T.let(
+            :AMS,
+            BrandDev::BrandRetrieveParams::TickerExchange::TaggedSymbol
+          )
+        AQS =
+          T.let(
+            :AQS,
+            BrandDev::BrandRetrieveParams::TickerExchange::TaggedSymbol
+          )
+        ASX =
+          T.let(
+            :ASX,
+            BrandDev::BrandRetrieveParams::TickerExchange::TaggedSymbol
+          )
+        ATH =
+          T.let(
+            :ATH,
+            BrandDev::BrandRetrieveParams::TickerExchange::TaggedSymbol
+          )
+        BER =
+          T.let(
+            :BER,
+            BrandDev::BrandRetrieveParams::TickerExchange::TaggedSymbol
+          )
+        BME =
+          T.let(
+            :BME,
+            BrandDev::BrandRetrieveParams::TickerExchange::TaggedSymbol
+          )
+        BRU =
+          T.let(
+            :BRU,
+            BrandDev::BrandRetrieveParams::TickerExchange::TaggedSymbol
+          )
+        BSE =
+          T.let(
+            :BSE,
+            BrandDev::BrandRetrieveParams::TickerExchange::TaggedSymbol
+          )
+        BUD =
+          T.let(
+            :BUD,
+            BrandDev::BrandRetrieveParams::TickerExchange::TaggedSymbol
+          )
+        BUE =
+          T.let(
+            :BUE,
+            BrandDev::BrandRetrieveParams::TickerExchange::TaggedSymbol
+          )
+        BVC =
+          T.let(
+            :BVC,
+            BrandDev::BrandRetrieveParams::TickerExchange::TaggedSymbol
+          )
+        CBOE =
+          T.let(
+            :CBOE,
+            BrandDev::BrandRetrieveParams::TickerExchange::TaggedSymbol
+          )
+        CNQ =
+          T.let(
+            :CNQ,
+            BrandDev::BrandRetrieveParams::TickerExchange::TaggedSymbol
+          )
+        CPH =
+          T.let(
+            :CPH,
+            BrandDev::BrandRetrieveParams::TickerExchange::TaggedSymbol
+          )
+        DFM =
+          T.let(
+            :DFM,
+            BrandDev::BrandRetrieveParams::TickerExchange::TaggedSymbol
+          )
+        DOH =
+          T.let(
+            :DOH,
+            BrandDev::BrandRetrieveParams::TickerExchange::TaggedSymbol
+          )
+        DUB =
+          T.let(
+            :DUB,
+            BrandDev::BrandRetrieveParams::TickerExchange::TaggedSymbol
+          )
+        DUS =
+          T.let(
+            :DUS,
+            BrandDev::BrandRetrieveParams::TickerExchange::TaggedSymbol
+          )
+        DXE =
+          T.let(
+            :DXE,
+            BrandDev::BrandRetrieveParams::TickerExchange::TaggedSymbol
+          )
+        EGX =
+          T.let(
+            :EGX,
+            BrandDev::BrandRetrieveParams::TickerExchange::TaggedSymbol
+          )
+        FSX =
+          T.let(
+            :FSX,
+            BrandDev::BrandRetrieveParams::TickerExchange::TaggedSymbol
+          )
+        HAM =
+          T.let(
+            :HAM,
+            BrandDev::BrandRetrieveParams::TickerExchange::TaggedSymbol
+          )
+        HEL =
+          T.let(
+            :HEL,
+            BrandDev::BrandRetrieveParams::TickerExchange::TaggedSymbol
+          )
+        HKSE =
+          T.let(
+            :HKSE,
+            BrandDev::BrandRetrieveParams::TickerExchange::TaggedSymbol
+          )
+        HOSE =
+          T.let(
+            :HOSE,
+            BrandDev::BrandRetrieveParams::TickerExchange::TaggedSymbol
+          )
+        ICE =
+          T.let(
+            :ICE,
+            BrandDev::BrandRetrieveParams::TickerExchange::TaggedSymbol
+          )
+        IOB =
+          T.let(
+            :IOB,
+            BrandDev::BrandRetrieveParams::TickerExchange::TaggedSymbol
+          )
+        IST =
+          T.let(
+            :IST,
+            BrandDev::BrandRetrieveParams::TickerExchange::TaggedSymbol
+          )
+        JKT =
+          T.let(
+            :JKT,
+            BrandDev::BrandRetrieveParams::TickerExchange::TaggedSymbol
+          )
+        JNB =
+          T.let(
+            :JNB,
+            BrandDev::BrandRetrieveParams::TickerExchange::TaggedSymbol
+          )
+        JPX =
+          T.let(
+            :JPX,
+            BrandDev::BrandRetrieveParams::TickerExchange::TaggedSymbol
+          )
+        KLS =
+          T.let(
+            :KLS,
+            BrandDev::BrandRetrieveParams::TickerExchange::TaggedSymbol
+          )
+        KOE =
+          T.let(
+            :KOE,
+            BrandDev::BrandRetrieveParams::TickerExchange::TaggedSymbol
+          )
+        KSC =
+          T.let(
+            :KSC,
+            BrandDev::BrandRetrieveParams::TickerExchange::TaggedSymbol
+          )
+        KUW =
+          T.let(
+            :KUW,
+            BrandDev::BrandRetrieveParams::TickerExchange::TaggedSymbol
+          )
+        LIS =
+          T.let(
+            :LIS,
+            BrandDev::BrandRetrieveParams::TickerExchange::TaggedSymbol
+          )
+        LSE =
+          T.let(
+            :LSE,
+            BrandDev::BrandRetrieveParams::TickerExchange::TaggedSymbol
+          )
+        MCX =
+          T.let(
+            :MCX,
+            BrandDev::BrandRetrieveParams::TickerExchange::TaggedSymbol
+          )
+        MEX =
+          T.let(
+            :MEX,
+            BrandDev::BrandRetrieveParams::TickerExchange::TaggedSymbol
+          )
+        MIL =
+          T.let(
+            :MIL,
+            BrandDev::BrandRetrieveParams::TickerExchange::TaggedSymbol
+          )
+        MUN =
+          T.let(
+            :MUN,
+            BrandDev::BrandRetrieveParams::TickerExchange::TaggedSymbol
+          )
+        NASDAQ =
+          T.let(
+            :NASDAQ,
+            BrandDev::BrandRetrieveParams::TickerExchange::TaggedSymbol
+          )
+        NEO =
+          T.let(
+            :NEO,
+            BrandDev::BrandRetrieveParams::TickerExchange::TaggedSymbol
+          )
+        NSE =
+          T.let(
+            :NSE,
+            BrandDev::BrandRetrieveParams::TickerExchange::TaggedSymbol
+          )
+        NYSE =
+          T.let(
+            :NYSE,
+            BrandDev::BrandRetrieveParams::TickerExchange::TaggedSymbol
+          )
+        NZE =
+          T.let(
+            :NZE,
+            BrandDev::BrandRetrieveParams::TickerExchange::TaggedSymbol
+          )
+        OSL =
+          T.let(
+            :OSL,
+            BrandDev::BrandRetrieveParams::TickerExchange::TaggedSymbol
+          )
+        OTC =
+          T.let(
+            :OTC,
+            BrandDev::BrandRetrieveParams::TickerExchange::TaggedSymbol
+          )
+        PAR =
+          T.let(
+            :PAR,
+            BrandDev::BrandRetrieveParams::TickerExchange::TaggedSymbol
+          )
+        PNK =
+          T.let(
+            :PNK,
+            BrandDev::BrandRetrieveParams::TickerExchange::TaggedSymbol
+          )
+        PRA =
+          T.let(
+            :PRA,
+            BrandDev::BrandRetrieveParams::TickerExchange::TaggedSymbol
+          )
+        RIS =
+          T.let(
+            :RIS,
+            BrandDev::BrandRetrieveParams::TickerExchange::TaggedSymbol
+          )
+        SAO =
+          T.let(
+            :SAO,
+            BrandDev::BrandRetrieveParams::TickerExchange::TaggedSymbol
+          )
+        SAU =
+          T.let(
+            :SAU,
+            BrandDev::BrandRetrieveParams::TickerExchange::TaggedSymbol
+          )
+        SES =
+          T.let(
+            :SES,
+            BrandDev::BrandRetrieveParams::TickerExchange::TaggedSymbol
+          )
+        SET =
+          T.let(
+            :SET,
+            BrandDev::BrandRetrieveParams::TickerExchange::TaggedSymbol
+          )
+        SGO =
+          T.let(
+            :SGO,
+            BrandDev::BrandRetrieveParams::TickerExchange::TaggedSymbol
+          )
+        SHH =
+          T.let(
+            :SHH,
+            BrandDev::BrandRetrieveParams::TickerExchange::TaggedSymbol
+          )
+        SHZ =
+          T.let(
+            :SHZ,
+            BrandDev::BrandRetrieveParams::TickerExchange::TaggedSymbol
+          )
+        SIX =
+          T.let(
+            :SIX,
+            BrandDev::BrandRetrieveParams::TickerExchange::TaggedSymbol
+          )
+        STO =
+          T.let(
+            :STO,
+            BrandDev::BrandRetrieveParams::TickerExchange::TaggedSymbol
+          )
+        STU =
+          T.let(
+            :STU,
+            BrandDev::BrandRetrieveParams::TickerExchange::TaggedSymbol
+          )
+        TAI =
+          T.let(
+            :TAI,
+            BrandDev::BrandRetrieveParams::TickerExchange::TaggedSymbol
+          )
+        TAL =
+          T.let(
+            :TAL,
+            BrandDev::BrandRetrieveParams::TickerExchange::TaggedSymbol
+          )
+        TLV =
+          T.let(
+            :TLV,
+            BrandDev::BrandRetrieveParams::TickerExchange::TaggedSymbol
+          )
+        TSX =
+          T.let(
+            :TSX,
+            BrandDev::BrandRetrieveParams::TickerExchange::TaggedSymbol
+          )
+        TSXV =
+          T.let(
+            :TSXV,
+            BrandDev::BrandRetrieveParams::TickerExchange::TaggedSymbol
+          )
+        TWO =
+          T.let(
+            :TWO,
+            BrandDev::BrandRetrieveParams::TickerExchange::TaggedSymbol
+          )
+        VIE =
+          T.let(
+            :VIE,
+            BrandDev::BrandRetrieveParams::TickerExchange::TaggedSymbol
+          )
+        WSE =
+          T.let(
+            :WSE,
+            BrandDev::BrandRetrieveParams::TickerExchange::TaggedSymbol
+          )
+        XETRA =
+          T.let(
+            :XETRA,
+            BrandDev::BrandRetrieveParams::TickerExchange::TaggedSymbol
+          )
+
+        sig do
+          override.returns(
+            T::Array[
+              BrandDev::BrandRetrieveParams::TickerExchange::TaggedSymbol
+            ]
+          )
+        end
+        def self.values
+        end
+      end
     end
   end
 end

data/rbi/brand_dev/resources/brand.rbi

@@ -13,6 +13,8 @@ module BrandDev
           max_speed: T::Boolean,
           name: String,
           ticker: String,
+          ticker_exchange:
+            BrandDev::BrandRetrieveParams::TickerExchange::OrSymbol,
           timeout_ms: Integer,
           request_options: BrandDev::RequestOptions::OrHash
         ).returns(BrandDev::Models::BrandRetrieveResponse)
@@ -33,9 +35,12 @@ module BrandDev
         # parameters.
         name: nil,
         # 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.
         ticker: nil,
+        # Optional stock exchange for the ticker. Only used when ticker parameter is
+        # provided. Defaults to assume ticker is American if not specified.
+        ticker_exchange: nil,
         # 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
         # value is 300000ms (5 minutes).

data/sig/brand_dev/file_part.rbs

@@ -14,7 +14,7 @@ module BrandDev
 
     def initialize: (
       Pathname | StringIO | IO | String content,
-      ?filename: String?,
+      ?filename: (Pathname | String)?,
       ?content_type: String?
     ) -> void
   end

data/sig/brand_dev/models/brand_retrieve_params.rbs

@@ -7,6 +7,7 @@ module BrandDev
         max_speed: bool,
         name: String,
         ticker: String,
+        ticker_exchange: BrandDev::Models::BrandRetrieveParams::ticker_exchange,
         timeout_ms: Integer
       }
       & BrandDev::Internal::Type::request_parameters
@@ -37,6 +38,12 @@ module BrandDev
 
       def ticker=: (String) -> String
 
+      attr_reader ticker_exchange: BrandDev::Models::BrandRetrieveParams::ticker_exchange?
+
+      def ticker_exchange=: (
+        BrandDev::Models::BrandRetrieveParams::ticker_exchange
+      ) -> BrandDev::Models::BrandRetrieveParams::ticker_exchange
+
       attr_reader timeout_ms: Integer?
 
       def timeout_ms=: (Integer) -> Integer
@@ -47,6 +54,7 @@ module BrandDev
         ?max_speed: bool,
         ?name: String,
         ?ticker: String,
+        ?ticker_exchange: BrandDev::Models::BrandRetrieveParams::ticker_exchange,
         ?timeout_ms: Integer,
         ?request_options: BrandDev::request_opts
       ) -> void
@@ -57,6 +65,7 @@ module BrandDev
         max_speed: bool,
         name: String,
         ticker: String,
+        ticker_exchange: BrandDev::Models::BrandRetrieveParams::ticker_exchange,
         timeout_ms: Integer,
         request_options: BrandDev::RequestOptions
       }
@@ -173,6 +182,159 @@ module BrandDev
 
         def self?.values: -> ::Array[BrandDev::Models::BrandRetrieveParams::force_language]
       end
+
+      type ticker_exchange =
+        :AMEX
+        | :AMS
+        | :AQS
+        | :ASX
+        | :ATH
+        | :BER
+        | :BME
+        | :BRU
+        | :BSE
+        | :BUD
+        | :BUE
+        | :BVC
+        | :CBOE
+        | :CNQ
+        | :CPH
+        | :DFM
+        | :DOH
+        | :DUB
+        | :DUS
+        | :DXE
+        | :EGX
+        | :FSX
+        | :HAM
+        | :HEL
+        | :HKSE
+        | :HOSE
+        | :ICE
+        | :IOB
+        | :IST
+        | :JKT
+        | :JNB
+        | :JPX
+        | :KLS
+        | :KOE
+        | :KSC
+        | :KUW
+        | :LIS
+        | :LSE
+        | :MCX
+        | :MEX
+        | :MIL
+        | :MUN
+        | :NASDAQ
+        | :NEO
+        | :NSE
+        | :NYSE
+        | :NZE
+        | :OSL
+        | :OTC
+        | :PAR
+        | :PNK
+        | :PRA
+        | :RIS
+        | :SAO
+        | :SAU
+        | :SES
+        | :SET
+        | :SGO
+        | :SHH
+        | :SHZ
+        | :SIX
+        | :STO
+        | :STU
+        | :TAI
+        | :TAL
+        | :TLV
+        | :TSX
+        | :TSXV
+        | :TWO
+        | :VIE
+        | :WSE
+        | :XETRA
+
+      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
+
+        def self?.values: -> ::Array[BrandDev::Models::BrandRetrieveParams::ticker_exchange]
+      end
     end
   end
 end

data/sig/brand_dev/resources/brand.rbs

@@ -7,6 +7,7 @@ module BrandDev
         ?max_speed: bool,
         ?name: String,
         ?ticker: String,
+        ?ticker_exchange: BrandDev::Models::BrandRetrieveParams::ticker_exchange,
         ?timeout_ms: Integer,
         ?request_options: BrandDev::request_opts
       ) -> BrandDev::Models::BrandRetrieveResponse

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: brand.dev
 version: !ruby/object:Gem::Version
-  version: 0.7.0
+  version: 0.9.0
 platform: ruby
 authors:
 - Brand Dev
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2025-09-28 00:00:00.000000000 Z
+date: 2025-10-29 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: connection_pool