firecrawl 4.49.2 → 4.50.0

package/README.md

@@ -15,7 +15,7 @@ npm install firecrawl
 1. Get an API key from [firecrawl.dev](https://firecrawl.dev)
 2. Set the API key as an environment variable named `FIRECRAWL_API_KEY` or pass it as the `apiKey` option to the `Firecrawl` class.
 
-Here's an example of how to use the SDK with error handling:
+Here's an example of how to use the SDK with error handling. It uses ES modules and top-level `await`, so save it as an `.mjs` file or set `"type": "module"` in your `package.json`:
 
 ```js
 import { Firecrawl } from 'firecrawl';

package/dist/{chunk-JRVJFY7G.js → chunk-NXSNF7F3.js}

@@ -1,6 +1,6 @@
 // package.json
 var name = "@mendable/firecrawl-js";
-var version = "4.49.2";
+var version = "4.50.0";
 var description = "JavaScript SDK for Firecrawl, the context API for AI agents: search, scrape, parse, crawl, map, and interact with the web, run Agent and Monitor jobs, and search scientific papers (PubMed, bioRxiv, medRxiv, arXiv)";
 var main = "dist/index.js";
 var types = "dist/index.d.ts";
@@ -70,7 +70,7 @@ var keywords = [
   "bioinformatics"
 ];
 var engines = {
-  node: ">=22.0.0"
+  node: ">=18.0.0"
 };
 var package_default = {
   name,

package/dist/index.cjs

@@ -39,7 +39,7 @@ var require_package = __commonJS({
   "package.json"(exports2, module2) {
     module2.exports = {
       name: "@mendable/firecrawl-js",
-      version: "4.49.2",
+      version: "4.50.0",
       description: "JavaScript SDK for Firecrawl, the context API for AI agents: search, scrape, parse, crawl, map, and interact with the web, run Agent and Monitor jobs, and search scientific papers (PubMed, bioRxiv, medRxiv, arXiv)",
       main: "dist/index.js",
       types: "dist/index.d.ts",
@@ -109,7 +109,7 @@ var require_package = __commonJS({
         "bioinformatics"
       ],
       engines: {
-        node: ">=22.0.0"
+        node: ">=18.0.0"
       }
     };
   }
@@ -155,6 +155,15 @@ function pinToApiOrigin(apiUrl, url) {
 }
 
 // src/v2/utils/httpClient.ts
+var rejectsDefaultCacheMode = () => {
+  if (typeof Request !== "function") return false;
+  try {
+    new Request("https://api.firecrawl.dev", { cache: "default" });
+    return false;
+  } catch {
+    return true;
+  }
+};
 var HttpClient = class {
   instance;
   apiKey;
@@ -177,7 +186,8 @@ var HttpClient = class {
         // grants it when no Authorization header is present).
         ...this.apiKey ? { Authorization: `Bearer ${this.apiKey}` } : {}
       },
-      transitional: { clarifyTimeoutError: true }
+      transitional: { clarifyTimeoutError: true },
+      ...rejectsDefaultCacheMode() ? { adapter: "fetch", env: { Request: null } } : {}
     });
   }
   getApiUrl() {
@@ -2246,37 +2256,84 @@ function defaultOrigin(version2) {
 }
 
 // src/v2/watcher.ts
-var import_events = require("events");
-var hasGlobalWebSocket = () => {
-  if (typeof globalThis === "undefined") return void 0;
+var getWebSocketCtor = () => {
   const candidate = globalThis.WebSocket;
   return typeof candidate === "function" ? candidate : void 0;
 };
-var isNodeRuntime = () => typeof process !== "undefined" && !!process.versions?.node;
-var cachedWebSocket;
-var loadPromise;
-var loadNodeWebSocket = async () => {
-  if (!isNodeRuntime()) return void 0;
-  try {
-    const undici = await import("undici");
-    const ctor = undici.WebSocket ?? undici.default?.WebSocket;
-    return typeof ctor === "function" ? ctor : void 0;
-  } catch {
-    return void 0;
+var Emitter = class {
+  listenersByEvent = /* @__PURE__ */ new Map();
+  maxListeners = 10;
+  on(event, listener) {
+    this.listenersByEvent.set(event, [...this.listenersByEvent.get(event) ?? [], listener]);
+    return this;
+  }
+  prependListener(event, listener) {
+    this.listenersByEvent.set(event, [listener, ...this.listenersByEvent.get(event) ?? []]);
+    return this;
+  }
+  prependOnceListener(event, listener) {
+    return this.prependListener(event, this.onceWrapper(event, listener));
+  }
+  listeners(event) {
+    return (this.listenersByEvent.get(event) ?? []).map((entry) => entry.listener ?? entry);
+  }
+  rawListeners(event) {
+    return [...this.listenersByEvent.get(event) ?? []];
+  }
+  eventNames() {
+    return [...this.listenersByEvent.keys()].filter((event) => this.listenerCount(event) > 0);
+  }
+  setMaxListeners(n) {
+    this.maxListeners = n;
+    return this;
+  }
+  getMaxListeners() {
+    return this.maxListeners;
+  }
+  addListener(event, listener) {
+    return this.on(event, listener);
+  }
+  once(event, listener) {
+    return this.on(event, this.onceWrapper(event, listener));
+  }
+  onceWrapper(event, listener) {
+    const wrapped = (...args) => {
+      this.off(event, wrapped);
+      listener.apply(this, args);
+    };
+    wrapped.listener = listener;
+    return wrapped;
+  }
+  off(event, listener) {
+    const current = this.listenersByEvent.get(event);
+    if (!current) return this;
+    for (let index = current.length - 1; index >= 0; index--) {
+      if (current[index] !== listener && current[index].listener !== listener) continue;
+      this.listenersByEvent.set(event, current.filter((_, i) => i !== index));
+      break;
+    }
+    return this;
+  }
+  removeListener(event, listener) {
+    return this.off(event, listener);
+  }
+  removeAllListeners(event) {
+    if (event === void 0) this.listenersByEvent.clear();
+    else this.listenersByEvent.delete(event);
+    return this;
+  }
+  listenerCount(event) {
+    return this.listenersByEvent.get(event)?.length ?? 0;
+  }
+  emit(event, ...args) {
+    const current = this.listenersByEvent.get(event);
+    if (!current?.length) {
+      if (event === "error") throw args[0] instanceof Error ? args[0] : new Error(String(args[0]));
+      return false;
+    }
+    for (const listener of [...current]) listener.apply(this, args);
+    return true;
   }
-};
-var getWebSocketCtor = async () => {
-  if (cachedWebSocket) return cachedWebSocket;
-  const globalWs = hasGlobalWebSocket();
-  if (globalWs) {
-    cachedWebSocket = globalWs;
-    return cachedWebSocket;
-  }
-  if (!loadPromise) {
-    loadPromise = loadNodeWebSocket();
-  }
-  cachedWebSocket = await loadPromise;
-  return cachedWebSocket;
 };
 var decoder = typeof TextDecoder !== "undefined" ? new TextDecoder() : void 0;
 var ensureUtf8String = (data) => {
@@ -2298,7 +2355,7 @@ var ensureUtf8String = (data) => {
   }
   return void 0;
 };
-var Watcher = class extends import_events.EventEmitter {
+var Watcher = class extends Emitter {
   http;
   jobId;
   kind;
@@ -2340,7 +2397,7 @@ var Watcher = class extends import_events.EventEmitter {
       (async () => {
         try {
           const url = this.buildWsUrl();
-          const wsCtor = await getWebSocketCtor();
+          const wsCtor = getWebSocketCtor();
           if (!wsCtor) {
             this.pollLoop();
             return;
@@ -2526,8 +2583,9 @@ var FirecrawlClient = class {
    */
   constructor(options = {}) {
     const opts = typeof options === "string" ? { apiKey: options } : options;
-    const apiKey = (opts.apiKey ?? process.env.FIRECRAWL_API_KEY ?? "").trim();
-    const apiUrl = (opts.apiUrl ?? process.env.FIRECRAWL_API_URL ?? "https://api.firecrawl.dev").replace(/\/$/, "");
+    const hasEnv = typeof process !== "undefined" && !!process.env;
+    const apiKey = (opts.apiKey ?? (hasEnv ? process.env.FIRECRAWL_API_KEY : void 0) ?? "").trim();
+    const apiUrl = (opts.apiUrl ?? (hasEnv ? process.env.FIRECRAWL_API_URL : void 0) ?? "https://api.firecrawl.dev").replace(/\/$/, "");
     this.http = new HttpClient({
       apiKey,
       apiUrl,
@@ -3073,7 +3131,7 @@ var FirecrawlApp = class {
       const packageJson = await Promise.resolve().then(() => __toESM(require_package(), 1));
       return packageJson.default.version;
     } catch (error) {
-      const isTest = typeof process !== "undefined" && false;
+      const isTest = typeof process !== "undefined" && !!process.env && false;
       if (!isTest) {
         console.error("Error getting version:", error);
       }
@@ -4362,6 +4420,9 @@ var CrawlWatcher = class extends e {
     super();
     this.id = id;
     const wsUrl = app.apiUrl.replace(/^http/, "ws");
+    if (typeof WebSocket === "undefined") {
+      throw new Error("Watching a crawl needs a global WebSocket (Node 22+, Bun, Deno or a browser). On older Node, use the v2 client's watcher(), which polls instead.");
+    }
     this.ws = new WebSocket(`${wsUrl}/v1/crawl/${id}`, app.apiKey);
     this.status = "scraping";
     this.data = [];

package/dist/index.d.cts

@@ -1,7 +1,6 @@
 import * as zt from 'zod';
 import { ZodTypeAny } from 'zod';
 import { AxiosResponse, AxiosRequestHeaders } from 'axios';
-import { EventEmitter } from 'events';
 import { TypedEventTarget } from 'typescript-event-target';
 
 type FormatString = "markdown" | "html" | "rawHtml" | "links" | "images" | "screenshot" | "summary" | "changeTracking" | "json" | "attributes" | "branding" | "product" | "menu" | "audio" | "video";
@@ -2222,13 +2221,37 @@ declare class ResearchClient {
     searchGithub(query: string, options?: SearchGithubOptions): Promise<GitHubSearchResponse>;
 }
 
+type Listener = ((...args: any[]) => void) & {
+    listener?: Listener;
+};
+/** Node's EventEmitter API for the watcher, with no import of "events", so browser bundles load it. */
+declare class Emitter {
+    private readonly listenersByEvent;
+    private maxListeners;
+    on(event: string | symbol, listener: Listener): this;
+    prependListener(event: string | symbol, listener: Listener): this;
+    prependOnceListener(event: string | symbol, listener: Listener): this;
+    listeners(event: string | symbol): Listener[];
+    rawListeners(event: string | symbol): Listener[];
+    eventNames(): (string | symbol)[];
+    setMaxListeners(n: number): this;
+    getMaxListeners(): number;
+    addListener(event: string | symbol, listener: Listener): this;
+    once(event: string | symbol, listener: Listener): this;
+    private onceWrapper;
+    off(event: string | symbol, listener: Listener): this;
+    removeListener(event: string | symbol, listener: Listener): this;
+    removeAllListeners(event?: string | symbol): this;
+    listenerCount(event: string | symbol): number;
+    emit(event: string | symbol, ...args: any[]): boolean;
+}
 type JobKind = "crawl" | "batch";
 interface WatcherOptions {
     kind?: JobKind;
     pollInterval?: number;
     timeout?: number;
 }
-declare class Watcher extends EventEmitter {
+declare class Watcher extends Emitter {
     private readonly http;
     private readonly jobId;
     private readonly kind;

package/dist/index.d.ts

@@ -1,7 +1,6 @@
 import * as zt from 'zod';
 import { ZodTypeAny } from 'zod';
 import { AxiosResponse, AxiosRequestHeaders } from 'axios';
-import { EventEmitter } from 'events';
 import { TypedEventTarget } from 'typescript-event-target';
 
 type FormatString = "markdown" | "html" | "rawHtml" | "links" | "images" | "screenshot" | "summary" | "changeTracking" | "json" | "attributes" | "branding" | "product" | "menu" | "audio" | "video";
@@ -2222,13 +2221,37 @@ declare class ResearchClient {
     searchGithub(query: string, options?: SearchGithubOptions): Promise<GitHubSearchResponse>;
 }
 
+type Listener = ((...args: any[]) => void) & {
+    listener?: Listener;
+};
+/** Node's EventEmitter API for the watcher, with no import of "events", so browser bundles load it. */
+declare class Emitter {
+    private readonly listenersByEvent;
+    private maxListeners;
+    on(event: string | symbol, listener: Listener): this;
+    prependListener(event: string | symbol, listener: Listener): this;
+    prependOnceListener(event: string | symbol, listener: Listener): this;
+    listeners(event: string | symbol): Listener[];
+    rawListeners(event: string | symbol): Listener[];
+    eventNames(): (string | symbol)[];
+    setMaxListeners(n: number): this;
+    getMaxListeners(): number;
+    addListener(event: string | symbol, listener: Listener): this;
+    once(event: string | symbol, listener: Listener): this;
+    private onceWrapper;
+    off(event: string | symbol, listener: Listener): this;
+    removeListener(event: string | symbol, listener: Listener): this;
+    removeAllListeners(event?: string | symbol): this;
+    listenerCount(event: string | symbol): number;
+    emit(event: string | symbol, ...args: any[]): boolean;
+}
 type JobKind = "crawl" | "batch";
 interface WatcherOptions {
     kind?: JobKind;
     pollInterval?: number;
     timeout?: number;
 }
-declare class Watcher extends EventEmitter {
+declare class Watcher extends Emitter {
     private readonly http;
     private readonly jobId;
     private readonly kind;

package/dist/index.js

@@ -1,6 +1,6 @@
 import {
   version
-} from "./chunk-JRVJFY7G.js";
+} from "./chunk-NXSNF7F3.js";
 
 // src/v2/utils/httpClient.ts
 import axios from "axios";
@@ -26,6 +26,15 @@ function pinToApiOrigin(apiUrl, url) {
 }
 
 // src/v2/utils/httpClient.ts
+var rejectsDefaultCacheMode = () => {
+  if (typeof Request !== "function") return false;
+  try {
+    new Request("https://api.firecrawl.dev", { cache: "default" });
+    return false;
+  } catch {
+    return true;
+  }
+};
 var HttpClient = class {
   instance;
   apiKey;
@@ -48,7 +57,8 @@ var HttpClient = class {
         // grants it when no Authorization header is present).
         ...this.apiKey ? { Authorization: `Bearer ${this.apiKey}` } : {}
       },
-      transitional: { clarifyTimeoutError: true }
+      transitional: { clarifyTimeoutError: true },
+      ...rejectsDefaultCacheMode() ? { adapter: "fetch", env: { Request: null } } : {}
     });
   }
   getApiUrl() {
@@ -2117,37 +2127,84 @@ function defaultOrigin(version2) {
 }
 
 // src/v2/watcher.ts
-import { EventEmitter } from "events";
-var hasGlobalWebSocket = () => {
-  if (typeof globalThis === "undefined") return void 0;
+var getWebSocketCtor = () => {
   const candidate = globalThis.WebSocket;
   return typeof candidate === "function" ? candidate : void 0;
 };
-var isNodeRuntime = () => typeof process !== "undefined" && !!process.versions?.node;
-var cachedWebSocket;
-var loadPromise;
-var loadNodeWebSocket = async () => {
-  if (!isNodeRuntime()) return void 0;
-  try {
-    const undici = await import("undici");
-    const ctor = undici.WebSocket ?? undici.default?.WebSocket;
-    return typeof ctor === "function" ? ctor : void 0;
-  } catch {
-    return void 0;
+var Emitter = class {
+  listenersByEvent = /* @__PURE__ */ new Map();
+  maxListeners = 10;
+  on(event, listener) {
+    this.listenersByEvent.set(event, [...this.listenersByEvent.get(event) ?? [], listener]);
+    return this;
+  }
+  prependListener(event, listener) {
+    this.listenersByEvent.set(event, [listener, ...this.listenersByEvent.get(event) ?? []]);
+    return this;
+  }
+  prependOnceListener(event, listener) {
+    return this.prependListener(event, this.onceWrapper(event, listener));
+  }
+  listeners(event) {
+    return (this.listenersByEvent.get(event) ?? []).map((entry) => entry.listener ?? entry);
+  }
+  rawListeners(event) {
+    return [...this.listenersByEvent.get(event) ?? []];
+  }
+  eventNames() {
+    return [...this.listenersByEvent.keys()].filter((event) => this.listenerCount(event) > 0);
+  }
+  setMaxListeners(n) {
+    this.maxListeners = n;
+    return this;
+  }
+  getMaxListeners() {
+    return this.maxListeners;
+  }
+  addListener(event, listener) {
+    return this.on(event, listener);
+  }
+  once(event, listener) {
+    return this.on(event, this.onceWrapper(event, listener));
+  }
+  onceWrapper(event, listener) {
+    const wrapped = (...args) => {
+      this.off(event, wrapped);
+      listener.apply(this, args);
+    };
+    wrapped.listener = listener;
+    return wrapped;
+  }
+  off(event, listener) {
+    const current = this.listenersByEvent.get(event);
+    if (!current) return this;
+    for (let index = current.length - 1; index >= 0; index--) {
+      if (current[index] !== listener && current[index].listener !== listener) continue;
+      this.listenersByEvent.set(event, current.filter((_, i) => i !== index));
+      break;
+    }
+    return this;
+  }
+  removeListener(event, listener) {
+    return this.off(event, listener);
+  }
+  removeAllListeners(event) {
+    if (event === void 0) this.listenersByEvent.clear();
+    else this.listenersByEvent.delete(event);
+    return this;
+  }
+  listenerCount(event) {
+    return this.listenersByEvent.get(event)?.length ?? 0;
+  }
+  emit(event, ...args) {
+    const current = this.listenersByEvent.get(event);
+    if (!current?.length) {
+      if (event === "error") throw args[0] instanceof Error ? args[0] : new Error(String(args[0]));
+      return false;
+    }
+    for (const listener of [...current]) listener.apply(this, args);
+    return true;
   }
-};
-var getWebSocketCtor = async () => {
-  if (cachedWebSocket) return cachedWebSocket;
-  const globalWs = hasGlobalWebSocket();
-  if (globalWs) {
-    cachedWebSocket = globalWs;
-    return cachedWebSocket;
-  }
-  if (!loadPromise) {
-    loadPromise = loadNodeWebSocket();
-  }
-  cachedWebSocket = await loadPromise;
-  return cachedWebSocket;
 };
 var decoder = typeof TextDecoder !== "undefined" ? new TextDecoder() : void 0;
 var ensureUtf8String = (data) => {
@@ -2169,7 +2226,7 @@ var ensureUtf8String = (data) => {
   }
   return void 0;
 };
-var Watcher = class extends EventEmitter {
+var Watcher = class extends Emitter {
   http;
   jobId;
   kind;
@@ -2211,7 +2268,7 @@ var Watcher = class extends EventEmitter {
       (async () => {
         try {
           const url = this.buildWsUrl();
-          const wsCtor = await getWebSocketCtor();
+          const wsCtor = getWebSocketCtor();
           if (!wsCtor) {
             this.pollLoop();
             return;
@@ -2397,8 +2454,9 @@ var FirecrawlClient = class {
    */
   constructor(options = {}) {
     const opts = typeof options === "string" ? { apiKey: options } : options;
-    const apiKey = (opts.apiKey ?? process.env.FIRECRAWL_API_KEY ?? "").trim();
-    const apiUrl = (opts.apiUrl ?? process.env.FIRECRAWL_API_URL ?? "https://api.firecrawl.dev").replace(/\/$/, "");
+    const hasEnv = typeof process !== "undefined" && !!process.env;
+    const apiKey = (opts.apiKey ?? (hasEnv ? process.env.FIRECRAWL_API_KEY : void 0) ?? "").trim();
+    const apiUrl = (opts.apiUrl ?? (hasEnv ? process.env.FIRECRAWL_API_URL : void 0) ?? "https://api.firecrawl.dev").replace(/\/$/, "");
     this.http = new HttpClient({
       apiKey,
       apiUrl,
@@ -2941,10 +2999,10 @@ var FirecrawlApp = class {
       if (typeof process !== "undefined" && process.env && process.env.npm_package_version) {
         return process.env.npm_package_version;
       }
-      const packageJson = await import("./package-DW3K6CBX.js");
+      const packageJson = await import("./package-KFOQKI5Z.js");
       return packageJson.default.version;
     } catch (error) {
-      const isTest = typeof process !== "undefined" && false;
+      const isTest = typeof process !== "undefined" && !!process.env && false;
       if (!isTest) {
         console.error("Error getting version:", error);
       }
@@ -4233,6 +4291,9 @@ var CrawlWatcher = class extends e {
     super();
     this.id = id;
     const wsUrl = app.apiUrl.replace(/^http/, "ws");
+    if (typeof WebSocket === "undefined") {
+      throw new Error("Watching a crawl needs a global WebSocket (Node 22+, Bun, Deno or a browser). On older Node, use the v2 client's watcher(), which polls instead.");
+    }
     this.ws = new WebSocket(`${wsUrl}/v1/crawl/${id}`, app.apiKey);
     this.status = "scraping";
     this.data = [];

package/dist/{package-DW3K6CBX.js → package-KFOQKI5Z.js}

@@ -17,7 +17,7 @@ import {
   type,
   types,
   version
-} from "./chunk-JRVJFY7G.js";
+} from "./chunk-NXSNF7F3.js";
 export {
   author,
   bugs,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "firecrawl",
-  "version": "4.49.2",
+  "version": "4.50.0",
   "description": "JavaScript SDK for Firecrawl, the context API for AI agents: search, scrape, parse, crawl, map, and interact with the web, run Agent and Monitor jobs, and search scientific papers (PubMed, bioRxiv, medRxiv, arXiv)",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -62,7 +62,7 @@
     "bioinformatics"
   ],
   "engines": {
-    "node": ">=22.0.0"
+    "node": ">=18.0.0"
   },
   "scripts": {
     "build": "tsup",

package/src/v1/index.ts

@@ -686,7 +686,7 @@ export default class FirecrawlApp {
       return packageJson.default.version;
     } catch (error) {
       // Suppress noisy logs under test environments
-      const isTest = typeof process !== 'undefined' && process.env.NODE_ENV === 'test';
+      const isTest = typeof process !== 'undefined' && !!process.env && process.env.NODE_ENV === 'test';
       if (!isTest) {
         // eslint-disable-next-line no-console
         console.error("Error getting version:", error);
@@ -2220,6 +2220,9 @@ export class CrawlWatcher extends TypedEventTarget<CrawlWatcherEvents> {
     this.id = id;
     // replace `http` with `ws` (`http://` -> `ws://` and `https://` -> `wss://`)
     const wsUrl = app.apiUrl.replace(/^http/, "ws");
+    if (typeof WebSocket === "undefined") {
+      throw new Error("Watching a crawl needs a global WebSocket (Node 22+, Bun, Deno or a browser). On older Node, use the v2 client's watcher(), which polls instead.");
+    }
     this.ws = new WebSocket(`${wsUrl}/v1/crawl/${id}`, app.apiKey);
     this.status = "scraping";
     this.data = [];

package/src/v2/client.ts

@@ -164,8 +164,9 @@ export class FirecrawlClient {
     const opts: FirecrawlClientOptions =
       typeof options === "string" ? { apiKey: options } : options;
 
-    const apiKey = (opts.apiKey ?? process.env.FIRECRAWL_API_KEY ?? "").trim();
-    const apiUrl = (opts.apiUrl ?? process.env.FIRECRAWL_API_URL ?? "https://api.firecrawl.dev").replace(/\/$/, "");
+    const hasEnv = typeof process !== "undefined" && !!process.env;
+    const apiKey = (opts.apiKey ?? (hasEnv ? process.env.FIRECRAWL_API_KEY : undefined) ?? "").trim();
+    const apiUrl = (opts.apiUrl ?? (hasEnv ? process.env.FIRECRAWL_API_URL : undefined) ?? "https://api.firecrawl.dev").replace(/\/$/, "");
 
     // No API key is allowed: scrape, search, and interact fall back to the
     // keyless free tier (rate-limited per IP). Other methods will return 401

package/src/v2/utils/httpClient.ts

@@ -6,6 +6,18 @@ import axios, {
 import { getVersion } from "./getVersion";
 import { pinToApiOrigin } from "../../utils/apiOrigin";
 
+// Runtimes such as Cloudflare Workers reject the Request `cache: "default"` that
+// axios's fetch adapter always sets; there axios calls fetch(url, init) without it.
+const rejectsDefaultCacheMode = (): boolean => {
+  if (typeof Request !== "function") return false;
+  try {
+    new Request("https://api.firecrawl.dev", { cache: "default" });
+    return false;
+  } catch {
+    return true;
+  }
+};
+
 export interface HttpClientOptions {
   apiKey: string;
   apiUrl: string;
@@ -44,6 +56,7 @@ export class HttpClient {
         ...(this.apiKey ? { Authorization: `Bearer ${this.apiKey}` } : {}),
       },
       transitional: { clarifyTimeoutError: true },
+      ...(rejectsDefaultCacheMode() ? { adapter: "fetch", env: { Request: null as any } } : {}),
     });
   }
 

package/src/v2/watcher.ts

@@ -1,48 +1,110 @@
-import { EventEmitter } from "events";
 import type { BatchScrapeJob, CrawlJob, Document } from "./types";
 import type { HttpClient } from "./utils/httpClient";
 import { getBatchScrapeStatus } from "./methods/batch";
 import { getCrawlStatus } from "./methods/crawl";
-// Note: browsers/Deno expose globalThis.WebSocket, but many Node runtimes (<22.4 or without
-// experimental flags) do not. We lazily fall back to node:undici.
 
 type WebSocketConstructor = new (url: string, protocols?: string | string[]) => WebSocket;
 
-const hasGlobalWebSocket = (): WebSocketConstructor | undefined => {
-  if (typeof globalThis === "undefined") return undefined;
+// Runtimes without a global WebSocket (Node before 22) poll instead.
+const getWebSocketCtor = (): WebSocketConstructor | undefined => {
   const candidate = (globalThis as any).WebSocket;
   return typeof candidate === "function" ? (candidate as WebSocketConstructor) : undefined;
 };
 
-const isNodeRuntime = () => typeof process !== "undefined" && !!process.versions?.node;
+type Listener = ((...args: any[]) => void) & { listener?: Listener };
 
-let cachedWebSocket: WebSocketConstructor | undefined;
-let loadPromise: Promise<WebSocketConstructor | undefined> | undefined;
+/** Node's EventEmitter API for the watcher, with no import of "events", so browser bundles load it. */
+class Emitter {
+  private readonly listenersByEvent = new Map<string | symbol, Listener[]>();
+  private maxListeners = 10;
 
-const loadNodeWebSocket = async (): Promise<WebSocketConstructor | undefined> => {
-  if (!isNodeRuntime()) return undefined;
-  try {
-    const undici = await import("node:undici");
-    const ctor = (undici as any).WebSocket ?? (undici as any).default?.WebSocket;
-    return typeof ctor === "function" ? (ctor as WebSocketConstructor) : undefined;
-  } catch {
-    return undefined;
+  on(event: string | symbol, listener: Listener): this {
+    this.listenersByEvent.set(event, [...(this.listenersByEvent.get(event) ?? []), listener]);
+    return this;
   }
-};
 
-const getWebSocketCtor = async (): Promise<WebSocketConstructor | undefined> => {
-  if (cachedWebSocket) return cachedWebSocket;
-  const globalWs = hasGlobalWebSocket();
-  if (globalWs) {
-    cachedWebSocket = globalWs;
-    return cachedWebSocket;
+  prependListener(event: string | symbol, listener: Listener): this {
+    this.listenersByEvent.set(event, [listener, ...(this.listenersByEvent.get(event) ?? [])]);
+    return this;
   }
-  if (!loadPromise) {
-    loadPromise = loadNodeWebSocket();
+
+  prependOnceListener(event: string | symbol, listener: Listener): this {
+    return this.prependListener(event, this.onceWrapper(event, listener));
   }
-  cachedWebSocket = await loadPromise;
-  return cachedWebSocket;
-};
+
+  listeners(event: string | symbol): Listener[] {
+    return (this.listenersByEvent.get(event) ?? []).map((entry) => entry.listener ?? entry);
+  }
+
+  rawListeners(event: string | symbol): Listener[] {
+    return [...(this.listenersByEvent.get(event) ?? [])];
+  }
+
+  eventNames(): (string | symbol)[] {
+    return [...this.listenersByEvent.keys()].filter((event) => this.listenerCount(event) > 0);
+  }
+
+  setMaxListeners(n: number): this {
+    this.maxListeners = n;
+    return this;
+  }
+
+  getMaxListeners(): number {
+    return this.maxListeners;
+  }
+
+  addListener(event: string | symbol, listener: Listener): this {
+    return this.on(event, listener);
+  }
+
+  once(event: string | symbol, listener: Listener): this {
+    return this.on(event, this.onceWrapper(event, listener));
+  }
+
+  private onceWrapper(event: string | symbol, listener: Listener): Listener {
+    const wrapped: Listener = (...args) => {
+      this.off(event, wrapped);
+      listener.apply(this, args);
+    };
+    wrapped.listener = listener;
+    return wrapped;
+  }
+
+  off(event: string | symbol, listener: Listener): this {
+    const current = this.listenersByEvent.get(event);
+    if (!current) return this;
+    for (let index = current.length - 1; index >= 0; index--) {
+      if (current[index] !== listener && current[index]!.listener !== listener) continue;
+      this.listenersByEvent.set(event, current.filter((_, i) => i !== index));
+      break;
+    }
+    return this;
+  }
+
+  removeListener(event: string | symbol, listener: Listener): this {
+    return this.off(event, listener);
+  }
+
+  removeAllListeners(event?: string | symbol): this {
+    if (event === undefined) this.listenersByEvent.clear();
+    else this.listenersByEvent.delete(event);
+    return this;
+  }
+
+  listenerCount(event: string | symbol): number {
+    return this.listenersByEvent.get(event)?.length ?? 0;
+  }
+
+  emit(event: string | symbol, ...args: any[]): boolean {
+    const current = this.listenersByEvent.get(event);
+    if (!current?.length) {
+      if (event === "error") throw args[0] instanceof Error ? args[0] : new Error(String(args[0]));
+      return false;
+    }
+    for (const listener of [...current]) listener.apply(this, args);
+    return true;
+  }
+}
 
 const decoder = typeof TextDecoder !== "undefined" ? new TextDecoder() : undefined;
 
@@ -81,7 +143,7 @@ export interface WatcherOptions {
 
 type Snapshot = CrawlJob | BatchScrapeJob;
 
-export class Watcher extends EventEmitter {
+export class Watcher extends Emitter {
   private readonly http: HttpClient;
   private readonly jobId: string;
   private readonly kind: JobKind;
@@ -122,7 +184,7 @@ export class Watcher extends EventEmitter {
       (async () => {
         try {
           const url = this.buildWsUrl();
-          const wsCtor = await getWebSocketCtor();
+          const wsCtor = getWebSocketCtor();
           if (!wsCtor) {
             this.pollLoop();
             return;

package/src/types/node-undici.d.ts

@@ -1,10 +0,0 @@
-type WebSocketCtor = typeof globalThis.WebSocket;
-
-declare module "node:undici" {
-  export const WebSocket: WebSocketCtor;
-  const _default: {
-    WebSocket: WebSocketCtor;
-  };
-  export default _default;
-}
-