extend-ai 1.14.0 → 1.15.0

package/BaseClient.js

@@ -44,8 +44,8 @@ function normalizeClientOptions(options) {
     const headers = (0, headers_1.mergeHeaders)({
         "X-Fern-Language": "JavaScript",
         "X-Fern-SDK-Name": "extend-ai",
-        "X-Fern-SDK-Version": "1.14.0",
-        "User-Agent": "extend-ai/1.14.0",
+        "X-Fern-SDK-Version": "1.15.0",
+        "User-Agent": "extend-ai/1.15.0",
         "X-Fern-Runtime": core.RUNTIME.type,
         "X-Fern-Runtime-Version": core.RUNTIME.version,
         "x-extend-api-version": (_a = options === null || options === void 0 ? void 0 : options.extendApiVersion) !== null && _a !== void 0 ? _a : "2026-02-09",

package/Client.d.ts

@@ -165,6 +165,8 @@ export declare class ExtendClient {
      *
      * The Extract endpoint allows you to extract structured data from files using an existing extractor, an inline configuration, or no configuration at all. When neither is provided, Extend automatically infers a schema from the document before extraction — no extractor or schema is required.
      *
+     * Pass `file` for a single document, or `package` to extract from multiple files in a single run. Exactly one of `file` or `package` must be provided.
+     *
      * For more details, see the [Extract File guide](https://docs.extend.ai/2026-02-09/extraction/overview).
      *
      * @param {Extend.ExtractRequest} request
@@ -224,7 +226,7 @@ export declare class ExtendClient {
      *         }
      *     })
      */
-    extract(request: Extend.ExtractRequest, requestOptions?: ExtendClient.RequestOptions): core.HttpResponsePromise<Extend.ExtractRun>;
+    extract(request?: Extend.ExtractRequest, requestOptions?: ExtendClient.RequestOptions): core.HttpResponsePromise<Extend.ExtractRun>;
     private __extract;
     /**
      * Classify a document synchronously, waiting for the result before returning. This endpoint has a **5-minute timeout** — if processing takes longer, the request will fail.

package/Client.js

@@ -386,6 +386,8 @@ class ExtendClient {
      *
      * The Extract endpoint allows you to extract structured data from files using an existing extractor, an inline configuration, or no configuration at all. When neither is provided, Extend automatically infers a schema from the document before extraction — no extractor or schema is required.
      *
+     * Pass `file` for a single document, or `package` to extract from multiple files in a single run. Exactly one of `file` or `package` must be provided.
+     *
      * For more details, see the [Extract File guide](https://docs.extend.ai/2026-02-09/extraction/overview).
      *
      * @param {Extend.ExtractRequest} request
@@ -445,11 +447,11 @@ class ExtendClient {
      *         }
      *     })
      */
-    extract(request, requestOptions) {
+    extract(request = {}, requestOptions) {
         return core.HttpResponsePromise.fromPromise(this.__extract(request, requestOptions));
     }
-    __extract(request, requestOptions) {
-        return __awaiter(this, void 0, void 0, function* () {
+    __extract() {
+        return __awaiter(this, arguments, void 0, function* (request = {}, requestOptions) {
             var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k, _l;
             const _authRequest = yield this._options.authProvider.getAuthRequest();
             const _headers = (0, headers_1.mergeHeaders)(_authRequest.headers, (_a = this._options) === null || _a === void 0 ? void 0 : _a.headers, (0, headers_1.mergeOnlyDefinedHeaders)({ "x-extend-api-version": (_b = requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.extendApiVersion) !== null && _b !== void 0 ? _b : "2026-02-09" }), requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.headers);

package/api/client/requests/ExtractRequest.d.ts

@@ -50,7 +50,17 @@ export interface ExtractRequest {
     extractor?: Extend.ExtractRequestExtractor;
     /** Inline extract configuration. Mutually exclusive with `extractor` — provide one or the other, or omit both to have Extend infer a schema from the document. */
     config?: Extend.ExtractConfigJson;
-    /** The file to be extracted from. Files can be provided as a URL, Extend file ID, or raw text. */
-    file: Extend.ExtractRequestFile;
+    /**
+     * The file to be extracted from. Mutually exclusive with `package` — provide one or the other.
+     *
+     * Files can be provided as a URL, Extend file ID, or raw text.
+     */
+    file?: Extend.ExtractRequestFile;
+    /**
+     * A collection of files to extract from together in a single run. Mutually exclusive with `file` — provide one or the other.
+     *
+     * See [Multifile Extraction](https://docs.extend.ai/2026-02-09/extraction/multifile) for details.
+     */
+    package?: Extend.MultiFileRunPackage;
     metadata?: Extend.RunMetadata;
 }

package/api/resources/extractRuns/client/Client.d.ts

@@ -60,8 +60,22 @@ export declare class ExtractRunsClient {
      *             url: "https://example.com/invoice.pdf"
      *         }
      *     })
+     *
+     * @example
+     *     await client.extractRuns.create({
+     *         extractor: {
+     *             id: "ex_1234567890"
+     *         },
+     *         "package": {
+     *             files: [{
+     *                     url: "https://example.com/invoice1.pdf"
+     *                 }, {
+     *                     url: "https://example.com/invoice2.pdf"
+     *                 }]
+     *         }
+     *     })
      */
-    create(request: Extend.ExtractRunsCreateRequest, requestOptions?: ExtractRunsClient.RequestOptions): core.HttpResponsePromise<Extend.ExtractRun>;
+    create(request?: Extend.ExtractRunsCreateRequest, requestOptions?: ExtractRunsClient.RequestOptions): core.HttpResponsePromise<Extend.ExtractRun>;
     private __create;
     /**
      * Retrieve details about a specific extract run, including its status, outputs, and any edits made during review.

package/api/resources/extractRuns/client/Client.js

@@ -170,12 +170,26 @@ class ExtractRunsClient {
      *             url: "https://example.com/invoice.pdf"
      *         }
      *     })
+     *
+     * @example
+     *     await client.extractRuns.create({
+     *         extractor: {
+     *             id: "ex_1234567890"
+     *         },
+     *         "package": {
+     *             files: [{
+     *                     url: "https://example.com/invoice1.pdf"
+     *                 }, {
+     *                     url: "https://example.com/invoice2.pdf"
+     *                 }]
+     *         }
+     *     })
      */
-    create(request, requestOptions) {
+    create(request = {}, requestOptions) {
         return core.HttpResponsePromise.fromPromise(this.__create(request, requestOptions));
     }
-    __create(request, requestOptions) {
-        return __awaiter(this, void 0, void 0, function* () {
+    __create() {
+        return __awaiter(this, arguments, void 0, function* (request = {}, requestOptions) {
             var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k, _l;
             const _authRequest = yield this._options.authProvider.getAuthRequest();
             const _headers = (0, headers_1.mergeHeaders)(_authRequest.headers, (_a = this._options) === null || _a === void 0 ? void 0 : _a.headers, (0, headers_1.mergeOnlyDefinedHeaders)({ "x-extend-api-version": (_b = requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.extendApiVersion) !== null && _b !== void 0 ? _b : "2026-02-09" }), requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.headers);

package/api/resources/extractRuns/client/requests/ExtractRunsCreateRequest.d.ts

@@ -9,14 +9,38 @@ import type * as Extend from "../../../../index";
  *             url: "https://example.com/invoice.pdf"
  *         }
  *     }
+ *
+ * @example
+ *     {
+ *         extractor: {
+ *             id: "ex_1234567890"
+ *         },
+ *         "package": {
+ *             files: [{
+ *                     url: "https://example.com/invoice1.pdf"
+ *                 }, {
+ *                     url: "https://example.com/invoice2.pdf"
+ *                 }]
+ *         }
+ *     }
  */
 export interface ExtractRunsCreateRequest {
     /** Reference to an existing extractor. Mutually exclusive with `config` — provide one or the other, or omit both to have Extend infer a schema from the document. */
     extractor?: Extend.ExtractRunsCreateRequestExtractor;
     /** Inline extract configuration. Mutually exclusive with `extractor` — provide one or the other, or omit both to have Extend infer a schema from the document. */
     config?: Extend.ExtractConfigJson;
-    /** The file to be extracted from. Files can be provided as a URL, Extend file ID, or raw text. */
-    file: Extend.ExtractRunsCreateRequestFile;
+    /**
+     * The file to be extracted from. Mutually exclusive with `package` — provide one or the other.
+     *
+     * Files can be provided as a URL, Extend file ID, or raw text.
+     */
+    file?: Extend.ExtractRunsCreateRequestFile;
+    /**
+     * A collection of files to extract from together in a single run. Mutually exclusive with `file` — provide one or the other.
+     *
+     * See [Multifile Extraction](https://docs.extend.ai/2026-02-09/extraction/multifile) for details.
+     */
+    package?: Extend.MultiFileRunPackage;
     priority?: Extend.RunPriority;
     metadata?: Extend.RunMetadata;
 }

package/api/resources/extractRuns/types/ExtractRunsCreateRequestFile.d.ts

@@ -1,5 +1,7 @@
 import type * as Extend from "../../../index";
 /**
- * The file to be extracted from. Files can be provided as a URL, Extend file ID, or raw text.
+ * The file to be extracted from. Mutually exclusive with `package` — provide one or the other.
+ *
+ * Files can be provided as a URL, Extend file ID, or raw text.
  */
 export type ExtractRunsCreateRequestFile = Extend.FileFromUrl | Extend.FileFromId | Extend.FileFromText;

package/api/types/ExtractRequestFile.d.ts

@@ -1,5 +1,7 @@
 import type * as Extend from "../index";
 /**
- * The file to be extracted from. Files can be provided as a URL, Extend file ID, or raw text.
+ * The file to be extracted from. Mutually exclusive with `package` — provide one or the other.
+ *
+ * Files can be provided as a URL, Extend file ID, or raw text.
  */
 export type ExtractRequestFile = Extend.FileFromUrl | Extend.FileFromId | Extend.FileFromText;

package/api/types/ExtractRun.d.ts

@@ -94,8 +94,14 @@ export interface ExtractRun {
      * **Availability:** Present when an extractor reference was provided. Not present when using inline `config`.
      */
     extractorVersion: Extend.ExtractorVersionSummary | null;
-    /** The file that was processed. `null` when the file could not be accessed or processed (for example a run that failed during file ingestion, or a multi-file batch run). */
+    /** The file that was processed. `null` for multifile runs (use `files` instead), and `null` when the file could not be accessed or processed (for example, a run that failed during file ingestion). */
     file: Extend.FileSummary | null;
+    /**
+     * The files that were processed, in the order they were submitted. Only populated for multifile runs (created with `package`).
+     *
+     * For single-file runs, this is `null` — use `file` instead.
+     */
+    files: Extend.FileSummary[] | null;
     /**
      * The ID of the parse run that was used for this extract run.
      *

package/api/types/ExtractRunSummary.d.ts

@@ -56,8 +56,14 @@ export interface ExtractRunSummary {
     reviewed: boolean;
     /** Indicates whether the run results have been edited during review. */
     edited: boolean;
-    /** The file that was processed. `null` when the file could not be accessed or processed (for example a run that failed during file ingestion, or a multi-file batch run). */
+    /** The file that was processed. `null` for multifile runs (use `files` instead), and `null` when the file could not be accessed or processed (for example, a run that failed during file ingestion). */
     file: Extend.FileSummary | null;
+    /**
+     * The files that were processed, in the order they were submitted. Only populated for multifile runs (created with `package`).
+     *
+     * For single-file runs, this is `null` — use `file` instead.
+     */
+    files: Extend.FileSummary[] | null;
     /**
      * The ID of the parse run that was used for this extract run.
      *

package/api/types/MultiFileRunPackage.d.ts

@@ -0,0 +1,10 @@
+import type * as Extend from "../index";
+/**
+ * An ordered collection of files to extract from together in a single run. Use this instead of `file` when you want to run extraction across multiple documents at once.
+ *
+ * Exactly one of `file` or `package` must be provided on a request — they are mutually exclusive.
+ */
+export interface MultiFileRunPackage {
+    /** The files to extract from. Each entry can be a URL or an existing Extend file ID. */
+    files: Extend.MultiFileRunPackageFilesItem[];
+}

package/api/types/MultiFileRunPackage.js

@@ -0,0 +1,3 @@
+"use strict";
+// This file was auto-generated by Fern from our API Definition.
+Object.defineProperty(exports, "__esModule", { value: true });

package/api/types/MultiFileRunPackageFilesItem.d.ts

@@ -0,0 +1,2 @@
+import type * as Extend from "../index";
+export type MultiFileRunPackageFilesItem = Extend.FileFromUrl | Extend.FileFromId;

package/api/types/MultiFileRunPackageFilesItem.js

@@ -0,0 +1,3 @@
+"use strict";
+// This file was auto-generated by Fern from our API Definition.
+Object.defineProperty(exports, "__esModule", { value: true });

package/api/types/index.d.ts

@@ -266,6 +266,8 @@ export * from "./MergeExtractStepDefinitionConfig";
 export * from "./MergeExtractStepDefinitionConfigMergeOrder";
 export * from "./MergeExtractStepRun";
 export * from "./MergeExtractStepRunStep";
+export * from "./MultiFileRunPackage";
+export * from "./MultiFileRunPackageFilesItem";
 export * from "./NextPageToken";
 export * from "./PageRanges";
 export * from "./PageRangesItem";

package/api/types/index.js

@@ -282,6 +282,8 @@ __exportStar(require("./MergeExtractStepDefinitionConfig"), exports);
 __exportStar(require("./MergeExtractStepDefinitionConfigMergeOrder"), exports);
 __exportStar(require("./MergeExtractStepRun"), exports);
 __exportStar(require("./MergeExtractStepRunStep"), exports);
+__exportStar(require("./MultiFileRunPackage"), exports);
+__exportStar(require("./MultiFileRunPackageFilesItem"), exports);
 __exportStar(require("./NextPageToken"), exports);
 __exportStar(require("./PageRanges"), exports);
 __exportStar(require("./PageRangesItem"), exports);

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "extend-ai",
-    "version": "1.14.0",
+    "version": "1.15.0",
     "private": false,
     "repository": {
         "type": "git",

package/reference.md

@@ -170,6 +170,8 @@ Extract structured data from a file synchronously, waiting for the result before
 
 The Extract endpoint allows you to extract structured data from files using an existing extractor, an inline configuration, or no configuration at all. When neither is provided, Extend automatically infers a schema from the document before extraction — no extractor or schema is required.
 
+Pass `file` for a single document, or `package` to extract from multiple files in a single run. Exactly one of `file` or `package` must be provided.
+
 For more details, see the [Extract File guide](https://docs.extend.ai/2026-02-09/extraction/overview).
 </dd>
 </dl>

package/version.d.ts

@@ -1 +1 @@
-export declare const SDK_VERSION = "1.14.0";
+export declare const SDK_VERSION = "1.15.0";

package/version.js

@@ -1,4 +1,4 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.SDK_VERSION = void 0;
-exports.SDK_VERSION = "1.14.0";
+exports.SDK_VERSION = "1.15.0";

package/wrapper/resources/extractRuns/ExtractRunsWrapper.test.js

@@ -51,7 +51,7 @@ function createMockExtractRun(overrides = {}) {
             metadata: {},
             createdAt: "2024-01-01T00:00:00Z",
             updatedAt: "2024-01-01T00:00:00Z",
-        }, dashboardUrl: "https://dashboard.extend.ai/extract-runs/extract_run_test123", edits: {}, usage: { credits: 1 }, failureReason: null, failureMessage: null, parseRunId: null, createdAt: "2024-01-01T00:00:00Z", updatedAt: "2024-01-01T00:00:00Z" }, overrides);
+        }, files: null, dashboardUrl: "https://dashboard.extend.ai/extract-runs/extract_run_test123", edits: {}, usage: { credits: 1 }, failureReason: null, failureMessage: null, parseRunId: null, createdAt: "2024-01-01T00:00:00Z", updatedAt: "2024-01-01T00:00:00Z" }, overrides);
 }
 // ============================================================================
 // Tests

package/wrapper/webhooks/Webhooks.test.js

@@ -145,6 +145,7 @@ const sampleExtractRunPayload = {
         createdAt: "2024-01-01T00:00:00Z",
         updatedAt: "2024-01-01T00:00:00Z",
     },
+    files: null,
     dashboardUrl: "https://dashboard.extend.ai/extract-runs/extract_run_def456",
     edits: {},
     usage: { credits: 1 },