@onkernel/sdk 0.19.2 → 0.21.0

package/resources/browser-pools.d.ts

@@ -0,0 +1,438 @@
+import { APIResource } from "../core/resource.js";
+import * as Shared from "./shared.js";
+import * as BrowsersAPI from "./browsers/browsers.js";
+import { APIPromise } from "../core/api-promise.js";
+import { RequestOptions } from "../internal/request-options.js";
+export declare class BrowserPools extends APIResource {
+    /**
+     * Create a new browser pool with the specified configuration and size.
+     *
+     * @example
+     * ```ts
+     * const browserPool = await client.browserPools.create({
+     *   size: 10,
+     * });
+     * ```
+     */
+    create(body: BrowserPoolCreateParams, options?: RequestOptions): APIPromise<BrowserPool>;
+    /**
+     * Retrieve details for a single browser pool by its ID or name.
+     *
+     * @example
+     * ```ts
+     * const browserPool = await client.browserPools.retrieve(
+     *   'id_or_name',
+     * );
+     * ```
+     */
+    retrieve(idOrName: string, options?: RequestOptions): APIPromise<BrowserPool>;
+    /**
+     * Updates the configuration used to create browsers in the pool.
+     *
+     * @example
+     * ```ts
+     * const browserPool = await client.browserPools.update(
+     *   'id_or_name',
+     *   { size: 10 },
+     * );
+     * ```
+     */
+    update(idOrName: string, body: BrowserPoolUpdateParams, options?: RequestOptions): APIPromise<BrowserPool>;
+    /**
+     * List browser pools owned by the caller's organization.
+     *
+     * @example
+     * ```ts
+     * const browserPools = await client.browserPools.list();
+     * ```
+     */
+    list(options?: RequestOptions): APIPromise<BrowserPoolListResponse>;
+    /**
+     * Delete a browser pool and all browsers in it. By default, deletion is blocked if
+     * browsers are currently leased. Use force=true to terminate leased browsers.
+     *
+     * @example
+     * ```ts
+     * await client.browserPools.delete('id_or_name');
+     * ```
+     */
+    delete(idOrName: string, body?: BrowserPoolDeleteParams | null | undefined, options?: RequestOptions): APIPromise<void>;
+    /**
+     * Long-polling endpoint to acquire a browser from the pool. Returns immediately
+     * when a browser is available, or returns 204 No Content when the poll times out.
+     * The client should retry the request to continue waiting for a browser. The
+     * acquired browser will use the pool's timeout_seconds for its idle timeout.
+     *
+     * @example
+     * ```ts
+     * const response = await client.browserPools.acquire(
+     *   'id_or_name',
+     * );
+     * ```
+     */
+    acquire(idOrName: string, body: BrowserPoolAcquireParams, options?: RequestOptions): APIPromise<BrowserPoolAcquireResponse>;
+    /**
+     * Destroys all idle browsers in the pool; leased browsers are not affected.
+     *
+     * @example
+     * ```ts
+     * await client.browserPools.flush('id_or_name');
+     * ```
+     */
+    flush(idOrName: string, options?: RequestOptions): APIPromise<void>;
+    /**
+     * Release a browser back to the pool, optionally recreating the browser instance.
+     *
+     * @example
+     * ```ts
+     * await client.browserPools.release('id_or_name', {
+     *   session_id: 'ts8iy3sg25ibheguyni2lg9t',
+     * });
+     * ```
+     */
+    release(idOrName: string, body: BrowserPoolReleaseParams, options?: RequestOptions): APIPromise<void>;
+}
+/**
+ * A browser pool containing multiple identically configured browsers.
+ */
+export interface BrowserPool {
+    /**
+     * Unique identifier for the browser pool
+     */
+    id: string;
+    /**
+     * Number of browsers currently acquired from the pool
+     */
+    acquired_count: number;
+    /**
+     * Number of browsers currently available in the pool
+     */
+    available_count: number;
+    /**
+     * Configuration used to create all browsers in this pool
+     */
+    browser_pool_config: BrowserPoolRequest;
+    /**
+     * Timestamp when the browser pool was created
+     */
+    created_at: string;
+    /**
+     * Browser pool name, if set
+     */
+    name?: string;
+}
+/**
+ * Request body for acquiring a browser from the pool.
+ */
+export interface BrowserPoolAcquireRequest {
+    /**
+     * Maximum number of seconds to wait for a browser to be available. Defaults to the
+     * calculated time it would take to fill the pool at the currently configured fill
+     * rate.
+     */
+    acquire_timeout_seconds?: number;
+}
+/**
+ * Request body for releasing a browser back to the pool.
+ */
+export interface BrowserPoolReleaseRequest {
+    /**
+     * Browser session ID to release back to the pool
+     */
+    session_id: string;
+    /**
+     * Whether to reuse the browser instance or destroy it and create a new one.
+     * Defaults to true.
+     */
+    reuse?: boolean;
+}
+/**
+ * Parameters for creating a browser pool. All browsers in the pool will be created
+ * with the same configuration.
+ */
+export interface BrowserPoolRequest {
+    /**
+     * Number of browsers to create in the pool
+     */
+    size: number;
+    /**
+     * List of browser extensions to load into the session. Provide each by id or name.
+     */
+    extensions?: Array<Shared.BrowserExtension>;
+    /**
+     * Percentage of the pool to fill per minute. Defaults to 10%.
+     */
+    fill_rate_per_minute?: number;
+    /**
+     * If true, launches the browser using a headless image. Defaults to false.
+     */
+    headless?: boolean;
+    /**
+     * If true, launches the browser in kiosk mode to hide address bar and tabs in live
+     * view.
+     */
+    kiosk_mode?: boolean;
+    /**
+     * Optional name for the browser pool. Must be unique within the organization.
+     */
+    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.
+     * Profiles must be created beforehand.
+     */
+    profile?: Shared.BrowserProfile;
+    /**
+     * Optional proxy to associate to the browser session. Must reference a proxy
+     * belonging to the caller's org.
+     */
+    proxy_id?: string;
+    /**
+     * If true, launches the browser in stealth mode to reduce detection by anti-bot
+     * mechanisms.
+     */
+    stealth?: boolean;
+    /**
+     * Default idle timeout in seconds for browsers acquired from this pool before they
+     * are destroyed. Defaults to 600 seconds if not specified
+     */
+    timeout_seconds?: number;
+    /**
+     * Initial browser window size in pixels with optional refresh rate. If omitted,
+     * image defaults apply (commonly 1024x768@60). Only specific viewport
+     * configurations are supported. The server will reject unsupported combinations.
+     * Supported resolutions are: 2560x1440@10, 1920x1080@25, 1920x1200@25,
+     * 1440x900@25, 1024x768@60, 1200x800@60 If refresh_rate is not provided, it will
+     * be automatically determined from the width and height if they match a supported
+     * configuration exactly. Note: Higher resolutions may affect the responsiveness of
+     * live view browser
+     */
+    viewport?: Shared.BrowserViewport;
+}
+/**
+ * Parameters for updating a browser pool. All browsers in the pool will be created
+ * with the same configuration.
+ */
+export interface BrowserPoolUpdateRequest extends BrowserPoolRequest {
+    /**
+     * Whether to discard all idle browsers and rebuild the pool immediately. Defaults
+     * to true.
+     */
+    discard_all_idle?: boolean;
+}
+export type BrowserPoolListResponse = Array<BrowserPool>;
+export interface BrowserPoolAcquireResponse {
+    /**
+     * Websocket URL for Chrome DevTools Protocol connections to the browser session
+     */
+    cdp_ws_url: string;
+    /**
+     * When the browser session was created.
+     */
+    created_at: string;
+    /**
+     * Whether the browser session is running in headless mode.
+     */
+    headless: boolean;
+    /**
+     * Unique identifier for the browser session
+     */
+    session_id: string;
+    /**
+     * Whether the browser session is running in stealth mode.
+     */
+    stealth: boolean;
+    /**
+     * The number of seconds of inactivity before the browser session is terminated.
+     */
+    timeout_seconds: number;
+    /**
+     * Remote URL for live viewing the browser session. Only available for non-headless
+     * browsers.
+     */
+    browser_live_view_url?: string;
+    /**
+     * When the browser session was soft-deleted. Only present for deleted sessions.
+     */
+    deleted_at?: string;
+    /**
+     * Whether the browser session is running in kiosk mode.
+     */
+    kiosk_mode?: boolean;
+    /**
+     * Optional persistence configuration for the browser session.
+     */
+    persistence?: BrowsersAPI.BrowserPersistence;
+    /**
+     * Browser profile metadata.
+     */
+    profile?: BrowsersAPI.Profile;
+    /**
+     * ID of the proxy associated with this browser session, if any.
+     */
+    proxy_id?: string;
+    /**
+     * Initial browser window size in pixels with optional refresh rate. If omitted,
+     * image defaults apply (commonly 1024x768@60). Only specific viewport
+     * configurations are supported. The server will reject unsupported combinations.
+     * Supported resolutions are: 2560x1440@10, 1920x1080@25, 1920x1200@25,
+     * 1440x900@25, 1024x768@60, 1200x800@60 If refresh_rate is not provided, it will
+     * be automatically determined from the width and height if they match a supported
+     * configuration exactly. Note: Higher resolutions may affect the responsiveness of
+     * live view browser
+     */
+    viewport?: Shared.BrowserViewport;
+}
+export interface BrowserPoolCreateParams {
+    /**
+     * Number of browsers to create in the pool
+     */
+    size: number;
+    /**
+     * List of browser extensions to load into the session. Provide each by id or name.
+     */
+    extensions?: Array<Shared.BrowserExtension>;
+    /**
+     * Percentage of the pool to fill per minute. Defaults to 10%.
+     */
+    fill_rate_per_minute?: number;
+    /**
+     * If true, launches the browser using a headless image. Defaults to false.
+     */
+    headless?: boolean;
+    /**
+     * If true, launches the browser in kiosk mode to hide address bar and tabs in live
+     * view.
+     */
+    kiosk_mode?: boolean;
+    /**
+     * Optional name for the browser pool. Must be unique within the organization.
+     */
+    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.
+     * Profiles must be created beforehand.
+     */
+    profile?: Shared.BrowserProfile;
+    /**
+     * Optional proxy to associate to the browser session. Must reference a proxy
+     * belonging to the caller's org.
+     */
+    proxy_id?: string;
+    /**
+     * If true, launches the browser in stealth mode to reduce detection by anti-bot
+     * mechanisms.
+     */
+    stealth?: boolean;
+    /**
+     * Default idle timeout in seconds for browsers acquired from this pool before they
+     * are destroyed. Defaults to 600 seconds if not specified
+     */
+    timeout_seconds?: number;
+    /**
+     * Initial browser window size in pixels with optional refresh rate. If omitted,
+     * image defaults apply (commonly 1024x768@60). Only specific viewport
+     * configurations are supported. The server will reject unsupported combinations.
+     * Supported resolutions are: 2560x1440@10, 1920x1080@25, 1920x1200@25,
+     * 1440x900@25, 1024x768@60, 1200x800@60 If refresh_rate is not provided, it will
+     * be automatically determined from the width and height if they match a supported
+     * configuration exactly. Note: Higher resolutions may affect the responsiveness of
+     * live view browser
+     */
+    viewport?: Shared.BrowserViewport;
+}
+export interface BrowserPoolUpdateParams {
+    /**
+     * Number of browsers to create in the pool
+     */
+    size: number;
+    /**
+     * Whether to discard all idle browsers and rebuild the pool immediately. Defaults
+     * to true.
+     */
+    discard_all_idle?: boolean;
+    /**
+     * List of browser extensions to load into the session. Provide each by id or name.
+     */
+    extensions?: Array<Shared.BrowserExtension>;
+    /**
+     * Percentage of the pool to fill per minute. Defaults to 10%.
+     */
+    fill_rate_per_minute?: number;
+    /**
+     * If true, launches the browser using a headless image. Defaults to false.
+     */
+    headless?: boolean;
+    /**
+     * If true, launches the browser in kiosk mode to hide address bar and tabs in live
+     * view.
+     */
+    kiosk_mode?: boolean;
+    /**
+     * Optional name for the browser pool. Must be unique within the organization.
+     */
+    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.
+     * Profiles must be created beforehand.
+     */
+    profile?: Shared.BrowserProfile;
+    /**
+     * Optional proxy to associate to the browser session. Must reference a proxy
+     * belonging to the caller's org.
+     */
+    proxy_id?: string;
+    /**
+     * If true, launches the browser in stealth mode to reduce detection by anti-bot
+     * mechanisms.
+     */
+    stealth?: boolean;
+    /**
+     * Default idle timeout in seconds for browsers acquired from this pool before they
+     * are destroyed. Defaults to 600 seconds if not specified
+     */
+    timeout_seconds?: number;
+    /**
+     * Initial browser window size in pixels with optional refresh rate. If omitted,
+     * image defaults apply (commonly 1024x768@60). Only specific viewport
+     * configurations are supported. The server will reject unsupported combinations.
+     * Supported resolutions are: 2560x1440@10, 1920x1080@25, 1920x1200@25,
+     * 1440x900@25, 1024x768@60, 1200x800@60 If refresh_rate is not provided, it will
+     * be automatically determined from the width and height if they match a supported
+     * configuration exactly. Note: Higher resolutions may affect the responsiveness of
+     * live view browser
+     */
+    viewport?: Shared.BrowserViewport;
+}
+export interface BrowserPoolDeleteParams {
+    /**
+     * If true, force delete even if browsers are currently leased. Leased browsers
+     * will be terminated.
+     */
+    force?: boolean;
+}
+export interface BrowserPoolAcquireParams {
+    /**
+     * Maximum number of seconds to wait for a browser to be available. Defaults to the
+     * calculated time it would take to fill the pool at the currently configured fill
+     * rate.
+     */
+    acquire_timeout_seconds?: number;
+}
+export interface BrowserPoolReleaseParams {
+    /**
+     * Browser session ID to release back to the pool
+     */
+    session_id: string;
+    /**
+     * Whether to reuse the browser instance or destroy it and create a new one.
+     * Defaults to true.
+     */
+    reuse?: boolean;
+}
+export declare namespace BrowserPools {
+    export { type BrowserPool as BrowserPool, type BrowserPoolAcquireRequest as BrowserPoolAcquireRequest, type BrowserPoolReleaseRequest as BrowserPoolReleaseRequest, type BrowserPoolRequest as BrowserPoolRequest, type BrowserPoolUpdateRequest as BrowserPoolUpdateRequest, type BrowserPoolListResponse as BrowserPoolListResponse, type BrowserPoolAcquireResponse as BrowserPoolAcquireResponse, type BrowserPoolCreateParams as BrowserPoolCreateParams, type BrowserPoolUpdateParams as BrowserPoolUpdateParams, type BrowserPoolDeleteParams as BrowserPoolDeleteParams, type BrowserPoolAcquireParams as BrowserPoolAcquireParams, type BrowserPoolReleaseParams as BrowserPoolReleaseParams, };
+}
+//# sourceMappingURL=browser-pools.d.ts.map

package/resources/browser-pools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"browser-pools.d.ts","sourceRoot":"","sources":["../src/resources/browser-pools.ts"],"names":[],"mappings":"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"}

package/resources/browser-pools.js

@@ -0,0 +1,125 @@
+"use strict";
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BrowserPools = void 0;
+const resource_1 = require("../core/resource.js");
+const headers_1 = require("../internal/headers.js");
+const path_1 = require("../internal/utils/path.js");
+class BrowserPools extends resource_1.APIResource {
+    /**
+     * Create a new browser pool with the specified configuration and size.
+     *
+     * @example
+     * ```ts
+     * const browserPool = await client.browserPools.create({
+     *   size: 10,
+     * });
+     * ```
+     */
+    create(body, options) {
+        return this._client.post('/browser_pools', { body, ...options });
+    }
+    /**
+     * Retrieve details for a single browser pool by its ID or name.
+     *
+     * @example
+     * ```ts
+     * const browserPool = await client.browserPools.retrieve(
+     *   'id_or_name',
+     * );
+     * ```
+     */
+    retrieve(idOrName, options) {
+        return this._client.get((0, path_1.path) `/browser_pools/${idOrName}`, options);
+    }
+    /**
+     * Updates the configuration used to create browsers in the pool.
+     *
+     * @example
+     * ```ts
+     * const browserPool = await client.browserPools.update(
+     *   'id_or_name',
+     *   { size: 10 },
+     * );
+     * ```
+     */
+    update(idOrName, body, options) {
+        return this._client.patch((0, path_1.path) `/browser_pools/${idOrName}`, { body, ...options });
+    }
+    /**
+     * List browser pools owned by the caller's organization.
+     *
+     * @example
+     * ```ts
+     * const browserPools = await client.browserPools.list();
+     * ```
+     */
+    list(options) {
+        return this._client.get('/browser_pools', options);
+    }
+    /**
+     * Delete a browser pool and all browsers in it. By default, deletion is blocked if
+     * browsers are currently leased. Use force=true to terminate leased browsers.
+     *
+     * @example
+     * ```ts
+     * await client.browserPools.delete('id_or_name');
+     * ```
+     */
+    delete(idOrName, body = {}, options) {
+        return this._client.delete((0, path_1.path) `/browser_pools/${idOrName}`, {
+            body,
+            ...options,
+            headers: (0, headers_1.buildHeaders)([{ Accept: '*/*' }, options?.headers]),
+        });
+    }
+    /**
+     * Long-polling endpoint to acquire a browser from the pool. Returns immediately
+     * when a browser is available, or returns 204 No Content when the poll times out.
+     * The client should retry the request to continue waiting for a browser. The
+     * acquired browser will use the pool's timeout_seconds for its idle timeout.
+     *
+     * @example
+     * ```ts
+     * const response = await client.browserPools.acquire(
+     *   'id_or_name',
+     * );
+     * ```
+     */
+    acquire(idOrName, body, options) {
+        return this._client.post((0, path_1.path) `/browser_pools/${idOrName}/acquire`, { body, ...options });
+    }
+    /**
+     * Destroys all idle browsers in the pool; leased browsers are not affected.
+     *
+     * @example
+     * ```ts
+     * await client.browserPools.flush('id_or_name');
+     * ```
+     */
+    flush(idOrName, options) {
+        return this._client.post((0, path_1.path) `/browser_pools/${idOrName}/flush`, {
+            ...options,
+            headers: (0, headers_1.buildHeaders)([{ Accept: '*/*' }, options?.headers]),
+        });
+    }
+    /**
+     * Release a browser back to the pool, optionally recreating the browser instance.
+     *
+     * @example
+     * ```ts
+     * await client.browserPools.release('id_or_name', {
+     *   session_id: 'ts8iy3sg25ibheguyni2lg9t',
+     * });
+     * ```
+     */
+    release(idOrName, body, options) {
+        return this._client.post((0, path_1.path) `/browser_pools/${idOrName}/release`, {
+            body,
+            ...options,
+            headers: (0, headers_1.buildHeaders)([{ Accept: '*/*' }, options?.headers]),
+        });
+    }
+}
+exports.BrowserPools = BrowserPools;
+//# sourceMappingURL=browser-pools.js.map

package/resources/browser-pools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"browser-pools.js","sourceRoot":"","sources":["../src/resources/browser-pools.ts"],"names":[],"mappings":";AAAA,sFAAsF;;;AAEtF,kDAA+C;AAI/C,oDAAmD;AAEnD,oDAA8C;AAE9C,MAAa,YAAa,SAAQ,sBAAW;IAC3C;;;;;;;;;OASG;IACH,MAAM,CAAC,IAA6B,EAAE,OAAwB;QAC5D,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,gBAAgB,EAAE,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IACnE,CAAC;IAED;;;;;;;;;OASG;IACH,QAAQ,CAAC,QAAgB,EAAE,OAAwB;QACjD,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAA,WAAI,EAAA,kBAAkB,QAAQ,EAAE,EAAE,OAAO,CAAC,CAAC;IACrE,CAAC;IAED;;;;;;;;;;OAUG;IACH,MAAM,CAAC,QAAgB,EAAE,IAA6B,EAAE,OAAwB;QAC9E,OAAO,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,IAAA,WAAI,EAAA,kBAAkB,QAAQ,EAAE,EAAE,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IACpF,CAAC;IAED;;;;;;;OAOG;IACH,IAAI,CAAC,OAAwB;QAC3B,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,gBAAgB,EAAE,OAAO,CAAC,CAAC;IACrD,CAAC;IAED;;;;;;;;OAQG;IACH,MAAM,CACJ,QAAgB,EAChB,OAAmD,EAAE,EACrD,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,IAAA,WAAI,EAAA,kBAAkB,QAAQ,EAAE,EAAE;YAC3D,IAAI;YACJ,GAAG,OAAO;YACV,OAAO,EAAE,IAAA,sBAAY,EAAC,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;SAC7D,CAAC,CAAC;IACL,CAAC;IAED;;;;;;;;;;;;OAYG;IACH,OAAO,CACL,QAAgB,EAChB,IAA8B,EAC9B,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,IAAA,WAAI,EAAA,kBAAkB,QAAQ,UAAU,EAAE,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IAC3F,CAAC;IAED;;;;;;;OAOG;IACH,KAAK,CAAC,QAAgB,EAAE,OAAwB;QAC9C,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,IAAA,WAAI,EAAA,kBAAkB,QAAQ,QAAQ,EAAE;YAC/D,GAAG,OAAO;YACV,OAAO,EAAE,IAAA,sBAAY,EAAC,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;SAC7D,CAAC,CAAC;IACL,CAAC;IAED;;;;;;;;;OASG;IACH,OAAO,CAAC,QAAgB,EAAE,IAA8B,EAAE,OAAwB;QAChF,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,IAAA,WAAI,EAAA,kBAAkB,QAAQ,UAAU,EAAE;YACjE,IAAI;YACJ,GAAG,OAAO;YACV,OAAO,EAAE,IAAA,sBAAY,EAAC,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;SAC7D,CAAC,CAAC;IACL,CAAC;CACF;AAlID,oCAkIC"}

package/resources/browser-pools.mjs

@@ -0,0 +1,121 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+import { APIResource } from "../core/resource.mjs";
+import { buildHeaders } from "../internal/headers.mjs";
+import { path } from "../internal/utils/path.mjs";
+export class BrowserPools extends APIResource {
+    /**
+     * Create a new browser pool with the specified configuration and size.
+     *
+     * @example
+     * ```ts
+     * const browserPool = await client.browserPools.create({
+     *   size: 10,
+     * });
+     * ```
+     */
+    create(body, options) {
+        return this._client.post('/browser_pools', { body, ...options });
+    }
+    /**
+     * Retrieve details for a single browser pool by its ID or name.
+     *
+     * @example
+     * ```ts
+     * const browserPool = await client.browserPools.retrieve(
+     *   'id_or_name',
+     * );
+     * ```
+     */
+    retrieve(idOrName, options) {
+        return this._client.get(path `/browser_pools/${idOrName}`, options);
+    }
+    /**
+     * Updates the configuration used to create browsers in the pool.
+     *
+     * @example
+     * ```ts
+     * const browserPool = await client.browserPools.update(
+     *   'id_or_name',
+     *   { size: 10 },
+     * );
+     * ```
+     */
+    update(idOrName, body, options) {
+        return this._client.patch(path `/browser_pools/${idOrName}`, { body, ...options });
+    }
+    /**
+     * List browser pools owned by the caller's organization.
+     *
+     * @example
+     * ```ts
+     * const browserPools = await client.browserPools.list();
+     * ```
+     */
+    list(options) {
+        return this._client.get('/browser_pools', options);
+    }
+    /**
+     * Delete a browser pool and all browsers in it. By default, deletion is blocked if
+     * browsers are currently leased. Use force=true to terminate leased browsers.
+     *
+     * @example
+     * ```ts
+     * await client.browserPools.delete('id_or_name');
+     * ```
+     */
+    delete(idOrName, body = {}, options) {
+        return this._client.delete(path `/browser_pools/${idOrName}`, {
+            body,
+            ...options,
+            headers: buildHeaders([{ Accept: '*/*' }, options?.headers]),
+        });
+    }
+    /**
+     * Long-polling endpoint to acquire a browser from the pool. Returns immediately
+     * when a browser is available, or returns 204 No Content when the poll times out.
+     * The client should retry the request to continue waiting for a browser. The
+     * acquired browser will use the pool's timeout_seconds for its idle timeout.
+     *
+     * @example
+     * ```ts
+     * const response = await client.browserPools.acquire(
+     *   'id_or_name',
+     * );
+     * ```
+     */
+    acquire(idOrName, body, options) {
+        return this._client.post(path `/browser_pools/${idOrName}/acquire`, { body, ...options });
+    }
+    /**
+     * Destroys all idle browsers in the pool; leased browsers are not affected.
+     *
+     * @example
+     * ```ts
+     * await client.browserPools.flush('id_or_name');
+     * ```
+     */
+    flush(idOrName, options) {
+        return this._client.post(path `/browser_pools/${idOrName}/flush`, {
+            ...options,
+            headers: buildHeaders([{ Accept: '*/*' }, options?.headers]),
+        });
+    }
+    /**
+     * Release a browser back to the pool, optionally recreating the browser instance.
+     *
+     * @example
+     * ```ts
+     * await client.browserPools.release('id_or_name', {
+     *   session_id: 'ts8iy3sg25ibheguyni2lg9t',
+     * });
+     * ```
+     */
+    release(idOrName, body, options) {
+        return this._client.post(path `/browser_pools/${idOrName}/release`, {
+            body,
+            ...options,
+            headers: buildHeaders([{ Accept: '*/*' }, options?.headers]),
+        });
+    }
+}
+//# sourceMappingURL=browser-pools.mjs.map