extend-ai 1.3.0 → 1.5.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.3.0",
-        "User-Agent": "extend-ai/1.3.0",
+        "X-Fern-SDK-Version": "1.5.0",
+        "User-Agent": "extend-ai/1.5.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

@@ -267,11 +267,13 @@ export declare class ExtendClient {
      *             splitClassifications: [{
      *                     id: "invoice",
      *                     type: "invoice",
-     *                     description: "An invoice or bill for goods or services"
+     *                     description: "An invoice or bill for goods or services",
+     *                     identifierKey: "invoice number from the document header"
      *                 }, {
      *                     id: "receipt",
      *                     type: "receipt",
-     *                     description: "A receipt confirming payment"
+     *                     description: "A receipt confirming payment",
+     *                     identifierKey: "receipt number"
      *                 }, {
      *                     id: "other",
      *                     type: "other",

package/Client.js

@@ -581,11 +581,13 @@ class ExtendClient {
      *             splitClassifications: [{
      *                     id: "invoice",
      *                     type: "invoice",
-     *                     description: "An invoice or bill for goods or services"
+     *                     description: "An invoice or bill for goods or services",
+     *                     identifierKey: "invoice number from the document header"
      *                 }, {
      *                     id: "receipt",
      *                     type: "receipt",
-     *                     description: "A receipt confirming payment"
+     *                     description: "A receipt confirming payment",
+     *                     identifierKey: "receipt number"
      *                 }, {
      *                     id: "other",
      *                     type: "other",

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

@@ -6,11 +6,13 @@ import type * as Extend from "../../index";
  *             splitClassifications: [{
  *                     id: "invoice",
  *                     type: "invoice",
- *                     description: "An invoice or bill for goods or services"
+ *                     description: "An invoice or bill for goods or services",
+ *                     identifierKey: "invoice number from the document header"
  *                 }, {
  *                     id: "receipt",
  *                     type: "receipt",
- *                     description: "A receipt confirming payment"
+ *                     description: "A receipt confirming payment",
+ *                     identifierKey: "receipt number"
  *                 }, {
  *                     id: "other",
  *                     type: "other",

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

@@ -93,6 +93,7 @@ export declare class FilesClient {
      * This endpoint requires multipart form encoding. Most HTTP clients will handle this encoding automatically (see the examples).
      *
      * @param {File | fs.ReadStream | Blob} file
+     * @param {Extend.FilesUploadRequest} request
      * @param {FilesClient.RequestOptions} requestOptions - Request-specific configuration.
      *
      * @throws {@link Extend.BadRequestError}
@@ -106,8 +107,8 @@ export declare class FilesClient {
      *
      * @example
      *     import { createReadStream } from "fs";
-     *     await client.files.upload(createReadStream("path/to/file"))
+     *     await client.files.upload(createReadStream("path/to/file"), {})
      */
-    upload(file: File | fs.ReadStream | Blob, requestOptions?: FilesClient.RequestOptions): core.HttpResponsePromise<Extend.File_>;
+    upload(file: File | fs.ReadStream | Blob, request: Extend.FilesUploadRequest, requestOptions?: FilesClient.RequestOptions): core.HttpResponsePromise<Extend.File_>;
     private __upload;
 }

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

@@ -296,6 +296,7 @@ class FilesClient {
      * This endpoint requires multipart form encoding. Most HTTP clients will handle this encoding automatically (see the examples).
      *
      * @param {File | fs.ReadStream | Blob} file
+     * @param {Extend.FilesUploadRequest} request
      * @param {FilesClient.RequestOptions} requestOptions - Request-specific configuration.
      *
      * @throws {@link Extend.BadRequestError}
@@ -309,14 +310,17 @@ class FilesClient {
      *
      * @example
      *     import { createReadStream } from "fs";
-     *     await client.files.upload(createReadStream("path/to/file"))
+     *     await client.files.upload(createReadStream("path/to/file"), {})
      */
-    upload(file, requestOptions) {
-        return core.HttpResponsePromise.fromPromise(this.__upload(file, requestOptions));
+    upload(file, request, requestOptions) {
+        return core.HttpResponsePromise.fromPromise(this.__upload(file, request, requestOptions));
     }
-    __upload(file, requestOptions) {
+    __upload(file, request, requestOptions) {
         return __awaiter(this, void 0, void 0, function* () {
             var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k, _l;
+            const _queryParams = {
+                convertToPdf: request.convertToPdf,
+            };
             const _body = yield core.newFormData();
             yield _body.appendFile("file", file);
             const _maybeEncodedRequest = yield _body.getRequest();
@@ -326,7 +330,7 @@ class FilesClient {
                 url: core.url.join((_e = (_d = (yield core.Supplier.get(this._options.baseUrl))) !== null && _d !== void 0 ? _d : (yield core.Supplier.get(this._options.environment))) !== null && _e !== void 0 ? _e : environments.ExtendEnvironment.Production, "files/upload"),
                 method: "POST",
                 headers: _headers,
-                queryParameters: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.queryParams,
+                queryParameters: Object.assign(Object.assign({}, _queryParams), requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.queryParams),
                 requestType: "file",
                 duplex: _maybeEncodedRequest.duplex,
                 body: _maybeEncodedRequest.body,

package/api/resources/files/client/requests/FilesUploadRequest.d.ts

@@ -2,4 +2,7 @@
  * @example
  *     {}
  */
-export type FilesUploadRequest = {};
+export interface FilesUploadRequest {
+    /** When true, converts the uploaded file to PDF. Supported file types include images (JPEG, PNG, TIFF, GIF, BMP, WebP, HEIC/HEIF), Word documents, PowerPoint, Excel, and HTML. */
+    convertToPdf?: boolean;
+}

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

@@ -56,11 +56,13 @@ export declare class SplittersClient {
      *             splitClassifications: [{
      *                     id: "invoice",
      *                     type: "invoice",
-     *                     description: "An invoice or bill for goods or services"
+     *                     description: "An invoice or bill for goods or services",
+     *                     identifierKey: "invoice number from the document header"
      *                 }, {
      *                     id: "receipt",
      *                     type: "receipt",
-     *                     description: "A receipt confirming payment"
+     *                     description: "A receipt confirming payment",
+     *                     identifierKey: "receipt number"
      *                 }, {
      *                     id: "other",
      *                     type: "other",

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

@@ -157,11 +157,13 @@ class SplittersClient {
      *             splitClassifications: [{
      *                     id: "invoice",
      *                     type: "invoice",
-     *                     description: "An invoice or bill for goods or services"
+     *                     description: "An invoice or bill for goods or services",
+     *                     identifierKey: "invoice number from the document header"
      *                 }, {
      *                     id: "receipt",
      *                     type: "receipt",
-     *                     description: "A receipt confirming payment"
+     *                     description: "A receipt confirming payment",
+     *                     identifierKey: "receipt number"
      *                 }, {
      *                     id: "other",
      *                     type: "other",

package/api/resources/splitters/client/requests/SplittersCreateRequest.d.ts

@@ -7,11 +7,13 @@ import type * as Extend from "../../../../index";
  *             splitClassifications: [{
  *                     id: "invoice",
  *                     type: "invoice",
- *                     description: "An invoice or bill for goods or services"
+ *                     description: "An invoice or bill for goods or services",
+ *                     identifierKey: "invoice number from the document header"
  *                 }, {
  *                     id: "receipt",
  *                     type: "receipt",
- *                     description: "A receipt confirming payment"
+ *                     description: "A receipt confirming payment",
+ *                     identifierKey: "receipt number"
  *                 }, {
  *                     id: "other",
  *                     type: "other",

package/api/types/EditConfigAdvancedOptions.d.ts

@@ -6,4 +6,8 @@ export interface EditConfigAdvancedOptions {
     tableParsingEnabled?: boolean;
     /** Whether to flatten the PDF (form widgets will not be editable with a PDF edit). Defaults to `true`. */
     flattenPdf?: boolean;
+    /** Whether to model radio fields as enums. This ensures only one radio widget is filled. Defaults to false. */
+    radioEnumsEnabled?: boolean;
+    /** If enabled, only native AcroForm from the PDF will be imported and used in the schema (skips object detection). Defaults to false. */
+    nativeFieldsOnly?: boolean;
 }

package/api/types/EditJson.d.ts

@@ -33,6 +33,8 @@ export interface EditJson {
      */
     "extend_edit:field_type"?: Extend.EditJsonExtendEditFieldType;
     "extend_edit:bbox"?: Extend.EditBoundingBox;
+    /** Array of bounding boxes for radio enums. Enum at index i corresponds to bbox at index i. */
+    "extend_edit:bboxes"?: Extend.EditBoundingBox[];
     /** Zero-based page index where the field should be placed */
     "extend_edit:page_index"?: number;
     "extend_edit:text_edit_options"?: Extend.EditTextOptions;

package/api/types/LegacySplitterAdvancedOptions.d.ts

@@ -2,7 +2,11 @@ import type * as Extend from "../index";
 export interface LegacySplitterAdvancedOptions {
     /** Custom rules for identifying split points. */
     splitIdentifierRules?: string;
-    /** The method to use for splitting documents. `high_precision` is more accurate but slower, while `low_latency` is faster but less precise. */
+    /**
+     * The method to use for splitting documents. `high_precision` is more accurate but slower, while `low_latency` is faster but less precise.
+     *
+     * **Deprecated:** For `splitting_light` >= 1.3.0 and `splitting_performance` >= 1.5.0, this field has no impact and is ignored if provided. It is still accepted for compatibility with older integrations.
+     */
     splitMethod?: Extend.LegacySplitterAdvancedOptionsSplitMethod;
     /** For Excel documents, split by worksheet. */
     splitExcelDocumentsBySheetEnabled?: boolean;

package/api/types/LegacySplitterAdvancedOptionsSplitMethod.d.ts

@@ -1,4 +1,8 @@
-/** The method to use for splitting documents. `high_precision` is more accurate but slower, while `low_latency` is faster but less precise. */
+/**
+ * The method to use for splitting documents. `high_precision` is more accurate but slower, while `low_latency` is faster but less precise.
+ *
+ * **Deprecated:** For `splitting_light` >= 1.3.0 and `splitting_performance` >= 1.5.0, this field has no impact and is ignored if provided. It is still accepted for compatibility with older integrations.
+ */
 export declare const LegacySplitterAdvancedOptionsSplitMethod: {
     readonly HighPrecision: "high_precision";
     readonly LowLatency: "low_latency";

package/api/types/LegacySplitterAdvancedOptionsSplitMethod.js

@@ -2,7 +2,11 @@
 // This file was auto-generated by Fern from our API Definition.
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.LegacySplitterAdvancedOptionsSplitMethod = void 0;
-/** The method to use for splitting documents. `high_precision` is more accurate but slower, while `low_latency` is faster but less precise. */
+/**
+ * The method to use for splitting documents. `high_precision` is more accurate but slower, while `low_latency` is faster but less precise.
+ *
+ * **Deprecated:** For `splitting_light` >= 1.3.0 and `splitting_performance` >= 1.5.0, this field has no impact and is ignored if provided. It is still accepted for compatibility with older integrations.
+ */
 exports.LegacySplitterAdvancedOptionsSplitMethod = {
     HighPrecision: "high_precision",
     LowLatency: "low_latency",

package/api/types/ParseConfigAdvancedOptions.d.ts

@@ -14,8 +14,14 @@ export interface ParseConfigAdvancedOptions {
     excelParsingMode?: Extend.ParseConfigAdvancedOptionsExcelParsingMode;
     /** Whether to exclude hidden rows, columns, and sheets when parsing Excel files. */
     excelSkipHiddenContent?: boolean;
+    /** Whether to return raw calculated cell values instead of locale-formatted values when parsing Excel files. Useful when downstream processing needs the underlying numeric or unformatted data. */
+    excelUseRawCellValues?: boolean;
+    /** Whether to skip formula recalculation when opening Excel workbooks. Significantly improves parsing speed for formula-heavy spreadsheets. Disable if cell values depend on volatile functions like NOW() or TODAY(). */
+    excelSkipCalculation?: boolean;
     /** Multiplier for the Y-axis threshold used to determine if text blocks should be placed on the same line or not (0.1-5.0, default 1.0). Higher values group elements that are further apart vertically. Only applies when the spatial target is set. */
     verticalGroupingThreshold?: number;
     /** Options for returning raw OCR data in the response. */
     returnOcr?: Extend.ParseConfigAdvancedOptionsReturnOcr;
+    /** Whether to convert supported file types (images, Word documents, PowerPoint, Excel, HTML) to PDF before parsing. This can improve parsing quality for some file types and ensures spatial output with bounding boxes. */
+    alwaysConvertToPdf?: boolean;
 }

package/api/types/SplitAdvancedOptions.d.ts

@@ -1,12 +1,23 @@
 import type * as Extend from "../index";
 export interface SplitAdvancedOptions {
-    /** Custom rules for identifying split points. */
+    /**
+     * Custom rules for identifying split points.
+     *
+     * **Deprecated:** For `splitting_light` >= 1.3.0 and `splitting_performance` >= 1.5.0, use the `identifierKey` field on each classification in `splitClassifications` instead. This provides per-type identifier extraction rules rather than a single global rule. On those versions, this field is accepted but ignored if provided.
+     */
     splitIdentifierRules?: string;
-    /** The method to use for splitting documents. `high_precision` is more accurate but slower, while `basic_precision` is faster but less precise. */
+    /**
+     * The method to use for splitting documents. `high_precision` is more accurate but slower, while `basic_precision` is faster but less precise.
+     *
+     * **Deprecated:** For `splitting_light` >= 1.3.0 and `splitting_performance` >= 1.5.0, this field has no impact and is ignored if provided. It is still accepted for compatibility with older integrations.
+     */
     splitMethod?: Extend.SplitAdvancedOptionsSplitMethod;
     /** For Excel documents, split by worksheet. */
     splitExcelDocumentsBySheetEnabled?: boolean;
     pageRanges?: Extend.PageRanges;
-    /** When enabled, the splitter will allow for page overlap when splitting a document such that a page can occur in multiple adjacent splits when context from the previous split is on the page and context from the next split is on the page. */
+    /**
+     * When enabled, the splitter will allow for page overlap when splitting a document such that a page can occur in multiple adjacent splits when context from the previous split is on the page and context from the next split is on the page.
+     * **Availability:** Supported on `splitting_light` >= 1.1.0 and `splitting_performance` >= 1.2.0. If provided on older versions, this field is accepted but ignored.
+     */
     pageOverlapEnabled?: boolean;
 }

package/api/types/SplitAdvancedOptionsSplitMethod.d.ts

@@ -1,4 +1,8 @@
-/** The method to use for splitting documents. `high_precision` is more accurate but slower, while `basic_precision` is faster but less precise. */
+/**
+ * The method to use for splitting documents. `high_precision` is more accurate but slower, while `basic_precision` is faster but less precise.
+ *
+ * **Deprecated:** For `splitting_light` >= 1.3.0 and `splitting_performance` >= 1.5.0, this field has no impact and is ignored if provided. It is still accepted for compatibility with older integrations.
+ */
 export declare const SplitAdvancedOptionsSplitMethod: {
     readonly HighPrecision: "high_precision";
     readonly BasicPrecision: "basic_precision";

package/api/types/SplitAdvancedOptionsSplitMethod.js

@@ -2,7 +2,11 @@
 // This file was auto-generated by Fern from our API Definition.
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.SplitAdvancedOptionsSplitMethod = void 0;
-/** The method to use for splitting documents. `high_precision` is more accurate but slower, while `basic_precision` is faster but less precise. */
+/**
+ * The method to use for splitting documents. `high_precision` is more accurate but slower, while `basic_precision` is faster but less precise.
+ *
+ * **Deprecated:** For `splitting_light` >= 1.3.0 and `splitting_performance` >= 1.5.0, this field has no impact and is ignored if provided. It is still accepted for compatibility with older integrations.
+ */
 exports.SplitAdvancedOptionsSplitMethod = {
     HighPrecision: "high_precision",
     BasicPrecision: "basic_precision",

package/api/types/SplitClassification.d.ts

@@ -0,0 +1,19 @@
+/**
+ * A classification for document splitting. Extends the base Classification with an optional `identifierKey` field for per-type identifier extraction rules.
+ */
+export interface SplitClassification {
+    /** Unique identifier for the classification. We recommend lowercase, underscore-separated format. */
+    id: string;
+    /** Type identifier for the classification. */
+    type: string;
+    /** A detailed description of the classification. */
+    description: string;
+    /**
+     * A natural-language rule describing how to extract a unique identifier for subdocuments of this type. For example, `"Extract the invoice number from the document header"`.
+     *
+     * When provided, the splitter will extract the specified identifier for each subdocument of this type and include it in the output as the `identifier` field. This enables merging of related subdocuments that share the same extracted identifier.
+     *
+     * **Availability:** Supported on `splitting_light` >= 1.3.0 and `splitting_performance` >= 1.5.0. If provided on older versions, this field is accepted but ignored.
+     */
+    identifierKey?: string;
+}

package/api/types/SplitClassification.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/SplitClassifications.d.ts

@@ -0,0 +1,5 @@
+import type * as Extend from "../index";
+/**
+ * Array of split classifications that define the possible types of document sections. Must provide at least one classification. At least one classification must have the type `"other"`. Each classification item must have a unique id.
+ */
+export type SplitClassifications = Extend.SplitClassification[];

package/api/types/SplitClassifications.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/SplitConfig.d.ts

@@ -3,7 +3,7 @@ export interface SplitConfig {
     baseProcessor?: Extend.SplitBaseProcessor;
     /** The version of the `"splitting_performance"` or `"splitting_light"` processor to use. If not provided, the latest stable version for the selected `baseProcessor` will be used automatically. See [Splitting Changelog](https://docs.extend.ai/2026-02-09/changelog/splitting/splitting-performance) for more details. */
     baseVersion?: string;
-    splitClassifications: Extend.Classifications;
+    splitClassifications: Extend.SplitClassifications;
     /** Custom rules to guide the document splitting process in natural language. */
     splitRules?: string;
     /** Advanced configuration options. */

package/api/types/SplitOverrideConfig.d.ts

@@ -7,7 +7,7 @@ export interface SplitOverrideConfig {
     baseProcessor?: Extend.SplitBaseProcessor;
     /** The version of the `"splitting_performance"` or `"splitting_light"` processor to use. If not provided, the latest stable version for the selected `baseProcessor` will be used automatically. See [Splitting Changelog](https://docs.extend.ai/2026-02-09/changelog/splitting/splitting-performance) for more details. */
     baseVersion?: string;
-    splitClassifications?: Extend.Classifications;
+    splitClassifications?: Extend.SplitClassifications;
     /** Custom rules to guide the document splitting process in natural language. */
     splitRules?: string;
     /** Advanced configuration options. */

package/api/types/index.d.ts

@@ -282,6 +282,8 @@ export * from "./SortDir";
 export * from "./SplitAdvancedOptions";
 export * from "./SplitAdvancedOptionsSplitMethod";
 export * from "./SplitBaseProcessor";
+export * from "./SplitClassification";
+export * from "./SplitClassifications";
 export * from "./SplitConfig";
 export * from "./SplitOutput";
 export * from "./SplitOutputSplitsItem";

package/api/types/index.js

@@ -298,6 +298,8 @@ __exportStar(require("./SortDir"), exports);
 __exportStar(require("./SplitAdvancedOptions"), exports);
 __exportStar(require("./SplitAdvancedOptionsSplitMethod"), exports);
 __exportStar(require("./SplitBaseProcessor"), exports);
+__exportStar(require("./SplitClassification"), exports);
+__exportStar(require("./SplitClassifications"), exports);
 __exportStar(require("./SplitConfig"), exports);
 __exportStar(require("./SplitOutput"), exports);
 __exportStar(require("./SplitOutputSplitsItem"), exports);

package/package.json

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

package/reference.md

@@ -370,11 +370,13 @@ await client.split({
         splitClassifications: [{
                 id: "invoice",
                 type: "invoice",
-                description: "An invoice or bill for goods or services"
+                description: "An invoice or bill for goods or services",
+                identifierKey: "invoice number from the document header"
             }, {
                 id: "receipt",
                 type: "receipt",
-                description: "A receipt confirming payment"
+                description: "A receipt confirming payment",
+                identifierKey: "receipt number"
             }, {
                 id: "other",
                 type: "other",
@@ -630,7 +632,7 @@ Example: `"file_xK9mLPqRtN3vS8wF5hB2cQ"`
 </dl>
 </details>
 
-<details><summary><code>client.files.<a href="/src/api/resources/files/client/Client.ts">upload</a>(file) -> Extend.File_</code></summary>
+<details><summary><code>client.files.<a href="/src/api/resources/files/client/Client.ts">upload</a>(file, { ...params }) -> Extend.File_</code></summary>
 <dl>
 <dd>
 
@@ -665,7 +667,7 @@ This endpoint requires multipart form encoding. Most HTTP clients will handle th
 <dd>
 
 ```typescript
-await client.files.upload(createReadStream("path/to/file"));
+await client.files.upload(createReadStream("path/to/file"), {});
 
 ```
 </dd>
@@ -689,6 +691,14 @@ await client.files.upload(createReadStream("path/to/file"));
 <dl>
 <dd>
 
+**request:** `Extend.FilesUploadRequest` 
+    
+</dd>
+</dl>
+
+<dl>
+<dd>
+
 **requestOptions:** `FilesClient.RequestOptions` 
     
 </dd>
@@ -3332,11 +3342,13 @@ await client.splitters.create({
         splitClassifications: [{
                 id: "invoice",
                 type: "invoice",
-                description: "An invoice or bill for goods or services"
+                description: "An invoice or bill for goods or services",
+                identifierKey: "invoice number from the document header"
             }, {
                 id: "receipt",
                 type: "receipt",
-                description: "A receipt confirming payment"
+                description: "A receipt confirming payment",
+                identifierKey: "receipt number"
             }, {
                 id: "other",
                 type: "other",

package/version.d.ts

@@ -1 +1 @@
-export declare const SDK_VERSION = "1.3.0";
+export declare const SDK_VERSION = "1.5.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.3.0";
+exports.SDK_VERSION = "1.5.0";