firecrawl 4.25.3 → 4.25.5

package/audit-ci.jsonc

@@ -1,7 +1,4 @@
 {
     "$schema": "https://github.com/IBM/audit-ci/raw/main/docs/schema.json",
-    "low": true,
-    "allowlist": [
-        "GHSA-w5hq-g745-h8pq"
-    ]
+    "low": true
 }

package/dist/{chunk-5D4KXCYO.js → chunk-L4JQOWAZ.js}

@@ -1,6 +1,10 @@
 var __getOwnPropNames = Object.getOwnPropertyNames;
 var __commonJS = (cb, mod) => function __require() {
-  return mod || (0, cb[__getOwnPropNames(cb)[0]])((mod = { exports: {} }).exports, mod), mod.exports;
+  try {
+    return mod || (0, cb[__getOwnPropNames(cb)[0]])((mod = { exports: {} }).exports, mod), mod.exports;
+  } catch (e) {
+    throw mod = 0, e;
+  }
 };
 
 // package.json
@@ -8,7 +12,7 @@ var require_package = __commonJS({
   "package.json"(exports, module) {
     module.exports = {
       name: "@mendable/firecrawl-js",
-      version: "4.25.3",
+      version: "4.25.5",
       description: "JavaScript SDK for Firecrawl API",
       main: "dist/index.js",
       types: "dist/index.d.ts",
@@ -79,7 +83,8 @@ var require_package = __commonJS({
           handlebars: ">=4.7.9",
           "brace-expansion": ">=5.0.6",
           "axios@>=1.0.0 <1.16.0": "1.16.1",
-          "follow-redirects@<1.16.0": ">=1.16.0 <2.0.0"
+          "follow-redirects@<1.16.0": ">=1.16.0 <2.0.0",
+          "esbuild@>=0.17.0 <0.28.1": "0.28.1"
         }
       }
     };

package/dist/index.cjs

@@ -6,7 +6,11 @@ var __getOwnPropNames = Object.getOwnPropertyNames;
 var __getProtoOf = Object.getPrototypeOf;
 var __hasOwnProp = Object.prototype.hasOwnProperty;
 var __commonJS = (cb, mod) => function __require() {
-  return mod || (0, cb[__getOwnPropNames(cb)[0]])((mod = { exports: {} }).exports, mod), mod.exports;
+  try {
+    return mod || (0, cb[__getOwnPropNames(cb)[0]])((mod = { exports: {} }).exports, mod), mod.exports;
+  } catch (e2) {
+    throw mod = 0, e2;
+  }
 };
 var __export = (target, all) => {
   for (var name in all)
@@ -35,7 +39,7 @@ var require_package = __commonJS({
   "package.json"(exports2, module2) {
     module2.exports = {
       name: "@mendable/firecrawl-js",
-      version: "4.25.3",
+      version: "4.25.5",
       description: "JavaScript SDK for Firecrawl API",
       main: "dist/index.js",
       types: "dist/index.d.ts",
@@ -106,7 +110,8 @@ var require_package = __commonJS({
           handlebars: ">=4.7.9",
           "brace-expansion": ">=5.0.6",
           "axios@>=1.0.0 <1.16.0": "1.16.1",
-          "follow-redirects@<1.16.0": ">=1.16.0 <2.0.0"
+          "follow-redirects@<1.16.0": ">=1.16.0 <2.0.0",
+          "esbuild@>=0.17.0 <0.28.1": "0.28.1"
         }
       }
     };
@@ -159,7 +164,10 @@ var HttpClient = class {
       baseURL: this.apiUrl,
       timeout: options.timeoutMs ?? 3e5,
       headers: {
-        Authorization: `Bearer ${this.apiKey}`
+        // Omit the Authorization header entirely when no API key is set so that
+        // scrape/search/interact can use the keyless free tier (the cloud only
+        // grants it when no Authorization header is present).
+        ...this.apiKey ? { Authorization: `Bearer ${this.apiKey}` } : {}
       },
       transitional: { clarifyTimeoutError: true }
     });
@@ -1463,6 +1471,7 @@ var ResearchClient = class {
   constructor(http) {
     this.http = http;
   }
+  http;
   /**
    * Search papers by abstract relevance.
    * @param query Natural-language search query.
@@ -1939,9 +1948,6 @@ var FirecrawlClient = class {
     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(/\/$/, "");
-    if (this.isCloudService(apiUrl) && !apiKey) {
-      throw new Error("API key is required for the cloud API. Set FIRECRAWL_API_KEY env or pass apiKey.");
-    }
     this.http = new HttpClient({
       apiKey,
       apiUrl,

package/dist/index.d.cts

@@ -4,7 +4,7 @@ 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" | "audio" | "video" | "pii";
+type FormatString = "markdown" | "html" | "rawHtml" | "links" | "images" | "screenshot" | "summary" | "changeTracking" | "json" | "attributes" | "branding" | "audio" | "video";
 interface Viewport {
     width: number;
     height: number;
@@ -165,34 +165,6 @@ interface RedactPIIOptions {
      */
     replaceStyle?: "tag" | "mask" | "remove";
 }
-type PIISource = "model" | "heuristics" | "unknown";
-interface PIISpan {
-    start: number;
-    end: number;
-    /** Unified entity bucket. Omitted when `kind` doesn't map onto one. */
-    entity?: RedactPIIEntity;
-    /** Granular recognizer label from fire-privacy. */
-    kind: string;
-    source: PIISource;
-    /** Confidence in [0, 1] when supplied. */
-    score?: number;
-}
-/**
- * - ok: redaction completed; redactedMarkdown is the result.
- * - skipped: redaction was not performed; see `reason`.
- * - failed: redaction was attempted but did not produce a usable result.
- */
-type PIIStatus = "ok" | "skipped" | "failed";
-/** Always set when status !== "ok". */
-type PIIReason = "empty_input" | "too_large" | "upstream_skipped" | "service_unavailable" | "timeout" | "error";
-interface PIIBlock {
-    status: PIIStatus;
-    reason?: PIIReason;
-    redactedMarkdown: string | null;
-    spans: PIISpan[];
-    /** Span count per entity bucket. Only non-zero entries are present. */
-    counts: Partial<Record<RedactPIIEntity, number>>;
-}
 type ParseFileData = Blob | File | Buffer | Uint8Array | ArrayBuffer | string;
 interface ParseFile {
     data: ParseFileData;
@@ -410,7 +382,6 @@ interface Document {
     warning?: string;
     changeTracking?: Record<string, unknown>;
     branding?: BrandingProfile;
-    pii?: PIIBlock;
 }
 interface PaginationConfig {
     /** When true (default), automatically follow `next` links and aggregate all documents. */
@@ -2468,4 +2439,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 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 CreateMonitorRequest, 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 FirecrawlClientInput, type FirecrawlClientOptions, type Format, type FormatOption, type FormatString, type GetMonitorCheckOptions, type GetPaperOptions, type GitHubScoreBreakdown, type GitHubSearchItem, type GitHubSearchResponse, type HighlightsFormat, type IdMap, JobTimeoutError, type JsonFormat, type ListMonitorChecksOptions, type ListMonitorsOptions, type LocationConfig$1 as LocationConfig, type MapData, type MapOptions, type Monitor, type MonitorCheck, type MonitorCheckDetail, type MonitorCheckPage, type MonitorCrawlTarget, type MonitorEmailNotification, type MonitorEmailRecipientSubscription, type MonitorJsonFieldDiff, type MonitorNotification, type MonitorPageDiff, type MonitorPageJudgment, type MonitorPageSnapshot, type MonitorSchedule, type MonitorScrapeTarget, type MonitorSummary, type MonitorTarget, type MonitorWebhookConfig, type PDFAction, type PIIBlock, type PIIReason, type PIISource, type PIISpan, type PIIStatus, type PaginationConfig, type PaperMetadata, type PaperMetadataResponse, type PaperResult, type PaperSignals, type ParseFile, type ParseFileData, type ParseFormat, type ParseFormatOption, type ParseFormatString, type ParseOptions, type Passage, type PressAction, type QueryFormat, type QuestionFormat, type QueueStatusResponse$1 as QueueStatusResponse, type ReadPaperResponse, type RedactPIIEntity, type RedactPIIOptions, ResearchClient, type ScrapeAction, type ScrapeBrowserDeleteResponse, type ScrapeExecuteRequest, type ScrapeExecuteResponse, type ScrapeOptions, type ScreenshotAction, type ScreenshotFormat, type ScrollAction, SdkError, type SearchData, type SearchGithubOptions, type SearchPapersOptions, type SearchPapersResponse, type SearchRequest, type SearchResultImages, type SearchResultNews, type SearchResultWeb, type SimilarPapersOptions, type SimilarPapersResponse, type TokenUsage, type TokenUsageHistoricalPeriod, type TokenUsageHistoricalResponse, type UpdateMonitorRequest, 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 CreateMonitorRequest, 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 FirecrawlClientInput, type FirecrawlClientOptions, type Format, type FormatOption, type FormatString, type GetMonitorCheckOptions, type GetPaperOptions, type GitHubScoreBreakdown, type GitHubSearchItem, type GitHubSearchResponse, type HighlightsFormat, type IdMap, JobTimeoutError, type JsonFormat, type ListMonitorChecksOptions, type ListMonitorsOptions, type LocationConfig$1 as LocationConfig, type MapData, type MapOptions, type Monitor, type MonitorCheck, type MonitorCheckDetail, type MonitorCheckPage, type MonitorCrawlTarget, type MonitorEmailNotification, type MonitorEmailRecipientSubscription, type MonitorJsonFieldDiff, type MonitorNotification, type MonitorPageDiff, type MonitorPageJudgment, type MonitorPageSnapshot, type MonitorSchedule, type MonitorScrapeTarget, type MonitorSummary, type MonitorTarget, type MonitorWebhookConfig, type PDFAction, type PaginationConfig, type PaperMetadata, type PaperMetadataResponse, type PaperResult, type PaperSignals, type ParseFile, type ParseFileData, type ParseFormat, type ParseFormatOption, type ParseFormatString, type ParseOptions, type Passage, type PressAction, type QueryFormat, type QuestionFormat, type QueueStatusResponse$1 as QueueStatusResponse, type ReadPaperResponse, type RedactPIIEntity, type RedactPIIOptions, ResearchClient, type ScrapeAction, type ScrapeBrowserDeleteResponse, type ScrapeExecuteRequest, type ScrapeExecuteResponse, type ScrapeOptions, type ScreenshotAction, type ScreenshotFormat, type ScrollAction, SdkError, type SearchData, type SearchGithubOptions, type SearchPapersOptions, type SearchPapersResponse, type SearchRequest, type SearchResultImages, type SearchResultNews, type SearchResultWeb, type SimilarPapersOptions, type SimilarPapersResponse, type TokenUsage, type TokenUsageHistoricalPeriod, type TokenUsageHistoricalResponse, type UpdateMonitorRequest, type Viewport, type WaitAction, Watcher, type WatcherOptions, type WebhookConfig, type WriteAction, Firecrawl as default };

package/dist/index.d.ts

@@ -4,7 +4,7 @@ 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" | "audio" | "video" | "pii";
+type FormatString = "markdown" | "html" | "rawHtml" | "links" | "images" | "screenshot" | "summary" | "changeTracking" | "json" | "attributes" | "branding" | "audio" | "video";
 interface Viewport {
     width: number;
     height: number;
@@ -165,34 +165,6 @@ interface RedactPIIOptions {
      */
     replaceStyle?: "tag" | "mask" | "remove";
 }
-type PIISource = "model" | "heuristics" | "unknown";
-interface PIISpan {
-    start: number;
-    end: number;
-    /** Unified entity bucket. Omitted when `kind` doesn't map onto one. */
-    entity?: RedactPIIEntity;
-    /** Granular recognizer label from fire-privacy. */
-    kind: string;
-    source: PIISource;
-    /** Confidence in [0, 1] when supplied. */
-    score?: number;
-}
-/**
- * - ok: redaction completed; redactedMarkdown is the result.
- * - skipped: redaction was not performed; see `reason`.
- * - failed: redaction was attempted but did not produce a usable result.
- */
-type PIIStatus = "ok" | "skipped" | "failed";
-/** Always set when status !== "ok". */
-type PIIReason = "empty_input" | "too_large" | "upstream_skipped" | "service_unavailable" | "timeout" | "error";
-interface PIIBlock {
-    status: PIIStatus;
-    reason?: PIIReason;
-    redactedMarkdown: string | null;
-    spans: PIISpan[];
-    /** Span count per entity bucket. Only non-zero entries are present. */
-    counts: Partial<Record<RedactPIIEntity, number>>;
-}
 type ParseFileData = Blob | File | Buffer | Uint8Array | ArrayBuffer | string;
 interface ParseFile {
     data: ParseFileData;
@@ -410,7 +382,6 @@ interface Document {
     warning?: string;
     changeTracking?: Record<string, unknown>;
     branding?: BrandingProfile;
-    pii?: PIIBlock;
 }
 interface PaginationConfig {
     /** When true (default), automatically follow `next` links and aggregate all documents. */
@@ -2468,4 +2439,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 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 CreateMonitorRequest, 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 FirecrawlClientInput, type FirecrawlClientOptions, type Format, type FormatOption, type FormatString, type GetMonitorCheckOptions, type GetPaperOptions, type GitHubScoreBreakdown, type GitHubSearchItem, type GitHubSearchResponse, type HighlightsFormat, type IdMap, JobTimeoutError, type JsonFormat, type ListMonitorChecksOptions, type ListMonitorsOptions, type LocationConfig$1 as LocationConfig, type MapData, type MapOptions, type Monitor, type MonitorCheck, type MonitorCheckDetail, type MonitorCheckPage, type MonitorCrawlTarget, type MonitorEmailNotification, type MonitorEmailRecipientSubscription, type MonitorJsonFieldDiff, type MonitorNotification, type MonitorPageDiff, type MonitorPageJudgment, type MonitorPageSnapshot, type MonitorSchedule, type MonitorScrapeTarget, type MonitorSummary, type MonitorTarget, type MonitorWebhookConfig, type PDFAction, type PIIBlock, type PIIReason, type PIISource, type PIISpan, type PIIStatus, type PaginationConfig, type PaperMetadata, type PaperMetadataResponse, type PaperResult, type PaperSignals, type ParseFile, type ParseFileData, type ParseFormat, type ParseFormatOption, type ParseFormatString, type ParseOptions, type Passage, type PressAction, type QueryFormat, type QuestionFormat, type QueueStatusResponse$1 as QueueStatusResponse, type ReadPaperResponse, type RedactPIIEntity, type RedactPIIOptions, ResearchClient, type ScrapeAction, type ScrapeBrowserDeleteResponse, type ScrapeExecuteRequest, type ScrapeExecuteResponse, type ScrapeOptions, type ScreenshotAction, type ScreenshotFormat, type ScrollAction, SdkError, type SearchData, type SearchGithubOptions, type SearchPapersOptions, type SearchPapersResponse, type SearchRequest, type SearchResultImages, type SearchResultNews, type SearchResultWeb, type SimilarPapersOptions, type SimilarPapersResponse, type TokenUsage, type TokenUsageHistoricalPeriod, type TokenUsageHistoricalResponse, type UpdateMonitorRequest, 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 CreateMonitorRequest, 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 FirecrawlClientInput, type FirecrawlClientOptions, type Format, type FormatOption, type FormatString, type GetMonitorCheckOptions, type GetPaperOptions, type GitHubScoreBreakdown, type GitHubSearchItem, type GitHubSearchResponse, type HighlightsFormat, type IdMap, JobTimeoutError, type JsonFormat, type ListMonitorChecksOptions, type ListMonitorsOptions, type LocationConfig$1 as LocationConfig, type MapData, type MapOptions, type Monitor, type MonitorCheck, type MonitorCheckDetail, type MonitorCheckPage, type MonitorCrawlTarget, type MonitorEmailNotification, type MonitorEmailRecipientSubscription, type MonitorJsonFieldDiff, type MonitorNotification, type MonitorPageDiff, type MonitorPageJudgment, type MonitorPageSnapshot, type MonitorSchedule, type MonitorScrapeTarget, type MonitorSummary, type MonitorTarget, type MonitorWebhookConfig, type PDFAction, type PaginationConfig, type PaperMetadata, type PaperMetadataResponse, type PaperResult, type PaperSignals, type ParseFile, type ParseFileData, type ParseFormat, type ParseFormatOption, type ParseFormatString, type ParseOptions, type Passage, type PressAction, type QueryFormat, type QuestionFormat, type QueueStatusResponse$1 as QueueStatusResponse, type ReadPaperResponse, type RedactPIIEntity, type RedactPIIOptions, ResearchClient, type ScrapeAction, type ScrapeBrowserDeleteResponse, type ScrapeExecuteRequest, type ScrapeExecuteResponse, type ScrapeOptions, type ScreenshotAction, type ScreenshotFormat, type ScrollAction, SdkError, type SearchData, type SearchGithubOptions, type SearchPapersOptions, type SearchPapersResponse, type SearchRequest, type SearchResultImages, type SearchResultNews, type SearchResultWeb, type SimilarPapersOptions, type SimilarPapersResponse, type TokenUsage, type TokenUsageHistoricalPeriod, type TokenUsageHistoricalResponse, type UpdateMonitorRequest, 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-5D4KXCYO.js";
+} from "./chunk-L4JQOWAZ.js";
 
 // src/v2/utils/httpClient.ts
 import axios from "axios";
@@ -34,7 +34,10 @@ var HttpClient = class {
       baseURL: this.apiUrl,
       timeout: options.timeoutMs ?? 3e5,
       headers: {
-        Authorization: `Bearer ${this.apiKey}`
+        // Omit the Authorization header entirely when no API key is set so that
+        // scrape/search/interact can use the keyless free tier (the cloud only
+        // grants it when no Authorization header is present).
+        ...this.apiKey ? { Authorization: `Bearer ${this.apiKey}` } : {}
       },
       transitional: { clarifyTimeoutError: true }
     });
@@ -1338,6 +1341,7 @@ var ResearchClient = class {
   constructor(http) {
     this.http = http;
   }
+  http;
   /**
    * Search papers by abstract relevance.
    * @param query Natural-language search query.
@@ -1814,9 +1818,6 @@ var FirecrawlClient = class {
     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(/\/$/, "");
-    if (this.isCloudService(apiUrl) && !apiKey) {
-      throw new Error("API key is required for the cloud API. Set FIRECRAWL_API_KEY env or pass apiKey.");
-    }
     this.http = new HttpClient({
       apiKey,
       apiUrl,
@@ -2243,7 +2244,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-HESILIET.js");
+      const packageJson = await import("./package-FPTJWPF7.js");
       return packageJson.default.version;
     } catch (error) {
       const isTest = typeof process !== "undefined" && (process.env.JEST_WORKER_ID != null || false);

package/dist/{package-HESILIET.js → package-FPTJWPF7.js}

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

package/package.json

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

package/src/__tests__/unit/v2/clientOptions.test.ts

@@ -67,12 +67,11 @@ describe('Firecrawl v2 Client Options', () => {
     expect(client).toBeInstanceOf(FirecrawlClient);
   });
 
-  it('should throw for empty string API key on cloud', () => {
-    expect(() => new Firecrawl('')).toThrow('API key is required');
-  });
-
-  it('should throw for whitespace-only string API key on cloud', () => {
-    expect(() => new Firecrawl('   ')).toThrow('API key is required');
+  it('should construct without an API key for the keyless free tier', () => {
+    // No key: scrape/search/interact use the keyless free tier; the SDK no
+    // longer throws at construction.
+    expect(() => new Firecrawl('')).not.toThrow();
+    expect(() => new Firecrawl('   ')).not.toThrow();
   });
 
   it('should provide v1 accessor when constructed with string', () => {

package/src/v2/client.ts

@@ -137,9 +137,9 @@ export class FirecrawlClient {
     const apiKey = (opts.apiKey ?? process.env.FIRECRAWL_API_KEY ?? "").trim();
     const apiUrl = (opts.apiUrl ?? process.env.FIRECRAWL_API_URL ?? "https://api.firecrawl.dev").replace(/\/$/, "");
 
-    if (this.isCloudService(apiUrl) && !apiKey) {
-      throw new Error("API key is required for the cloud API. Set FIRECRAWL_API_KEY env or pass apiKey.");
-    }
+    // 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
+    // from the API until a key is provided.
 
     this.http = new HttpClient({
       apiKey,

package/src/v2/types.ts

@@ -14,8 +14,7 @@ export type FormatString =
   | "attributes"
   | "branding"
   | "audio"
-  | "video"
-  | "pii";
+  | "video";
 
 export interface Viewport {
   width: number;
@@ -240,45 +239,6 @@ export interface RedactPIIOptions {
   replaceStyle?: "tag" | "mask" | "remove";
 }
 
-export type PIISource = "model" | "heuristics" | "unknown";
-
-export interface PIISpan {
-  start: number;
-  end: number;
-  /** Unified entity bucket. Omitted when `kind` doesn't map onto one. */
-  entity?: RedactPIIEntity;
-  /** Granular recognizer label from fire-privacy. */
-  kind: string;
-  source: PIISource;
-  /** Confidence in [0, 1] when supplied. */
-  score?: number;
-}
-
-/**
- * - ok: redaction completed; redactedMarkdown is the result.
- * - skipped: redaction was not performed; see `reason`.
- * - failed: redaction was attempted but did not produce a usable result.
- */
-export type PIIStatus = "ok" | "skipped" | "failed";
-
-/** Always set when status !== "ok". */
-export type PIIReason =
-  | "empty_input"
-  | "too_large"
-  | "upstream_skipped"
-  | "service_unavailable"
-  | "timeout"
-  | "error";
-
-export interface PIIBlock {
-  status: PIIStatus;
-  reason?: PIIReason;
-  redactedMarkdown: string | null;
-  spans: PIISpan[];
-  /** Span count per entity bucket. Only non-zero entries are present. */
-  counts: Partial<Record<RedactPIIEntity, number>>;
-}
-
 export type ParseFileData =
   | Blob
   | File
@@ -549,7 +509,6 @@ export interface Document {
   warning?: string;
   changeTracking?: Record<string, unknown>;
   branding?: BrandingProfile;
-  pii?: PIIBlock;
 }
 
 // Pagination configuration for auto-fetching pages from v2 endpoints that return a `next` URL

package/src/v2/utils/httpClient.ts

@@ -34,7 +34,10 @@ export class HttpClient {
       baseURL: this.apiUrl,
       timeout: options.timeoutMs ?? 300000,
       headers: {
-        Authorization: `Bearer ${this.apiKey}`,
+        // Omit the Authorization header entirely when no API key is set so that
+        // scrape/search/interact can use the keyless free tier (the cloud only
+        // grants it when no Authorization header is present).
+        ...(this.apiKey ? { Authorization: `Bearer ${this.apiKey}` } : {}),
       },
       transitional: { clarifyTimeoutError: true },
     });