firecrawl 4.25.0 → 4.25.2

package/README.md

@@ -7,7 +7,7 @@ The Firecrawl Node SDK is a library that lets you easily search, scrape, and int
 To install the Firecrawl Node SDK, you can use npm:
 
 ```bash
-npm install @mendable/firecrawl-js
+npm install firecrawl
 ```
 
 ## Usage
@@ -18,7 +18,7 @@ npm install @mendable/firecrawl-js
 Here's an example of how to use the SDK with error handling:
 
 ```js
-import Firecrawl from '@mendable/firecrawl-js';
+import { Firecrawl } from 'firecrawl';
 
 const app = new Firecrawl({ apiKey: 'fc-YOUR_API_KEY' });
 
@@ -114,7 +114,7 @@ const status = await app.getCrawlStatus(id);
 Use `extract` with a prompt and schema. Zod schemas are supported directly.
 
 ```js
-import Firecrawl from '@mendable/firecrawl-js';
+import { Firecrawl } from 'firecrawl';
 import { z } from 'zod';
 
 const app = new Firecrawl({ apiKey: 'fc-YOUR_API_KEY' });
@@ -236,7 +236,7 @@ await watch.start();
 The feature‑frozen v1 is still available under `app.v1` with the original method names.
 
 ```js
-import Firecrawl from '@mendable/firecrawl-js';
+import { Firecrawl } from 'firecrawl';
 
 const app = new Firecrawl({ apiKey: 'fc-YOUR_API_KEY' });
 

package/dist/{chunk-46XQC2QL.js → chunk-XCQC2QCZ.js}

@@ -8,7 +8,7 @@ var require_package = __commonJS({
   "package.json"(exports, module) {
     module.exports = {
       name: "@mendable/firecrawl-js",
-      version: "4.25.0",
+      version: "4.25.2",
       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.15.2",
+        axios: "1.16.1",
         firecrawl: "4.16.0",
         "typescript-event-target": "^1.1.1",
         zod: "^3.23.8",
@@ -78,7 +78,7 @@ var require_package = __commonJS({
           "picomatch@<4.0.4": ">=4.0.4",
           handlebars: ">=4.7.9",
           "brace-expansion": ">=5.0.6",
-          "axios@<1.15.2": "1.15.2",
+          "axios@>=1.0.0 <1.16.0": "1.16.1",
           "follow-redirects@<1.16.0": ">=1.16.0 <2.0.0"
         }
       }

package/dist/index.cjs

@@ -35,7 +35,7 @@ var require_package = __commonJS({
   "package.json"(exports2, module2) {
     module2.exports = {
       name: "@mendable/firecrawl-js",
-      version: "4.25.0",
+      version: "4.25.2",
       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.15.2",
+        axios: "1.16.1",
         firecrawl: "4.16.0",
         "typescript-event-target": "^1.1.1",
         zod: "^3.23.8",
@@ -105,7 +105,7 @@ var require_package = __commonJS({
           "picomatch@<4.0.4": ">=4.0.4",
           handlebars: ">=4.7.9",
           "brace-expansion": ">=5.0.6",
-          "axios@<1.15.2": "1.15.2",
+          "axios@>=1.0.0 <1.16.0": "1.16.1",
           "follow-redirects@<1.16.0": ">=1.16.0 <2.0.0"
         }
       }

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";
+type FormatString = "markdown" | "html" | "rawHtml" | "links" | "images" | "screenshot" | "summary" | "changeTracking" | "json" | "attributes" | "branding" | "audio" | "video" | "pii";
 interface Viewport {
     width: number;
     height: number;
@@ -140,6 +140,7 @@ interface ScrapeOptions {
     minAge?: number;
     storeInCache?: boolean;
     lockdown?: boolean;
+    redactPII?: boolean | RedactPIIOptions;
     profile?: {
         name: string;
         saveChanges?: boolean;
@@ -147,6 +148,51 @@ interface ScrapeOptions {
     integration?: string;
     origin?: string;
 }
+type RedactPIIEntity = "PERSON" | "EMAIL" | "PHONE" | "LOCATION" | "FINANCIAL" | "SECRET";
+interface RedactPIIOptions {
+    /**
+     * accurate (default): model-only redaction. Best precision, cleanest output.
+     * aggressive: model + Presidio + spaCy. Higher recall at the cost of precision.
+     * fast: Presidio only, no model call. Lower F1, ~2x throughput.
+     */
+    mode?: "accurate" | "aggressive" | "fast";
+    /** Restrict redaction to these entity buckets. Unset means all entities. */
+    entities?: RedactPIIEntity[];
+    /**
+     * tag (default): replace spans with `<KIND>` placeholders.
+     * mask: replace spans with `*` of equal length.
+     * remove: drop span characters entirely.
+     */
+    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;
@@ -364,6 +410,7 @@ 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. */
@@ -522,6 +569,24 @@ interface MonitorEmailNotification {
     recipients?: string[];
     includeDiffs?: boolean;
 }
+/**
+ * Per-recipient opt-in state for monitor email notifications.
+ *
+ * External recipients (not members of the team that owns the monitor) must
+ * confirm their subscription via a one-time email before they receive any
+ * monitor notifications. Team members are auto-confirmed.
+ *
+ * - `pending`      → confirmation email sent, no notifications yet
+ * - `confirmed`    → notifications enabled
+ * - `unsubscribed` → recipient opted out and cannot be re-added without a new
+ *                    confirmation flow
+ */
+interface MonitorEmailRecipientSubscription {
+    email: string;
+    status: "pending" | "confirmed" | "unsubscribed";
+    source: "team" | "opt_in" | "legacy";
+    confirmationEmailSent?: boolean;
+}
 interface MonitorNotification {
     email?: MonitorEmailNotification;
 }
@@ -585,6 +650,13 @@ interface Monitor {
     targets: MonitorTarget[];
     webhook?: MonitorWebhookConfig | null;
     notification?: MonitorNotification | null;
+    /**
+     * Present on create/update/get responses. Reflects the opt-in state of every
+     * email recipient currently configured on the monitor. Absent when the API
+     * has not reconciled recipients (e.g. team-default delivery with no
+     * explicit recipients).
+     */
+    emailRecipientSubscriptions?: MonitorEmailRecipientSubscription[];
     retentionDays: number;
     estimatedCreditsPerMonth?: number | null;
     lastCheckSummary?: MonitorSummary | null;
@@ -597,7 +669,12 @@ interface MonitorPageJudgment {
     meaningful: boolean;
     confidence: "high" | "medium" | "low";
     reason: string;
-    fields: string[];
+    meaningfulChanges: Array<{
+        type: "added" | "removed" | "changed";
+        before: string | null;
+        after: string | null;
+        reason: string;
+    }>;
 }
 interface MonitorCheck {
     id: string;
@@ -2203,4 +2280,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 HighlightsFormat, 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 MonitorJsonFieldDiff, type MonitorNotification, type MonitorPageDiff, type MonitorPageJudgment, type MonitorPageSnapshot, type MonitorSchedule, type MonitorScrapeTarget, type MonitorSummary, type MonitorTarget, type MonitorWebhookConfig, type PDFAction, type PaginationConfig, type ParseFile, type ParseFileData, type ParseFormat, type ParseFormatOption, type ParseFormatString, type ParseOptions, type PressAction, type QueryFormat, type QuestionFormat, type QueueStatusResponse$1 as QueueStatusResponse, type ScrapeAction, type ScrapeBrowserDeleteResponse, type ScrapeExecuteRequest, type ScrapeExecuteResponse, 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 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 HighlightsFormat, 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 ParseFile, type ParseFileData, type ParseFormat, type ParseFormatOption, type ParseFormatString, type ParseOptions, type PressAction, type QueryFormat, type QuestionFormat, type QueueStatusResponse$1 as QueueStatusResponse, type RedactPIIEntity, type RedactPIIOptions, type ScrapeAction, type ScrapeBrowserDeleteResponse, type ScrapeExecuteRequest, type ScrapeExecuteResponse, 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 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";
+type FormatString = "markdown" | "html" | "rawHtml" | "links" | "images" | "screenshot" | "summary" | "changeTracking" | "json" | "attributes" | "branding" | "audio" | "video" | "pii";
 interface Viewport {
     width: number;
     height: number;
@@ -140,6 +140,7 @@ interface ScrapeOptions {
     minAge?: number;
     storeInCache?: boolean;
     lockdown?: boolean;
+    redactPII?: boolean | RedactPIIOptions;
     profile?: {
         name: string;
         saveChanges?: boolean;
@@ -147,6 +148,51 @@ interface ScrapeOptions {
     integration?: string;
     origin?: string;
 }
+type RedactPIIEntity = "PERSON" | "EMAIL" | "PHONE" | "LOCATION" | "FINANCIAL" | "SECRET";
+interface RedactPIIOptions {
+    /**
+     * accurate (default): model-only redaction. Best precision, cleanest output.
+     * aggressive: model + Presidio + spaCy. Higher recall at the cost of precision.
+     * fast: Presidio only, no model call. Lower F1, ~2x throughput.
+     */
+    mode?: "accurate" | "aggressive" | "fast";
+    /** Restrict redaction to these entity buckets. Unset means all entities. */
+    entities?: RedactPIIEntity[];
+    /**
+     * tag (default): replace spans with `<KIND>` placeholders.
+     * mask: replace spans with `*` of equal length.
+     * remove: drop span characters entirely.
+     */
+    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;
@@ -364,6 +410,7 @@ 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. */
@@ -522,6 +569,24 @@ interface MonitorEmailNotification {
     recipients?: string[];
     includeDiffs?: boolean;
 }
+/**
+ * Per-recipient opt-in state for monitor email notifications.
+ *
+ * External recipients (not members of the team that owns the monitor) must
+ * confirm their subscription via a one-time email before they receive any
+ * monitor notifications. Team members are auto-confirmed.
+ *
+ * - `pending`      → confirmation email sent, no notifications yet
+ * - `confirmed`    → notifications enabled
+ * - `unsubscribed` → recipient opted out and cannot be re-added without a new
+ *                    confirmation flow
+ */
+interface MonitorEmailRecipientSubscription {
+    email: string;
+    status: "pending" | "confirmed" | "unsubscribed";
+    source: "team" | "opt_in" | "legacy";
+    confirmationEmailSent?: boolean;
+}
 interface MonitorNotification {
     email?: MonitorEmailNotification;
 }
@@ -585,6 +650,13 @@ interface Monitor {
     targets: MonitorTarget[];
     webhook?: MonitorWebhookConfig | null;
     notification?: MonitorNotification | null;
+    /**
+     * Present on create/update/get responses. Reflects the opt-in state of every
+     * email recipient currently configured on the monitor. Absent when the API
+     * has not reconciled recipients (e.g. team-default delivery with no
+     * explicit recipients).
+     */
+    emailRecipientSubscriptions?: MonitorEmailRecipientSubscription[];
     retentionDays: number;
     estimatedCreditsPerMonth?: number | null;
     lastCheckSummary?: MonitorSummary | null;
@@ -597,7 +669,12 @@ interface MonitorPageJudgment {
     meaningful: boolean;
     confidence: "high" | "medium" | "low";
     reason: string;
-    fields: string[];
+    meaningfulChanges: Array<{
+        type: "added" | "removed" | "changed";
+        before: string | null;
+        after: string | null;
+        reason: string;
+    }>;
 }
 interface MonitorCheck {
     id: string;
@@ -2203,4 +2280,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 HighlightsFormat, 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 MonitorJsonFieldDiff, type MonitorNotification, type MonitorPageDiff, type MonitorPageJudgment, type MonitorPageSnapshot, type MonitorSchedule, type MonitorScrapeTarget, type MonitorSummary, type MonitorTarget, type MonitorWebhookConfig, type PDFAction, type PaginationConfig, type ParseFile, type ParseFileData, type ParseFormat, type ParseFormatOption, type ParseFormatString, type ParseOptions, type PressAction, type QueryFormat, type QuestionFormat, type QueueStatusResponse$1 as QueueStatusResponse, type ScrapeAction, type ScrapeBrowserDeleteResponse, type ScrapeExecuteRequest, type ScrapeExecuteResponse, 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 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 HighlightsFormat, 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 ParseFile, type ParseFileData, type ParseFormat, type ParseFormatOption, type ParseFormatString, type ParseOptions, type PressAction, type QueryFormat, type QuestionFormat, type QueueStatusResponse$1 as QueueStatusResponse, type RedactPIIEntity, type RedactPIIOptions, type ScrapeAction, type ScrapeBrowserDeleteResponse, type ScrapeExecuteRequest, type ScrapeExecuteResponse, 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 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-46XQC2QL.js";
+} from "./chunk-XCQC2QCZ.js";
 
 // src/v2/utils/httpClient.ts
 import axios from "axios";
@@ -2097,7 +2097,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-MW3GMNCL.js");
+      const packageJson = await import("./package-D6422PQU.js");
       return packageJson.default.version;
     } catch (error) {
       const isTest = typeof process !== "undefined" && (process.env.JEST_WORKER_ID != null || false);

package/dist/{package-MW3GMNCL.js → package-D6422PQU.js}

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "firecrawl",
-  "version": "4.25.0",
+  "version": "4.25.2",
   "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.15.2",
+    "axios": "1.16.1",
     "typescript-event-target": "^1.1.1",
     "zod": "^3.23.8",
     "zod-to-json-schema": "^3.23.0"

package/src/v2/types.ts

@@ -14,7 +14,8 @@ export type FormatString =
   | "attributes"
   | "branding"
   | "audio"
-  | "video";
+  | "video"
+  | "pii";
 
 export interface Viewport {
   width: number;
@@ -205,6 +206,7 @@ export interface ScrapeOptions {
   minAge?: number;
   storeInCache?: boolean;
   lockdown?: boolean;
+  redactPII?: boolean | RedactPIIOptions;
   profile?: {
     name: string;
     saveChanges?: boolean;
@@ -213,6 +215,70 @@ export interface ScrapeOptions {
   origin?: string;
 }
 
+export type RedactPIIEntity =
+  | "PERSON"
+  | "EMAIL"
+  | "PHONE"
+  | "LOCATION"
+  | "FINANCIAL"
+  | "SECRET";
+
+export interface RedactPIIOptions {
+  /**
+   * accurate (default): model-only redaction. Best precision, cleanest output.
+   * aggressive: model + Presidio + spaCy. Higher recall at the cost of precision.
+   * fast: Presidio only, no model call. Lower F1, ~2x throughput.
+   */
+  mode?: "accurate" | "aggressive" | "fast";
+  /** Restrict redaction to these entity buckets. Unset means all entities. */
+  entities?: RedactPIIEntity[];
+  /**
+   * tag (default): replace spans with `<KIND>` placeholders.
+   * mask: replace spans with `*` of equal length.
+   * remove: drop span characters entirely.
+   */
+  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
@@ -483,6 +549,7 @@ 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
@@ -660,6 +727,25 @@ export interface MonitorEmailNotification {
   includeDiffs?: boolean;
 }
 
+/**
+ * Per-recipient opt-in state for monitor email notifications.
+ *
+ * External recipients (not members of the team that owns the monitor) must
+ * confirm their subscription via a one-time email before they receive any
+ * monitor notifications. Team members are auto-confirmed.
+ *
+ * - `pending`      → confirmation email sent, no notifications yet
+ * - `confirmed`    → notifications enabled
+ * - `unsubscribed` → recipient opted out and cannot be re-added without a new
+ *                    confirmation flow
+ */
+export interface MonitorEmailRecipientSubscription {
+  email: string;
+  status: "pending" | "confirmed" | "unsubscribed";
+  source: "team" | "opt_in" | "legacy";
+  confirmationEmailSent?: boolean;
+}
+
 export interface MonitorNotification {
   email?: MonitorEmailNotification;
 }
@@ -731,6 +817,13 @@ export interface Monitor {
   targets: MonitorTarget[];
   webhook?: MonitorWebhookConfig | null;
   notification?: MonitorNotification | null;
+  /**
+   * Present on create/update/get responses. Reflects the opt-in state of every
+   * email recipient currently configured on the monitor. Absent when the API
+   * has not reconciled recipients (e.g. team-default delivery with no
+   * explicit recipients).
+   */
+  emailRecipientSubscriptions?: MonitorEmailRecipientSubscription[];
   retentionDays: number;
   estimatedCreditsPerMonth?: number | null;
   lastCheckSummary?: MonitorSummary | null;
@@ -744,7 +837,12 @@ export interface MonitorPageJudgment {
   meaningful: boolean;
   confidence: "high" | "medium" | "low";
   reason: string;
-  fields: string[];
+  meaningfulChanges: Array<{
+    type: "added" | "removed" | "changed";
+    before: string | null;
+    after: string | null;
+    reason: string;
+  }>;
 }
 
 export interface MonitorCheck {