firecrawl 3.0.3 → 3.1.0

package/dist/{chunk-OIZ6OKY4.js → chunk-WNGXI3ZW.js}

@@ -8,7 +8,7 @@ var require_package = __commonJS({
   "package.json"(exports, module) {
     module.exports = {
       name: "@mendable/firecrawl-js",
-      version: "3.0.3",
+      version: "3.1.0",
       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: "3.0.3",
+      version: "3.1.0",
       description: "JavaScript SDK for Firecrawl API",
       main: "dist/index.js",
       types: "dist/index.d.ts",
@@ -327,6 +327,21 @@ function prepareSearchPayload(req) {
   }
   return payload;
 }
+function transformArray(arr) {
+  const results = [];
+  for (const item of arr) {
+    if (item && typeof item === "object") {
+      if ("markdown" in item || "html" in item || "rawHtml" in item || "links" in item || "screenshot" in item || "changeTracking" in item || "summary" in item || "json" in item) {
+        results.push(item);
+      } else {
+        results.push(item);
+      }
+    } else {
+      results.push({ url: item });
+    }
+  }
+  return results;
+}
 async function search(http, request) {
   const payload = prepareSearchPayload(request);
   try {
@@ -336,24 +351,9 @@ async function search(http, request) {
     }
     const data = res.data.data || {};
     const out = {};
-    for (const key of Object.keys(data)) {
-      const arr = data[key];
-      if (Array.isArray(arr)) {
-        const results = [];
-        for (const item of arr) {
-          if (item && typeof item === "object") {
-            if ("markdown" in item || "html" in item || "rawHtml" in item || "links" in item || "screenshot" in item || "changeTracking" in item || "summary" in item || "json" in item) {
-              results.push(item);
-            } else {
-              results.push({ url: item.url, title: item.title, description: item.description });
-            }
-          } else if (typeof item === "string") {
-            results.push({ url: item });
-          }
-        }
-        out[key] = results;
-      }
-    }
+    if (data.web) out.web = transformArray(data.web);
+    if (data.news) out.news = transformArray(data.news);
+    if (data.images) out.images = transformArray(data.images);
     return out;
   } catch (err) {
     if (err?.isAxiosError) return normalizeAxiosError(err, "search");

package/dist/index.d.cts

@@ -138,15 +138,31 @@ interface Document {
     warning?: string;
     changeTracking?: Record<string, unknown>;
 }
-interface SearchResult {
+interface SearchResultWeb {
     url: string;
     title?: string;
     description?: string;
 }
+interface SearchResultNews {
+    title?: string;
+    url?: string;
+    snippet?: string;
+    date?: string;
+    imageUrl?: string;
+    position?: number;
+}
+interface SearchResultImages {
+    title?: string;
+    imageUrl?: string;
+    imageWidth?: number;
+    imageHeight?: number;
+    url?: string;
+    position?: number;
+}
 interface SearchData {
-    web?: Array<SearchResult | Document>;
-    news?: Array<SearchResult | Document>;
-    images?: Array<SearchResult | Document>;
+    web?: Array<SearchResultWeb | Document>;
+    news?: Array<SearchResultNews | Document>;
+    images?: Array<SearchResultImages | Document>;
 }
 interface SearchRequest {
     query: string;
@@ -215,7 +231,7 @@ interface BatchScrapeJob {
     data: Document[];
 }
 interface MapData {
-    links: SearchResult[];
+    links: SearchResultWeb[];
 }
 interface MapOptions {
     search?: string;
@@ -1326,4 +1342,4 @@ declare class Firecrawl extends FirecrawlClient {
     get v1(): FirecrawlApp;
 }
 
-export { type ActionOption, type ActiveCrawl, type ActiveCrawlsResponse, type BatchScrapeJob, type BatchScrapeOptions, type BatchScrapeResponse$1 as BatchScrapeResponse, type ChangeTrackingFormat, type ClickAction, type ConcurrencyCheck, type CrawlErrorsResponse$1 as CrawlErrorsResponse, type CrawlJob, type CrawlOptions, type CrawlResponse$1 as CrawlResponse, type CreditUsage, type Document, type DocumentMetadata, type ErrorDetails, type ExecuteJavascriptAction, type ExtractResponse$1 as ExtractResponse, Firecrawl, FirecrawlApp as FirecrawlAppV1, FirecrawlClient, type Format, type FormatOption, type FormatString, type JsonFormat, type LocationConfig, type MapData, type MapOptions, type PDFAction, type PressAction, type ScrapeAction, type ScrapeOptions, type ScreenshotAction, type ScreenshotFormat, type ScrollAction, SdkError, type SearchData, type SearchRequest, type SearchResult, type TokenUsage, type Viewport, type WaitAction, type WebhookConfig, type WriteAction, Firecrawl as default };
+export { type ActionOption, type ActiveCrawl, type ActiveCrawlsResponse, type BatchScrapeJob, type BatchScrapeOptions, type BatchScrapeResponse$1 as BatchScrapeResponse, type ChangeTrackingFormat, type ClickAction, type ConcurrencyCheck, type CrawlErrorsResponse$1 as CrawlErrorsResponse, type CrawlJob, type CrawlOptions, type CrawlResponse$1 as CrawlResponse, type CreditUsage, type Document, type DocumentMetadata, type ErrorDetails, type ExecuteJavascriptAction, type ExtractResponse$1 as ExtractResponse, Firecrawl, FirecrawlApp as FirecrawlAppV1, FirecrawlClient, type Format, type FormatOption, type FormatString, type JsonFormat, type LocationConfig, type MapData, type MapOptions, type PDFAction, type PressAction, type ScrapeAction, type ScrapeOptions, type ScreenshotAction, type ScreenshotFormat, type ScrollAction, SdkError, type SearchData, type SearchRequest, type SearchResultImages, type SearchResultNews, type SearchResultWeb, type TokenUsage, type Viewport, type WaitAction, type WebhookConfig, type WriteAction, Firecrawl as default };

package/dist/index.d.ts

@@ -138,15 +138,31 @@ interface Document {
     warning?: string;
     changeTracking?: Record<string, unknown>;
 }
-interface SearchResult {
+interface SearchResultWeb {
     url: string;
     title?: string;
     description?: string;
 }
+interface SearchResultNews {
+    title?: string;
+    url?: string;
+    snippet?: string;
+    date?: string;
+    imageUrl?: string;
+    position?: number;
+}
+interface SearchResultImages {
+    title?: string;
+    imageUrl?: string;
+    imageWidth?: number;
+    imageHeight?: number;
+    url?: string;
+    position?: number;
+}
 interface SearchData {
-    web?: Array<SearchResult | Document>;
-    news?: Array<SearchResult | Document>;
-    images?: Array<SearchResult | Document>;
+    web?: Array<SearchResultWeb | Document>;
+    news?: Array<SearchResultNews | Document>;
+    images?: Array<SearchResultImages | Document>;
 }
 interface SearchRequest {
     query: string;
@@ -215,7 +231,7 @@ interface BatchScrapeJob {
     data: Document[];
 }
 interface MapData {
-    links: SearchResult[];
+    links: SearchResultWeb[];
 }
 interface MapOptions {
     search?: string;
@@ -1326,4 +1342,4 @@ declare class Firecrawl extends FirecrawlClient {
     get v1(): FirecrawlApp;
 }
 
-export { type ActionOption, type ActiveCrawl, type ActiveCrawlsResponse, type BatchScrapeJob, type BatchScrapeOptions, type BatchScrapeResponse$1 as BatchScrapeResponse, type ChangeTrackingFormat, type ClickAction, type ConcurrencyCheck, type CrawlErrorsResponse$1 as CrawlErrorsResponse, type CrawlJob, type CrawlOptions, type CrawlResponse$1 as CrawlResponse, type CreditUsage, type Document, type DocumentMetadata, type ErrorDetails, type ExecuteJavascriptAction, type ExtractResponse$1 as ExtractResponse, Firecrawl, FirecrawlApp as FirecrawlAppV1, FirecrawlClient, type Format, type FormatOption, type FormatString, type JsonFormat, type LocationConfig, type MapData, type MapOptions, type PDFAction, type PressAction, type ScrapeAction, type ScrapeOptions, type ScreenshotAction, type ScreenshotFormat, type ScrollAction, SdkError, type SearchData, type SearchRequest, type SearchResult, type TokenUsage, type Viewport, type WaitAction, type WebhookConfig, type WriteAction, Firecrawl as default };
+export { type ActionOption, type ActiveCrawl, type ActiveCrawlsResponse, type BatchScrapeJob, type BatchScrapeOptions, type BatchScrapeResponse$1 as BatchScrapeResponse, type ChangeTrackingFormat, type ClickAction, type ConcurrencyCheck, type CrawlErrorsResponse$1 as CrawlErrorsResponse, type CrawlJob, type CrawlOptions, type CrawlResponse$1 as CrawlResponse, type CreditUsage, type Document, type DocumentMetadata, type ErrorDetails, type ExecuteJavascriptAction, type ExtractResponse$1 as ExtractResponse, Firecrawl, FirecrawlApp as FirecrawlAppV1, FirecrawlClient, type Format, type FormatOption, type FormatString, type JsonFormat, type LocationConfig, type MapData, type MapOptions, type PDFAction, type PressAction, type ScrapeAction, type ScrapeOptions, type ScreenshotAction, type ScreenshotFormat, type ScrollAction, SdkError, type SearchData, type SearchRequest, type SearchResultImages, type SearchResultNews, type SearchResultWeb, type TokenUsage, type Viewport, type WaitAction, type WebhookConfig, type WriteAction, Firecrawl as default };

package/dist/index.js

@@ -1,6 +1,6 @@
 import {
   require_package
-} from "./chunk-OIZ6OKY4.js";
+} from "./chunk-WNGXI3ZW.js";
 
 // src/v2/utils/httpClient.ts
 import axios from "axios";
@@ -211,6 +211,21 @@ function prepareSearchPayload(req) {
   }
   return payload;
 }
+function transformArray(arr) {
+  const results = [];
+  for (const item of arr) {
+    if (item && typeof item === "object") {
+      if ("markdown" in item || "html" in item || "rawHtml" in item || "links" in item || "screenshot" in item || "changeTracking" in item || "summary" in item || "json" in item) {
+        results.push(item);
+      } else {
+        results.push(item);
+      }
+    } else {
+      results.push({ url: item });
+    }
+  }
+  return results;
+}
 async function search(http, request) {
   const payload = prepareSearchPayload(request);
   try {
@@ -220,24 +235,9 @@ async function search(http, request) {
     }
     const data = res.data.data || {};
     const out = {};
-    for (const key of Object.keys(data)) {
-      const arr = data[key];
-      if (Array.isArray(arr)) {
-        const results = [];
-        for (const item of arr) {
-          if (item && typeof item === "object") {
-            if ("markdown" in item || "html" in item || "rawHtml" in item || "links" in item || "screenshot" in item || "changeTracking" in item || "summary" in item || "json" in item) {
-              results.push(item);
-            } else {
-              results.push({ url: item.url, title: item.title, description: item.description });
-            }
-          } else if (typeof item === "string") {
-            results.push({ url: item });
-          }
-        }
-        out[key] = results;
-      }
-    }
+    if (data.web) out.web = transformArray(data.web);
+    if (data.news) out.news = transformArray(data.news);
+    if (data.images) out.images = transformArray(data.images);
     return out;
   } catch (err) {
     if (err?.isAxiosError) return normalizeAxiosError(err, "search");
@@ -932,7 +932,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-V5IPFKBE.js");
+      const packageJson = await import("./package-KMFB7KZD.js");
       return packageJson.default.version;
     } catch (error) {
       const isTest = typeof process !== "undefined" && (process.env.JEST_WORKER_ID != null || false);

package/dist/{package-V5IPFKBE.js → package-KMFB7KZD.js}

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

package/package.json

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

package/src/v2/methods/search.ts

@@ -1,4 +1,4 @@
-import { type Document, type SearchData, type SearchRequest, type SearchResult, type ScrapeOptions } from "../types";
+import { type Document, type SearchData, type SearchRequest, type SearchResultWeb, type ScrapeOptions, type SearchResultNews, type SearchResultImages } from "../types";
 import { HttpClient } from "../utils/httpClient";
 import { ensureValidScrapeOptions } from "../utils/validation";
 import { throwForBadResponse, normalizeAxiosError } from "../utils/errorHandler";
@@ -23,6 +23,31 @@ function prepareSearchPayload(req: SearchRequest): Record<string, unknown> {
   return payload;
 }
 
+function transformArray<ResultType>(arr: any[]): Array<ResultType | Document> {
+  const results: Array<ResultType | Document> = [] as any;
+  for (const item of arr) {
+    if (item && typeof item === "object") {
+      if (
+        "markdown" in item ||
+        "html" in item ||
+        "rawHtml" in item ||
+        "links" in item ||
+        "screenshot" in item ||
+        "changeTracking" in item ||
+        "summary" in item ||
+        "json" in item
+      ) {
+        results.push(item as Document);
+      } else {
+        results.push(item as ResultType);
+      }
+    } else {
+      results.push({ url: item } as ResultType);
+    }
+  }
+  return results;
+}
+
 export async function search(http: HttpClient, request: SearchRequest): Promise<SearchData> {
   const payload = prepareSearchPayload(request);
   try {
@@ -32,34 +57,9 @@ export async function search(http: HttpClient, request: SearchRequest): Promise<
     }
     const data = (res.data.data || {}) as Record<string, any>;
     const out: SearchData = {};
-    for (const key of Object.keys(data)) {
-      const arr = data[key];
-      if (Array.isArray(arr)) {
-        const results: Array<SearchResult | Document> = [] as any;
-        for (const item of arr) {
-          if (item && typeof item === "object") {
-            // If scraped page fields present, treat as Document; otherwise SearchResult
-            if (
-              "markdown" in item ||
-              "html" in item ||
-              "rawHtml" in item ||
-              "links" in item ||
-              "screenshot" in item ||
-              "changeTracking" in item ||
-              "summary" in item ||
-              "json" in item
-            ) {
-              results.push(item as Document);
-            } else {
-              results.push({ url: item.url, title: item.title, description: item.description } as SearchResult);
-            }
-          } else if (typeof item === "string") {
-            results.push({ url: item } as SearchResult);
-          }
-        }
-        (out as any)[key] = results;
-      }
-    }
+    if (data.web) out.web = transformArray<SearchResultWeb>(data.web);
+    if (data.news) out.news = transformArray<SearchResultNews>(data.news);
+    if (data.images) out.images = transformArray<SearchResultImages>(data.images);
     return out;
   } catch (err: any) {
     if (err?.isAxiosError) return normalizeAxiosError(err, "search");

package/src/v2/types.ts

@@ -173,16 +173,34 @@ export interface Document {
   changeTracking?: Record<string, unknown>;
 }
 
-export interface SearchResult {
+export interface SearchResultWeb {
   url: string;
   title?: string;
   description?: string;
 }
 
+export interface SearchResultNews {
+  title?: string;
+  url?: string;
+  snippet?: string;
+  date?: string;
+  imageUrl?: string;
+  position?: number;
+}
+
+export interface SearchResultImages {
+  title?: string;
+  imageUrl?: string;
+  imageWidth?: number;
+  imageHeight?: number;
+  url?: string;
+  position?: number;
+}
+
 export interface SearchData {
-  web?: Array<SearchResult | Document>;
-  news?: Array<SearchResult | Document>;
-  images?: Array<SearchResult | Document>;
+  web?: Array<SearchResultWeb | Document>;
+  news?: Array<SearchResultNews | Document>;
+  images?: Array<SearchResultImages | Document>;
 }
 
 export interface SearchRequest {
@@ -257,7 +275,7 @@ export interface BatchScrapeJob {
 }
 
 export interface MapData {
-  links: SearchResult[];
+  links: SearchResultWeb[];
 }
 
 export interface MapOptions {