brand.dev 0.1.0 → 0.2.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 824d292c41a48213239b6d735b4603e5e00e06e78993cf0ef687aa52222c9755
-  data.tar.gz: fd40a5b5cab29332c6a1a25654015f31230523e059646ce75be08696c0605fd8
+  metadata.gz: c1733af9001125a6d8043d5b1cc26bd9daebe84de1815720f1b27d91600d69bb
+  data.tar.gz: 12ca79b8f074d7adbdcc99f5b2caa74dce3af2bd1aa38c7a6693a2467e6e4e17
 SHA512:
-  metadata.gz: 134eb59e2cf2b53012812e2d0028e488ecfae96cc0a0bd18e79f0042421fde9d121a0e90d152e6093947a538367e121d97e89b6c5264d5b3ece7b884d99154c6
-  data.tar.gz: 6dec3e7ad876474973f234021971eb5dd751ac87f638dbee58a95f9915e79c7099c2281b3583e9667c150894409de7edb7cdf72ef5ca9a2b9bdef461de9c3757
+  metadata.gz: e07bc91cf68b05b3382dc7194c8b152e5fec14499d6f10c335b810bdf1366421c746eb11437ef255406736d9bd9390b9c790cb49b10d850ee416a85d8ecad3c2
+  data.tar.gz: c8b69abe8f13128a313e83033ab45058aa62db44d7b84a53120f75c18b70917988f2cb6d30afe9dc9414b2a49bd925637fc2efdbd5bf4ed03b85ce76ea5a4695

data/CHANGELOG.md

@@ -1,5 +1,21 @@
 # Changelog
 
+## 0.2.1 (2025-08-01)
+
+Full Changelog: [v0.2.0...v0.2.1](https://github.com/brand-dot-dev/ruby-sdk/compare/v0.2.0...v0.2.1)
+
+### Chores
+
+* **internal:** increase visibility of internal helper method ([cfabb97](https://github.com/brand-dot-dev/ruby-sdk/commit/cfabb971de6365cbc73952eb438d4d9ecfb5407c))
+
+## 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)

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

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

@@ -365,7 +365,7 @@ module BrandDev
         #
         # @raise [BrandDev::Errors::APIError]
         # @return [Array(Integer, Net::HTTPResponse, Enumerable<String>)]
-        private def send_request(request, redirect_count:, retry_count:, send_retry_header:)
+        def send_request(request, redirect_count:, retry_count:, send_retry_header:)
           url, headers, max_retries, timeout = request.fetch_values(:url, :headers, :max_retries, :timeout)
           input = {**request.except(:timeout), deadline: BrandDev::Internal::Util.monotonic_secs + timeout}
 

data/lib/brand_dev/models/brand_ai_query_response.rb

@@ -4,12 +4,6 @@ module BrandDev
   module Models
     # @see BrandDev::Resources::Brand#ai_query
     class BrandAIQueryResponse < BrandDev::Internal::Type::BaseModel
-      # @!attribute code
-      #   HTTP status code
-      #
-      #   @return [Integer, nil]
-      optional :code, Integer
-
       # @!attribute data_extracted
       #   Array of extracted data points
       #
@@ -35,9 +29,7 @@ module BrandDev
       #   @return [Array<String>, nil]
       optional :urls_analyzed, BrandDev::Internal::Type::ArrayOf[String]
 
-      # @!method initialize(code: nil, data_extracted: nil, domain: nil, status: nil, urls_analyzed: nil)
-      #   @param code [Integer] HTTP status code
-      #
+      # @!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

data/lib/brand_dev/models/brand_identify_from_transaction_response.rb

@@ -63,6 +63,12 @@ module BrandDev
         #   @return [String, nil]
         optional :domain, String
 
+        # @!attribute email
+        #   Company email address
+        #
+        #   @return [String, nil]
+        optional :email, String
+
         # @!attribute is_nsfw
         #   Indicates whether the brand content is not safe for work (NSFW)
         #
@@ -76,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
         #
@@ -102,7 +114,7 @@ module BrandDev
         #   @return [String, nil]
         optional :title, String
 
-        # @!method initialize(address: nil, backdrops: nil, colors: nil, description: nil, domain: nil, is_nsfw: 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.
@@ -119,10 +131,14 @@ module BrandDev
         #
         #   @param domain [String] The domain name of the brand
         #
+        #   @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
@@ -242,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
             #
@@ -254,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
@@ -290,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
@@ -309,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
@@ -345,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
             #
@@ -359,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,6 +63,12 @@ module BrandDev
         #   @return [String, nil]
         optional :domain, String
 
+        # @!attribute email
+        #   Company email address
+        #
+        #   @return [String, nil]
+        optional :email, String
+
         # @!attribute is_nsfw
         #   Indicates whether the brand content is not safe for work (NSFW)
         #
@@ -76,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
         #
@@ -102,7 +114,7 @@ module BrandDev
         #   @return [String, nil]
         optional :title, String
 
-        # @!method initialize(address: nil, backdrops: nil, colors: nil, description: nil, domain: nil, is_nsfw: 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.
         #
@@ -118,10 +130,14 @@ module BrandDev
         #
         #   @param domain [String] The domain name of the brand
         #
+        #   @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
@@ -240,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
             #
@@ -252,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
@@ -288,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
@@ -306,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
@@ -342,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
             #
@@ -356,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

data/lib/brand_dev/models/brand_retrieve_response.rb

@@ -63,6 +63,12 @@ module BrandDev
         #   @return [String, nil]
         optional :domain, String
 
+        # @!attribute email
+        #   Company email address
+        #
+        #   @return [String, nil]
+        optional :email, String
+
         # @!attribute is_nsfw
         #   Indicates whether the brand content is not safe for work (NSFW)
         #
@@ -76,6 +82,12 @@ module BrandDev
         optional :logos,
                  -> { BrandDev::Internal::Type::ArrayOf[BrandDev::Models::BrandRetrieveResponse::Brand::Logo] }
 
+        # @!attribute phone
+        #   Company phone number
+        #
+        #   @return [String, nil]
+        optional :phone, String
+
         # @!attribute slogan
         #   The brand's slogan
         #
@@ -102,7 +114,7 @@ module BrandDev
         #   @return [String, nil]
         optional :title, String
 
-        # @!method initialize(address: nil, backdrops: nil, colors: nil, description: nil, domain: nil, is_nsfw: 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::BrandRetrieveResponse::Brand} for more details.
         #
@@ -118,10 +130,14 @@ module BrandDev
         #
         #   @param domain [String] The domain name of the brand
         #
+        #   @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::BrandRetrieveResponse::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::BrandRetrieveResponse::Brand::Social>] An array of social media links for the brand
@@ -240,6 +256,12 @@ module BrandDev
 
           # @see BrandDev::Models::BrandRetrieveResponse::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
             #
@@ -252,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
@@ -288,17 +312,13 @@ module BrandDev
           optional :colors,
                    -> { BrandDev::Internal::Type::ArrayOf[BrandDev::Models::BrandRetrieveResponse::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::BrandRetrieveResponse::Brand::Logo::Mode, nil]
+          optional :mode, enum: -> { BrandDev::Models::BrandRetrieveResponse::Brand::Logo::Mode }
 
           # @!attribute resolution
           #   Resolution of the logo image
@@ -306,22 +326,31 @@ module BrandDev
           #   @return [BrandDev::Models::BrandRetrieveResponse::Brand::Logo::Resolution, nil]
           optional :resolution, -> { BrandDev::Models::BrandRetrieveResponse::Brand::Logo::Resolution }
 
+          # @!attribute type
+          #   Type of the logo based on resolution (e.g., 'icon', 'logo')
+          #
+          #   @return [Symbol, BrandDev::Models::BrandRetrieveResponse::Brand::Logo::Type, nil]
+          optional :type, enum: -> { BrandDev::Models::BrandRetrieveResponse::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::BrandRetrieveResponse::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::BrandRetrieveResponse::Brand::Logo} for more details.
           #
-          #   @param group [Integer] Group identifier for logos
+          #   @param colors [Array<BrandDev::Models::BrandRetrieveResponse::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::BrandRetrieveResponse::Brand::Logo::Mode] Indicates when this logo is best used: 'light' = best for light mode, 'dark' = b
           #
           #   @param resolution [BrandDev::Models::BrandRetrieveResponse::Brand::Logo::Resolution] Resolution of the logo image
           #
-          #   @param url [String] URL of the logo image
+          #   @param type [Symbol, BrandDev::Models::BrandRetrieveResponse::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
@@ -342,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::BrandRetrieveResponse::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::BrandRetrieveResponse::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
             #
@@ -356,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::BrandRetrieveResponse::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