context.dev 2.7.0 → 2.8.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: e324f1e33503f55a47664f8196dc0f07abf62c1c4fed5e9d09baee669939f16f
-  data.tar.gz: 43c6f5ec7f3e210ec6ea287db7ffee80cbd6c6f0c8fca7438ea8625540787127
+  metadata.gz: 00c5f92b8b65317b72386a6582682ef62851cef787995be6a72be151b4aa40fb
+  data.tar.gz: 3e3a50df8e1e9d2cebdfb69de6f5c4ca0f29fee113b9c616c12b12f73515a29c
 SHA512:
-  metadata.gz: a0da6fbb0005114984cc6ee0ee233ae6b0b81666442ed342937cdf93469ece8acd041d7c25560ace5adbdc5e2c8a8e921ca931c3bd8216a04d56d6f9fd721ed0
-  data.tar.gz: 2dea9ed22d8eac728dcb0defaebf1a345fd8c1a2e649dd0a416e59639492fd04db7d3d34f94186f3cb613161deff4ac579f9002360d5c43cab474ab63ff004b5
+  metadata.gz: ce4193c612f2b34aced1bd14795a8e914b1aac8fd89178a654249db944163516ed7abde812992c6b070f4b1c05ff3dc74b0c3a3157645394f05b39a3b18c50ba
+  data.tar.gz: 62118c6e0913a9653616fd42121f3bacbc4b473f187430c0be61fd6fe496a046b4f1f831c1df748a14f4bde33fbcfe532f0afd92e13ae11bf604bea5207efdc7

data/CHANGELOG.md

@@ -1,5 +1,13 @@
 # Changelog
 
+## 2.8.0 (2026-08-05)
+
+Full Changelog: [v2.7.0...v2.8.0](https://github.com/context-dot-dev/context-ruby-sdk/compare/v2.7.0...v2.8.0)
+
+### Features
+
+* **api:** manual updates ([054713e](https://github.com/context-dot-dev/context-ruby-sdk/commit/054713ecd7a6c12c29a2aaf0df0ea0eeb0ff61fc))
+
 ## 2.7.0 (2026-08-01)
 
 Full Changelog: [v2.6.0...v2.7.0](https://github.com/context-dot-dev/context-ruby-sdk/compare/v2.6.0...v2.7.0)

data/README.md

@@ -26,7 +26,7 @@ To use this gem, install via Bundler by adding the following to your application
 <!-- x-release-please-start-version -->
 
 ```ruby
-gem "context.dev", "~> 2.7.0"
+gem "context.dev", "~> 2.8.0"
 ```
 
 <!-- x-release-please-end -->

data/lib/context_dev/models/brand_search_params.rb

@@ -0,0 +1,36 @@
+# frozen_string_literal: true
+
+module ContextDev
+  module Models
+    # @see ContextDev::Resources::Brand#search
+    class BrandSearchParams < ContextDev::Internal::Type::BaseModel
+      extend ContextDev::Internal::Type::RequestParameters::Converter
+      include ContextDev::Internal::Type::RequestParameters
+
+      # @!attribute query
+      #   Search term, matched against brand names and domains by prefix (e.g. 'nike',
+      #   'nike.com', 'nik').
+      #
+      #   @return [String]
+      required :query, String
+
+      # @!attribute tags
+      #   Optional comma-separated caller-defined tags for tracking this request. Tags are
+      #   recorded on the request's usage log and can be used to filter usage on the
+      #   dashboard usage page. Up to 20 tags, each 1-50 characters.
+      #
+      #   @return [Array<String>, nil]
+      optional :tags, ContextDev::Internal::Type::ArrayOf[String]
+
+      # @!method initialize(query:, tags: nil, request_options: {})
+      #   Some parameter documentations has been truncated, see
+      #   {ContextDev::Models::BrandSearchParams} for more details.
+      #
+      #   @param query [String] Search term, matched against brand names and domains by prefix (e.g. 'nike', 'ni
+      #
+      #   @param tags [Array<String>] Optional comma-separated caller-defined tags for tracking this request. Tags are
+      #
+      #   @param request_options [ContextDev::RequestOptions, Hash{Symbol=>Object}]
+    end
+  end
+end

data/lib/context_dev/models/brand_search_response.rb

@@ -0,0 +1,84 @@
+# frozen_string_literal: true
+
+module ContextDev
+  module Models
+    # @see ContextDev::Resources::Brand#search
+    class BrandSearchResponse < ContextDev::Internal::Type::BaseModel
+      # @!attribute results
+      #   Up to 10 matching brands, most popular first. Empty when nothing matches.
+      #
+      #   @return [Array<ContextDev::Models::BrandSearchResponse::Result>]
+      required :results,
+               -> { ContextDev::Internal::Type::ArrayOf[ContextDev::Models::BrandSearchResponse::Result] }
+
+      # @!attribute key_metadata
+      #   Metadata about the API key used for the request. Included in every response
+      #   whenever a valid API key is provided, even when the response status is not 200.
+      #
+      #   @return [ContextDev::Models::BrandSearchResponse::KeyMetadata, nil]
+      optional :key_metadata, -> { ContextDev::Models::BrandSearchResponse::KeyMetadata }
+
+      # @!method initialize(results:, key_metadata: nil)
+      #   Some parameter documentations has been truncated, see
+      #   {ContextDev::Models::BrandSearchResponse} for more details.
+      #
+      #   @param results [Array<ContextDev::Models::BrandSearchResponse::Result>] Up to 10 matching brands, most popular first. Empty when nothing matches.
+      #
+      #   @param key_metadata [ContextDev::Models::BrandSearchResponse::KeyMetadata] Metadata about the API key used for the request. Included in every response when
+
+      class Result < ContextDev::Internal::Type::BaseModel
+        # @!attribute domain
+        #   The brand's domain.
+        #
+        #   @return [String]
+        required :domain, String
+
+        # @!attribute logo
+        #   Logo link URL that serves the brand's logo, generated per request for the
+        #   calling organization.
+        #
+        #   @return [String]
+        required :logo, String
+
+        # @!attribute name
+        #   The brand's name. Empty string when unknown.
+        #
+        #   @return [String]
+        required :name, String
+
+        # @!method initialize(domain:, logo:, name:)
+        #   Some parameter documentations has been truncated, see
+        #   {ContextDev::Models::BrandSearchResponse::Result} for more details.
+        #
+        #   @param domain [String] The brand's domain.
+        #
+        #   @param logo [String] Logo link URL that serves the brand's logo, generated per request for the callin
+        #
+        #   @param name [String] The brand's name. Empty string when unknown.
+      end
+
+      # @see ContextDev::Models::BrandSearchResponse#key_metadata
+      class KeyMetadata < ContextDev::Internal::Type::BaseModel
+        # @!attribute credits_consumed
+        #   The number of credits consumed by this request.
+        #
+        #   @return [Integer]
+        required :credits_consumed, Integer
+
+        # @!attribute credits_remaining
+        #   The number of credits remaining for your organization after this request.
+        #
+        #   @return [Integer]
+        required :credits_remaining, Integer
+
+        # @!method initialize(credits_consumed:, credits_remaining:)
+        #   Metadata about the API key used for the request. Included in every response
+        #   whenever a valid API key is provided, even when the response status is not 200.
+        #
+        #   @param credits_consumed [Integer] The number of credits consumed by this request.
+        #
+        #   @param credits_remaining [Integer] The number of credits remaining for your organization after this request.
+      end
+    end
+  end
+end

data/lib/context_dev/models.rb

@@ -57,6 +57,8 @@ module ContextDev
 
   BrandRetrieveSimplifiedParams = ContextDev::Models::BrandRetrieveSimplifiedParams
 
+  BrandSearchParams = ContextDev::Models::BrandSearchParams
+
   CrawlControls = ContextDev::Models::CrawlControls
 
   Failure = ContextDev::Models::Failure

data/lib/context_dev/resources/brand.rb

@@ -65,6 +65,40 @@ module ContextDev
         )
       end
 
+      # Some parameter documentations has been truncated, see
+      # {ContextDev::Models::BrandSearchParams} for more details.
+      #
+      # Search brands by name or domain and get back up to 10 lightweight matches
+      # (domain, name, logo), most popular first: by Tranco rank, then market cap for
+      # brands outside the Tranco list, with text relevance breaking ties. Matching is
+      # prefix-based with no typo tolerance, so it is suited to autocomplete. Only
+      # brands already in the Context.dev index are returned — use /brand/retrieve to
+      # fetch (and index) a specific domain. Free on Pro and Scale plans; costs 1 credit
+      # per request on the Free and Starter plans.
+      #
+      # @overload search(query:, tags: nil, request_options: {})
+      #
+      # @param query [String] Search term, matched against brand names and domains by prefix (e.g. 'nike', 'ni
+      #
+      # @param tags [Array<String>] Optional comma-separated caller-defined tags for tracking this request. Tags are
+      #
+      # @param request_options [ContextDev::RequestOptions, Hash{Symbol=>Object}, nil]
+      #
+      # @return [ContextDev::Models::BrandSearchResponse]
+      #
+      # @see ContextDev::Models::BrandSearchParams
+      def search(params)
+        parsed, options = ContextDev::BrandSearchParams.dump_request(params)
+        query = ContextDev::Internal::Util.encode_query_params(parsed)
+        @client.request(
+          method: :get,
+          path: "brand/search",
+          query: query,
+          model: ContextDev::Models::BrandSearchResponse,
+          options: options
+        )
+      end
+
       # @api private
       #
       # @param client [ContextDev::Client]

data/lib/context_dev/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module ContextDev
-  VERSION = "2.7.0"
+  VERSION = "2.8.0"
 end

data/lib/context_dev.rb

@@ -70,6 +70,8 @@ require_relative "context_dev/models/brand_retrieve_params"
 require_relative "context_dev/models/brand_retrieve_response"
 require_relative "context_dev/models/brand_retrieve_simplified_params"
 require_relative "context_dev/models/brand_retrieve_simplified_response"
+require_relative "context_dev/models/brand_search_params"
+require_relative "context_dev/models/brand_search_response"
 require_relative "context_dev/models/crawl_controls"
 require_relative "context_dev/models/failure"
 require_relative "context_dev/models/industry_retrieve_naics_params"

data/rbi/context_dev/models/brand_search_params.rbi

@@ -0,0 +1,60 @@
+# typed: strong
+
+module ContextDev
+  module Models
+    class BrandSearchParams < ContextDev::Internal::Type::BaseModel
+      extend ContextDev::Internal::Type::RequestParameters::Converter
+      include ContextDev::Internal::Type::RequestParameters
+
+      OrHash =
+        T.type_alias do
+          T.any(ContextDev::BrandSearchParams, ContextDev::Internal::AnyHash)
+        end
+
+      # Search term, matched against brand names and domains by prefix (e.g. 'nike',
+      # 'nike.com', 'nik').
+      sig { returns(String) }
+      attr_accessor :query
+
+      # Optional comma-separated caller-defined tags for tracking this request. Tags are
+      # recorded on the request's usage log and can be used to filter usage on the
+      # dashboard usage page. Up to 20 tags, each 1-50 characters.
+      sig { returns(T.nilable(T::Array[String])) }
+      attr_reader :tags
+
+      sig { params(tags: T::Array[String]).void }
+      attr_writer :tags
+
+      sig do
+        params(
+          query: String,
+          tags: T::Array[String],
+          request_options: ContextDev::RequestOptions::OrHash
+        ).returns(T.attached_class)
+      end
+      def self.new(
+        # Search term, matched against brand names and domains by prefix (e.g. 'nike',
+        # 'nike.com', 'nik').
+        query:,
+        # Optional comma-separated caller-defined tags for tracking this request. Tags are
+        # recorded on the request's usage log and can be used to filter usage on the
+        # dashboard usage page. Up to 20 tags, each 1-50 characters.
+        tags: nil,
+        request_options: {}
+      )
+      end
+
+      sig do
+        override.returns(
+          {
+            query: String,
+            tags: T::Array[String],
+            request_options: ContextDev::RequestOptions
+          }
+        )
+      end
+      def to_hash
+      end
+    end
+  end
+end

data/rbi/context_dev/models/brand_search_response.rbi

@@ -0,0 +1,146 @@
+# typed: strong
+
+module ContextDev
+  module Models
+    class BrandSearchResponse < ContextDev::Internal::Type::BaseModel
+      OrHash =
+        T.type_alias do
+          T.any(
+            ContextDev::Models::BrandSearchResponse,
+            ContextDev::Internal::AnyHash
+          )
+        end
+
+      # Up to 10 matching brands, most popular first. Empty when nothing matches.
+      sig { returns(T::Array[ContextDev::Models::BrandSearchResponse::Result]) }
+      attr_accessor :results
+
+      # Metadata about the API key used for the request. Included in every response
+      # whenever a valid API key is provided, even when the response status is not 200.
+      sig do
+        returns(T.nilable(ContextDev::Models::BrandSearchResponse::KeyMetadata))
+      end
+      attr_reader :key_metadata
+
+      sig do
+        params(
+          key_metadata:
+            ContextDev::Models::BrandSearchResponse::KeyMetadata::OrHash
+        ).void
+      end
+      attr_writer :key_metadata
+
+      sig do
+        params(
+          results:
+            T::Array[ContextDev::Models::BrandSearchResponse::Result::OrHash],
+          key_metadata:
+            ContextDev::Models::BrandSearchResponse::KeyMetadata::OrHash
+        ).returns(T.attached_class)
+      end
+      def self.new(
+        # Up to 10 matching brands, most popular first. Empty when nothing matches.
+        results:,
+        # Metadata about the API key used for the request. Included in every response
+        # whenever a valid API key is provided, even when the response status is not 200.
+        key_metadata: nil
+      )
+      end
+
+      sig do
+        override.returns(
+          {
+            results: T::Array[ContextDev::Models::BrandSearchResponse::Result],
+            key_metadata: ContextDev::Models::BrandSearchResponse::KeyMetadata
+          }
+        )
+      end
+      def to_hash
+      end
+
+      class Result < ContextDev::Internal::Type::BaseModel
+        OrHash =
+          T.type_alias do
+            T.any(
+              ContextDev::Models::BrandSearchResponse::Result,
+              ContextDev::Internal::AnyHash
+            )
+          end
+
+        # The brand's domain.
+        sig { returns(String) }
+        attr_accessor :domain
+
+        # Logo link URL that serves the brand's logo, generated per request for the
+        # calling organization.
+        sig { returns(String) }
+        attr_accessor :logo
+
+        # The brand's name. Empty string when unknown.
+        sig { returns(String) }
+        attr_accessor :name
+
+        sig do
+          params(domain: String, logo: String, name: String).returns(
+            T.attached_class
+          )
+        end
+        def self.new(
+          # The brand's domain.
+          domain:,
+          # Logo link URL that serves the brand's logo, generated per request for the
+          # calling organization.
+          logo:,
+          # The brand's name. Empty string when unknown.
+          name:
+        )
+        end
+
+        sig { override.returns({ domain: String, logo: String, name: String }) }
+        def to_hash
+        end
+      end
+
+      class KeyMetadata < ContextDev::Internal::Type::BaseModel
+        OrHash =
+          T.type_alias do
+            T.any(
+              ContextDev::Models::BrandSearchResponse::KeyMetadata,
+              ContextDev::Internal::AnyHash
+            )
+          end
+
+        # The number of credits consumed by this request.
+        sig { returns(Integer) }
+        attr_accessor :credits_consumed
+
+        # The number of credits remaining for your organization after this request.
+        sig { returns(Integer) }
+        attr_accessor :credits_remaining
+
+        # Metadata about the API key used for the request. Included in every response
+        # whenever a valid API key is provided, even when the response status is not 200.
+        sig do
+          params(credits_consumed: Integer, credits_remaining: Integer).returns(
+            T.attached_class
+          )
+        end
+        def self.new(
+          # The number of credits consumed by this request.
+          credits_consumed:,
+          # The number of credits remaining for your organization after this request.
+          credits_remaining:
+        )
+        end
+
+        sig do
+          override.returns(
+            { credits_consumed: Integer, credits_remaining: Integer }
+          )
+        end
+        def to_hash
+        end
+      end
+    end
+  end
+end

data/rbi/context_dev/models.rbi

@@ -20,6 +20,8 @@ module ContextDev
   BrandRetrieveSimplifiedParams =
     ContextDev::Models::BrandRetrieveSimplifiedParams
 
+  BrandSearchParams = ContextDev::Models::BrandSearchParams
+
   CrawlControls = ContextDev::Models::CrawlControls
 
   Failure = ContextDev::Models::Failure

data/rbi/context_dev/resources/brand.rbi

@@ -64,6 +64,32 @@ module ContextDev
       )
       end
 
+      # Search brands by name or domain and get back up to 10 lightweight matches
+      # (domain, name, logo), most popular first: by Tranco rank, then market cap for
+      # brands outside the Tranco list, with text relevance breaking ties. Matching is
+      # prefix-based with no typo tolerance, so it is suited to autocomplete. Only
+      # brands already in the Context.dev index are returned — use /brand/retrieve to
+      # fetch (and index) a specific domain. Free on Pro and Scale plans; costs 1 credit
+      # per request on the Free and Starter plans.
+      sig do
+        params(
+          query: String,
+          tags: T::Array[String],
+          request_options: ContextDev::RequestOptions::OrHash
+        ).returns(ContextDev::Models::BrandSearchResponse)
+      end
+      def search(
+        # Search term, matched against brand names and domains by prefix (e.g. 'nike',
+        # 'nike.com', 'nik').
+        query:,
+        # Optional comma-separated caller-defined tags for tracking this request. Tags are
+        # recorded on the request's usage log and can be used to filter usage on the
+        # dashboard usage page. Up to 20 tags, each 1-50 characters.
+        tags: nil,
+        request_options: {}
+      )
+      end
+
       # @api private
       sig { params(client: ContextDev::Client).returns(T.attached_class) }
       def self.new(client:)

data/sig/context_dev/models/brand_search_params.rbs

@@ -0,0 +1,30 @@
+module ContextDev
+  module Models
+    type brand_search_params =
+      { query: String, tags: ::Array[String] }
+      & ContextDev::Internal::Type::request_parameters
+
+    class BrandSearchParams < ContextDev::Internal::Type::BaseModel
+      extend ContextDev::Internal::Type::RequestParameters::Converter
+      include ContextDev::Internal::Type::RequestParameters
+
+      attr_accessor query: String
+
+      attr_reader tags: ::Array[String]?
+
+      def tags=: (::Array[String]) -> ::Array[String]
+
+      def initialize: (
+        query: String,
+        ?tags: ::Array[String],
+        ?request_options: ContextDev::request_opts
+      ) -> void
+
+      def to_hash: -> {
+        query: String,
+        tags: ::Array[String],
+        request_options: ContextDev::RequestOptions
+      }
+    end
+  end
+end

data/sig/context_dev/models/brand_search_response.rbs

@@ -0,0 +1,62 @@
+module ContextDev
+  module Models
+    type brand_search_response =
+      {
+        results: ::Array[ContextDev::Models::BrandSearchResponse::Result],
+        key_metadata: ContextDev::Models::BrandSearchResponse::KeyMetadata
+      }
+
+    class BrandSearchResponse < ContextDev::Internal::Type::BaseModel
+      attr_accessor results: ::Array[ContextDev::Models::BrandSearchResponse::Result]
+
+      attr_reader key_metadata: ContextDev::Models::BrandSearchResponse::KeyMetadata?
+
+      def key_metadata=: (
+        ContextDev::Models::BrandSearchResponse::KeyMetadata
+      ) -> ContextDev::Models::BrandSearchResponse::KeyMetadata
+
+      def initialize: (
+        results: ::Array[ContextDev::Models::BrandSearchResponse::Result],
+        ?key_metadata: ContextDev::Models::BrandSearchResponse::KeyMetadata
+      ) -> void
+
+      def to_hash: -> {
+        results: ::Array[ContextDev::Models::BrandSearchResponse::Result],
+        key_metadata: ContextDev::Models::BrandSearchResponse::KeyMetadata
+      }
+
+      type result = { domain: String, logo: String, name: String }
+
+      class Result < ContextDev::Internal::Type::BaseModel
+        attr_accessor domain: String
+
+        attr_accessor logo: String
+
+        attr_accessor name: String
+
+        def initialize: (domain: String, logo: String, name: String) -> void
+
+        def to_hash: -> { domain: String, logo: String, name: String }
+      end
+
+      type key_metadata =
+        { credits_consumed: Integer, credits_remaining: Integer }
+
+      class KeyMetadata < ContextDev::Internal::Type::BaseModel
+        attr_accessor credits_consumed: Integer
+
+        attr_accessor credits_remaining: Integer
+
+        def initialize: (
+          credits_consumed: Integer,
+          credits_remaining: Integer
+        ) -> void
+
+        def to_hash: -> {
+          credits_consumed: Integer,
+          credits_remaining: Integer
+        }
+      end
+    end
+  end
+end

data/sig/context_dev/models.rbs

@@ -17,6 +17,8 @@ module ContextDev
 
   class BrandRetrieveSimplifiedParams = ContextDev::Models::BrandRetrieveSimplifiedParams
 
+  class BrandSearchParams = ContextDev::Models::BrandSearchParams
+
   class CrawlControls = ContextDev::Models::CrawlControls
 
   class Failure = ContextDev::Models::Failure

data/sig/context_dev/resources/brand.rbs

@@ -15,6 +15,12 @@ module ContextDev
         ?request_options: ContextDev::request_opts
       ) -> ContextDev::Models::BrandRetrieveSimplifiedResponse
 
+      def search: (
+        query: String,
+        ?tags: ::Array[String],
+        ?request_options: ContextDev::request_opts
+      ) -> ContextDev::Models::BrandSearchResponse
+
       def initialize: (client: ContextDev::Client) -> void
     end
   end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: context.dev
 version: !ruby/object:Gem::Version
-  version: 2.7.0
+  version: 2.8.0
 platform: ruby
 authors:
 - Context Dev
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-08-01 00:00:00.000000000 Z
+date: 2026-08-05 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: cgi
@@ -87,6 +87,8 @@ files:
 - lib/context_dev/models/brand_retrieve_response.rb
 - lib/context_dev/models/brand_retrieve_simplified_params.rb
 - lib/context_dev/models/brand_retrieve_simplified_response.rb
+- lib/context_dev/models/brand_search_params.rb
+- lib/context_dev/models/brand_search_response.rb
 - lib/context_dev/models/crawl_controls.rb
 - lib/context_dev/models/failure.rb
 - lib/context_dev/models/industry_retrieve_naics_params.rb
@@ -196,6 +198,8 @@ files:
 - rbi/context_dev/models/brand_retrieve_response.rbi
 - rbi/context_dev/models/brand_retrieve_simplified_params.rbi
 - rbi/context_dev/models/brand_retrieve_simplified_response.rbi
+- rbi/context_dev/models/brand_search_params.rbi
+- rbi/context_dev/models/brand_search_response.rbi
 - rbi/context_dev/models/crawl_controls.rbi
 - rbi/context_dev/models/failure.rbi
 - rbi/context_dev/models/industry_retrieve_naics_params.rbi
@@ -304,6 +308,8 @@ files:
 - sig/context_dev/models/brand_retrieve_response.rbs
 - sig/context_dev/models/brand_retrieve_simplified_params.rbs
 - sig/context_dev/models/brand_retrieve_simplified_response.rbs
+- sig/context_dev/models/brand_search_params.rbs
+- sig/context_dev/models/brand_search_response.rbs
 - sig/context_dev/models/crawl_controls.rbs
 - sig/context_dev/models/failure.rbs
 - sig/context_dev/models/industry_retrieve_naics_params.rbs