firecrawl 4.24.1 → 4.25.0

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

@@ -8,7 +8,7 @@ var require_package = __commonJS({
   "package.json"(exports, module) {
     module.exports = {
       name: "@mendable/firecrawl-js",
-      version: "4.24.1",
+      version: "4.25.0",
       description: "JavaScript SDK for Firecrawl API",
       main: "dist/index.js",
       types: "dist/index.d.ts",
@@ -77,7 +77,7 @@ var require_package = __commonJS({
           "rollup@<4.59.0": ">=4.59.0",
           "picomatch@<4.0.4": ">=4.0.4",
           handlebars: ">=4.7.9",
-          "brace-expansion": ">=5.0.5",
+          "brace-expansion": ">=5.0.6",
           "axios@<1.15.2": "1.15.2",
           "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.24.1",
+      version: "4.25.0",
       description: "JavaScript SDK for Firecrawl API",
       main: "dist/index.js",
       types: "dist/index.d.ts",
@@ -104,7 +104,7 @@ var require_package = __commonJS({
           "rollup@<4.59.0": ">=4.59.0",
           "picomatch@<4.0.4": ">=4.0.4",
           handlebars: ">=4.7.9",
-          "brace-expansion": ">=5.0.5",
+          "brace-expansion": ">=5.0.6",
           "axios@<1.15.2": "1.15.2",
           "follow-redirects@<1.16.0": ">=1.16.0 <2.0.0"
         }
@@ -746,6 +746,20 @@ async function search(http, request) {
     if (data.news) out.news = transformArray(data.news);
     if (data.images)
       out.images = transformArray(data.images);
+    Object.defineProperty(out, "data", {
+      get() {
+        const parts = [];
+        if (out.web?.length) parts.push(`.web (${out.web.length} results)`);
+        if (out.news?.length) parts.push(`.news (${out.news.length} results)`);
+        if (out.images?.length) parts.push(`.images (${out.images.length} results)`);
+        const available = parts.length ? parts.join(", ") : ".web, .news, or .images";
+        throw new Error(
+          `SearchData has no '.data'. Results are grouped by source: ${available}`
+        );
+      },
+      enumerable: false,
+      configurable: true
+    });
     return out;
   } catch (err) {
     if (err?.isAxiosError) return normalizeAxiosError(err, "search");
@@ -1781,20 +1795,21 @@ var FirecrawlClient = class {
   }
   /**
    * Create a v2 client.
-   * @param options Transport configuration (API key, base URL, timeouts, retries).
+   * @param options API key string or transport configuration object.
    */
   constructor(options = {}) {
-    const apiKey = options.apiKey ?? process.env.FIRECRAWL_API_KEY ?? "";
-    const apiUrl = (options.apiUrl ?? process.env.FIRECRAWL_API_URL ?? "https://api.firecrawl.dev").replace(/\/$/, "");
+    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,
-      timeoutMs: options.timeoutMs,
-      maxRetries: options.maxRetries,
-      backoffFactor: options.backoffFactor
+      timeoutMs: opts.timeoutMs,
+      maxRetries: opts.maxRetries,
+      backoffFactor: opts.backoffFactor
     });
   }
   async scrape(url, options) {
@@ -2131,6 +2146,46 @@ var FirecrawlClient = class {
   watcher(jobId, opts = {}) {
     return new Watcher(this.http, jobId, opts);
   }
+  /** @deprecated V1 compatibility alias for agent recovery. Prefer scrape(). */
+  async scrapeUrl(url, options) {
+    return this.scrape(url, options);
+  }
+  /** @deprecated V1 compatibility alias for agent recovery. Prefer crawl(). */
+  async crawlUrl(url, req = {}) {
+    return this.crawl(url, req);
+  }
+  /** @deprecated V1 compatibility alias for agent recovery. Prefer startCrawl(). */
+  async asyncCrawlUrl(url, req = {}) {
+    return this.startCrawl(url, req);
+  }
+  /** @deprecated V1 compatibility alias for agent recovery. Prefer getCrawlStatus(). */
+  async checkCrawlStatus(jobId, pagination) {
+    return this.getCrawlStatus(jobId, pagination);
+  }
+  /** @deprecated V1 compatibility alias for agent recovery. Prefer getCrawlErrors(). */
+  async checkCrawlErrors(crawlId) {
+    return this.getCrawlErrors(crawlId);
+  }
+  /** @deprecated V1 compatibility alias for agent recovery. Prefer map(). */
+  async mapUrl(url, options) {
+    return this.map(url, options);
+  }
+  /** @deprecated V1 compatibility alias for agent recovery. Prefer batchScrape(). */
+  async batchScrapeUrls(urls, opts) {
+    return this.batchScrape(urls, opts);
+  }
+  /** @deprecated V1 compatibility alias for agent recovery. Prefer startBatchScrape(). */
+  async asyncBatchScrapeUrls(urls, opts) {
+    return this.startBatchScrape(urls, opts);
+  }
+  /** @deprecated V1 compatibility alias for agent recovery. Prefer getBatchScrapeStatus(). */
+  async checkBatchScrapeStatus(jobId, pagination) {
+    return this.getBatchScrapeStatus(jobId, pagination);
+  }
+  /** @deprecated V1 compatibility alias for agent recovery. Prefer getBatchScrapeErrors(). */
+  async checkBatchScrapeErrors(jobId) {
+    return this.getBatchScrapeErrors(jobId);
+  }
 };
 
 // src/v1/index.ts
@@ -3534,12 +3589,13 @@ var Firecrawl = class extends FirecrawlClient {
   /** Feature‑frozen v1 client (lazy). */
   _v1;
   _v1Opts;
-  /** @param opts API credentials and base URL. */
+  /** @param opts API key string or credentials object. */
   constructor(opts = {}) {
-    super(opts);
+    const resolved = typeof opts === "string" ? { apiKey: opts } : opts;
+    super(resolved);
     this._v1Opts = {
-      apiKey: opts.apiKey,
-      apiUrl: opts.apiUrl
+      apiKey: resolved.apiKey,
+      apiUrl: resolved.apiUrl
     };
   }
   /** Access the legacy v1 client (instantiated on first access). */
@@ -3548,6 +3604,14 @@ var Firecrawl = class extends FirecrawlClient {
     return this._v1;
   }
 };
+(function exposeV2MethodsOnTopLevel() {
+  for (const name of Object.getOwnPropertyNames(FirecrawlClient.prototype)) {
+    if (name === "constructor") continue;
+    if (Object.prototype.hasOwnProperty.call(Firecrawl.prototype, name)) continue;
+    const desc = Object.getOwnPropertyDescriptor(FirecrawlClient.prototype, name);
+    if (desc) Object.defineProperty(Firecrawl.prototype, name, desc);
+  }
+})();
 var index_default = Firecrawl;
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {

package/dist/index.d.cts

@@ -552,6 +552,8 @@ interface CreateMonitorRequest {
     notification?: MonitorNotification;
     targets: MonitorTarget[];
     retentionDays?: number;
+    goal?: string;
+    judgeEnabled?: boolean;
 }
 interface UpdateMonitorRequest {
     name?: string;
@@ -561,6 +563,8 @@ interface UpdateMonitorRequest {
     notification?: MonitorNotification | null;
     targets?: MonitorTarget[];
     retentionDays?: number;
+    goal?: string | null;
+    judgeEnabled?: boolean;
 }
 interface MonitorSummary {
     totalPages: number;
@@ -584,9 +588,17 @@ interface Monitor {
     retentionDays: number;
     estimatedCreditsPerMonth?: number | null;
     lastCheckSummary?: MonitorSummary | null;
+    goal?: string | null;
+    judgeEnabled?: boolean;
     createdAt: string;
     updatedAt: string;
 }
+interface MonitorPageJudgment {
+    meaningful: boolean;
+    confidence: "high" | "medium" | "low";
+    reason: string;
+    fields: string[];
+}
 interface MonitorCheck {
     id: string;
     monitorId: string;
@@ -650,6 +662,7 @@ interface MonitorCheckPage {
     metadata?: unknown;
     diff?: MonitorPageDiff | null;
     snapshot?: MonitorPageSnapshot | null;
+    judgment?: MonitorPageJudgment | null;
     createdAt: string;
 }
 interface MonitorCheckDetail extends MonitorCheck {
@@ -960,6 +973,8 @@ interface FirecrawlClientOptions {
     /** Exponential backoff factor for retries (optional). */
     backoffFactor?: number;
 }
+/** Accepts a plain API key string or a full options object. */
+type FirecrawlClientInput = FirecrawlClientOptions | string;
 /**
  * Firecrawl v2 client. Provides typed access to all v2 endpoints and utilities.
  */
@@ -968,9 +983,9 @@ declare class FirecrawlClient {
     private isCloudService;
     /**
      * Create a v2 client.
-     * @param options Transport configuration (API key, base URL, timeouts, retries).
+     * @param options API key string or transport configuration object.
      */
-    constructor(options?: FirecrawlClientOptions);
+    constructor(options?: FirecrawlClientInput);
     /**
      * Scrape a single URL.
      * @param url Target URL.
@@ -1234,6 +1249,32 @@ declare class FirecrawlClient {
      * @param opts Watcher options (kind, pollInterval, timeout seconds).
      */
     watcher(jobId: string, opts?: WatcherOptions): Watcher;
+    /** @deprecated V1 compatibility alias for agent recovery. Prefer scrape(). */
+    scrapeUrl(url: string, options?: ScrapeOptions): Promise<Document>;
+    /** @deprecated V1 compatibility alias for agent recovery. Prefer crawl(). */
+    crawlUrl(url: string, req?: CrawlOptions & {
+        pollInterval?: number;
+        timeout?: number;
+    }): Promise<CrawlJob>;
+    /** @deprecated V1 compatibility alias for agent recovery. Prefer startCrawl(). */
+    asyncCrawlUrl(url: string, req?: CrawlOptions): Promise<CrawlResponse$1>;
+    /** @deprecated V1 compatibility alias for agent recovery. Prefer getCrawlStatus(). */
+    checkCrawlStatus(jobId: string, pagination?: PaginationConfig): Promise<CrawlJob>;
+    /** @deprecated V1 compatibility alias for agent recovery. Prefer getCrawlErrors(). */
+    checkCrawlErrors(crawlId: string): Promise<CrawlErrorsResponse$1>;
+    /** @deprecated V1 compatibility alias for agent recovery. Prefer map(). */
+    mapUrl(url: string, options?: MapOptions): Promise<MapData>;
+    /** @deprecated V1 compatibility alias for agent recovery. Prefer batchScrape(). */
+    batchScrapeUrls(urls: string[], opts?: BatchScrapeOptions & {
+        pollInterval?: number;
+        timeout?: number;
+    }): Promise<BatchScrapeJob>;
+    /** @deprecated V1 compatibility alias for agent recovery. Prefer startBatchScrape(). */
+    asyncBatchScrapeUrls(urls: string[], opts?: BatchScrapeOptions): Promise<BatchScrapeResponse$1>;
+    /** @deprecated V1 compatibility alias for agent recovery. Prefer getBatchScrapeStatus(). */
+    checkBatchScrapeStatus(jobId: string, pagination?: PaginationConfig): Promise<BatchScrapeJob>;
+    /** @deprecated V1 compatibility alias for agent recovery. Prefer getBatchScrapeErrors(). */
+    checkBatchScrapeErrors(jobId: string): Promise<CrawlErrorsResponse$1>;
 }
 
 /**
@@ -2156,10 +2197,10 @@ declare class Firecrawl extends FirecrawlClient {
     /** Feature‑frozen v1 client (lazy). */
     private _v1?;
     private _v1Opts;
-    /** @param opts API credentials and base URL. */
-    constructor(opts?: FirecrawlClientOptions);
+    /** @param opts API key string or credentials object. */
+    constructor(opts?: FirecrawlClientInput);
     /** Access the legacy v1 client (instantiated on first access). */
     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 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 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 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 };

package/dist/index.d.ts

@@ -552,6 +552,8 @@ interface CreateMonitorRequest {
     notification?: MonitorNotification;
     targets: MonitorTarget[];
     retentionDays?: number;
+    goal?: string;
+    judgeEnabled?: boolean;
 }
 interface UpdateMonitorRequest {
     name?: string;
@@ -561,6 +563,8 @@ interface UpdateMonitorRequest {
     notification?: MonitorNotification | null;
     targets?: MonitorTarget[];
     retentionDays?: number;
+    goal?: string | null;
+    judgeEnabled?: boolean;
 }
 interface MonitorSummary {
     totalPages: number;
@@ -584,9 +588,17 @@ interface Monitor {
     retentionDays: number;
     estimatedCreditsPerMonth?: number | null;
     lastCheckSummary?: MonitorSummary | null;
+    goal?: string | null;
+    judgeEnabled?: boolean;
     createdAt: string;
     updatedAt: string;
 }
+interface MonitorPageJudgment {
+    meaningful: boolean;
+    confidence: "high" | "medium" | "low";
+    reason: string;
+    fields: string[];
+}
 interface MonitorCheck {
     id: string;
     monitorId: string;
@@ -650,6 +662,7 @@ interface MonitorCheckPage {
     metadata?: unknown;
     diff?: MonitorPageDiff | null;
     snapshot?: MonitorPageSnapshot | null;
+    judgment?: MonitorPageJudgment | null;
     createdAt: string;
 }
 interface MonitorCheckDetail extends MonitorCheck {
@@ -960,6 +973,8 @@ interface FirecrawlClientOptions {
     /** Exponential backoff factor for retries (optional). */
     backoffFactor?: number;
 }
+/** Accepts a plain API key string or a full options object. */
+type FirecrawlClientInput = FirecrawlClientOptions | string;
 /**
  * Firecrawl v2 client. Provides typed access to all v2 endpoints and utilities.
  */
@@ -968,9 +983,9 @@ declare class FirecrawlClient {
     private isCloudService;
     /**
      * Create a v2 client.
-     * @param options Transport configuration (API key, base URL, timeouts, retries).
+     * @param options API key string or transport configuration object.
      */
-    constructor(options?: FirecrawlClientOptions);
+    constructor(options?: FirecrawlClientInput);
     /**
      * Scrape a single URL.
      * @param url Target URL.
@@ -1234,6 +1249,32 @@ declare class FirecrawlClient {
      * @param opts Watcher options (kind, pollInterval, timeout seconds).
      */
     watcher(jobId: string, opts?: WatcherOptions): Watcher;
+    /** @deprecated V1 compatibility alias for agent recovery. Prefer scrape(). */
+    scrapeUrl(url: string, options?: ScrapeOptions): Promise<Document>;
+    /** @deprecated V1 compatibility alias for agent recovery. Prefer crawl(). */
+    crawlUrl(url: string, req?: CrawlOptions & {
+        pollInterval?: number;
+        timeout?: number;
+    }): Promise<CrawlJob>;
+    /** @deprecated V1 compatibility alias for agent recovery. Prefer startCrawl(). */
+    asyncCrawlUrl(url: string, req?: CrawlOptions): Promise<CrawlResponse$1>;
+    /** @deprecated V1 compatibility alias for agent recovery. Prefer getCrawlStatus(). */
+    checkCrawlStatus(jobId: string, pagination?: PaginationConfig): Promise<CrawlJob>;
+    /** @deprecated V1 compatibility alias for agent recovery. Prefer getCrawlErrors(). */
+    checkCrawlErrors(crawlId: string): Promise<CrawlErrorsResponse$1>;
+    /** @deprecated V1 compatibility alias for agent recovery. Prefer map(). */
+    mapUrl(url: string, options?: MapOptions): Promise<MapData>;
+    /** @deprecated V1 compatibility alias for agent recovery. Prefer batchScrape(). */
+    batchScrapeUrls(urls: string[], opts?: BatchScrapeOptions & {
+        pollInterval?: number;
+        timeout?: number;
+    }): Promise<BatchScrapeJob>;
+    /** @deprecated V1 compatibility alias for agent recovery. Prefer startBatchScrape(). */
+    asyncBatchScrapeUrls(urls: string[], opts?: BatchScrapeOptions): Promise<BatchScrapeResponse$1>;
+    /** @deprecated V1 compatibility alias for agent recovery. Prefer getBatchScrapeStatus(). */
+    checkBatchScrapeStatus(jobId: string, pagination?: PaginationConfig): Promise<BatchScrapeJob>;
+    /** @deprecated V1 compatibility alias for agent recovery. Prefer getBatchScrapeErrors(). */
+    checkBatchScrapeErrors(jobId: string): Promise<CrawlErrorsResponse$1>;
 }
 
 /**
@@ -2156,10 +2197,10 @@ declare class Firecrawl extends FirecrawlClient {
     /** Feature‑frozen v1 client (lazy). */
     private _v1?;
     private _v1Opts;
-    /** @param opts API credentials and base URL. */
-    constructor(opts?: FirecrawlClientOptions);
+    /** @param opts API key string or credentials object. */
+    constructor(opts?: FirecrawlClientInput);
     /** Access the legacy v1 client (instantiated on first access). */
     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 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 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 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 };

package/dist/index.js

@@ -1,6 +1,6 @@
 import {
   require_package
-} from "./chunk-F3RFBUTZ.js";
+} from "./chunk-46XQC2QL.js";
 
 // src/v2/utils/httpClient.ts
 import axios from "axios";
@@ -622,6 +622,20 @@ async function search(http, request) {
     if (data.news) out.news = transformArray(data.news);
     if (data.images)
       out.images = transformArray(data.images);
+    Object.defineProperty(out, "data", {
+      get() {
+        const parts = [];
+        if (out.web?.length) parts.push(`.web (${out.web.length} results)`);
+        if (out.news?.length) parts.push(`.news (${out.news.length} results)`);
+        if (out.images?.length) parts.push(`.images (${out.images.length} results)`);
+        const available = parts.length ? parts.join(", ") : ".web, .news, or .images";
+        throw new Error(
+          `SearchData has no '.data'. Results are grouped by source: ${available}`
+        );
+      },
+      enumerable: false,
+      configurable: true
+    });
     return out;
   } catch (err) {
     if (err?.isAxiosError) return normalizeAxiosError(err, "search");
@@ -1657,20 +1671,21 @@ var FirecrawlClient = class {
   }
   /**
    * Create a v2 client.
-   * @param options Transport configuration (API key, base URL, timeouts, retries).
+   * @param options API key string or transport configuration object.
    */
   constructor(options = {}) {
-    const apiKey = options.apiKey ?? process.env.FIRECRAWL_API_KEY ?? "";
-    const apiUrl = (options.apiUrl ?? process.env.FIRECRAWL_API_URL ?? "https://api.firecrawl.dev").replace(/\/$/, "");
+    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,
-      timeoutMs: options.timeoutMs,
-      maxRetries: options.maxRetries,
-      backoffFactor: options.backoffFactor
+      timeoutMs: opts.timeoutMs,
+      maxRetries: opts.maxRetries,
+      backoffFactor: opts.backoffFactor
     });
   }
   async scrape(url, options) {
@@ -2007,6 +2022,46 @@ var FirecrawlClient = class {
   watcher(jobId, opts = {}) {
     return new Watcher(this.http, jobId, opts);
   }
+  /** @deprecated V1 compatibility alias for agent recovery. Prefer scrape(). */
+  async scrapeUrl(url, options) {
+    return this.scrape(url, options);
+  }
+  /** @deprecated V1 compatibility alias for agent recovery. Prefer crawl(). */
+  async crawlUrl(url, req = {}) {
+    return this.crawl(url, req);
+  }
+  /** @deprecated V1 compatibility alias for agent recovery. Prefer startCrawl(). */
+  async asyncCrawlUrl(url, req = {}) {
+    return this.startCrawl(url, req);
+  }
+  /** @deprecated V1 compatibility alias for agent recovery. Prefer getCrawlStatus(). */
+  async checkCrawlStatus(jobId, pagination) {
+    return this.getCrawlStatus(jobId, pagination);
+  }
+  /** @deprecated V1 compatibility alias for agent recovery. Prefer getCrawlErrors(). */
+  async checkCrawlErrors(crawlId) {
+    return this.getCrawlErrors(crawlId);
+  }
+  /** @deprecated V1 compatibility alias for agent recovery. Prefer map(). */
+  async mapUrl(url, options) {
+    return this.map(url, options);
+  }
+  /** @deprecated V1 compatibility alias for agent recovery. Prefer batchScrape(). */
+  async batchScrapeUrls(urls, opts) {
+    return this.batchScrape(urls, opts);
+  }
+  /** @deprecated V1 compatibility alias for agent recovery. Prefer startBatchScrape(). */
+  async asyncBatchScrapeUrls(urls, opts) {
+    return this.startBatchScrape(urls, opts);
+  }
+  /** @deprecated V1 compatibility alias for agent recovery. Prefer getBatchScrapeStatus(). */
+  async checkBatchScrapeStatus(jobId, pagination) {
+    return this.getBatchScrapeStatus(jobId, pagination);
+  }
+  /** @deprecated V1 compatibility alias for agent recovery. Prefer getBatchScrapeErrors(). */
+  async checkBatchScrapeErrors(jobId) {
+    return this.getBatchScrapeErrors(jobId);
+  }
 };
 
 // src/v1/index.ts
@@ -2042,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-B3VSS5SY.js");
+      const packageJson = await import("./package-MW3GMNCL.js");
       return packageJson.default.version;
     } catch (error) {
       const isTest = typeof process !== "undefined" && (process.env.JEST_WORKER_ID != null || false);
@@ -3410,12 +3465,13 @@ var Firecrawl = class extends FirecrawlClient {
   /** Feature‑frozen v1 client (lazy). */
   _v1;
   _v1Opts;
-  /** @param opts API credentials and base URL. */
+  /** @param opts API key string or credentials object. */
   constructor(opts = {}) {
-    super(opts);
+    const resolved = typeof opts === "string" ? { apiKey: opts } : opts;
+    super(resolved);
     this._v1Opts = {
-      apiKey: opts.apiKey,
-      apiUrl: opts.apiUrl
+      apiKey: resolved.apiKey,
+      apiUrl: resolved.apiUrl
     };
   }
   /** Access the legacy v1 client (instantiated on first access). */
@@ -3424,6 +3480,14 @@ var Firecrawl = class extends FirecrawlClient {
     return this._v1;
   }
 };
+(function exposeV2MethodsOnTopLevel() {
+  for (const name of Object.getOwnPropertyNames(FirecrawlClient.prototype)) {
+    if (name === "constructor") continue;
+    if (Object.prototype.hasOwnProperty.call(Firecrawl.prototype, name)) continue;
+    const desc = Object.getOwnPropertyDescriptor(FirecrawlClient.prototype, name);
+    if (desc) Object.defineProperty(Firecrawl.prototype, name, desc);
+  }
+})();
 var index_default = Firecrawl;
 export {
   Firecrawl,

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

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

package/package.json

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

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

@@ -1,4 +1,4 @@
-import { Firecrawl, type FirecrawlClientOptions } from '../../../index';
+import { Firecrawl, FirecrawlClient, type FirecrawlClientOptions } from '../../../index';
 
 describe('Firecrawl v2 Client Options', () => {
   it('should accept v2 options including timeoutMs, maxRetries, and backoffFactor', () => {
@@ -52,4 +52,32 @@ describe('Firecrawl v2 Client Options', () => {
     expect(options.timeoutMs).toBe(300);
     expect(options.apiKey).toBe('test-key');
   });
+
+  it('should accept a string API key in Firecrawl constructor', () => {
+    const client = new Firecrawl('test-key');
+
+    expect(client).toBeDefined();
+    expect(client).toBeInstanceOf(Firecrawl);
+  });
+
+  it('should accept a string API key in FirecrawlClient constructor', () => {
+    const client = new FirecrawlClient('test-key');
+
+    expect(client).toBeDefined();
+    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 provide v1 accessor when constructed with string', () => {
+    const client = new Firecrawl('test-key');
+
+    expect(client.v1).toBeDefined();
+  });
 });

package/src/__tests__/unit/v2/prototype-discoverability.test.ts

@@ -0,0 +1,45 @@
+import { Firecrawl, FirecrawlClient } from "../../../index";
+
+describe("V2 prototype discoverability", () => {
+  const app = new Firecrawl({ apiKey: "fc-test", apiUrl: "http://localhost:9" });
+
+  it("exposes V2 methods on immediate Firecrawl prototype", () => {
+    const names = Object.getOwnPropertyNames(Object.getPrototypeOf(app));
+
+    expect(names).toEqual(
+      expect.arrayContaining([
+        "scrape",
+        "search",
+        "map",
+        "crawl",
+        "startCrawl",
+        "getCrawlStatus",
+        "batchScrape",
+        "v1",
+      ])
+    );
+  });
+
+  it("preserves v1 getter on Firecrawl prototype", () => {
+    const desc = Object.getOwnPropertyDescriptor(
+      Object.getPrototypeOf(app),
+      "v1"
+    );
+    expect(desc).toBeDefined();
+    expect(desc!.get).toBeDefined();
+  });
+
+  it("copied descriptors are identical to V2 prototype originals", () => {
+    for (const name of ["scrape", "search", "crawl", "map", "startCrawl"]) {
+      const firecrawlDesc = Object.getOwnPropertyDescriptor(Firecrawl.prototype, name);
+      const v2Desc = Object.getOwnPropertyDescriptor(FirecrawlClient.prototype, name);
+      expect(firecrawlDesc).toBeDefined();
+      expect(firecrawlDesc!.value).toBe(v2Desc!.value);
+    }
+  });
+
+  it("copied method resolves this to the Firecrawl instance", async () => {
+    const method = Object.getOwnPropertyDescriptor(Firecrawl.prototype, "scrape")!.value;
+    await expect(method.call(app, "https://example.com")).rejects.toThrow();
+  });
+});

package/src/__tests__/unit/v2/search-data-property.test.ts

@@ -0,0 +1,66 @@
+import { search } from "../../../v2/methods/search";
+
+const fakeHttp = {
+  post: jest.fn(),
+} as any;
+
+describe("SearchData .data helpful error", () => {
+  beforeEach(() => jest.clearAllMocks());
+
+  it("throws with available sources when .data is accessed", async () => {
+    fakeHttp.post.mockResolvedValue({
+      status: 200,
+      data: {
+        success: true,
+        data: {
+          web: [{ title: "Test", url: "http://a.com" }],
+        },
+      },
+    });
+
+    const result = await search(fakeHttp, { query: "test" });
+    expect(result.web).toHaveLength(1);
+    expect(() => (result as any).data).toThrow(
+      /SearchData has no '\.data'.*\.web \(1 results\)/,
+    );
+  });
+
+  it("throws with multiple sources listed", async () => {
+    fakeHttp.post.mockResolvedValue({
+      status: 200,
+      data: {
+        success: true,
+        data: {
+          web: [{ title: "W", url: "http://a.com" }],
+          news: [{ title: "N", url: "http://b.com" }],
+        },
+      },
+    });
+
+    const result = await search(fakeHttp, { query: "test" });
+    expect(() => (result as any).data).toThrow(/\.web.*\.news/);
+  });
+
+  it("throws with generic message when empty", async () => {
+    fakeHttp.post.mockResolvedValue({
+      status: 200,
+      data: { success: true, data: {} },
+    });
+
+    const result = await search(fakeHttp, { query: "test" });
+    expect(() => (result as any).data).toThrow("grouped by source");
+  });
+
+  it("does not show .data in Object.keys", async () => {
+    fakeHttp.post.mockResolvedValue({
+      status: 200,
+      data: {
+        success: true,
+        data: { web: [{ title: "T", url: "http://a.com" }] },
+      },
+    });
+
+    const result = await search(fakeHttp, { query: "test" });
+    expect(Object.keys(result)).not.toContain("data");
+  });
+});

package/src/__tests__/unit/v2/v1-aliases.test.ts

@@ -0,0 +1,32 @@
+import { FirecrawlClient } from "../../../v2/client";
+
+const ALIAS_MAP: Record<string, string> = {
+  scrapeUrl: "scrape",
+  crawlUrl: "crawl",
+  asyncCrawlUrl: "startCrawl",
+  checkCrawlStatus: "getCrawlStatus",
+  checkCrawlErrors: "getCrawlErrors",
+  mapUrl: "map",
+  batchScrapeUrls: "batchScrape",
+  asyncBatchScrapeUrls: "startBatchScrape",
+  checkBatchScrapeStatus: "getBatchScrapeStatus",
+  checkBatchScrapeErrors: "getBatchScrapeErrors",
+};
+
+describe("V1 deprecated aliases", () => {
+  const app = new FirecrawlClient({
+    apiKey: "fc-test",
+    apiUrl: "http://localhost:9",
+  });
+
+  for (const [alias, target] of Object.entries(ALIAS_MAP)) {
+    it(`${alias} delegates to ${target}`, async () => {
+      const spy = jest
+        .spyOn(app, target as any)
+        .mockResolvedValue({ ok: true } as any);
+      await (app as any)[alias]("https://example.com");
+      expect(spy).toHaveBeenCalled();
+      spy.mockRestore();
+    });
+  }
+});

package/src/index.ts

@@ -15,11 +15,11 @@ export { Watcher, type WatcherOptions } from "./v2/watcher";
 export { default as FirecrawlAppV1 } from "./v1";
 
 import V1 from "./v1";
-import { FirecrawlClient as V2, type FirecrawlClientOptions } from "./v2/client";
+import { FirecrawlClient as V2, type FirecrawlClientOptions, type FirecrawlClientInput } from "./v2/client";
 import type { FirecrawlAppConfig } from "./v1";
 
 // Re-export v2 client options for convenience
-export type { FirecrawlClientOptions } from "./v2/client";
+export type { FirecrawlClientOptions, FirecrawlClientInput } from "./v2/client";
 
 /** Unified client: extends v2 and adds `.v1` for backward compatibility. */
 export class Firecrawl extends V2 {
@@ -27,12 +27,14 @@ export class Firecrawl extends V2 {
   private _v1?: V1;
   private _v1Opts: FirecrawlAppConfig;
 
-  /** @param opts API credentials and base URL. */
-  constructor(opts: FirecrawlClientOptions = {}) {
-    super(opts);
+  /** @param opts API key string or credentials object. */
+  constructor(opts: FirecrawlClientInput = {}) {
+    const resolved: FirecrawlClientOptions =
+      typeof opts === "string" ? { apiKey: opts } : opts;
+    super(resolved);
     this._v1Opts = {
-      apiKey: opts.apiKey,
-      apiUrl: opts.apiUrl,
+      apiKey: resolved.apiKey,
+      apiUrl: resolved.apiUrl,
     };
   }
 
@@ -43,5 +45,16 @@ export class Firecrawl extends V2 {
   }
 }
 
+// Copy V2 method descriptors onto Firecrawl.prototype so that
+// Object.getOwnPropertyNames(Object.getPrototypeOf(app)) includes them.
+(function exposeV2MethodsOnTopLevel() {
+  for (const name of Object.getOwnPropertyNames(V2.prototype)) {
+    if (name === "constructor") continue;
+    if (Object.prototype.hasOwnProperty.call(Firecrawl.prototype, name)) continue;
+    const desc = Object.getOwnPropertyDescriptor(V2.prototype, name);
+    if (desc) Object.defineProperty(Firecrawl.prototype, name, desc);
+  }
+})();
+
 export default Firecrawl;
 

package/src/v2/client.ts

@@ -110,6 +110,9 @@ export interface FirecrawlClientOptions {
   backoffFactor?: number;
 }
 
+/** Accepts a plain API key string or a full options object. */
+export type FirecrawlClientInput = FirecrawlClientOptions | string;
+
 /**
  * Firecrawl v2 client. Provides typed access to all v2 endpoints and utilities.
  */
@@ -123,11 +126,14 @@ export class FirecrawlClient {
 
   /**
    * Create a v2 client.
-   * @param options Transport configuration (API key, base URL, timeouts, retries).
+   * @param options API key string or transport configuration object.
    */
-  constructor(options: FirecrawlClientOptions = {}) {
-    const apiKey = options.apiKey ?? process.env.FIRECRAWL_API_KEY ?? "";
-    const apiUrl = (options.apiUrl ?? process.env.FIRECRAWL_API_URL ?? "https://api.firecrawl.dev").replace(/\/$/, "");
+  constructor(options: FirecrawlClientInput = {}) {
+    const opts: FirecrawlClientOptions =
+      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.");
@@ -136,9 +142,9 @@ export class FirecrawlClient {
     this.http = new HttpClient({
       apiKey,
       apiUrl,
-      timeoutMs: options.timeoutMs,
-      maxRetries: options.maxRetries,
-      backoffFactor: options.backoffFactor,
+      timeoutMs: opts.timeoutMs,
+      maxRetries: opts.maxRetries,
+      backoffFactor: opts.backoffFactor,
     });
   }
 
@@ -547,6 +553,56 @@ export class FirecrawlClient {
   watcher(jobId: string, opts: WatcherOptions = {}): Watcher {
     return new Watcher(this.http, jobId, opts);
   }
+
+  /** @deprecated V1 compatibility alias for agent recovery. Prefer scrape(). */
+  async scrapeUrl(url: string, options?: ScrapeOptions): Promise<Document> {
+    return this.scrape(url, options);
+  }
+
+  /** @deprecated V1 compatibility alias for agent recovery. Prefer crawl(). */
+  async crawlUrl(url: string, req: CrawlOptions & { pollInterval?: number; timeout?: number } = {}): Promise<CrawlJob> {
+    return this.crawl(url, req);
+  }
+
+  /** @deprecated V1 compatibility alias for agent recovery. Prefer startCrawl(). */
+  async asyncCrawlUrl(url: string, req: CrawlOptions = {}): Promise<CrawlResponse> {
+    return this.startCrawl(url, req);
+  }
+
+  /** @deprecated V1 compatibility alias for agent recovery. Prefer getCrawlStatus(). */
+  async checkCrawlStatus(jobId: string, pagination?: PaginationConfig): Promise<CrawlJob> {
+    return this.getCrawlStatus(jobId, pagination);
+  }
+
+  /** @deprecated V1 compatibility alias for agent recovery. Prefer getCrawlErrors(). */
+  async checkCrawlErrors(crawlId: string): Promise<CrawlErrorsResponse> {
+    return this.getCrawlErrors(crawlId);
+  }
+
+  /** @deprecated V1 compatibility alias for agent recovery. Prefer map(). */
+  async mapUrl(url: string, options?: MapOptions): Promise<MapData> {
+    return this.map(url, options);
+  }
+
+  /** @deprecated V1 compatibility alias for agent recovery. Prefer batchScrape(). */
+  async batchScrapeUrls(urls: string[], opts?: BatchScrapeOptions & { pollInterval?: number; timeout?: number }): Promise<BatchScrapeJob> {
+    return this.batchScrape(urls, opts);
+  }
+
+  /** @deprecated V1 compatibility alias for agent recovery. Prefer startBatchScrape(). */
+  async asyncBatchScrapeUrls(urls: string[], opts?: BatchScrapeOptions): Promise<BatchScrapeResponse> {
+    return this.startBatchScrape(urls, opts);
+  }
+
+  /** @deprecated V1 compatibility alias for agent recovery. Prefer getBatchScrapeStatus(). */
+  async checkBatchScrapeStatus(jobId: string, pagination?: PaginationConfig): Promise<BatchScrapeJob> {
+    return this.getBatchScrapeStatus(jobId, pagination);
+  }
+
+  /** @deprecated V1 compatibility alias for agent recovery. Prefer getBatchScrapeErrors(). */
+  async checkBatchScrapeErrors(jobId: string): Promise<CrawlErrorsResponse> {
+    return this.getBatchScrapeErrors(jobId);
+  }
 }
 
 export default FirecrawlClient;

package/src/v2/methods/search.ts

@@ -98,6 +98,20 @@ export async function search(
     if (data.news) out.news = transformArray<SearchResultNews>(data.news);
     if (data.images)
       out.images = transformArray<SearchResultImages>(data.images);
+    Object.defineProperty(out, "data", {
+      get() {
+        const parts: string[] = [];
+        if (out.web?.length) parts.push(`.web (${out.web.length} results)`);
+        if (out.news?.length) parts.push(`.news (${out.news.length} results)`);
+        if (out.images?.length) parts.push(`.images (${out.images.length} results)`);
+        const available = parts.length ? parts.join(", ") : ".web, .news, or .images";
+        throw new Error(
+          `SearchData has no '.data'. Results are grouped by source: ${available}`,
+        );
+      },
+      enumerable: false,
+      configurable: true,
+    });
     return out;
   } catch (err: any) {
     if (err?.isAxiosError) return normalizeAxiosError(err, "search");

package/src/v2/types.ts

@@ -695,6 +695,8 @@ export interface CreateMonitorRequest {
   notification?: MonitorNotification;
   targets: MonitorTarget[];
   retentionDays?: number;
+  goal?: string;
+  judgeEnabled?: boolean;
 }
 
 export interface UpdateMonitorRequest {
@@ -705,6 +707,8 @@ export interface UpdateMonitorRequest {
   notification?: MonitorNotification | null;
   targets?: MonitorTarget[];
   retentionDays?: number;
+  goal?: string | null;
+  judgeEnabled?: boolean;
 }
 
 export interface MonitorSummary {
@@ -730,10 +734,19 @@ export interface Monitor {
   retentionDays: number;
   estimatedCreditsPerMonth?: number | null;
   lastCheckSummary?: MonitorSummary | null;
+  goal?: string | null;
+  judgeEnabled?: boolean;
   createdAt: string;
   updatedAt: string;
 }
 
+export interface MonitorPageJudgment {
+  meaningful: boolean;
+  confidence: "high" | "medium" | "low";
+  reason: string;
+  fields: string[];
+}
+
 export interface MonitorCheck {
   id: string;
   monitorId: string;
@@ -807,6 +820,7 @@ export interface MonitorCheckPage {
   metadata?: unknown;
   diff?: MonitorPageDiff | null;
   snapshot?: MonitorPageSnapshot | null;
+  judgment?: MonitorPageJudgment | null;
   createdAt: string;
 }