firecrawl 4.29.2 → 4.30.1

package/dist/{chunk-N3GO36OX.js → chunk-2LUWTM44.js}

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

package/dist/index.cjs

@@ -39,7 +39,7 @@ var require_package = __commonJS({
   "package.json"(exports2, module2) {
     module2.exports = {
       name: "@mendable/firecrawl-js",
-      version: "4.29.2",
+      version: "4.30.1",
       description: "JavaScript SDK for Firecrawl API",
       main: "dist/index.js",
       types: "dist/index.d.ts",
@@ -717,10 +717,13 @@ function prepareSearchPayload(req) {
   if (req.ignoreInvalidURLs != null)
     payload.ignoreInvalidURLs = req.ignoreInvalidURLs;
   if (req.timeout != null) payload.timeout = req.timeout;
+  if (req.highlights != null) payload.highlights = req.highlights;
   if (req.integration && req.integration.trim())
     payload.integration = req.integration.trim();
   if (req.origin) payload.origin = req.origin;
   if (req.enterprise) payload.enterprise = req.enterprise;
+  if (req.threatProtection != null)
+    payload.threatProtection = req.threatProtection;
   if (req.scrapeOptions) {
     ensureValidScrapeOptions(req.scrapeOptions);
     payload.scrapeOptions = req.scrapeOptions;
@@ -797,6 +800,8 @@ function prepareMapPayload(url, options) {
       payload.integration = options.integration.trim();
     if (options.origin) payload.origin = options.origin;
     if (options.location != null) payload.location = options.location;
+    if (options.threatProtection != null)
+      payload.threatProtection = options.threatProtection;
   }
   return payload;
 }
@@ -1229,6 +1234,8 @@ function prepareExtractPayload(args) {
   if (args.origin) body.origin = args.origin;
   if (args.agent) body.agent = args.agent;
   if (args.webhook != null) body.webhook = args.webhook;
+  if (args.threatProtection != null)
+    body.threatProtection = args.threatProtection;
   if (args.scrapeOptions) {
     ensureValidScrapeOptions(args.scrapeOptions);
     body.scrapeOptions = args.scrapeOptions;
@@ -1286,6 +1293,8 @@ function prepareAgentPayload(args) {
   if (args.strictConstrainToURLs !== null && args.strictConstrainToURLs !== void 0) body.strictConstrainToURLs = args.strictConstrainToURLs;
   if (args.model !== null && args.model !== void 0) body.model = args.model;
   if (args.webhook != null) body.webhook = args.webhook;
+  if (args.threatProtection != null)
+    body.threatProtection = args.threatProtection;
   return body;
 }
 async function startAgent(http, args) {

package/dist/index.d.cts

@@ -141,6 +141,7 @@ interface ScrapeOptions {
     storeInCache?: boolean;
     lockdown?: boolean;
     redactPII?: boolean | RedactPIIOptions;
+    threatProtection?: ThreatProtectionOptions;
     profile?: {
         name: string;
         saveChanges?: boolean;
@@ -165,13 +166,33 @@ interface RedactPIIOptions {
      */
     replaceStyle?: "tag" | "mask" | "remove";
 }
+/**
+ * Enterprise: per-request field-level override of your team's threat
+ * protection policy. Requires threat protection to be enabled for your team
+ * and request overrides to be allowed in the team configuration. Only the
+ * fields you provide replace the team policy's values.
+ */
+interface ThreatProtectionOptions {
+    /** "off" disables scanning for this request; "normal" applies the policy. */
+    mode?: "off" | "normal";
+    /** Block verdicts at or above this risk score (integer 0-100). */
+    riskScoreThreshold?: number;
+    /** Exact domains or globs like "*.example.com" to always block (max 1000). */
+    blacklist?: string[];
+    /** Exact domains or globs to always allow; wins over everything (max 1000). */
+    whitelist?: string[];
+    /** Lowercase TLDs without the leading dot, e.g. "zip" (max 1000). */
+    blockedTlds?: string[];
+    /** Behavior when scanning is unavailable: "closed" blocks, "open" allows. */
+    failurePolicy?: "open" | "closed";
+}
 type ParseFileData = Blob | File | Buffer | Uint8Array | ArrayBuffer | string;
 interface ParseFile {
     data: ParseFileData;
     filename: string;
     contentType?: string;
 }
-type ParseOptions = Omit<ScrapeOptions, "formats" | "waitFor" | "mobile" | "actions" | "location" | "maxAge" | "minAge" | "storeInCache" | "lockdown" | "proxy"> & {
+type ParseOptions = Omit<ScrapeOptions, "formats" | "waitFor" | "mobile" | "actions" | "location" | "maxAge" | "minAge" | "storeInCache" | "lockdown" | "proxy" | "threatProtection"> & {
     formats?: ParseFormatOption[];
     proxy?: "basic" | "auto";
 };
@@ -523,6 +544,8 @@ interface SearchRequest {
     location?: string;
     ignoreInvalidURLs?: boolean;
     timeout?: number;
+    /** Generate query-relevant highlights for search results. Defaults to true. */
+    highlights?: boolean;
     scrapeOptions?: ScrapeOptions;
     /**
      * Enterprise search options. Use `["zdr"]` for end-to-end Zero Data
@@ -530,6 +553,7 @@ interface SearchRequest {
      * your team.
      */
     enterprise?: Array<"default" | "anon" | "zdr">;
+    threatProtection?: ThreatProtectionOptions;
     integration?: string;
     origin?: string;
 }
@@ -610,6 +634,7 @@ interface MapOptions {
     integration?: string;
     origin?: string;
     location?: LocationConfig$1;
+    threatProtection?: ThreatProtectionOptions;
 }
 type FeedbackRating = "good" | "partial" | "bad";
 type EndpointFeedbackEndpoint = "search" | "scrape" | "parse" | "map";
@@ -1250,6 +1275,7 @@ declare function prepareExtractPayload(args: {
     origin?: string;
     agent?: AgentOptions$1;
     webhook?: string | WebhookConfig | null;
+    threatProtection?: ThreatProtectionOptions;
 }): Record<string, unknown>;
 /**
  * @deprecated The extract endpoint is in maintenance mode and its use is discouraged.
@@ -1267,6 +1293,7 @@ declare function prepareAgentPayload(args: {
     strictConstrainToURLs?: boolean;
     model?: "spark-1-pro" | "spark-1-mini";
     webhook?: string | AgentWebhookConfig;
+    threatProtection?: ThreatProtectionOptions;
 }): Record<string, unknown>;
 declare function startAgent(http: HttpClient, args: Parameters<typeof prepareAgentPayload>[0]): Promise<AgentResponse>;
 
@@ -2629,4 +2656,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 EndpointFeedbackEndpoint, type EndpointFeedbackRequest, type ErrorDetails, type ExecuteJavascriptAction, type ExtractResponse$1 as ExtractResponse, type FeedbackMissingContent, type FeedbackRating, type FeedbackResponse, type FeedbackValuableSource, 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 MenuAvailability, type MenuImage, type MenuItem, type MenuItemIdentifiers, type MenuMerchant, type MenuPrice, type MenuProfile, type MenuSection, type Monitor, type MonitorCheck, type MonitorCheckDetail, type MonitorCheckPage, type MonitorCrawlTarget, type MonitorCrawlTargetResult, type MonitorEmailNotification, type MonitorEmailRecipientSubscription, type MonitorJsonFieldDiff, type MonitorNotification, type MonitorPageDiff, type MonitorPageJudgment, type MonitorPageSnapshot, type MonitorSchedule, type MonitorScrapeTarget, type MonitorScrapeTargetResult, type MonitorSearchTarget, type MonitorSearchTargetResult, type MonitorSummary, type MonitorTarget, type MonitorTargetResult, 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 ProductAvailability, type ProductImage, type ProductPrice, type ProductProfile, type ProductSale, type ProductVariant, 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 SearchFeedbackRequest, 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 EndpointFeedbackEndpoint, type EndpointFeedbackRequest, type ErrorDetails, type ExecuteJavascriptAction, type ExtractResponse$1 as ExtractResponse, type FeedbackMissingContent, type FeedbackRating, type FeedbackResponse, type FeedbackValuableSource, 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 MenuAvailability, type MenuImage, type MenuItem, type MenuItemIdentifiers, type MenuMerchant, type MenuPrice, type MenuProfile, type MenuSection, type Monitor, type MonitorCheck, type MonitorCheckDetail, type MonitorCheckPage, type MonitorCrawlTarget, type MonitorCrawlTargetResult, type MonitorEmailNotification, type MonitorEmailRecipientSubscription, type MonitorJsonFieldDiff, type MonitorNotification, type MonitorPageDiff, type MonitorPageJudgment, type MonitorPageSnapshot, type MonitorSchedule, type MonitorScrapeTarget, type MonitorScrapeTargetResult, type MonitorSearchTarget, type MonitorSearchTargetResult, type MonitorSummary, type MonitorTarget, type MonitorTargetResult, 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 ProductAvailability, type ProductImage, type ProductPrice, type ProductProfile, type ProductSale, type ProductVariant, 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 SearchFeedbackRequest, type SearchGithubOptions, type SearchPapersOptions, type SearchPapersResponse, type SearchRequest, type SearchResultImages, type SearchResultNews, type SearchResultWeb, type SimilarPapersOptions, type SimilarPapersResponse, type ThreatProtectionOptions, 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

@@ -141,6 +141,7 @@ interface ScrapeOptions {
     storeInCache?: boolean;
     lockdown?: boolean;
     redactPII?: boolean | RedactPIIOptions;
+    threatProtection?: ThreatProtectionOptions;
     profile?: {
         name: string;
         saveChanges?: boolean;
@@ -165,13 +166,33 @@ interface RedactPIIOptions {
      */
     replaceStyle?: "tag" | "mask" | "remove";
 }
+/**
+ * Enterprise: per-request field-level override of your team's threat
+ * protection policy. Requires threat protection to be enabled for your team
+ * and request overrides to be allowed in the team configuration. Only the
+ * fields you provide replace the team policy's values.
+ */
+interface ThreatProtectionOptions {
+    /** "off" disables scanning for this request; "normal" applies the policy. */
+    mode?: "off" | "normal";
+    /** Block verdicts at or above this risk score (integer 0-100). */
+    riskScoreThreshold?: number;
+    /** Exact domains or globs like "*.example.com" to always block (max 1000). */
+    blacklist?: string[];
+    /** Exact domains or globs to always allow; wins over everything (max 1000). */
+    whitelist?: string[];
+    /** Lowercase TLDs without the leading dot, e.g. "zip" (max 1000). */
+    blockedTlds?: string[];
+    /** Behavior when scanning is unavailable: "closed" blocks, "open" allows. */
+    failurePolicy?: "open" | "closed";
+}
 type ParseFileData = Blob | File | Buffer | Uint8Array | ArrayBuffer | string;
 interface ParseFile {
     data: ParseFileData;
     filename: string;
     contentType?: string;
 }
-type ParseOptions = Omit<ScrapeOptions, "formats" | "waitFor" | "mobile" | "actions" | "location" | "maxAge" | "minAge" | "storeInCache" | "lockdown" | "proxy"> & {
+type ParseOptions = Omit<ScrapeOptions, "formats" | "waitFor" | "mobile" | "actions" | "location" | "maxAge" | "minAge" | "storeInCache" | "lockdown" | "proxy" | "threatProtection"> & {
     formats?: ParseFormatOption[];
     proxy?: "basic" | "auto";
 };
@@ -523,6 +544,8 @@ interface SearchRequest {
     location?: string;
     ignoreInvalidURLs?: boolean;
     timeout?: number;
+    /** Generate query-relevant highlights for search results. Defaults to true. */
+    highlights?: boolean;
     scrapeOptions?: ScrapeOptions;
     /**
      * Enterprise search options. Use `["zdr"]` for end-to-end Zero Data
@@ -530,6 +553,7 @@ interface SearchRequest {
      * your team.
      */
     enterprise?: Array<"default" | "anon" | "zdr">;
+    threatProtection?: ThreatProtectionOptions;
     integration?: string;
     origin?: string;
 }
@@ -610,6 +634,7 @@ interface MapOptions {
     integration?: string;
     origin?: string;
     location?: LocationConfig$1;
+    threatProtection?: ThreatProtectionOptions;
 }
 type FeedbackRating = "good" | "partial" | "bad";
 type EndpointFeedbackEndpoint = "search" | "scrape" | "parse" | "map";
@@ -1250,6 +1275,7 @@ declare function prepareExtractPayload(args: {
     origin?: string;
     agent?: AgentOptions$1;
     webhook?: string | WebhookConfig | null;
+    threatProtection?: ThreatProtectionOptions;
 }): Record<string, unknown>;
 /**
  * @deprecated The extract endpoint is in maintenance mode and its use is discouraged.
@@ -1267,6 +1293,7 @@ declare function prepareAgentPayload(args: {
     strictConstrainToURLs?: boolean;
     model?: "spark-1-pro" | "spark-1-mini";
     webhook?: string | AgentWebhookConfig;
+    threatProtection?: ThreatProtectionOptions;
 }): Record<string, unknown>;
 declare function startAgent(http: HttpClient, args: Parameters<typeof prepareAgentPayload>[0]): Promise<AgentResponse>;
 
@@ -2629,4 +2656,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 EndpointFeedbackEndpoint, type EndpointFeedbackRequest, type ErrorDetails, type ExecuteJavascriptAction, type ExtractResponse$1 as ExtractResponse, type FeedbackMissingContent, type FeedbackRating, type FeedbackResponse, type FeedbackValuableSource, 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 MenuAvailability, type MenuImage, type MenuItem, type MenuItemIdentifiers, type MenuMerchant, type MenuPrice, type MenuProfile, type MenuSection, type Monitor, type MonitorCheck, type MonitorCheckDetail, type MonitorCheckPage, type MonitorCrawlTarget, type MonitorCrawlTargetResult, type MonitorEmailNotification, type MonitorEmailRecipientSubscription, type MonitorJsonFieldDiff, type MonitorNotification, type MonitorPageDiff, type MonitorPageJudgment, type MonitorPageSnapshot, type MonitorSchedule, type MonitorScrapeTarget, type MonitorScrapeTargetResult, type MonitorSearchTarget, type MonitorSearchTargetResult, type MonitorSummary, type MonitorTarget, type MonitorTargetResult, 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 ProductAvailability, type ProductImage, type ProductPrice, type ProductProfile, type ProductSale, type ProductVariant, 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 SearchFeedbackRequest, 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 EndpointFeedbackEndpoint, type EndpointFeedbackRequest, type ErrorDetails, type ExecuteJavascriptAction, type ExtractResponse$1 as ExtractResponse, type FeedbackMissingContent, type FeedbackRating, type FeedbackResponse, type FeedbackValuableSource, 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 MenuAvailability, type MenuImage, type MenuItem, type MenuItemIdentifiers, type MenuMerchant, type MenuPrice, type MenuProfile, type MenuSection, type Monitor, type MonitorCheck, type MonitorCheckDetail, type MonitorCheckPage, type MonitorCrawlTarget, type MonitorCrawlTargetResult, type MonitorEmailNotification, type MonitorEmailRecipientSubscription, type MonitorJsonFieldDiff, type MonitorNotification, type MonitorPageDiff, type MonitorPageJudgment, type MonitorPageSnapshot, type MonitorSchedule, type MonitorScrapeTarget, type MonitorScrapeTargetResult, type MonitorSearchTarget, type MonitorSearchTargetResult, type MonitorSummary, type MonitorTarget, type MonitorTargetResult, 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 ProductAvailability, type ProductImage, type ProductPrice, type ProductProfile, type ProductSale, type ProductVariant, 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 SearchFeedbackRequest, type SearchGithubOptions, type SearchPapersOptions, type SearchPapersResponse, type SearchRequest, type SearchResultImages, type SearchResultNews, type SearchResultWeb, type SimilarPapersOptions, type SimilarPapersResponse, type ThreatProtectionOptions, 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-N3GO36OX.js";
+} from "./chunk-2LUWTM44.js";
 
 // src/v2/utils/httpClient.ts
 import axios from "axios";
@@ -584,10 +584,13 @@ function prepareSearchPayload(req) {
   if (req.ignoreInvalidURLs != null)
     payload.ignoreInvalidURLs = req.ignoreInvalidURLs;
   if (req.timeout != null) payload.timeout = req.timeout;
+  if (req.highlights != null) payload.highlights = req.highlights;
   if (req.integration && req.integration.trim())
     payload.integration = req.integration.trim();
   if (req.origin) payload.origin = req.origin;
   if (req.enterprise) payload.enterprise = req.enterprise;
+  if (req.threatProtection != null)
+    payload.threatProtection = req.threatProtection;
   if (req.scrapeOptions) {
     ensureValidScrapeOptions(req.scrapeOptions);
     payload.scrapeOptions = req.scrapeOptions;
@@ -664,6 +667,8 @@ function prepareMapPayload(url, options) {
       payload.integration = options.integration.trim();
     if (options.origin) payload.origin = options.origin;
     if (options.location != null) payload.location = options.location;
+    if (options.threatProtection != null)
+      payload.threatProtection = options.threatProtection;
   }
   return payload;
 }
@@ -1096,6 +1101,8 @@ function prepareExtractPayload(args) {
   if (args.origin) body.origin = args.origin;
   if (args.agent) body.agent = args.agent;
   if (args.webhook != null) body.webhook = args.webhook;
+  if (args.threatProtection != null)
+    body.threatProtection = args.threatProtection;
   if (args.scrapeOptions) {
     ensureValidScrapeOptions(args.scrapeOptions);
     body.scrapeOptions = args.scrapeOptions;
@@ -1153,6 +1160,8 @@ function prepareAgentPayload(args) {
   if (args.strictConstrainToURLs !== null && args.strictConstrainToURLs !== void 0) body.strictConstrainToURLs = args.strictConstrainToURLs;
   if (args.model !== null && args.model !== void 0) body.model = args.model;
   if (args.webhook != null) body.webhook = args.webhook;
+  if (args.threatProtection != null)
+    body.threatProtection = args.threatProtection;
   return body;
 }
 async function startAgent(http, args) {
@@ -2303,7 +2312,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-VAY7ZMTB.js");
+      const packageJson = await import("./package-2VNCXFNY.js");
       return packageJson.default.version;
     } catch (error) {
       const isTest = typeof process !== "undefined" && (process.env.JEST_WORKER_ID != null || false);

package/dist/{package-VAY7ZMTB.js → package-2VNCXFNY.js}

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

package/package.json

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

package/src/__tests__/unit/v2/search-highlights.unit.test.ts

@@ -0,0 +1,18 @@
+import { describe, expect, jest, test } from "@jest/globals";
+import { search } from "../../../v2/methods/search";
+
+describe("v2 search highlights", () => {
+  test("forwards the highlights option", async () => {
+    const http = {
+      post: jest.fn(async () => ({ status: 200, data: { success: true } })),
+    } as any;
+
+    await search(http, { query: "firecrawl", highlights: false });
+
+    expect(http.post).toHaveBeenCalledWith(
+      "/v2/search",
+      { query: "firecrawl", highlights: false },
+      {},
+    );
+  });
+});

package/src/__tests__/unit/v2/threat-protection.unit.test.ts

@@ -0,0 +1,123 @@
+import { describe, test, expect, jest } from "@jest/globals";
+import { scrape } from "../../../v2/methods/scrape";
+import { startBatchScrape } from "../../../v2/methods/batch";
+import { startCrawl } from "../../../v2/methods/crawl";
+import { search } from "../../../v2/methods/search";
+import { map } from "../../../v2/methods/map";
+import { startExtract } from "../../../v2/methods/extract";
+import { startAgent } from "../../../v2/methods/agent";
+import type { ThreatProtectionOptions } from "../../../v2/types";
+
+const threatProtection: ThreatProtectionOptions = {
+  mode: "normal",
+  riskScoreThreshold: 80,
+  blacklist: ["*.blocked.example.com"],
+  whitelist: ["allowed.example.com"],
+  blockedTlds: ["zip"],
+  failurePolicy: "open",
+};
+
+function makeHttp(data: Record<string, unknown>) {
+  const post = jest.fn(async () => ({ status: 200, data }));
+  return {
+    post,
+    prepareHeaders: jest.fn(() => undefined),
+  } as any;
+}
+
+describe("v2 threatProtection request serialization", () => {
+  test("scrape sends threatProtection at top level", async () => {
+    const http = makeHttp({ success: true, data: {} });
+    await scrape(http, "https://example.com", { threatProtection });
+    expect(http.post).toHaveBeenCalledWith(
+      "/v2/scrape",
+      expect.objectContaining({ url: "https://example.com", threatProtection }),
+      {},
+    );
+  });
+
+  test("batch scrape sends threatProtection at top level", async () => {
+    const http = makeHttp({ success: true, id: "job", url: "u" });
+    await startBatchScrape(http, ["https://example.com"], {
+      options: { threatProtection },
+    });
+    expect(http.post).toHaveBeenCalledWith(
+      "/v2/batch/scrape",
+      expect.objectContaining({
+        urls: ["https://example.com"],
+        threatProtection,
+      }),
+      expect.anything(),
+    );
+  });
+
+  test("crawl sends threatProtection under scrapeOptions", async () => {
+    const http = makeHttp({ success: true, id: "job", url: "u" });
+    await startCrawl(http, {
+      url: "https://example.com",
+      scrapeOptions: { threatProtection },
+    });
+    expect(http.post).toHaveBeenCalledWith(
+      "/v2/crawl",
+      expect.objectContaining({
+        scrapeOptions: expect.objectContaining({ threatProtection }),
+      }),
+    );
+  });
+
+  test("search sends threatProtection at top level and under scrapeOptions", async () => {
+    const http = makeHttp({ success: true, data: {} });
+    await search(http, {
+      query: "firecrawl",
+      threatProtection,
+      scrapeOptions: { threatProtection },
+    });
+    expect(http.post).toHaveBeenCalledWith(
+      "/v2/search",
+      expect.objectContaining({
+        threatProtection,
+        scrapeOptions: expect.objectContaining({ threatProtection }),
+      }),
+      {},
+    );
+  });
+
+  test("map sends threatProtection at top level", async () => {
+    const http = makeHttp({ success: true, links: [] });
+    await map(http, "https://example.com", { threatProtection });
+    expect(http.post).toHaveBeenCalledWith(
+      "/v2/map",
+      expect.objectContaining({ threatProtection }),
+      {},
+    );
+  });
+
+  test("extract sends threatProtection at top level", async () => {
+    const http = makeHttp({ success: true, id: "job" });
+    await startExtract(http, {
+      urls: ["https://example.com"],
+      prompt: "extract",
+      threatProtection,
+    });
+    expect(http.post).toHaveBeenCalledWith(
+      "/v2/extract",
+      expect.objectContaining({ threatProtection }),
+    );
+  });
+
+  test("agent sends threatProtection at top level", async () => {
+    const http = makeHttp({ success: true, id: "job", status: "processing" });
+    await startAgent(http, { prompt: "find pricing", threatProtection });
+    expect(http.post).toHaveBeenCalledWith(
+      "/v2/agent",
+      expect.objectContaining({ threatProtection }),
+    );
+  });
+
+  test("threatProtection is omitted when not provided", async () => {
+    const http = makeHttp({ success: true, data: {} });
+    await scrape(http, "https://example.com", { onlyMainContent: true });
+    const body = http.post.mock.calls[0][1] as Record<string, unknown>;
+    expect(body).not.toHaveProperty("threatProtection");
+  });
+});

package/src/v2/methods/agent.ts

@@ -1,4 +1,4 @@
-import { type AgentResponse, type AgentStatusResponse, type AgentWebhookConfig } from "../types";
+import { type AgentResponse, type AgentStatusResponse, type AgentWebhookConfig, type ThreatProtectionOptions } from "../types";
 import { HttpClient } from "../utils/httpClient";
 import { normalizeAxiosError, throwForBadResponse } from "../utils/errorHandler";
 import { isZodSchema, zodSchemaToJsonSchema } from "../../utils/zodSchemaToJson";
@@ -14,6 +14,7 @@ function prepareAgentPayload(args: {
   strictConstrainToURLs?: boolean;
   model?: "spark-1-pro" | "spark-1-mini";
   webhook?: string | AgentWebhookConfig;
+  threatProtection?: ThreatProtectionOptions;
 }): Record<string, unknown> {
   const body: Record<string, unknown> = {};
   if (args.urls) body.urls = args.urls;
@@ -27,6 +28,8 @@ function prepareAgentPayload(args: {
   if (args.strictConstrainToURLs !== null && args.strictConstrainToURLs !== undefined) body.strictConstrainToURLs = args.strictConstrainToURLs;
   if (args.model !== null && args.model !== undefined) body.model = args.model;
   if (args.webhook != null) body.webhook = args.webhook;
+  if (args.threatProtection != null)
+    body.threatProtection = args.threatProtection;
   return body;
 }
 

package/src/v2/methods/extract.ts

@@ -1,4 +1,4 @@
-import { type ExtractResponse, type ScrapeOptions, type AgentOptions, type WebhookConfig } from "../types";
+import { type ExtractResponse, type ScrapeOptions, type AgentOptions, type ThreatProtectionOptions, type WebhookConfig } from "../types";
 import { HttpClient } from "../utils/httpClient";
 import { ensureValidScrapeOptions } from "../utils/validation";
 import { normalizeAxiosError, throwForBadResponse } from "../utils/errorHandler";
@@ -19,6 +19,7 @@ function prepareExtractPayload(args: {
   origin?: string;
   agent?: AgentOptions;
   webhook?: string | WebhookConfig | null;
+  threatProtection?: ThreatProtectionOptions;
 }): Record<string, unknown> {
   const body: Record<string, unknown> = {};
   if (args.urls) body.urls = args.urls;
@@ -35,6 +36,8 @@ function prepareExtractPayload(args: {
   if (args.origin) body.origin = args.origin;
   if (args.agent) body.agent = args.agent;
   if (args.webhook != null) body.webhook = args.webhook;
+  if (args.threatProtection != null)
+    body.threatProtection = args.threatProtection;
   if (args.scrapeOptions) {
     ensureValidScrapeOptions(args.scrapeOptions);
     body.scrapeOptions = args.scrapeOptions;

package/src/v2/methods/map.ts

@@ -24,6 +24,8 @@ function prepareMapPayload(
       payload.integration = options.integration.trim();
     if (options.origin) payload.origin = options.origin;
     if (options.location != null) payload.location = options.location;
+    if (options.threatProtection != null)
+      payload.threatProtection = options.threatProtection;
   }
   return payload;
 }

package/src/v2/methods/search.ts

@@ -37,10 +37,13 @@ function prepareSearchPayload(req: SearchRequest): Record<string, unknown> {
   if (req.ignoreInvalidURLs != null)
     payload.ignoreInvalidURLs = req.ignoreInvalidURLs;
   if (req.timeout != null) payload.timeout = req.timeout;
+  if (req.highlights != null) payload.highlights = req.highlights;
   if (req.integration && req.integration.trim())
     payload.integration = req.integration.trim();
   if (req.origin) payload.origin = req.origin;
   if (req.enterprise) payload.enterprise = req.enterprise;
+  if (req.threatProtection != null)
+    payload.threatProtection = req.threatProtection;
   if (req.scrapeOptions) {
     ensureValidScrapeOptions(req.scrapeOptions as ScrapeOptions);
     payload.scrapeOptions = req.scrapeOptions;

package/src/v2/types.ts

@@ -208,6 +208,7 @@ export interface ScrapeOptions {
   storeInCache?: boolean;
   lockdown?: boolean;
   redactPII?: boolean | RedactPIIOptions;
+  threatProtection?: ThreatProtectionOptions;
   profile?: {
     name: string;
     saveChanges?: boolean;
@@ -241,6 +242,27 @@ export interface RedactPIIOptions {
   replaceStyle?: "tag" | "mask" | "remove";
 }
 
+/**
+ * Enterprise: per-request field-level override of your team's threat
+ * protection policy. Requires threat protection to be enabled for your team
+ * and request overrides to be allowed in the team configuration. Only the
+ * fields you provide replace the team policy's values.
+ */
+export interface ThreatProtectionOptions {
+  /** "off" disables scanning for this request; "normal" applies the policy. */
+  mode?: "off" | "normal";
+  /** Block verdicts at or above this risk score (integer 0-100). */
+  riskScoreThreshold?: number;
+  /** Exact domains or globs like "*.example.com" to always block (max 1000). */
+  blacklist?: string[];
+  /** Exact domains or globs to always allow; wins over everything (max 1000). */
+  whitelist?: string[];
+  /** Lowercase TLDs without the leading dot, e.g. "zip" (max 1000). */
+  blockedTlds?: string[];
+  /** Behavior when scanning is unavailable: "closed" blocks, "open" allows. */
+  failurePolicy?: "open" | "closed";
+}
+
 export type ParseFileData =
   | Blob
   | File
@@ -267,6 +289,7 @@ export type ParseOptions = Omit<
   | "storeInCache"
   | "lockdown"
   | "proxy"
+  | "threatProtection"
 > & {
   formats?: ParseFormatOption[];
   proxy?: "basic" | "auto";
@@ -674,6 +697,8 @@ export interface SearchRequest {
   location?: string;
   ignoreInvalidURLs?: boolean;
   timeout?: number; // ms
+  /** Generate query-relevant highlights for search results. Defaults to true. */
+  highlights?: boolean;
   scrapeOptions?: ScrapeOptions;
   /**
    * Enterprise search options. Use `["zdr"]` for end-to-end Zero Data
@@ -681,6 +706,7 @@ export interface SearchRequest {
    * your team.
    */
   enterprise?: Array<"default" | "anon" | "zdr">;
+  threatProtection?: ThreatProtectionOptions;
   integration?: string;
   origin?: string;
 }
@@ -769,6 +795,7 @@ export interface MapOptions {
   integration?: string;
   origin?: string;
   location?: LocationConfig;
+  threatProtection?: ThreatProtectionOptions;
 }
 
 export type FeedbackRating = "good" | "partial" | "bad";