firecrawl 4.22.1 → 4.22.2

package/dist/{chunk-WTZQ5IMF.js → chunk-HGRZHWZU.js}

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

package/dist/index.cjs

@@ -35,7 +35,7 @@ var require_package = __commonJS({
   "package.json"(exports2, module2) {
     module2.exports = {
       name: "@mendable/firecrawl-js",
-      version: "4.22.1",
+      version: "4.22.2",
       description: "JavaScript SDK for Firecrawl API",
       main: "dist/index.js",
       types: "dist/index.d.ts",
@@ -2986,6 +2986,7 @@ var FirecrawlApp = class {
    * @param onActivity - Optional callback to receive activity updates in real-time.
    * @param onSource - Optional callback to receive source updates in real-time.
    * @returns The final research results.
+   * @deprecated /v1/deep-research is deprecated. Use /v2/search instead.
    */
   async deepResearch(query, params, onActivity, onSource) {
     try {
@@ -3042,6 +3043,7 @@ var FirecrawlApp = class {
    * Initiates a deep research operation on a given query without polling.
    * @param params - Parameters for the deep research operation.
    * @returns The response containing the research job ID.
+   * @deprecated /v1/deep-research is deprecated. Use /v2/search instead.
    */
   async asyncDeepResearch(query, params) {
     const headers = this.prepareHeaders();
@@ -3079,6 +3081,7 @@ var FirecrawlApp = class {
    * Checks the status of a deep research operation.
    * @param id - The ID of the deep research operation.
    * @returns The current status and results of the research operation.
+   * @deprecated /v1/deep-research is deprecated. Use /v2/search instead.
    */
   async checkDeepResearchStatus(id) {
     const headers = this.prepareHeaders();
@@ -3217,6 +3220,7 @@ var FirecrawlApp = class {
    * @param url - The URL to generate LLMs.txt from.
    * @param params - Parameters for the LLMs.txt generation operation.
    * @returns The final generation results.
+   * @deprecated /v1/llmstxt is deprecated and will not be replaced.
    */
   async generateLLMsText(url, params) {
     try {
@@ -3258,6 +3262,7 @@ var FirecrawlApp = class {
    * @param url - The URL to generate LLMs.txt from.
    * @param params - Parameters for the LLMs.txt generation operation.
    * @returns The response containing the generation job ID.
+   * @deprecated /v1/llmstxt is deprecated and will not be replaced.
    */
   async asyncGenerateLLMsText(url, params) {
     const headers = this.prepareHeaders();
@@ -3286,6 +3291,7 @@ var FirecrawlApp = class {
    * Checks the status of a LLMs.txt generation operation.
    * @param id - The ID of the LLMs.txt generation operation.
    * @returns The current status and results of the generation operation.
+   * @deprecated /v1/llmstxt is deprecated and will not be replaced.
    */
   async checkGenerateLLMsTextStatus(id) {
     const headers = this.prepareHeaders();

package/dist/index.d.cts

@@ -621,6 +621,8 @@ interface ExtractResponse$1 {
     data?: unknown;
     error?: string;
     warning?: string;
+    warnings?: string[];
+    replacement?: string;
     sources?: Record<string, unknown>;
     expiresAt?: string;
     creditsUsed?: number;
@@ -1521,6 +1523,8 @@ interface ExtractResponse<LLMSchema extends zt.ZodSchema = any> {
     data: LLMSchema;
     error?: string;
     warning?: string;
+    warnings?: string[];
+    replacement?: string;
     sources?: string[];
     creditsUsed?: number;
 }
@@ -1623,6 +1627,8 @@ interface DeepResearchParams<LLMSchema extends zt.ZodSchema = any> {
 interface DeepResearchResponse {
     success: boolean;
     id: string;
+    warnings?: string[];
+    replacement?: string;
 }
 /**
  * Status response interface for deep research operations.
@@ -1662,6 +1668,8 @@ interface DeepResearchStatusResponse {
         description: string;
     }>;
     summaries: string[];
+    warnings?: string[];
+    replacement?: string;
 }
 /**
  * Parameters for LLMs.txt generation operations.
@@ -1693,6 +1701,8 @@ interface GenerateLLMsTextParams {
 interface GenerateLLMsTextResponse {
     success: boolean;
     id: string;
+    warnings?: string[];
+    replacement?: string;
 }
 /**
  * Status response interface for LLMs.txt generation operations.
@@ -1706,6 +1716,8 @@ interface GenerateLLMsTextStatusResponse {
     status: "processing" | "completed" | "failed";
     error?: string;
     expiresAt: string;
+    warnings?: string[];
+    replacement?: string;
 }
 /**
  * Response interface for queue status operations.
@@ -1955,6 +1967,7 @@ declare class FirecrawlApp {
      * @param onActivity - Optional callback to receive activity updates in real-time.
      * @param onSource - Optional callback to receive source updates in real-time.
      * @returns The final research results.
+     * @deprecated /v1/deep-research is deprecated. Use /v2/search instead.
      */
     deepResearch(query: string, params: DeepResearchParams<zt.ZodSchema>, onActivity?: (activity: {
         type: string;
@@ -1972,12 +1985,14 @@ declare class FirecrawlApp {
      * Initiates a deep research operation on a given query without polling.
      * @param params - Parameters for the deep research operation.
      * @returns The response containing the research job ID.
+     * @deprecated /v1/deep-research is deprecated. Use /v2/search instead.
      */
     asyncDeepResearch(query: string, params: DeepResearchParams<zt.ZodSchema>): Promise<DeepResearchResponse | ErrorResponse>;
     /**
      * Checks the status of a deep research operation.
      * @param id - The ID of the deep research operation.
      * @returns The current status and results of the research operation.
+     * @deprecated /v1/deep-research is deprecated. Use /v2/search instead.
      */
     checkDeepResearchStatus(id: string): Promise<DeepResearchStatusResponse | ErrorResponse>;
     /**
@@ -2014,6 +2029,7 @@ declare class FirecrawlApp {
      * @param url - The URL to generate LLMs.txt from.
      * @param params - Parameters for the LLMs.txt generation operation.
      * @returns The final generation results.
+     * @deprecated /v1/llmstxt is deprecated and will not be replaced.
      */
     generateLLMsText(url: string, params?: GenerateLLMsTextParams): Promise<GenerateLLMsTextStatusResponse | ErrorResponse>;
     /**
@@ -2021,12 +2037,14 @@ declare class FirecrawlApp {
      * @param url - The URL to generate LLMs.txt from.
      * @param params - Parameters for the LLMs.txt generation operation.
      * @returns The response containing the generation job ID.
+     * @deprecated /v1/llmstxt is deprecated and will not be replaced.
      */
     asyncGenerateLLMsText(url: string, params?: GenerateLLMsTextParams): Promise<GenerateLLMsTextResponse | ErrorResponse>;
     /**
      * Checks the status of a LLMs.txt generation operation.
      * @param id - The ID of the LLMs.txt generation operation.
      * @returns The current status and results of the generation operation.
+     * @deprecated /v1/llmstxt is deprecated and will not be replaced.
      */
     checkGenerateLLMsTextStatus(id: string): Promise<GenerateLLMsTextStatusResponse | ErrorResponse>;
     /**

package/dist/index.d.ts

@@ -621,6 +621,8 @@ interface ExtractResponse$1 {
     data?: unknown;
     error?: string;
     warning?: string;
+    warnings?: string[];
+    replacement?: string;
     sources?: Record<string, unknown>;
     expiresAt?: string;
     creditsUsed?: number;
@@ -1521,6 +1523,8 @@ interface ExtractResponse<LLMSchema extends zt.ZodSchema = any> {
     data: LLMSchema;
     error?: string;
     warning?: string;
+    warnings?: string[];
+    replacement?: string;
     sources?: string[];
     creditsUsed?: number;
 }
@@ -1623,6 +1627,8 @@ interface DeepResearchParams<LLMSchema extends zt.ZodSchema = any> {
 interface DeepResearchResponse {
     success: boolean;
     id: string;
+    warnings?: string[];
+    replacement?: string;
 }
 /**
  * Status response interface for deep research operations.
@@ -1662,6 +1668,8 @@ interface DeepResearchStatusResponse {
         description: string;
     }>;
     summaries: string[];
+    warnings?: string[];
+    replacement?: string;
 }
 /**
  * Parameters for LLMs.txt generation operations.
@@ -1693,6 +1701,8 @@ interface GenerateLLMsTextParams {
 interface GenerateLLMsTextResponse {
     success: boolean;
     id: string;
+    warnings?: string[];
+    replacement?: string;
 }
 /**
  * Status response interface for LLMs.txt generation operations.
@@ -1706,6 +1716,8 @@ interface GenerateLLMsTextStatusResponse {
     status: "processing" | "completed" | "failed";
     error?: string;
     expiresAt: string;
+    warnings?: string[];
+    replacement?: string;
 }
 /**
  * Response interface for queue status operations.
@@ -1955,6 +1967,7 @@ declare class FirecrawlApp {
      * @param onActivity - Optional callback to receive activity updates in real-time.
      * @param onSource - Optional callback to receive source updates in real-time.
      * @returns The final research results.
+     * @deprecated /v1/deep-research is deprecated. Use /v2/search instead.
      */
     deepResearch(query: string, params: DeepResearchParams<zt.ZodSchema>, onActivity?: (activity: {
         type: string;
@@ -1972,12 +1985,14 @@ declare class FirecrawlApp {
      * Initiates a deep research operation on a given query without polling.
      * @param params - Parameters for the deep research operation.
      * @returns The response containing the research job ID.
+     * @deprecated /v1/deep-research is deprecated. Use /v2/search instead.
      */
     asyncDeepResearch(query: string, params: DeepResearchParams<zt.ZodSchema>): Promise<DeepResearchResponse | ErrorResponse>;
     /**
      * Checks the status of a deep research operation.
      * @param id - The ID of the deep research operation.
      * @returns The current status and results of the research operation.
+     * @deprecated /v1/deep-research is deprecated. Use /v2/search instead.
      */
     checkDeepResearchStatus(id: string): Promise<DeepResearchStatusResponse | ErrorResponse>;
     /**
@@ -2014,6 +2029,7 @@ declare class FirecrawlApp {
      * @param url - The URL to generate LLMs.txt from.
      * @param params - Parameters for the LLMs.txt generation operation.
      * @returns The final generation results.
+     * @deprecated /v1/llmstxt is deprecated and will not be replaced.
      */
     generateLLMsText(url: string, params?: GenerateLLMsTextParams): Promise<GenerateLLMsTextStatusResponse | ErrorResponse>;
     /**
@@ -2021,12 +2037,14 @@ declare class FirecrawlApp {
      * @param url - The URL to generate LLMs.txt from.
      * @param params - Parameters for the LLMs.txt generation operation.
      * @returns The response containing the generation job ID.
+     * @deprecated /v1/llmstxt is deprecated and will not be replaced.
      */
     asyncGenerateLLMsText(url: string, params?: GenerateLLMsTextParams): Promise<GenerateLLMsTextResponse | ErrorResponse>;
     /**
      * Checks the status of a LLMs.txt generation operation.
      * @param id - The ID of the LLMs.txt generation operation.
      * @returns The current status and results of the generation operation.
+     * @deprecated /v1/llmstxt is deprecated and will not be replaced.
      */
     checkGenerateLLMsTextStatus(id: string): Promise<GenerateLLMsTextStatusResponse | ErrorResponse>;
     /**

package/dist/index.js

@@ -1,6 +1,6 @@
 import {
   require_package
-} from "./chunk-WTZQ5IMF.js";
+} from "./chunk-HGRZHWZU.js";
 
 // src/v2/utils/httpClient.ts
 import axios from "axios";
@@ -2036,7 +2036,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-YDTOLYXI.js");
+      const packageJson = await import("./package-WSP46L7M.js");
       return packageJson.default.version;
     } catch (error) {
       const isTest = typeof process !== "undefined" && (process.env.JEST_WORKER_ID != null || false);
@@ -2862,6 +2862,7 @@ var FirecrawlApp = class {
    * @param onActivity - Optional callback to receive activity updates in real-time.
    * @param onSource - Optional callback to receive source updates in real-time.
    * @returns The final research results.
+   * @deprecated /v1/deep-research is deprecated. Use /v2/search instead.
    */
   async deepResearch(query, params, onActivity, onSource) {
     try {
@@ -2918,6 +2919,7 @@ var FirecrawlApp = class {
    * Initiates a deep research operation on a given query without polling.
    * @param params - Parameters for the deep research operation.
    * @returns The response containing the research job ID.
+   * @deprecated /v1/deep-research is deprecated. Use /v2/search instead.
    */
   async asyncDeepResearch(query, params) {
     const headers = this.prepareHeaders();
@@ -2955,6 +2957,7 @@ var FirecrawlApp = class {
    * Checks the status of a deep research operation.
    * @param id - The ID of the deep research operation.
    * @returns The current status and results of the research operation.
+   * @deprecated /v1/deep-research is deprecated. Use /v2/search instead.
    */
   async checkDeepResearchStatus(id) {
     const headers = this.prepareHeaders();
@@ -3093,6 +3096,7 @@ var FirecrawlApp = class {
    * @param url - The URL to generate LLMs.txt from.
    * @param params - Parameters for the LLMs.txt generation operation.
    * @returns The final generation results.
+   * @deprecated /v1/llmstxt is deprecated and will not be replaced.
    */
   async generateLLMsText(url, params) {
     try {
@@ -3134,6 +3138,7 @@ var FirecrawlApp = class {
    * @param url - The URL to generate LLMs.txt from.
    * @param params - Parameters for the LLMs.txt generation operation.
    * @returns The response containing the generation job ID.
+   * @deprecated /v1/llmstxt is deprecated and will not be replaced.
    */
   async asyncGenerateLLMsText(url, params) {
     const headers = this.prepareHeaders();
@@ -3162,6 +3167,7 @@ var FirecrawlApp = class {
    * Checks the status of a LLMs.txt generation operation.
    * @param id - The ID of the LLMs.txt generation operation.
    * @returns The current status and results of the generation operation.
+   * @deprecated /v1/llmstxt is deprecated and will not be replaced.
    */
   async checkGenerateLLMsTextStatus(id) {
     const headers = this.prepareHeaders();

package/dist/{package-YDTOLYXI.js → package-WSP46L7M.js}

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

package/package.json

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

package/src/v1/index.ts

@@ -363,6 +363,8 @@ export interface ExtractResponse<LLMSchema extends zt.ZodSchema = any> {
   data: LLMSchema;
   error?: string;
   warning?: string;
+  warnings?: string[];
+  replacement?: string;
   sources?: string[];
   creditsUsed?: number;
 }
@@ -490,6 +492,8 @@ export interface DeepResearchParams<LLMSchema extends zt.ZodSchema = any>  {
 export interface DeepResearchResponse {
   success: boolean;
   id: string;
+  warnings?: string[];
+  replacement?: string;
 }
 
 /**
@@ -530,6 +534,8 @@ export interface DeepResearchStatusResponse {
     description: string;
   }>;
   summaries: string[];
+  warnings?: string[];
+  replacement?: string;
 }
 
 /**
@@ -563,6 +569,8 @@ export interface GenerateLLMsTextParams {
 export interface GenerateLLMsTextResponse {
   success: boolean;
   id: string;
+  warnings?: string[];
+  replacement?: string;
 }
 
 /**
@@ -577,6 +585,8 @@ export interface GenerateLLMsTextStatusResponse {
   status: "processing" | "completed" | "failed";
   error?: string;
   expiresAt: string;
+  warnings?: string[];
+  replacement?: string;
 }
 
 /**
@@ -1626,6 +1636,7 @@ export default class FirecrawlApp {
    * @param onActivity - Optional callback to receive activity updates in real-time.
    * @param onSource - Optional callback to receive source updates in real-time.
    * @returns The final research results.
+   * @deprecated /v1/deep-research is deprecated. Use /v2/search instead.
    */
   async deepResearch(
     query: string, 
@@ -1713,6 +1724,7 @@ export default class FirecrawlApp {
    * Initiates a deep research operation on a given query without polling.
    * @param params - Parameters for the deep research operation.
    * @returns The response containing the research job ID.
+   * @deprecated /v1/deep-research is deprecated. Use /v2/search instead.
    */
   async asyncDeepResearch(query: string, params: DeepResearchParams<zt.ZodSchema>): Promise<DeepResearchResponse | ErrorResponse> {
     const headers = this.prepareHeaders();
@@ -1754,6 +1766,7 @@ export default class FirecrawlApp {
    * Checks the status of a deep research operation.
    * @param id - The ID of the deep research operation.
    * @returns The current status and results of the research operation.
+   * @deprecated /v1/deep-research is deprecated. Use /v2/search instead.
    */
   async checkDeepResearchStatus(id: string): Promise<DeepResearchStatusResponse | ErrorResponse> {
     const headers = this.prepareHeaders();
@@ -1921,6 +1934,7 @@ export default class FirecrawlApp {
    * @param url - The URL to generate LLMs.txt from.
    * @param params - Parameters for the LLMs.txt generation operation.
    * @returns The final generation results.
+   * @deprecated /v1/llmstxt is deprecated and will not be replaced.
    */
   async generateLLMsText(url: string, params?: GenerateLLMsTextParams): Promise<GenerateLLMsTextStatusResponse | ErrorResponse> {
     try {
@@ -1973,6 +1987,7 @@ export default class FirecrawlApp {
    * @param url - The URL to generate LLMs.txt from.
    * @param params - Parameters for the LLMs.txt generation operation.
    * @returns The response containing the generation job ID.
+   * @deprecated /v1/llmstxt is deprecated and will not be replaced.
    */
   async asyncGenerateLLMsText(url: string, params?: GenerateLLMsTextParams): Promise<GenerateLLMsTextResponse | ErrorResponse> {
     const headers = this.prepareHeaders();
@@ -2003,6 +2018,7 @@ export default class FirecrawlApp {
    * Checks the status of a LLMs.txt generation operation.
    * @param id - The ID of the LLMs.txt generation operation.
    * @returns The current status and results of the generation operation.
+   * @deprecated /v1/llmstxt is deprecated and will not be replaced.
    */
   async checkGenerateLLMsTextStatus(id: string): Promise<GenerateLLMsTextStatusResponse | ErrorResponse> {
     const headers = this.prepareHeaders();

package/src/v2/types.ts

@@ -777,6 +777,8 @@ export interface ExtractResponse {
   data?: unknown;
   error?: string;
   warning?: string;
+  warnings?: string[];
+  replacement?: string;
   sources?: Record<string, unknown>;
   expiresAt?: string;
   creditsUsed?: number;