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

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

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

package/dist/index.d.cts

@@ -558,21 +558,30 @@ interface BrowserCreateResponse {
     success: boolean;
     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 {
     id: string;
     status: string;
     cdpUrl: string;
+    liveViewUrl: string;
     streamWebView: boolean;
     createdAt: string;
     lastActivity: string;
@@ -635,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";
@@ -854,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

@@ -558,21 +558,30 @@ interface BrowserCreateResponse {
     success: boolean;
     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 {
     id: string;
     status: string;
     cdpUrl: string;
+    liveViewUrl: string;
     streamWebView: boolean;
     createdAt: string;
     lastActivity: string;
@@ -635,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";
@@ -854,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-XXDTBMNV.js";
+} from "./chunk-WBUKU64H.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`,
@@ -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);
@@ -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-WXWM2ZOD.js");
+      const packageJson = await import("./package-Q6GJF2UB.js");
       return packageJson.default.version;
     } catch (error) {
       const isTest = typeof process !== "undefined" && (process.env.JEST_WORKER_ID != null || false);

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

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mendable/firecrawl-js",
-  "version": "4.13.0-beta.1",
+  "version": "4.13.0-beta.3",
   "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

@@ -689,17 +689,25 @@ export interface BrowserCreateResponse {
   success: boolean;
   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;
 }
 
@@ -707,6 +715,7 @@ export interface BrowserSession {
   id: string;
   status: string;
   cdpUrl: string;
+  liveViewUrl: string;
   streamWebView: boolean;
   createdAt: string;
   lastActivity: string;