@onkernel/sdk 0.74.0 → 0.76.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.
Files changed (57) hide show
  1. package/CHANGELOG.md +29 -0
  2. package/package.json +1 -1
  3. package/resources/api-keys.d.mts +2 -1
  4. package/resources/api-keys.d.mts.map +1 -1
  5. package/resources/api-keys.d.ts +2 -1
  6. package/resources/api-keys.d.ts.map +1 -1
  7. package/resources/api-keys.js +2 -1
  8. package/resources/api-keys.js.map +1 -1
  9. package/resources/api-keys.mjs +2 -1
  10. package/resources/api-keys.mjs.map +1 -1
  11. package/resources/apps.d.mts +3 -1
  12. package/resources/apps.d.mts.map +1 -1
  13. package/resources/apps.d.ts +3 -1
  14. package/resources/apps.d.ts.map +1 -1
  15. package/resources/browser-pools.d.mts +75 -40
  16. package/resources/browser-pools.d.mts.map +1 -1
  17. package/resources/browser-pools.d.ts +75 -40
  18. package/resources/browser-pools.d.ts.map +1 -1
  19. package/resources/browser-pools.js +3 -1
  20. package/resources/browser-pools.js.map +1 -1
  21. package/resources/browser-pools.mjs +3 -1
  22. package/resources/browser-pools.mjs.map +1 -1
  23. package/resources/browsers/browsers.d.mts +34 -16
  24. package/resources/browsers/browsers.d.mts.map +1 -1
  25. package/resources/browsers/browsers.d.ts +34 -16
  26. package/resources/browsers/browsers.d.ts.map +1 -1
  27. package/resources/browsers/browsers.js.map +1 -1
  28. package/resources/browsers/browsers.mjs.map +1 -1
  29. package/resources/browsers/telemetry.d.mts +8 -8
  30. package/resources/browsers/telemetry.d.mts.map +1 -1
  31. package/resources/browsers/telemetry.d.ts +8 -8
  32. package/resources/browsers/telemetry.d.ts.map +1 -1
  33. package/resources/credentials.d.mts +16 -0
  34. package/resources/credentials.d.mts.map +1 -1
  35. package/resources/credentials.d.ts +16 -0
  36. package/resources/credentials.d.ts.map +1 -1
  37. package/resources/deployments.d.mts +14 -5
  38. package/resources/deployments.d.mts.map +1 -1
  39. package/resources/deployments.d.ts +14 -5
  40. package/resources/deployments.d.ts.map +1 -1
  41. package/resources/extensions.d.mts +24 -0
  42. package/resources/extensions.d.mts.map +1 -1
  43. package/resources/extensions.d.ts +24 -0
  44. package/resources/extensions.d.ts.map +1 -1
  45. package/src/resources/api-keys.ts +2 -1
  46. package/src/resources/apps.ts +3 -1
  47. package/src/resources/browser-pools.ts +80 -40
  48. package/src/resources/browsers/browsers.ts +34 -16
  49. package/src/resources/browsers/telemetry.ts +8 -8
  50. package/src/resources/credentials.ts +19 -0
  51. package/src/resources/deployments.ts +14 -5
  52. package/src/resources/extensions.ts +27 -0
  53. package/src/version.ts +1 -1
  54. package/version.d.mts +1 -1
  55. package/version.d.ts +1 -1
  56. package/version.js +1 -1
  57. package/version.mjs +1 -1
@@ -98,6 +98,14 @@ export interface ExtensionListResponse {
98
98
  * Size of the extension archive in bytes
99
99
  */
100
100
  size_bytes: number;
101
+ /**
102
+ * SHA-256 checksum, encoded as lowercase hexadecimal, of the exact uploaded
103
+ * extension archive bytes. This is not a normalized checksum of the extension
104
+ * contents; archive metadata, file ordering, and compression can change the
105
+ * checksum for otherwise identical contents. Omitted for legacy rows and
106
+ * server-repackaged Chrome Web Store extensions.
107
+ */
108
+ checksum?: string | null;
101
109
  /**
102
110
  * Timestamp when the extension was last used
103
111
  */
@@ -124,6 +132,14 @@ export interface ExtensionGetResponse {
124
132
  * Size of the extension archive in bytes
125
133
  */
126
134
  size_bytes: number;
135
+ /**
136
+ * SHA-256 checksum, encoded as lowercase hexadecimal, of the exact uploaded
137
+ * extension archive bytes. This is not a normalized checksum of the extension
138
+ * contents; archive metadata, file ordering, and compression can change the
139
+ * checksum for otherwise identical contents. Omitted for legacy rows and
140
+ * server-repackaged Chrome Web Store extensions.
141
+ */
142
+ checksum?: string | null;
127
143
  /**
128
144
  * Timestamp when the extension was last used
129
145
  */
@@ -150,6 +166,14 @@ export interface ExtensionUploadResponse {
150
166
  * Size of the extension archive in bytes
151
167
  */
152
168
  size_bytes: number;
169
+ /**
170
+ * SHA-256 checksum, encoded as lowercase hexadecimal, of the exact uploaded
171
+ * extension archive bytes. This is not a normalized checksum of the extension
172
+ * contents; archive metadata, file ordering, and compression can change the
173
+ * checksum for otherwise identical contents. Omitted for legacy rows and
174
+ * server-repackaged Chrome Web Store extensions.
175
+ */
176
+ checksum?: string | null;
153
177
  /**
154
178
  * Timestamp when the extension was last used
155
179
  */
@@ -1 +1 @@
1
- {"version":3,"file":"extensions.d.ts","sourceRoot":"","sources":["../src/resources/extensions.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"extensions.d.ts","sourceRoot":"","sources":["../src/resources/extensions.ts"],"names":[],"mappings":"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"}
@@ -75,7 +75,8 @@ export class APIKeys extends APIResource {
75
75
  }
76
76
 
77
77
  /**
78
- * Delete an API key.
78
+ * Delete an API key. A key cannot delete itself; use a different key to delete
79
+ * this one.
79
80
  *
80
81
  * @example
81
82
  * ```ts
@@ -47,7 +47,9 @@ export interface AppListResponse {
47
47
  deployment: string;
48
48
 
49
49
  /**
50
- * Environment variables configured for this app version
50
+ * Environment variables configured for this app version. Values are redacted for
51
+ * API key, OAuth, and managed-auth callers, which receive every key with an empty
52
+ * string value. Only dashboard sessions receive the actual values.
51
53
  */
52
54
  env_vars: { [key: string]: string };
53
55
 
@@ -48,7 +48,9 @@ export class BrowserPools extends APIResource {
48
48
  /**
49
49
  * Updates the configuration used to create browsers in the pool. As with creation,
50
50
  * save_changes on the pool profile is ignored (not rejected); pooled browsers
51
- * never persist changes back to the profile.
51
+ * never persist changes back to the profile. To clear the profile reference, send
52
+ * `profile: { "id": "" }`. Clearing the profile also disables
53
+ * `refresh_on_profile_update`.
52
54
  *
53
55
  * @example
54
56
  * ```ts
@@ -186,10 +188,26 @@ export interface BrowserPool {
186
188
  */
187
189
  created_at: string;
188
190
 
191
+ /**
192
+ * Resolved extension IDs attached to the pool, in configured load order. Empty
193
+ * when no extensions are attached. Authoritative for programmatic consumers; the
194
+ * extensions inside `browser_pool_config` reflect the configured selector (echoed
195
+ * as sent on create).
196
+ */
197
+ extension_ids: Array<string>;
198
+
189
199
  /**
190
200
  * Browser pool name, if set
191
201
  */
192
202
  name?: string;
203
+
204
+ /**
205
+ * Resolved profile ID the pool is attached to. Omitted when no profile is
206
+ * attached. Authoritative for programmatic consumers; the profile inside
207
+ * `browser_pool_config` reflects the configured selector (echoed as sent on
208
+ * create).
209
+ */
210
+ profile_id?: string;
193
211
  }
194
212
 
195
213
  export namespace BrowserPool {
@@ -241,12 +259,11 @@ export namespace BrowserPool {
241
259
  name?: string;
242
260
 
243
261
  /**
244
- * Profile selection for browsers in a pool. Provide either id or name. The
245
- * matching profile is loaded into every browser in the pool. Profiles must be
246
- * created beforehand. Unlike single browser sessions, pools load the profile
247
- * read-only and never persist changes back to it, so save_changes is omitted here.
248
- * Any save_changes value sent on a pool profile is silently ignored rather than
249
- * rejected, so callers reusing a single-session profile object will not error.
262
+ * Profile configuration for browsers in a pool. Provide either id or name.
263
+ * Profiles must be created beforehand. Unlike single browser sessions, pools load
264
+ * the profile read-only and never persist changes back to it, so save_changes is
265
+ * omitted here. Any save_changes value sent on a pool profile is silently ignored
266
+ * rather than rejected.
250
267
  */
251
268
  profile?: BrowserPoolConfig.Profile;
252
269
 
@@ -256,6 +273,13 @@ export namespace BrowserPool {
256
273
  */
257
274
  proxy_id?: string;
258
275
 
276
+ /**
277
+ * When true, flush idle browsers when the profile the pool uses is updated, so
278
+ * pool browsers pick up the latest profile data. Requires a profile to be set on
279
+ * the pool.
280
+ */
281
+ refresh_on_profile_update?: boolean;
282
+
259
283
  /**
260
284
  * Optional URL to navigate to when a new browser is warmed into the pool.
261
285
  * Best-effort: failures to navigate do not fail pool fill. Only applied to
@@ -296,12 +320,11 @@ export namespace BrowserPool {
296
320
 
297
321
  export namespace BrowserPoolConfig {
298
322
  /**
299
- * Profile selection for browsers in a pool. Provide either id or name. The
300
- * matching profile is loaded into every browser in the pool. Profiles must be
301
- * created beforehand. Unlike single browser sessions, pools load the profile
302
- * read-only and never persist changes back to it, so save_changes is omitted here.
303
- * Any save_changes value sent on a pool profile is silently ignored rather than
304
- * rejected, so callers reusing a single-session profile object will not error.
323
+ * Profile configuration for browsers in a pool. Provide either id or name.
324
+ * Profiles must be created beforehand. Unlike single browser sessions, pools load
325
+ * the profile read-only and never persist changes back to it, so save_changes is
326
+ * omitted here. Any save_changes value sent on a pool profile is silently ignored
327
+ * rather than rejected.
305
328
  */
306
329
  export interface Profile {
307
330
  /**
@@ -495,12 +518,11 @@ export interface BrowserPoolCreateParams {
495
518
  name?: string;
496
519
 
497
520
  /**
498
- * Profile selection for browsers in a pool. Provide either id or name. The
499
- * matching profile is loaded into every browser in the pool. Profiles must be
500
- * created beforehand. Unlike single browser sessions, pools load the profile
501
- * read-only and never persist changes back to it, so save_changes is omitted here.
502
- * Any save_changes value sent on a pool profile is silently ignored rather than
503
- * rejected, so callers reusing a single-session profile object will not error.
521
+ * Profile configuration for browsers in a pool. Provide either id or name.
522
+ * Profiles must be created beforehand. Unlike single browser sessions, pools load
523
+ * the profile read-only and never persist changes back to it, so save_changes is
524
+ * omitted here. Any save_changes value sent on a pool profile is silently ignored
525
+ * rather than rejected.
504
526
  */
505
527
  profile?: BrowserPoolCreateParams.Profile;
506
528
 
@@ -510,6 +532,13 @@ export interface BrowserPoolCreateParams {
510
532
  */
511
533
  proxy_id?: string;
512
534
 
535
+ /**
536
+ * When true, flush idle browsers when the profile the pool uses is updated, so
537
+ * pool browsers pick up the latest profile data. Requires a profile to be set on
538
+ * the pool.
539
+ */
540
+ refresh_on_profile_update?: boolean;
541
+
513
542
  /**
514
543
  * Optional URL to navigate to when a new browser is warmed into the pool.
515
544
  * Best-effort: failures to navigate do not fail pool fill. Only applied to
@@ -550,12 +579,11 @@ export interface BrowserPoolCreateParams {
550
579
 
551
580
  export namespace BrowserPoolCreateParams {
552
581
  /**
553
- * Profile selection for browsers in a pool. Provide either id or name. The
554
- * matching profile is loaded into every browser in the pool. Profiles must be
555
- * created beforehand. Unlike single browser sessions, pools load the profile
556
- * read-only and never persist changes back to it, so save_changes is omitted here.
557
- * Any save_changes value sent on a pool profile is silently ignored rather than
558
- * rejected, so callers reusing a single-session profile object will not error.
582
+ * Profile configuration for browsers in a pool. Provide either id or name.
583
+ * Profiles must be created beforehand. Unlike single browser sessions, pools load
584
+ * the profile read-only and never persist changes back to it, so save_changes is
585
+ * omitted here. Any save_changes value sent on a pool profile is silently ignored
586
+ * rather than rejected.
559
587
  */
560
588
  export interface Profile {
561
589
  /**
@@ -581,8 +609,12 @@ export interface BrowserPoolUpdateParams {
581
609
  chrome_policy?: { [key: string]: unknown };
582
610
 
583
611
  /**
584
- * Whether to discard all idle browsers and rebuild the pool immediately. Defaults
585
- * to false.
612
+ * Whether to discard all idle browsers and rebuild them immediately with the new
613
+ * configuration. Defaults to false. Only browsers that are idle when the update
614
+ * runs are rebuilt. A browser that is in use during the update keeps its original
615
+ * configuration, and if it is later released with `reuse: true` it returns to the
616
+ * pool with that stale configuration until it is discarded (by this flag on a
617
+ * later update, or by flushing the pool).
586
618
  */
587
619
  discard_all_idle?: boolean;
588
620
 
@@ -615,12 +647,11 @@ export interface BrowserPoolUpdateParams {
615
647
  name?: string;
616
648
 
617
649
  /**
618
- * Profile selection for browsers in a pool. Provide either id or name. The
619
- * matching profile is loaded into every browser in the pool. Profiles must be
620
- * created beforehand. Unlike single browser sessions, pools load the profile
621
- * read-only and never persist changes back to it, so save_changes is omitted here.
622
- * Any save_changes value sent on a pool profile is silently ignored rather than
623
- * rejected, so callers reusing a single-session profile object will not error.
650
+ * Profile configuration for browsers in a pool. Provide either id or name.
651
+ * Profiles must be created beforehand. Unlike single browser sessions, pools load
652
+ * the profile read-only and never persist changes back to it, so save_changes is
653
+ * omitted here. Any save_changes value sent on a pool profile is silently ignored
654
+ * rather than rejected.
624
655
  */
625
656
  profile?: BrowserPoolUpdateParams.Profile;
626
657
 
@@ -630,6 +661,13 @@ export interface BrowserPoolUpdateParams {
630
661
  */
631
662
  proxy_id?: string;
632
663
 
664
+ /**
665
+ * When true, flush idle browsers when the profile the pool uses is updated, so
666
+ * pool browsers pick up the latest profile data. Requires a profile to be set on
667
+ * the pool.
668
+ */
669
+ refresh_on_profile_update?: boolean;
670
+
633
671
  /**
634
672
  * Number of browsers to maintain in the pool. The maximum size is determined by
635
673
  * your organization's pooled sessions limit (the sum of all pool sizes cannot
@@ -677,12 +715,11 @@ export interface BrowserPoolUpdateParams {
677
715
 
678
716
  export namespace BrowserPoolUpdateParams {
679
717
  /**
680
- * Profile selection for browsers in a pool. Provide either id or name. The
681
- * matching profile is loaded into every browser in the pool. Profiles must be
682
- * created beforehand. Unlike single browser sessions, pools load the profile
683
- * read-only and never persist changes back to it, so save_changes is omitted here.
684
- * Any save_changes value sent on a pool profile is silently ignored rather than
685
- * rejected, so callers reusing a single-session profile object will not error.
718
+ * Profile configuration for browsers in a pool. Provide either id or name.
719
+ * Profiles must be created beforehand. Unlike single browser sessions, pools load
720
+ * the profile read-only and never persist changes back to it, so save_changes is
721
+ * omitted here. Any save_changes value sent on a pool profile is silently ignored
722
+ * rather than rejected.
686
723
  */
687
724
  export interface Profile {
688
725
  /**
@@ -752,7 +789,10 @@ export interface BrowserPoolReleaseParams {
752
789
 
753
790
  /**
754
791
  * Whether to reuse the browser instance or destroy it and create a new one.
755
- * Defaults to true.
792
+ * Defaults to true. A reused browser keeps the configuration it was created with,
793
+ * so it does not pick up pool configuration changes made while it was in use.
794
+ * Release with `reuse: false`, or flush the pool afterward, to rebuild it with the
795
+ * current configuration.
756
796
  */
757
797
  reuse?: boolean;
758
798
  }
@@ -1014,18 +1014,27 @@ export namespace BrowserCreateParams {
1014
1014
  */
1015
1015
  export interface Telemetry {
1016
1016
  /**
1017
- * Per-category capture flags. Selection is opt-in: only the categories set to
1018
- * enabled=true are captured; anything omitted is off. If enabled is true and
1019
- * browser is omitted or empty, the default category set is used. A browser config
1020
- * that enables nothing stops capture on update and starts no capture on create.
1017
+ * Per-category capture flags. The operational categories (control, connection,
1018
+ * system, captcha) are captured whenever telemetry is enabled; set one to
1019
+ * enabled=false to opt out. The CDP categories (console, network, page,
1020
+ * interaction) and screenshot are off by default; set enabled=true to opt in. On
1021
+ * create, provided categories layer onto the default set. On update, provided
1022
+ * categories merge onto the session's current config; when no telemetry is active
1023
+ * this falls back to the default set (matching create). If browser is omitted or
1024
+ * empty, the default set is used. A browser config that disables every category
1025
+ * stops capture on update and starts no capture on create.
1021
1026
  */
1022
1027
  browser?: TelemetryAPI.BrowserTelemetryCategoriesConfig;
1023
1028
 
1024
1029
  /**
1025
- * Request shortcut for browser telemetry capture. True enables capture using the
1026
- * default category set unless browser category settings are provided. False stops
1027
- * capture on update and starts no capture on create. enabled=false cannot be
1028
- * combined with browser category settings.
1030
+ * Request shortcut for browser telemetry capture. True enables capture; with no
1031
+ * browser category settings it captures the default set (control, connection,
1032
+ * system, captcha), and any browser category settings are layered onto that
1033
+ * default set. On update, enabled=true resolves the config fresh from the default
1034
+ * set plus any provided categories, replacing the session's current selection
1035
+ * rather than merging onto it; omit enabled to merge categories onto the current
1036
+ * selection instead. False stops capture on update and starts no capture on
1037
+ * create. enabled=false cannot be combined with browser category settings.
1029
1038
  */
1030
1039
  enabled?: boolean;
1031
1040
  }
@@ -1096,18 +1105,27 @@ export namespace BrowserUpdateParams {
1096
1105
  */
1097
1106
  export interface Telemetry {
1098
1107
  /**
1099
- * Per-category capture flags. Selection is opt-in: only the categories set to
1100
- * enabled=true are captured; anything omitted is off. If enabled is true and
1101
- * browser is omitted or empty, the default category set is used. A browser config
1102
- * that enables nothing stops capture on update and starts no capture on create.
1108
+ * Per-category capture flags. The operational categories (control, connection,
1109
+ * system, captcha) are captured whenever telemetry is enabled; set one to
1110
+ * enabled=false to opt out. The CDP categories (console, network, page,
1111
+ * interaction) and screenshot are off by default; set enabled=true to opt in. On
1112
+ * create, provided categories layer onto the default set. On update, provided
1113
+ * categories merge onto the session's current config; when no telemetry is active
1114
+ * this falls back to the default set (matching create). If browser is omitted or
1115
+ * empty, the default set is used. A browser config that disables every category
1116
+ * stops capture on update and starts no capture on create.
1103
1117
  */
1104
1118
  browser?: TelemetryAPI.BrowserTelemetryCategoriesConfig;
1105
1119
 
1106
1120
  /**
1107
- * Request shortcut for browser telemetry capture. True enables capture using the
1108
- * default category set unless browser category settings are provided. False stops
1109
- * capture on update and starts no capture on create. enabled=false cannot be
1110
- * combined with browser category settings.
1121
+ * Request shortcut for browser telemetry capture. True enables capture; with no
1122
+ * browser category settings it captures the default set (control, connection,
1123
+ * system, captcha), and any browser category settings are layered onto that
1124
+ * default set. On update, enabled=true resolves the config fresh from the default
1125
+ * set plus any provided categories, replacing the session's current selection
1126
+ * rather than merging onto it; omit enabled to merge categories onto the current
1127
+ * selection instead. False stops capture on update and starts no capture on
1128
+ * create. enabled=false cannot be combined with browser category settings.
1111
1129
  */
1112
1130
  enabled?: boolean;
1113
1131
  }
@@ -1879,12 +1879,11 @@ export namespace BrowserSystemOomKillEvent {
1879
1879
  }
1880
1880
 
1881
1881
  /**
1882
- * Per-category telemetry capture settings. Selection is opt-in: set a category to
1883
- * enabled=true to capture it; anything omitted is off. The default set (used by
1884
- * enabled=true with no per-category settings) is the lightweight operational
1885
- * signals: control, connection, system, captcha. The CDP categories (console,
1886
- * network, page, interaction) and screenshot are off by default and must be opted
1887
- * into.
1882
+ * Per-category telemetry capture settings layered onto the default set. The
1883
+ * operational signals (control, connection, system, captcha) are on by default and
1884
+ * are opt-out: set one to enabled=false to stop capturing it. The CDP categories
1885
+ * (console, network, page, interaction) and screenshot are off by default and are
1886
+ * opt-in: set enabled=true to capture them.
1888
1887
  */
1889
1888
  export interface BrowserTelemetryCategoriesConfig {
1890
1889
  /**
@@ -1948,8 +1947,9 @@ export interface BrowserTelemetryCategoriesConfig {
1948
1947
  */
1949
1948
  export interface BrowserTelemetryCategoryConfig {
1950
1949
  /**
1951
- * Whether this category is captured. Selection is opt-in, so an omitted category
1952
- * is not captured.
1950
+ * Whether this category is captured. Operational categories (control, connection,
1951
+ * system, captcha) default to true; set false to opt out. CDP categories (console,
1952
+ * network, page, interaction) and screenshot default to false; set true to opt in.
1953
1953
  */
1954
1954
  enabled?: boolean;
1955
1955
  }
@@ -202,6 +202,13 @@ export interface Credential {
202
202
  * When the totp_code expires. Only included when totp_code is present.
203
203
  */
204
204
  totp_code_expires_at?: string;
205
+
206
+ /**
207
+ * The field names stored in this credential's values (e.g., username, password).
208
+ * Values themselves are never returned. Included on single-credential responses
209
+ * (create, get by id or name, update); omitted from list responses.
210
+ */
211
+ value_keys?: Array<string>;
205
212
  }
206
213
 
207
214
  /**
@@ -213,6 +220,12 @@ export interface UpdateCredentialRequest {
213
220
  */
214
221
  name?: string;
215
222
 
223
+ /**
224
+ * Field names to remove from the credential's stored values. Removals are applied
225
+ * before `values` are merged, so a key present in both is kept with its new value.
226
+ */
227
+ remove_value_keys?: Array<string>;
228
+
216
229
  /**
217
230
  * If set, indicates this credential should be used with the specified SSO
218
231
  * provider. Set to empty string or null to remove.
@@ -281,6 +294,12 @@ export interface CredentialUpdateParams {
281
294
  */
282
295
  name?: string;
283
296
 
297
+ /**
298
+ * Field names to remove from the credential's stored values. Removals are applied
299
+ * before `values` are merged, so a key present in both is kept with its new value.
300
+ */
301
+ remove_value_keys?: Array<string>;
302
+
284
303
  /**
285
304
  * If set, indicates this credential should be used with the specified SSO
286
305
  * provider. Set to empty string or null to remove.
@@ -159,7 +159,9 @@ export namespace DeploymentStateEvent {
159
159
  entrypoint_rel_path?: string;
160
160
 
161
161
  /**
162
- * Environment variables configured for this deployment
162
+ * Environment variables configured for this deployment. Values are redacted for
163
+ * API key, OAuth, and managed-auth callers, which receive every key with an empty
164
+ * string value. Only dashboard sessions receive the actual values.
163
165
  */
164
166
  env_vars?: { [key: string]: string };
165
167
 
@@ -205,7 +207,9 @@ export interface DeploymentCreateResponse {
205
207
  entrypoint_rel_path?: string;
206
208
 
207
209
  /**
208
- * Environment variables configured for this deployment
210
+ * Environment variables configured for this deployment. Values are redacted for
211
+ * API key, OAuth, and managed-auth callers, which receive every key with an empty
212
+ * string value. Only dashboard sessions receive the actual values.
209
213
  */
210
214
  env_vars?: { [key: string]: string };
211
215
 
@@ -250,7 +254,9 @@ export interface DeploymentRetrieveResponse {
250
254
  entrypoint_rel_path?: string;
251
255
 
252
256
  /**
253
- * Environment variables configured for this deployment
257
+ * Environment variables configured for this deployment. Values are redacted for
258
+ * API key, OAuth, and managed-auth callers, which receive every key with an empty
259
+ * string value. Only dashboard sessions receive the actual values.
254
260
  */
255
261
  env_vars?: { [key: string]: string };
256
262
 
@@ -295,7 +301,9 @@ export interface DeploymentListResponse {
295
301
  entrypoint_rel_path?: string;
296
302
 
297
303
  /**
298
- * Environment variables configured for this deployment
304
+ * Environment variables configured for this deployment. Values are redacted for
305
+ * API key, OAuth, and managed-auth callers, which receive every key with an empty
306
+ * string value. Only dashboard sessions receive the actual values.
299
307
  */
300
308
  env_vars?: { [key: string]: string };
301
309
 
@@ -361,7 +369,8 @@ export namespace DeploymentFollowResponse {
361
369
  version: string;
362
370
 
363
371
  /**
364
- * Environment variables configured for this app version
372
+ * Environment variables configured for this app version. Not currently populated
373
+ * on streamed app_version_summary events.
365
374
  */
366
375
  env_vars?: { [key: string]: string };
367
376
  }
@@ -147,6 +147,15 @@ export interface ExtensionListResponse {
147
147
  */
148
148
  size_bytes: number;
149
149
 
150
+ /**
151
+ * SHA-256 checksum, encoded as lowercase hexadecimal, of the exact uploaded
152
+ * extension archive bytes. This is not a normalized checksum of the extension
153
+ * contents; archive metadata, file ordering, and compression can change the
154
+ * checksum for otherwise identical contents. Omitted for legacy rows and
155
+ * server-repackaged Chrome Web Store extensions.
156
+ */
157
+ checksum?: string | null;
158
+
150
159
  /**
151
160
  * Timestamp when the extension was last used
152
161
  */
@@ -178,6 +187,15 @@ export interface ExtensionGetResponse {
178
187
  */
179
188
  size_bytes: number;
180
189
 
190
+ /**
191
+ * SHA-256 checksum, encoded as lowercase hexadecimal, of the exact uploaded
192
+ * extension archive bytes. This is not a normalized checksum of the extension
193
+ * contents; archive metadata, file ordering, and compression can change the
194
+ * checksum for otherwise identical contents. Omitted for legacy rows and
195
+ * server-repackaged Chrome Web Store extensions.
196
+ */
197
+ checksum?: string | null;
198
+
181
199
  /**
182
200
  * Timestamp when the extension was last used
183
201
  */
@@ -209,6 +227,15 @@ export interface ExtensionUploadResponse {
209
227
  */
210
228
  size_bytes: number;
211
229
 
230
+ /**
231
+ * SHA-256 checksum, encoded as lowercase hexadecimal, of the exact uploaded
232
+ * extension archive bytes. This is not a normalized checksum of the extension
233
+ * contents; archive metadata, file ordering, and compression can change the
234
+ * checksum for otherwise identical contents. Omitted for legacy rows and
235
+ * server-repackaged Chrome Web Store extensions.
236
+ */
237
+ checksum?: string | null;
238
+
212
239
  /**
213
240
  * Timestamp when the extension was last used
214
241
  */
package/src/version.ts CHANGED
@@ -1 +1 @@
1
- export const VERSION = '0.74.0'; // x-release-please-version
1
+ export const VERSION = '0.76.0'; // x-release-please-version
package/version.d.mts CHANGED
@@ -1,2 +1,2 @@
1
- export declare const VERSION = "0.74.0";
1
+ export declare const VERSION = "0.76.0";
2
2
  //# sourceMappingURL=version.d.mts.map
package/version.d.ts CHANGED
@@ -1,2 +1,2 @@
1
- export declare const VERSION = "0.74.0";
1
+ export declare const VERSION = "0.76.0";
2
2
  //# sourceMappingURL=version.d.ts.map
package/version.js CHANGED
@@ -1,5 +1,5 @@
1
1
  "use strict";
2
2
  Object.defineProperty(exports, "__esModule", { value: true });
3
3
  exports.VERSION = void 0;
4
- exports.VERSION = '0.74.0'; // x-release-please-version
4
+ exports.VERSION = '0.76.0'; // x-release-please-version
5
5
  //# sourceMappingURL=version.js.map
package/version.mjs CHANGED
@@ -1,2 +1,2 @@
1
- export const VERSION = '0.74.0'; // x-release-please-version
1
+ export const VERSION = '0.76.0'; // x-release-please-version
2
2
  //# sourceMappingURL=version.mjs.map