brand.dev 0.2.0 → 0.3.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: df28fd5aa0d8231a27a6b3c155f9000846e642c65fc753f1774bd6c0e58a014b
-  data.tar.gz: a55600ebc91b03e85320b577705bbd1e5ad3edd60ed6b7b2dbfb5cb1af9089bd
+  metadata.gz: 23c048d37c43f960cb83f4cb6e0279bb2d679d73c25f8f595a9a29a4518350f8
+  data.tar.gz: 79a03cd2a28ad67717d209e0c2282b6ca14179f0bcfbfd7db20855dd4500ff83
 SHA512:
-  metadata.gz: 5d6cdee2fb3161e12e02d0645fbf71508664827af349b769d2f148db5f53df609b135fc556303160711ca287655fbe646aed2826495663d0df3173cb0baea1f4
-  data.tar.gz: 5b6f254d84d2d883ba3c07fe4f86768f10e7fb82651f9f587fe4eb21a81313b98790358ab120275240152c186be0d42568bc106682d0acfab95766b669bdabdb
+  metadata.gz: a960e3351767fa3af608912074a893fcf5b66ceac4f43563cd1838764861a67bc89779aeb085f913ffbceec93e3d22e9ec583cd0cb35b3407f742470670afe95
+  data.tar.gz: 59823343664acd13660bc099e3077d8f171280961ad58cbcdb3147587ee0626c7a3083f65aedf5d2d494b8854b34df47c14c331fb1c8d6f7b402714e6df474cd

data/CHANGELOG.md

@@ -1,5 +1,31 @@
 # Changelog
 
+## 0.3.0 (2025-08-19)
+
+Full Changelog: [v0.2.1...v0.3.0](https://github.com/brand-dot-dev/ruby-sdk/compare/v0.2.1...v0.3.0)
+
+### Features
+
+* **api:** api update ([300cd20](https://github.com/brand-dot-dev/ruby-sdk/commit/300cd20109a1cfb9a20d6f084fd663a4f460b9a1))
+* **api:** api update ([63abe64](https://github.com/brand-dot-dev/ruby-sdk/commit/63abe64a9fb4f188a7667e25a135c7cd16867c10))
+* **api:** api update ([221ec47](https://github.com/brand-dot-dev/ruby-sdk/commit/221ec47349dc4c937bd32e92e8ecd1d7d8bd9321))
+
+
+### Chores
+
+* collect metadata from type DSL ([1c0ddc6](https://github.com/brand-dot-dev/ruby-sdk/commit/1c0ddc66bcacc3fedc7044759dc99bb6d374d71e))
+* **internal:** codegen related update ([f544144](https://github.com/brand-dot-dev/ruby-sdk/commit/f544144eee9d1c3bc1e879a80a9913f51c83f010))
+* **internal:** update comment in script ([1c17fb4](https://github.com/brand-dot-dev/ruby-sdk/commit/1c17fb44ee56f6f8b797f68806cd5dfbeaf66b17))
+* update @stainless-api/prism-cli to v5.15.0 ([42f525c](https://github.com/brand-dot-dev/ruby-sdk/commit/42f525cbd0b0d4418d8cd553b05688a03c06a3ec))
+
+## 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)

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.2.0"
+gem "brand.dev", "~> 0.3.0"
 ```
 
 <!-- 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/internal/type/array_of.rb

@@ -148,6 +148,7 @@ module BrandDev
         #   @option spec [Boolean] :"nil?"
         def initialize(type_info, spec = {})
           @item_type_fn = BrandDev::Internal::Type::Converter.type_info(type_info || spec)
+          @meta = BrandDev::Internal::Type::Converter.meta_info(type_info, spec)
           @nilable = spec.fetch(:nil?, false)
         end
 

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

@@ -52,6 +52,7 @@ module BrandDev
           #
           #   @option spec [Boolean] :"nil?"
           private def add_field(name_sym, required:, type_info:, spec:)
+            meta = BrandDev::Internal::Type::Converter.meta_info(type_info, spec)
             type_fn, info =
               case type_info
               in Proc | BrandDev::Internal::Type::Converter | Class
@@ -81,7 +82,8 @@ module BrandDev
                 required: required,
                 nilable: nilable,
                 const: const,
-                type_fn: type_fn
+                type_fn: type_fn,
+                meta: meta
               }
 
             define_method(setter) do |value|

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

@@ -98,6 +98,33 @@ module BrandDev
             end
           end
 
+          # @api private
+          #
+          # @param type_info [Hash{Symbol=>Object}, Proc, BrandDev::Internal::Type::Converter, Class] .
+          #
+          #   @option type_info [NilClass, TrueClass, FalseClass, Integer, Float, Symbol] :const
+          #
+          #   @option type_info [Proc] :enum
+          #
+          #   @option type_info [Proc] :union
+          #
+          #   @option type_info [Boolean] :"nil?"
+          #
+          # @param spec [Hash{Symbol=>Object}, Proc, BrandDev::Internal::Type::Converter, Class] .
+          #
+          #   @option spec [NilClass, TrueClass, FalseClass, Integer, Float, Symbol] :const
+          #
+          #   @option spec [Proc] :enum
+          #
+          #   @option spec [Proc] :union
+          #
+          #   @option spec [Boolean] :"nil?"
+          #
+          # @return [Hash{Symbol=>Object}]
+          def meta_info(type_info, spec)
+            [spec, type_info].grep(Hash).first.to_h.except(:const, :enum, :union, :nil?)
+          end
+
           # @api private
           #
           # @param translate_names [Boolean]

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

@@ -168,6 +168,7 @@ module BrandDev
         #   @option spec [Boolean] :"nil?"
         def initialize(type_info, spec = {})
           @item_type_fn = BrandDev::Internal::Type::Converter.type_info(type_info || spec)
+          @meta = BrandDev::Internal::Type::Converter.meta_info(type_info, spec)
           @nilable = spec.fetch(:nil?, false)
         end
 

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

@@ -12,20 +12,20 @@ module BrandDev
         #
         # All of the specified variant info for this union.
         #
-        # @return [Array<Array(Symbol, Proc)>]
+        # @return [Array<Array(Symbol, Proc, Hash{Symbol=>Object})>]
         private def known_variants = (@known_variants ||= [])
 
         # @api private
         #
-        # @return [Array<Array(Symbol, Object)>]
+        # @return [Array<Array(Symbol, Object, Hash{Symbol=>Object})>]
         protected def derefed_variants
-          known_variants.map { |key, variant_fn| [key, variant_fn.call] }
+          known_variants.map { |key, variant_fn, meta| [key, variant_fn.call, meta] }
         end
 
         # All of the specified variants for this union.
         #
         # @return [Array<Object>]
-        def variants = derefed_variants.map(&:last)
+        def variants = derefed_variants.map { _2 }
 
         # @api private
         #
@@ -51,12 +51,13 @@ module BrandDev
         #
         #   @option spec [Boolean] :"nil?"
         private def variant(key, spec = nil)
+          meta = BrandDev::Internal::Type::Converter.meta_info(nil, spec)
           variant_info =
             case key
             in Symbol
-              [key, BrandDev::Internal::Type::Converter.type_info(spec)]
+              [key, BrandDev::Internal::Type::Converter.type_info(spec), meta]
             in Proc | BrandDev::Internal::Type::Converter | Class | Hash
-              [nil, BrandDev::Internal::Type::Converter.type_info(key)]
+              [nil, BrandDev::Internal::Type::Converter.type_info(key), meta]
             end
 
           known_variants << variant_info
@@ -79,7 +80,8 @@ module BrandDev
             return nil if key == BrandDev::Internal::OMIT
 
             key = key.to_sym if key.is_a?(String)
-            known_variants.find { |k,| k == key }&.last&.call
+            _, found = known_variants.find { |k,| k == key }
+            found&.call
           else
             nil
           end

data/lib/brand_dev/models/brand_identify_from_transaction_response.rb

@@ -69,6 +69,12 @@ module BrandDev
         #   @return [String, nil]
         optional :email, String
 
+        # @!attribute industries
+        #   Industry classification information for the brand
+        #
+        #   @return [BrandDev::Models::BrandIdentifyFromTransactionResponse::Brand::Industries, nil]
+        optional :industries, -> { BrandDev::Models::BrandIdentifyFromTransactionResponse::Brand::Industries }
+
         # @!attribute is_nsfw
         #   Indicates whether the brand content is not safe for work (NSFW)
         #
@@ -114,7 +120,7 @@ module BrandDev
         #   @return [String, nil]
         optional :title, String
 
-        # @!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)
+        # @!method initialize(address: nil, backdrops: nil, colors: nil, description: nil, domain: nil, email: nil, industries: 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.
@@ -133,6 +139,8 @@ module BrandDev
         #
         #   @param email [String] Company email address
         #
+        #   @param industries [BrandDev::Models::BrandIdentifyFromTransactionResponse::Brand::Industries] Industry classification information for the brand
+        #
         #   @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
@@ -306,6 +314,308 @@ module BrandDev
           #   @param name [String] Name of the color
         end
 
+        # @see BrandDev::Models::BrandIdentifyFromTransactionResponse::Brand#industries
+        class Industries < BrandDev::Internal::Type::BaseModel
+          # @!attribute eic
+          #   Easy Industry Classification - array of industry and subindustry pairs
+          #
+          #   @return [Array<BrandDev::Models::BrandIdentifyFromTransactionResponse::Brand::Industries::Eic>, nil]
+          optional :eic,
+                   -> { BrandDev::Internal::Type::ArrayOf[BrandDev::Models::BrandIdentifyFromTransactionResponse::Brand::Industries::Eic] }
+
+          # @!method initialize(eic: nil)
+          #   Industry classification information for the brand
+          #
+          #   @param eic [Array<BrandDev::Models::BrandIdentifyFromTransactionResponse::Brand::Industries::Eic>] Easy Industry Classification - array of industry and subindustry pairs
+
+          class Eic < BrandDev::Internal::Type::BaseModel
+            # @!attribute industry
+            #   Industry classification enum
+            #
+            #   @return [Symbol, BrandDev::Models::BrandIdentifyFromTransactionResponse::Brand::Industries::Eic::Industry]
+            required :industry,
+                     enum: -> { BrandDev::Models::BrandIdentifyFromTransactionResponse::Brand::Industries::Eic::Industry }
+
+            # @!attribute subindustry
+            #   Subindustry classification enum
+            #
+            #   @return [Symbol, BrandDev::Models::BrandIdentifyFromTransactionResponse::Brand::Industries::Eic::Subindustry]
+            required :subindustry,
+                     enum: -> { BrandDev::Models::BrandIdentifyFromTransactionResponse::Brand::Industries::Eic::Subindustry }
+
+            # @!method initialize(industry:, subindustry:)
+            #   @param industry [Symbol, BrandDev::Models::BrandIdentifyFromTransactionResponse::Brand::Industries::Eic::Industry] Industry classification enum
+            #
+            #   @param subindustry [Symbol, BrandDev::Models::BrandIdentifyFromTransactionResponse::Brand::Industries::Eic::Subindustry] Subindustry classification enum
+
+            # Industry classification enum
+            #
+            # @see BrandDev::Models::BrandIdentifyFromTransactionResponse::Brand::Industries::Eic#industry
+            module Industry
+              extend BrandDev::Internal::Type::Enum
+
+              AEROSPACE_DEFENSE = :"Aerospace & Defense"
+              TECHNOLOGY = :Technology
+              FINANCE = :Finance
+              HEALTHCARE = :Healthcare
+              RETAIL_E_COMMERCE = :"Retail & E-commerce"
+              ENTERTAINMENT = :Entertainment
+              EDUCATION = :Education
+              GOVERNMENT_NONPROFIT = :"Government & Nonprofit"
+              INDUSTRIAL_ENERGY = :"Industrial & Energy"
+              AUTOMOTIVE_TRANSPORTATION = :"Automotive & Transportation"
+              LIFESTYLE_LEISURE = :"Lifestyle & Leisure"
+              LUXURY_FASHION = :"Luxury & Fashion"
+              NEWS_MEDIA = :"News & Media"
+              SPORTS = :Sports
+              REAL_ESTATE_PROP_TECH = :"Real Estate & PropTech"
+              LEGAL_COMPLIANCE = :"Legal & Compliance"
+              TELECOMMUNICATIONS = :Telecommunications
+              AGRICULTURE_FOOD = :"Agriculture & Food"
+              PROFESSIONAL_SERVICES_AGENCIES = :"Professional Services & Agencies"
+              CHEMICALS_MATERIALS = :"Chemicals & Materials"
+              LOGISTICS_SUPPLY_CHAIN = :"Logistics & Supply Chain"
+              HOSPITALITY_TOURISM = :"Hospitality & Tourism"
+              CONSTRUCTION_BUILT_ENVIRONMENT = :"Construction & Built Environment"
+              CONSUMER_PACKAGED_GOODS_CPG = :"Consumer Packaged Goods (CPG)"
+
+              # @!method self.values
+              #   @return [Array<Symbol>]
+            end
+
+            # Subindustry classification enum
+            #
+            # @see BrandDev::Models::BrandIdentifyFromTransactionResponse::Brand::Industries::Eic#subindustry
+            module Subindustry
+              extend BrandDev::Internal::Type::Enum
+
+              DEFENSE_SYSTEMS_MILITARY_HARDWARE = :"Defense Systems & Military Hardware"
+              AEROSPACE_MANUFACTURING = :"Aerospace Manufacturing"
+              AVIONICS_NAVIGATION_TECHNOLOGY = :"Avionics & Navigation Technology"
+              SUBSEA_NAVAL_DEFENSE_SYSTEMS = :"Subsea & Naval Defense Systems"
+              SPACE_SATELLITE_TECHNOLOGY = :"Space & Satellite Technology"
+              DEFENSE_IT_SYSTEMS_INTEGRATION = :"Defense IT & Systems Integration"
+              SOFTWARE_B2_B = :"Software (B2B)"
+              SOFTWARE_B2_C = :"Software (B2C)"
+              CLOUD_INFRASTRUCTURE_DEV_OPS = :"Cloud Infrastructure & DevOps"
+              CYBERSECURITY = :Cybersecurity
+              ARTIFICIAL_INTELLIGENCE_MACHINE_LEARNING = :"Artificial Intelligence & Machine Learning"
+              DATA_INFRASTRUCTURE_ANALYTICS = :"Data Infrastructure & Analytics"
+              HARDWARE_SEMICONDUCTORS = :"Hardware & Semiconductors"
+              FINTECH_INFRASTRUCTURE = :"Fintech Infrastructure"
+              E_COMMERCE_MARKETPLACE_PLATFORMS = :"eCommerce & Marketplace Platforms"
+              DEVELOPER_TOOLS_APIS = :"Developer Tools & APIs"
+              WEB3_BLOCKCHAIN = :"Web3 & Blockchain"
+              XR_SPATIAL_COMPUTING = :"XR & Spatial Computing"
+              BANKING_LENDING = :"Banking & Lending"
+              INVESTMENT_MANAGEMENT_WEALTH_TECH = :"Investment Management & WealthTech"
+              INSURANCE_INSUR_TECH = :"Insurance & InsurTech"
+              PAYMENTS_MONEY_MOVEMENT = :"Payments & Money Movement"
+              ACCOUNTING_TAX_FINANCIAL_PLANNING_TOOLS = :"Accounting, Tax & Financial Planning Tools"
+              CAPITAL_MARKETS_TRADING_PLATFORMS = :"Capital Markets & Trading Platforms"
+              FINANCIAL_INFRASTRUCTURE_APIS = :"Financial Infrastructure & APIs"
+              CREDIT_SCORING_RISK_MANAGEMENT = :"Credit Scoring & Risk Management"
+              CRYPTOCURRENCY_DIGITAL_ASSETS = :"Cryptocurrency & Digital Assets"
+              BNPL_ALTERNATIVE_FINANCING = :"BNPL & Alternative Financing"
+              HEALTHCARE_PROVIDERS_SERVICES = :"Healthcare Providers & Services"
+              PHARMACEUTICALS_DRUG_DEVELOPMENT = :"Pharmaceuticals & Drug Development"
+              MEDICAL_DEVICES_DIAGNOSTICS = :"Medical Devices & Diagnostics"
+              BIOTECHNOLOGY_GENOMICS = :"Biotechnology & Genomics"
+              DIGITAL_HEALTH_TELEMEDICINE = :"Digital Health & Telemedicine"
+              HEALTH_INSURANCE_BENEFITS_TECH = :"Health Insurance & Benefits Tech"
+              CLINICAL_TRIALS_RESEARCH_PLATFORMS = :"Clinical Trials & Research Platforms"
+              MENTAL_HEALTH_WELLNESS = :"Mental Health & Wellness"
+              HEALTHCARE_IT_EHR_SYSTEMS = :"Healthcare IT & EHR Systems"
+              CONSUMER_HEALTH_WELLNESS_PRODUCTS = :"Consumer Health & Wellness Products"
+              ONLINE_MARKETPLACES = :"Online Marketplaces"
+              DIRECT_TO_CONSUMER_DTC_BRANDS = :"Direct-to-Consumer (DTC) Brands"
+              RETAIL_TECH_POINT_OF_SALE_SYSTEMS = :"Retail Tech & Point-of-Sale Systems"
+              OMNICHANNEL_IN_STORE_RETAIL = :"Omnichannel & In-Store Retail"
+              E_COMMERCE_ENABLEMENT_INFRASTRUCTURE = :"E-commerce Enablement & Infrastructure"
+              SUBSCRIPTION_MEMBERSHIP_COMMERCE = :"Subscription & Membership Commerce"
+              SOCIAL_COMMERCE_INFLUENCER_PLATFORMS = :"Social Commerce & Influencer Platforms"
+              FASHION_APPAREL_RETAIL = :"Fashion & Apparel Retail"
+              FOOD_BEVERAGE_GROCERY_E_COMMERCE = :"Food, Beverage & Grocery E-commerce"
+              STREAMING_PLATFORMS_VIDEO_MUSIC_AUDIO = :"Streaming Platforms (Video, Music, Audio)"
+              GAMING_INTERACTIVE_ENTERTAINMENT = :"Gaming & Interactive Entertainment"
+              CREATOR_ECONOMY_INFLUENCER_PLATFORMS = :"Creator Economy & Influencer Platforms"
+              ADVERTISING_ADTECH_MEDIA_BUYING = :"Advertising, Adtech & Media Buying"
+              FILM_TV_PRODUCTION_STUDIOS = :"Film, TV & Production Studios"
+              EVENTS_VENUES_LIVE_ENTERTAINMENT = :"Events, Venues & Live Entertainment"
+              VIRTUAL_WORLDS_METAVERSE_EXPERIENCES = :"Virtual Worlds & Metaverse Experiences"
+              K_12_EDUCATION_PLATFORMS_TOOLS = :"K-12 Education Platforms & Tools"
+              HIGHER_EDUCATION_UNIVERSITY_TECH = :"Higher Education & University Tech"
+              ONLINE_LEARNING_MOO_CS = :"Online Learning & MOOCs"
+              TEST_PREP_CERTIFICATION = :"Test Prep & Certification"
+              CORPORATE_TRAINING_UPSKILLING = :"Corporate Training & Upskilling"
+              TUTORING_SUPPLEMENTAL_LEARNING = :"Tutoring & Supplemental Learning"
+              EDUCATION_MANAGEMENT_SYSTEMS_LMS_SIS = :"Education Management Systems (LMS/SIS)"
+              LANGUAGE_LEARNING = :"Language Learning"
+              CREATOR_LED_COHORT_BASED_COURSES = :"Creator-Led & Cohort-Based Courses"
+              SPECIAL_EDUCATION_ACCESSIBILITY_TOOLS = :"Special Education & Accessibility Tools"
+              GOVERNMENT_TECHNOLOGY_DIGITAL_SERVICES = :"Government Technology & Digital Services"
+              CIVIC_ENGAGEMENT_POLICY_PLATFORMS = :"Civic Engagement & Policy Platforms"
+              INTERNATIONAL_DEVELOPMENT_HUMANITARIAN_AID = :"International Development & Humanitarian Aid"
+              PHILANTHROPY_GRANTMAKING = :"Philanthropy & Grantmaking"
+              NONPROFIT_OPERATIONS_FUNDRAISING_TOOLS = :"Nonprofit Operations & Fundraising Tools"
+              PUBLIC_HEALTH_SOCIAL_SERVICES = :"Public Health & Social Services"
+              EDUCATION_YOUTH_DEVELOPMENT_PROGRAMS = :"Education & Youth Development Programs"
+              ENVIRONMENTAL_CLIMATE_ACTION_ORGANIZATIONS = :"Environmental & Climate Action Organizations"
+              LEGAL_AID_SOCIAL_JUSTICE_ADVOCACY = :"Legal Aid & Social Justice Advocacy"
+              MUNICIPAL_INFRASTRUCTURE_SERVICES = :"Municipal & Infrastructure Services"
+              MANUFACTURING_INDUSTRIAL_AUTOMATION = :"Manufacturing & Industrial Automation"
+              ENERGY_PRODUCTION_OIL_GAS_NUCLEAR = :"Energy Production (Oil, Gas, Nuclear)"
+              RENEWABLE_ENERGY_CLEANTECH = :"Renewable Energy & Cleantech"
+              UTILITIES_GRID_INFRASTRUCTURE = :"Utilities & Grid Infrastructure"
+              INDUSTRIAL_IO_T_MONITORING_SYSTEMS = :"Industrial IoT & Monitoring Systems"
+              CONSTRUCTION_HEAVY_EQUIPMENT = :"Construction & Heavy Equipment"
+              MINING_NATURAL_RESOURCES = :"Mining & Natural Resources"
+              ENVIRONMENTAL_ENGINEERING_SUSTAINABILITY = :"Environmental Engineering & Sustainability"
+              ENERGY_STORAGE_BATTERY_TECHNOLOGY = :"Energy Storage & Battery Technology"
+              AUTOMOTIVE_OE_MS_VEHICLE_MANUFACTURING = :"Automotive OEMs & Vehicle Manufacturing"
+              ELECTRIC_VEHICLES_E_VS_CHARGING_INFRASTRUCTURE = :"Electric Vehicles (EVs) & Charging Infrastructure"
+              MOBILITY_AS_A_SERVICE_MAA_S = :"Mobility-as-a-Service (MaaS)"
+              FLEET_MANAGEMENT = :"Fleet Management"
+              PUBLIC_TRANSIT_URBAN_MOBILITY = :"Public Transit & Urban Mobility"
+              AUTONOMOUS_VEHICLES_ADAS = :"Autonomous Vehicles & ADAS"
+              AFTERMARKET_PARTS_SERVICES = :"Aftermarket Parts & Services"
+              TELEMATICS_VEHICLE_CONNECTIVITY = :"Telematics & Vehicle Connectivity"
+              AVIATION_AEROSPACE_TRANSPORT = :"Aviation & Aerospace Transport"
+              MARITIME_SHIPPING = :"Maritime Shipping"
+              FITNESS_WELLNESS = :"Fitness & Wellness"
+              BEAUTY_PERSONAL_CARE = :"Beauty & Personal Care"
+              HOME_LIVING = :"Home & Living"
+              DATING_RELATIONSHIPS = :"Dating & Relationships"
+              HOBBIES_CRAFTS_DIY = :"Hobbies, Crafts & DIY"
+              OUTDOOR_RECREATIONAL_GEAR = :"Outdoor & Recreational Gear"
+              EVENTS_EXPERIENCES_TICKETING_PLATFORMS = :"Events, Experiences & Ticketing Platforms"
+              DESIGNER_LUXURY_APPAREL = :"Designer & Luxury Apparel"
+              ACCESSORIES_JEWELRY_WATCHES = :"Accessories, Jewelry & Watches"
+              FOOTWEAR_LEATHER_GOODS = :"Footwear & Leather Goods"
+              BEAUTY_FRAGRANCE_SKINCARE = :"Beauty, Fragrance & Skincare"
+              FASHION_MARKETPLACES_RETAIL_PLATFORMS = :"Fashion Marketplaces & Retail Platforms"
+              SUSTAINABLE_ETHICAL_FASHION = :"Sustainable & Ethical Fashion"
+              RESALE_VINTAGE_CIRCULAR_FASHION = :"Resale, Vintage & Circular Fashion"
+              FASHION_TECH_VIRTUAL_TRY_ONS = :"Fashion Tech & Virtual Try-Ons"
+              STREETWEAR_EMERGING_LUXURY = :"Streetwear & Emerging Luxury"
+              COUTURE_MADE_TO_MEASURE = :"Couture & Made-to-Measure"
+              NEWS_PUBLISHING_JOURNALISM = :"News Publishing & Journalism"
+              DIGITAL_MEDIA_CONTENT_PLATFORMS = :"Digital Media & Content Platforms"
+              BROADCASTING_TV_RADIO = :"Broadcasting (TV & Radio)"
+              PODCASTING_AUDIO_MEDIA = :"Podcasting & Audio Media"
+              NEWS_AGGREGATORS_CURATION_TOOLS = :"News Aggregators & Curation Tools"
+              INDEPENDENT_CREATOR_LED_MEDIA = :"Independent & Creator-Led Media"
+              NEWSLETTERS_SUBSTACK_STYLE_PLATFORMS = :"Newsletters & Substack-Style Platforms"
+              POLITICAL_INVESTIGATIVE_MEDIA = :"Political & Investigative Media"
+              TRADE_NICHE_PUBLICATIONS = :"Trade & Niche Publications"
+              MEDIA_MONITORING_ANALYTICS = :"Media Monitoring & Analytics"
+              PROFESSIONAL_TEAMS_LEAGUES = :"Professional Teams & Leagues"
+              SPORTS_MEDIA_BROADCASTING = :"Sports Media & Broadcasting"
+              SPORTS_BETTING_FANTASY_SPORTS = :"Sports Betting & Fantasy Sports"
+              FITNESS_ATHLETIC_TRAINING_PLATFORMS = :"Fitness & Athletic Training Platforms"
+              SPORTSWEAR_EQUIPMENT = :"Sportswear & Equipment"
+              ESPORTS_COMPETITIVE_GAMING = :"Esports & Competitive Gaming"
+              SPORTS_VENUES_EVENT_MANAGEMENT = :"Sports Venues & Event Management"
+              ATHLETE_MANAGEMENT_TALENT_AGENCIES = :"Athlete Management & Talent Agencies"
+              SPORTS_TECH_PERFORMANCE_ANALYTICS = :"Sports Tech & Performance Analytics"
+              YOUTH_AMATEUR_COLLEGIATE_SPORTS = :"Youth, Amateur & Collegiate Sports"
+              REAL_ESTATE_MARKETPLACES = :"Real Estate Marketplaces"
+              PROPERTY_MANAGEMENT_SOFTWARE = :"Property Management Software"
+              RENTAL_PLATFORMS = :"Rental Platforms"
+              MORTGAGE_LENDING_TECH = :"Mortgage & Lending Tech"
+              REAL_ESTATE_INVESTMENT_PLATFORMS = :"Real Estate Investment Platforms"
+              LAW_FIRMS_LEGAL_SERVICES = :"Law Firms & Legal Services"
+              LEGAL_TECH_AUTOMATION = :"Legal Tech & Automation"
+              REGULATORY_COMPLIANCE = :"Regulatory Compliance"
+              E_DISCOVERY_LITIGATION_TOOLS = :"E-Discovery & Litigation Tools"
+              CONTRACT_MANAGEMENT = :"Contract Management"
+              GOVERNANCE_RISK_COMPLIANCE_GRC = :"Governance, Risk & Compliance (GRC)"
+              IP_TRADEMARK_MANAGEMENT = :"IP & Trademark Management"
+              LEGAL_RESEARCH_INTELLIGENCE = :"Legal Research & Intelligence"
+              COMPLIANCE_TRAINING_CERTIFICATION = :"Compliance Training & Certification"
+              WHISTLEBLOWER_ETHICS_REPORTING = :"Whistleblower & Ethics Reporting"
+              MOBILE_WIRELESS_NETWORKS_3_G_4_G_5_G = :"Mobile & Wireless Networks (3G/4G/5G)"
+              BROADBAND_FIBER_INTERNET = :"Broadband & Fiber Internet"
+              SATELLITE_SPACE_BASED_COMMUNICATIONS = :"Satellite & Space-Based Communications"
+              NETWORK_EQUIPMENT_INFRASTRUCTURE = :"Network Equipment & Infrastructure"
+              TELECOM_BILLING_OSS_BSS_SYSTEMS = :"Telecom Billing & OSS/BSS Systems"
+              VO_IP_UNIFIED_COMMUNICATIONS = :"VoIP & Unified Communications"
+              INTERNET_SERVICE_PROVIDERS_IS_PS = :"Internet Service Providers (ISPs)"
+              EDGE_COMPUTING_NETWORK_VIRTUALIZATION = :"Edge Computing & Network Virtualization"
+              IO_T_CONNECTIVITY_PLATFORMS = :"IoT Connectivity Platforms"
+              PRECISION_AGRICULTURE_AG_TECH = :"Precision Agriculture & AgTech"
+              CROP_LIVESTOCK_PRODUCTION = :"Crop & Livestock Production"
+              FOOD_BEVERAGE_MANUFACTURING_PROCESSING = :"Food & Beverage Manufacturing & Processing"
+              FOOD_DISTRIBUTION = :"Food Distribution"
+              RESTAURANTS_FOOD_SERVICE = :"Restaurants & Food Service"
+              AGRICULTURAL_INPUTS_EQUIPMENT = :"Agricultural Inputs & Equipment"
+              SUSTAINABLE_REGENERATIVE_AGRICULTURE = :"Sustainable & Regenerative Agriculture"
+              SEAFOOD_AQUACULTURE = :"Seafood & Aquaculture"
+              MANAGEMENT_CONSULTING = :"Management Consulting"
+              MARKETING_ADVERTISING_AGENCIES = :"Marketing & Advertising Agencies"
+              DESIGN_BRANDING_CREATIVE_STUDIOS = :"Design, Branding & Creative Studios"
+              IT_SERVICES_MANAGED_SERVICES = :"IT Services & Managed Services"
+              STAFFING_RECRUITING_TALENT = :"Staffing, Recruiting & Talent"
+              ACCOUNTING_TAX_FIRMS = :"Accounting & Tax Firms"
+              PUBLIC_RELATIONS_COMMUNICATIONS = :"Public Relations & Communications"
+              BUSINESS_PROCESS_OUTSOURCING_BPO = :"Business Process Outsourcing (BPO)"
+              PROFESSIONAL_TRAINING_COACHING = :"Professional Training & Coaching"
+              SPECIALTY_CHEMICALS = :"Specialty Chemicals"
+              COMMODITY_PETROCHEMICALS = :"Commodity & Petrochemicals"
+              POLYMERS_PLASTICS_RUBBER = :"Polymers, Plastics & Rubber"
+              COATINGS_ADHESIVES_SEALANTS = :"Coatings, Adhesives & Sealants"
+              INDUSTRIAL_GASES = :"Industrial Gases"
+              ADVANCED_MATERIALS_COMPOSITES = :"Advanced Materials & Composites"
+              BATTERY_MATERIALS_ENERGY_STORAGE = :"Battery Materials & Energy Storage"
+              ELECTRONIC_MATERIALS_SEMICONDUCTOR_CHEMICALS = :"Electronic Materials & Semiconductor Chemicals"
+              AGROCHEMICALS_FERTILIZERS = :"Agrochemicals & Fertilizers"
+              FREIGHT_TRANSPORTATION_TECH = :"Freight & Transportation Tech"
+              LAST_MILE_DELIVERY = :"Last-Mile Delivery"
+              WAREHOUSE_AUTOMATION = :"Warehouse Automation"
+              SUPPLY_CHAIN_VISIBILITY_PLATFORMS = :"Supply Chain Visibility Platforms"
+              LOGISTICS_MARKETPLACES = :"Logistics Marketplaces"
+              SHIPPING_FREIGHT_FORWARDING = :"Shipping & Freight Forwarding"
+              COLD_CHAIN_LOGISTICS = :"Cold Chain Logistics"
+              REVERSE_LOGISTICS_RETURNS = :"Reverse Logistics & Returns"
+              CROSS_BORDER_TRADE_TECH = :"Cross-Border Trade Tech"
+              TRANSPORTATION_MANAGEMENT_SYSTEMS_TMS = :"Transportation Management Systems (TMS)"
+              HOTELS_ACCOMMODATION = :"Hotels & Accommodation"
+              VACATION_RENTALS_SHORT_TERM_STAYS = :"Vacation Rentals & Short-Term Stays"
+              RESTAURANT_TECH_MANAGEMENT = :"Restaurant Tech & Management"
+              TRAVEL_BOOKING_PLATFORMS = :"Travel Booking Platforms"
+              TOURISM_EXPERIENCES_ACTIVITIES = :"Tourism Experiences & Activities"
+              CRUISE_LINES_MARINE_TOURISM = :"Cruise Lines & Marine Tourism"
+              HOSPITALITY_MANAGEMENT_SYSTEMS = :"Hospitality Management Systems"
+              EVENT_VENUE_MANAGEMENT = :"Event & Venue Management"
+              CORPORATE_TRAVEL_MANAGEMENT = :"Corporate Travel Management"
+              TRAVEL_INSURANCE_PROTECTION = :"Travel Insurance & Protection"
+              CONSTRUCTION_MANAGEMENT_SOFTWARE = :"Construction Management Software"
+              BIM_CAD_DESIGN_TOOLS = :"BIM/CAD & Design Tools"
+              CONSTRUCTION_MARKETPLACES = :"Construction Marketplaces"
+              EQUIPMENT_RENTAL_MANAGEMENT = :"Equipment Rental & Management"
+              BUILDING_MATERIALS_PROCUREMENT = :"Building Materials & Procurement"
+              CONSTRUCTION_WORKFORCE_MANAGEMENT = :"Construction Workforce Management"
+              PROJECT_ESTIMATION_BIDDING = :"Project Estimation & Bidding"
+              MODULAR_PREFAB_CONSTRUCTION = :"Modular & Prefab Construction"
+              CONSTRUCTION_SAFETY_COMPLIANCE = :"Construction Safety & Compliance"
+              SMART_BUILDING_TECHNOLOGY = :"Smart Building Technology"
+              FOOD_BEVERAGE_CPG = :"Food & Beverage CPG"
+              HOME_PERSONAL_CARE_CPG = :"Home & Personal Care CPG"
+              CPG_ANALYTICS_INSIGHTS = :"CPG Analytics & Insights"
+              DIRECT_TO_CONSUMER_CPG_BRANDS = :"Direct-to-Consumer CPG Brands"
+              CPG_SUPPLY_CHAIN_DISTRIBUTION = :"CPG Supply Chain & Distribution"
+              PRIVATE_LABEL_MANUFACTURING = :"Private Label Manufacturing"
+              CPG_RETAIL_INTELLIGENCE = :"CPG Retail Intelligence"
+              SUSTAINABLE_CPG_PACKAGING = :"Sustainable CPG & Packaging"
+              BEAUTY_COSMETICS_CPG = :"Beauty & Cosmetics CPG"
+              HEALTH_WELLNESS_CPG = :"Health & Wellness CPG"
+
+              # @!method self.values
+              #   @return [Array<Symbol>]
+            end
+          end
+        end
+
         class Logo < BrandDev::Internal::Type::BaseModel
           # @!attribute colors
           #   Array of colors in the logo

data/lib/brand_dev/models/brand_retrieve_params.rb

@@ -8,13 +8,15 @@ module BrandDev
       include BrandDev::Internal::Type::RequestParameters
 
       # @!attribute domain
-      #   Domain name to retrieve brand data for
+      #   Domain name to retrieve brand data for (e.g., 'example.com', 'google.com').
+      #   Cannot be used with name or ticker parameters.
       #
-      #   @return [String]
-      required :domain, String
+      #   @return [String, nil]
+      optional :domain, String
 
       # @!attribute force_language
-      #   Optional parameter to force the language of the retrieved brand data
+      #   Optional parameter to force the language of the retrieved brand data. Works with
+      #   all three lookup methods.
       #
       #   @return [Symbol, BrandDev::Models::BrandRetrieveParams::ForceLanguage, nil]
       optional :force_language, enum: -> { BrandDev::BrandRetrieveParams::ForceLanguage }
@@ -22,11 +24,27 @@ module BrandDev
       # @!attribute max_speed
       #   Optional parameter to optimize the API call for maximum speed. When set to true,
       #   the API will skip time-consuming operations for faster response at the cost of
-      #   less comprehensive data.
+      #   less comprehensive data. Works with all three lookup methods.
       #
       #   @return [Boolean, nil]
       optional :max_speed, BrandDev::Internal::Type::Boolean
 
+      # @!attribute name
+      #   Company name to retrieve brand data for (e.g., 'Apple Inc', 'Microsoft
+      #   Corporation'). Must be 3-30 characters. Cannot be used with domain or ticker
+      #   parameters.
+      #
+      #   @return [String, nil]
+      optional :name, String
+
+      # @!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.
+      #
+      #   @return [String, nil]
+      optional :ticker, String
+
       # @!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
@@ -35,21 +53,26 @@ module BrandDev
       #   @return [Integer, nil]
       optional :timeout_ms, Integer
 
-      # @!method initialize(domain:, force_language: nil, max_speed: nil, timeout_ms: nil, request_options: {})
+      # @!method initialize(domain: nil, force_language: nil, max_speed: nil, name: nil, ticker: nil, timeout_ms: nil, request_options: {})
       #   Some parameter documentations has been truncated, see
       #   {BrandDev::Models::BrandRetrieveParams} for more details.
       #
-      #   @param domain [String] Domain name to retrieve brand data for
+      #   @param domain [String] Domain name to retrieve brand data for (e.g., 'example.com', 'google.com'). Cann
       #
-      #   @param force_language [Symbol, BrandDev::Models::BrandRetrieveParams::ForceLanguage] Optional parameter to force the language of the retrieved brand data
+      #   @param force_language [Symbol, BrandDev::Models::BrandRetrieveParams::ForceLanguage] Optional parameter to force the language of the retrieved brand data. Works with
       #
       #   @param max_speed [Boolean] Optional parameter to optimize the API call for maximum speed. When set to true,
       #
+      #   @param name [String] Company name to retrieve brand data for (e.g., 'Apple Inc', 'Microsoft Corporati
+      #
+      #   @param ticker [String] Stock ticker symbol to retrieve brand data for (e.g., 'AAPL', 'GOOGL', 'BRK.A').
+      #
       #   @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}]
 
-      # Optional parameter to force the language of the retrieved brand data
+      # Optional parameter to force the language of the retrieved brand data. Works with
+      # all three lookup methods.
       module ForceLanguage
         extend BrandDev::Internal::Type::Enum