context.dev 2.10.0 → 2.12.0

data/rbi/context_dev/models/ai_extract_products_response.rbi

@@ -158,6 +158,16 @@ module ContextDev
         sig { returns(T::Array[String]) }
         attr_accessor :target_audience
 
+        # Normalized stock or ordering availability
+        sig do
+          returns(
+            T.nilable(
+              ContextDev::Models::AIExtractProductsResponse::Product::Availability::TaggedSymbol
+            )
+          )
+        end
+        attr_accessor :availability
+
         # Billing frequency for the product
         sig do
           returns(
@@ -176,6 +186,13 @@ module ContextDev
         sig { returns(T.nilable(String)) }
         attr_accessor :currency
 
+        # Dimension statements shown for the product, preserving labels, values, and units
+        sig { returns(T.nilable(T::Array[String])) }
+        attr_reader :dimensions
+
+        sig { params(dimensions: T::Array[String]).void }
+        attr_writer :dimensions
+
         # URL to the product image
         sig { returns(T.nilable(String)) }
         attr_accessor :image_url
@@ -194,6 +211,10 @@ module ContextDev
         end
         attr_accessor :pricing_model
 
+        # Original or regular price before a displayed discount
+        sig { returns(T.nilable(Float)) }
+        attr_accessor :regular_price
+
         # URL to the product page
         sig { returns(T.nilable(String)) }
         attr_accessor :url
@@ -207,18 +228,24 @@ module ContextDev
             sku: T.nilable(String),
             tags: T::Array[String],
             target_audience: T::Array[String],
+            availability:
+              T.nilable(
+                ContextDev::Models::AIExtractProductsResponse::Product::Availability::OrSymbol
+              ),
             billing_frequency:
               T.nilable(
                 ContextDev::Models::AIExtractProductsResponse::Product::BillingFrequency::OrSymbol
               ),
             category: T.nilable(String),
             currency: T.nilable(String),
+            dimensions: T::Array[String],
             image_url: T.nilable(String),
             price: T.nilable(Float),
             pricing_model:
               T.nilable(
                 ContextDev::Models::AIExtractProductsResponse::Product::PricingModel::OrSymbol
               ),
+            regular_price: T.nilable(Float),
             url: T.nilable(String)
           ).returns(T.attached_class)
         end
@@ -237,18 +264,24 @@ module ContextDev
           tags:,
           # Target audience for the product (array of strings)
           target_audience:,
+          # Normalized stock or ordering availability
+          availability: nil,
           # Billing frequency for the product
           billing_frequency: nil,
           # Category of the product
           category: nil,
           # Currency code for the price (e.g., USD, EUR)
           currency: nil,
+          # Dimension statements shown for the product, preserving labels, values, and units
+          dimensions: nil,
           # URL to the product image
           image_url: nil,
           # Price of the product
           price: nil,
           # Pricing model for the product
           pricing_model: nil,
+          # Original or regular price before a displayed discount
+          regular_price: nil,
           # URL to the product page
           url: nil
         )
@@ -264,18 +297,24 @@ module ContextDev
               sku: T.nilable(String),
               tags: T::Array[String],
               target_audience: T::Array[String],
+              availability:
+                T.nilable(
+                  ContextDev::Models::AIExtractProductsResponse::Product::Availability::TaggedSymbol
+                ),
               billing_frequency:
                 T.nilable(
                   ContextDev::Models::AIExtractProductsResponse::Product::BillingFrequency::TaggedSymbol
                 ),
               category: T.nilable(String),
               currency: T.nilable(String),
+              dimensions: T::Array[String],
               image_url: T.nilable(String),
               price: T.nilable(Float),
               pricing_model:
                 T.nilable(
                   ContextDev::Models::AIExtractProductsResponse::Product::PricingModel::TaggedSymbol
                 ),
+              regular_price: T.nilable(Float),
               url: T.nilable(String)
             }
           )
@@ -283,6 +322,66 @@ module ContextDev
         def to_hash
         end
 
+        # Normalized stock or ordering availability
+        module Availability
+          extend ContextDev::Internal::Type::Enum
+
+          TaggedSymbol =
+            T.type_alias do
+              T.all(
+                Symbol,
+                ContextDev::Models::AIExtractProductsResponse::Product::Availability
+              )
+            end
+          OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+          IN_STOCK =
+            T.let(
+              :in_stock,
+              ContextDev::Models::AIExtractProductsResponse::Product::Availability::TaggedSymbol
+            )
+          OUT_OF_STOCK =
+            T.let(
+              :out_of_stock,
+              ContextDev::Models::AIExtractProductsResponse::Product::Availability::TaggedSymbol
+            )
+          LIMITED_AVAILABILITY =
+            T.let(
+              :limited_availability,
+              ContextDev::Models::AIExtractProductsResponse::Product::Availability::TaggedSymbol
+            )
+          PREORDER =
+            T.let(
+              :preorder,
+              ContextDev::Models::AIExtractProductsResponse::Product::Availability::TaggedSymbol
+            )
+          BACKORDER =
+            T.let(
+              :backorder,
+              ContextDev::Models::AIExtractProductsResponse::Product::Availability::TaggedSymbol
+            )
+          MADE_TO_ORDER =
+            T.let(
+              :made_to_order,
+              ContextDev::Models::AIExtractProductsResponse::Product::Availability::TaggedSymbol
+            )
+          DISCONTINUED =
+            T.let(
+              :discontinued,
+              ContextDev::Models::AIExtractProductsResponse::Product::Availability::TaggedSymbol
+            )
+
+          sig do
+            override.returns(
+              T::Array[
+                ContextDev::Models::AIExtractProductsResponse::Product::Availability::TaggedSymbol
+              ]
+            )
+          end
+          def self.values
+          end
+        end
+
         # Billing frequency for the product
         module BillingFrequency
           extend ContextDev::Internal::Type::Enum

data/rbi/context_dev/models/brand_retrieve_response.rbi

@@ -767,18 +767,95 @@ module ContextDev
           sig { params(name: String).void }
           attr_writer :name
 
-          sig { params(hex: String, name: String).returns(T.attached_class) }
+          # Where the color was observed: 'site' colors come from the website's own theme
+          # signals (rendered page colors, manifest, theme-color meta), 'logo' colors from
+          # logo image pixels.
+          sig do
+            returns(
+              T.nilable(
+                ContextDev::Models::BrandRetrieveResponse::Brand::Color::Source::TaggedSymbol
+              )
+            )
+          end
+          attr_reader :source
+
+          sig do
+            params(
+              source:
+                ContextDev::Models::BrandRetrieveResponse::Brand::Color::Source::OrSymbol
+            ).void
+          end
+          attr_writer :source
+
+          sig do
+            params(
+              hex: String,
+              name: String,
+              source:
+                ContextDev::Models::BrandRetrieveResponse::Brand::Color::Source::OrSymbol
+            ).returns(T.attached_class)
+          end
           def self.new(
             # Color in hexadecimal format
             hex: nil,
             # Name of the color
-            name: nil
+            name: nil,
+            # Where the color was observed: 'site' colors come from the website's own theme
+            # signals (rendered page colors, manifest, theme-color meta), 'logo' colors from
+            # logo image pixels.
+            source: nil
           )
           end
 
-          sig { override.returns({ hex: String, name: String }) }
+          sig do
+            override.returns(
+              {
+                hex: String,
+                name: String,
+                source:
+                  ContextDev::Models::BrandRetrieveResponse::Brand::Color::Source::TaggedSymbol
+              }
+            )
+          end
           def to_hash
           end
+
+          # Where the color was observed: 'site' colors come from the website's own theme
+          # signals (rendered page colors, manifest, theme-color meta), 'logo' colors from
+          # logo image pixels.
+          module Source
+            extend ContextDev::Internal::Type::Enum
+
+            TaggedSymbol =
+              T.type_alias do
+                T.all(
+                  Symbol,
+                  ContextDev::Models::BrandRetrieveResponse::Brand::Color::Source
+                )
+              end
+            OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+            SITE =
+              T.let(
+                :site,
+                ContextDev::Models::BrandRetrieveResponse::Brand::Color::Source::TaggedSymbol
+              )
+            LOGO =
+              T.let(
+                :logo,
+                ContextDev::Models::BrandRetrieveResponse::Brand::Color::Source::TaggedSymbol
+              )
+
+            sig do
+              override.returns(
+                T::Array[
+                  ContextDev::Models::BrandRetrieveResponse::Brand::Color::Source::TaggedSymbol
+                ]
+              )
+            end
+            def self.values
+            end
+          end
         end
 
         class Employees < ContextDev::Internal::Type::BaseModel

data/rbi/context_dev/models/brand_retrieve_simplified_response.rbi

@@ -453,18 +453,95 @@ module ContextDev
           sig { params(name: String).void }
           attr_writer :name
 
-          sig { params(hex: String, name: String).returns(T.attached_class) }
+          # Where the color was observed: 'site' colors come from the website's own theme
+          # signals (rendered page colors, manifest, theme-color meta), 'logo' colors from
+          # logo image pixels.
+          sig do
+            returns(
+              T.nilable(
+                ContextDev::Models::BrandRetrieveSimplifiedResponse::Brand::Color::Source::TaggedSymbol
+              )
+            )
+          end
+          attr_reader :source
+
+          sig do
+            params(
+              source:
+                ContextDev::Models::BrandRetrieveSimplifiedResponse::Brand::Color::Source::OrSymbol
+            ).void
+          end
+          attr_writer :source
+
+          sig do
+            params(
+              hex: String,
+              name: String,
+              source:
+                ContextDev::Models::BrandRetrieveSimplifiedResponse::Brand::Color::Source::OrSymbol
+            ).returns(T.attached_class)
+          end
           def self.new(
             # Color in hexadecimal format
             hex: nil,
             # Name of the color
-            name: nil
+            name: nil,
+            # Where the color was observed: 'site' colors come from the website's own theme
+            # signals (rendered page colors, manifest, theme-color meta), 'logo' colors from
+            # logo image pixels.
+            source: nil
           )
           end
 
-          sig { override.returns({ hex: String, name: String }) }
+          sig do
+            override.returns(
+              {
+                hex: String,
+                name: String,
+                source:
+                  ContextDev::Models::BrandRetrieveSimplifiedResponse::Brand::Color::Source::TaggedSymbol
+              }
+            )
+          end
           def to_hash
           end
+
+          # Where the color was observed: 'site' colors come from the website's own theme
+          # signals (rendered page colors, manifest, theme-color meta), 'logo' colors from
+          # logo image pixels.
+          module Source
+            extend ContextDev::Internal::Type::Enum
+
+            TaggedSymbol =
+              T.type_alias do
+                T.all(
+                  Symbol,
+                  ContextDev::Models::BrandRetrieveSimplifiedResponse::Brand::Color::Source
+                )
+              end
+            OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+            SITE =
+              T.let(
+                :site,
+                ContextDev::Models::BrandRetrieveSimplifiedResponse::Brand::Color::Source::TaggedSymbol
+              )
+            LOGO =
+              T.let(
+                :logo,
+                ContextDev::Models::BrandRetrieveSimplifiedResponse::Brand::Color::Source::TaggedSymbol
+              )
+
+            sig do
+              override.returns(
+                T::Array[
+                  ContextDev::Models::BrandRetrieveSimplifiedResponse::Brand::Color::Source::TaggedSymbol
+                ]
+              )
+            end
+            def self.values
+            end
+          end
         end
 
         class Logo < ContextDev::Internal::Type::BaseModel

data/rbi/context_dev/models/news_search_params.rbi

@@ -1123,6 +1123,11 @@ module ContextDev
               :cl,
               ContextDev::NewsSearchParams::FilterBy::SourceCountry::TaggedSymbol
             )
+          CZ =
+            T.let(
+              :cz,
+              ContextDev::NewsSearchParams::FilterBy::SourceCountry::TaggedSymbol
+            )
           DE =
             T.let(
               :de,

data/rbi/context_dev/models/news_search_response.rbi

@@ -11,12 +11,15 @@ module ContextDev
           )
         end
 
+      # Articles matching the search, in the requested order.
       sig { returns(T::Array[ContextDev::Models::NewsSearchResponse::Data]) }
       attr_accessor :data
 
+      # True when more results are available beyond this page.
       sig { returns(T::Boolean) }
       attr_accessor :has_more
 
+      # Summary information about this response.
       sig { returns(ContextDev::Models::NewsSearchResponse::Meta) }
       attr_reader :meta
 
@@ -25,6 +28,8 @@ module ContextDev
       end
       attr_writer :meta
 
+      # Pass as cursor in the next request to fetch the following page. Null when there
+      # are no more results.
       sig { returns(T.nilable(String)) }
       attr_accessor :next_cursor
 
@@ -54,9 +59,14 @@ module ContextDev
         ).returns(T.attached_class)
       end
       def self.new(
+        # Articles matching the search, in the requested order.
         data:,
+        # True when more results are available beyond this page.
         has_more:,
+        # Summary information about this response.
         meta:,
+        # Pass as cursor in the next request to fetch the following page. Null when there
+        # are no more results.
         next_cursor:,
         # 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.
@@ -87,21 +97,29 @@ module ContextDev
             )
           end
 
+        # Stable unique identifier for this article. Use it to deduplicate or reference an
+        # article across requests.
         sig { returns(String) }
         attr_accessor :id
 
+        # Bylined authors. Empty when no byline is available.
         sig { returns(T::Array[String]) }
         attr_accessor :authors
 
+        # Short summary or excerpt of the article, when the publisher provides one.
         sig { returns(T.nilable(String)) }
         attr_accessor :description
 
+        # Lead image for the article, when one is available.
         sig { returns(T.nilable(String)) }
         attr_accessor :image_url
 
+        # Language the article is written in, as a lowercase ISO 639-1 code such as en.
+        # Null when unknown.
         sig { returns(T.nilable(String)) }
         attr_accessor :language
 
+        # How the article relates to the company you searched for.
         sig { returns(ContextDev::Models::NewsSearchResponse::Data::Match) }
         attr_reader :match
 
@@ -112,9 +130,12 @@ module ContextDev
         end
         attr_writer :match
 
+        # When the article was published, as an ISO 8601 timestamp. Null when the
+        # publisher does not state a reliable date.
         sig { returns(T.nilable(Time)) }
         attr_accessor :published_at
 
+        # The publication that published the article.
         sig { returns(ContextDev::Models::NewsSearchResponse::Data::Source) }
         attr_reader :source
 
@@ -125,13 +146,17 @@ module ContextDev
         end
         attr_writer :source
 
-        # Groups matching normalized headlines published on the same UTC day.
+        # Shared by articles covering the same story on the same day. Use it to group or
+        # collapse syndicated copies of one announcement across outlets.
         sig { returns(String) }
         attr_accessor :story_id
 
+        # Article headline.
         sig { returns(String) }
         attr_accessor :title
 
+        # Kind of coverage. Use it to separate independent reporting (editorial) from
+        # company-issued content (press_release, regulatory_filing, advisory).
         sig do
           returns(
             ContextDev::Models::NewsSearchResponse::Data::Type::TaggedSymbol
@@ -139,6 +164,7 @@ module ContextDev
         end
         attr_accessor :type
 
+        # Link to the article on the publisher site.
         sig { returns(String) }
         attr_accessor :url
 
@@ -160,18 +186,34 @@ module ContextDev
           ).returns(T.attached_class)
         end
         def self.new(
+          # Stable unique identifier for this article. Use it to deduplicate or reference an
+          # article across requests.
           id:,
+          # Bylined authors. Empty when no byline is available.
           authors:,
+          # Short summary or excerpt of the article, when the publisher provides one.
           description:,
+          # Lead image for the article, when one is available.
           image_url:,
+          # Language the article is written in, as a lowercase ISO 639-1 code such as en.
+          # Null when unknown.
           language:,
+          # How the article relates to the company you searched for.
           match:,
+          # When the article was published, as an ISO 8601 timestamp. Null when the
+          # publisher does not state a reliable date.
           published_at:,
+          # The publication that published the article.
           source:,
-          # Groups matching normalized headlines published on the same UTC day.
+          # Shared by articles covering the same story on the same day. Use it to group or
+          # collapse syndicated copies of one announcement across outlets.
           story_id:,
+          # Article headline.
           title:,
+          # Kind of coverage. Use it to separate independent reporting (editorial) from
+          # company-issued content (press_release, regulatory_filing, advisory).
           type:,
+          # Link to the article on the publisher site.
           url:
         )
         end
@@ -207,9 +249,12 @@ module ContextDev
               )
             end
 
+          # How confident the match is, from 0 to 1. Null when a score is unavailable.
           sig { returns(T.nilable(Float)) }
           attr_accessor :confidence
 
+          # primary when the article is mainly about the company, secondary when the company
+          # is mentioned but is not the main subject.
           sig do
             returns(
               ContextDev::Models::NewsSearchResponse::Data::Match::Level::TaggedSymbol
@@ -217,6 +262,7 @@ module ContextDev
           end
           attr_accessor :level
 
+          # How the article relates to the company you searched for.
           sig do
             params(
               confidence: T.nilable(Float),
@@ -224,7 +270,13 @@ module ContextDev
                 ContextDev::Models::NewsSearchResponse::Data::Match::Level::OrSymbol
             ).returns(T.attached_class)
           end
-          def self.new(confidence:, level:)
+          def self.new(
+            # How confident the match is, from 0 to 1. Null when a score is unavailable.
+            confidence:,
+            # primary when the article is mainly about the company, secondary when the company
+            # is mentioned but is not the main subject.
+            level:
+          )
           end
 
           sig do
@@ -239,6 +291,8 @@ module ContextDev
           def to_hash
           end
 
+          # primary when the article is mainly about the company, secondary when the company
+          # is mentioned but is not the main subject.
           module Level
             extend ContextDev::Internal::Type::Enum
 
@@ -287,12 +341,15 @@ module ContextDev
           sig { returns(T::Boolean) }
           attr_accessor :direct
 
+          # Website domain of the publication.
           sig { returns(String) }
           attr_accessor :domain
 
+          # Name of the publication, such as Reuters.
           sig { returns(String) }
           attr_accessor :name
 
+          # The publication that published the article.
           sig do
             params(direct: T::Boolean, domain: String, name: String).returns(
               T.attached_class
@@ -301,7 +358,9 @@ module ContextDev
           def self.new(
             # True when Context observed this article in the publisher-owned feed.
             direct:,
+            # Website domain of the publication.
             domain:,
+            # Name of the publication, such as Reuters.
             name:
           )
           end
@@ -315,6 +374,8 @@ module ContextDev
           end
         end
 
+        # Kind of coverage. Use it to separate independent reporting (editorial) from
+        # company-issued content (press_release, regulatory_filing, advisory).
         module Type
           extend ContextDev::Internal::Type::Enum
 
@@ -366,11 +427,16 @@ module ContextDev
             )
           end
 
+        # Number of articles in this page.
         sig { returns(Integer) }
         attr_accessor :count
 
+        # Summary information about this response.
         sig { params(count: Integer).returns(T.attached_class) }
-        def self.new(count:)
+        def self.new(
+          # Number of articles in this page.
+          count:
+        )
         end
 
         sig { override.returns({ count: Integer }) }