context.dev 1.22.0 → 1.24.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
checksums.yaml CHANGED
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  SHA256:
3
- metadata.gz: a14d5f028bfeb55ce73a32eaeaa1909340d1d7c6fd93184275f26b4dfef118d5
4
- data.tar.gz: c47c216f96e898388c0c8dfe13283bb114fd267da917f245ee7b1656b1b53179
3
+ metadata.gz: 18c7d842ed7b7ad15534738c63bcd5c85e4423fce2f7d91f5a66f08d148705a0
4
+ data.tar.gz: '067911c3ee2689b6aaff65fd02c2ff6a3ddc6bd7ab8557c436465da33a66c6b7'
5
5
  SHA512:
6
- metadata.gz: 978ce0203c5313bde915374ba3f465290adfa53f32f0f5a5551b72b455730793de0b30525c4798deeedf6b8418133a44be3e7bdd9c50ee8dd6c86ce696b0c7e9
7
- data.tar.gz: 38f150aa5a5b3a8ff537f63fde25faa48646659c6651403e2066d97d4210f33d227c172e8020631c5968b627eec6028578ef9cef3de5cd790b8877870eb1d5c3
6
+ metadata.gz: 63387a950cc87f056744ac02ec23a7b1566d6111189fcee2a78297ad21e3a0e6510c965ae81258a3a427651ec5290d029a0ccab716d464cb8779a63329d7a43d
7
+ data.tar.gz: 19785a765c206092c2857e6aca4c645c13e491296c23cf5b4236a97898cf8182ad7f37db1d2e95f2b5e1010c94b32fa7861959e11546f89252cfa15bf03efb23
data/CHANGELOG.md CHANGED
@@ -1,5 +1,21 @@
1
1
  # Changelog
2
2
 
3
+ ## 1.24.0 (2026-05-30)
4
+
5
+ Full Changelog: [v1.23.0...v1.24.0](https://github.com/context-dot-dev/context-ruby-sdk/compare/v1.23.0...v1.24.0)
6
+
7
+ ### Features
8
+
9
+ * **api:** api update ([7948cbf](https://github.com/context-dot-dev/context-ruby-sdk/commit/7948cbf296742dd0fea7c08c148962a35ed88c20))
10
+
11
+ ## 1.23.0 (2026-05-19)
12
+
13
+ Full Changelog: [v1.22.0...v1.23.0](https://github.com/context-dot-dev/context-ruby-sdk/compare/v1.22.0...v1.23.0)
14
+
15
+ ### Features
16
+
17
+ * **api:** api update ([5574aa6](https://github.com/context-dot-dev/context-ruby-sdk/commit/5574aa6793f9ff576b625cbb2e86fa819fd3bf36))
18
+
3
19
  ## 1.22.0 (2026-05-16)
4
20
 
5
21
  Full Changelog: [v1.21.0...v1.22.0](https://github.com/context-dot-dev/context-ruby-sdk/compare/v1.21.0...v1.22.0)
data/README.md CHANGED
@@ -26,7 +26,7 @@ To use this gem, install via Bundler by adding the following to your application
26
26
  <!-- x-release-please-start-version -->
27
27
 
28
28
  ```ruby
29
- gem "context.dev", "~> 1.22.0"
29
+ gem "context.dev", "~> 1.24.0"
30
30
  ```
31
31
 
32
32
  <!-- x-release-please-end -->
@@ -23,6 +23,15 @@ module ContextDev
23
23
  # @return [String, nil]
24
24
  optional :domain, String
25
25
 
26
+ # @!attribute max_age_ms
27
+ # Maximum age in milliseconds for cached data before the API performs a hard
28
+ # refresh. Defaults to 3 months (7776000000 ms). Values below 1 day (86400000 ms)
29
+ # are clamped to 1 day; values above 1 year (31536000000 ms) are clamped to 1
30
+ # year.
31
+ #
32
+ # @return [Integer, nil]
33
+ optional :max_age_ms, Integer
34
+
26
35
  # @!attribute timeout_ms
27
36
  # Optional timeout in milliseconds for the request. If the request takes longer
28
37
  # than this value, it will be aborted with a 408 status code. Maximum allowed
@@ -31,7 +40,7 @@ module ContextDev
31
40
  # @return [Integer, nil]
32
41
  optional :timeout_ms, Integer
33
42
 
34
- # @!method initialize(direct_url: nil, domain: nil, timeout_ms: nil, request_options: {})
43
+ # @!method initialize(direct_url: nil, domain: nil, max_age_ms: nil, timeout_ms: nil, request_options: {})
35
44
  # Some parameter documentations has been truncated, see
36
45
  # {ContextDev::Models::WebExtractFontsParams} for more details.
37
46
  #
@@ -39,6 +48,8 @@ module ContextDev
39
48
  #
40
49
  # @param domain [String] Domain name to extract fonts from (e.g., 'example.com', 'google.com'). The domai
41
50
  #
51
+ # @param max_age_ms [Integer] Maximum age in milliseconds for cached data before the API performs a hard refre
52
+ #
42
53
  # @param timeout_ms [Integer] Optional timeout in milliseconds for the request. If the request takes longer th
43
54
  #
44
55
  # @param request_options [ContextDev::RequestOptions, Hash{Symbol=>Object}]
@@ -24,6 +24,15 @@ module ContextDev
24
24
  # @return [String, nil]
25
25
  optional :domain, String
26
26
 
27
+ # @!attribute max_age_ms
28
+ # Maximum age in milliseconds for cached data before the API performs a hard
29
+ # refresh. Defaults to 3 months (7776000000 ms). Values below 1 day (86400000 ms)
30
+ # are clamped to 1 day; values above 1 year (31536000000 ms) are clamped to 1
31
+ # year.
32
+ #
33
+ # @return [Integer, nil]
34
+ optional :max_age_ms, Integer
35
+
27
36
  # @!attribute timeout_ms
28
37
  # Optional timeout in milliseconds for the request. If the request takes longer
29
38
  # than this value, it will be aborted with a 408 status code. Maximum allowed
@@ -32,7 +41,7 @@ module ContextDev
32
41
  # @return [Integer, nil]
33
42
  optional :timeout_ms, Integer
34
43
 
35
- # @!method initialize(direct_url: nil, domain: nil, timeout_ms: nil, request_options: {})
44
+ # @!method initialize(direct_url: nil, domain: nil, max_age_ms: nil, timeout_ms: nil, request_options: {})
36
45
  # Some parameter documentations has been truncated, see
37
46
  # {ContextDev::Models::WebExtractStyleguideParams} for more details.
38
47
  #
@@ -40,6 +49,8 @@ module ContextDev
40
49
  #
41
50
  # @param domain [String] Domain name to extract styleguide from (e.g., 'example.com', 'google.com'). The
42
51
  #
52
+ # @param max_age_ms [Integer] Maximum age in milliseconds for cached data before the API performs a hard refre
53
+ #
43
54
  # @param timeout_ms [Integer] Optional timeout in milliseconds for the request. If the request takes longer th
44
55
  #
45
56
  # @param request_options [ContextDev::RequestOptions, Hash{Symbol=>Object}]
@@ -9,12 +9,14 @@ module ContextDev
9
9
  # Scrape font information from a website including font families, usage
10
10
  # statistics, fallbacks, and element/word counts.
11
11
  #
12
- # @overload extract_fonts(direct_url: nil, domain: nil, timeout_ms: nil, request_options: {})
12
+ # @overload extract_fonts(direct_url: nil, domain: nil, max_age_ms: nil, timeout_ms: nil, request_options: {})
13
13
  #
14
14
  # @param direct_url [String] A specific URL to fetch fonts from directly, bypassing domain resolution (e.g.,
15
15
  #
16
16
  # @param domain [String] Domain name to extract fonts from (e.g., 'example.com', 'google.com'). The domai
17
17
  #
18
+ # @param max_age_ms [Integer] Maximum age in milliseconds for cached data before the API performs a hard refre
19
+ #
18
20
  # @param timeout_ms [Integer] Optional timeout in milliseconds for the request. If the request takes longer th
19
21
  #
20
22
  # @param request_options [ContextDev::RequestOptions, Hash{Symbol=>Object}, nil]
@@ -28,7 +30,11 @@ module ContextDev
28
30
  @client.request(
29
31
  method: :get,
30
32
  path: "web/fonts",
31
- query: query.transform_keys(direct_url: "directUrl", timeout_ms: "timeoutMS"),
33
+ query: query.transform_keys(
34
+ direct_url: "directUrl",
35
+ max_age_ms: "maxAgeMs",
36
+ timeout_ms: "timeoutMS"
37
+ ),
32
38
  model: ContextDev::Models::WebExtractFontsResponse,
33
39
  options: options
34
40
  )
@@ -40,12 +46,14 @@ module ContextDev
40
46
  # Extract a comprehensive design system from a website including colors,
41
47
  # typography, spacing, shadows, and UI components.
42
48
  #
43
- # @overload extract_styleguide(direct_url: nil, domain: nil, timeout_ms: nil, request_options: {})
49
+ # @overload extract_styleguide(direct_url: nil, domain: nil, max_age_ms: nil, timeout_ms: nil, request_options: {})
44
50
  #
45
51
  # @param direct_url [String] A specific URL to fetch the styleguide from directly, bypassing domain resolutio
46
52
  #
47
53
  # @param domain [String] Domain name to extract styleguide from (e.g., 'example.com', 'google.com'). The
48
54
  #
55
+ # @param max_age_ms [Integer] Maximum age in milliseconds for cached data before the API performs a hard refre
56
+ #
49
57
  # @param timeout_ms [Integer] Optional timeout in milliseconds for the request. If the request takes longer th
50
58
  #
51
59
  # @param request_options [ContextDev::RequestOptions, Hash{Symbol=>Object}, nil]
@@ -59,7 +67,11 @@ module ContextDev
59
67
  @client.request(
60
68
  method: :get,
61
69
  path: "web/styleguide",
62
- query: query.transform_keys(direct_url: "directUrl", timeout_ms: "timeoutMS"),
70
+ query: query.transform_keys(
71
+ direct_url: "directUrl",
72
+ max_age_ms: "maxAgeMs",
73
+ timeout_ms: "timeoutMS"
74
+ ),
63
75
  model: ContextDev::Models::WebExtractStyleguideResponse,
64
76
  options: options
65
77
  )
@@ -251,8 +263,8 @@ module ContextDev
251
263
  #
252
264
  # Extract image assets from a web page, including standard URLs, inline SVGs, data
253
265
  # URIs, responsive image sources, metadata, CSS backgrounds, video posters, and
254
- # embeds. The base request costs 1 credit; enrichment costs 1 credit per returned
255
- # image.
266
+ # embeds. The base request costs 1 credit. When enrichment is enabled, the entire
267
+ # call costs 5 credits.
256
268
  #
257
269
  # @overload web_scrape_images(url:, enrichment: nil, max_age_ms: nil, timeout_ms: nil, wait_for_ms: nil, request_options: {})
258
270
  #
@@ -1,5 +1,5 @@
1
1
  # frozen_string_literal: true
2
2
 
3
3
  module ContextDev
4
- VERSION = "1.22.0"
4
+ VERSION = "1.24.0"
5
5
  end
@@ -32,6 +32,16 @@ module ContextDev
32
32
  sig { params(domain: String).void }
33
33
  attr_writer :domain
34
34
 
35
+ # Maximum age in milliseconds for cached data before the API performs a hard
36
+ # refresh. Defaults to 3 months (7776000000 ms). Values below 1 day (86400000 ms)
37
+ # are clamped to 1 day; values above 1 year (31536000000 ms) are clamped to 1
38
+ # year.
39
+ sig { returns(T.nilable(Integer)) }
40
+ attr_reader :max_age_ms
41
+
42
+ sig { params(max_age_ms: Integer).void }
43
+ attr_writer :max_age_ms
44
+
35
45
  # Optional timeout in milliseconds for the request. If the request takes longer
36
46
  # than this value, it will be aborted with a 408 status code. Maximum allowed
37
47
  # value is 300000ms (5 minutes).
@@ -45,6 +55,7 @@ module ContextDev
45
55
  params(
46
56
  direct_url: String,
47
57
  domain: String,
58
+ max_age_ms: Integer,
48
59
  timeout_ms: Integer,
49
60
  request_options: ContextDev::RequestOptions::OrHash
50
61
  ).returns(T.attached_class)
@@ -58,6 +69,11 @@ module ContextDev
58
69
  # domain will be automatically normalized and validated. You must provide either
59
70
  # 'domain' or 'directUrl', but not both.
60
71
  domain: nil,
72
+ # Maximum age in milliseconds for cached data before the API performs a hard
73
+ # refresh. Defaults to 3 months (7776000000 ms). Values below 1 day (86400000 ms)
74
+ # are clamped to 1 day; values above 1 year (31536000000 ms) are clamped to 1
75
+ # year.
76
+ max_age_ms: nil,
61
77
  # Optional timeout in milliseconds for the request. If the request takes longer
62
78
  # than this value, it will be aborted with a 408 status code. Maximum allowed
63
79
  # value is 300000ms (5 minutes).
@@ -71,6 +87,7 @@ module ContextDev
71
87
  {
72
88
  direct_url: String,
73
89
  domain: String,
90
+ max_age_ms: Integer,
74
91
  timeout_ms: Integer,
75
92
  request_options: ContextDev::RequestOptions
76
93
  }
@@ -33,6 +33,16 @@ module ContextDev
33
33
  sig { params(domain: String).void }
34
34
  attr_writer :domain
35
35
 
36
+ # Maximum age in milliseconds for cached data before the API performs a hard
37
+ # refresh. Defaults to 3 months (7776000000 ms). Values below 1 day (86400000 ms)
38
+ # are clamped to 1 day; values above 1 year (31536000000 ms) are clamped to 1
39
+ # year.
40
+ sig { returns(T.nilable(Integer)) }
41
+ attr_reader :max_age_ms
42
+
43
+ sig { params(max_age_ms: Integer).void }
44
+ attr_writer :max_age_ms
45
+
36
46
  # Optional timeout in milliseconds for the request. If the request takes longer
37
47
  # than this value, it will be aborted with a 408 status code. Maximum allowed
38
48
  # value is 300000ms (5 minutes).
@@ -46,6 +56,7 @@ module ContextDev
46
56
  params(
47
57
  direct_url: String,
48
58
  domain: String,
59
+ max_age_ms: Integer,
49
60
  timeout_ms: Integer,
50
61
  request_options: ContextDev::RequestOptions::OrHash
51
62
  ).returns(T.attached_class)
@@ -60,6 +71,11 @@ module ContextDev
60
71
  # domain will be automatically normalized and validated. You must provide either
61
72
  # 'domain' or 'directUrl', but not both.
62
73
  domain: nil,
74
+ # Maximum age in milliseconds for cached data before the API performs a hard
75
+ # refresh. Defaults to 3 months (7776000000 ms). Values below 1 day (86400000 ms)
76
+ # are clamped to 1 day; values above 1 year (31536000000 ms) are clamped to 1
77
+ # year.
78
+ max_age_ms: nil,
63
79
  # Optional timeout in milliseconds for the request. If the request takes longer
64
80
  # than this value, it will be aborted with a 408 status code. Maximum allowed
65
81
  # value is 300000ms (5 minutes).
@@ -73,6 +89,7 @@ module ContextDev
73
89
  {
74
90
  direct_url: String,
75
91
  domain: String,
92
+ max_age_ms: Integer,
76
93
  timeout_ms: Integer,
77
94
  request_options: ContextDev::RequestOptions
78
95
  }
@@ -9,6 +9,7 @@ module ContextDev
9
9
  params(
10
10
  direct_url: String,
11
11
  domain: String,
12
+ max_age_ms: Integer,
12
13
  timeout_ms: Integer,
13
14
  request_options: ContextDev::RequestOptions::OrHash
14
15
  ).returns(ContextDev::Models::WebExtractFontsResponse)
@@ -22,6 +23,11 @@ module ContextDev
22
23
  # domain will be automatically normalized and validated. You must provide either
23
24
  # 'domain' or 'directUrl', but not both.
24
25
  domain: nil,
26
+ # Maximum age in milliseconds for cached data before the API performs a hard
27
+ # refresh. Defaults to 3 months (7776000000 ms). Values below 1 day (86400000 ms)
28
+ # are clamped to 1 day; values above 1 year (31536000000 ms) are clamped to 1
29
+ # year.
30
+ max_age_ms: nil,
25
31
  # Optional timeout in milliseconds for the request. If the request takes longer
26
32
  # than this value, it will be aborted with a 408 status code. Maximum allowed
27
33
  # value is 300000ms (5 minutes).
@@ -36,6 +42,7 @@ module ContextDev
36
42
  params(
37
43
  direct_url: String,
38
44
  domain: String,
45
+ max_age_ms: Integer,
39
46
  timeout_ms: Integer,
40
47
  request_options: ContextDev::RequestOptions::OrHash
41
48
  ).returns(ContextDev::Models::WebExtractStyleguideResponse)
@@ -50,6 +57,11 @@ module ContextDev
50
57
  # domain will be automatically normalized and validated. You must provide either
51
58
  # 'domain' or 'directUrl', but not both.
52
59
  domain: nil,
60
+ # Maximum age in milliseconds for cached data before the API performs a hard
61
+ # refresh. Defaults to 3 months (7776000000 ms). Values below 1 day (86400000 ms)
62
+ # are clamped to 1 day; values above 1 year (31536000000 ms) are clamped to 1
63
+ # year.
64
+ max_age_ms: nil,
53
65
  # Optional timeout in milliseconds for the request. If the request takes longer
54
66
  # than this value, it will be aborted with a 408 status code. Maximum allowed
55
67
  # value is 300000ms (5 minutes).
@@ -260,8 +272,8 @@ module ContextDev
260
272
 
261
273
  # Extract image assets from a web page, including standard URLs, inline SVGs, data
262
274
  # URIs, responsive image sources, metadata, CSS backgrounds, video posters, and
263
- # embeds. The base request costs 1 credit; enrichment costs 1 credit per returned
264
- # image.
275
+ # embeds. The base request costs 1 credit. When enrichment is enabled, the entire
276
+ # call costs 5 credits.
265
277
  sig do
266
278
  params(
267
279
  url: String,
@@ -1,7 +1,12 @@
1
1
  module ContextDev
2
2
  module Models
3
3
  type web_extract_fonts_params =
4
- { direct_url: String, domain: String, timeout_ms: Integer }
4
+ {
5
+ direct_url: String,
6
+ domain: String,
7
+ max_age_ms: Integer,
8
+ timeout_ms: Integer
9
+ }
5
10
  & ContextDev::Internal::Type::request_parameters
6
11
 
7
12
  class WebExtractFontsParams < ContextDev::Internal::Type::BaseModel
@@ -16,6 +21,10 @@ module ContextDev
16
21
 
17
22
  def domain=: (String) -> String
18
23
 
24
+ attr_reader max_age_ms: Integer?
25
+
26
+ def max_age_ms=: (Integer) -> Integer
27
+
19
28
  attr_reader timeout_ms: Integer?
20
29
 
21
30
  def timeout_ms=: (Integer) -> Integer
@@ -23,6 +32,7 @@ module ContextDev
23
32
  def initialize: (
24
33
  ?direct_url: String,
25
34
  ?domain: String,
35
+ ?max_age_ms: Integer,
26
36
  ?timeout_ms: Integer,
27
37
  ?request_options: ContextDev::request_opts
28
38
  ) -> void
@@ -30,6 +40,7 @@ module ContextDev
30
40
  def to_hash: -> {
31
41
  direct_url: String,
32
42
  domain: String,
43
+ max_age_ms: Integer,
33
44
  timeout_ms: Integer,
34
45
  request_options: ContextDev::RequestOptions
35
46
  }
@@ -1,7 +1,12 @@
1
1
  module ContextDev
2
2
  module Models
3
3
  type web_extract_styleguide_params =
4
- { direct_url: String, domain: String, timeout_ms: Integer }
4
+ {
5
+ direct_url: String,
6
+ domain: String,
7
+ max_age_ms: Integer,
8
+ timeout_ms: Integer
9
+ }
5
10
  & ContextDev::Internal::Type::request_parameters
6
11
 
7
12
  class WebExtractStyleguideParams < ContextDev::Internal::Type::BaseModel
@@ -16,6 +21,10 @@ module ContextDev
16
21
 
17
22
  def domain=: (String) -> String
18
23
 
24
+ attr_reader max_age_ms: Integer?
25
+
26
+ def max_age_ms=: (Integer) -> Integer
27
+
19
28
  attr_reader timeout_ms: Integer?
20
29
 
21
30
  def timeout_ms=: (Integer) -> Integer
@@ -23,6 +32,7 @@ module ContextDev
23
32
  def initialize: (
24
33
  ?direct_url: String,
25
34
  ?domain: String,
35
+ ?max_age_ms: Integer,
26
36
  ?timeout_ms: Integer,
27
37
  ?request_options: ContextDev::request_opts
28
38
  ) -> void
@@ -30,6 +40,7 @@ module ContextDev
30
40
  def to_hash: -> {
31
41
  direct_url: String,
32
42
  domain: String,
43
+ max_age_ms: Integer,
33
44
  timeout_ms: Integer,
34
45
  request_options: ContextDev::RequestOptions
35
46
  }
@@ -4,6 +4,7 @@ module ContextDev
4
4
  def extract_fonts: (
5
5
  ?direct_url: String,
6
6
  ?domain: String,
7
+ ?max_age_ms: Integer,
7
8
  ?timeout_ms: Integer,
8
9
  ?request_options: ContextDev::request_opts
9
10
  ) -> ContextDev::Models::WebExtractFontsResponse
@@ -11,6 +12,7 @@ module ContextDev
11
12
  def extract_styleguide: (
12
13
  ?direct_url: String,
13
14
  ?domain: String,
15
+ ?max_age_ms: Integer,
14
16
  ?timeout_ms: Integer,
15
17
  ?request_options: ContextDev::request_opts
16
18
  ) -> ContextDev::Models::WebExtractStyleguideResponse
metadata CHANGED
@@ -1,14 +1,14 @@
1
1
  --- !ruby/object:Gem::Specification
2
2
  name: context.dev
3
3
  version: !ruby/object:Gem::Version
4
- version: 1.22.0
4
+ version: 1.24.0
5
5
  platform: ruby
6
6
  authors:
7
7
  - Context Dev
8
8
  autorequire:
9
9
  bindir: bin
10
10
  cert_chain: []
11
- date: 2026-05-16 00:00:00.000000000 Z
11
+ date: 2026-05-30 00:00:00.000000000 Z
12
12
  dependencies:
13
13
  - !ruby/object:Gem::Dependency
14
14
  name: cgi