@mixedbread/sdk 0.56.0 → 0.57.0

package/lib/upload-file.js

@@ -0,0 +1,146 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MultipartUploadError = void 0;
+exports.handleFileCreate = handleFileCreate;
+const api_promise_1 = require("../core/api-promise.js");
+const to_file_1 = require("../internal/to-file.js");
+const uploads_1 = require("../internal/uploads.js");
+const DEFAULT_THRESHOLD = 100 * 1024 * 1024; // 100MB
+const DEFAULT_CONCURRENCY = 5;
+const DEFAULT_PART_SIZE = 100 * 1024 * 1024; // 100MB per part
+const MIN_PART_SIZE = 5 * 1024 * 1024; // 5MB minimum
+const MAX_PART_COUNT = 10000;
+class MultipartUploadError extends Error {
+    constructor(message, uploadId) {
+        super(message);
+        this.name = 'MultipartUploadError';
+        this.uploadId = uploadId;
+    }
+}
+exports.MultipartUploadError = MultipartUploadError;
+function makeResponseProps(response) {
+    return {
+        response,
+        options: {},
+        controller: new AbortController(),
+        requestLogID: '',
+        retryOfRequestLogID: undefined,
+        startTime: Date.now(),
+    };
+}
+function handleFileCreate(client, body, options) {
+    let resolvedData;
+    const responsePromise = (async () => {
+        const { multipartUpload, ...rest } = body;
+        const threshold = multipartUpload?.threshold ?? DEFAULT_THRESHOLD;
+        const concurrency = multipartUpload?.concurrency ?? DEFAULT_CONCURRENCY;
+        const partSize = multipartUpload?.partSize ?? DEFAULT_PART_SIZE;
+        if (partSize < MIN_PART_SIZE) {
+            throw new Error(`partSize must be at least 5MB (${MIN_PART_SIZE} bytes), got ${partSize}`);
+        }
+        if (threshold < MIN_PART_SIZE) {
+            throw new Error(`threshold must be at least 5MB (${MIN_PART_SIZE} bytes), got ${threshold}`);
+        }
+        // Normalize the uploadable to a File object so we can inspect size
+        const file = await (0, to_file_1.toFile)(rest.file);
+        const fileSize = file.size;
+        // Small file: delegate to the standard single-request upload
+        if (fileSize <= threshold) {
+            const apiPromise = client.post('/v1/files', await (0, uploads_1.multipartFormRequestOptions)({ body: { file }, ...options }, client));
+            const { data, response } = await apiPromise.withResponse();
+            resolvedData = data;
+            return makeResponseProps(response);
+        }
+        // Large file: multipart upload flow
+        const partCount = Math.ceil(fileSize / partSize);
+        if (partCount > MAX_PART_COUNT) {
+            throw new Error(`File would require ${partCount} parts, but the maximum is ${MAX_PART_COUNT}. Increase partSize to at least ${Math.ceil(fileSize / MAX_PART_COUNT)} bytes.`);
+        }
+        const filename = file.name || 'unknown_file';
+        const mimeType = file.type || 'application/octet-stream';
+        // Step 1: Initiate multipart upload
+        const uploadResponse = await client.files.uploads.create({
+            filename,
+            file_size: fileSize,
+            mime_type: mimeType,
+            part_count: partCount,
+        });
+        const uploadId = uploadResponse.id;
+        const partUrls = uploadResponse.part_urls;
+        try {
+            // Use the client's configured fetch (respects custom fetch, proxy, TLS settings)
+            const fetchFn = client.fetch;
+            // Step 2: Upload parts with concurrency control
+            const completedParts = await uploadParts(file, partUrls, concurrency, partSize, fileSize, fetchFn, options?.signal, multipartUpload?.onPartUpload);
+            // Step 3: Complete the multipart upload
+            const completePromise = client.files.uploads.complete(uploadId, { parts: completedParts });
+            const { data, response } = await completePromise.withResponse();
+            resolvedData = data;
+            return makeResponseProps(response);
+        }
+        catch (error) {
+            // Attempt to abort on any failure
+            try {
+                await client.files.uploads.abort(uploadId);
+            }
+            catch {
+                // Abort is best-effort; ignore failures
+            }
+            if (error instanceof MultipartUploadError) {
+                throw error;
+            }
+            throw new MultipartUploadError(error instanceof Error ? error.message : String(error), uploadId);
+        }
+    })();
+    return new api_promise_1.APIPromise(client, responsePromise, async () => resolvedData);
+}
+async function uploadParts(file, partUrls, concurrency, partSize, fileSize, fetchFn, signal, onPartUpload) {
+    const results = [];
+    const totalParts = partUrls.length;
+    let uploadedBytes = 0;
+    let nextIndex = 0;
+    async function worker() {
+        while (nextIndex < partUrls.length) {
+            if (signal?.aborted) {
+                throw new Error('Upload aborted');
+            }
+            const index = nextIndex++;
+            const { part_number, url } = partUrls[index];
+            const start = (part_number - 1) * partSize;
+            const end = Math.min(start + partSize, fileSize);
+            const chunkSize = end - start;
+            const blob = file.slice(start, end);
+            const response = await fetchFn(url, {
+                method: 'PUT',
+                body: blob,
+                ...(signal ? { signal } : {}),
+            });
+            if (!response.ok) {
+                throw new Error(`Part ${part_number} upload failed with status ${response.status}`);
+            }
+            const etag = response.headers.get('ETag') || response.headers.get('etag');
+            if (!etag) {
+                throw new Error(`Part ${part_number} response missing ETag header`);
+            }
+            results.push({ part_number, etag });
+            uploadedBytes += chunkSize;
+            onPartUpload?.({
+                partNumber: part_number,
+                totalParts,
+                partSize: chunkSize,
+                uploadedBytes,
+                totalBytes: fileSize,
+            });
+        }
+    }
+    const workerCount = Math.min(concurrency, partUrls.length);
+    const workers = [];
+    for (let i = 0; i < workerCount; i++) {
+        workers.push(worker());
+    }
+    await Promise.all(workers);
+    // Sort by part number for the complete call
+    results.sort((a, b) => a.part_number - b.part_number);
+    return results;
+}
+//# sourceMappingURL=upload-file.js.map

package/lib/upload-file.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"upload-file.js","sourceRoot":"","sources":["../src/lib/upload-file.ts"],"names":[],"mappings":"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"}

package/lib/upload-file.mjs

@@ -0,0 +1,141 @@
+import { APIPromise } from "../core/api-promise.mjs";
+import { toFile } from "../internal/to-file.mjs";
+import { multipartFormRequestOptions } from "../internal/uploads.mjs";
+const DEFAULT_THRESHOLD = 100 * 1024 * 1024; // 100MB
+const DEFAULT_CONCURRENCY = 5;
+const DEFAULT_PART_SIZE = 100 * 1024 * 1024; // 100MB per part
+const MIN_PART_SIZE = 5 * 1024 * 1024; // 5MB minimum
+const MAX_PART_COUNT = 10000;
+export class MultipartUploadError extends Error {
+    constructor(message, uploadId) {
+        super(message);
+        this.name = 'MultipartUploadError';
+        this.uploadId = uploadId;
+    }
+}
+function makeResponseProps(response) {
+    return {
+        response,
+        options: {},
+        controller: new AbortController(),
+        requestLogID: '',
+        retryOfRequestLogID: undefined,
+        startTime: Date.now(),
+    };
+}
+export function handleFileCreate(client, body, options) {
+    let resolvedData;
+    const responsePromise = (async () => {
+        const { multipartUpload, ...rest } = body;
+        const threshold = multipartUpload?.threshold ?? DEFAULT_THRESHOLD;
+        const concurrency = multipartUpload?.concurrency ?? DEFAULT_CONCURRENCY;
+        const partSize = multipartUpload?.partSize ?? DEFAULT_PART_SIZE;
+        if (partSize < MIN_PART_SIZE) {
+            throw new Error(`partSize must be at least 5MB (${MIN_PART_SIZE} bytes), got ${partSize}`);
+        }
+        if (threshold < MIN_PART_SIZE) {
+            throw new Error(`threshold must be at least 5MB (${MIN_PART_SIZE} bytes), got ${threshold}`);
+        }
+        // Normalize the uploadable to a File object so we can inspect size
+        const file = await toFile(rest.file);
+        const fileSize = file.size;
+        // Small file: delegate to the standard single-request upload
+        if (fileSize <= threshold) {
+            const apiPromise = client.post('/v1/files', await multipartFormRequestOptions({ body: { file }, ...options }, client));
+            const { data, response } = await apiPromise.withResponse();
+            resolvedData = data;
+            return makeResponseProps(response);
+        }
+        // Large file: multipart upload flow
+        const partCount = Math.ceil(fileSize / partSize);
+        if (partCount > MAX_PART_COUNT) {
+            throw new Error(`File would require ${partCount} parts, but the maximum is ${MAX_PART_COUNT}. Increase partSize to at least ${Math.ceil(fileSize / MAX_PART_COUNT)} bytes.`);
+        }
+        const filename = file.name || 'unknown_file';
+        const mimeType = file.type || 'application/octet-stream';
+        // Step 1: Initiate multipart upload
+        const uploadResponse = await client.files.uploads.create({
+            filename,
+            file_size: fileSize,
+            mime_type: mimeType,
+            part_count: partCount,
+        });
+        const uploadId = uploadResponse.id;
+        const partUrls = uploadResponse.part_urls;
+        try {
+            // Use the client's configured fetch (respects custom fetch, proxy, TLS settings)
+            const fetchFn = client.fetch;
+            // Step 2: Upload parts with concurrency control
+            const completedParts = await uploadParts(file, partUrls, concurrency, partSize, fileSize, fetchFn, options?.signal, multipartUpload?.onPartUpload);
+            // Step 3: Complete the multipart upload
+            const completePromise = client.files.uploads.complete(uploadId, { parts: completedParts });
+            const { data, response } = await completePromise.withResponse();
+            resolvedData = data;
+            return makeResponseProps(response);
+        }
+        catch (error) {
+            // Attempt to abort on any failure
+            try {
+                await client.files.uploads.abort(uploadId);
+            }
+            catch {
+                // Abort is best-effort; ignore failures
+            }
+            if (error instanceof MultipartUploadError) {
+                throw error;
+            }
+            throw new MultipartUploadError(error instanceof Error ? error.message : String(error), uploadId);
+        }
+    })();
+    return new APIPromise(client, responsePromise, async () => resolvedData);
+}
+async function uploadParts(file, partUrls, concurrency, partSize, fileSize, fetchFn, signal, onPartUpload) {
+    const results = [];
+    const totalParts = partUrls.length;
+    let uploadedBytes = 0;
+    let nextIndex = 0;
+    async function worker() {
+        while (nextIndex < partUrls.length) {
+            if (signal?.aborted) {
+                throw new Error('Upload aborted');
+            }
+            const index = nextIndex++;
+            const { part_number, url } = partUrls[index];
+            const start = (part_number - 1) * partSize;
+            const end = Math.min(start + partSize, fileSize);
+            const chunkSize = end - start;
+            const blob = file.slice(start, end);
+            const response = await fetchFn(url, {
+                method: 'PUT',
+                body: blob,
+                ...(signal ? { signal } : {}),
+            });
+            if (!response.ok) {
+                throw new Error(`Part ${part_number} upload failed with status ${response.status}`);
+            }
+            const etag = response.headers.get('ETag') || response.headers.get('etag');
+            if (!etag) {
+                throw new Error(`Part ${part_number} response missing ETag header`);
+            }
+            results.push({ part_number, etag });
+            uploadedBytes += chunkSize;
+            onPartUpload?.({
+                partNumber: part_number,
+                totalParts,
+                partSize: chunkSize,
+                uploadedBytes,
+                totalBytes: fileSize,
+            });
+        }
+    }
+    const workerCount = Math.min(concurrency, partUrls.length);
+    const workers = [];
+    for (let i = 0; i < workerCount; i++) {
+        workers.push(worker());
+    }
+    await Promise.all(workers);
+    // Sort by part number for the complete call
+    results.sort((a, b) => a.part_number - b.part_number);
+    return results;
+}
+//# sourceMappingURL=upload-file.mjs.map

package/lib/upload-file.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"upload-file.mjs","sourceRoot":"","sources":["../src/lib/upload-file.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mixedbread/sdk",
-  "version": "0.56.0",
+  "version": "0.57.0",
   "description": "The official TypeScript library for the Mixedbread API",
   "author": "Mixedbread <support@mixedbread.com>",
   "types": "./index.d.ts",

package/resources/files/files.d.mts

@@ -0,0 +1,156 @@
+import { APIResource } from "../../core/resource.mjs";
+import * as UploadsAPI from "./uploads.mjs";
+import { MultipartUploadPart, MultipartUploadPartURL, UploadAbortResponse, UploadCompleteParams, UploadCreateParams, UploadCreateResponse, UploadListResponse, UploadRetrieveResponse, Uploads } from "./uploads.mjs";
+import { APIPromise } from "../../core/api-promise.mjs";
+import { Cursor, type CursorParams, PagePromise } from "../../core/pagination.mjs";
+import { type Uploadable } from "../../core/uploads.mjs";
+import { RequestOptions } from "../../internal/request-options.mjs";
+import { type MultipartUploadConfig } from "../../lib/upload-file.mjs";
+export declare class Files extends APIResource {
+    uploads: UploadsAPI.Uploads;
+    /**
+     * Upload a new file.
+     *
+     * Args: file: The file to upload.
+     *
+     * Returns: FileResponse: The response containing the details of the uploaded file.
+     */
+    create(body: FileCreateParams, options?: RequestOptions): APIPromise<FileObject>;
+    /**
+     * Retrieve details of a specific file by its ID.
+     *
+     * Args: file_id: The ID of the file to retrieve.
+     *
+     * Returns: FileResponse: The response containing the file details.
+     */
+    retrieve(fileID: string, options?: RequestOptions): APIPromise<FileObject>;
+    /**
+     * Update the details of a specific file.
+     *
+     * Args: file_id: The ID of the file to update. file: The new details for the file.
+     *
+     * Returns: FileObject: The updated file details.
+     */
+    update(fileID: string, body: FileUpdateParams, options?: RequestOptions): APIPromise<FileObject>;
+    /**
+     * List all files for the authenticated user.
+     *
+     * Args: pagination: The pagination options
+     *
+     * Returns: A list of files belonging to the user.
+     */
+    list(query?: FileListParams | null | undefined, options?: RequestOptions): PagePromise<FileObjectsCursor, FileObject>;
+    /**
+     * Delete a specific file by its ID.
+     *
+     * Args: file_id: The ID of the file to delete.
+     *
+     * Returns: FileDeleted: The response containing the details of the deleted file.
+     */
+    delete(fileID: string, options?: RequestOptions): APIPromise<FileDeleteResponse>;
+    /**
+     * Download a specific file by its ID.
+     *
+     * Args: file_id: The ID of the file to download.
+     *
+     * Returns: FileStreamResponse: The response containing the file to be downloaded.
+     */
+    content(fileID: string, options?: RequestOptions): APIPromise<Response>;
+}
+export type FileObjectsCursor = Cursor<FileObject>;
+/**
+ * A model representing a file object in the system.
+ *
+ * This model contains metadata about files stored in the system, including
+ * identifiers, size information, and timestamps.
+ */
+export interface FileObject {
+    /**
+     * Unique identifier for the file
+     */
+    id: string;
+    /**
+     * Name of the file including extension
+     */
+    filename: string;
+    /**
+     * Size of the file in bytes
+     */
+    bytes: number;
+    /**
+     * MIME type of the file
+     */
+    mime_type: string;
+    /**
+     * Version of the file
+     */
+    version: number;
+    /**
+     * Timestamp when the file was created
+     */
+    created_at: string;
+    /**
+     * Timestamp when the file was last updated
+     */
+    updated_at: string;
+}
+/**
+ * Pagination model that includes total count of items.
+ */
+export interface PaginationWithTotal {
+    /**
+     * Maximum number of items to return per page
+     */
+    limit?: number;
+    /**
+     * Offset of the first item to return
+     */
+    offset?: number;
+    /**
+     * Total number of items available
+     */
+    total?: number;
+}
+export interface FileDeleteResponse {
+    /**
+     * The ID of the deleted file
+     */
+    id: string;
+    /**
+     * Whether the file was deleted
+     */
+    deleted?: boolean;
+    /**
+     * The type of the deleted object
+     */
+    object?: 'file';
+}
+export interface FileCreateParams {
+    /**
+     * The file to upload
+     */
+    file: Uploadable;
+    /**
+     * Optional configuration for automatic multipart uploads.
+     * When the file size exceeds the threshold (default 100MB), the SDK
+     * will automatically use multipart upload with presigned URLs.
+     */
+    multipartUpload?: MultipartUploadConfig;
+}
+export interface FileUpdateParams {
+    /**
+     * The file to update
+     */
+    file: Uploadable;
+}
+export interface FileListParams extends CursorParams {
+    /**
+     * Search query for fuzzy matching over name and description fields
+     */
+    q?: string | null;
+}
+export declare namespace Files {
+    export { type FileObject as FileObject, type PaginationWithTotal as PaginationWithTotal, type FileDeleteResponse as FileDeleteResponse, type FileObjectsCursor as FileObjectsCursor, type FileCreateParams as FileCreateParams, type FileUpdateParams as FileUpdateParams, type FileListParams as FileListParams, };
+    export { Uploads as Uploads, type MultipartUploadPart as MultipartUploadPart, type MultipartUploadPartURL as MultipartUploadPartURL, type UploadCreateResponse as UploadCreateResponse, type UploadRetrieveResponse as UploadRetrieveResponse, type UploadListResponse as UploadListResponse, type UploadAbortResponse as UploadAbortResponse, type UploadCreateParams as UploadCreateParams, type UploadCompleteParams as UploadCompleteParams, };
+}
+//# sourceMappingURL=files.d.mts.map

package/resources/files/files.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"files.d.mts","sourceRoot":"","sources":["../../src/resources/files/files.ts"],"names":[],"mappings":"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"}

package/resources/files/files.d.ts

@@ -0,0 +1,156 @@
+import { APIResource } from "../../core/resource.js";
+import * as UploadsAPI from "./uploads.js";
+import { MultipartUploadPart, MultipartUploadPartURL, UploadAbortResponse, UploadCompleteParams, UploadCreateParams, UploadCreateResponse, UploadListResponse, UploadRetrieveResponse, Uploads } from "./uploads.js";
+import { APIPromise } from "../../core/api-promise.js";
+import { Cursor, type CursorParams, PagePromise } from "../../core/pagination.js";
+import { type Uploadable } from "../../core/uploads.js";
+import { RequestOptions } from "../../internal/request-options.js";
+import { type MultipartUploadConfig } from "../../lib/upload-file.js";
+export declare class Files extends APIResource {
+    uploads: UploadsAPI.Uploads;
+    /**
+     * Upload a new file.
+     *
+     * Args: file: The file to upload.
+     *
+     * Returns: FileResponse: The response containing the details of the uploaded file.
+     */
+    create(body: FileCreateParams, options?: RequestOptions): APIPromise<FileObject>;
+    /**
+     * Retrieve details of a specific file by its ID.
+     *
+     * Args: file_id: The ID of the file to retrieve.
+     *
+     * Returns: FileResponse: The response containing the file details.
+     */
+    retrieve(fileID: string, options?: RequestOptions): APIPromise<FileObject>;
+    /**
+     * Update the details of a specific file.
+     *
+     * Args: file_id: The ID of the file to update. file: The new details for the file.
+     *
+     * Returns: FileObject: The updated file details.
+     */
+    update(fileID: string, body: FileUpdateParams, options?: RequestOptions): APIPromise<FileObject>;
+    /**
+     * List all files for the authenticated user.
+     *
+     * Args: pagination: The pagination options
+     *
+     * Returns: A list of files belonging to the user.
+     */
+    list(query?: FileListParams | null | undefined, options?: RequestOptions): PagePromise<FileObjectsCursor, FileObject>;
+    /**
+     * Delete a specific file by its ID.
+     *
+     * Args: file_id: The ID of the file to delete.
+     *
+     * Returns: FileDeleted: The response containing the details of the deleted file.
+     */
+    delete(fileID: string, options?: RequestOptions): APIPromise<FileDeleteResponse>;
+    /**
+     * Download a specific file by its ID.
+     *
+     * Args: file_id: The ID of the file to download.
+     *
+     * Returns: FileStreamResponse: The response containing the file to be downloaded.
+     */
+    content(fileID: string, options?: RequestOptions): APIPromise<Response>;
+}
+export type FileObjectsCursor = Cursor<FileObject>;
+/**
+ * A model representing a file object in the system.
+ *
+ * This model contains metadata about files stored in the system, including
+ * identifiers, size information, and timestamps.
+ */
+export interface FileObject {
+    /**
+     * Unique identifier for the file
+     */
+    id: string;
+    /**
+     * Name of the file including extension
+     */
+    filename: string;
+    /**
+     * Size of the file in bytes
+     */
+    bytes: number;
+    /**
+     * MIME type of the file
+     */
+    mime_type: string;
+    /**
+     * Version of the file
+     */
+    version: number;
+    /**
+     * Timestamp when the file was created
+     */
+    created_at: string;
+    /**
+     * Timestamp when the file was last updated
+     */
+    updated_at: string;
+}
+/**
+ * Pagination model that includes total count of items.
+ */
+export interface PaginationWithTotal {
+    /**
+     * Maximum number of items to return per page
+     */
+    limit?: number;
+    /**
+     * Offset of the first item to return
+     */
+    offset?: number;
+    /**
+     * Total number of items available
+     */
+    total?: number;
+}
+export interface FileDeleteResponse {
+    /**
+     * The ID of the deleted file
+     */
+    id: string;
+    /**
+     * Whether the file was deleted
+     */
+    deleted?: boolean;
+    /**
+     * The type of the deleted object
+     */
+    object?: 'file';
+}
+export interface FileCreateParams {
+    /**
+     * The file to upload
+     */
+    file: Uploadable;
+    /**
+     * Optional configuration for automatic multipart uploads.
+     * When the file size exceeds the threshold (default 100MB), the SDK
+     * will automatically use multipart upload with presigned URLs.
+     */
+    multipartUpload?: MultipartUploadConfig;
+}
+export interface FileUpdateParams {
+    /**
+     * The file to update
+     */
+    file: Uploadable;
+}
+export interface FileListParams extends CursorParams {
+    /**
+     * Search query for fuzzy matching over name and description fields
+     */
+    q?: string | null;
+}
+export declare namespace Files {
+    export { type FileObject as FileObject, type PaginationWithTotal as PaginationWithTotal, type FileDeleteResponse as FileDeleteResponse, type FileObjectsCursor as FileObjectsCursor, type FileCreateParams as FileCreateParams, type FileUpdateParams as FileUpdateParams, type FileListParams as FileListParams, };
+    export { Uploads as Uploads, type MultipartUploadPart as MultipartUploadPart, type MultipartUploadPartURL as MultipartUploadPartURL, type UploadCreateResponse as UploadCreateResponse, type UploadRetrieveResponse as UploadRetrieveResponse, type UploadListResponse as UploadListResponse, type UploadAbortResponse as UploadAbortResponse, type UploadCreateParams as UploadCreateParams, type UploadCompleteParams as UploadCompleteParams, };
+}
+//# sourceMappingURL=files.d.ts.map

package/resources/files/files.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"files.d.ts","sourceRoot":"","sources":["../../src/resources/files/files.ts"],"names":[],"mappings":"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"}