@mendable/firecrawl-js 4.12.0 → 4.13.0-beta.1

package/dist/{chunk-G5AJUV7O.js → chunk-XXDTBMNV.js}

@@ -8,7 +8,7 @@ var require_package = __commonJS({
   "package.json"(exports, module) {
     module.exports = {
       name: "@mendable/firecrawl-js",
-      version: "4.12.0",
+      version: "4.13.0-beta.1",
       description: "JavaScript SDK for Firecrawl API",
       main: "dist/index.js",
       types: "dist/index.d.ts",
@@ -34,7 +34,7 @@ var require_package = __commonJS({
       author: "Mendable.ai",
       license: "MIT",
       dependencies: {
-        axios: "^1.12.2",
+        axios: "^1.13.5",
         "typescript-event-target": "^1.1.1",
         zod: "^3.23.8",
         "zod-to-json-schema": "^3.23.0"
@@ -71,11 +71,7 @@ var require_package = __commonJS({
       },
       pnpm: {
         overrides: {
-          "@babel/helpers@<7.26.10": ">=7.26.10",
-          "brace-expansion@>=1.0.0 <=1.1.11": ">=1.1.12",
-          "brace-expansion@>=2.0.0 <=2.0.1": ">=2.0.2",
-          "js-yaml@<3.14.2": ">=3.14.2",
-          "glob@>=10.2.0 <10.5.0": ">=10.5.0"
+          "@isaacs/brace-expansion@<=5.0.0": ">=5.0.1"
         }
       }
     };

package/dist/index.cjs

@@ -35,7 +35,7 @@ var require_package = __commonJS({
   "package.json"(exports2, module2) {
     module2.exports = {
       name: "@mendable/firecrawl-js",
-      version: "4.12.0",
+      version: "4.13.0-beta.1",
       description: "JavaScript SDK for Firecrawl API",
       main: "dist/index.js",
       types: "dist/index.d.ts",
@@ -61,7 +61,7 @@ var require_package = __commonJS({
       author: "Mendable.ai",
       license: "MIT",
       dependencies: {
-        axios: "^1.12.2",
+        axios: "^1.13.5",
         "typescript-event-target": "^1.1.1",
         zod: "^3.23.8",
         "zod-to-json-schema": "^3.23.0"
@@ -98,11 +98,7 @@ var require_package = __commonJS({
       },
       pnpm: {
         overrides: {
-          "@babel/helpers@<7.26.10": ">=7.26.10",
-          "brace-expansion@>=1.0.0 <=1.1.11": ">=1.1.12",
-          "brace-expansion@>=2.0.0 <=2.0.1": ">=2.0.2",
-          "js-yaml@<3.14.2": ">=3.14.2",
-          "glob@>=10.2.0 <10.5.0": ">=10.5.0"
+          "@isaacs/brace-expansion@<=5.0.0": ">=5.0.1"
         }
       }
     };
@@ -110,17 +106,17 @@ var require_package = __commonJS({
 });
 
 // src/index.ts
-var index_exports = {};
-__export(index_exports, {
+var src_exports = {};
+__export(src_exports, {
   Firecrawl: () => Firecrawl,
   FirecrawlAppV1: () => FirecrawlApp,
   FirecrawlClient: () => FirecrawlClient,
   JobTimeoutError: () => JobTimeoutError,
   SdkError: () => SdkError,
   Watcher: () => Watcher,
-  default: () => index_default
+  default: () => src_default
 });
-module.exports = __toCommonJS(index_exports);
+module.exports = __toCommonJS(src_exports);
 
 // src/v2/utils/httpClient.ts
 var import_axios = __toESM(require("axios"), 1);
@@ -932,6 +928,63 @@ async function cancelAgent(http, jobId) {
   }
 }
 
+// src/v2/methods/browser.ts
+async function browser(http, args = {}) {
+  const body = {};
+  if (args.ttlTotal != null) body.ttlTotal = args.ttlTotal;
+  if (args.ttlWithoutActivity != null) body.ttlWithoutActivity = args.ttlWithoutActivity;
+  if (args.streamWebView != null) body.streamWebView = args.streamWebView;
+  try {
+    const res = await http.post("/v2/browser", body);
+    if (res.status !== 200) throwForBadResponse(res, "create browser session");
+    return res.data;
+  } catch (err) {
+    if (err?.isAxiosError) return normalizeAxiosError(err, "create browser session");
+    throw err;
+  }
+}
+async function browserExecute(http, sessionId, args) {
+  const body = {
+    code: args.code,
+    language: args.language ?? "python"
+  };
+  try {
+    const res = await http.post(
+      `/v2/browser/${sessionId}/execute`,
+      body
+    );
+    if (res.status !== 200) throwForBadResponse(res, "execute browser code");
+    return res.data;
+  } catch (err) {
+    if (err?.isAxiosError) return normalizeAxiosError(err, "execute browser code");
+    throw err;
+  }
+}
+async function deleteBrowser(http, sessionId) {
+  try {
+    const res = await http.delete(
+      `/v2/browser/${sessionId}`
+    );
+    if (res.status !== 200) throwForBadResponse(res, "delete browser session");
+    return res.data;
+  } catch (err) {
+    if (err?.isAxiosError) return normalizeAxiosError(err, "delete browser session");
+    throw err;
+  }
+}
+async function listBrowsers(http, args = {}) {
+  let endpoint = "/v2/browser";
+  if (args.status) endpoint += `?status=${args.status}`;
+  try {
+    const res = await http.get(endpoint);
+    if (res.status !== 200) throwForBadResponse(res, "list browser sessions");
+    return res.data;
+  } catch (err) {
+    if (err?.isAxiosError) return normalizeAxiosError(err, "list browser sessions");
+    throw err;
+  }
+}
+
 // src/v2/methods/usage.ts
 async function getConcurrency(http) {
   try {
@@ -1425,6 +1478,39 @@ var FirecrawlClient = class {
   async cancelAgent(jobId) {
     return cancelAgent(this.http, jobId);
   }
+  // Browser
+  /**
+   * Create a new browser session.
+   * @param args Session options (ttlTotal, ttlWithoutActivity, streamWebView).
+   * @returns Session id and CDP URL.
+   */
+  async browser(args = {}) {
+    return browser(this.http, args);
+  }
+  /**
+   * Execute code in a browser session.
+   * @param sessionId Browser session id.
+   * @param args Code and language to execute.
+   * @returns Execution result.
+   */
+  async browserExecute(sessionId, args) {
+    return browserExecute(this.http, sessionId, args);
+  }
+  /**
+   * Delete a browser session.
+   * @param sessionId Browser session id.
+   */
+  async deleteBrowser(sessionId) {
+    return deleteBrowser(this.http, sessionId);
+  }
+  /**
+   * List browser sessions.
+   * @param args Optional filter (status: "active" | "destroyed").
+   * @returns List of browser sessions.
+   */
+  async listBrowsers(args = {}) {
+    return listBrowsers(this.http, args);
+  }
   // Usage
   /** Current concurrency usage. */
   async getConcurrency() {
@@ -1465,7 +1551,7 @@ var FirecrawlClient = class {
 var import_axios3 = __toESM(require("axios"), 1);
 var zt2 = require("zod");
 
-// node_modules/.pnpm/typescript-event-target@1.1.1/node_modules/typescript-event-target/dist/index.mjs
+// node_modules/typescript-event-target/dist/index.mjs
 var e = class extends EventTarget {
   dispatchTypedEvent(s, t) {
     return super.dispatchEvent(t);
@@ -2865,7 +2951,7 @@ var Firecrawl = class extends FirecrawlClient {
     return this._v1;
   }
 };
-var index_default = Firecrawl;
+var src_default = Firecrawl;
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   Firecrawl,

package/dist/index.d.cts

@@ -554,6 +554,34 @@ interface QueueStatusResponse$1 {
     maxConcurrency: number;
     mostRecentSuccess: string | null;
 }
+interface BrowserCreateResponse {
+    success: boolean;
+    id?: string;
+    cdpUrl?: string;
+    error?: string;
+}
+interface BrowserExecuteResponse {
+    success: boolean;
+    result?: string;
+    error?: string;
+}
+interface BrowserDeleteResponse {
+    success: boolean;
+    error?: string;
+}
+interface BrowserSession {
+    id: string;
+    status: string;
+    cdpUrl: string;
+    streamWebView: boolean;
+    createdAt: string;
+    lastActivity: string;
+}
+interface BrowserListResponse {
+    success: boolean;
+    sessions?: BrowserSession[];
+    error?: string;
+}
 
 interface HttpClientOptions {
     apiKey: string;
@@ -573,9 +601,9 @@ declare class HttpClient {
     getApiKey(): string;
     private request;
     private sleep;
-    post<T = any>(endpoint: string, body: Record<string, unknown>, headers?: Record<string, string>): Promise<AxiosResponse<T, any, {}>>;
-    get<T = any>(endpoint: string, headers?: Record<string, string>): Promise<AxiosResponse<T, any, {}>>;
-    delete<T = any>(endpoint: string, headers?: Record<string, string>): Promise<AxiosResponse<T, any, {}>>;
+    post<T = any>(endpoint: string, body: Record<string, unknown>, headers?: Record<string, string>): Promise<AxiosResponse<T, any>>;
+    get<T = any>(endpoint: string, headers?: Record<string, string>): Promise<AxiosResponse<T, any>>;
+    delete<T = any>(endpoint: string, headers?: Record<string, string>): Promise<AxiosResponse<T, any>>;
     prepareHeaders(idempotencyKey?: string): Record<string, string>;
 }
 
@@ -606,6 +634,19 @@ declare function prepareAgentPayload(args: {
 }): Record<string, unknown>;
 declare function startAgent(http: HttpClient, args: Parameters<typeof prepareAgentPayload>[0]): Promise<AgentResponse>;
 
+declare function browser(http: HttpClient, args?: {
+    ttlTotal?: number;
+    ttlWithoutActivity?: number;
+    streamWebView?: boolean;
+}): Promise<BrowserCreateResponse>;
+declare function browserExecute(http: HttpClient, sessionId: string, args: {
+    code: string;
+    language?: "python" | "js";
+}): Promise<BrowserExecuteResponse>;
+declare function listBrowsers(http: HttpClient, args?: {
+    status?: "active" | "destroyed";
+}): Promise<BrowserListResponse>;
+
 type JobKind = "crawl" | "batch";
 interface WatcherOptions {
     kind?: JobKind;
@@ -811,6 +852,30 @@ declare class FirecrawlClient {
      * @returns True if cancelled.
      */
     cancelAgent(jobId: string): Promise<boolean>;
+    /**
+     * Create a new browser session.
+     * @param args Session options (ttlTotal, ttlWithoutActivity, streamWebView).
+     * @returns Session id and CDP URL.
+     */
+    browser(args?: Parameters<typeof browser>[1]): Promise<BrowserCreateResponse>;
+    /**
+     * Execute code in a browser session.
+     * @param sessionId Browser session id.
+     * @param args Code and language to execute.
+     * @returns Execution result.
+     */
+    browserExecute(sessionId: string, args: Parameters<typeof browserExecute>[2]): Promise<BrowserExecuteResponse>;
+    /**
+     * Delete a browser session.
+     * @param sessionId Browser session id.
+     */
+    deleteBrowser(sessionId: string): Promise<BrowserDeleteResponse>;
+    /**
+     * List browser sessions.
+     * @param args Optional filter (status: "active" | "destroyed").
+     * @returns List of browser sessions.
+     */
+    listBrowsers(args?: Parameters<typeof listBrowsers>[1]): Promise<BrowserListResponse>;
     /** Current concurrency usage. */
     getConcurrency(): Promise<ConcurrencyCheck>;
     /** Current credit usage. */
@@ -1736,4 +1801,4 @@ declare class Firecrawl extends FirecrawlClient {
     get v1(): FirecrawlApp;
 }
 
-export { type ActionOption, type ActiveCrawl, type ActiveCrawlsResponse, type AgentOptions$1 as AgentOptions, type AgentResponse, type AgentStatusResponse, type AgentWebhookConfig, type AgentWebhookEvent, type AttributesFormat, type BatchScrapeJob, type BatchScrapeOptions, type BatchScrapeResponse$1 as BatchScrapeResponse, type BrandingProfile, type CategoryOption, type ChangeTrackingFormat, type ClickAction, type ConcurrencyCheck, type CrawlErrorsResponse$1 as CrawlErrorsResponse, type CrawlJob, type CrawlOptions, type CrawlResponse$1 as CrawlResponse, type CreditUsage, type CreditUsageHistoricalPeriod, type CreditUsageHistoricalResponse, type Document, type DocumentMetadata, type ErrorDetails, type ExecuteJavascriptAction, type ExtractResponse$1 as ExtractResponse, Firecrawl, FirecrawlApp as FirecrawlAppV1, FirecrawlClient, type FirecrawlClientOptions, type Format, type FormatOption, type FormatString, JobTimeoutError, type JsonFormat, type LocationConfig$1 as LocationConfig, type MapData, type MapOptions, type PDFAction, type PaginationConfig, type PressAction, type QueueStatusResponse$1 as QueueStatusResponse, type ScrapeAction, type ScrapeOptions, type ScreenshotAction, type ScreenshotFormat, type ScrollAction, SdkError, type SearchData, type SearchRequest, type SearchResultImages, type SearchResultNews, type SearchResultWeb, type TokenUsage, type TokenUsageHistoricalPeriod, type TokenUsageHistoricalResponse, type Viewport, type WaitAction, Watcher, type WatcherOptions, type WebhookConfig, type WriteAction, Firecrawl as default };
+export { type ActionOption, type ActiveCrawl, type ActiveCrawlsResponse, type AgentOptions$1 as AgentOptions, type AgentResponse, type AgentStatusResponse, type AgentWebhookConfig, type AgentWebhookEvent, type AttributesFormat, type BatchScrapeJob, type BatchScrapeOptions, type BatchScrapeResponse$1 as BatchScrapeResponse, type BrandingProfile, type BrowserCreateResponse, type BrowserDeleteResponse, type BrowserExecuteResponse, type BrowserListResponse, type BrowserSession, type CategoryOption, type ChangeTrackingFormat, type ClickAction, type ConcurrencyCheck, type CrawlErrorsResponse$1 as CrawlErrorsResponse, type CrawlJob, type CrawlOptions, type CrawlResponse$1 as CrawlResponse, type CreditUsage, type CreditUsageHistoricalPeriod, type CreditUsageHistoricalResponse, type Document, type DocumentMetadata, type ErrorDetails, type ExecuteJavascriptAction, type ExtractResponse$1 as ExtractResponse, Firecrawl, FirecrawlApp as FirecrawlAppV1, FirecrawlClient, type FirecrawlClientOptions, type Format, type FormatOption, type FormatString, JobTimeoutError, type JsonFormat, type LocationConfig$1 as LocationConfig, type MapData, type MapOptions, type PDFAction, type PaginationConfig, type PressAction, type QueueStatusResponse$1 as QueueStatusResponse, type ScrapeAction, type ScrapeOptions, type ScreenshotAction, type ScreenshotFormat, type ScrollAction, SdkError, type SearchData, type SearchRequest, type SearchResultImages, type SearchResultNews, type SearchResultWeb, type TokenUsage, type TokenUsageHistoricalPeriod, type TokenUsageHistoricalResponse, type Viewport, type WaitAction, Watcher, type WatcherOptions, type WebhookConfig, type WriteAction, Firecrawl as default };

package/dist/index.d.ts

@@ -554,6 +554,34 @@ interface QueueStatusResponse$1 {
     maxConcurrency: number;
     mostRecentSuccess: string | null;
 }
+interface BrowserCreateResponse {
+    success: boolean;
+    id?: string;
+    cdpUrl?: string;
+    error?: string;
+}
+interface BrowserExecuteResponse {
+    success: boolean;
+    result?: string;
+    error?: string;
+}
+interface BrowserDeleteResponse {
+    success: boolean;
+    error?: string;
+}
+interface BrowserSession {
+    id: string;
+    status: string;
+    cdpUrl: string;
+    streamWebView: boolean;
+    createdAt: string;
+    lastActivity: string;
+}
+interface BrowserListResponse {
+    success: boolean;
+    sessions?: BrowserSession[];
+    error?: string;
+}
 
 interface HttpClientOptions {
     apiKey: string;
@@ -573,9 +601,9 @@ declare class HttpClient {
     getApiKey(): string;
     private request;
     private sleep;
-    post<T = any>(endpoint: string, body: Record<string, unknown>, headers?: Record<string, string>): Promise<AxiosResponse<T, any, {}>>;
-    get<T = any>(endpoint: string, headers?: Record<string, string>): Promise<AxiosResponse<T, any, {}>>;
-    delete<T = any>(endpoint: string, headers?: Record<string, string>): Promise<AxiosResponse<T, any, {}>>;
+    post<T = any>(endpoint: string, body: Record<string, unknown>, headers?: Record<string, string>): Promise<AxiosResponse<T, any>>;
+    get<T = any>(endpoint: string, headers?: Record<string, string>): Promise<AxiosResponse<T, any>>;
+    delete<T = any>(endpoint: string, headers?: Record<string, string>): Promise<AxiosResponse<T, any>>;
     prepareHeaders(idempotencyKey?: string): Record<string, string>;
 }
 
@@ -606,6 +634,19 @@ declare function prepareAgentPayload(args: {
 }): Record<string, unknown>;
 declare function startAgent(http: HttpClient, args: Parameters<typeof prepareAgentPayload>[0]): Promise<AgentResponse>;
 
+declare function browser(http: HttpClient, args?: {
+    ttlTotal?: number;
+    ttlWithoutActivity?: number;
+    streamWebView?: boolean;
+}): Promise<BrowserCreateResponse>;
+declare function browserExecute(http: HttpClient, sessionId: string, args: {
+    code: string;
+    language?: "python" | "js";
+}): Promise<BrowserExecuteResponse>;
+declare function listBrowsers(http: HttpClient, args?: {
+    status?: "active" | "destroyed";
+}): Promise<BrowserListResponse>;
+
 type JobKind = "crawl" | "batch";
 interface WatcherOptions {
     kind?: JobKind;
@@ -811,6 +852,30 @@ declare class FirecrawlClient {
      * @returns True if cancelled.
      */
     cancelAgent(jobId: string): Promise<boolean>;
+    /**
+     * Create a new browser session.
+     * @param args Session options (ttlTotal, ttlWithoutActivity, streamWebView).
+     * @returns Session id and CDP URL.
+     */
+    browser(args?: Parameters<typeof browser>[1]): Promise<BrowserCreateResponse>;
+    /**
+     * Execute code in a browser session.
+     * @param sessionId Browser session id.
+     * @param args Code and language to execute.
+     * @returns Execution result.
+     */
+    browserExecute(sessionId: string, args: Parameters<typeof browserExecute>[2]): Promise<BrowserExecuteResponse>;
+    /**
+     * Delete a browser session.
+     * @param sessionId Browser session id.
+     */
+    deleteBrowser(sessionId: string): Promise<BrowserDeleteResponse>;
+    /**
+     * List browser sessions.
+     * @param args Optional filter (status: "active" | "destroyed").
+     * @returns List of browser sessions.
+     */
+    listBrowsers(args?: Parameters<typeof listBrowsers>[1]): Promise<BrowserListResponse>;
     /** Current concurrency usage. */
     getConcurrency(): Promise<ConcurrencyCheck>;
     /** Current credit usage. */
@@ -1736,4 +1801,4 @@ declare class Firecrawl extends FirecrawlClient {
     get v1(): FirecrawlApp;
 }
 
-export { type ActionOption, type ActiveCrawl, type ActiveCrawlsResponse, type AgentOptions$1 as AgentOptions, type AgentResponse, type AgentStatusResponse, type AgentWebhookConfig, type AgentWebhookEvent, type AttributesFormat, type BatchScrapeJob, type BatchScrapeOptions, type BatchScrapeResponse$1 as BatchScrapeResponse, type BrandingProfile, type CategoryOption, type ChangeTrackingFormat, type ClickAction, type ConcurrencyCheck, type CrawlErrorsResponse$1 as CrawlErrorsResponse, type CrawlJob, type CrawlOptions, type CrawlResponse$1 as CrawlResponse, type CreditUsage, type CreditUsageHistoricalPeriod, type CreditUsageHistoricalResponse, type Document, type DocumentMetadata, type ErrorDetails, type ExecuteJavascriptAction, type ExtractResponse$1 as ExtractResponse, Firecrawl, FirecrawlApp as FirecrawlAppV1, FirecrawlClient, type FirecrawlClientOptions, type Format, type FormatOption, type FormatString, JobTimeoutError, type JsonFormat, type LocationConfig$1 as LocationConfig, type MapData, type MapOptions, type PDFAction, type PaginationConfig, type PressAction, type QueueStatusResponse$1 as QueueStatusResponse, type ScrapeAction, type ScrapeOptions, type ScreenshotAction, type ScreenshotFormat, type ScrollAction, SdkError, type SearchData, type SearchRequest, type SearchResultImages, type SearchResultNews, type SearchResultWeb, type TokenUsage, type TokenUsageHistoricalPeriod, type TokenUsageHistoricalResponse, type Viewport, type WaitAction, Watcher, type WatcherOptions, type WebhookConfig, type WriteAction, Firecrawl as default };
+export { type ActionOption, type ActiveCrawl, type ActiveCrawlsResponse, type AgentOptions$1 as AgentOptions, type AgentResponse, type AgentStatusResponse, type AgentWebhookConfig, type AgentWebhookEvent, type AttributesFormat, type BatchScrapeJob, type BatchScrapeOptions, type BatchScrapeResponse$1 as BatchScrapeResponse, type BrandingProfile, type BrowserCreateResponse, type BrowserDeleteResponse, type BrowserExecuteResponse, type BrowserListResponse, type BrowserSession, type CategoryOption, type ChangeTrackingFormat, type ClickAction, type ConcurrencyCheck, type CrawlErrorsResponse$1 as CrawlErrorsResponse, type CrawlJob, type CrawlOptions, type CrawlResponse$1 as CrawlResponse, type CreditUsage, type CreditUsageHistoricalPeriod, type CreditUsageHistoricalResponse, type Document, type DocumentMetadata, type ErrorDetails, type ExecuteJavascriptAction, type ExtractResponse$1 as ExtractResponse, Firecrawl, FirecrawlApp as FirecrawlAppV1, FirecrawlClient, type FirecrawlClientOptions, type Format, type FormatOption, type FormatString, JobTimeoutError, type JsonFormat, type LocationConfig$1 as LocationConfig, type MapData, type MapOptions, type PDFAction, type PaginationConfig, type PressAction, type QueueStatusResponse$1 as QueueStatusResponse, type ScrapeAction, type ScrapeOptions, type ScreenshotAction, type ScreenshotFormat, type ScrollAction, SdkError, type SearchData, type SearchRequest, type SearchResultImages, type SearchResultNews, type SearchResultWeb, type TokenUsage, type TokenUsageHistoricalPeriod, type TokenUsageHistoricalResponse, type Viewport, type WaitAction, Watcher, type WatcherOptions, type WebhookConfig, type WriteAction, Firecrawl as default };

package/dist/index.js

@@ -1,6 +1,6 @@
 import {
   require_package
-} from "./chunk-G5AJUV7O.js";
+} from "./chunk-XXDTBMNV.js";
 
 // src/v2/utils/httpClient.ts
 import axios from "axios";
@@ -812,6 +812,63 @@ async function cancelAgent(http, jobId) {
   }
 }
 
+// src/v2/methods/browser.ts
+async function browser(http, args = {}) {
+  const body = {};
+  if (args.ttlTotal != null) body.ttlTotal = args.ttlTotal;
+  if (args.ttlWithoutActivity != null) body.ttlWithoutActivity = args.ttlWithoutActivity;
+  if (args.streamWebView != null) body.streamWebView = args.streamWebView;
+  try {
+    const res = await http.post("/v2/browser", body);
+    if (res.status !== 200) throwForBadResponse(res, "create browser session");
+    return res.data;
+  } catch (err) {
+    if (err?.isAxiosError) return normalizeAxiosError(err, "create browser session");
+    throw err;
+  }
+}
+async function browserExecute(http, sessionId, args) {
+  const body = {
+    code: args.code,
+    language: args.language ?? "python"
+  };
+  try {
+    const res = await http.post(
+      `/v2/browser/${sessionId}/execute`,
+      body
+    );
+    if (res.status !== 200) throwForBadResponse(res, "execute browser code");
+    return res.data;
+  } catch (err) {
+    if (err?.isAxiosError) return normalizeAxiosError(err, "execute browser code");
+    throw err;
+  }
+}
+async function deleteBrowser(http, sessionId) {
+  try {
+    const res = await http.delete(
+      `/v2/browser/${sessionId}`
+    );
+    if (res.status !== 200) throwForBadResponse(res, "delete browser session");
+    return res.data;
+  } catch (err) {
+    if (err?.isAxiosError) return normalizeAxiosError(err, "delete browser session");
+    throw err;
+  }
+}
+async function listBrowsers(http, args = {}) {
+  let endpoint = "/v2/browser";
+  if (args.status) endpoint += `?status=${args.status}`;
+  try {
+    const res = await http.get(endpoint);
+    if (res.status !== 200) throwForBadResponse(res, "list browser sessions");
+    return res.data;
+  } catch (err) {
+    if (err?.isAxiosError) return normalizeAxiosError(err, "list browser sessions");
+    throw err;
+  }
+}
+
 // src/v2/methods/usage.ts
 async function getConcurrency(http) {
   try {
@@ -902,7 +959,7 @@ var loadPromise;
 var loadNodeWebSocket = async () => {
   if (!isNodeRuntime()) return void 0;
   try {
-    const undici = await import("undici");
+    const undici = await import("node:undici");
     const ctor = undici.WebSocket ?? undici.default?.WebSocket;
     return typeof ctor === "function" ? ctor : void 0;
   } catch {
@@ -1305,6 +1362,39 @@ var FirecrawlClient = class {
   async cancelAgent(jobId) {
     return cancelAgent(this.http, jobId);
   }
+  // Browser
+  /**
+   * Create a new browser session.
+   * @param args Session options (ttlTotal, ttlWithoutActivity, streamWebView).
+   * @returns Session id and CDP URL.
+   */
+  async browser(args = {}) {
+    return browser(this.http, args);
+  }
+  /**
+   * Execute code in a browser session.
+   * @param sessionId Browser session id.
+   * @param args Code and language to execute.
+   * @returns Execution result.
+   */
+  async browserExecute(sessionId, args) {
+    return browserExecute(this.http, sessionId, args);
+  }
+  /**
+   * Delete a browser session.
+   * @param sessionId Browser session id.
+   */
+  async deleteBrowser(sessionId) {
+    return deleteBrowser(this.http, sessionId);
+  }
+  /**
+   * List browser sessions.
+   * @param args Optional filter (status: "active" | "destroyed").
+   * @returns List of browser sessions.
+   */
+  async listBrowsers(args = {}) {
+    return listBrowsers(this.http, args);
+  }
   // Usage
   /** Current concurrency usage. */
   async getConcurrency() {
@@ -1345,7 +1435,7 @@ var FirecrawlClient = class {
 import axios2, { AxiosError } from "axios";
 import "zod";
 
-// node_modules/.pnpm/typescript-event-target@1.1.1/node_modules/typescript-event-target/dist/index.mjs
+// node_modules/typescript-event-target/dist/index.mjs
 var e = class extends EventTarget {
   dispatchTypedEvent(s, t) {
     return super.dispatchEvent(t);
@@ -1374,7 +1464,7 @@ 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-T35BK7SG.js");
+      const packageJson = await import("./package-WXWM2ZOD.js");
       return packageJson.default.version;
     } catch (error) {
       const isTest = typeof process !== "undefined" && (process.env.JEST_WORKER_ID != null || false);
@@ -2745,7 +2835,7 @@ var Firecrawl = class extends FirecrawlClient {
     return this._v1;
   }
 };
-var index_default = Firecrawl;
+var src_default = Firecrawl;
 export {
   Firecrawl,
   FirecrawlApp as FirecrawlAppV1,
@@ -2753,5 +2843,5 @@ export {
   JobTimeoutError,
   SdkError,
   Watcher,
-  index_default as default
+  src_default as default
 };

package/dist/{package-T35BK7SG.js → package-WXWM2ZOD.js}

@@ -1,4 +1,4 @@
 import {
   require_package
-} from "./chunk-G5AJUV7O.js";
+} from "./chunk-XXDTBMNV.js";
 export default require_package();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mendable/firecrawl-js",
-  "version": "4.12.0",
+  "version": "4.13.0-beta.1",
   "description": "JavaScript SDK for Firecrawl API",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -19,7 +19,7 @@
   "author": "Mendable.ai",
   "license": "MIT",
   "dependencies": {
-    "axios": "^1.12.2",
+    "axios": "^1.13.5",
     "typescript-event-target": "^1.1.1",
     "zod": "^3.23.8",
     "zod-to-json-schema": "^3.23.0"

package/src/__tests__/e2e/v1/index.test.ts

@@ -33,10 +33,10 @@ describe('FirecrawlApp E2E Tests', () => {
     }
   });
 
-  test.concurrent('should throw error for blocklisted URL on scrape', async () => {
+  test.concurrent('should throw error for unsupported URL on scrape', async () => {
     const app = new FirecrawlApp({ apiKey: TEST_API_KEY, apiUrl: API_URL });
-    const blocklistedUrl = "https://facebook.com/fake-test";
-    await expect(app.scrapeUrl(blocklistedUrl)).rejects.toThrow("This website is not currently supported");
+    const unsupportedUrl = "https://facebook.com/fake-test";
+    await expect(app.scrapeUrl(unsupportedUrl)).rejects.toThrow("do not support this site");
   });
 
   test.concurrent('should return successful response for valid scrape', async () => {
@@ -243,10 +243,10 @@ describe('FirecrawlApp E2E Tests', () => {
     }
   });
 
-  test.concurrent('should throw error for blocklisted URL on map', async () => {
+  test.concurrent('should throw error for unsupported URL on map', async () => {
     const app = new FirecrawlApp({ apiKey: TEST_API_KEY, apiUrl: API_URL });
-    const blocklistedUrl = "https://facebook.com/fake-test";
-    await expect(app.mapUrl(blocklistedUrl)).rejects.toThrow("403");
+    const unsupportedUrl = "https://facebook.com/fake-test";
+    await expect(app.mapUrl(unsupportedUrl)).rejects.toThrow("403");
   });
 
   test.concurrent('should return successful response for valid map', async () => {

package/src/v2/client.ts

@@ -20,6 +20,12 @@ import {
 } from "./methods/batch";
 import { startExtract, getExtractStatus, extract as extractWaiter } from "./methods/extract";
 import { startAgent, getAgentStatus, cancelAgent, agent as agentWaiter } from "./methods/agent";
+import {
+  browser as browserMethod,
+  browserExecute,
+  deleteBrowser,
+  listBrowsers,
+} from "./methods/browser";
 import { getConcurrency, getCreditUsage, getQueueStatus, getTokenUsage, getCreditUsageHistorical, getTokenUsageHistorical } from "./methods/usage";
 import type {
   Document,
@@ -40,6 +46,10 @@ import type {
   CrawlOptions,
   BatchScrapeOptions,
   PaginationConfig,
+  BrowserCreateResponse,
+  BrowserExecuteResponse,
+  BrowserDeleteResponse,
+  BrowserListResponse,
 } from "./types";
 import { Watcher } from "./watcher";
 import type { WatcherOptions } from "./watcher";
@@ -298,6 +308,47 @@ export class FirecrawlClient {
     return cancelAgent(this.http, jobId);
   }
 
+  // Browser
+  /**
+   * Create a new browser session.
+   * @param args Session options (ttlTotal, ttlWithoutActivity, streamWebView).
+   * @returns Session id and CDP URL.
+   */
+  async browser(
+    args: Parameters<typeof browserMethod>[1] = {}
+  ): Promise<BrowserCreateResponse> {
+    return browserMethod(this.http, args);
+  }
+  /**
+   * Execute code in a browser session.
+   * @param sessionId Browser session id.
+   * @param args Code and language to execute.
+   * @returns Execution result.
+   */
+  async browserExecute(
+    sessionId: string,
+    args: Parameters<typeof browserExecute>[2]
+  ): Promise<BrowserExecuteResponse> {
+    return browserExecute(this.http, sessionId, args);
+  }
+  /**
+   * Delete a browser session.
+   * @param sessionId Browser session id.
+   */
+  async deleteBrowser(sessionId: string): Promise<BrowserDeleteResponse> {
+    return deleteBrowser(this.http, sessionId);
+  }
+  /**
+   * List browser sessions.
+   * @param args Optional filter (status: "active" | "destroyed").
+   * @returns List of browser sessions.
+   */
+  async listBrowsers(
+    args: Parameters<typeof listBrowsers>[1] = {}
+  ): Promise<BrowserListResponse> {
+    return listBrowsers(this.http, args);
+  }
+
   // Usage
   /** Current concurrency usage. */
   async getConcurrency() {

package/src/v2/methods/browser.ts

@@ -0,0 +1,92 @@
+import type {
+  BrowserCreateResponse,
+  BrowserExecuteResponse,
+  BrowserDeleteResponse,
+  BrowserListResponse,
+} from "../types";
+import { HttpClient } from "../utils/httpClient";
+import { normalizeAxiosError, throwForBadResponse } from "../utils/errorHandler";
+
+export async function browser(
+  http: HttpClient,
+  args: {
+    ttlTotal?: number;
+    ttlWithoutActivity?: number;
+    streamWebView?: boolean;
+  } = {}
+): Promise<BrowserCreateResponse> {
+  const body: Record<string, unknown> = {};
+  if (args.ttlTotal != null) body.ttlTotal = args.ttlTotal;
+  if (args.ttlWithoutActivity != null) body.ttlWithoutActivity = args.ttlWithoutActivity;
+  if (args.streamWebView != null) body.streamWebView = args.streamWebView;
+
+  try {
+    const res = await http.post<BrowserCreateResponse>("/v2/browser", body);
+    if (res.status !== 200) throwForBadResponse(res, "create browser session");
+    return res.data;
+  } catch (err: any) {
+    if (err?.isAxiosError) return normalizeAxiosError(err, "create browser session");
+    throw err;
+  }
+}
+
+export async function browserExecute(
+  http: HttpClient,
+  sessionId: string,
+  args: {
+    code: string;
+    language?: "python" | "js";
+  }
+): Promise<BrowserExecuteResponse> {
+  const body: Record<string, unknown> = {
+    code: args.code,
+    language: args.language ?? "python",
+  };
+
+  try {
+    const res = await http.post<BrowserExecuteResponse>(
+      `/v2/browser/${sessionId}/execute`,
+      body
+    );
+    if (res.status !== 200) throwForBadResponse(res, "execute browser code");
+    return res.data;
+  } catch (err: any) {
+    if (err?.isAxiosError) return normalizeAxiosError(err, "execute browser code");
+    throw err;
+  }
+}
+
+export async function deleteBrowser(
+  http: HttpClient,
+  sessionId: string
+): Promise<BrowserDeleteResponse> {
+  try {
+    const res = await http.delete<BrowserDeleteResponse>(
+      `/v2/browser/${sessionId}`
+    );
+    if (res.status !== 200) throwForBadResponse(res, "delete browser session");
+    return res.data;
+  } catch (err: any) {
+    if (err?.isAxiosError) return normalizeAxiosError(err, "delete browser session");
+    throw err;
+  }
+}
+
+export async function listBrowsers(
+  http: HttpClient,
+  args: {
+    status?: "active" | "destroyed";
+  } = {}
+): Promise<BrowserListResponse> {
+  let endpoint = "/v2/browser";
+  if (args.status) endpoint += `?status=${args.status}`;
+
+  try {
+    const res = await http.get<BrowserListResponse>(endpoint);
+    if (res.status !== 200) throwForBadResponse(res, "list browser sessions");
+    return res.data;
+  } catch (err: any) {
+    if (err?.isAxiosError) return normalizeAxiosError(err, "list browser sessions");
+    throw err;
+  }
+}

package/src/v2/types.ts

@@ -683,3 +683,37 @@ export interface QueueStatusResponse {
   maxConcurrency: number;
   mostRecentSuccess: string | null;
 }
+
+// Browser types
+export interface BrowserCreateResponse {
+  success: boolean;
+  id?: string;
+  cdpUrl?: string;
+  error?: string;
+}
+
+export interface BrowserExecuteResponse {
+  success: boolean;
+  result?: string;
+  error?: string;
+}
+
+export interface BrowserDeleteResponse {
+  success: boolean;
+  error?: string;
+}
+
+export interface BrowserSession {
+  id: string;
+  status: string;
+  cdpUrl: string;
+  streamWebView: boolean;
+  createdAt: string;
+  lastActivity: string;
+}
+
+export interface BrowserListResponse {
+  success: boolean;
+  sessions?: BrowserSession[];
+  error?: string;
+}