pulse-ts-sdk 0.0.53 → 0.0.55

package/dist/esm/Client.mjs

@@ -12,8 +12,9 @@ import * as Pulse from "./api/index.mjs";
 import { JobsClient } from "./api/resources/jobs/client/Client.mjs";
 import { WebhooksClient } from "./api/resources/webhooks/client/Client.mjs";
 import { normalizeClientOptions } from "./BaseClient.mjs";
-import { mergeHeaders } from "./core/headers.mjs";
+import { mergeHeaders, mergeOnlyDefinedHeaders } from "./core/headers.mjs";
 import * as core from "./core/index.mjs";
+import { toJson } from "./core/json.mjs";
 import * as environments from "./environments.mjs";
 import { handleNonStatusCodeError } from "./errors/handleNonStatusCodeError.mjs";
 import * as errors from "./errors/index.mjs";
@@ -34,7 +35,7 @@ export class PulseClient {
      * file URLs and returns rich markdown content with optional structured data
      * extraction based on user-provided schemas and extraction options.
      *
-     * @param {Pulse.ExtractJsonInput} request
+     * @param {Pulse.ExtractRequest} request
      * @param {PulseClient.RequestOptions} requestOptions - Request-specific configuration.
      *
      * @throws {@link Pulse.BadRequestError}
@@ -42,9 +43,8 @@ export class PulseClient {
      * @throws {@link Pulse.TooManyRequestsError}
      *
      * @example
-     *     await client.extract({
-     *         fileUrl: "fileUrl"
-     *     })
+     *     import { createReadStream } from "fs";
+     *     await client.extract({})
      */
     extract(request, requestOptions) {
         return core.HttpResponsePromise.fromPromise(this.__extract(request, requestOptions));
@@ -52,15 +52,64 @@ export class PulseClient {
     __extract(request, requestOptions) {
         return __awaiter(this, void 0, void 0, function* () {
             var _a, _b, _c, _d, _e, _f, _g, _h, _j;
-            const _headers = mergeHeaders((_a = this._options) === null || _a === void 0 ? void 0 : _a.headers, requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.headers);
+            const _request = yield core.newFormData();
+            if (request.file != null) {
+                yield _request.appendFile("file", request.file);
+            }
+            if (request.fileUrl != null) {
+                _request.append("fileUrl", request.fileUrl);
+            }
+            if (request.structuredOutput != null) {
+                _request.append("structuredOutput", toJson(request.structuredOutput));
+            }
+            if (request.schema != null) {
+                _request.append("schema", typeof request.schema === "string" ? request.schema : toJson(request.schema));
+            }
+            if (request.experimentalSchema != null) {
+                _request.append("experimentalSchema", typeof request.experimentalSchema === "string"
+                    ? request.experimentalSchema
+                    : toJson(request.experimentalSchema));
+            }
+            if (request.schemaPrompt != null) {
+                _request.append("schemaPrompt", request.schemaPrompt);
+            }
+            if (request.customPrompt != null) {
+                _request.append("customPrompt", request.customPrompt);
+            }
+            if (request.chunking != null) {
+                _request.append("chunking", request.chunking);
+            }
+            if (request.chunkSize != null) {
+                _request.append("chunkSize", request.chunkSize.toString());
+            }
+            if (request.pages != null) {
+                _request.append("pages", request.pages);
+            }
+            if (request.extractFigure != null) {
+                _request.append("extractFigure", request.extractFigure.toString());
+            }
+            if (request.figureDescription != null) {
+                _request.append("figureDescription", request.figureDescription.toString());
+            }
+            if (request.returnHtml != null) {
+                _request.append("returnHtml", request.returnHtml.toString());
+            }
+            if (request.thinking != null) {
+                _request.append("thinking", request.thinking.toString());
+            }
+            if (request.storage != null) {
+                _request.append("storage", toJson(request.storage));
+            }
+            const _maybeEncodedRequest = yield _request.getRequest();
+            const _headers = mergeHeaders((_a = this._options) === null || _a === void 0 ? void 0 : _a.headers, mergeOnlyDefinedHeaders(Object.assign({}, _maybeEncodedRequest.headers)), requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.headers);
             const _response = yield core.fetcher({
                 url: core.url.join((_c = (_b = (yield core.Supplier.get(this._options.baseUrl))) !== null && _b !== void 0 ? _b : (yield core.Supplier.get(this._options.environment))) !== null && _c !== void 0 ? _c : environments.PulseEnvironment.Default, "extract"),
                 method: "POST",
                 headers: _headers,
-                contentType: "application/json",
                 queryParameters: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.queryParams,
-                requestType: "json",
-                body: request,
+                requestType: "file",
+                duplex: _maybeEncodedRequest.duplex,
+                body: _maybeEncodedRequest.body,
                 timeoutMs: ((_f = (_d = requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.timeoutInSeconds) !== null && _d !== void 0 ? _d : (_e = this._options) === null || _e === void 0 ? void 0 : _e.timeoutInSeconds) !== null && _f !== void 0 ? _f : 60) * 1000,
                 maxRetries: (_g = requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.maxRetries) !== null && _g !== void 0 ? _g : (_h = this._options) === null || _h === void 0 ? void 0 : _h.maxRetries,
                 abortSignal: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.abortSignal,
@@ -94,7 +143,7 @@ export class PulseClient {
      * synchronous options but returns immediately with a job identifier that
      * clients can poll for completion status.
      *
-     * @param {Pulse.ExtractJsonInput} request
+     * @param {Pulse.ExtractAsyncRequest} request
      * @param {PulseClient.RequestOptions} requestOptions - Request-specific configuration.
      *
      * @throws {@link Pulse.BadRequestError}
@@ -102,9 +151,8 @@ export class PulseClient {
      * @throws {@link Pulse.TooManyRequestsError}
      *
      * @example
-     *     await client.extractAsync({
-     *         fileUrl: "fileUrl"
-     *     })
+     *     import { createReadStream } from "fs";
+     *     await client.extractAsync({})
      */
     extractAsync(request, requestOptions) {
         return core.HttpResponsePromise.fromPromise(this.__extractAsync(request, requestOptions));
@@ -112,15 +160,64 @@ export class PulseClient {
     __extractAsync(request, requestOptions) {
         return __awaiter(this, void 0, void 0, function* () {
             var _a, _b, _c, _d, _e, _f, _g, _h, _j;
-            const _headers = mergeHeaders((_a = this._options) === null || _a === void 0 ? void 0 : _a.headers, requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.headers);
+            const _request = yield core.newFormData();
+            if (request.file != null) {
+                yield _request.appendFile("file", request.file);
+            }
+            if (request.fileUrl != null) {
+                _request.append("fileUrl", request.fileUrl);
+            }
+            if (request.structuredOutput != null) {
+                _request.append("structuredOutput", toJson(request.structuredOutput));
+            }
+            if (request.schema != null) {
+                _request.append("schema", typeof request.schema === "string" ? request.schema : toJson(request.schema));
+            }
+            if (request.experimentalSchema != null) {
+                _request.append("experimentalSchema", typeof request.experimentalSchema === "string"
+                    ? request.experimentalSchema
+                    : toJson(request.experimentalSchema));
+            }
+            if (request.schemaPrompt != null) {
+                _request.append("schemaPrompt", request.schemaPrompt);
+            }
+            if (request.customPrompt != null) {
+                _request.append("customPrompt", request.customPrompt);
+            }
+            if (request.chunking != null) {
+                _request.append("chunking", request.chunking);
+            }
+            if (request.chunkSize != null) {
+                _request.append("chunkSize", request.chunkSize.toString());
+            }
+            if (request.pages != null) {
+                _request.append("pages", request.pages);
+            }
+            if (request.extractFigure != null) {
+                _request.append("extractFigure", request.extractFigure.toString());
+            }
+            if (request.figureDescription != null) {
+                _request.append("figureDescription", request.figureDescription.toString());
+            }
+            if (request.returnHtml != null) {
+                _request.append("returnHtml", request.returnHtml.toString());
+            }
+            if (request.thinking != null) {
+                _request.append("thinking", request.thinking.toString());
+            }
+            if (request.storage != null) {
+                _request.append("storage", toJson(request.storage));
+            }
+            const _maybeEncodedRequest = yield _request.getRequest();
+            const _headers = mergeHeaders((_a = this._options) === null || _a === void 0 ? void 0 : _a.headers, mergeOnlyDefinedHeaders(Object.assign({}, _maybeEncodedRequest.headers)), requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.headers);
             const _response = yield core.fetcher({
                 url: core.url.join((_c = (_b = (yield core.Supplier.get(this._options.baseUrl))) !== null && _b !== void 0 ? _b : (yield core.Supplier.get(this._options.environment))) !== null && _c !== void 0 ? _c : environments.PulseEnvironment.Default, "extract_async"),
                 method: "POST",
                 headers: _headers,
-                contentType: "application/json",
                 queryParameters: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.queryParams,
-                requestType: "json",
-                body: request,
+                requestType: "file",
+                duplex: _maybeEncodedRequest.duplex,
+                body: _maybeEncodedRequest.body,
                 timeoutMs: ((_f = (_d = requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.timeoutInSeconds) !== null && _d !== void 0 ? _d : (_e = this._options) === null || _e === void 0 ? void 0 : _e.timeoutInSeconds) !== null && _f !== void 0 ? _f : 60) * 1000,
                 maxRetries: (_g = requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.maxRetries) !== null && _g !== void 0 ? _g : (_h = this._options) === null || _h === void 0 ? void 0 : _h.maxRetries,
                 abortSignal: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.abortSignal,

package/dist/esm/api/client/index.d.mts

@@ -0,0 +1 @@
+export * from "./requests/index.mjs";

package/dist/esm/api/client/index.mjs

@@ -0,0 +1 @@
+export * from "./requests/index.mjs";

package/dist/{cjs/api/types/ExtractJsonInput.d.ts → esm/api/client/requests/ExtractAsyncRequest.d.mts}

@@ -1,15 +1,19 @@
+import type * as core from "../../../core/index.mjs";
 /**
- * Input schema for JSON requests (fileUrl only).
+ * @example
+ *     {}
  */
-export interface ExtractJsonInput {
-    /** Public or pre-signed URL that Pulse will download and extract. */
-    fileUrl: string;
+export interface ExtractAsyncRequest {
+    /** Document to upload directly. Required unless fileUrl is provided. */
+    file?: core.file.Uploadable | undefined;
+    /** Public or pre-signed URL that Pulse will download and extract. Required unless file is provided. */
+    fileUrl?: string;
     /** Recommended method for schema-guided extraction. Contains the schema and optional prompt in a single object. */
-    structuredOutput?: ExtractJsonInput.StructuredOutput;
+    structuredOutput?: ExtractAsyncRequest.StructuredOutput;
     /** (Deprecated) JSON schema describing structured data to extract. Use structuredOutput instead. Accepts either a JSON object or a stringified JSON representation. */
-    schema?: ExtractJsonInput.Schema;
+    schema?: ExtractAsyncRequest.Schema;
     /** (Deprecated) Experimental schema definition used for feature flagged behaviour. Accepts either a JSON object or a stringified JSON representation. */
-    experimentalSchema?: ExtractJsonInput.ExperimentalSchema;
+    experimentalSchema?: ExtractAsyncRequest.ExperimentalSchema;
     /** (Deprecated) Natural language prompt for schema-guided extraction. Use structuredOutput.schemaPrompt instead. */
     schemaPrompt?: string;
     /** (Deprecated) Custom instructions that augment the default extraction behaviour. */
@@ -29,9 +33,9 @@ export interface ExtractJsonInput {
     /** (Deprecated) Enables expanded rationale output for debugging. */
     thinking?: boolean;
     /** Options for persisting extraction artifacts. When enabled (default), artifacts are saved to storage and a database record is created. */
-    storage?: ExtractJsonInput.Storage;
+    storage?: ExtractAsyncRequest.Storage;
 }
-export declare namespace ExtractJsonInput {
+export declare namespace ExtractAsyncRequest {
     /**
      * Recommended method for schema-guided extraction. Contains the schema and optional prompt in a single object.
      */

package/dist/esm/api/{types/ExtractMultipartInput.d.mts → client/requests/ExtractRequest.d.mts}

@@ -1,17 +1,19 @@
+import type * as core from "../../../core/index.mjs";
 /**
- * Input schema for multipart/form-data requests (file upload or fileUrl).
+ * @example
+ *     {}
  */
-export interface ExtractMultipartInput {
+export interface ExtractRequest {
     /** Document to upload directly. Required unless fileUrl is provided. */
-    file?: string;
+    file?: core.file.Uploadable | undefined;
     /** Public or pre-signed URL that Pulse will download and extract. Required unless file is provided. */
     fileUrl?: string;
     /** Recommended method for schema-guided extraction. Contains the schema and optional prompt in a single object. */
-    structuredOutput?: ExtractMultipartInput.StructuredOutput;
+    structuredOutput?: ExtractRequest.StructuredOutput;
     /** (Deprecated) JSON schema describing structured data to extract. Use structuredOutput instead. Accepts either a JSON object or a stringified JSON representation. */
-    schema?: ExtractMultipartInput.Schema;
+    schema?: ExtractRequest.Schema;
     /** (Deprecated) Experimental schema definition used for feature flagged behaviour. Accepts either a JSON object or a stringified JSON representation. */
-    experimentalSchema?: ExtractMultipartInput.ExperimentalSchema;
+    experimentalSchema?: ExtractRequest.ExperimentalSchema;
     /** (Deprecated) Natural language prompt for schema-guided extraction. Use structuredOutput.schemaPrompt instead. */
     schemaPrompt?: string;
     /** (Deprecated) Custom instructions that augment the default extraction behaviour. */
@@ -31,9 +33,9 @@ export interface ExtractMultipartInput {
     /** (Deprecated) Enables expanded rationale output for debugging. */
     thinking?: boolean;
     /** Options for persisting extraction artifacts. When enabled (default), artifacts are saved to storage and a database record is created. */
-    storage?: ExtractMultipartInput.Storage;
+    storage?: ExtractRequest.Storage;
 }
-export declare namespace ExtractMultipartInput {
+export declare namespace ExtractRequest {
     /**
      * Recommended method for schema-guided extraction. Contains the schema and optional prompt in a single object.
      */

package/dist/esm/api/client/requests/index.d.mts

@@ -0,0 +1,2 @@
+export type { ExtractAsyncRequest } from "./ExtractAsyncRequest.mjs";
+export type { ExtractRequest } from "./ExtractRequest.mjs";

package/dist/esm/api/client/requests/index.mjs

@@ -0,0 +1 @@
+export {};

package/dist/esm/api/index.d.mts

@@ -1,3 +1,4 @@
+export * from "./client/index.mjs";
 export * from "./errors/index.mjs";
 export * from "./resources/index.mjs";
 export * from "./types/index.mjs";

package/dist/esm/api/index.mjs

@@ -1,3 +1,4 @@
+export * from "./client/index.mjs";
 export * from "./errors/index.mjs";
 export * from "./resources/index.mjs";
 export * from "./types/index.mjs";

package/dist/esm/api/types/ExtractInput.d.mts

@@ -1 +1,63 @@
-export type ExtractInput = unknown;
+/**
+ * Input schema for extraction requests. Provide either file (direct upload) or fileUrl (remote URL).
+ */
+export interface ExtractInput {
+    /** Document to upload directly. Required unless fileUrl is provided. */
+    file?: string;
+    /** Public or pre-signed URL that Pulse will download and extract. Required unless file is provided. */
+    fileUrl?: string;
+    /** Recommended method for schema-guided extraction. Contains the schema and optional prompt in a single object. */
+    structuredOutput?: ExtractInput.StructuredOutput;
+    /** (Deprecated) JSON schema describing structured data to extract. Use structuredOutput instead. Accepts either a JSON object or a stringified JSON representation. */
+    schema?: ExtractInput.Schema;
+    /** (Deprecated) Experimental schema definition used for feature flagged behaviour. Accepts either a JSON object or a stringified JSON representation. */
+    experimentalSchema?: ExtractInput.ExperimentalSchema;
+    /** (Deprecated) Natural language prompt for schema-guided extraction. Use structuredOutput.schemaPrompt instead. */
+    schemaPrompt?: string;
+    /** (Deprecated) Custom instructions that augment the default extraction behaviour. */
+    customPrompt?: string;
+    /** Comma-separated list of chunking strategies to apply (for example `semantic,header,page,recursive`). */
+    chunking?: string;
+    /** Override for maximum characters per chunk when chunking is enabled. */
+    chunkSize?: number;
+    /** Page range filter supporting segments such as `1-2` or mixed ranges like `1-2,5`. */
+    pages?: string;
+    /** Toggle to enable figure extraction in results. */
+    extractFigure?: boolean;
+    /** Toggle to generate descriptive captions for extracted figures. */
+    figureDescription?: boolean;
+    /** Whether to include HTML representation alongside markdown in the response. */
+    returnHtml?: boolean;
+    /** (Deprecated) Enables expanded rationale output for debugging. */
+    thinking?: boolean;
+    /** Options for persisting extraction artifacts. When enabled (default), artifacts are saved to storage and a database record is created. */
+    storage?: ExtractInput.Storage;
+}
+export declare namespace ExtractInput {
+    /**
+     * Recommended method for schema-guided extraction. Contains the schema and optional prompt in a single object.
+     */
+    interface StructuredOutput {
+        /** JSON schema describing the structured data to extract. */
+        schema?: Record<string, unknown>;
+        /** Natural language prompt with additional extraction instructions. */
+        schemaPrompt?: string;
+    }
+    /**
+     * (Deprecated) JSON schema describing structured data to extract. Use structuredOutput instead. Accepts either a JSON object or a stringified JSON representation.
+     */
+    type Schema = Record<string, unknown> | string;
+    /**
+     * (Deprecated) Experimental schema definition used for feature flagged behaviour. Accepts either a JSON object or a stringified JSON representation.
+     */
+    type ExperimentalSchema = Record<string, unknown> | string;
+    /**
+     * Options for persisting extraction artifacts. When enabled (default), artifacts are saved to storage and a database record is created.
+     */
+    interface Storage {
+        /** Whether to persist extraction artifacts. Set to false for temporary extractions with no storage or database record. */
+        enabled?: boolean;
+        /** Target folder name to save the extraction to. Creates the folder if it doesn't exist. */
+        folderName?: string;
+    }
+}

package/dist/esm/api/types/{MultipartSource.d.mts → ExtractSource.d.mts}

@@ -1,7 +1,7 @@
 /**
  * Document source definition for multipart/form-data requests. Provide exactly one of `file` (direct upload) or `fileUrl` (remote URL).
  */
-export interface MultipartSource {
+export interface ExtractSource {
     /** Document to upload directly. Required unless fileUrl is provided. */
     file?: string;
     /** Public or pre-signed URL that Pulse will download and extract. Required unless file is provided. */

package/dist/esm/api/types/index.d.mts

@@ -1,12 +1,8 @@
-export * from "./ExtractAsyncInput.mjs";
 export * from "./ExtractAsyncResponse.mjs";
 export * from "./ExtractInput.mjs";
-export * from "./ExtractJsonInput.mjs";
-export * from "./ExtractMultipartInput.mjs";
 export * from "./ExtractOptions.mjs";
 export * from "./ExtractResponse.mjs";
+export * from "./ExtractSource.mjs";
 export * from "./JobCancellationResponse.mjs";
 export * from "./JobStatus.mjs";
 export * from "./JobStatusResponse.mjs";
-export * from "./JsonSource.mjs";
-export * from "./MultipartSource.mjs";

package/dist/esm/api/types/index.mjs

@@ -1,12 +1,8 @@
-export * from "./ExtractAsyncInput.mjs";
 export * from "./ExtractAsyncResponse.mjs";
 export * from "./ExtractInput.mjs";
-export * from "./ExtractJsonInput.mjs";
-export * from "./ExtractMultipartInput.mjs";
 export * from "./ExtractOptions.mjs";
 export * from "./ExtractResponse.mjs";
+export * from "./ExtractSource.mjs";
 export * from "./JobCancellationResponse.mjs";
 export * from "./JobStatus.mjs";
 export * from "./JobStatusResponse.mjs";
-export * from "./JsonSource.mjs";
-export * from "./MultipartSource.mjs";

package/dist/esm/core/exports.d.mts

@@ -1 +1,2 @@
+export * from "./file/exports.mjs";
 export * from "./logging/exports.mjs";

package/dist/esm/core/exports.mjs

@@ -1 +1,2 @@
+export * from "./file/exports.mjs";
 export * from "./logging/exports.mjs";

package/dist/esm/core/file/exports.d.mts

@@ -0,0 +1 @@
+export type { Uploadable } from "./types.mjs";

package/dist/esm/core/file/exports.mjs

@@ -0,0 +1 @@
+export {};

package/dist/esm/core/file/file.d.mts

@@ -0,0 +1,10 @@
+import type { Uploadable } from "./types.mjs";
+export declare function toBinaryUploadRequest(file: Uploadable): Promise<{
+    body: Uploadable.FileLike;
+    headers?: Record<string, string>;
+}>;
+export declare function toMultipartDataPart(file: Uploadable): Promise<{
+    data: Uploadable.FileLike;
+    filename?: string;
+    contentType?: string;
+}>;

package/dist/esm/core/file/file.mjs

@@ -0,0 +1,184 @@
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+export function toBinaryUploadRequest(file) {
+    return __awaiter(this, void 0, void 0, function* () {
+        const { data, filename, contentLength, contentType } = yield getFileWithMetadata(file);
+        const request = {
+            body: data,
+            headers: {},
+        };
+        if (filename) {
+            request.headers["Content-Disposition"] = `attachment; filename="${filename}"`;
+        }
+        if (contentType) {
+            request.headers["Content-Type"] = contentType;
+        }
+        if (contentLength != null) {
+            request.headers["Content-Length"] = contentLength.toString();
+        }
+        return request;
+    });
+}
+export function toMultipartDataPart(file) {
+    return __awaiter(this, void 0, void 0, function* () {
+        const { data, filename, contentType } = yield getFileWithMetadata(file, {
+            noSniffFileSize: true,
+        });
+        return {
+            data,
+            filename,
+            contentType,
+        };
+    });
+}
+function getFileWithMetadata(file_1) {
+    return __awaiter(this, arguments, void 0, function* (file, { noSniffFileSize } = {}) {
+        var _a, _b, _c, _d, _e;
+        if (isFileLike(file)) {
+            return getFileWithMetadata({
+                data: file,
+            }, { noSniffFileSize });
+        }
+        if ("path" in file) {
+            const fs = yield import("fs");
+            if (!fs || !fs.createReadStream) {
+                throw new Error("File path uploads are not supported in this environment.");
+            }
+            const data = fs.createReadStream(file.path);
+            const contentLength = (_a = file.contentLength) !== null && _a !== void 0 ? _a : (noSniffFileSize === true ? undefined : yield tryGetFileSizeFromPath(file.path));
+            const filename = (_b = file.filename) !== null && _b !== void 0 ? _b : getNameFromPath(file.path);
+            return {
+                data,
+                filename,
+                contentType: file.contentType,
+                contentLength,
+            };
+        }
+        if ("data" in file) {
+            const data = file.data;
+            const contentLength = (_c = file.contentLength) !== null && _c !== void 0 ? _c : (yield tryGetContentLengthFromFileLike(data, {
+                noSniffFileSize,
+            }));
+            const filename = (_d = file.filename) !== null && _d !== void 0 ? _d : tryGetNameFromFileLike(data);
+            return {
+                data,
+                filename,
+                contentType: (_e = file.contentType) !== null && _e !== void 0 ? _e : tryGetContentTypeFromFileLike(data),
+                contentLength,
+            };
+        }
+        throw new Error(`Invalid FileUpload of type ${typeof file}: ${JSON.stringify(file)}`);
+    });
+}
+function isFileLike(value) {
+    return (isBuffer(value) ||
+        isArrayBufferView(value) ||
+        isArrayBuffer(value) ||
+        isUint8Array(value) ||
+        isBlob(value) ||
+        isFile(value) ||
+        isStreamLike(value) ||
+        isReadableStream(value));
+}
+function tryGetFileSizeFromPath(path) {
+    return __awaiter(this, void 0, void 0, function* () {
+        try {
+            const fs = yield import("fs");
+            if (!fs || !fs.promises || !fs.promises.stat) {
+                return undefined;
+            }
+            const fileStat = yield fs.promises.stat(path);
+            return fileStat.size;
+        }
+        catch (_fallbackError) {
+            return undefined;
+        }
+    });
+}
+function tryGetNameFromFileLike(data) {
+    if (isNamedValue(data)) {
+        return data.name;
+    }
+    if (isPathedValue(data)) {
+        return getNameFromPath(data.path.toString());
+    }
+    return undefined;
+}
+function tryGetContentLengthFromFileLike(data_1) {
+    return __awaiter(this, arguments, void 0, function* (data, { noSniffFileSize } = {}) {
+        if (isBuffer(data)) {
+            return data.length;
+        }
+        if (isArrayBufferView(data)) {
+            return data.byteLength;
+        }
+        if (isArrayBuffer(data)) {
+            return data.byteLength;
+        }
+        if (isBlob(data)) {
+            return data.size;
+        }
+        if (isFile(data)) {
+            return data.size;
+        }
+        if (noSniffFileSize === true) {
+            return undefined;
+        }
+        if (isPathedValue(data)) {
+            return yield tryGetFileSizeFromPath(data.path.toString());
+        }
+        return undefined;
+    });
+}
+function tryGetContentTypeFromFileLike(data) {
+    if (isBlob(data)) {
+        return data.type;
+    }
+    if (isFile(data)) {
+        return data.type;
+    }
+    return undefined;
+}
+function getNameFromPath(path) {
+    const lastForwardSlash = path.lastIndexOf("/");
+    const lastBackSlash = path.lastIndexOf("\\");
+    const lastSlashIndex = Math.max(lastForwardSlash, lastBackSlash);
+    return lastSlashIndex >= 0 ? path.substring(lastSlashIndex + 1) : path;
+}
+function isNamedValue(value) {
+    return typeof value === "object" && value != null && "name" in value;
+}
+function isPathedValue(value) {
+    return typeof value === "object" && value != null && "path" in value;
+}
+function isStreamLike(value) {
+    return typeof value === "object" && value != null && ("read" in value || "pipe" in value);
+}
+function isReadableStream(value) {
+    return typeof value === "object" && value != null && "getReader" in value;
+}
+function isBuffer(value) {
+    return typeof Buffer !== "undefined" && Buffer.isBuffer && Buffer.isBuffer(value);
+}
+function isArrayBufferView(value) {
+    return typeof ArrayBuffer !== "undefined" && ArrayBuffer.isView(value);
+}
+function isArrayBuffer(value) {
+    return typeof ArrayBuffer !== "undefined" && value instanceof ArrayBuffer;
+}
+function isUint8Array(value) {
+    return typeof Uint8Array !== "undefined" && value instanceof Uint8Array;
+}
+function isBlob(value) {
+    return typeof Blob !== "undefined" && value instanceof Blob;
+}
+function isFile(value) {
+    return typeof File !== "undefined" && value instanceof File;
+}

package/dist/esm/core/file/index.d.mts

@@ -0,0 +1,2 @@
+export * from "./file.mjs";
+export * from "./types.mjs";

package/dist/esm/core/file/index.mjs

@@ -0,0 +1,2 @@
+export * from "./file.mjs";
+export * from "./types.mjs";