@chrt-inc/typescript-sdk 0.252.0 → 0.271.0

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

@@ -0,0 +1,4 @@
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+export {};

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

@@ -0,0 +1,11 @@
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+import * as Chrt from "../index.mjs";
+export interface TrackingCargoByDeviceDataPointMetadata1 {
+    device_id: string;
+    cargo_id: string;
+    task_group_id: string;
+    outlier?: boolean | null;
+    outlier_labeller?: Chrt.OutlierLabellerEnum | null;
+}

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

@@ -0,0 +1,4 @@
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+export {};

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

@@ -1,8 +1,11 @@
 /**
  * This file was auto-generated by Fern from our API Definition.
  */
+import * as Chrt from "../index.mjs";
 export interface TrackingCargoByDriverDataPointMetadata1 {
     driver_id: string;
     cargo_id: string;
     task_group_id: string;
+    outlier?: boolean | null;
+    outlier_labeller?: Chrt.OutlierLabellerEnum | null;
 }

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

@@ -1,9 +1,9 @@
 /**
  * This file was auto-generated by Fern from our API Definition.
  */
-export type TrackingDeviceTypeEnum1 = "D15N" | "MTB06" | "T3-D";
+export type TrackingDeviceTypeEnum1 = "D15N-tag" | "MTB06-label" | "T3-D-tag";
 export declare const TrackingDeviceTypeEnum1: {
-    readonly D15N: "D15N";
-    readonly Mtb06: "MTB06";
-    readonly T3D: "T3-D";
+    readonly D15NTag: "D15N-tag";
+    readonly Mtb06Label: "MTB06-label";
+    readonly T3DTag: "T3-D-tag";
 };

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

@@ -2,7 +2,7 @@
  * This file was auto-generated by Fern from our API Definition.
  */
 export const TrackingDeviceTypeEnum1 = {
-    D15N: "D15N",
-    Mtb06: "MTB06",
-    T3D: "T3-D",
+    D15NTag: "D15N-tag",
+    Mtb06Label: "MTB06-label",
+    T3DTag: "T3-D-tag",
 };

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

@@ -1,6 +1,9 @@
 /**
  * This file was auto-generated by Fern from our API Definition.
  */
+import * as Chrt from "../index.mjs";
 export interface TrackingSessionByDeviceDataPointMetadata1 {
     session_id: string;
+    outlier?: boolean | null;
+    outlier_labeller?: Chrt.OutlierLabellerEnum | null;
 }

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

@@ -1,7 +1,10 @@
 /**
  * This file was auto-generated by Fern from our API Definition.
  */
+import * as Chrt from "../index.mjs";
 export interface TrackingTaskGroupByDriverDataPointMetadata1 {
     driver_id: string;
     task_group_id: string;
+    outlier?: boolean | null;
+    outlier_labeller?: Chrt.OutlierLabellerEnum | null;
 }

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

@@ -20,6 +20,7 @@ export * from "./DecodedJwtWithOrgAndUserId.mjs";
 export * from "./Device1.mjs";
 export * from "./Driver1.mjs";
 export * from "./DriverStatusEnum.mjs";
+export * from "./DriverUpdateResp.mjs";
 export * from "./Expense1.mjs";
 export * from "./GenerateInvoiceRes.mjs";
 export * from "./GeometryCollectionInputGeometriesItem.mjs";
@@ -33,9 +34,8 @@ export * from "./LineItem1.mjs";
 export * from "./LineItemClientCreate1.mjs";
 export * from "./LineItemEnum1.mjs";
 export * from "./LineString.mjs";
-export * from "./LocationFeatureInputGeometry.mjs";
+export * from "./Geometry.mjs";
 export * from "./LocationFeature.mjs";
-export * from "./LocationFeatureOutputGeometry.mjs";
 export * from "./LocationProperties.mjs";
 export * from "./Milestone1.mjs";
 export * from "./MilestoneClientCreate1.mjs";
@@ -57,6 +57,7 @@ export * from "./OrderStatusEnum1.mjs";
 export * from "./OrgMemberDetails.mjs";
 export * from "./OrgMembersAndDrivers.mjs";
 export * from "./OrgPublicData2.mjs";
+export * from "./OutlierLabellerEnum.mjs";
 export * from "./PaymentPreviewResponse.mjs";
 export * from "./PayoutStatusEnum.mjs";
 export * from "./Point.mjs";
@@ -65,6 +66,9 @@ export * from "./Position2D.mjs";
 export * from "./Position3D.mjs";
 export * from "./PriceNameEnum.mjs";
 export * from "./RouteTypeEnum1.mjs";
+export * from "./Session1.mjs";
+export * from "./SessionByDeviceDeleteResponse1.mjs";
+export * from "./SessionByDeviceMarkOutliersResponse1.mjs";
 export * from "./ShipperContactInfo1.mjs";
 export * from "./ShipperContactInfoClientCreate1.mjs";
 export * from "./ShipperNotificationEventEnum.mjs";
@@ -93,6 +97,8 @@ export * from "./TaskGroupsExpandedRes.mjs";
 export * from "./TaskWithDetails.mjs";
 export * from "./TemplateRes.mjs";
 export * from "./TimezoneResponse.mjs";
+export * from "./TrackingCargoByDeviceDataPoint1.mjs";
+export * from "./TrackingCargoByDeviceDataPointMetadata1.mjs";
 export * from "./TrackingCargoByDriverDataPoint1.mjs";
 export * from "./TrackingCargoByDriverDataPointMetadata1.mjs";
 export * from "./TrackingDeviceTypeEnum1.mjs";

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

@@ -20,6 +20,7 @@ export * from "./DecodedJwtWithOrgAndUserId.mjs";
 export * from "./Device1.mjs";
 export * from "./Driver1.mjs";
 export * from "./DriverStatusEnum.mjs";
+export * from "./DriverUpdateResp.mjs";
 export * from "./Expense1.mjs";
 export * from "./GenerateInvoiceRes.mjs";
 export * from "./GeometryCollectionInputGeometriesItem.mjs";
@@ -33,9 +34,8 @@ export * from "./LineItem1.mjs";
 export * from "./LineItemClientCreate1.mjs";
 export * from "./LineItemEnum1.mjs";
 export * from "./LineString.mjs";
-export * from "./LocationFeatureInputGeometry.mjs";
+export * from "./Geometry.mjs";
 export * from "./LocationFeature.mjs";
-export * from "./LocationFeatureOutputGeometry.mjs";
 export * from "./LocationProperties.mjs";
 export * from "./Milestone1.mjs";
 export * from "./MilestoneClientCreate1.mjs";
@@ -57,6 +57,7 @@ export * from "./OrderStatusEnum1.mjs";
 export * from "./OrgMemberDetails.mjs";
 export * from "./OrgMembersAndDrivers.mjs";
 export * from "./OrgPublicData2.mjs";
+export * from "./OutlierLabellerEnum.mjs";
 export * from "./PaymentPreviewResponse.mjs";
 export * from "./PayoutStatusEnum.mjs";
 export * from "./Point.mjs";
@@ -65,6 +66,9 @@ export * from "./Position2D.mjs";
 export * from "./Position3D.mjs";
 export * from "./PriceNameEnum.mjs";
 export * from "./RouteTypeEnum1.mjs";
+export * from "./Session1.mjs";
+export * from "./SessionByDeviceDeleteResponse1.mjs";
+export * from "./SessionByDeviceMarkOutliersResponse1.mjs";
 export * from "./ShipperContactInfo1.mjs";
 export * from "./ShipperContactInfoClientCreate1.mjs";
 export * from "./ShipperNotificationEventEnum.mjs";
@@ -93,6 +97,8 @@ export * from "./TaskGroupsExpandedRes.mjs";
 export * from "./TaskWithDetails.mjs";
 export * from "./TemplateRes.mjs";
 export * from "./TimezoneResponse.mjs";
+export * from "./TrackingCargoByDeviceDataPoint1.mjs";
+export * from "./TrackingCargoByDeviceDataPointMetadata1.mjs";
 export * from "./TrackingCargoByDriverDataPoint1.mjs";
 export * from "./TrackingCargoByDriverDataPointMetadata1.mjs";
 export * from "./TrackingDeviceTypeEnum1.mjs";

package/dist/esm/core/auth/AuthProvider.d.mts

@@ -0,0 +1,4 @@
+import { AuthRequest } from "./AuthRequest.mjs";
+export interface AuthProvider {
+    getAuthRequest(): Promise<AuthRequest>;
+}

package/dist/esm/core/auth/AuthProvider.mjs

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

package/dist/esm/core/auth/AuthRequest.d.mts

@@ -0,0 +1,9 @@
+/**
+ * Request parameters for authentication requests.
+ */
+export interface AuthRequest {
+    /**
+     * The headers to be included in the request.
+     */
+    headers: Record<string, string>;
+}

package/dist/esm/core/auth/AuthRequest.mjs

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

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

@@ -1,2 +1,4 @@
+export { AuthProvider } from "./AuthProvider.mjs";
+export { type AuthRequest } from "./AuthRequest.mjs";
 export { BasicAuth } from "./BasicAuth.mjs";
 export { BearerToken } from "./BearerToken.mjs";

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

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

package/dist/esm/core/exports.mjs

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

package/dist/esm/core/fetcher/Fetcher.d.mts

@@ -6,8 +6,8 @@ export declare namespace Fetcher {
         url: string;
         method: string;
         contentType?: string;
-        headers?: Record<string, string | Supplier<string | undefined> | undefined>;
-        queryParameters?: Record<string, string | string[] | object | object[] | null>;
+        headers?: Record<string, string | Supplier<string | null | undefined> | null | undefined>;
+        queryParameters?: Record<string, unknown>;
         body?: unknown;
         timeoutMs?: number;
         maxRetries?: number;

package/dist/esm/core/fetcher/Fetcher.mjs

@@ -8,15 +8,15 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
     });
 };
 import { toJson } from "../json.mjs";
-import { abortRawResponse, toRawResponse, unknownRawResponse } from "./RawResponse.mjs";
-import { Supplier } from "./Supplier.mjs";
 import { createRequestUrl } from "./createRequestUrl.mjs";
 import { getErrorResponseBody } from "./getErrorResponseBody.mjs";
 import { getFetchFn } from "./getFetchFn.mjs";
 import { getRequestBody } from "./getRequestBody.mjs";
 import { getResponseBody } from "./getResponseBody.mjs";
 import { makeRequest } from "./makeRequest.mjs";
+import { abortRawResponse, toRawResponse, unknownRawResponse } from "./RawResponse.mjs";
 import { requestWithRetries } from "./requestWithRetries.mjs";
+import { Supplier } from "./Supplier.mjs";
 function getHeaders(args) {
     return __awaiter(this, void 0, void 0, function* () {
         const newHeaders = {};

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

@@ -1,9 +1,9 @@
 export type { APIResponse } from "./APIResponse.mjs";
-export { fetcher } from "./Fetcher.mjs";
+export type { BinaryResponse } from "./BinaryResponse.mjs";
 export type { Fetcher, FetchFunction } from "./Fetcher.mjs";
+export { fetcher } from "./Fetcher.mjs";
 export { getHeader } from "./getHeader.mjs";
-export { Supplier } from "./Supplier.mjs";
-export { abortRawResponse, toRawResponse, unknownRawResponse } from "./RawResponse.mjs";
-export type { RawResponse, WithRawResponse } from "./RawResponse.mjs";
 export { HttpResponsePromise } from "./HttpResponsePromise.mjs";
-export { BinaryResponse } from "./BinaryResponse.mjs";
+export type { RawResponse, WithRawResponse } from "./RawResponse.mjs";
+export { abortRawResponse, toRawResponse, unknownRawResponse } from "./RawResponse.mjs";
+export { Supplier } from "./Supplier.mjs";

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

@@ -1,5 +1,5 @@
 export { fetcher } from "./Fetcher.mjs";
 export { getHeader } from "./getHeader.mjs";
-export { Supplier } from "./Supplier.mjs";
-export { abortRawResponse, toRawResponse, unknownRawResponse } from "./RawResponse.mjs";
 export { HttpResponsePromise } from "./HttpResponsePromise.mjs";
+export { abortRawResponse, toRawResponse, unknownRawResponse } from "./RawResponse.mjs";
+export { Supplier } from "./Supplier.mjs";

package/dist/esm/core/fetcher/requestWithRetries.mjs

@@ -11,21 +11,57 @@ const INITIAL_RETRY_DELAY = 1000; // in milliseconds
 const MAX_RETRY_DELAY = 60000; // in milliseconds
 const DEFAULT_MAX_RETRIES = 2;
 const JITTER_FACTOR = 0.2; // 20% random jitter
-function addJitter(delay) {
-    // Generate a random value between -JITTER_FACTOR and +JITTER_FACTOR
-    const jitterMultiplier = 1 + (Math.random() * 2 - 1) * JITTER_FACTOR;
+function addPositiveJitter(delay) {
+    // Generate a random value between 0 and +JITTER_FACTOR
+    const jitterMultiplier = 1 + Math.random() * JITTER_FACTOR;
     return delay * jitterMultiplier;
 }
+function addSymmetricJitter(delay) {
+    // Generate a random value in a JITTER_FACTOR-sized percentage range around delay
+    const jitterMultiplier = 1 + (Math.random() - 0.5) * JITTER_FACTOR;
+    return delay * jitterMultiplier;
+}
+function getRetryDelayFromHeaders(response, retryAttempt) {
+    // Check for Retry-After header first (RFC 7231), with no jitter
+    const retryAfter = response.headers.get("Retry-After");
+    if (retryAfter) {
+        // Parse as number of seconds...
+        const retryAfterSeconds = parseInt(retryAfter, 10);
+        if (!isNaN(retryAfterSeconds) && retryAfterSeconds > 0) {
+            return Math.min(retryAfterSeconds * 1000, MAX_RETRY_DELAY);
+        }
+        // ...or as an HTTP date; both are valid
+        const retryAfterDate = new Date(retryAfter);
+        if (!isNaN(retryAfterDate.getTime())) {
+            const delay = retryAfterDate.getTime() - Date.now();
+            if (delay > 0) {
+                return Math.min(Math.max(delay, 0), MAX_RETRY_DELAY);
+            }
+        }
+    }
+    // Then check for industry-standard X-RateLimit-Reset header, with positive jitter
+    const rateLimitReset = response.headers.get("X-RateLimit-Reset");
+    if (rateLimitReset) {
+        const resetTime = parseInt(rateLimitReset, 10);
+        if (!isNaN(resetTime)) {
+            // Assume Unix timestamp in epoch seconds
+            const delay = resetTime * 1000 - Date.now();
+            if (delay > 0) {
+                return addPositiveJitter(Math.min(delay, MAX_RETRY_DELAY));
+            }
+        }
+    }
+    // Fall back to exponential backoff, with symmetric jitter
+    return addSymmetricJitter(Math.min(INITIAL_RETRY_DELAY * Math.pow(2, retryAttempt), MAX_RETRY_DELAY));
+}
 export function requestWithRetries(requestFn_1) {
     return __awaiter(this, arguments, void 0, function* (requestFn, maxRetries = DEFAULT_MAX_RETRIES) {
         let response = yield requestFn();
         for (let i = 0; i < maxRetries; ++i) {
             if ([408, 429].includes(response.status) || response.status >= 500) {
-                // Calculate base delay using exponential backoff (in milliseconds)
-                const baseDelay = Math.min(INITIAL_RETRY_DELAY * Math.pow(2, i), MAX_RETRY_DELAY);
-                // Add jitter to the delay
-                const delayWithJitter = addJitter(baseDelay);
-                yield new Promise((resolve) => setTimeout(resolve, delayWithJitter));
+                // Get delay with appropriate jitter applied
+                const delay = getRetryDelayFromHeaders(response, i);
+                yield new Promise((resolve) => setTimeout(resolve, delay));
                 response = yield requestFn();
             }
             else {

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

@@ -0,0 +1 @@
+export { 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,5 @@
+import { Uploadable } from "./types.mjs";
+export declare function toBinaryUploadRequest(file: Uploadable): Promise<{
+    body: Uploadable.FileLike;
+    headers?: Record<string, string>;
+}>;

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

@@ -0,0 +1,167 @@
+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;
+    });
+}
+function getFileWithMetadata(file) {
+    return __awaiter(this, void 0, void 0, function* () {
+        var _a, _b, _c, _d, _e;
+        if (isFileLike(file)) {
+            return getFileWithMetadata({
+                data: file,
+            });
+        }
+        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 : (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));
+            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) {
+    return __awaiter(this, void 0, void 0, function* () {
+        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 (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";

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

@@ -0,0 +1,66 @@
+/**
+ * A file that can be uploaded. Can be a file-like object (stream, buffer, blob, etc.),
+ * a path to a file, or an object with a file-like object and metadata.
+ */
+export type Uploadable = Uploadable.FileLike | Uploadable.FromPath | Uploadable.WithMetadata;
+export declare namespace Uploadable {
+    /**
+     * Various file-like objects that can be used to upload a file.
+     */
+    type FileLike = ArrayBuffer | ArrayBufferLike | ArrayBufferView | Uint8Array | import("buffer").Buffer | import("buffer").Blob | import("buffer").File | import("stream").Readable | import("stream/web").ReadableStream | globalThis.Blob | globalThis.File | ReadableStream;
+    /**
+     * A file path with optional metadata, used for uploading a file from the file system.
+     */
+    type FromPath = {
+        /** The path to the file to upload */
+        path: string;
+        /**
+         * Optional override for the file name (defaults to basename of path).
+         * This is used to set the `Content-Disposition` header in upload requests.
+         */
+        filename?: string;
+        /**
+         * Optional MIME type of the file (e.g., 'image/jpeg', 'text/plain').
+         * This is used to set the `Content-Type` header in upload requests.
+         */
+        contentType?: string;
+        /**
+         * Optional file size in bytes.
+         * If not provided, the file size will be determined from the file system.
+         * The content length is used to set the `Content-Length` header in upload requests.
+         */
+        contentLength?: number;
+    };
+    /**
+     * A file-like object with metadata, used for uploading files.
+     */
+    type WithMetadata = {
+        /** The file data */
+        data: FileLike;
+        /**
+         * Optional override for the file name (defaults to basename of path).
+         * This is used to set the `Content-Disposition` header in upload requests.
+         */
+        filename?: string;
+        /**
+         * Optional MIME type of the file (e.g., 'image/jpeg', 'text/plain').
+         * This is used to set the `Content-Type` header in upload requests.
+         *
+         * If not provided, the content type may be determined from the data itself.
+         * * If the data is a `File`, `Blob`, or similar, the content type will be determined from the file itself, if the type is set.
+         * * Any other data type will not have a content type set, and the upload request will use `Content-Type: application/octet-stream` instead.
+         */
+        contentType?: string;
+        /**
+         * Optional file size in bytes.
+         * The content length is used to set the `Content-Length` header in upload requests.
+         * If the content length is not provided and cannot be determined, the upload request will not include the `Content-Length` header, but will use `Transfer-Encoding: chunked` instead.
+         *
+         * If not provided, the file size will be determined depending on the data type.
+         * * If the data is of type `fs.ReadStream` (`createReadStream`), the size will be determined from the file system.
+         * * If the data is a `Buffer`, `ArrayBuffer`, `Uint8Array`, `Blob`, `File`, or similar, the size will be determined from the data itself.
+         * * If the data is a `Readable` or `ReadableStream`, the size will not be determined.
+         */
+        contentLength?: number;
+    };
+}

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

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

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

@@ -1,3 +1,3 @@
 import * as core from "./index.mjs";
-export declare function mergeHeaders(...headersArray: (Record<string, string | core.Supplier<string | undefined> | undefined> | undefined)[]): Record<string, string | core.Supplier<string | undefined>>;
-export declare function mergeOnlyDefinedHeaders(...headersArray: (Record<string, string | core.Supplier<string | undefined> | undefined> | undefined)[]): Record<string, string | core.Supplier<string | undefined>>;
+export declare function mergeHeaders(...headersArray: (Record<string, string | core.Supplier<string | null | undefined> | null | undefined> | null | undefined)[]): Record<string, string | core.Supplier<string | null | undefined>>;
+export declare function mergeOnlyDefinedHeaders(...headersArray: (Record<string, string | core.Supplier<string | null | undefined> | null | undefined> | null | undefined)[]): Record<string, string | core.Supplier<string | null | undefined>>;

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

@@ -4,4 +4,4 @@ export * as url from "./url/index.mjs";
 export * from "./auth/index.mjs";
 export * from "./base64.mjs";
 export * from "./form-data-utils/index.mjs";
-export * from "./file.mjs";
+export * as file from "./file/index.mjs";

package/dist/esm/core/index.mjs

@@ -4,4 +4,4 @@ export * as url from "./url/index.mjs";
 export * from "./auth/index.mjs";
 export * from "./base64.mjs";
 export * from "./form-data-utils/index.mjs";
-export * from "./file.mjs";
+export * as file from "./file/index.mjs";

package/dist/esm/exports.d.mts

@@ -0,0 +1 @@
+export * from "./core/exports.mjs";

package/dist/esm/exports.mjs

@@ -0,0 +1 @@
+export * from "./core/exports.mjs";

package/dist/esm/index.d.mts

@@ -2,3 +2,4 @@ export * as Chrt from "./api/index.mjs";
 export { ChrtError, ChrtTimeoutError } from "./errors/index.mjs";
 export { ChrtClient } from "./Client.mjs";
 export { ChrtEnvironment } from "./environments.mjs";
+export * from "./exports.mjs";

package/dist/esm/index.mjs

@@ -2,3 +2,4 @@ export * as Chrt from "./api/index.mjs";
 export { ChrtError, ChrtTimeoutError } from "./errors/index.mjs";
 export { ChrtClient } from "./Client.mjs";
 export { ChrtEnvironment } from "./environments.mjs";
+export * from "./exports.mjs";

package/dist/esm/version.d.mts

@@ -1 +1 @@
-export declare const SDK_VERSION = "0.252.0";
+export declare const SDK_VERSION = "0.271.0";

package/dist/esm/version.mjs

@@ -1 +1 @@
-export const SDK_VERSION = "0.252.0";
+export const SDK_VERSION = "0.271.0";