surfsky 0.0.6 → 0.0.9

package/dist/index.d.ts

@@ -45,6 +45,20 @@ declare const regionalPool: z.ZodEnum<{
   western: "western";
   westeurope: "westeurope";
 }>;
+declare const captchaType: z.ZodEnum<{
+  bls: "bls";
+  click: "click";
+  datadome: "datadome";
+  datadome_audio: "datadome_audio";
+  datadome_click: "datadome_click";
+  funcaptcha: "funcaptcha";
+  geetest: "geetest";
+  hcaptcha: "hcaptcha";
+  image: "image";
+  perimeterx: "perimeterx";
+  recaptcha: "recaptcha";
+  turnstile: "turnstile";
+}>;
 type OS = z.infer<typeof os>;
 type Arch = z.infer<typeof arch>;
 type DeviceType = z.infer<typeof deviceType>;
@@ -52,6 +66,7 @@ type WaitUntil = z.infer<typeof waitUntil>;
 type ProxyType = z.infer<typeof proxyType>;
 type ProfileOrdering = z.infer<typeof profileOrdering>;
 type RegionalPool = z.infer<typeof regionalPool>;
+type CaptchaType = z.infer<typeof captchaType>;
 type ExportFormat = "json" | "netscape";
 type MouseButton = "left" | "right" | "middle";
 type KeyModifier = "Alt" | "Control" | "Meta" | "Shift";
@@ -178,6 +193,27 @@ declare const browserSettings: z.ZodObject<{
   cache_key: z.ZodOptional<z.ZodString>;
 }, z.core.$strict>;
 type BrowserSettings = z.infer<typeof browserSettings>;
+declare const antiCaptcha: z.ZodObject<{
+  enabled: z.ZodOptional<z.ZodBoolean>;
+  auto_captcha_types: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+    bls: "bls";
+    click: "click";
+    datadome: "datadome";
+    datadome_audio: "datadome_audio";
+    datadome_click: "datadome_click";
+    funcaptcha: "funcaptcha";
+    geetest: "geetest";
+    hcaptcha: "hcaptcha";
+    image: "image";
+    perimeterx: "perimeterx";
+    recaptcha: "recaptcha";
+    turnstile: "turnstile";
+  }>>>;
+  gemini_api_key: z.ZodOptional<z.ZodString>;
+  disable_external_providers: z.ZodOptional<z.ZodBoolean>;
+  external_providers_initially_enabled: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strict>;
+type AntiCaptcha = z.infer<typeof antiCaptcha>;
 declare const shared: z.ZodObject<{
   tier: z.ZodLiteral<"shared">;
   country: z.ZodOptional<z.ZodString>;
@@ -371,6 +407,26 @@ declare const oneTimeStartRequest: z.ZodObject<{
     cache_enabled: z.ZodOptional<z.ZodBoolean>;
     cache_key: z.ZodOptional<z.ZodString>;
   }, z.core.$strict>>;
+  anti_captcha: z.ZodOptional<z.ZodObject<{
+    enabled: z.ZodOptional<z.ZodBoolean>;
+    auto_captcha_types: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+      bls: "bls";
+      click: "click";
+      datadome: "datadome";
+      datadome_audio: "datadome_audio";
+      datadome_click: "datadome_click";
+      funcaptcha: "funcaptcha";
+      geetest: "geetest";
+      hcaptcha: "hcaptcha";
+      image: "image";
+      perimeterx: "perimeterx";
+      recaptcha: "recaptcha";
+      turnstile: "turnstile";
+    }>>>;
+    gemini_api_key: z.ZodOptional<z.ZodString>;
+    disable_external_providers: z.ZodOptional<z.ZodBoolean>;
+    external_providers_initially_enabled: z.ZodOptional<z.ZodBoolean>;
+  }, z.core.$strict>>;
   enable_chromedriver: z.ZodOptional<z.ZodBoolean>;
   extensions: z.ZodOptional<z.ZodArray<z.ZodString>>;
   proxy_blacklist: z.ZodOptional<z.ZodArray<z.ZodString>>;
@@ -390,6 +446,26 @@ declare const profileStartRequest: z.ZodObject<{
     cache_enabled: z.ZodOptional<z.ZodBoolean>;
     cache_key: z.ZodOptional<z.ZodString>;
   }, z.core.$strict>>;
+  anti_captcha: z.ZodOptional<z.ZodObject<{
+    enabled: z.ZodOptional<z.ZodBoolean>;
+    auto_captcha_types: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+      bls: "bls";
+      click: "click";
+      datadome: "datadome";
+      datadome_audio: "datadome_audio";
+      datadome_click: "datadome_click";
+      funcaptcha: "funcaptcha";
+      geetest: "geetest";
+      hcaptcha: "hcaptcha";
+      image: "image";
+      perimeterx: "perimeterx";
+      recaptcha: "recaptcha";
+      turnstile: "turnstile";
+    }>>>;
+    gemini_api_key: z.ZodOptional<z.ZodString>;
+    disable_external_providers: z.ZodOptional<z.ZodBoolean>;
+    external_providers_initially_enabled: z.ZodOptional<z.ZodBoolean>;
+  }, z.core.$strict>>;
   enable_chromedriver: z.ZodOptional<z.ZodBoolean>;
   extensions: z.ZodOptional<z.ZodArray<z.ZodString>>;
   proxy_blacklist: z.ZodOptional<z.ZodArray<z.ZodString>>;
@@ -1266,7 +1342,6 @@ declare class Deadline {
   readonly until: number;
   constructor(timeout: number | null | undefined, message: string);
   error(): BrowserTimeoutError;
-  check(): void;
   race<T>(promise: Promise<T>): Promise<T>;
 }
 declare class CapturedResponse {
@@ -1330,6 +1405,7 @@ declare class Page extends Actions {
   /** @internal */
   _send(method: string, params?: Record<string, unknown>): Promise<any>;
   /** @internal */
+  _change(): Promise<void>;
   _waitReady(): Promise<void>;
   /** @internal */
   _setup(waiting: boolean): Promise<void>;
@@ -1428,6 +1504,7 @@ declare class Browser extends Page implements AsyncDisposable {
   /** @internal */ _pages: Map<string, Page>;
   /** @internal aborts on close: background sleeps end early */
   _signal: AbortSignal;
+  _changed: PromiseWithResolvers<void>;
   constructor(session: Session, options?: BrowserOptions);
   get internalUuid(): string;
   get cdp(): CDPClient;
@@ -1466,6 +1543,8 @@ declare class Browser extends Page implements AsyncDisposable {
   /** @internal */
   _onAttached(event: Record<string, any>): void;
   /** @internal */
+  _notify(): void;
+  /** @internal */
   _onDetached(event: Record<string, any>): void;
   /** @internal */
   _drop(page: Page): void;
@@ -1628,6 +1707,7 @@ interface RequestOptions {
 interface SessionStartOptions extends SessionOptions {
   /** A saved profile to start; a one-time session when absent. */
   profileUuid?: string;
+  signal?: AbortSignal;
 }
 interface BrowserStartOptions extends SessionStartOptions {
   /** CDP resource types to drop: `["image", "font", "media"]` saves proxy traffic. */
@@ -1674,7 +1754,7 @@ declare class Surfsky implements AsyncDisposable {
   /** An open `BrowserPool`. `close()` stops every browser in it. */
   browsers(options?: PoolOptions): Promise<BrowserPool>;
   /** `browsers()` and `pool.map()` in 1 call. */
-  map<I, R>(handler: PoolHandler<I, R>, items: Iterable<I>, options?: PoolOptions): Promise<PoolOutcome<I, R>[]>;
+  map<I, R>(handler: PoolHandler<I, R>, items: Iterable<I>, options?: PoolOptions & LeaseOptions): Promise<PoolOutcome<I, R>[]>;
   /** Nothing to release with fetch; here for `await using` symmetry. */
   close(): Promise<void>;
   [Symbol.asyncDispose](): Promise<void>;
@@ -1704,6 +1784,9 @@ type PoolOutcome<I, R> = {
   index: number;
   error: unknown;
 };
+interface LeaseOptions {
+  signal?: AbortSignal;
+}
 declare class BrowserPool implements AsyncDisposable {
   #private;
   readonly sessionOptions: SessionOptions;
@@ -1717,12 +1800,12 @@ declare class BrowserPool implements AsyncDisposable {
   close(): Promise<void>;
   [Symbol.asyncDispose](): Promise<void>;
   /** Run `fn` on a live browser, then hand the browser back. Waits while all are busy. */
-  lease<R>(fn: (browser: Browser) => Promise<R>): Promise<R>;
+  lease<R>(fn: (browser: Browser) => Promise<R>, { signal }?: LeaseOptions): Promise<R>;
   /** Run every item through `handler` on a leased browser, `capacity` at a time. */
-  map<I, R>(handler: PoolHandler<I, R>, items: Iterable<I>): Promise<PoolOutcome<I, R>[]>;
+  map<I, R>(handler: PoolHandler<I, R>, items: Iterable<I>, { signal }?: LeaseOptions): Promise<PoolOutcome<I, R>[]>;
 }
 //#endregion
 //#region src/version.d.ts
 declare const VERSION: string;
 //#endregion
-export { APIConnectionError, APIError, APIErrorOptions, APITimeoutError, Account, Actions, type ActiveProfile, type Arch, AuthenticationError, BadRequestError, type BatchDeleteResult, Browser, type BrowserLimits, type BrowserOptions, BrowserPool, type BrowserSettings, type BrowserStartOptions, BrowserTimeoutError, CDPClient, type CDPClientOptions, CDPError, CapturedResponse, type ClickOptions, ConfigurationError, ConflictError, type Cookie, type CookieInput, type CreateWebSocket, type DblclickOptions, type DeviceModel, type DeviceModelsOptions, type DeviceType, type DialogHandler, type DomainRoute, type DragOptions, type EvaluateOptions, type EventHandler, type ExportFormat, type Extension, type ExtensionFile, Extensions, type Fingerprint, Fingerprints, ForbiddenError, type Geolocation, type GotoOptions, type HoverOptions, type Inspector, type InspectorPage, type KeyModifier, Keyboard, type ListPageOptions, type ListPageRequest, type Logger, type Loose, type ManagedSession, type MediaDevices, MonthlySessionLimitError, Mouse, type MouseButton, type MouseClickOptions, type Noise, NotFoundError, type OS, type OneTimeStartRequest, Page, PageClosedError, PaymentRequiredError, type PoolHandler, type PoolOptions, type PoolOutcome, type PremiumProxy, PremiumTrafficLimitError, type PressOptions, type Profile, type ProfileCreate, type ProfileCreateRequest, type ProfileOrdering, type ProfileRef, type ProfileStartRequest, type ProfileSummary, type ProfileUpdate, type ProfileUpdateRequest, Profiles, Proxies, type ProxyCity, type ProxyCountry, ProxyCycle, type ProxyFactory, type ProxyInput, type ProxyLike, type ProxyQuota, ProxyRandom, type ProxyRegion, type ProxySource, ProxyTemplate, type ProxyType, RESOURCE_TYPES, RateLimitError, type RegionalPool, type Renderer, type RequestOptions, type ScrapeOptions, type ScrapeRequest, type ScrapeResult, type Screen, type ScreenshotOptions, type ScrollBehavior, type ScrollOptions, type ScrollToOptions, ServerError, type Session, type SessionLimits, type SessionOptions, type SessionStartOptions, type SharedProxy, type SharedProxyQuota, SharedTrafficLimitError, type Spec, type StopAllResult, StopRun, type StorageOptions, Surfsky, SurfskyError, type SurfskyOptions, type TrafficStats, type TrafficVolume, VERSION, ValidationError, type WaitOptions, type WaitUntil, type WebSocketLike, type isRecord, type parseListPageRequest, type parseOneTimeStartRequest, type parseProfileCreateRequest, type parseProfileStartRequest, type parseProfileUpdateRequest, type parseProxyLike, type parseScrapeRequest };
+export { APIConnectionError, APIError, APIErrorOptions, APITimeoutError, Account, Actions, type ActiveProfile, type AntiCaptcha, type Arch, AuthenticationError, BadRequestError, type BatchDeleteResult, Browser, type BrowserLimits, type BrowserOptions, BrowserPool, type BrowserSettings, type BrowserStartOptions, BrowserTimeoutError, CDPClient, type CDPClientOptions, CDPError, type CaptchaType, CapturedResponse, type ClickOptions, ConfigurationError, ConflictError, type Cookie, type CookieInput, type CreateWebSocket, type DblclickOptions, type DeviceModel, type DeviceModelsOptions, type DeviceType, type DialogHandler, type DomainRoute, type DragOptions, type EvaluateOptions, type EventHandler, type ExportFormat, type Extension, type ExtensionFile, Extensions, type Fingerprint, Fingerprints, ForbiddenError, type Geolocation, type GotoOptions, type HoverOptions, type Inspector, type InspectorPage, type KeyModifier, Keyboard, type ListPageOptions, type ListPageRequest, type Logger, type Loose, type ManagedSession, type MediaDevices, MonthlySessionLimitError, Mouse, type MouseButton, type MouseClickOptions, type Noise, NotFoundError, type OS, type OneTimeStartRequest, Page, PageClosedError, PaymentRequiredError, type PoolHandler, type PoolOptions, type PoolOutcome, type PremiumProxy, PremiumTrafficLimitError, type PressOptions, type Profile, type ProfileCreate, type ProfileCreateRequest, type ProfileOrdering, type ProfileRef, type ProfileStartRequest, type ProfileSummary, type ProfileUpdate, type ProfileUpdateRequest, Profiles, Proxies, type ProxyCity, type ProxyCountry, ProxyCycle, type ProxyFactory, type ProxyInput, type ProxyLike, type ProxyQuota, ProxyRandom, type ProxyRegion, type ProxySource, ProxyTemplate, type ProxyType, RESOURCE_TYPES, RateLimitError, type RegionalPool, type Renderer, type RequestOptions, type ScrapeOptions, type ScrapeRequest, type ScrapeResult, type Screen, type ScreenshotOptions, type ScrollBehavior, type ScrollOptions, type ScrollToOptions, ServerError, type Session, type SessionLimits, type SessionOptions, type SessionStartOptions, type SharedProxy, type SharedProxyQuota, SharedTrafficLimitError, type Spec, type StopAllResult, StopRun, type StorageOptions, Surfsky, SurfskyError, type SurfskyOptions, type TrafficStats, type TrafficVolume, VERSION, ValidationError, type WaitOptions, type WaitUntil, type WebSocketLike, type isRecord, type parseListPageRequest, type parseOneTimeStartRequest, type parseProfileCreateRequest, type parseProfileStartRequest, type parseProfileUpdateRequest, type parseProxyLike, type parseScrapeRequest };

package/dist/index.js

@@ -277,6 +277,20 @@ const regionalPool = z.enum([
 	"oceania",
 	"mena"
 ]);
+const captchaType = z.enum([
+	"recaptcha",
+	"hcaptcha",
+	"turnstile",
+	"perimeterx",
+	"geetest",
+	"bls",
+	"datadome",
+	"datadome_audio",
+	"datadome_click",
+	"click",
+	"image",
+	"funcaptcha"
+]);
 const loose = () => z.string();
 function isRecord(value) {
 	return typeof value === "object" && value !== null && !Array.isArray(value);
@@ -329,6 +343,13 @@ const browserSettings = z.strictObject({
 	cache_enabled: z.boolean().optional(),
 	cache_key: z.string().optional()
 });
+const antiCaptcha = z.strictObject({
+	enabled: z.boolean().optional(),
+	auto_captcha_types: z.array(captchaType).optional(),
+	gemini_api_key: z.string().optional(),
+	disable_external_providers: z.boolean().optional(),
+	external_providers_initially_enabled: z.boolean().optional()
+});
 const shared = z.strictObject({
 	tier: z.literal("shared"),
 	country: z.string().min(1).optional()
@@ -383,6 +404,7 @@ const oneTimeStartRequest = z.strictObject({
 	fingerprint: fingerprint.optional(),
 	proxy: proxyLike.nullish(),
 	browser_settings: browserSettings.optional(),
+	anti_captcha: antiCaptcha.optional(),
 	enable_chromedriver: z.boolean().optional(),
 	extensions: z.array(z.string()).max(5).optional(),
 	proxy_blacklist: z.array(z.string()).optional(),
@@ -920,9 +942,6 @@ var Deadline = class {
 	error() {
 		return new BrowserTimeoutError(`${this.message} within ${this.timeout}ms`);
 	}
-	check() {
-		if (Date.now() >= this.until) throw this.error();
-	}
 	race(promise) {
 		if (this.timeout === null) return promise;
 		return withTimeout(promise, Math.max(0, this.until - Date.now()), () => this.error());
@@ -1064,6 +1083,9 @@ var Page = class extends Actions {
 		}
 	}
 	/** @internal */
+	_change() {
+		return Promise.race([this._browser._changed.promise, sleep(100)]);
+	}
 	async _waitReady() {
 		await this._ready.wait();
 		if (this._setupError !== void 0) throw this._setupError;
@@ -1113,8 +1135,7 @@ var Page = class extends Actions {
 		const deadline = new Deadline(options.timeout ?? 3e4, `the page did not reach '${state}'`);
 		while (!this._milestones.has(milestone)) {
 			this._requireOpen();
-			deadline.check();
-			await sleep(100);
+			await deadline.race(this._change());
 		}
 	}
 	async goto(url, options = {}) {
@@ -1166,8 +1187,7 @@ var Page = class extends Actions {
 		const deadline = new Deadline(timeout, "history did not move");
 		while (true) {
 			if ((await deadline.race(this.send("Page.getNavigationHistory"))).currentIndex === index) break;
-			deadline.check();
-			await sleep(100);
+			await deadline.race(sleep(100));
 		}
 		return this.url();
 	}
@@ -1192,8 +1212,7 @@ var Page = class extends Actions {
 			const found = this._responses.find((response) => response.url.includes(fragment));
 			if (found !== void 0) return found;
 			this._requireOpen();
-			deadline.check();
-			await sleep(100);
+			await deadline.race(this._change());
 		}
 	}
 	/** @internal */
@@ -1221,6 +1240,7 @@ var Page = class extends Actions {
 			this._browser.logger.debug(`no body for ${String(response.url)}: ${String(err)}`);
 		}
 		into.push(new CapturedResponse(typeof response.url === "string" ? response.url : "", typeof response.status === "number" ? response.status : 0, isRecord(response.headers) ? response.headers : {}, body));
+		this._browser._notify();
 	}
 	localStorage() {
 		return this.#storage(true);
@@ -1338,8 +1358,7 @@ var Page = class extends Actions {
 		while (true) {
 			const value = await deadline.race(this.evaluate(expression, rest));
 			if (value) return value;
-			deadline.check();
-			await sleep(100);
+			await deadline.race(sleep(100));
 		}
 	}
 	async innerText(selector) {
@@ -1413,10 +1432,7 @@ var Page = class extends Actions {
 		const visible = options.visible ?? true;
 		const state = visible ? "visible" : "in the document";
 		const deadline = new Deadline(options.timeout ?? 3e4, `'${selector}' was not ${state}`);
-		while (!await deadline.race(this.#matches(selector, visible))) {
-			deadline.check();
-			await sleep(100);
-		}
+		while (!await deadline.race(this.#matches(selector, visible))) await deadline.race(sleep(100));
 	}
 	async #matches(selector, visible) {
 		let box;
@@ -1472,8 +1488,7 @@ var Page = class extends Actions {
 		while (true) {
 			const url = await deadline.race(this.url());
 			if (url.includes(fragment)) return url;
-			deadline.check();
-			await sleep(100);
+			await deadline.race(sleep(100));
 		}
 	}
 	/** The first match has a bounding box. */
@@ -1551,6 +1566,7 @@ var Page = class extends Actions {
 			this._loaderId = loaderId;
 			this._milestones = /* @__PURE__ */ new Set([name]);
 		}
+		this._browser._notify();
 		this._waiter?.observe(name, loaderId);
 	}
 	/** @internal */
@@ -1663,6 +1679,7 @@ var Browser = class extends Page {
 	#client;
 	#abort = new AbortController();
 	#pending = /* @__PURE__ */ new Set();
+	_changed = Promise.withResolvers();
 	#closing;
 	#retired = false;
 	#useCount = 0;
@@ -1744,8 +1761,7 @@ var Browser = class extends Page {
 			const last = opened[opened.length - 1];
 			if (last !== void 0) return last;
 			this._requireOpen();
-			deadline.check();
-			await sleep(100);
+			await deadline.race(this._change());
 		}
 	}
 	async connect() {
@@ -1817,8 +1833,7 @@ var Browser = class extends Page {
 		let page = this.#pageFor(targetId);
 		while (page === void 0) {
 			this._requireOpen();
-			deadline.check();
-			await sleep(100);
+			await deadline.race(this._change());
 			page = this.#pageFor(targetId);
 		}
 		await deadline.race(page._waitReady());
@@ -1848,8 +1863,14 @@ var Browser = class extends Page {
 		page._frameId = page._targetId;
 		page._ready = new Flag();
 		this._pages.set(sessionId, page);
+		this._notify();
 		this._spawn(page._setup(waiting));
 	}
+	/** @internal */
+	_notify() {
+		this._changed.resolve();
+		this._changed = Promise.withResolvers();
+	}
 	async #letGo(sessionId, waiting) {
 		const timeout = this.commandTimeout;
 		const detach = async () => {
@@ -1867,6 +1888,7 @@ var Browser = class extends Page {
 	_drop(page) {
 		this._pages.delete(page._sessionId);
 		page._closed = true;
+		this._notify();
 		page._waiter?.fail("page closed");
 		if (page === this) {
 			this.logger.warn(`page target gone for ${this.internalUuid}`);
@@ -1885,6 +1907,7 @@ var Browser = class extends Page {
 			page._closed = true;
 			page._waiter?.fail("CDP connection closed");
 		}
+		this._notify();
 	}
 	/** @internal track a background task; its failure is logged at debug level */
 	_spawn(task) {
@@ -2230,7 +2253,6 @@ var BrowserPool = class {
 	#idle = [];
 	#owned = 0;
 	#planFull = false;
-	#planFullError;
 	#waiters = [];
 	#capacity = 0;
 	#slots;
@@ -2263,7 +2285,6 @@ var BrowserPool = class {
 		this.#capacity = Math.max(1, total);
 		this.#slots = new Semaphore(this.#capacity);
 		this.#planFull = false;
-		this.#planFullError = void 0;
 		this.#owned = 0;
 		return this;
 	}
@@ -2279,14 +2300,17 @@ var BrowserPool = class {
 		return this.close();
 	}
 	/** Run `fn` on a live browser, then hand the browser back. Waits while all are busy. */
-	async lease(fn) {
+	async lease(fn, { signal } = {}) {
+		signal?.throwIfAborted();
 		const slots = this.#requireOpen();
 		await slots.acquire();
 		try {
 			if (this.#slots !== slots) throw new Error("the pool was closed while waiting for a slot");
+			signal?.throwIfAborted();
 			const browser = await this.#acquire();
 			browser._lease();
 			try {
+				signal?.throwIfAborted();
 				return await fn(browser);
 			} finally {
 				await this.#release(browser);
@@ -2317,7 +2341,6 @@ var BrowserPool = class {
 			const idle = this.#idle.pop();
 			if (idle !== void 0) return idle;
 			if (this.#planFull) {
-				if (this.#owned === 0) throw this.#planFullError ?? new RateLimitError("parallel browser limit reached", { statusCode: 429 });
 				await this.#wait();
 				continue;
 			}
@@ -2326,15 +2349,10 @@ var BrowserPool = class {
 			try {
 				browser = await this.#startBrowser();
 			} catch (err) {
-				const full = planIsFull(err);
 				this.#owned -= 1;
-				if (full) {
-					this.#planFull = true;
-					this.#planFullError = err;
-				}
-				const nothingLeft = this.#owned === 0;
+				this.#planFull = planIsFull(err) && this.#owned > 0;
 				this.#notifyAll();
-				if (!full || nothingLeft) throw err;
+				if (!this.#planFull) throw err;
 				this.#client.logger.info("plan is full, waiting for a browser of ours");
 				continue;
 			}
@@ -2358,20 +2376,20 @@ var BrowserPool = class {
 		this.#notifyAll();
 	}
 	/** Run every item through `handler` on a leased browser, `capacity` at a time. */
-	async map(handler, items) {
+	async map(handler, items, { signal } = {}) {
 		const work = items[Symbol.iterator]();
 		const outcomes = [];
 		let index = 0;
 		let stopped = false;
 		const worker = async () => {
-			while (!stopped) {
+			while (!stopped && !signal?.aborted) {
 				const next = work.next();
 				if (next.done) return;
 				const item = next.value;
 				const at = index;
 				index += 1;
 				try {
-					const value = await this.lease((browser) => handler(browser, item));
+					const value = await this.lease((browser) => handler(browser, item), { signal });
 					outcomes.push({
 						ok: true,
 						item,
@@ -2678,7 +2696,7 @@ var Proxies = class {
 };
 //#endregion
 //#region src/version.ts
-const VERSION = "0.0.6";
+const VERSION = "0.0.9";
 //#endregion
 //#region src/client.ts
 function userAgent() {
@@ -2777,13 +2795,18 @@ var Surfsky = class Surfsky {
 	}
 	/** Start a session; `stop()` it (or `await using`) so it does not keep billing. */
 	async session(options = {}) {
-		const { profileUuid, ...rest } = options;
+		const { profileUuid, signal, ...rest } = options;
+		signal?.throwIfAborted();
 		const session = profileUuid === void 0 ? await this.profiles.startOneTime(rest) : await this.profiles.start(profileUuid, rest);
 		let stopping;
 		const stop = () => {
 			stopping ??= stopSession(this, session.internal_uuid);
 			return stopping;
 		};
+		if (signal?.aborted) {
+			await stop();
+			throw signal.reason;
+		}
 		return {
 			...session,
 			stop,
@@ -2792,11 +2815,12 @@ var Surfsky = class Surfsky {
 	}
 	/** Start a session and connect a `Browser` to it. `close()` stops the session. */
 	async browser(options = {}) {
-		const { profileUuid, blockResources, blockUrls, connectTimeout, commandTimeout, createWebSocket, ...sessionOptions } = options;
+		const { profileUuid, signal, blockResources, blockUrls, connectTimeout, commandTimeout, createWebSocket, ...sessionOptions } = options;
 		const blocked = normalizeBlocked(blockResources);
 		const urls = normalizeUrls(blockUrls);
 		const session = await this.session({
 			profileUuid,
+			signal,
 			...sessionOptions
 		});
 		const browser = new Browser(session, {
@@ -2808,7 +2832,19 @@ var Surfsky = class Surfsky {
 			logger: this.logger,
 			onClose: () => session.stop()
 		});
-		await browser.connect();
+		const onAbort = () => void browser.close();
+		signal?.addEventListener("abort", onAbort, { once: true });
+		try {
+			await browser.connect();
+		} catch (err) {
+			throw signal?.aborted ? signal.reason : err;
+		} finally {
+			signal?.removeEventListener("abort", onAbort);
+		}
+		if (signal?.aborted) {
+			await browser.close();
+			throw signal.reason;
+		}
 		return browser;
 	}
 	/** An open `BrowserPool`. `close()` stops every browser in it. */
@@ -2817,9 +2853,10 @@ var Surfsky = class Surfsky {
 	}
 	/** `browsers()` and `pool.map()` in 1 call. */
 	async map(handler, items, options = {}) {
-		const pool = await this.browsers(options);
+		const { signal, ...poolOptions } = options;
+		const pool = await this.browsers(poolOptions);
 		try {
-			return await pool.map(handler, items);
+			return await pool.map(handler, items, { signal });
 		} finally {
 			await pool.close();
 		}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "surfsky",
-  "version": "0.0.6",
+  "version": "0.0.9",
   "description": "TypeScript SDK for the Surfsky antidetect browser cloud.",
   "keywords": [
     "surfsky",