firecrawl 3.1.0 → 3.2.0

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

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

package/dist/index.cjs

@@ -34,8 +34,8 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 var require_package = __commonJS({
   "package.json"(exports2, module2) {
     module2.exports = {
-      name: "@mendable/firecrawl-js",
-      version: "3.1.0",
+      name: "firecrawl",
+      version: "3.2.0",
       description: "JavaScript SDK for Firecrawl API",
       main: "dist/index.js",
       types: "dist/index.d.ts",
@@ -108,15 +108,15 @@ var require_package = __commonJS({
 });
 
 // src/index.ts
-var index_exports = {};
-__export(index_exports, {
+var src_exports = {};
+__export(src_exports, {
   Firecrawl: () => Firecrawl,
   FirecrawlAppV1: () => FirecrawlApp,
   FirecrawlClient: () => FirecrawlClient,
   SdkError: () => SdkError,
-  default: () => index_default
+  default: () => src_default
 });
-module.exports = __toCommonJS(index_exports);
+module.exports = __toCommonJS(src_exports);
 
 // src/v2/utils/httpClient.ts
 var import_axios = __toESM(require("axios"), 1);
@@ -316,6 +316,7 @@ function prepareSearchPayload(req) {
     query: req.query
   };
   if (req.sources) payload.sources = req.sources;
+  if (req.categories) payload.categories = req.categories;
   if (req.limit != null) payload.limit = req.limit;
   if (req.tbs != null) payload.tbs = req.tbs;
   if (req.location != null) payload.location = req.location;
@@ -2355,7 +2356,7 @@ var Firecrawl = class extends FirecrawlClient {
     return this._v1;
   }
 };
-var index_default = Firecrawl;
+var src_default = Firecrawl;
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   Firecrawl,

package/dist/index.d.cts

@@ -142,6 +142,7 @@ interface SearchResultWeb {
     url: string;
     title?: string;
     description?: string;
+    category?: string;
 }
 interface SearchResultNews {
     title?: string;
@@ -150,6 +151,7 @@ interface SearchResultNews {
     date?: string;
     imageUrl?: string;
     position?: number;
+    category?: string;
 }
 interface SearchResultImages {
     title?: string;
@@ -164,11 +166,15 @@ interface SearchData {
     news?: Array<SearchResultNews | Document>;
     images?: Array<SearchResultImages | Document>;
 }
+interface CategoryOption {
+    type: "github" | "research";
+}
 interface SearchRequest {
     query: string;
     sources?: Array<"web" | "news" | "images" | {
         type: "web" | "news" | "images";
     }>;
+    categories?: Array<"github" | "research" | CategoryOption>;
     limit?: number;
     tbs?: string;
     location?: string;
@@ -1342,4 +1348,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 SearchResultImages, type SearchResultNews, type SearchResultWeb, 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 CategoryOption, 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

@@ -142,6 +142,7 @@ interface SearchResultWeb {
     url: string;
     title?: string;
     description?: string;
+    category?: string;
 }
 interface SearchResultNews {
     title?: string;
@@ -150,6 +151,7 @@ interface SearchResultNews {
     date?: string;
     imageUrl?: string;
     position?: number;
+    category?: string;
 }
 interface SearchResultImages {
     title?: string;
@@ -164,11 +166,15 @@ interface SearchData {
     news?: Array<SearchResultNews | Document>;
     images?: Array<SearchResultImages | Document>;
 }
+interface CategoryOption {
+    type: "github" | "research";
+}
 interface SearchRequest {
     query: string;
     sources?: Array<"web" | "news" | "images" | {
         type: "web" | "news" | "images";
     }>;
+    categories?: Array<"github" | "research" | CategoryOption>;
     limit?: number;
     tbs?: string;
     location?: string;
@@ -1342,4 +1348,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 SearchResultImages, type SearchResultNews, type SearchResultWeb, 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 CategoryOption, 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-WNGXI3ZW.js";
+} from "./chunk-NVTWBXZM.js";
 
 // src/v2/utils/httpClient.ts
 import axios from "axios";
@@ -200,6 +200,7 @@ function prepareSearchPayload(req) {
     query: req.query
   };
   if (req.sources) payload.sources = req.sources;
+  if (req.categories) payload.categories = req.categories;
   if (req.limit != null) payload.limit = req.limit;
   if (req.tbs != null) payload.tbs = req.tbs;
   if (req.location != null) payload.location = req.location;
@@ -932,7 +933,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-KMFB7KZD.js");
+      const packageJson = await import("./package-TM3XCIRK.js");
       return packageJson.default.version;
     } catch (error) {
       const isTest = typeof process !== "undefined" && (process.env.JEST_WORKER_ID != null || false);
@@ -2239,11 +2240,11 @@ var Firecrawl = class extends FirecrawlClient {
     return this._v1;
   }
 };
-var index_default = Firecrawl;
+var src_default = Firecrawl;
 export {
   Firecrawl,
   FirecrawlApp as FirecrawlAppV1,
   FirecrawlClient,
   SdkError,
-  index_default as default
+  src_default as default
 };

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

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

package/package.json

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

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

@@ -9,11 +9,18 @@ describe("v2 utils: validation", () => {
     expect(() => ensureValidFormats(formats)).toThrow(/json format must be an object/i);
   });
 
-  test("ensureValidFormats: json format requires prompt and schema", () => {
-    const bad1: FormatOption[] = [{ type: "json", prompt: "p" } as any];
-    const bad2: FormatOption[] = [{ type: "json", schema: {} } as any];
-    expect(() => ensureValidFormats(bad1)).toThrow(/requires 'prompt' and 'schema'/i);
-    expect(() => ensureValidFormats(bad2)).toThrow(/requires 'prompt' and 'schema'/i);
+  test("ensureValidFormats: json format requires prompt or schema", () => {
+    // Valid cases - should not throw
+    const valid1: FormatOption[] = [{ type: "json", prompt: "p" } as any];
+    const valid2: FormatOption[] = [{ type: "json", schema: {} } as any];
+    const valid3: FormatOption[] = [{ type: "json", prompt: "p", schema: {} } as any];
+    expect(() => ensureValidFormats(valid1)).not.toThrow();
+    expect(() => ensureValidFormats(valid2)).not.toThrow();
+    expect(() => ensureValidFormats(valid3)).not.toThrow();
+
+    // Invalid case - should throw when both are missing
+    const bad: FormatOption[] = [{ type: "json" } as any];
+    expect(() => ensureValidFormats(bad)).toThrow(/requires either 'prompt' or 'schema'/i);
   });
 
   test("ensureValidFormats: converts zod schema to JSON schema", () => {

package/src/v2/methods/search.ts

@@ -11,6 +11,7 @@ function prepareSearchPayload(req: SearchRequest): Record<string, unknown> {
     query: req.query,
   };
   if (req.sources) payload.sources = req.sources;
+  if (req.categories) payload.categories = req.categories;
   if (req.limit != null) payload.limit = req.limit;
   if (req.tbs != null) payload.tbs = req.tbs;
   if (req.location != null) payload.location = req.location;

package/src/v2/types.ts

@@ -177,6 +177,7 @@ export interface SearchResultWeb {
   url: string;
   title?: string;
   description?: string;
+  category?: string;
 }
 
 export interface SearchResultNews {
@@ -186,6 +187,7 @@ export interface SearchResultNews {
   date?: string;
   imageUrl?: string;
   position?: number;
+  category?: string;
 }
 
 export interface SearchResultImages {
@@ -203,9 +205,14 @@ export interface SearchData {
   images?: Array<SearchResultImages | Document>;
 }
 
+export interface CategoryOption {
+  type: "github" | "research";
+}
+
 export interface SearchRequest {
   query: string;
   sources?: Array<"web" | "news" | "images" | { type: "web" | "news" | "images" }>;
+  categories?: Array<"github" | "research" | CategoryOption>;
   limit?: number;
   tbs?: string;
   location?: string;