@mendable/firecrawl-js 4.13.0-beta.2 → 4.13.0

package/dist/{chunk-VEC6CWSH.js → chunk-22A4MB4F.js}

@@ -8,7 +8,7 @@ var require_package = __commonJS({
   "package.json"(exports, module) {
     module.exports = {
       name: "@mendable/firecrawl-js",
-      version: "4.13.0-beta.2",
+      version: "4.13.0",
       description: "JavaScript SDK for Firecrawl API",
       main: "dist/index.js",
       types: "dist/index.d.ts",

package/dist/index.cjs

@@ -35,7 +35,7 @@ var require_package = __commonJS({
   "package.json"(exports2, module2) {
     module2.exports = {
       name: "@mendable/firecrawl-js",
-      version: "4.13.0-beta.2",
+      version: "4.13.0",
       description: "JavaScript SDK for Firecrawl API",
       main: "dist/index.js",
       types: "dist/index.d.ts",
@@ -106,17 +106,17 @@ var require_package = __commonJS({
 });
 
 // src/index.ts
-var src_exports = {};
-__export(src_exports, {
+var index_exports = {};
+__export(index_exports, {
   Firecrawl: () => Firecrawl,
   FirecrawlAppV1: () => FirecrawlApp,
   FirecrawlClient: () => FirecrawlClient,
   JobTimeoutError: () => JobTimeoutError,
   SdkError: () => SdkError,
   Watcher: () => Watcher,
-  default: () => src_default
+  default: () => index_default
 });
-module.exports = __toCommonJS(src_exports);
+module.exports = __toCommonJS(index_exports);
 
 // src/v2/utils/httpClient.ts
 var import_axios = __toESM(require("axios"), 1);
@@ -931,8 +931,8 @@ 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.ttl != null) body.ttl = args.ttl;
+  if (args.activityTtl != null) body.activityTtl = args.activityTtl;
   if (args.streamWebView != null) body.streamWebView = args.streamWebView;
   try {
     const res = await http.post("/v2/browser", body);
@@ -946,8 +946,9 @@ async function browser(http, args = {}) {
 async function browserExecute(http, sessionId, args) {
   const body = {
     code: args.code,
-    language: args.language ?? "python"
+    language: args.language ?? "bash"
   };
+  if (args.timeout != null) body.timeout = args.timeout;
   try {
     const res = await http.post(
       `/v2/browser/${sessionId}/execute`,
@@ -1481,8 +1482,8 @@ var FirecrawlClient = class {
   // Browser
   /**
    * Create a new browser session.
-   * @param args Session options (ttlTotal, ttlWithoutActivity, streamWebView).
-   * @returns Session id and CDP URL.
+   * @param args Session options (ttl, activityTtl, streamWebView).
+   * @returns Session id, CDP URL, live view URL, and expiration time.
    */
   async browser(args = {}) {
     return browser(this.http, args);
@@ -1490,8 +1491,8 @@ var FirecrawlClient = class {
   /**
    * Execute code in a browser session.
    * @param sessionId Browser session id.
-   * @param args Code and language to execute.
-   * @returns Execution result.
+   * @param args Code, language ("python" | "node" | "bash"), and optional timeout.
+   * @returns Execution result including stdout, stderr, exitCode, and killed status.
    */
   async browserExecute(sessionId, args) {
     return browserExecute(this.http, sessionId, args);
@@ -1551,7 +1552,7 @@ var FirecrawlClient = class {
 var import_axios3 = __toESM(require("axios"), 1);
 var zt2 = require("zod");
 
-// node_modules/typescript-event-target/dist/index.mjs
+// node_modules/.pnpm/typescript-event-target@1.1.1/node_modules/typescript-event-target/dist/index.mjs
 var e = class extends EventTarget {
   dispatchTypedEvent(s, t) {
     return super.dispatchEvent(t);
@@ -2951,7 +2952,7 @@ var Firecrawl = class extends FirecrawlClient {
     return this._v1;
   }
 };
-var src_default = Firecrawl;
+var index_default = Firecrawl;
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   Firecrawl,

package/dist/index.d.cts

@@ -559,15 +559,22 @@ interface BrowserCreateResponse {
     id?: string;
     cdpUrl?: string;
     liveViewUrl?: string;
+    expiresAt?: string;
     error?: string;
 }
 interface BrowserExecuteResponse {
     success: boolean;
+    stdout?: string;
     result?: string;
+    stderr?: string;
+    exitCode?: number;
+    killed?: boolean;
     error?: string;
 }
 interface BrowserDeleteResponse {
     success: boolean;
+    sessionDurationMs?: number;
+    creditsBilled?: number;
     error?: string;
 }
 interface BrowserSession {
@@ -603,9 +610,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>;
 }
 
@@ -637,13 +644,14 @@ declare function prepareAgentPayload(args: {
 declare function startAgent(http: HttpClient, args: Parameters<typeof prepareAgentPayload>[0]): Promise<AgentResponse>;
 
 declare function browser(http: HttpClient, args?: {
-    ttlTotal?: number;
-    ttlWithoutActivity?: number;
+    ttl?: number;
+    activityTtl?: number;
     streamWebView?: boolean;
 }): Promise<BrowserCreateResponse>;
 declare function browserExecute(http: HttpClient, sessionId: string, args: {
     code: string;
-    language?: "python" | "js";
+    language?: "python" | "node" | "bash";
+    timeout?: number;
 }): Promise<BrowserExecuteResponse>;
 declare function listBrowsers(http: HttpClient, args?: {
     status?: "active" | "destroyed";
@@ -856,15 +864,15 @@ declare class FirecrawlClient {
     cancelAgent(jobId: string): Promise<boolean>;
     /**
      * Create a new browser session.
-     * @param args Session options (ttlTotal, ttlWithoutActivity, streamWebView).
-     * @returns Session id and CDP URL.
+     * @param args Session options (ttl, activityTtl, streamWebView).
+     * @returns Session id, CDP URL, live view URL, and expiration time.
      */
     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.
+     * @param args Code, language ("python" | "node" | "bash"), and optional timeout.
+     * @returns Execution result including stdout, stderr, exitCode, and killed status.
      */
     browserExecute(sessionId: string, args: Parameters<typeof browserExecute>[2]): Promise<BrowserExecuteResponse>;
     /**

package/dist/index.d.ts

@@ -559,15 +559,22 @@ interface BrowserCreateResponse {
     id?: string;
     cdpUrl?: string;
     liveViewUrl?: string;
+    expiresAt?: string;
     error?: string;
 }
 interface BrowserExecuteResponse {
     success: boolean;
+    stdout?: string;
     result?: string;
+    stderr?: string;
+    exitCode?: number;
+    killed?: boolean;
     error?: string;
 }
 interface BrowserDeleteResponse {
     success: boolean;
+    sessionDurationMs?: number;
+    creditsBilled?: number;
     error?: string;
 }
 interface BrowserSession {
@@ -603,9 +610,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>;
 }
 
@@ -637,13 +644,14 @@ declare function prepareAgentPayload(args: {
 declare function startAgent(http: HttpClient, args: Parameters<typeof prepareAgentPayload>[0]): Promise<AgentResponse>;
 
 declare function browser(http: HttpClient, args?: {
-    ttlTotal?: number;
-    ttlWithoutActivity?: number;
+    ttl?: number;
+    activityTtl?: number;
     streamWebView?: boolean;
 }): Promise<BrowserCreateResponse>;
 declare function browserExecute(http: HttpClient, sessionId: string, args: {
     code: string;
-    language?: "python" | "js";
+    language?: "python" | "node" | "bash";
+    timeout?: number;
 }): Promise<BrowserExecuteResponse>;
 declare function listBrowsers(http: HttpClient, args?: {
     status?: "active" | "destroyed";
@@ -856,15 +864,15 @@ declare class FirecrawlClient {
     cancelAgent(jobId: string): Promise<boolean>;
     /**
      * Create a new browser session.
-     * @param args Session options (ttlTotal, ttlWithoutActivity, streamWebView).
-     * @returns Session id and CDP URL.
+     * @param args Session options (ttl, activityTtl, streamWebView).
+     * @returns Session id, CDP URL, live view URL, and expiration time.
      */
     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.
+     * @param args Code, language ("python" | "node" | "bash"), and optional timeout.
+     * @returns Execution result including stdout, stderr, exitCode, and killed status.
      */
     browserExecute(sessionId: string, args: Parameters<typeof browserExecute>[2]): Promise<BrowserExecuteResponse>;
     /**

package/dist/index.js

@@ -1,6 +1,6 @@
 import {
   require_package
-} from "./chunk-VEC6CWSH.js";
+} from "./chunk-22A4MB4F.js";
 
 // src/v2/utils/httpClient.ts
 import axios from "axios";
@@ -815,8 +815,8 @@ 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.ttl != null) body.ttl = args.ttl;
+  if (args.activityTtl != null) body.activityTtl = args.activityTtl;
   if (args.streamWebView != null) body.streamWebView = args.streamWebView;
   try {
     const res = await http.post("/v2/browser", body);
@@ -830,8 +830,9 @@ async function browser(http, args = {}) {
 async function browserExecute(http, sessionId, args) {
   const body = {
     code: args.code,
-    language: args.language ?? "python"
+    language: args.language ?? "bash"
   };
+  if (args.timeout != null) body.timeout = args.timeout;
   try {
     const res = await http.post(
       `/v2/browser/${sessionId}/execute`,
@@ -959,7 +960,7 @@ var loadPromise;
 var loadNodeWebSocket = async () => {
   if (!isNodeRuntime()) return void 0;
   try {
-    const undici = await import("node:undici");
+    const undici = await import("undici");
     const ctor = undici.WebSocket ?? undici.default?.WebSocket;
     return typeof ctor === "function" ? ctor : void 0;
   } catch {
@@ -1365,8 +1366,8 @@ var FirecrawlClient = class {
   // Browser
   /**
    * Create a new browser session.
-   * @param args Session options (ttlTotal, ttlWithoutActivity, streamWebView).
-   * @returns Session id and CDP URL.
+   * @param args Session options (ttl, activityTtl, streamWebView).
+   * @returns Session id, CDP URL, live view URL, and expiration time.
    */
   async browser(args = {}) {
     return browser(this.http, args);
@@ -1374,8 +1375,8 @@ var FirecrawlClient = class {
   /**
    * Execute code in a browser session.
    * @param sessionId Browser session id.
-   * @param args Code and language to execute.
-   * @returns Execution result.
+   * @param args Code, language ("python" | "node" | "bash"), and optional timeout.
+   * @returns Execution result including stdout, stderr, exitCode, and killed status.
    */
   async browserExecute(sessionId, args) {
     return browserExecute(this.http, sessionId, args);
@@ -1435,7 +1436,7 @@ var FirecrawlClient = class {
 import axios2, { AxiosError } from "axios";
 import "zod";
 
-// node_modules/typescript-event-target/dist/index.mjs
+// node_modules/.pnpm/typescript-event-target@1.1.1/node_modules/typescript-event-target/dist/index.mjs
 var e = class extends EventTarget {
   dispatchTypedEvent(s, t) {
     return super.dispatchEvent(t);
@@ -1464,7 +1465,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-BBT366VN.js");
+      const packageJson = await import("./package-5SIMNZMX.js");
       return packageJson.default.version;
     } catch (error) {
       const isTest = typeof process !== "undefined" && (process.env.JEST_WORKER_ID != null || false);
@@ -2835,7 +2836,7 @@ var Firecrawl = class extends FirecrawlClient {
     return this._v1;
   }
 };
-var src_default = Firecrawl;
+var index_default = Firecrawl;
 export {
   Firecrawl,
   FirecrawlApp as FirecrawlAppV1,
@@ -2843,5 +2844,5 @@ export {
   JobTimeoutError,
   SdkError,
   Watcher,
-  src_default as default
+  index_default as default
 };

package/dist/{package-BBT366VN.js → package-5SIMNZMX.js}

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mendable/firecrawl-js",
-  "version": "4.13.0-beta.2",
+  "version": "4.13.0",
   "description": "JavaScript SDK for Firecrawl API",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",

package/src/v2/client.ts

@@ -311,8 +311,8 @@ export class FirecrawlClient {
   // Browser
   /**
    * Create a new browser session.
-   * @param args Session options (ttlTotal, ttlWithoutActivity, streamWebView).
-   * @returns Session id and CDP URL.
+   * @param args Session options (ttl, activityTtl, streamWebView).
+   * @returns Session id, CDP URL, live view URL, and expiration time.
    */
   async browser(
     args: Parameters<typeof browserMethod>[1] = {}
@@ -322,8 +322,8 @@ export class FirecrawlClient {
   /**
    * Execute code in a browser session.
    * @param sessionId Browser session id.
-   * @param args Code and language to execute.
-   * @returns Execution result.
+   * @param args Code, language ("python" | "node" | "bash"), and optional timeout.
+   * @returns Execution result including stdout, stderr, exitCode, and killed status.
    */
   async browserExecute(
     sessionId: string,

package/src/v2/methods/browser.ts

@@ -10,14 +10,14 @@ import { normalizeAxiosError, throwForBadResponse } from "../utils/errorHandler"
 export async function browser(
   http: HttpClient,
   args: {
-    ttlTotal?: number;
-    ttlWithoutActivity?: number;
+    ttl?: number;
+    activityTtl?: 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.ttl != null) body.ttl = args.ttl;
+  if (args.activityTtl != null) body.activityTtl = args.activityTtl;
   if (args.streamWebView != null) body.streamWebView = args.streamWebView;
 
   try {
@@ -35,13 +35,15 @@ export async function browserExecute(
   sessionId: string,
   args: {
     code: string;
-    language?: "python" | "js";
+    language?: "python" | "node" | "bash";
+    timeout?: number;
   }
 ): Promise<BrowserExecuteResponse> {
   const body: Record<string, unknown> = {
     code: args.code,
-    language: args.language ?? "python",
+    language: args.language ?? "bash",
   };
+  if (args.timeout != null) body.timeout = args.timeout;
 
   try {
     const res = await http.post<BrowserExecuteResponse>(

package/src/v2/types.ts

@@ -690,17 +690,24 @@ export interface BrowserCreateResponse {
   id?: string;
   cdpUrl?: string;
   liveViewUrl?: string;
+  expiresAt?: string;
   error?: string;
 }
 
 export interface BrowserExecuteResponse {
   success: boolean;
+  stdout?: string;
   result?: string;
+  stderr?: string;
+  exitCode?: number;
+  killed?: boolean;
   error?: string;
 }
 
 export interface BrowserDeleteResponse {
   success: boolean;
+  sessionDurationMs?: number;
+  creditsBilled?: number;
   error?: string;
 }