brand.dev 0.1.0.pre.alpha.13 → 0.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: f2f4cce21a6e8e9842288272aad3a29805bdfc6a4666c098c0509f1006295535
-  data.tar.gz: e781e45d40fb23338c0e594aeaa06d9a9f9effc4e7cb157d3bd1f46a98ecf819
+  metadata.gz: df28fd5aa0d8231a27a6b3c155f9000846e642c65fc753f1774bd6c0e58a014b
+  data.tar.gz: a55600ebc91b03e85320b577705bbd1e5ad3edd60ed6b7b2dbfb5cb1af9089bd
 SHA512:
-  metadata.gz: 322aa87785e29d162e5c633a79398cff050bfc9c0d5dcd594d85c36713131dc5bf9bc07c4c684454c68ef7127090bd1d1b17a96529433a031ca47fc0236d5df8
-  data.tar.gz: b22769471f2d222c5879d52c2539f81b59f355ebefd432a00b13678e4be7f18519d4830d5b73c8427ee5254f5e6a5f1775d278d1ed3718adf3ca6783e75857e0
+  metadata.gz: 5d6cdee2fb3161e12e02d0645fbf71508664827af349b769d2f148db5f53df609b135fc556303160711ca287655fbe646aed2826495663d0df3173cb0baea1f4
+  data.tar.gz: 5b6f254d84d2d883ba3c07fe4f86768f10e7fb82651f9f587fe4eb21a81313b98790358ab120275240152c186be0d42568bc106682d0acfab95766b669bdabdb

data/CHANGELOG.md

@@ -1,5 +1,54 @@
 # Changelog
 
+## 0.2.0 (2025-07-31)
+
+Full Changelog: [v0.1.0...v0.2.0](https://github.com/brand-dot-dev/ruby-sdk/compare/v0.1.0...v0.2.0)
+
+### Features
+
+* **api:** manual updates ([9e2f31d](https://github.com/brand-dot-dev/ruby-sdk/commit/9e2f31dc4082586468781ae4d25c58155eb2d119))
+
+## 0.1.0 (2025-07-29)
+
+Full Changelog: [v0.0.2...v0.1.0](https://github.com/brand-dot-dev/ruby-sdk/compare/v0.0.2...v0.1.0)
+
+### Features
+
+* **api:** manual updates ([16b9bdc](https://github.com/brand-dot-dev/ruby-sdk/commit/16b9bdcdbcbac819a1120c93399195b102db34ed))
+
+
+### Bug Fixes
+
+* **internal:** ensure sorbet test always runs serially ([b780fe6](https://github.com/brand-dot-dev/ruby-sdk/commit/b780fe622148d3af2db69a59c16470ebf82b3702))
+
+
+### Chores
+
+* **internal:** version bump ([d7516ea](https://github.com/brand-dot-dev/ruby-sdk/commit/d7516ea2cf7f6c5b21236d90fca254a91476d5ad))
+* update contribute.md ([05a6bc4](https://github.com/brand-dot-dev/ruby-sdk/commit/05a6bc4264abb72f63d72ee43a0ba2fac7fd0511))
+
+## 0.0.2 (2025-07-21)
+
+Full Changelog: [v0.0.1...v0.0.2](https://github.com/brand-dot-dev/ruby-sdk/compare/v0.0.1...v0.0.2)
+
+### Chores
+
+* **internal:** version bump ([c8553b7](https://github.com/brand-dot-dev/ruby-sdk/commit/c8553b728303284cda46b2a980743c5533932fdd))
+
+## 0.0.1 (2025-07-21)
+
+Full Changelog: [v0.1.0-alpha.13...v0.0.1](https://github.com/brand-dot-dev/ruby-sdk/compare/v0.1.0-alpha.13...v0.0.1)
+
+### Features
+
+* **api:** manual updates ([cfaabba](https://github.com/brand-dot-dev/ruby-sdk/commit/cfaabbab93b68ba4926f78560d759d788e4b4b98))
+
+
+### Chores
+
+* **internal:** allow streams to also be unwrapped on a per-row basis ([99d7893](https://github.com/brand-dot-dev/ruby-sdk/commit/99d7893d01a3e111d49fb7c39e53bc9dd524f6b6))
+* **internal:** version bump ([d51ca58](https://github.com/brand-dot-dev/ruby-sdk/commit/d51ca5841eb432576fb2e251d4ebdab02cfb1ad7))
+
 ## 0.1.0-alpha.13 (2025-06-29)
 
 Full Changelog: [v0.1.0-alpha.12...v0.1.0-alpha.13](https://github.com/brand-dot-dev/ruby-sdk/compare/v0.1.0-alpha.12...v0.1.0-alpha.13)

data/README.md

@@ -15,7 +15,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.1.0.pre.alpha.13"
+gem "brand.dev", "~> 0.2.0"
 ```
 
 <!-- x-release-please-end -->

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

@@ -471,6 +471,7 @@ module BrandDev
           self.class.validate!(req)
           model = req.fetch(:model) { BrandDev::Internal::Type::Unknown }
           opts = req[:options].to_h
+          unwrap = req[:unwrap]
           BrandDev::RequestOptions.validate!(opts)
           request = build_request(req.except(:options), opts)
           url = request.fetch(:url)
@@ -487,11 +488,18 @@ module BrandDev
           decoded = BrandDev::Internal::Util.decode_content(response, stream: stream)
           case req
           in {stream: Class => st}
-            st.new(model: model, url: url, status: status, response: response, stream: decoded)
+            st.new(
+              model: model,
+              url: url,
+              status: status,
+              response: response,
+              unwrap: unwrap,
+              stream: decoded
+            )
           in {page: Class => page}
             page.new(client: self, req: req, headers: response, page_data: decoded)
           else
-            unwrapped = BrandDev::Internal::Util.dig(decoded, req[:unwrap])
+            unwrapped = BrandDev::Internal::Util.dig(decoded, unwrap)
             BrandDev::Internal::Type::Converter.coerce(model, unwrapped)
           end
         end

data/lib/brand_dev/models/brand_ai_query_response.rb

@@ -17,17 +17,25 @@ module BrandDev
       #   @return [String, nil]
       optional :domain, String
 
+      # @!attribute status
+      #   Status of the response, e.g., 'ok'
+      #
+      #   @return [String, nil]
+      optional :status, String
+
       # @!attribute urls_analyzed
       #   List of URLs that were analyzed
       #
       #   @return [Array<String>, nil]
       optional :urls_analyzed, BrandDev::Internal::Type::ArrayOf[String]
 
-      # @!method initialize(data_extracted: nil, domain: nil, urls_analyzed: nil)
+      # @!method initialize(data_extracted: nil, domain: nil, status: nil, urls_analyzed: nil)
       #   @param data_extracted [Array<BrandDev::Models::BrandAIQueryResponse::DataExtracted>] Array of extracted data points
       #
       #   @param domain [String] The domain that was analyzed
       #
+      #   @param status [String] Status of the response, e.g., 'ok'
+      #
       #   @param urls_analyzed [Array<String>] List of URLs that were analyzed
 
       class DataExtracted < BrandDev::Internal::Type::BaseModel

data/lib/brand_dev/models/brand_identify_from_transaction_response.rb

@@ -63,12 +63,17 @@ module BrandDev
         #   @return [String, nil]
         optional :domain, String
 
-        # @!attribute fonts
-        #   An array of fonts used by the brand's website
+        # @!attribute email
+        #   Company email address
         #
-        #   @return [Array<BrandDev::Models::BrandIdentifyFromTransactionResponse::Brand::Font>, nil]
-        optional :fonts,
-                 -> { BrandDev::Internal::Type::ArrayOf[BrandDev::Models::BrandIdentifyFromTransactionResponse::Brand::Font] }
+        #   @return [String, nil]
+        optional :email, String
+
+        # @!attribute is_nsfw
+        #   Indicates whether the brand content is not safe for work (NSFW)
+        #
+        #   @return [Boolean, nil]
+        optional :is_nsfw, BrandDev::Internal::Type::Boolean
 
         # @!attribute logos
         #   An array of logos associated with the brand
@@ -77,6 +82,12 @@ module BrandDev
         optional :logos,
                  -> { BrandDev::Internal::Type::ArrayOf[BrandDev::Models::BrandIdentifyFromTransactionResponse::Brand::Logo] }
 
+        # @!attribute phone
+        #   Company phone number
+        #
+        #   @return [String, nil]
+        optional :phone, String
+
         # @!attribute slogan
         #   The brand's slogan
         #
@@ -103,7 +114,7 @@ module BrandDev
         #   @return [String, nil]
         optional :title, String
 
-        # @!method initialize(address: nil, backdrops: nil, colors: nil, description: nil, domain: nil, fonts: nil, logos: nil, slogan: nil, socials: nil, stock: nil, title: nil)
+        # @!method initialize(address: nil, backdrops: nil, colors: nil, description: nil, domain: nil, email: nil, is_nsfw: nil, logos: nil, phone: nil, slogan: nil, socials: nil, stock: nil, title: nil)
         #   Some parameter documentations has been truncated, see
         #   {BrandDev::Models::BrandIdentifyFromTransactionResponse::Brand} for more
         #   details.
@@ -120,10 +131,14 @@ module BrandDev
         #
         #   @param domain [String] The domain name of the brand
         #
-        #   @param fonts [Array<BrandDev::Models::BrandIdentifyFromTransactionResponse::Brand::Font>] An array of fonts used by the brand's website
+        #   @param email [String] Company email address
+        #
+        #   @param is_nsfw [Boolean] Indicates whether the brand content is not safe for work (NSFW)
         #
         #   @param logos [Array<BrandDev::Models::BrandIdentifyFromTransactionResponse::Brand::Logo>] An array of logos associated with the brand
         #
+        #   @param phone [String] Company phone number
+        #
         #   @param slogan [String] The brand's slogan
         #
         #   @param socials [Array<BrandDev::Models::BrandIdentifyFromTransactionResponse::Brand::Social>] An array of social media links for the brand
@@ -243,6 +258,12 @@ module BrandDev
 
           # @see BrandDev::Models::BrandIdentifyFromTransactionResponse::Brand::Backdrop#resolution
           class Resolution < BrandDev::Internal::Type::BaseModel
+            # @!attribute aspect_ratio
+            #   Aspect ratio of the image (width/height)
+            #
+            #   @return [Float, nil]
+            optional :aspect_ratio, Float
+
             # @!attribute height
             #   Height of the image in pixels
             #
@@ -255,9 +276,11 @@ module BrandDev
             #   @return [Integer, nil]
             optional :width, Integer
 
-            # @!method initialize(height: nil, width: nil)
+            # @!method initialize(aspect_ratio: nil, height: nil, width: nil)
             #   Resolution of the backdrop image
             #
+            #   @param aspect_ratio [Float] Aspect ratio of the image (width/height)
+            #
             #   @param height [Integer] Height of the image in pixels
             #
             #   @param width [Integer] Width of the image in pixels
@@ -283,25 +306,6 @@ module BrandDev
           #   @param name [String] Name of the color
         end
 
-        class Font < BrandDev::Internal::Type::BaseModel
-          # @!attribute name
-          #   Name of the font
-          #
-          #   @return [String, nil]
-          optional :name, String
-
-          # @!attribute usage
-          #   Usage of the font, e.g., 'title', 'body', 'button'
-          #
-          #   @return [String, nil]
-          optional :usage, String
-
-          # @!method initialize(name: nil, usage: nil)
-          #   @param name [String] Name of the font
-          #
-          #   @param usage [String] Usage of the font, e.g., 'title', 'body', 'button'
-        end
-
         class Logo < BrandDev::Internal::Type::BaseModel
           # @!attribute colors
           #   Array of colors in the logo
@@ -310,17 +314,13 @@ module BrandDev
           optional :colors,
                    -> { BrandDev::Internal::Type::ArrayOf[BrandDev::Models::BrandIdentifyFromTransactionResponse::Brand::Logo::Color] }
 
-          # @!attribute group
-          #   Group identifier for logos
-          #
-          #   @return [Integer, nil]
-          optional :group, Integer
-
           # @!attribute mode
-          #   Mode of the logo, e.g., 'dark', 'light'
+          #   Indicates when this logo is best used: 'light' = best for light mode, 'dark' =
+          #   best for dark mode, 'has_opaque_background' = can be used for either as image
+          #   has its own background
           #
-          #   @return [String, nil]
-          optional :mode, String
+          #   @return [Symbol, BrandDev::Models::BrandIdentifyFromTransactionResponse::Brand::Logo::Mode, nil]
+          optional :mode, enum: -> { BrandDev::Models::BrandIdentifyFromTransactionResponse::Brand::Logo::Mode }
 
           # @!attribute resolution
           #   Resolution of the logo image
@@ -329,22 +329,32 @@ module BrandDev
           optional :resolution,
                    -> { BrandDev::Models::BrandIdentifyFromTransactionResponse::Brand::Logo::Resolution }
 
+          # @!attribute type
+          #   Type of the logo based on resolution (e.g., 'icon', 'logo')
+          #
+          #   @return [Symbol, BrandDev::Models::BrandIdentifyFromTransactionResponse::Brand::Logo::Type, nil]
+          optional :type, enum: -> { BrandDev::Models::BrandIdentifyFromTransactionResponse::Brand::Logo::Type }
+
           # @!attribute url
-          #   URL of the logo image
+          #   CDN hosted url of the logo (ready for display)
           #
           #   @return [String, nil]
           optional :url, String
 
-          # @!method initialize(colors: nil, group: nil, mode: nil, resolution: nil, url: nil)
-          #   @param colors [Array<BrandDev::Models::BrandIdentifyFromTransactionResponse::Brand::Logo::Color>] Array of colors in the logo
+          # @!method initialize(colors: nil, mode: nil, resolution: nil, type: nil, url: nil)
+          #   Some parameter documentations has been truncated, see
+          #   {BrandDev::Models::BrandIdentifyFromTransactionResponse::Brand::Logo} for more
+          #   details.
           #
-          #   @param group [Integer] Group identifier for logos
+          #   @param colors [Array<BrandDev::Models::BrandIdentifyFromTransactionResponse::Brand::Logo::Color>] Array of colors in the logo
           #
-          #   @param mode [String] Mode of the logo, e.g., 'dark', 'light'
+          #   @param mode [Symbol, BrandDev::Models::BrandIdentifyFromTransactionResponse::Brand::Logo::Mode] Indicates when this logo is best used: 'light' = best for light mode, 'dark' = b
           #
           #   @param resolution [BrandDev::Models::BrandIdentifyFromTransactionResponse::Brand::Logo::Resolution] Resolution of the logo image
           #
-          #   @param url [String] URL of the logo image
+          #   @param type [Symbol, BrandDev::Models::BrandIdentifyFromTransactionResponse::Brand::Logo::Type] Type of the logo based on resolution (e.g., 'icon', 'logo')
+          #
+          #   @param url [String] CDN hosted url of the logo (ready for display)
 
           class Color < BrandDev::Internal::Type::BaseModel
             # @!attribute hex
@@ -365,8 +375,30 @@ module BrandDev
             #   @param name [String] Name of the color
           end
 
+          # Indicates when this logo is best used: 'light' = best for light mode, 'dark' =
+          # best for dark mode, 'has_opaque_background' = can be used for either as image
+          # has its own background
+          #
+          # @see BrandDev::Models::BrandIdentifyFromTransactionResponse::Brand::Logo#mode
+          module Mode
+            extend BrandDev::Internal::Type::Enum
+
+            LIGHT = :light
+            DARK = :dark
+            HAS_OPAQUE_BACKGROUND = :has_opaque_background
+
+            # @!method self.values
+            #   @return [Array<Symbol>]
+          end
+
           # @see BrandDev::Models::BrandIdentifyFromTransactionResponse::Brand::Logo#resolution
           class Resolution < BrandDev::Internal::Type::BaseModel
+            # @!attribute aspect_ratio
+            #   Aspect ratio of the image (width/height)
+            #
+            #   @return [Float, nil]
+            optional :aspect_ratio, Float
+
             # @!attribute height
             #   Height of the image in pixels
             #
@@ -379,13 +411,28 @@ module BrandDev
             #   @return [Integer, nil]
             optional :width, Integer
 
-            # @!method initialize(height: nil, width: nil)
+            # @!method initialize(aspect_ratio: nil, height: nil, width: nil)
             #   Resolution of the logo image
             #
+            #   @param aspect_ratio [Float] Aspect ratio of the image (width/height)
+            #
             #   @param height [Integer] Height of the image in pixels
             #
             #   @param width [Integer] Width of the image in pixels
           end
+
+          # Type of the logo based on resolution (e.g., 'icon', 'logo')
+          #
+          # @see BrandDev::Models::BrandIdentifyFromTransactionResponse::Brand::Logo#type
+          module Type
+            extend BrandDev::Internal::Type::Enum
+
+            ICON = :icon
+            LOGO = :logo
+
+            # @!method self.values
+            #   @return [Array<Symbol>]
+          end
         end
 
         class Social < BrandDev::Internal::Type::BaseModel

data/lib/brand_dev/models/brand_retrieve_by_ticker_response.rb

@@ -63,12 +63,17 @@ module BrandDev
         #   @return [String, nil]
         optional :domain, String
 
-        # @!attribute fonts
-        #   An array of fonts used by the brand's website
+        # @!attribute email
+        #   Company email address
         #
-        #   @return [Array<BrandDev::Models::BrandRetrieveByTickerResponse::Brand::Font>, nil]
-        optional :fonts,
-                 -> { BrandDev::Internal::Type::ArrayOf[BrandDev::Models::BrandRetrieveByTickerResponse::Brand::Font] }
+        #   @return [String, nil]
+        optional :email, String
+
+        # @!attribute is_nsfw
+        #   Indicates whether the brand content is not safe for work (NSFW)
+        #
+        #   @return [Boolean, nil]
+        optional :is_nsfw, BrandDev::Internal::Type::Boolean
 
         # @!attribute logos
         #   An array of logos associated with the brand
@@ -77,6 +82,12 @@ module BrandDev
         optional :logos,
                  -> { BrandDev::Internal::Type::ArrayOf[BrandDev::Models::BrandRetrieveByTickerResponse::Brand::Logo] }
 
+        # @!attribute phone
+        #   Company phone number
+        #
+        #   @return [String, nil]
+        optional :phone, String
+
         # @!attribute slogan
         #   The brand's slogan
         #
@@ -103,7 +114,7 @@ module BrandDev
         #   @return [String, nil]
         optional :title, String
 
-        # @!method initialize(address: nil, backdrops: nil, colors: nil, description: nil, domain: nil, fonts: nil, logos: nil, slogan: nil, socials: nil, stock: nil, title: nil)
+        # @!method initialize(address: nil, backdrops: nil, colors: nil, description: nil, domain: nil, email: nil, is_nsfw: nil, logos: nil, phone: nil, slogan: nil, socials: nil, stock: nil, title: nil)
         #   Some parameter documentations has been truncated, see
         #   {BrandDev::Models::BrandRetrieveByTickerResponse::Brand} for more details.
         #
@@ -119,10 +130,14 @@ module BrandDev
         #
         #   @param domain [String] The domain name of the brand
         #
-        #   @param fonts [Array<BrandDev::Models::BrandRetrieveByTickerResponse::Brand::Font>] An array of fonts used by the brand's website
+        #   @param email [String] Company email address
+        #
+        #   @param is_nsfw [Boolean] Indicates whether the brand content is not safe for work (NSFW)
         #
         #   @param logos [Array<BrandDev::Models::BrandRetrieveByTickerResponse::Brand::Logo>] An array of logos associated with the brand
         #
+        #   @param phone [String] Company phone number
+        #
         #   @param slogan [String] The brand's slogan
         #
         #   @param socials [Array<BrandDev::Models::BrandRetrieveByTickerResponse::Brand::Social>] An array of social media links for the brand
@@ -241,6 +256,12 @@ module BrandDev
 
           # @see BrandDev::Models::BrandRetrieveByTickerResponse::Brand::Backdrop#resolution
           class Resolution < BrandDev::Internal::Type::BaseModel
+            # @!attribute aspect_ratio
+            #   Aspect ratio of the image (width/height)
+            #
+            #   @return [Float, nil]
+            optional :aspect_ratio, Float
+
             # @!attribute height
             #   Height of the image in pixels
             #
@@ -253,9 +274,11 @@ module BrandDev
             #   @return [Integer, nil]
             optional :width, Integer
 
-            # @!method initialize(height: nil, width: nil)
+            # @!method initialize(aspect_ratio: nil, height: nil, width: nil)
             #   Resolution of the backdrop image
             #
+            #   @param aspect_ratio [Float] Aspect ratio of the image (width/height)
+            #
             #   @param height [Integer] Height of the image in pixels
             #
             #   @param width [Integer] Width of the image in pixels
@@ -281,25 +304,6 @@ module BrandDev
           #   @param name [String] Name of the color
         end
 
-        class Font < BrandDev::Internal::Type::BaseModel
-          # @!attribute name
-          #   Name of the font
-          #
-          #   @return [String, nil]
-          optional :name, String
-
-          # @!attribute usage
-          #   Usage of the font, e.g., 'title', 'body', 'button'
-          #
-          #   @return [String, nil]
-          optional :usage, String
-
-          # @!method initialize(name: nil, usage: nil)
-          #   @param name [String] Name of the font
-          #
-          #   @param usage [String] Usage of the font, e.g., 'title', 'body', 'button'
-        end
-
         class Logo < BrandDev::Internal::Type::BaseModel
           # @!attribute colors
           #   Array of colors in the logo
@@ -308,17 +312,13 @@ module BrandDev
           optional :colors,
                    -> { BrandDev::Internal::Type::ArrayOf[BrandDev::Models::BrandRetrieveByTickerResponse::Brand::Logo::Color] }
 
-          # @!attribute group
-          #   Group identifier for logos
-          #
-          #   @return [Integer, nil]
-          optional :group, Integer
-
           # @!attribute mode
-          #   Mode of the logo, e.g., 'dark', 'light'
+          #   Indicates when this logo is best used: 'light' = best for light mode, 'dark' =
+          #   best for dark mode, 'has_opaque_background' = can be used for either as image
+          #   has its own background
           #
-          #   @return [String, nil]
-          optional :mode, String
+          #   @return [Symbol, BrandDev::Models::BrandRetrieveByTickerResponse::Brand::Logo::Mode, nil]
+          optional :mode, enum: -> { BrandDev::Models::BrandRetrieveByTickerResponse::Brand::Logo::Mode }
 
           # @!attribute resolution
           #   Resolution of the logo image
@@ -326,22 +326,31 @@ module BrandDev
           #   @return [BrandDev::Models::BrandRetrieveByTickerResponse::Brand::Logo::Resolution, nil]
           optional :resolution, -> { BrandDev::Models::BrandRetrieveByTickerResponse::Brand::Logo::Resolution }
 
+          # @!attribute type
+          #   Type of the logo based on resolution (e.g., 'icon', 'logo')
+          #
+          #   @return [Symbol, BrandDev::Models::BrandRetrieveByTickerResponse::Brand::Logo::Type, nil]
+          optional :type, enum: -> { BrandDev::Models::BrandRetrieveByTickerResponse::Brand::Logo::Type }
+
           # @!attribute url
-          #   URL of the logo image
+          #   CDN hosted url of the logo (ready for display)
           #
           #   @return [String, nil]
           optional :url, String
 
-          # @!method initialize(colors: nil, group: nil, mode: nil, resolution: nil, url: nil)
-          #   @param colors [Array<BrandDev::Models::BrandRetrieveByTickerResponse::Brand::Logo::Color>] Array of colors in the logo
+          # @!method initialize(colors: nil, mode: nil, resolution: nil, type: nil, url: nil)
+          #   Some parameter documentations has been truncated, see
+          #   {BrandDev::Models::BrandRetrieveByTickerResponse::Brand::Logo} for more details.
           #
-          #   @param group [Integer] Group identifier for logos
+          #   @param colors [Array<BrandDev::Models::BrandRetrieveByTickerResponse::Brand::Logo::Color>] Array of colors in the logo
           #
-          #   @param mode [String] Mode of the logo, e.g., 'dark', 'light'
+          #   @param mode [Symbol, BrandDev::Models::BrandRetrieveByTickerResponse::Brand::Logo::Mode] Indicates when this logo is best used: 'light' = best for light mode, 'dark' = b
           #
           #   @param resolution [BrandDev::Models::BrandRetrieveByTickerResponse::Brand::Logo::Resolution] Resolution of the logo image
           #
-          #   @param url [String] URL of the logo image
+          #   @param type [Symbol, BrandDev::Models::BrandRetrieveByTickerResponse::Brand::Logo::Type] Type of the logo based on resolution (e.g., 'icon', 'logo')
+          #
+          #   @param url [String] CDN hosted url of the logo (ready for display)
 
           class Color < BrandDev::Internal::Type::BaseModel
             # @!attribute hex
@@ -362,8 +371,30 @@ module BrandDev
             #   @param name [String] Name of the color
           end
 
+          # Indicates when this logo is best used: 'light' = best for light mode, 'dark' =
+          # best for dark mode, 'has_opaque_background' = can be used for either as image
+          # has its own background
+          #
+          # @see BrandDev::Models::BrandRetrieveByTickerResponse::Brand::Logo#mode
+          module Mode
+            extend BrandDev::Internal::Type::Enum
+
+            LIGHT = :light
+            DARK = :dark
+            HAS_OPAQUE_BACKGROUND = :has_opaque_background
+
+            # @!method self.values
+            #   @return [Array<Symbol>]
+          end
+
           # @see BrandDev::Models::BrandRetrieveByTickerResponse::Brand::Logo#resolution
           class Resolution < BrandDev::Internal::Type::BaseModel
+            # @!attribute aspect_ratio
+            #   Aspect ratio of the image (width/height)
+            #
+            #   @return [Float, nil]
+            optional :aspect_ratio, Float
+
             # @!attribute height
             #   Height of the image in pixels
             #
@@ -376,13 +407,28 @@ module BrandDev
             #   @return [Integer, nil]
             optional :width, Integer
 
-            # @!method initialize(height: nil, width: nil)
+            # @!method initialize(aspect_ratio: nil, height: nil, width: nil)
             #   Resolution of the logo image
             #
+            #   @param aspect_ratio [Float] Aspect ratio of the image (width/height)
+            #
             #   @param height [Integer] Height of the image in pixels
             #
             #   @param width [Integer] Width of the image in pixels
           end
+
+          # Type of the logo based on resolution (e.g., 'icon', 'logo')
+          #
+          # @see BrandDev::Models::BrandRetrieveByTickerResponse::Brand::Logo#type
+          module Type
+            extend BrandDev::Internal::Type::Enum
+
+            ICON = :icon
+            LOGO = :logo
+
+            # @!method self.values
+            #   @return [Array<Symbol>]
+          end
         end
 
         class Social < BrandDev::Internal::Type::BaseModel