context.dev 1.9.0 → 1.10.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: bc275c1c011dbedbe3bbdb3496fabd7cfe52ace449f9e8a1d5966b04944cfe93
-  data.tar.gz: 4277b8a2e2e1ce2f1f36e77cd3d34ab5e00decf16e8c4dab011036cc34b7cac5
+  metadata.gz: dd5277f504c21625472d556d7a4151a793e14e4721d603c2304b93fad9668631
+  data.tar.gz: 0c4141a438cd3acee423b2edf10563e58f95bf48ed107c0d4db14871e6f1dd52
 SHA512:
-  metadata.gz: cdb083597dc16824f95e3ea5a27e72c478c31ef89664e73928ead17f2db98b6d77db929ac6fcabac2922316ae4d2e32c76757ab538ef041f4e79061238ec3c9a
-  data.tar.gz: 810d3685eb4bc4a3cb112beadc9f0564ddcec92a39c507bd6104f98d9ddee3fab363d7081d999e0a9c830289a33e2ef15b3797e27afab3e7169772accf4dd5f5
+  metadata.gz: 17e11b02edc7b645b530ac42a76635525745050130a62b8cce21e07b11b583638df5063e242f14fd89467b198a79c0df344a3667eecedcaa5cce185cd5d9a28a
+  data.tar.gz: 6839a627ea33e8e1d2f95c260167ed208f327d90d362f771ed609d3986434b3d89b8ddf30d05a5f90b7b6e7fbecff282ba1a0d550dd9ad5bfa8738f7e86383ae

data/CHANGELOG.md

@@ -1,5 +1,15 @@
 # Changelog
 
+## 1.10.0 (2026-05-01)
+
+Full Changelog: [v1.9.0...v1.10.0](https://github.com/context-dot-dev/context-ruby-sdk/compare/v1.9.0...v1.10.0)
+
+### Features
+
+* **api:** api update ([c74cbf3](https://github.com/context-dot-dev/context-ruby-sdk/commit/c74cbf354e15c2b56680b4248ed69462a1a84d23))
+* **api:** api update ([cc57672](https://github.com/context-dot-dev/context-ruby-sdk/commit/cc576729ce6c522ee578e7dc5f99122463014515))
+* support setting headers via env ([e625fee](https://github.com/context-dot-dev/context-ruby-sdk/commit/e625fee97a6d4f6ab25f69447b33521cac6a896c))
+
 ## 1.9.0 (2026-04-25)
 
 Full Changelog: [v1.8.0...v1.9.0](https://github.com/context-dot-dev/context-ruby-sdk/compare/v1.8.0...v1.9.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", "~> 1.9.0"
+gem "context.dev", "~> 1.10.0"
 ```
 
 <!-- x-release-please-end -->

data/lib/context_dev/client.rb

@@ -70,6 +70,19 @@ module ContextDev
         raise ArgumentError.new("api_key is required, and can be set via environ: \"CONTEXT_DEV_API_KEY\"")
       end
 
+      headers = {}
+      custom_headers_env = ENV["CONTEXT_DEV_CUSTOM_HEADERS"]
+      unless custom_headers_env.nil?
+        parsed = {}
+        custom_headers_env.split("\n").each do |line|
+          colon = line.index(":")
+          unless colon.nil?
+            parsed[line[0...colon].strip] = line[(colon + 1)..].strip
+          end
+        end
+        headers = parsed.merge(headers)
+      end
+
       @api_key = api_key.to_s
 
       super(
@@ -77,7 +90,8 @@ module ContextDev
         timeout: timeout,
         max_retries: max_retries,
         initial_retry_delay: initial_retry_delay,
-        max_retry_delay: max_retry_delay
+        max_retry_delay: max_retry_delay,
+        headers: headers
       )
 
       @web = ContextDev::Resources::Web.new(client: self)

data/lib/context_dev/models/ai_extract_product_params.rb

@@ -13,6 +13,14 @@ module ContextDev
       #   @return [String]
       required :url, String
 
+      # @!attribute max_age_ms
+      #   Return a cached result if a prior scrape for the same parameters exists and is
+      #   younger than this many milliseconds. Defaults to 7 days (604800000 ms) when
+      #   omitted. Max is 30 days (2592000000 ms). Set to 0 to always scrape fresh.
+      #
+      #   @return [Integer, nil]
+      optional :max_age_ms, Integer, api_name: :maxAgeMs
+
       # @!attribute timeout_ms
       #   Optional timeout in milliseconds for the request. Maximum allowed value is
       #   300000ms (5 minutes).
@@ -20,12 +28,14 @@ module ContextDev
       #   @return [Integer, nil]
       optional :timeout_ms, Integer, api_name: :timeoutMS
 
-      # @!method initialize(url:, timeout_ms: nil, request_options: {})
+      # @!method initialize(url:, max_age_ms: nil, timeout_ms: nil, request_options: {})
       #   Some parameter documentations has been truncated, see
       #   {ContextDev::Models::AIExtractProductParams} for more details.
       #
       #   @param url [String] The product page URL to extract product data from.
       #
+      #   @param max_age_ms [Integer] Return a cached result if a prior scrape for the same parameters exists and is y
+      #
       #   @param timeout_ms [Integer] Optional timeout in milliseconds for the request. Maximum allowed value is 30000
       #
       #   @param request_options [ContextDev::RequestOptions, Hash{Symbol=>Object}]

data/lib/context_dev/models/ai_extract_products_params.rb

@@ -30,6 +30,14 @@ module ContextDev
           #   @return [String]
           required :domain, String
 
+          # @!attribute max_age_ms
+          #   Return a cached result if a prior scrape for the same parameters exists and is
+          #   younger than this many milliseconds. Defaults to 7 days (604800000 ms) when
+          #   omitted. Max is 30 days (2592000000 ms). Set to 0 to always scrape fresh.
+          #
+          #   @return [Integer, nil]
+          optional :max_age_ms, Integer, api_name: :maxAgeMs
+
           # @!attribute max_products
           #   Maximum number of products to extract.
           #
@@ -43,12 +51,14 @@ module ContextDev
           #   @return [Integer, nil]
           optional :timeout_ms, Integer, api_name: :timeoutMS
 
-          # @!method initialize(domain:, max_products: nil, timeout_ms: nil)
+          # @!method initialize(domain:, max_age_ms: nil, max_products: nil, timeout_ms: nil)
           #   Some parameter documentations has been truncated, see
           #   {ContextDev::Models::AIExtractProductsParams::Body::ByDomain} for more details.
           #
           #   @param domain [String] The domain name to analyze.
           #
+          #   @param max_age_ms [Integer] Return a cached result if a prior scrape for the same parameters exists and is y
+          #
           #   @param max_products [Integer] Maximum number of products to extract.
           #
           #   @param timeout_ms [Integer] Optional timeout in milliseconds for the request. Maximum allowed value is 30000
@@ -62,6 +72,14 @@ module ContextDev
           #   @return [String]
           required :direct_url, String, api_name: :directUrl
 
+          # @!attribute max_age_ms
+          #   Return a cached result if a prior scrape for the same parameters exists and is
+          #   younger than this many milliseconds. Defaults to 7 days (604800000 ms) when
+          #   omitted. Max is 30 days (2592000000 ms). Set to 0 to always scrape fresh.
+          #
+          #   @return [Integer, nil]
+          optional :max_age_ms, Integer, api_name: :maxAgeMs
+
           # @!attribute max_products
           #   Maximum number of products to extract.
           #
@@ -75,13 +93,15 @@ module ContextDev
           #   @return [Integer, nil]
           optional :timeout_ms, Integer, api_name: :timeoutMS
 
-          # @!method initialize(direct_url:, max_products: nil, timeout_ms: nil)
+          # @!method initialize(direct_url:, max_age_ms: nil, max_products: nil, timeout_ms: nil)
           #   Some parameter documentations has been truncated, see
           #   {ContextDev::Models::AIExtractProductsParams::Body::ByDirectURL} for more
           #   details.
           #
           #   @param direct_url [String] A specific URL to use directly as the starting point for extraction without doma
           #
+          #   @param max_age_ms [Integer] Return a cached result if a prior scrape for the same parameters exists and is y
+          #
           #   @param max_products [Integer] Maximum number of products to extract.
           #
           #   @param timeout_ms [Integer] Optional timeout in milliseconds for the request. Maximum allowed value is 30000

data/lib/context_dev/resources/ai.rb

@@ -39,14 +39,15 @@ module ContextDev
       # Some parameter documentations has been truncated, see
       # {ContextDev::Models::AIExtractProductParams} for more details.
       #
-      # Beta feature: Given a single URL, determines if it is a product detail page,
-      # classifies the platform/product type, and extracts the product information.
-      # Supports Amazon, TikTok Shop, Etsy, and generic ecommerce sites.
+      # Given a single URL, determines if it is a product page and extracts the product
+      # information.
       #
-      # @overload extract_product(url:, timeout_ms: nil, request_options: {})
+      # @overload extract_product(url:, max_age_ms: nil, timeout_ms: nil, request_options: {})
       #
       # @param url [String] The product page URL to extract product data from.
       #
+      # @param max_age_ms [Integer] Return a cached result if a prior scrape for the same parameters exists and is y
+      #
       # @param timeout_ms [Integer] Optional timeout in milliseconds for the request. Maximum allowed value is 30000
       #
       # @param request_options [ContextDev::RequestOptions, Hash{Symbol=>Object}, nil]
@@ -65,9 +66,9 @@ module ContextDev
         )
       end
 
-      # Beta feature: Extract product information from a brand's website. We will
-      # analyze the website and return a list of products with details such as name,
-      # description, image, pricing, features, and more.
+      # Extract product information from a brand's website. We will analyze the website
+      # and return a list of products with details such as name, description, image,
+      # pricing, features, and more.
       #
       # @overload extract_products(body:, request_options: {})
       #

data/lib/context_dev/resources/industry.rb

@@ -43,8 +43,8 @@ module ContextDev
       # {ContextDev::Models::IndustryRetrieveSicParams} for more details.
       #
       # Classify any brand into Standard Industrial Classification (SIC) codes from its
-      # domain or name. Choose between the original 1987 SIC system (`original_sic`) or
-      # the latest SIC list maintained by the SEC (`latest_sec`).
+      # domain or name. Choose between the original SIC system (`original_sic`) or the
+      # latest SIC list maintained by the SEC (`latest_sec`).
       #
       # @overload retrieve_sic(input:, max_results: nil, min_results: nil, timeout_ms: nil, type: nil, request_options: {})
       #

data/lib/context_dev/resources/utility.rb

@@ -7,9 +7,7 @@ module ContextDev
       # {ContextDev::Models::UtilityPrefetchParams} for more details.
       #
       # Signal that you may fetch brand data for a particular domain soon to improve
-      # latency. This endpoint does not charge credits and is available for paid
-      # customers to optimize future requests. [You must be on a paid plan to use this
-      # endpoint]
+      # latency.
       #
       # @overload prefetch(domain:, timeout_ms: nil, request_options: {})
       #
@@ -39,9 +37,7 @@ module ContextDev
       # Signal that you may fetch brand data for a particular domain soon to improve
       # latency. This endpoint accepts an email address, extracts the domain from it,
       # validates that it's not a disposable or free email provider, and queues the
-      # domain for prefetching. This endpoint does not charge credits and is available
-      # for paid customers to optimize future requests. [You must be on a paid plan to
-      # use this endpoint]
+      # domain for prefetching.
       #
       # @overload prefetch_by_email(email:, timeout_ms: nil, request_options: {})
       #

data/lib/context_dev/version.rb

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

data/rbi/context_dev/models/ai_extract_product_params.rbi

@@ -18,6 +18,15 @@ module ContextDev
       sig { returns(String) }
       attr_accessor :url
 
+      # Return a cached result if a prior scrape for the same parameters exists and is
+      # younger than this many milliseconds. Defaults to 7 days (604800000 ms) when
+      # omitted. Max is 30 days (2592000000 ms). Set to 0 to always scrape fresh.
+      sig { returns(T.nilable(Integer)) }
+      attr_reader :max_age_ms
+
+      sig { params(max_age_ms: Integer).void }
+      attr_writer :max_age_ms
+
       # Optional timeout in milliseconds for the request. Maximum allowed value is
       # 300000ms (5 minutes).
       sig { returns(T.nilable(Integer)) }
@@ -29,6 +38,7 @@ module ContextDev
       sig do
         params(
           url: String,
+          max_age_ms: Integer,
           timeout_ms: Integer,
           request_options: ContextDev::RequestOptions::OrHash
         ).returns(T.attached_class)
@@ -36,6 +46,10 @@ module ContextDev
       def self.new(
         # The product page URL to extract product data from.
         url:,
+        # Return a cached result if a prior scrape for the same parameters exists and is
+        # younger than this many milliseconds. Defaults to 7 days (604800000 ms) when
+        # omitted. Max is 30 days (2592000000 ms). Set to 0 to always scrape fresh.
+        max_age_ms: nil,
         # Optional timeout in milliseconds for the request. Maximum allowed value is
         # 300000ms (5 minutes).
         timeout_ms: nil,
@@ -47,6 +61,7 @@ module ContextDev
         override.returns(
           {
             url: String,
+            max_age_ms: Integer,
             timeout_ms: Integer,
             request_options: ContextDev::RequestOptions
           }

data/rbi/context_dev/models/ai_extract_products_params.rbi

@@ -76,6 +76,15 @@ module ContextDev
           sig { returns(String) }
           attr_accessor :domain
 
+          # Return a cached result if a prior scrape for the same parameters exists and is
+          # younger than this many milliseconds. Defaults to 7 days (604800000 ms) when
+          # omitted. Max is 30 days (2592000000 ms). Set to 0 to always scrape fresh.
+          sig { returns(T.nilable(Integer)) }
+          attr_reader :max_age_ms
+
+          sig { params(max_age_ms: Integer).void }
+          attr_writer :max_age_ms
+
           # Maximum number of products to extract.
           sig { returns(T.nilable(Integer)) }
           attr_reader :max_products
@@ -94,6 +103,7 @@ module ContextDev
           sig do
             params(
               domain: String,
+              max_age_ms: Integer,
               max_products: Integer,
               timeout_ms: Integer
             ).returns(T.attached_class)
@@ -101,6 +111,10 @@ module ContextDev
           def self.new(
             # The domain name to analyze.
             domain:,
+            # Return a cached result if a prior scrape for the same parameters exists and is
+            # younger than this many milliseconds. Defaults to 7 days (604800000 ms) when
+            # omitted. Max is 30 days (2592000000 ms). Set to 0 to always scrape fresh.
+            max_age_ms: nil,
             # Maximum number of products to extract.
             max_products: nil,
             # Optional timeout in milliseconds for the request. Maximum allowed value is
@@ -111,7 +125,12 @@ module ContextDev
 
           sig do
             override.returns(
-              { domain: String, max_products: Integer, timeout_ms: Integer }
+              {
+                domain: String,
+                max_age_ms: Integer,
+                max_products: Integer,
+                timeout_ms: Integer
+              }
             )
           end
           def to_hash
@@ -132,6 +151,15 @@ module ContextDev
           sig { returns(String) }
           attr_accessor :direct_url
 
+          # Return a cached result if a prior scrape for the same parameters exists and is
+          # younger than this many milliseconds. Defaults to 7 days (604800000 ms) when
+          # omitted. Max is 30 days (2592000000 ms). Set to 0 to always scrape fresh.
+          sig { returns(T.nilable(Integer)) }
+          attr_reader :max_age_ms
+
+          sig { params(max_age_ms: Integer).void }
+          attr_writer :max_age_ms
+
           # Maximum number of products to extract.
           sig { returns(T.nilable(Integer)) }
           attr_reader :max_products
@@ -150,6 +178,7 @@ module ContextDev
           sig do
             params(
               direct_url: String,
+              max_age_ms: Integer,
               max_products: Integer,
               timeout_ms: Integer
             ).returns(T.attached_class)
@@ -158,6 +187,10 @@ module ContextDev
             # A specific URL to use directly as the starting point for extraction without
             # domain resolution.
             direct_url:,
+            # Return a cached result if a prior scrape for the same parameters exists and is
+            # younger than this many milliseconds. Defaults to 7 days (604800000 ms) when
+            # omitted. Max is 30 days (2592000000 ms). Set to 0 to always scrape fresh.
+            max_age_ms: nil,
             # Maximum number of products to extract.
             max_products: nil,
             # Optional timeout in milliseconds for the request. Maximum allowed value is
@@ -168,7 +201,12 @@ module ContextDev
 
           sig do
             override.returns(
-              { direct_url: String, max_products: Integer, timeout_ms: Integer }
+              {
+                direct_url: String,
+                max_age_ms: Integer,
+                max_products: Integer,
+                timeout_ms: Integer
+              }
             )
           end
           def to_hash

data/rbi/context_dev/resources/ai.rbi

@@ -31,12 +31,12 @@ module ContextDev
       )
       end
 
-      # Beta feature: Given a single URL, determines if it is a product detail page,
-      # classifies the platform/product type, and extracts the product information.
-      # Supports Amazon, TikTok Shop, Etsy, and generic ecommerce sites.
+      # Given a single URL, determines if it is a product page and extracts the product
+      # information.
       sig do
         params(
           url: String,
+          max_age_ms: Integer,
           timeout_ms: Integer,
           request_options: ContextDev::RequestOptions::OrHash
         ).returns(ContextDev::Models::AIExtractProductResponse)
@@ -44,6 +44,10 @@ module ContextDev
       def extract_product(
         # The product page URL to extract product data from.
         url:,
+        # Return a cached result if a prior scrape for the same parameters exists and is
+        # younger than this many milliseconds. Defaults to 7 days (604800000 ms) when
+        # omitted. Max is 30 days (2592000000 ms). Set to 0 to always scrape fresh.
+        max_age_ms: nil,
         # Optional timeout in milliseconds for the request. Maximum allowed value is
         # 300000ms (5 minutes).
         timeout_ms: nil,
@@ -51,9 +55,9 @@ module ContextDev
       )
       end
 
-      # Beta feature: Extract product information from a brand's website. We will
-      # analyze the website and return a list of products with details such as name,
-      # description, image, pricing, features, and more.
+      # Extract product information from a brand's website. We will analyze the website
+      # and return a list of products with details such as name, description, image,
+      # pricing, features, and more.
       sig do
         params(
           body:

data/rbi/context_dev/resources/industry.rbi

@@ -32,8 +32,8 @@ module ContextDev
       end
 
       # Classify any brand into Standard Industrial Classification (SIC) codes from its
-      # domain or name. Choose between the original 1987 SIC system (`original_sic`) or
-      # the latest SIC list maintained by the SEC (`latest_sec`).
+      # domain or name. Choose between the original SIC system (`original_sic`) or the
+      # latest SIC list maintained by the SEC (`latest_sec`).
       sig do
         params(
           input: String,

data/rbi/context_dev/resources/utility.rbi

@@ -4,9 +4,7 @@ module ContextDev
   module Resources
     class Utility
       # Signal that you may fetch brand data for a particular domain soon to improve
-      # latency. This endpoint does not charge credits and is available for paid
-      # customers to optimize future requests. [You must be on a paid plan to use this
-      # endpoint]
+      # latency.
       sig do
         params(
           domain: String,
@@ -28,9 +26,7 @@ module ContextDev
       # Signal that you may fetch brand data for a particular domain soon to improve
       # latency. This endpoint accepts an email address, extracts the domain from it,
       # validates that it's not a disposable or free email provider, and queues the
-      # domain for prefetching. This endpoint does not charge credits and is available
-      # for paid customers to optimize future requests. [You must be on a paid plan to
-      # use this endpoint]
+      # domain for prefetching.
       sig do
         params(
           email: String,

data/sig/context_dev/models/ai_extract_product_params.rbs

@@ -1,7 +1,7 @@
 module ContextDev
   module Models
     type ai_extract_product_params =
-      { url: String, timeout_ms: Integer }
+      { url: String, max_age_ms: Integer, timeout_ms: Integer }
       & ContextDev::Internal::Type::request_parameters
 
     class AIExtractProductParams < ContextDev::Internal::Type::BaseModel
@@ -10,18 +10,24 @@ module ContextDev
 
       attr_accessor url: String
 
+      attr_reader max_age_ms: Integer?
+
+      def max_age_ms=: (Integer) -> Integer
+
       attr_reader timeout_ms: Integer?
 
       def timeout_ms=: (Integer) -> Integer
 
       def initialize: (
         url: String,
+        ?max_age_ms: Integer,
         ?timeout_ms: Integer,
         ?request_options: ContextDev::request_opts
       ) -> void
 
       def to_hash: -> {
         url: String,
+        max_age_ms: Integer,
         timeout_ms: Integer,
         request_options: ContextDev::RequestOptions
       }

data/sig/context_dev/models/ai_extract_products_params.rbs

@@ -28,11 +28,20 @@ module ContextDev
         extend ContextDev::Internal::Type::Union
 
         type by_domain =
-          { domain: String, max_products: Integer, timeout_ms: Integer }
+          {
+            domain: String,
+            max_age_ms: Integer,
+            max_products: Integer,
+            timeout_ms: Integer
+          }
 
         class ByDomain < ContextDev::Internal::Type::BaseModel
           attr_accessor domain: String
 
+          attr_reader max_age_ms: Integer?
+
+          def max_age_ms=: (Integer) -> Integer
+
           attr_reader max_products: Integer?
 
           def max_products=: (Integer) -> Integer
@@ -43,23 +52,34 @@ module ContextDev
 
           def initialize: (
             domain: String,
+            ?max_age_ms: Integer,
             ?max_products: Integer,
             ?timeout_ms: Integer
           ) -> void
 
           def to_hash: -> {
             domain: String,
+            max_age_ms: Integer,
             max_products: Integer,
             timeout_ms: Integer
           }
         end
 
         type by_direct_url =
-          { direct_url: String, max_products: Integer, timeout_ms: Integer }
+          {
+            direct_url: String,
+            max_age_ms: Integer,
+            max_products: Integer,
+            timeout_ms: Integer
+          }
 
         class ByDirectURL < ContextDev::Internal::Type::BaseModel
           attr_accessor direct_url: String
 
+          attr_reader max_age_ms: Integer?
+
+          def max_age_ms=: (Integer) -> Integer
+
           attr_reader max_products: Integer?
 
           def max_products=: (Integer) -> Integer
@@ -70,12 +90,14 @@ module ContextDev
 
           def initialize: (
             direct_url: String,
+            ?max_age_ms: Integer,
             ?max_products: Integer,
             ?timeout_ms: Integer
           ) -> void
 
           def to_hash: -> {
             direct_url: String,
+            max_age_ms: Integer,
             max_products: Integer,
             timeout_ms: Integer
           }

data/sig/context_dev/resources/ai.rbs

@@ -11,6 +11,7 @@ module ContextDev
 
       def extract_product: (
         url: String,
+        ?max_age_ms: Integer,
         ?timeout_ms: Integer,
         ?request_options: ContextDev::request_opts
       ) -> ContextDev::Models::AIExtractProductResponse

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: context.dev
 version: !ruby/object:Gem::Version
-  version: 1.9.0
+  version: 1.10.0
 platform: ruby
 authors:
 - Context Dev
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-04-25 00:00:00.000000000 Z
+date: 2026-05-01 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: cgi