context.dev 1.34.0 → 1.36.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: fd17c0a5c6f2ce8e8539a2173689b2013c87fbaba2cceedc66594c51d9289f2b
-  data.tar.gz: 6db4666ba083805420a21d4d6bc9094df09fa3175e7773423e612442e34e2ae0
+  metadata.gz: b992b047fe68af144930573fcf7afe0e46201c7079c77c3b38b0c6700cd44caf
+  data.tar.gz: 98b70840e40a074cbef802cec9842d03883300d201b4a7d0fde34dcb13d8f9b7
 SHA512:
-  metadata.gz: c191886c414c10297b0b53fb6f10317183db917af443628ec65b16edbca1067e4258f7e992f0e1b61afe27a85da4f69a88284a9911917c7b4e6c4b545b3ca591
-  data.tar.gz: 3942beaa1e6fe0113a3ecf025531876a3b90fc0fb92658986062b0205b603cc7c1ac5900b1ee690b6b24f125e9555d7103deabe94e6c51da3d33801b3ee49004
+  metadata.gz: 50fe5fca39ab53e19c40eea5c6fce6e762272e42aebc77363fd08bc80a94977fddf3c00edf87eed28fce801af282276f78a4ae8fe542da01d34d174c8c320fda
+  data.tar.gz: 6378d2fce07dd46987a7d708a7d62a975f7fb3663e8c2716eb04f488ee1edab072575c930591719ce4549f810ab22794b41a5d42d19b38650e3c62e0634dc333

data/CHANGELOG.md

@@ -1,5 +1,24 @@
 # Changelog
 
+## 1.36.0 (2026-06-27)
+
+Full Changelog: [v1.35.0...v1.36.0](https://github.com/context-dot-dev/context-ruby-sdk/compare/v1.35.0...v1.36.0)
+
+### Features
+
+* **api:** api update ([edf39d7](https://github.com/context-dot-dev/context-ruby-sdk/commit/edf39d75e9ca0a7b96ddac6467f9b50ceca0acf1))
+* **api:** api update ([893f11d](https://github.com/context-dot-dev/context-ruby-sdk/commit/893f11d2746ccb636e971e12c24553043046cb11))
+* **api:** api update ([59319b0](https://github.com/context-dot-dev/context-ruby-sdk/commit/59319b0421154c96a444f5e2d45b83e8f4bc9074))
+* **api:** api update ([125ebe5](https://github.com/context-dot-dev/context-ruby-sdk/commit/125ebe5cb023b276c01bdc8c3cafbe8841dffddb))
+
+## 1.35.0 (2026-06-25)
+
+Full Changelog: [v1.34.0...v1.35.0](https://github.com/context-dot-dev/context-ruby-sdk/compare/v1.34.0...v1.35.0)
+
+### Features
+
+* **api:** api update ([26f4358](https://github.com/context-dot-dev/context-ruby-sdk/commit/26f43582d8d63b9ebd98f0ba04c64e93d61b185f))
+
 ## 1.34.0 (2026-06-19)
 
 Full Changelog: [v1.33.0...v1.34.0](https://github.com/context-dot-dev/context-ruby-sdk/compare/v1.33.0...v1.34.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.34.0"
+gem "context.dev", "~> 1.36.0"
 ```
 
 <!-- x-release-please-end -->
@@ -206,25 +206,25 @@ context_dev.brand.retrieve(**params)
 Since this library does not depend on `sorbet-runtime`, it cannot provide [`T::Enum`](https://sorbet.org/docs/tenum) instances. Instead, we provide "tagged symbols" instead, which is always a primitive at runtime:
 
 ```ruby
-# :true
-puts(ContextDev::WebScreenshotParams::FullScreenshot::TRUE)
+# :light
+puts(ContextDev::WebExtractStyleguideParams::ColorScheme::LIGHT)
 
-# Revealed type: `T.all(ContextDev::WebScreenshotParams::FullScreenshot, Symbol)`
-T.reveal_type(ContextDev::WebScreenshotParams::FullScreenshot::TRUE)
+# Revealed type: `T.all(ContextDev::WebExtractStyleguideParams::ColorScheme, Symbol)`
+T.reveal_type(ContextDev::WebExtractStyleguideParams::ColorScheme::LIGHT)
 ```
 
 Enum parameters have a "relaxed" type, so you can either pass in enum constants or their literal value:
 
 ```ruby
 # Using the enum constants preserves the tagged type information:
-context_dev.web.screenshot(
-  full_screenshot: ContextDev::WebScreenshotParams::FullScreenshot::TRUE,
+context_dev.web.extract_styleguide(
+  color_scheme: ContextDev::WebExtractStyleguideParams::ColorScheme::LIGHT,
   # …
 )
 
 # Literal values are also permissible:
-context_dev.web.screenshot(
-  full_screenshot: :true,
+context_dev.web.extract_styleguide(
+  color_scheme: :light,
   # …
 )
 ```

data/lib/context_dev/models/web_extract_styleguide_params.rb

@@ -7,6 +7,13 @@ module ContextDev
       extend ContextDev::Internal::Type::RequestParameters::Converter
       include ContextDev::Internal::Type::RequestParameters
 
+      # @!attribute color_scheme
+      #   Optional browser color scheme to emulate for websites that respond to
+      #   prefers-color-scheme. This value is part of the styleguide cache key.
+      #
+      #   @return [Symbol, ContextDev::Models::WebExtractStyleguideParams::ColorScheme, nil]
+      optional :color_scheme, enum: -> { ContextDev::WebExtractStyleguideParams::ColorScheme }
+
       # @!attribute direct_url
       #   A specific URL to fetch the styleguide from directly, bypassing domain
       #   resolution (e.g., 'https://example.com/design-system'). When provided, the
@@ -41,10 +48,12 @@ module ContextDev
       #   @return [Integer, nil]
       optional :timeout_ms, Integer
 
-      # @!method initialize(direct_url: nil, domain: nil, max_age_ms: nil, timeout_ms: nil, request_options: {})
+      # @!method initialize(color_scheme: nil, direct_url: nil, domain: nil, max_age_ms: nil, timeout_ms: nil, request_options: {})
       #   Some parameter documentations has been truncated, see
       #   {ContextDev::Models::WebExtractStyleguideParams} for more details.
       #
+      #   @param color_scheme [Symbol, ContextDev::Models::WebExtractStyleguideParams::ColorScheme] Optional browser color scheme to emulate for websites that respond to prefers-co
+      #
       #   @param direct_url [String] A specific URL to fetch the styleguide from directly, bypassing domain resolutio
       #
       #   @param domain [String] Domain name to extract styleguide from (e.g., 'example.com', 'google.com'). The
@@ -54,6 +63,18 @@ module ContextDev
       #   @param timeout_ms [Integer] Optional timeout in milliseconds for the request. If the request takes longer th
       #
       #   @param request_options [ContextDev::RequestOptions, Hash{Symbol=>Object}]
+
+      # Optional browser color scheme to emulate for websites that respond to
+      # prefers-color-scheme. This value is part of the styleguide cache key.
+      module ColorScheme
+        extend ContextDev::Internal::Type::Enum
+
+        LIGHT = :light
+        DARK = :dark
+
+        # @!method self.values
+        #   @return [Array<Symbol>]
+      end
     end
   end
 end

data/lib/context_dev/models/web_screenshot_params.rb

@@ -7,6 +7,20 @@ module ContextDev
       extend ContextDev::Internal::Type::RequestParameters::Converter
       include ContextDev::Internal::Type::RequestParameters
 
+      # @!attribute color_scheme
+      #   Optional parameter to choose the site's visual theme in the screenshot. Use
+      #   'light' or 'dark' when the site offers both appearances.
+      #
+      #   @return [Symbol, ContextDev::Models::WebScreenshotParams::ColorScheme, nil]
+      optional :color_scheme, enum: -> { ContextDev::WebScreenshotParams::ColorScheme }
+
+      # @!attribute country
+      #   Two-letter ISO 3166-1 alpha-2 country code for the website request location.
+      #   When provided, Context.dev fetches the target page from that country.
+      #
+      #   @return [Symbol, ContextDev::Models::WebScreenshotParams::Country, nil]
+      optional :country, enum: -> { ContextDev::WebScreenshotParams::Country }
+
       # @!attribute direct_url
       #   A specific URL to screenshot directly, bypassing domain resolution (e.g.,
       #   'https://example.com/pricing'). When provided, the screenshot is taken of this
@@ -57,6 +71,17 @@ module ContextDev
       #   @return [Symbol, ContextDev::Models::WebScreenshotParams::Page, nil]
       optional :page, enum: -> { ContextDev::WebScreenshotParams::Page }
 
+      # @!attribute scroll_offset
+      #   Optional vertical scroll offset in pixels for capturing a long page in
+      #   viewport-sized chunks. When provided, the full page is captured once and the
+      #   returned image is the viewport-sized slice that begins at this Y offset (e.g.
+      #   request scrollOffset=0, then 1080, then 2160 to walk a 1920x1080 landing page
+      #   top to bottom). The final slice may be shorter than the viewport height. Takes
+      #   precedence over fullScreenshot. Max: 100000.
+      #
+      #   @return [Integer, nil]
+      optional :scroll_offset, Integer
+
       # @!attribute timeout_ms
       #   Optional timeout in milliseconds for the request. If the request takes longer
       #   than this value, it will be aborted with a 408 status code. Maximum allowed
@@ -79,10 +104,14 @@ module ContextDev
       #   @return [Integer, nil]
       optional :wait_for_ms, Integer
 
-      # @!method initialize(direct_url: nil, domain: nil, full_screenshot: nil, handle_cookie_popup: nil, max_age_ms: nil, page: nil, timeout_ms: nil, viewport: nil, wait_for_ms: nil, request_options: {})
+      # @!method initialize(color_scheme: nil, country: nil, direct_url: nil, domain: nil, full_screenshot: nil, handle_cookie_popup: nil, max_age_ms: nil, page: nil, scroll_offset: nil, timeout_ms: nil, viewport: nil, wait_for_ms: nil, request_options: {})
       #   Some parameter documentations has been truncated, see
       #   {ContextDev::Models::WebScreenshotParams} for more details.
       #
+      #   @param color_scheme [Symbol, ContextDev::Models::WebScreenshotParams::ColorScheme] Optional parameter to choose the site's visual theme in the screenshot. Use 'lig
+      #
+      #   @param country [Symbol, ContextDev::Models::WebScreenshotParams::Country] Two-letter ISO 3166-1 alpha-2 country code for the website request location. Whe
+      #
       #   @param direct_url [String] A specific URL to screenshot directly, bypassing domain resolution (e.g., 'https
       #
       #   @param domain [String] Domain name to take screenshot of (e.g., 'example.com', 'google.com'). The domai
@@ -95,6 +124,8 @@ module ContextDev
       #
       #   @param page [Symbol, ContextDev::Models::WebScreenshotParams::Page] Optional parameter to specify which page type to screenshot. If provided, the sy
       #
+      #   @param scroll_offset [Integer] Optional vertical scroll offset in pixels for capturing a long page in viewport-
+      #
       #   @param timeout_ms [Integer] Optional timeout in milliseconds for the request. If the request takes longer th
       #
       #   @param viewport [ContextDev::Models::WebScreenshotParams::Viewport] Optional browser viewport dimensions for the screenshot. Defaults to 1920x1080.
@@ -103,6 +134,232 @@ module ContextDev
       #
       #   @param request_options [ContextDev::RequestOptions, Hash{Symbol=>Object}]
 
+      # Optional parameter to choose the site's visual theme in the screenshot. Use
+      # 'light' or 'dark' when the site offers both appearances.
+      module ColorScheme
+        extend ContextDev::Internal::Type::Enum
+
+        LIGHT = :light
+        DARK = :dark
+
+        # @!method self.values
+        #   @return [Array<Symbol>]
+      end
+
+      # Two-letter ISO 3166-1 alpha-2 country code for the website request location.
+      # When provided, Context.dev fetches the target page from that country.
+      module Country
+        extend ContextDev::Internal::Type::Enum
+
+        AD = :ad
+        AE = :ae
+        AF = :af
+        AG = :ag
+        AI = :ai
+        AL = :al
+        AM = :am
+        AO = :ao
+        AR = :ar
+        AT = :at
+        AU = :au
+        AW = :aw
+        AZ = :az
+        BA = :ba
+        BB = :bb
+        BD = :bd
+        BE = :be
+        BF = :bf
+        BG = :bg
+        BH = :bh
+        BI = :bi
+        BJ = :bj
+        BM = :bm
+        BN = :bn
+        BO = :bo
+        BQ = :bq
+        BR = :br
+        BS = :bs
+        BW = :bw
+        BY = :by
+        BZ = :bz
+        CA = :ca
+        CD = :cd
+        CF = :cf
+        CG = :cg
+        CH = :ch
+        CI = :ci
+        CL = :cl
+        CM = :cm
+        CN = :cn
+        CO = :co
+        CR = :cr
+        CV = :cv
+        CW = :cw
+        CY = :cy
+        CZ = :cz
+        DE = :de
+        DJ = :dj
+        DK = :dk
+        DM = :dm
+        DO = :do
+        DZ = :dz
+        EC = :ec
+        EE = :ee
+        EG = :eg
+        ES = :es
+        ET = :et
+        FI = :fi
+        FJ = :fj
+        FR = :fr
+        GA = :ga
+        GB = :gb
+        GD = :gd
+        GE = :ge
+        GF = :gf
+        GG = :gg
+        GH = :gh
+        GM = :gm
+        GN = :gn
+        GP = :gp
+        GQ = :gq
+        GR = :gr
+        GT = :gt
+        GU = :gu
+        GW = :gw
+        GY = :gy
+        HK = :hk
+        HN = :hn
+        HR = :hr
+        HT = :ht
+        HU = :hu
+        ID = :id
+        IE = :ie
+        IL = :il
+        IM = :im
+        IN = :in
+        IQ = :iq
+        IR = :ir
+        IS = :is
+        IT = :it
+        JE = :je
+        JM = :jm
+        JO = :jo
+        JP = :jp
+        KE = :ke
+        KG = :kg
+        KH = :kh
+        KN = :kn
+        KR = :kr
+        KW = :kw
+        KY = :ky
+        KZ = :kz
+        LA = :la
+        LB = :lb
+        LC = :lc
+        LK = :lk
+        LR = :lr
+        LS = :ls
+        LT = :lt
+        LU = :lu
+        LV = :lv
+        LY = :ly
+        MA = :ma
+        MC = :mc
+        MD = :md
+        ME = :me
+        MF = :mf
+        MG = :mg
+        MK = :mk
+        ML = :ml
+        MM = :mm
+        MN = :mn
+        MO = :mo
+        MQ = :mq
+        MR = :mr
+        MT = :mt
+        MU = :mu
+        MV = :mv
+        MW = :mw
+        MX = :mx
+        MY = :my
+        MZ = :mz
+        NA = :na
+        NC = :nc
+        NE = :ne
+        NG = :ng
+        NI = :ni
+        NL = :nl
+        NO = :no
+        NP = :np
+        NZ = :nz
+        OM = :om
+        PA = :pa
+        PE = :pe
+        PF = :pf
+        PG = :pg
+        PH = :ph
+        PK = :pk
+        PL = :pl
+        PR = :pr
+        PS = :ps
+        PT = :pt
+        PY = :py
+        QA = :qa
+        RE = :re
+        RO = :ro
+        RS = :rs
+        RU = :ru
+        RW = :rw
+        SA = :sa
+        SC = :sc
+        SD = :sd
+        SE = :se
+        SG = :sg
+        SI = :si
+        SK = :sk
+        SL = :sl
+        SM = :sm
+        SN = :sn
+        SO = :so
+        SR = :sr
+        SS = :ss
+        ST = :st
+        SV = :sv
+        SX = :sx
+        SY = :sy
+        SZ = :sz
+        TC = :tc
+        TD = :td
+        TG = :tg
+        TH = :th
+        TJ = :tj
+        TL = :tl
+        TM = :tm
+        TN = :tn
+        TR = :tr
+        TT = :tt
+        TW = :tw
+        TZ = :tz
+        UA = :ua
+        UG = :ug
+        US = :us
+        UY = :uy
+        UZ = :uz
+        VC = :vc
+        VE = :ve
+        VG = :vg
+        VI = :vi
+        VN = :vn
+        YE = :ye
+        YT = :yt
+        ZA = :za
+        ZM = :zm
+        ZW = :zw
+
+        # @!method self.values
+        #   @return [Array<Symbol>]
+      end
+
       # 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).