context.dev 1.3.0 → 1.4.0

data/rbi/context_dev/models/web_screenshot_params.rbi

@@ -11,10 +11,22 @@ module ContextDev
           T.any(ContextDev::WebScreenshotParams, ContextDev::Internal::AnyHash)
         end
 
+      # A specific URL to screenshot directly, bypassing domain resolution (e.g.,
+      # 'https://example.com/pricing'). When provided, the screenshot is taken of this
+      # exact URL.
+      sig { returns(T.nilable(String)) }
+      attr_reader :direct_url
+
+      sig { params(direct_url: String).void }
+      attr_writer :direct_url
+
       # Domain name to take screenshot of (e.g., 'example.com', 'google.com'). The
       # domain will be automatically normalized and validated.
-      sig { returns(String) }
-      attr_accessor :domain
+      sig { returns(T.nilable(String)) }
+      attr_reader :domain
+
+      sig { params(domain: String).void }
+      attr_writer :domain
 
       # Optional parameter to determine screenshot type. If 'true', takes a full page
       # screenshot capturing all content. If 'false' or not provided, takes a viewport
@@ -37,7 +49,8 @@ module ContextDev
       # Optional parameter to specify which page type to screenshot. If provided, the
       # system will scrape the domain's links and use heuristics to find the most
       # appropriate URL for the specified page type (30 supported languages). If not
-      # provided, screenshots the main domain landing page.
+      # provided, screenshots the main domain landing page. Only applicable when using
+      # 'domain', not 'directUrl'.
       sig do
         returns(T.nilable(ContextDev::WebScreenshotParams::Page::OrSymbol))
       end
@@ -65,6 +78,7 @@ module ContextDev
 
       sig do
         params(
+          direct_url: String,
           domain: String,
           full_screenshot:
             ContextDev::WebScreenshotParams::FullScreenshot::OrSymbol,
@@ -74,9 +88,13 @@ module ContextDev
         ).returns(T.attached_class)
       end
       def self.new(
+        # A specific URL to screenshot directly, bypassing domain resolution (e.g.,
+        # 'https://example.com/pricing'). When provided, the screenshot is taken of this
+        # exact URL.
+        direct_url: nil,
         # Domain name to take screenshot of (e.g., 'example.com', 'google.com'). The
         # domain will be automatically normalized and validated.
-        domain:,
+        domain: nil,
         # Optional parameter to determine screenshot type. If 'true', takes a full page
         # screenshot capturing all content. If 'false' or not provided, takes a viewport
         # screenshot (standard browser view).
@@ -84,7 +102,8 @@ module ContextDev
         # Optional parameter to specify which page type to screenshot. If provided, the
         # system will scrape the domain's links and use heuristics to find the most
         # appropriate URL for the specified page type (30 supported languages). If not
-        # provided, screenshots the main domain landing page.
+        # provided, screenshots the main domain landing page. Only applicable when using
+        # 'domain', not 'directUrl'.
         page: nil,
         # Optional parameter to prioritize screenshot capture. If 'speed', optimizes for
         # faster capture with basic quality. If 'quality', optimizes for higher quality
@@ -97,6 +116,7 @@ module ContextDev
       sig do
         override.returns(
           {
+            direct_url: String,
             domain: String,
             full_screenshot:
               ContextDev::WebScreenshotParams::FullScreenshot::OrSymbol,
@@ -146,7 +166,8 @@ module ContextDev
       # Optional parameter to specify which page type to screenshot. If provided, the
       # system will scrape the domain's links and use heuristics to find the most
       # appropriate URL for the specified page type (30 supported languages). If not
-      # provided, screenshots the main domain landing page.
+      # provided, screenshots the main domain landing page. Only applicable when using
+      # 'domain', not 'directUrl'.
       module Page
         extend ContextDev::Internal::Type::Enum
 

data/rbi/context_dev/resources/brand.rbi

@@ -19,8 +19,7 @@ module ContextDev
         # Domain name to retrieve brand data for (e.g., 'example.com', 'google.com').
         # Cannot be used with name or ticker parameters.
         domain:,
-        # Optional parameter to force the language of the retrieved brand data. Works with
-        # all three lookup methods.
+        # Optional parameter to force the language of the retrieved brand data.
         force_language: nil,
         # Optional parameter to optimize the API call for maximum speed. When set to true,
         # the API will skip time-consuming operations for faster response at the cost of

data/rbi/context_dev/resources/web.rbi

@@ -5,10 +5,12 @@ module ContextDev
     class Web
       # Capture a screenshot of a website. Supports both viewport (standard browser
       # view) and full-page screenshots. Can also screenshot specific page types (login,
-      # pricing, etc.) by using heuristics to find the appropriate URL. Returns a URL to
-      # the uploaded screenshot image hosted on our CDN.
+      # pricing, etc.) by using heuristics to find the appropriate URL. Either 'domain'
+      # or 'directUrl' must be provided as a query parameter, but not both. Returns a
+      # URL to the uploaded screenshot image hosted on our CDN.
       sig do
         params(
+          direct_url: String,
           domain: String,
           full_screenshot:
             ContextDev::WebScreenshotParams::FullScreenshot::OrSymbol,
@@ -18,9 +20,13 @@ module ContextDev
         ).returns(ContextDev::Models::WebScreenshotResponse)
       end
       def screenshot(
+        # A specific URL to screenshot directly, bypassing domain resolution (e.g.,
+        # 'https://example.com/pricing'). When provided, the screenshot is taken of this
+        # exact URL.
+        direct_url: nil,
         # Domain name to take screenshot of (e.g., 'example.com', 'google.com'). The
         # domain will be automatically normalized and validated.
-        domain:,
+        domain: nil,
         # Optional parameter to determine screenshot type. If 'true', takes a full page
         # screenshot capturing all content. If 'false' or not provided, takes a viewport
         # screenshot (standard browser view).
@@ -28,7 +34,8 @@ module ContextDev
         # Optional parameter to specify which page type to screenshot. If provided, the
         # system will scrape the domain's links and use heuristics to find the most
         # appropriate URL for the specified page type (30 supported languages). If not
-        # provided, screenshots the main domain landing page.
+        # provided, screenshots the main domain landing page. Only applicable when using
+        # 'domain', not 'directUrl'.
         page: nil,
         # Optional parameter to prioritize screenshot capture. If 'speed', optimizes for
         # faster capture with basic quality. If 'quality', optimizes for higher quality

data/sig/context_dev/models/brand_identify_from_transaction_params.rbs

@@ -570,120 +570,250 @@ module ContextDev
       end
 
       type force_language =
-        :albanian
+        :afrikaans
+        | :albanian
+        | :amharic
         | :arabic
+        | :armenian
+        | :assamese
+        | :aymara
         | :azeri
+        | :basque
+        | :belarusian
         | :bengali
+        | :bosnian
         | :bulgarian
+        | :burmese
         | :cantonese
+        | :catalan
         | :cebuano
+        | :chinese
+        | :corsican
         | :croatian
         | :czech
         | :danish
         | :dutch
         | :english
+        | :esperanto
         | :estonian
         | :farsi
+        | :fijian
         | :finnish
         | :french
+        | :galician
+        | :georgian
         | :german
+        | :greek
+        | :guarani
+        | :gujarati
+        | :"haitian-creole"
         | :hausa
         | :hawaiian
+        | :hebrew
         | :hindi
+        | :hmong
         | :hungarian
         | :icelandic
+        | :igbo
         | :indonesian
+        | :irish
         | :italian
+        | :japanese
+        | :javanese
+        | :kannada
         | :kazakh
+        | :khmer
+        | :kinyarwanda
         | :korean
+        | :kurdish
         | :kyrgyz
+        | :lao
         | :latin
         | :latvian
+        | :lingala
         | :lithuanian
+        | :luxembourgish
         | :macedonian
+        | :malagasy
+        | :malay
+        | :malayalam
+        | :maltese
+        | :maori
+        | :marathi
         | :mongolian
         | :nepali
         | :norwegian
+        | :odia
+        | :oromo
         | :pashto
         | :pidgin
         | :polish
         | :portuguese
+        | :punjabi
+        | :quechua
         | :romanian
         | :russian
+        | :samoan
+        | :"scottish-gaelic"
         | :serbian
+        | :sesotho
+        | :shona
+        | :sindhi
+        | :sinhala
         | :slovak
         | :slovene
         | :somali
         | :spanish
+        | :sundanese
         | :swahili
         | :swedish
         | :tagalog
+        | :tajik
+        | :tamil
+        | :tatar
+        | :telugu
         | :thai
+        | :tibetan
+        | :tigrinya
+        | :tongan
+        | :tswana
         | :turkish
+        | :turkmen
         | :ukrainian
         | :urdu
+        | :uyghur
         | :uzbek
         | :vietnamese
         | :welsh
+        | :wolof
+        | :xhosa
+        | :yiddish
+        | :yoruba
+        | :zulu
 
       module ForceLanguage
         extend ContextDev::Internal::Type::Enum
 
+        AFRIKAANS: :afrikaans
         ALBANIAN: :albanian
+        AMHARIC: :amharic
         ARABIC: :arabic
+        ARMENIAN: :armenian
+        ASSAMESE: :assamese
+        AYMARA: :aymara
         AZERI: :azeri
+        BASQUE: :basque
+        BELARUSIAN: :belarusian
         BENGALI: :bengali
+        BOSNIAN: :bosnian
         BULGARIAN: :bulgarian
+        BURMESE: :burmese
         CANTONESE: :cantonese
+        CATALAN: :catalan
         CEBUANO: :cebuano
+        CHINESE: :chinese
+        CORSICAN: :corsican
         CROATIAN: :croatian
         CZECH: :czech
         DANISH: :danish
         DUTCH: :dutch
         ENGLISH: :english
+        ESPERANTO: :esperanto
         ESTONIAN: :estonian
         FARSI: :farsi
+        FIJIAN: :fijian
         FINNISH: :finnish
         FRENCH: :french
+        GALICIAN: :galician
+        GEORGIAN: :georgian
         GERMAN: :german
+        GREEK: :greek
+        GUARANI: :guarani
+        GUJARATI: :gujarati
+        HAITIAN_CREOLE: :"haitian-creole"
         HAUSA: :hausa
         HAWAIIAN: :hawaiian
+        HEBREW: :hebrew
         HINDI: :hindi
+        HMONG: :hmong
         HUNGARIAN: :hungarian
         ICELANDIC: :icelandic
+        IGBO: :igbo
         INDONESIAN: :indonesian
+        IRISH: :irish
         ITALIAN: :italian
+        JAPANESE: :japanese
+        JAVANESE: :javanese
+        KANNADA: :kannada
         KAZAKH: :kazakh
+        KHMER: :khmer
+        KINYARWANDA: :kinyarwanda
         KOREAN: :korean
+        KURDISH: :kurdish
         KYRGYZ: :kyrgyz
+        LAO: :lao
         LATIN: :latin
         LATVIAN: :latvian
+        LINGALA: :lingala
         LITHUANIAN: :lithuanian
+        LUXEMBOURGISH: :luxembourgish
         MACEDONIAN: :macedonian
+        MALAGASY: :malagasy
+        MALAY: :malay
+        MALAYALAM: :malayalam
+        MALTESE: :maltese
+        MAORI: :maori
+        MARATHI: :marathi
         MONGOLIAN: :mongolian
         NEPALI: :nepali
         NORWEGIAN: :norwegian
+        ODIA: :odia
+        OROMO: :oromo
         PASHTO: :pashto
         PIDGIN: :pidgin
         POLISH: :polish
         PORTUGUESE: :portuguese
+        PUNJABI: :punjabi
+        QUECHUA: :quechua
         ROMANIAN: :romanian
         RUSSIAN: :russian
+        SAMOAN: :samoan
+        SCOTTISH_GAELIC: :"scottish-gaelic"
         SERBIAN: :serbian
+        SESOTHO: :sesotho
+        SHONA: :shona
+        SINDHI: :sindhi
+        SINHALA: :sinhala
         SLOVAK: :slovak
         SLOVENE: :slovene
         SOMALI: :somali
         SPANISH: :spanish
+        SUNDANESE: :sundanese
         SWAHILI: :swahili
         SWEDISH: :swedish
         TAGALOG: :tagalog
+        TAJIK: :tajik
+        TAMIL: :tamil
+        TATAR: :tatar
+        TELUGU: :telugu
         THAI: :thai
+        TIBETAN: :tibetan
+        TIGRINYA: :tigrinya
+        TONGAN: :tongan
+        TSWANA: :tswana
         TURKISH: :turkish
+        TURKMEN: :turkmen
         UKRAINIAN: :ukrainian
         URDU: :urdu
+        UYGHUR: :uyghur
         UZBEK: :uzbek
         VIETNAMESE: :vietnamese
         WELSH: :welsh
+        WOLOF: :wolof
+        XHOSA: :xhosa
+        YIDDISH: :yiddish
+        YORUBA: :yoruba
+        ZULU: :zulu
 
         def self?.values: -> ::Array[ContextDev::Models::BrandIdentifyFromTransactionParams::force_language]
       end