brand.dev 0.0.1.pre.alpha.0 → 0.1.0.pre.alpha.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 308ab90d3e6f03ff0fb725a2aece6d8c14bb16ff54ed00fab2fee5ad217a72fe
-  data.tar.gz: 92c6e324a4885ac710359c9556dad60e904d8630a25510c79c122de0d436f420
+  metadata.gz: e9985ae9ba5e62a158a02c8cd2b290bab9811c3ebc6f3061c2f1d90cbf2d0dbe
+  data.tar.gz: cf66b53c0110ff560bb84484e6113990f4f078aa740ca1a8e653cd32334c6f06
 SHA512:
-  metadata.gz: 9d454dbf45c518f184acb12ec4f9f418add64888c748939005d7a88df98affd9f4935cc5346088aca69041fd18096d6d92d8f4c69b8dbcc537278050c4358e19
-  data.tar.gz: 9aa4d6101d29030416e70f1ded7cd38550c582baf2822b5face0f3706718c7989ac27d964f7bd9f08ab55fffdb3e4c5ef7f369fd7ecfea5e409fcc67a991ef49
+  metadata.gz: d1cdf4ea4e6b14cdf0bd77d0eb0d2a9d75edee737d10d0464f30df495b35e6eb811e55ca8cb1f379c6dd2f109d8052541e7671d0efbcf5cb57f66ca6d53cbfe0
+  data.tar.gz: 23b905b672117b2d6ade382f7f0291d800072c1de2967b21f0bde3cad888e5317d87cf42e688697db88d31264c0f70d1eadcee46941c943e4ea171173adf5d39

data/CHANGELOG.md

@@ -0,0 +1,15 @@
+# Changelog
+
+## 0.1.0-alpha.1 (2025-06-02)
+
+Full Changelog: [v0.0.1-alpha.0...v0.1.0-alpha.1](https://github.com/brand-dot-dev/ruby-sdk/compare/v0.0.1-alpha.0...v0.1.0-alpha.1)
+
+### Features
+
+* **api:** manual updates ([1c2a095](https://github.com/brand-dot-dev/ruby-sdk/commit/1c2a09538494964e67752f572ed11a41f4bf4e29))
+
+
+### Chores
+
+* configure new SDK language ([4b2d19e](https://github.com/brand-dot-dev/ruby-sdk/commit/4b2d19e3ea9342c01529655c0231e1258c04de35))
+* sync repo ([fc86136](https://github.com/brand-dot-dev/ruby-sdk/commit/fc86136bdab0b1c30529662a3dedb8016726d8bc))

data/README.md

@@ -1,6 +1,6 @@
 # Brand Dev Ruby API library
 
-The Brand Dev Ruby library provides convenient access to the Brand Dev REST API from any Ruby 3.2.0+ application. It ships with comprehensive types & docstrings in Yard, RBS, and RBI – [see below](https://github.com/stainless-sdks/brand.dev-ruby#Sorbet) for usage with Sorbet. The standard library's `net/http` is used as the HTTP transport, with connection pooling via the `connection_pool` gem.
+The Brand Dev Ruby library provides convenient access to the Brand Dev REST API from any Ruby 3.2.0+ application. It ships with comprehensive types & docstrings in Yard, RBS, and RBI – [see below](https://github.com/brand-dot-dev/ruby-sdk#Sorbet) for usage with Sorbet. The standard library's `net/http` is used as the HTTP transport, with connection pooling via the `connection_pool` gem.
 
 It is generated with [Stainless](https://www.stainless.com/).
 
@@ -12,10 +12,14 @@ Documentation for releases of this gem can be found [on RubyDoc](https://gemdocs
 
 To use this gem, install via Bundler by adding the following to your application's `Gemfile`:
 
+<!-- x-release-please-start-version -->
+
 ```ruby
-gem "brand.dev", "~> 0.0.1.pre.alpha.0"
+gem "brand.dev", "~> 0.1.0.pre.alpha.1"
 ```
 
+<!-- x-release-please-end -->
+
 ## Usage
 
 ```ruby
@@ -226,4 +230,4 @@ Ruby 3.2.0 or higher.
 
 ## Contributing
 
-See [the contributing documentation](https://github.com/stainless-sdks/brand.dev-ruby/tree/main/CONTRIBUTING.md).
+See [the contributing documentation](https://github.com/brand-dot-dev/ruby-sdk/tree/main/CONTRIBUTING.md).

data/lib/brand_dev/models/brand_ai_query_params.rb

@@ -0,0 +1,91 @@
+# frozen_string_literal: true
+
+module BrandDev
+  module Models
+    # @see BrandDev::Resources::Brand#ai_query
+    class BrandAIQueryParams < BrandDev::Internal::Type::BaseModel
+      extend BrandDev::Internal::Type::RequestParameters::Converter
+      include BrandDev::Internal::Type::RequestParameters
+
+      # @!attribute data_to_extract
+      #   Array of data points to extract from the website
+      #
+      #   @return [Array<BrandDev::Models::BrandAIQueryParams::DataToExtract>]
+      required :data_to_extract,
+               -> { BrandDev::Internal::Type::ArrayOf[BrandDev::BrandAIQueryParams::DataToExtract] }
+
+      # @!attribute domain
+      #   The domain name to analyze
+      #
+      #   @return [String]
+      required :domain, String
+
+      # @!attribute specific_pages
+      #   Optional array of specific pages to analyze
+      #
+      #   @return [Array<String>, nil]
+      optional :specific_pages, BrandDev::Internal::Type::ArrayOf[String]
+
+      # @!method initialize(data_to_extract:, domain:, specific_pages: nil, request_options: {})
+      #   @param data_to_extract [Array<BrandDev::Models::BrandAIQueryParams::DataToExtract>] Array of data points to extract from the website
+      #
+      #   @param domain [String] The domain name to analyze
+      #
+      #   @param specific_pages [Array<String>] Optional array of specific pages to analyze
+      #
+      #   @param request_options [BrandDev::RequestOptions, Hash{Symbol=>Object}]
+
+      class DataToExtract < BrandDev::Internal::Type::BaseModel
+        # @!attribute datapoint_description
+        #   Description of what to extract
+        #
+        #   @return [String]
+        required :datapoint_description, String
+
+        # @!attribute datapoint_example
+        #   Example of the expected value
+        #
+        #   @return [String]
+        required :datapoint_example, String
+
+        # @!attribute datapoint_name
+        #   Name of the data point to extract
+        #
+        #   @return [String]
+        required :datapoint_name, String
+
+        # @!attribute datapoint_type
+        #   Type of the data point
+        #
+        #   @return [Symbol, BrandDev::Models::BrandAIQueryParams::DataToExtract::DatapointType]
+        required :datapoint_type, enum: -> { BrandDev::BrandAIQueryParams::DataToExtract::DatapointType }
+
+        # @!method initialize(datapoint_description:, datapoint_example:, datapoint_name:, datapoint_type:)
+        #   @param datapoint_description [String] Description of what to extract
+        #
+        #   @param datapoint_example [String] Example of the expected value
+        #
+        #   @param datapoint_name [String] Name of the data point to extract
+        #
+        #   @param datapoint_type [Symbol, BrandDev::Models::BrandAIQueryParams::DataToExtract::DatapointType] Type of the data point
+
+        # Type of the data point
+        #
+        # @see BrandDev::Models::BrandAIQueryParams::DataToExtract#datapoint_type
+        module DatapointType
+          extend BrandDev::Internal::Type::Enum
+
+          TEXT = :text
+          NUMBER = :number
+          DATE = :date
+          BOOLEAN = :boolean
+          LIST = :list
+          URL = :url
+
+          # @!method self.values
+          #   @return [Array<Symbol>]
+        end
+      end
+    end
+  end
+end

data/lib/brand_dev/models/brand_ai_query_response.rb

@@ -0,0 +1,80 @@
+# frozen_string_literal: true
+
+module BrandDev
+  module Models
+    # @see BrandDev::Resources::Brand#ai_query
+    class BrandAIQueryResponse < BrandDev::Internal::Type::BaseModel
+      # @!attribute data_extracted
+      #   Array of extracted data points
+      #
+      #   @return [Array<BrandDev::Models::BrandAIQueryResponse::DataExtracted>, nil]
+      optional :data_extracted,
+               -> { BrandDev::Internal::Type::ArrayOf[BrandDev::Models::BrandAIQueryResponse::DataExtracted] }
+
+      # @!attribute domain
+      #   The domain that was analyzed
+      #
+      #   @return [String, nil]
+      optional :domain, 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)
+      #   @param data_extracted [Array<BrandDev::Models::BrandAIQueryResponse::DataExtracted>] Array of extracted data points
+      #
+      #   @param domain [String] The domain that was analyzed
+      #
+      #   @param urls_analyzed [Array<String>] List of URLs that were analyzed
+
+      class DataExtracted < BrandDev::Internal::Type::BaseModel
+        # @!attribute datapoint_name
+        #   Name of the extracted data point
+        #
+        #   @return [String, nil]
+        optional :datapoint_name, String
+
+        # @!attribute datapoint_value
+        #   Value of the extracted data point
+        #
+        #   @return [String, Float, Boolean, Array<String>, Array<Float>, nil]
+        optional :datapoint_value,
+                 union: -> { BrandDev::Models::BrandAIQueryResponse::DataExtracted::DatapointValue }
+
+        # @!method initialize(datapoint_name: nil, datapoint_value: nil)
+        #   @param datapoint_name [String] Name of the extracted data point
+        #
+        #   @param datapoint_value [String, Float, Boolean, Array<String>, Array<Float>] Value of the extracted data point
+
+        # Value of the extracted data point
+        #
+        # @see BrandDev::Models::BrandAIQueryResponse::DataExtracted#datapoint_value
+        module DatapointValue
+          extend BrandDev::Internal::Type::Union
+
+          variant String
+
+          variant Float
+
+          variant BrandDev::Internal::Type::Boolean
+
+          variant -> { BrandDev::Models::BrandAIQueryResponse::DataExtracted::DatapointValue::StringArray }
+
+          variant -> { BrandDev::Models::BrandAIQueryResponse::DataExtracted::DatapointValue::FloatArray }
+
+          # @!method self.variants
+          #   @return [Array(String, Float, Boolean, Array<String>, Array<Float>)]
+
+          # @type [BrandDev::Internal::Type::Converter]
+          StringArray = BrandDev::Internal::Type::ArrayOf[String]
+
+          # @type [BrandDev::Internal::Type::Converter]
+          FloatArray = BrandDev::Internal::Type::ArrayOf[Float]
+        end
+      end
+    end
+  end
+end

data/lib/brand_dev/models.rb

@@ -39,6 +39,8 @@ module BrandDev
     mod.define_sorbet_constant!(const) { T.type_alias { mod.to_sorbet_type } }
   end
 
+  BrandAIQueryParams = BrandDev::Models::BrandAIQueryParams
+
   BrandIdentifyFromTransactionParams = BrandDev::Models::BrandIdentifyFromTransactionParams
 
   BrandRetrieveByTickerParams = BrandDev::Models::BrandRetrieveByTickerParams

data/lib/brand_dev/resources/brand.rb

@@ -27,6 +27,34 @@ module BrandDev
         )
       end
 
+      # Beta feature: Use AI to extract specific data points from a brand's website. The
+      # AI will crawl the website and extract the requested information based on the
+      # provided data points.
+      #
+      # @overload ai_query(data_to_extract:, domain:, specific_pages: nil, request_options: {})
+      #
+      # @param data_to_extract [Array<BrandDev::Models::BrandAIQueryParams::DataToExtract>] Array of data points to extract from the website
+      #
+      # @param domain [String] The domain name to analyze
+      #
+      # @param specific_pages [Array<String>] Optional array of specific pages to analyze
+      #
+      # @param request_options [BrandDev::RequestOptions, Hash{Symbol=>Object}, nil]
+      #
+      # @return [BrandDev::Models::BrandAIQueryResponse]
+      #
+      # @see BrandDev::Models::BrandAIQueryParams
+      def ai_query(params)
+        parsed, options = BrandDev::BrandAIQueryParams.dump_request(params)
+        @client.request(
+          method: :post,
+          path: "brand/ai/query",
+          body: parsed,
+          model: BrandDev::Models::BrandAIQueryResponse,
+          options: options
+        )
+      end
+
       # Endpoint specially designed for platforms that want to identify transaction data
       # by the transaction title.
       #

data/lib/brand_dev/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module BrandDev
-  VERSION = "0.0.1.pre.alpha.0"
+  VERSION = "0.1.0.pre.alpha.1"
 end

data/lib/brand_dev.rb

@@ -50,6 +50,8 @@ require_relative "brand_dev/errors"
 require_relative "brand_dev/internal/transport/base_client"
 require_relative "brand_dev/internal/transport/pooled_net_requester"
 require_relative "brand_dev/client"
+require_relative "brand_dev/models/brand_ai_query_params"
+require_relative "brand_dev/models/brand_ai_query_response"
 require_relative "brand_dev/models/brand_identify_from_transaction_params"
 require_relative "brand_dev/models/brand_identify_from_transaction_response"
 require_relative "brand_dev/models/brand_retrieve_by_ticker_params"

data/rbi/brand_dev/models/brand_ai_query_params.rbi

@@ -0,0 +1,184 @@
+# typed: strong
+
+module BrandDev
+  module Models
+    class BrandAIQueryParams < BrandDev::Internal::Type::BaseModel
+      extend BrandDev::Internal::Type::RequestParameters::Converter
+      include BrandDev::Internal::Type::RequestParameters
+
+      OrHash =
+        T.type_alias do
+          T.any(BrandDev::BrandAIQueryParams, BrandDev::Internal::AnyHash)
+        end
+
+      # Array of data points to extract from the website
+      sig { returns(T::Array[BrandDev::BrandAIQueryParams::DataToExtract]) }
+      attr_accessor :data_to_extract
+
+      # The domain name to analyze
+      sig { returns(String) }
+      attr_accessor :domain
+
+      # Optional array of specific pages to analyze
+      sig { returns(T.nilable(T::Array[String])) }
+      attr_reader :specific_pages
+
+      sig { params(specific_pages: T::Array[String]).void }
+      attr_writer :specific_pages
+
+      sig do
+        params(
+          data_to_extract:
+            T::Array[BrandDev::BrandAIQueryParams::DataToExtract::OrHash],
+          domain: String,
+          specific_pages: T::Array[String],
+          request_options: BrandDev::RequestOptions::OrHash
+        ).returns(T.attached_class)
+      end
+      def self.new(
+        # Array of data points to extract from the website
+        data_to_extract:,
+        # The domain name to analyze
+        domain:,
+        # Optional array of specific pages to analyze
+        specific_pages: nil,
+        request_options: {}
+      )
+      end
+
+      sig do
+        override.returns(
+          {
+            data_to_extract:
+              T::Array[BrandDev::BrandAIQueryParams::DataToExtract],
+            domain: String,
+            specific_pages: T::Array[String],
+            request_options: BrandDev::RequestOptions
+          }
+        )
+      end
+      def to_hash
+      end
+
+      class DataToExtract < BrandDev::Internal::Type::BaseModel
+        OrHash =
+          T.type_alias do
+            T.any(
+              BrandDev::BrandAIQueryParams::DataToExtract,
+              BrandDev::Internal::AnyHash
+            )
+          end
+
+        # Description of what to extract
+        sig { returns(String) }
+        attr_accessor :datapoint_description
+
+        # Example of the expected value
+        sig { returns(String) }
+        attr_accessor :datapoint_example
+
+        # Name of the data point to extract
+        sig { returns(String) }
+        attr_accessor :datapoint_name
+
+        # Type of the data point
+        sig do
+          returns(
+            BrandDev::BrandAIQueryParams::DataToExtract::DatapointType::OrSymbol
+          )
+        end
+        attr_accessor :datapoint_type
+
+        sig do
+          params(
+            datapoint_description: String,
+            datapoint_example: String,
+            datapoint_name: String,
+            datapoint_type:
+              BrandDev::BrandAIQueryParams::DataToExtract::DatapointType::OrSymbol
+          ).returns(T.attached_class)
+        end
+        def self.new(
+          # Description of what to extract
+          datapoint_description:,
+          # Example of the expected value
+          datapoint_example:,
+          # Name of the data point to extract
+          datapoint_name:,
+          # Type of the data point
+          datapoint_type:
+        )
+        end
+
+        sig do
+          override.returns(
+            {
+              datapoint_description: String,
+              datapoint_example: String,
+              datapoint_name: String,
+              datapoint_type:
+                BrandDev::BrandAIQueryParams::DataToExtract::DatapointType::OrSymbol
+            }
+          )
+        end
+        def to_hash
+        end
+
+        # Type of the data point
+        module DatapointType
+          extend BrandDev::Internal::Type::Enum
+
+          TaggedSymbol =
+            T.type_alias do
+              T.all(
+                Symbol,
+                BrandDev::BrandAIQueryParams::DataToExtract::DatapointType
+              )
+            end
+          OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+          TEXT =
+            T.let(
+              :text,
+              BrandDev::BrandAIQueryParams::DataToExtract::DatapointType::TaggedSymbol
+            )
+          NUMBER =
+            T.let(
+              :number,
+              BrandDev::BrandAIQueryParams::DataToExtract::DatapointType::TaggedSymbol
+            )
+          DATE =
+            T.let(
+              :date,
+              BrandDev::BrandAIQueryParams::DataToExtract::DatapointType::TaggedSymbol
+            )
+          BOOLEAN =
+            T.let(
+              :boolean,
+              BrandDev::BrandAIQueryParams::DataToExtract::DatapointType::TaggedSymbol
+            )
+          LIST =
+            T.let(
+              :list,
+              BrandDev::BrandAIQueryParams::DataToExtract::DatapointType::TaggedSymbol
+            )
+          URL =
+            T.let(
+              :url,
+              BrandDev::BrandAIQueryParams::DataToExtract::DatapointType::TaggedSymbol
+            )
+
+          sig do
+            override.returns(
+              T::Array[
+                BrandDev::BrandAIQueryParams::DataToExtract::DatapointType::TaggedSymbol
+              ]
+            )
+          end
+          def self.values
+          end
+        end
+      end
+    end
+  end
+end

data/rbi/brand_dev/models/brand_ai_query_response.rbi

@@ -0,0 +1,182 @@
+# typed: strong
+
+module BrandDev
+  module Models
+    class BrandAIQueryResponse < BrandDev::Internal::Type::BaseModel
+      OrHash =
+        T.type_alias do
+          T.any(
+            BrandDev::Models::BrandAIQueryResponse,
+            BrandDev::Internal::AnyHash
+          )
+        end
+
+      # Array of extracted data points
+      sig do
+        returns(
+          T.nilable(
+            T::Array[BrandDev::Models::BrandAIQueryResponse::DataExtracted]
+          )
+        )
+      end
+      attr_reader :data_extracted
+
+      sig do
+        params(
+          data_extracted:
+            T::Array[
+              BrandDev::Models::BrandAIQueryResponse::DataExtracted::OrHash
+            ]
+        ).void
+      end
+      attr_writer :data_extracted
+
+      # The domain that was analyzed
+      sig { returns(T.nilable(String)) }
+      attr_reader :domain
+
+      sig { params(domain: String).void }
+      attr_writer :domain
+
+      # List of URLs that were analyzed
+      sig { returns(T.nilable(T::Array[String])) }
+      attr_reader :urls_analyzed
+
+      sig { params(urls_analyzed: T::Array[String]).void }
+      attr_writer :urls_analyzed
+
+      sig do
+        params(
+          data_extracted:
+            T::Array[
+              BrandDev::Models::BrandAIQueryResponse::DataExtracted::OrHash
+            ],
+          domain: String,
+          urls_analyzed: T::Array[String]
+        ).returns(T.attached_class)
+      end
+      def self.new(
+        # Array of extracted data points
+        data_extracted: nil,
+        # The domain that was analyzed
+        domain: nil,
+        # List of URLs that were analyzed
+        urls_analyzed: nil
+      )
+      end
+
+      sig do
+        override.returns(
+          {
+            data_extracted:
+              T::Array[BrandDev::Models::BrandAIQueryResponse::DataExtracted],
+            domain: String,
+            urls_analyzed: T::Array[String]
+          }
+        )
+      end
+      def to_hash
+      end
+
+      class DataExtracted < BrandDev::Internal::Type::BaseModel
+        OrHash =
+          T.type_alias do
+            T.any(
+              BrandDev::Models::BrandAIQueryResponse::DataExtracted,
+              BrandDev::Internal::AnyHash
+            )
+          end
+
+        # Name of the extracted data point
+        sig { returns(T.nilable(String)) }
+        attr_reader :datapoint_name
+
+        sig { params(datapoint_name: String).void }
+        attr_writer :datapoint_name
+
+        # Value of the extracted data point
+        sig do
+          returns(
+            T.nilable(
+              BrandDev::Models::BrandAIQueryResponse::DataExtracted::DatapointValue::Variants
+            )
+          )
+        end
+        attr_reader :datapoint_value
+
+        sig do
+          params(
+            datapoint_value:
+              BrandDev::Models::BrandAIQueryResponse::DataExtracted::DatapointValue::Variants
+          ).void
+        end
+        attr_writer :datapoint_value
+
+        sig do
+          params(
+            datapoint_name: String,
+            datapoint_value:
+              BrandDev::Models::BrandAIQueryResponse::DataExtracted::DatapointValue::Variants
+          ).returns(T.attached_class)
+        end
+        def self.new(
+          # Name of the extracted data point
+          datapoint_name: nil,
+          # Value of the extracted data point
+          datapoint_value: nil
+        )
+        end
+
+        sig do
+          override.returns(
+            {
+              datapoint_name: String,
+              datapoint_value:
+                BrandDev::Models::BrandAIQueryResponse::DataExtracted::DatapointValue::Variants
+            }
+          )
+        end
+        def to_hash
+        end
+
+        # Value of the extracted data point
+        module DatapointValue
+          extend BrandDev::Internal::Type::Union
+
+          Variants =
+            T.type_alias do
+              T.any(
+                String,
+                Float,
+                T::Boolean,
+                T::Array[String],
+                T::Array[Float]
+              )
+            end
+
+          sig do
+            override.returns(
+              T::Array[
+                BrandDev::Models::BrandAIQueryResponse::DataExtracted::DatapointValue::Variants
+              ]
+            )
+          end
+          def self.variants
+          end
+
+          StringArray =
+            T.let(
+              BrandDev::Internal::Type::ArrayOf[String],
+              BrandDev::Internal::Type::Converter
+            )
+
+          FloatArray =
+            T.let(
+              BrandDev::Internal::Type::ArrayOf[Float],
+              BrandDev::Internal::Type::Converter
+            )
+        end
+      end
+    end
+  end
+end

data/rbi/brand_dev/models.rbi

@@ -1,6 +1,8 @@
 # typed: strong
 
 module BrandDev
+  BrandAIQueryParams = BrandDev::Models::BrandAIQueryParams
+
   BrandIdentifyFromTransactionParams =
     BrandDev::Models::BrandIdentifyFromTransactionParams
 

data/rbi/brand_dev/resources/brand.rbi

@@ -21,6 +21,29 @@ module BrandDev
       )
       end
 
+      # Beta feature: Use AI to extract specific data points from a brand's website. The
+      # AI will crawl the website and extract the requested information based on the
+      # provided data points.
+      sig do
+        params(
+          data_to_extract:
+            T::Array[BrandDev::BrandAIQueryParams::DataToExtract::OrHash],
+          domain: String,
+          specific_pages: T::Array[String],
+          request_options: BrandDev::RequestOptions::OrHash
+        ).returns(BrandDev::Models::BrandAIQueryResponse)
+      end
+      def ai_query(
+        # Array of data points to extract from the website
+        data_to_extract:,
+        # The domain name to analyze
+        domain:,
+        # Optional array of specific pages to analyze
+        specific_pages: nil,
+        request_options: {}
+      )
+      end
+
       # Endpoint specially designed for platforms that want to identify transaction data
       # by the transaction title.
       sig do

data/sig/brand_dev/models/brand_ai_query_params.rbs

@@ -0,0 +1,85 @@
+module BrandDev
+  module Models
+    type brand_ai_query_params =
+      {
+        data_to_extract: ::Array[BrandDev::BrandAIQueryParams::DataToExtract],
+        domain: String,
+        specific_pages: ::Array[String]
+      }
+      & BrandDev::Internal::Type::request_parameters
+
+    class BrandAIQueryParams < BrandDev::Internal::Type::BaseModel
+      extend BrandDev::Internal::Type::RequestParameters::Converter
+      include BrandDev::Internal::Type::RequestParameters
+
+      attr_accessor data_to_extract: ::Array[BrandDev::BrandAIQueryParams::DataToExtract]
+
+      attr_accessor domain: String
+
+      attr_reader specific_pages: ::Array[String]?
+
+      def specific_pages=: (::Array[String]) -> ::Array[String]
+
+      def initialize: (
+        data_to_extract: ::Array[BrandDev::BrandAIQueryParams::DataToExtract],
+        domain: String,
+        ?specific_pages: ::Array[String],
+        ?request_options: BrandDev::request_opts
+      ) -> void
+
+      def to_hash: -> {
+        data_to_extract: ::Array[BrandDev::BrandAIQueryParams::DataToExtract],
+        domain: String,
+        specific_pages: ::Array[String],
+        request_options: BrandDev::RequestOptions
+      }
+
+      type data_to_extract =
+        {
+          datapoint_description: String,
+          datapoint_example: String,
+          datapoint_name: String,
+          datapoint_type: BrandDev::Models::BrandAIQueryParams::DataToExtract::datapoint_type
+        }
+
+      class DataToExtract < BrandDev::Internal::Type::BaseModel
+        attr_accessor datapoint_description: String
+
+        attr_accessor datapoint_example: String
+
+        attr_accessor datapoint_name: String
+
+        attr_accessor datapoint_type: BrandDev::Models::BrandAIQueryParams::DataToExtract::datapoint_type
+
+        def initialize: (
+          datapoint_description: String,
+          datapoint_example: String,
+          datapoint_name: String,
+          datapoint_type: BrandDev::Models::BrandAIQueryParams::DataToExtract::datapoint_type
+        ) -> void
+
+        def to_hash: -> {
+          datapoint_description: String,
+          datapoint_example: String,
+          datapoint_name: String,
+          datapoint_type: BrandDev::Models::BrandAIQueryParams::DataToExtract::datapoint_type
+        }
+
+        type datapoint_type = :text | :number | :date | :boolean | :list | :url
+
+        module DatapointType
+          extend BrandDev::Internal::Type::Enum
+
+          TEXT: :text
+          NUMBER: :number
+          DATE: :date
+          BOOLEAN: :boolean
+          LIST: :list
+          URL: :url
+
+          def self?.values: -> ::Array[BrandDev::Models::BrandAIQueryParams::DataToExtract::datapoint_type]
+        end
+      end
+    end
+  end
+end

data/sig/brand_dev/models/brand_ai_query_response.rbs

@@ -0,0 +1,79 @@
+module BrandDev
+  module Models
+    type brand_ai_query_response =
+      {
+        data_extracted: ::Array[BrandDev::Models::BrandAIQueryResponse::DataExtracted],
+        domain: String,
+        urls_analyzed: ::Array[String]
+      }
+
+    class BrandAIQueryResponse < BrandDev::Internal::Type::BaseModel
+      attr_reader data_extracted: ::Array[BrandDev::Models::BrandAIQueryResponse::DataExtracted]?
+
+      def data_extracted=: (
+        ::Array[BrandDev::Models::BrandAIQueryResponse::DataExtracted]
+      ) -> ::Array[BrandDev::Models::BrandAIQueryResponse::DataExtracted]
+
+      attr_reader domain: String?
+
+      def domain=: (String) -> String
+
+      attr_reader urls_analyzed: ::Array[String]?
+
+      def urls_analyzed=: (::Array[String]) -> ::Array[String]
+
+      def initialize: (
+        ?data_extracted: ::Array[BrandDev::Models::BrandAIQueryResponse::DataExtracted],
+        ?domain: String,
+        ?urls_analyzed: ::Array[String]
+      ) -> void
+
+      def to_hash: -> {
+        data_extracted: ::Array[BrandDev::Models::BrandAIQueryResponse::DataExtracted],
+        domain: String,
+        urls_analyzed: ::Array[String]
+      }
+
+      type data_extracted =
+        {
+          datapoint_name: String,
+          datapoint_value: BrandDev::Models::BrandAIQueryResponse::DataExtracted::datapoint_value
+        }
+
+      class DataExtracted < BrandDev::Internal::Type::BaseModel
+        attr_reader datapoint_name: String?
+
+        def datapoint_name=: (String) -> String
+
+        attr_reader datapoint_value: BrandDev::Models::BrandAIQueryResponse::DataExtracted::datapoint_value?
+
+        def datapoint_value=: (
+          BrandDev::Models::BrandAIQueryResponse::DataExtracted::datapoint_value
+        ) -> BrandDev::Models::BrandAIQueryResponse::DataExtracted::datapoint_value
+
+        def initialize: (
+          ?datapoint_name: String,
+          ?datapoint_value: BrandDev::Models::BrandAIQueryResponse::DataExtracted::datapoint_value
+        ) -> void
+
+        def to_hash: -> {
+          datapoint_name: String,
+          datapoint_value: BrandDev::Models::BrandAIQueryResponse::DataExtracted::datapoint_value
+        }
+
+        type datapoint_value =
+          String | Float | bool | ::Array[String] | ::Array[Float]
+
+        module DatapointValue
+          extend BrandDev::Internal::Type::Union
+
+          def self?.variants: -> ::Array[BrandDev::Models::BrandAIQueryResponse::DataExtracted::datapoint_value]
+
+          StringArray: BrandDev::Internal::Type::Converter
+
+          FloatArray: BrandDev::Internal::Type::Converter
+        end
+      end
+    end
+  end
+end

data/sig/brand_dev/models.rbs

@@ -1,4 +1,6 @@
 module BrandDev
+  class BrandAIQueryParams = BrandDev::Models::BrandAIQueryParams
+
   class BrandIdentifyFromTransactionParams = BrandDev::Models::BrandIdentifyFromTransactionParams
 
   class BrandRetrieveByTickerParams = BrandDev::Models::BrandRetrieveByTickerParams

data/sig/brand_dev/resources/brand.rbs

@@ -7,6 +7,13 @@ module BrandDev
         ?request_options: BrandDev::request_opts
       ) -> BrandDev::Models::BrandRetrieveResponse
 
+      def ai_query: (
+        data_to_extract: ::Array[BrandDev::BrandAIQueryParams::DataToExtract],
+        domain: String,
+        ?specific_pages: ::Array[String],
+        ?request_options: BrandDev::request_opts
+      ) -> BrandDev::Models::BrandAIQueryResponse
+
       def identify_from_transaction: (
         transaction_info: String,
         ?request_options: BrandDev::request_opts

metadata

@@ -1,36 +1,37 @@
 --- !ruby/object:Gem::Specification
 name: brand.dev
 version: !ruby/object:Gem::Version
-  version: 0.0.1.pre.alpha.0
+  version: 0.1.0.pre.alpha.1
 platform: ruby
 authors:
 - Brand Dev
-autorequire: 
+autorequire:
 bindir: bin
 cert_chain: []
-date: 2025-05-29 00:00:00.000000000 Z
+date: 2025-06-02 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: connection_pool
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
-        version: '2.2'
+        version: '0'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
-        version: '2.2'
-description: 
+        version: '0'
+description:
 email: ''
 executables: []
 extensions: []
 extra_rdoc_files:
 - README.md
 files:
+- CHANGELOG.md
 - README.md
 - SECURITY.md
 - lib/brand_dev.rb
@@ -53,6 +54,8 @@ files:
 - lib/brand_dev/internal/type/unknown.rb
 - lib/brand_dev/internal/util.rb
 - lib/brand_dev/models.rb
+- lib/brand_dev/models/brand_ai_query_params.rb
+- lib/brand_dev/models/brand_ai_query_response.rb
 - lib/brand_dev/models/brand_identify_from_transaction_params.rb
 - lib/brand_dev/models/brand_identify_from_transaction_response.rb
 - lib/brand_dev/models/brand_retrieve_by_ticker_params.rb
@@ -86,6 +89,8 @@ files:
 - rbi/brand_dev/internal/type/unknown.rbi
 - rbi/brand_dev/internal/util.rbi
 - rbi/brand_dev/models.rbi
+- rbi/brand_dev/models/brand_ai_query_params.rbi
+- rbi/brand_dev/models/brand_ai_query_response.rbi
 - rbi/brand_dev/models/brand_identify_from_transaction_params.rbi
 - rbi/brand_dev/models/brand_identify_from_transaction_response.rbi
 - rbi/brand_dev/models/brand_retrieve_by_ticker_params.rbi
@@ -118,6 +123,8 @@ files:
 - sig/brand_dev/internal/type/unknown.rbs
 - sig/brand_dev/internal/util.rbs
 - sig/brand_dev/models.rbs
+- sig/brand_dev/models/brand_ai_query_params.rbs
+- sig/brand_dev/models/brand_ai_query_response.rbs
 - sig/brand_dev/models/brand_identify_from_transaction_params.rbs
 - sig/brand_dev/models/brand_identify_from_transaction_response.rbs
 - sig/brand_dev/models/brand_retrieve_by_ticker_params.rbs
@@ -132,13 +139,12 @@ files:
 - sig/brand_dev/resources/brand.rbs
 - sig/brand_dev/version.rbs
 homepage: https://gemdocs.org/gems/brand.dev
-licenses:
-- Apache-2.0
+licenses: []
 metadata:
   homepage_uri: https://gemdocs.org/gems/brand.dev
-  source_code_uri: https://github.com/stainless-sdks/brand.dev-ruby
+  source_code_uri: https://github.com/brand-dot-dev/ruby-sdk
   rubygems_mfa_required: 'false'
-post_install_message: 
+post_install_message:
 rdoc_options: []
 require_paths:
 - lib
@@ -153,8 +159,8 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: 1.3.1
 requirements: []
-rubygems_version: 3.0.3.1
-signing_key: 
+rubygems_version: 3.4.1
+signing_key:
 specification_version: 4
 summary: Ruby library to access the Brand Dev API
 test_files: []