@onkernel/sdk 0.62.0 → 0.64.0

package/src/internal/qs/utils.ts

@@ -0,0 +1,265 @@
+import { RFC1738 } from './formats';
+import type { DefaultEncoder, Format } from './types';
+import { isArray } from '../utils/values';
+
+export let has = (obj: object, key: PropertyKey): boolean => (
+  (has = (Object as any).hasOwn ?? Function.prototype.call.bind(Object.prototype.hasOwnProperty)),
+  has(obj, key)
+);
+
+const hex_table = /* @__PURE__ */ (() => {
+  const array = [];
+  for (let i = 0; i < 256; ++i) {
+    array.push('%' + ((i < 16 ? '0' : '') + i.toString(16)).toUpperCase());
+  }
+
+  return array;
+})();
+
+function compact_queue<T extends Record<string, any>>(queue: Array<{ obj: T; prop: string }>) {
+  while (queue.length > 1) {
+    const item = queue.pop();
+    if (!item) continue;
+
+    const obj = item.obj[item.prop];
+
+    if (isArray(obj)) {
+      const compacted: unknown[] = [];
+
+      for (let j = 0; j < obj.length; ++j) {
+        if (typeof obj[j] !== 'undefined') {
+          compacted.push(obj[j]);
+        }
+      }
+
+      // @ts-ignore
+      item.obj[item.prop] = compacted;
+    }
+  }
+}
+
+function array_to_object(source: any[], options: { plainObjects: boolean }) {
+  const obj = options && options.plainObjects ? Object.create(null) : {};
+  for (let i = 0; i < source.length; ++i) {
+    if (typeof source[i] !== 'undefined') {
+      obj[i] = source[i];
+    }
+  }
+
+  return obj;
+}
+
+export function merge(
+  target: any,
+  source: any,
+  options: { plainObjects?: boolean; allowPrototypes?: boolean } = {},
+) {
+  if (!source) {
+    return target;
+  }
+
+  if (typeof source !== 'object') {
+    if (isArray(target)) {
+      target.push(source);
+    } else if (target && typeof target === 'object') {
+      if ((options && (options.plainObjects || options.allowPrototypes)) || !has(Object.prototype, source)) {
+        target[source] = true;
+      }
+    } else {
+      return [target, source];
+    }
+
+    return target;
+  }
+
+  if (!target || typeof target !== 'object') {
+    return [target].concat(source);
+  }
+
+  let mergeTarget = target;
+  if (isArray(target) && !isArray(source)) {
+    // @ts-ignore
+    mergeTarget = array_to_object(target, options);
+  }
+
+  if (isArray(target) && isArray(source)) {
+    source.forEach(function (item, i) {
+      if (has(target, i)) {
+        const targetItem = target[i];
+        if (targetItem && typeof targetItem === 'object' && item && typeof item === 'object') {
+          target[i] = merge(targetItem, item, options);
+        } else {
+          target.push(item);
+        }
+      } else {
+        target[i] = item;
+      }
+    });
+    return target;
+  }
+
+  return Object.keys(source).reduce(function (acc, key) {
+    const value = source[key];
+
+    if (has(acc, key)) {
+      acc[key] = merge(acc[key], value, options);
+    } else {
+      acc[key] = value;
+    }
+    return acc;
+  }, mergeTarget);
+}
+
+export function assign_single_source(target: any, source: any) {
+  return Object.keys(source).reduce(function (acc, key) {
+    acc[key] = source[key];
+    return acc;
+  }, target);
+}
+
+export function decode(str: string, _: any, charset: string) {
+  const strWithoutPlus = str.replace(/\+/g, ' ');
+  if (charset === 'iso-8859-1') {
+    // unescape never throws, no try...catch needed:
+    return strWithoutPlus.replace(/%[0-9a-f]{2}/gi, unescape);
+  }
+  // utf-8
+  try {
+    return decodeURIComponent(strWithoutPlus);
+  } catch (e) {
+    return strWithoutPlus;
+  }
+}
+
+const limit = 1024;
+
+export const encode: (
+  str: any,
+  defaultEncoder: DefaultEncoder,
+  charset: string,
+  type: 'key' | 'value',
+  format: Format,
+) => string = (str, _defaultEncoder, charset, _kind, format: Format) => {
+  // This code was originally written by Brian White for the io.js core querystring library.
+  // It has been adapted here for stricter adherence to RFC 3986
+  if (str.length === 0) {
+    return str;
+  }
+
+  let string = str;
+  if (typeof str === 'symbol') {
+    string = Symbol.prototype.toString.call(str);
+  } else if (typeof str !== 'string') {
+    string = String(str);
+  }
+
+  if (charset === 'iso-8859-1') {
+    return escape(string).replace(/%u[0-9a-f]{4}/gi, function ($0) {
+      return '%26%23' + parseInt($0.slice(2), 16) + '%3B';
+    });
+  }
+
+  let out = '';
+  for (let j = 0; j < string.length; j += limit) {
+    const segment = string.length >= limit ? string.slice(j, j + limit) : string;
+    const arr = [];
+
+    for (let i = 0; i < segment.length; ++i) {
+      let c = segment.charCodeAt(i);
+      if (
+        c === 0x2d || // -
+        c === 0x2e || // .
+        c === 0x5f || // _
+        c === 0x7e || // ~
+        (c >= 0x30 && c <= 0x39) || // 0-9
+        (c >= 0x41 && c <= 0x5a) || // a-z
+        (c >= 0x61 && c <= 0x7a) || // A-Z
+        (format === RFC1738 && (c === 0x28 || c === 0x29)) // ( )
+      ) {
+        arr[arr.length] = segment.charAt(i);
+        continue;
+      }
+
+      if (c < 0x80) {
+        arr[arr.length] = hex_table[c];
+        continue;
+      }
+
+      if (c < 0x800) {
+        arr[arr.length] = hex_table[0xc0 | (c >> 6)]! + hex_table[0x80 | (c & 0x3f)];
+        continue;
+      }
+
+      if (c < 0xd800 || c >= 0xe000) {
+        arr[arr.length] =
+          hex_table[0xe0 | (c >> 12)]! + hex_table[0x80 | ((c >> 6) & 0x3f)] + hex_table[0x80 | (c & 0x3f)];
+        continue;
+      }
+
+      i += 1;
+      c = 0x10000 + (((c & 0x3ff) << 10) | (segment.charCodeAt(i) & 0x3ff));
+
+      arr[arr.length] =
+        hex_table[0xf0 | (c >> 18)]! +
+        hex_table[0x80 | ((c >> 12) & 0x3f)] +
+        hex_table[0x80 | ((c >> 6) & 0x3f)] +
+        hex_table[0x80 | (c & 0x3f)];
+    }
+
+    out += arr.join('');
+  }
+
+  return out;
+};
+
+export function compact(value: any) {
+  const queue = [{ obj: { o: value }, prop: 'o' }];
+  const refs = [];
+
+  for (let i = 0; i < queue.length; ++i) {
+    const item = queue[i];
+    // @ts-ignore
+    const obj = item.obj[item.prop];
+
+    const keys = Object.keys(obj);
+    for (let j = 0; j < keys.length; ++j) {
+      const key = keys[j]!;
+      const val = obj[key];
+      if (typeof val === 'object' && val !== null && refs.indexOf(val) === -1) {
+        queue.push({ obj: obj, prop: key });
+        refs.push(val);
+      }
+    }
+  }
+
+  compact_queue(queue);
+
+  return value;
+}
+
+export function is_regexp(obj: any) {
+  return Object.prototype.toString.call(obj) === '[object RegExp]';
+}
+
+export function is_buffer(obj: any) {
+  if (!obj || typeof obj !== 'object') {
+    return false;
+  }
+
+  return !!(obj.constructor && obj.constructor.isBuffer && obj.constructor.isBuffer(obj));
+}
+
+export function combine(a: any, b: any) {
+  return [].concat(a, b);
+}
+
+export function maybe_map<T>(val: T[], fn: (v: T) => T) {
+  if (isArray(val)) {
+    const mapped = [];
+    for (let i = 0; i < val.length; i += 1) {
+      mapped.push(fn(val[i]!));
+    }
+    return mapped;
+  }
+  return fn(val);
+}

package/src/internal/utils/query.ts

@@ -1,23 +1,7 @@
 // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
-import { KernelError } from '../../core/error';
+import * as qs from '../qs/stringify';
 
-/**
- * Basic re-implementation of `qs.stringify` for primitive types.
- */
 export function stringifyQuery(query: object | Record<string, unknown>) {
-  return Object.entries(query)
-    .filter(([_, value]) => typeof value !== 'undefined')
-    .map(([key, value]) => {
-      if (typeof value === 'string' || typeof value === 'number' || typeof value === 'boolean') {
-        return `${encodeURIComponent(key)}=${encodeURIComponent(value)}`;
-      }
-      if (value === null) {
-        return `${encodeURIComponent(key)}=`;
-      }
-      throw new KernelError(
-        `Cannot stringify type ${typeof value}; Expected string, number, boolean, or null. If you need to pass nested query parameters, you can manually encode them, e.g. { query: { 'foo[key1]': value1, 'foo[key2]': value2 } }, and please open a GitHub issue requesting better support for your use case.`,
-      );
-    })
-    .join('&');
+  return qs.stringify(query, { arrayFormat: 'comma' });
 }

package/src/resources/browser-pools.ts

@@ -355,6 +355,11 @@ export interface BrowserPoolAcquireResponse {
    */
   kiosk_mode?: boolean;
 
+  /**
+   * Human-readable name of the browser session, if one was set at creation.
+   */
+  name?: string;
+
   /**
    * Browser pool this session was acquired from, if any.
    */
@@ -379,6 +384,12 @@ export interface BrowserPoolAcquireResponse {
    */
   start_url?: string;
 
+  /**
+   * User-defined key-value tags that were set on this browser session, if any.
+   * Echoed back when present.
+   */
+  tags?: BrowsersAPI.Tags;
+
   /**
    * Active telemetry configuration for the session, if any.
    */

package/src/resources/browsers/browsers.ts

@@ -53,7 +53,11 @@ import {
 } from './replays';
 import * as TelemetryAPI from './telemetry';
 import {
+  BrowserAPICallEvent,
   BrowserCallStack,
+  BrowserCaptchaSolveResultEvent,
+  BrowserCdpConnectEvent,
+  BrowserCdpDisconnectEvent,
   BrowserConsoleErrorEvent,
   BrowserConsoleLogEvent,
   BrowserEventContext,
@@ -62,6 +66,8 @@ import {
   BrowserInteractionClickEvent,
   BrowserInteractionKeyEvent,
   BrowserInteractionScrollSettledEvent,
+  BrowserLiveViewConnectEvent,
+  BrowserLiveViewDisconnectEvent,
   BrowserMonitorDisconnectedEvent,
   BrowserMonitorInitFailedEvent,
   BrowserMonitorReconnectFailedEvent,
@@ -79,6 +85,8 @@ import {
   BrowserPageNavigationEvent,
   BrowserPageNavigationSettledEvent,
   BrowserPageTabOpenedEvent,
+  BrowserServiceCrashedEvent,
+  BrowserSystemOomKillEvent,
   BrowserTelemetryCategoriesConfig,
   BrowserTelemetryCategoryConfig,
   BrowserTelemetryConfig,
@@ -319,6 +327,11 @@ export interface Profile {
   updated_at?: string;
 }
 
+/**
+ * User-defined key-value tags.
+ */
+export type Tags = { [key: string]: string };
+
 export interface BrowserCreateResponse {
   /**
    * Websocket URL for Chrome DevTools Protocol connections to the browser session
@@ -389,6 +402,11 @@ export interface BrowserCreateResponse {
    */
   kiosk_mode?: boolean;
 
+  /**
+   * Human-readable name of the browser session, if one was set at creation.
+   */
+  name?: string;
+
   /**
    * Browser pool this session was acquired from, if any.
    */
@@ -413,6 +431,12 @@ export interface BrowserCreateResponse {
    */
   start_url?: string;
 
+  /**
+   * User-defined key-value tags that were set on this browser session, if any.
+   * Echoed back when present.
+   */
+  tags?: Tags;
+
   /**
    * Active telemetry configuration for the session, if any.
    */
@@ -510,6 +534,11 @@ export interface BrowserRetrieveResponse {
    */
   kiosk_mode?: boolean;
 
+  /**
+   * Human-readable name of the browser session, if one was set at creation.
+   */
+  name?: string;
+
   /**
    * Browser pool this session was acquired from, if any.
    */
@@ -534,6 +563,12 @@ export interface BrowserRetrieveResponse {
    */
   start_url?: string;
 
+  /**
+   * User-defined key-value tags that were set on this browser session, if any.
+   * Echoed back when present.
+   */
+  tags?: Tags;
+
   /**
    * Active telemetry configuration for the session, if any.
    */
@@ -631,6 +666,11 @@ export interface BrowserUpdateResponse {
    */
   kiosk_mode?: boolean;
 
+  /**
+   * Human-readable name of the browser session, if one was set at creation.
+   */
+  name?: string;
+
   /**
    * Browser pool this session was acquired from, if any.
    */
@@ -655,6 +695,12 @@ export interface BrowserUpdateResponse {
    */
   start_url?: string;
 
+  /**
+   * User-defined key-value tags that were set on this browser session, if any.
+   * Echoed back when present.
+   */
+  tags?: Tags;
+
   /**
    * Active telemetry configuration for the session, if any.
    */
@@ -752,6 +798,11 @@ export interface BrowserListResponse {
    */
   kiosk_mode?: boolean;
 
+  /**
+   * Human-readable name of the browser session, if one was set at creation.
+   */
+  name?: string;
+
   /**
    * Browser pool this session was acquired from, if any.
    */
@@ -776,6 +827,12 @@ export interface BrowserListResponse {
    */
   start_url?: string;
 
+  /**
+   * User-defined key-value tags that were set on this browser session, if any.
+   * Echoed back when present.
+   */
+  tags?: Tags;
+
   /**
    * Active telemetry configuration for the session, if any.
    */
@@ -865,6 +922,13 @@ export interface BrowserCreateParams {
    */
   kiosk_mode?: boolean;
 
+  /**
+   * Optional human-readable name for the browser session, used to find it later in
+   * the dashboard. Must be unique among active sessions within the project. Set at
+   * creation time only.
+   */
+  name?: string;
+
   /**
    * Profile selection for the browser session. Provide either id or name. If
    * specified, the matching profile will be loaded into the browser session.
@@ -891,6 +955,12 @@ export interface BrowserCreateParams {
    */
   stealth?: boolean;
 
+  /**
+   * Optional user-defined key-value tags for the browser session, used to find and
+   * group sessions later. Set at creation time only. Up to 50 pairs.
+   */
+  tags?: Tags;
+
   /**
    * Telemetry configuration for the browser session. Set enabled to true to start
    * capture using VM defaults, or provide browser category settings. If omitted,
@@ -936,17 +1006,18 @@ export namespace BrowserCreateParams {
    */
   export interface Telemetry {
     /**
-     * Per-category enable/disable flags. If enabled is true and browser is omitted or
-     * empty, the VM default category set is used. Explicitly disabling all four
-     * categories stops capture on update and starts no capture on create.
+     * Per-category capture flags. Selection is opt-in: only the categories set to
+     * enabled=true are captured; anything omitted is off. If enabled is true and
+     * browser is omitted or empty, the default category set is used. A browser config
+     * that enables nothing stops capture on update and starts no capture on create.
      */
     browser?: TelemetryAPI.BrowserTelemetryCategoriesConfig;
 
     /**
-     * Request shortcut for browser telemetry capture. True enables capture using VM
-     * defaults unless browser category settings are provided. False stops capture on
-     * update and starts no capture on create. enabled=false cannot be combined with
-     * browser category settings.
+     * Request shortcut for browser telemetry capture. True enables capture using the
+     * default category set unless browser category settings are provided. False stops
+     * capture on update and starts no capture on create. enabled=false cannot be
+     * combined with browser category settings.
      */
     enabled?: boolean;
   }
@@ -1003,17 +1074,18 @@ export namespace BrowserUpdateParams {
    */
   export interface Telemetry {
     /**
-     * Per-category enable/disable flags. If enabled is true and browser is omitted or
-     * empty, the VM default category set is used. Explicitly disabling all four
-     * categories stops capture on update and starts no capture on create.
+     * Per-category capture flags. Selection is opt-in: only the categories set to
+     * enabled=true are captured; anything omitted is off. If enabled is true and
+     * browser is omitted or empty, the default category set is used. A browser config
+     * that enables nothing stops capture on update and starts no capture on create.
      */
     browser?: TelemetryAPI.BrowserTelemetryCategoriesConfig;
 
     /**
-     * Request shortcut for browser telemetry capture. True enables capture using VM
-     * defaults unless browser category settings are provided. False stops capture on
-     * update and starts no capture on create. enabled=false cannot be combined with
-     * browser category settings.
+     * Request shortcut for browser telemetry capture. True enables capture using the
+     * default category set unless browser category settings are provided. False stops
+     * capture on update and starts no capture on create. enabled=false cannot be
+     * combined with browser category settings.
      */
     enabled?: boolean;
   }
@@ -1040,7 +1112,7 @@ export interface BrowserListParams extends OffsetPaginationParams {
   include_deleted?: boolean;
 
   /**
-   * Search browsers by session ID, profile ID, proxy ID, or pool name.
+   * Search browsers by name, session ID, profile ID, proxy ID, or pool name.
    */
   query?: string;
 
@@ -1049,6 +1121,13 @@ export interface BrowserListParams extends OffsetPaginationParams {
    * "deleted" returns only soft-deleted sessions, "all" returns both.
    */
   status?: 'active' | 'deleted' | 'all';
+
+  /**
+   * Filter sessions by tag key-value pairs using deepObject style, e.g.
+   * ?tags[team]=backend&tags[env]=staging. Multiple pairs are ANDed: a session must
+   * match every supplied pair exactly.
+   */
+  tags?: { [key: string]: string };
 }
 
 export interface BrowserCurlParams {
@@ -1118,6 +1197,7 @@ export declare namespace Browsers {
     type BrowserPoolRef as BrowserPoolRef,
     type BrowserUsage as BrowserUsage,
     type Profile as Profile,
+    type Tags as Tags,
     type BrowserCreateResponse as BrowserCreateResponse,
     type BrowserRetrieveResponse as BrowserRetrieveResponse,
     type BrowserUpdateResponse as BrowserUpdateResponse,
@@ -1134,7 +1214,11 @@ export declare namespace Browsers {
 
   export {
     TelemetryAPITelemetry as Telemetry,
+    type BrowserAPICallEvent as BrowserAPICallEvent,
     type BrowserCallStack as BrowserCallStack,
+    type BrowserCaptchaSolveResultEvent as BrowserCaptchaSolveResultEvent,
+    type BrowserCdpConnectEvent as BrowserCdpConnectEvent,
+    type BrowserCdpDisconnectEvent as BrowserCdpDisconnectEvent,
     type BrowserConsoleErrorEvent as BrowserConsoleErrorEvent,
     type BrowserConsoleLogEvent as BrowserConsoleLogEvent,
     type BrowserEventContext as BrowserEventContext,
@@ -1143,6 +1227,8 @@ export declare namespace Browsers {
     type BrowserInteractionClickEvent as BrowserInteractionClickEvent,
     type BrowserInteractionKeyEvent as BrowserInteractionKeyEvent,
     type BrowserInteractionScrollSettledEvent as BrowserInteractionScrollSettledEvent,
+    type BrowserLiveViewConnectEvent as BrowserLiveViewConnectEvent,
+    type BrowserLiveViewDisconnectEvent as BrowserLiveViewDisconnectEvent,
     type BrowserMonitorDisconnectedEvent as BrowserMonitorDisconnectedEvent,
     type BrowserMonitorInitFailedEvent as BrowserMonitorInitFailedEvent,
     type BrowserMonitorReconnectFailedEvent as BrowserMonitorReconnectFailedEvent,
@@ -1160,6 +1246,8 @@ export declare namespace Browsers {
     type BrowserPageNavigationEvent as BrowserPageNavigationEvent,
     type BrowserPageNavigationSettledEvent as BrowserPageNavigationSettledEvent,
     type BrowserPageTabOpenedEvent as BrowserPageTabOpenedEvent,
+    type BrowserServiceCrashedEvent as BrowserServiceCrashedEvent,
+    type BrowserSystemOomKillEvent as BrowserSystemOomKillEvent,
     type BrowserTelemetryCategoriesConfig as BrowserTelemetryCategoriesConfig,
     type BrowserTelemetryCategoryConfig as BrowserTelemetryCategoryConfig,
     type BrowserTelemetryConfig as BrowserTelemetryConfig,

package/src/resources/browsers/index.ts

@@ -5,6 +5,7 @@ export {
   type BrowserPoolRef,
   type BrowserUsage,
   type Profile,
+  type Tags,
   type BrowserCreateResponse,
   type BrowserRetrieveResponse,
   type BrowserUpdateResponse,
@@ -81,7 +82,11 @@ export {
 } from './replays';
 export {
   Telemetry,
+  type BrowserAPICallEvent,
   type BrowserCallStack,
+  type BrowserCaptchaSolveResultEvent,
+  type BrowserCdpConnectEvent,
+  type BrowserCdpDisconnectEvent,
   type BrowserConsoleErrorEvent,
   type BrowserConsoleLogEvent,
   type BrowserEventContext,
@@ -90,6 +95,8 @@ export {
   type BrowserInteractionClickEvent,
   type BrowserInteractionKeyEvent,
   type BrowserInteractionScrollSettledEvent,
+  type BrowserLiveViewConnectEvent,
+  type BrowserLiveViewDisconnectEvent,
   type BrowserMonitorDisconnectedEvent,
   type BrowserMonitorInitFailedEvent,
   type BrowserMonitorReconnectFailedEvent,
@@ -107,6 +114,8 @@ export {
   type BrowserPageNavigationEvent,
   type BrowserPageNavigationSettledEvent,
   type BrowserPageTabOpenedEvent,
+  type BrowserServiceCrashedEvent,
+  type BrowserSystemOomKillEvent,
   type BrowserTelemetryCategoriesConfig,
   type BrowserTelemetryCategoryConfig,
   type BrowserTelemetryConfig,