@edgestore/sdk 1.0.0-next.1 → 1.0.0-next.2

package/dist/managementClient.js

@@ -1,9 +1,9 @@
 import { createManagementAccessClient } from './managementAccess.js';
 import { createManagementResourceClient } from './managementResources.js';
 
-function createManagementClient(transport) {
+function createManagementClient(transport, uploadDefaults) {
     return {
-        ...createManagementResourceClient(transport),
+        ...createManagementResourceClient(transport, uploadDefaults),
         ...createManagementAccessClient(transport),
         whoami: (options)=>transport.execute((client)=>client.GET('/whoami', {
                     signal: options?.signal

package/dist/managementResources.d.ts

@@ -1,5 +1,7 @@
 import type { OperationBody, OperationId, OperationQuery, OperationResult } from './internal/operationTypes.js';
 import type { Transport } from './internal/transport.js';
+import { type ManagementUploadInput, type ManagementUploadResult } from './managementUpload.js';
+import type { UploadDefaults } from './uploadTypes.js';
 type CallOptions = {
     /** Cancels the request. */
     signal?: AbortSignal;
@@ -70,6 +72,8 @@ export type ManagementResourceClient = {
         delete(input: ProjectInput & OperationBody<'v2.management.files.delete'> & CallOptions): Promise<Result<'v2.management.files.delete'>>;
     };
     uploads: {
+        /** Transfers a file and waits for server-side processing to complete. */
+        upload(input: ManagementUploadInput): Promise<ManagementUploadResult>;
         /** Requests signed upload destination(s) without transferring data. */
         request(input: BucketInput & OperationBody<'v2.management.uploads.request'> & CallOptions): Promise<Result<'v2.management.uploads.request'>>;
         /** Gets the current upload and processing state. */
@@ -82,6 +86,6 @@ export type ManagementResourceClient = {
         completeMultipart(input: UploadInput & OperationBody<'v2.management.uploads.multipart.complete'> & CallOptions): Promise<Result<'v2.management.uploads.multipart.complete'>>;
     };
 };
-export declare function createManagementResourceClient(transport: Transport): ManagementResourceClient;
+export declare function createManagementResourceClient(transport: Transport, uploadDefaults?: UploadDefaults): ManagementResourceClient;
 export {};
 //# sourceMappingURL=managementResources.d.ts.map

package/dist/managementResources.d.ts.map

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

package/dist/managementResources.js

@@ -1,4 +1,8 @@
-function createManagementResourceClient(transport) {
+import { createManagementUploadOperations } from './internal/managementUploadOperations.js';
+import { uploadManagementFile } from './managementUpload.js';
+
+function createManagementResourceClient(transport, uploadDefaults = {}) {
+    const uploadOperations = createManagementUploadOperations(transport);
     return {
         projects: {
             list: ({ account, signal })=>transport.execute((client)=>client.GET('/management/accounts/{accountId}/projects', {
@@ -164,54 +168,15 @@ function createManagementResourceClient(transport) {
                     }))
         },
         uploads: {
-            request: ({ project, bucket, signal, ...body })=>transport.execute((client)=>client.POST('/management/projects/{projectRef}/buckets/{bucketName}/uploads', {
-                        params: {
-                            path: {
-                                projectRef: project,
-                                bucketName: bucket
-                            }
-                        },
-                        body,
-                        signal
-                    })),
-            get: ({ project, uploadId, signal })=>transport.execute((client)=>client.GET('/management/projects/{projectRef}/uploads/{uploadId}', {
-                        params: {
-                            path: {
-                                projectRef: project,
-                                uploadId
-                            }
-                        },
-                        signal
-                    })),
-            cancel: ({ project, uploadId, signal })=>transport.execute((client)=>client.DELETE('/management/projects/{projectRef}/uploads/{uploadId}', {
-                        params: {
-                            path: {
-                                projectRef: project,
-                                uploadId
-                            }
-                        },
-                        signal
-                    })),
-            createParts: ({ project, uploadId, signal, ...body })=>transport.execute((client)=>client.POST('/management/projects/{projectRef}/uploads/{uploadId}/parts', {
-                        params: {
-                            path: {
-                                projectRef: project,
-                                uploadId
-                            }
-                        },
-                        body,
-                        signal
-                    })),
-            completeMultipart: ({ project, uploadId, signal, ...body })=>transport.execute((client)=>client.POST('/management/projects/{projectRef}/uploads/{uploadId}/complete', {
-                        params: {
-                            path: {
-                                projectRef: project,
-                                uploadId
-                            }
-                        },
-                        body,
-                        signal
-                    }))
+            upload: (input)=>uploadManagementFile({
+                    transport,
+                    operations: uploadOperations
+                }, input, uploadDefaults),
+            request: uploadOperations.request,
+            get: uploadOperations.get,
+            cancel: uploadOperations.cancel,
+            createParts: uploadOperations.createParts,
+            completeMultipart: uploadOperations.completeMultipart
         }
     };
 }

package/dist/managementUpload.d.ts

@@ -0,0 +1,36 @@
+import type { ManagementUploadOperations } from './internal/managementUploadOperations.js';
+import type { OperationBody, OperationResult } from './internal/operationTypes.js';
+import type { Transport } from './internal/transport.js';
+import type { UploadDefaults, UploadMetadataValue, UploadProgress, UploadSource } from './uploadTypes.js';
+type RequestBody = OperationBody<'v2.management.uploads.request'>;
+type RequestResult = OperationResult<'v2.management.uploads.request'>;
+type GetResult = OperationResult<'v2.management.uploads.get'>;
+type CompletedUpload = Extract<GetResult, {
+    upload: {
+        status: 'completed';
+    };
+}>;
+/** Input for a complete administrative upload managed by the SDK. */
+export type ManagementUploadInput = Omit<RequestBody, 'sizeBytes' | 'metadata' | 'multipart'> & {
+    project: string;
+    bucket: string;
+    source: UploadSource;
+    metadata?: Record<string, UploadMetadataValue>;
+    signal?: AbortSignal;
+    onProgress?: (progress: UploadProgress) => void;
+    multipart?: boolean | {
+        partSizeBytes?: number;
+        concurrency?: number;
+    };
+    processingTimeoutMs?: number;
+};
+/** Completed administrative file upload. */
+export type ManagementUploadResult = CompletedUpload & {
+    signedReadUrl?: RequestResult['signedReadUrl'];
+};
+export declare function uploadManagementFile(context: {
+    transport: Transport;
+    operations: ManagementUploadOperations;
+}, input: ManagementUploadInput, defaults?: UploadDefaults): Promise<ManagementUploadResult>;
+export {};
+//# sourceMappingURL=managementUpload.d.ts.map

package/dist/managementUpload.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"managementUpload.d.ts","sourceRoot":"","sources":["../src/managementUpload.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,uCAAuC,CAAC;AACxF,OAAO,KAAK,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAChF,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AAUtD,OAAO,KAAK,EACV,cAAc,EACd,mBAAmB,EACnB,cAAc,EACd,YAAY,EACb,MAAM,eAAe,CAAC;AAGvB,KAAK,WAAW,GAAG,aAAa,CAAC,+BAA+B,CAAC,CAAC;AAClE,KAAK,aAAa,GAAG,eAAe,CAAC,+BAA+B,CAAC,CAAC;AACtE,KAAK,SAAS,GAAG,eAAe,CAAC,2BAA2B,CAAC,CAAC;AAC9D,KAAK,eAAe,GAAG,OAAO,CAAC,SAAS,EAAE;IAAE,MAAM,EAAE;QAAE,MAAM,EAAE,WAAW,CAAA;KAAE,CAAA;CAAE,CAAC,CAAC;AAE/E,qEAAqE;AACrE,MAAM,MAAM,qBAAqB,GAAG,IAAI,CACtC,WAAW,EACX,WAAW,GAAG,UAAU,GAAG,WAAW,CACvC,GAAG;IACF,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,YAAY,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,mBAAmB,CAAC,CAAC;IAC/C,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,UAAU,CAAC,EAAE,CAAC,QAAQ,EAAE,cAAc,KAAK,IAAI,CAAC;IAChD,SAAS,CAAC,EACN,OAAO,GACP;QACE,aAAa,CAAC,EAAE,MAAM,CAAC;QACvB,WAAW,CAAC,EAAE,MAAM,CAAC;KACtB,CAAC;IACN,mBAAmB,CAAC,EAAE,MAAM,CAAC;CAC9B,CAAC;AAEF,4CAA4C;AAC5C,MAAM,MAAM,sBAAsB,GAAG,eAAe,GAAG;IACrD,aAAa,CAAC,EAAE,aAAa,CAAC,eAAe,CAAC,CAAC;CAChD,CAAC;AAEF,wBAAsB,oBAAoB,CACxC,OAAO,EAAE;IACP,SAAS,EAAE,SAAS,CAAC;IACrB,UAAU,EAAE,0BAA0B,CAAC;CACxC,EACD,KAAK,EAAE,qBAAqB,EAC5B,QAAQ,GAAE,cAAmB,GAC5B,OAAO,CAAC,sBAAsB,CAAC,CAiFjC"}

package/dist/managementUpload.js

@@ -0,0 +1,74 @@
+import { executeUploadLifecycle } from './internal/uploadLifecycle.js';
+import { throwIfAborted } from './internal/uploadRetry.js';
+import { prepareUploadSource, reportUploadProgress, normalizeUploadMetadata } from './internal/uploadSource.js';
+import { assertNonNegative } from './internal/uploadValidation.js';
+import { planMultipartUpload } from './multipartPlan.js';
+import { DEFAULT_PROCESSING_TIMEOUT_MS } from './uploadTypes.js';
+
+async function uploadManagementFile(context, input, defaults = {}) {
+    const { transport, operations } = context;
+    const { project, bucket, source, metadata, signal, onProgress, multipart, processingTimeoutMs = defaults.processingTimeoutMs ?? DEFAULT_PROCESSING_TIMEOUT_MS, ...requestInput } = input;
+    const prepared = prepareUploadSource(source);
+    const totalBytes = prepared.sizeBytes;
+    assertNonNegative(processingTimeoutMs, 'processingTimeoutMs');
+    throwIfAborted(signal);
+    reportUploadProgress(onProgress, {
+        transferredBytes: 0,
+        totalBytes,
+        phase: 'preparing'
+    });
+    const multipartPlan = planMultipartUpload({
+        sizeBytes: totalBytes,
+        thresholdBytes: defaults.multipartThresholdBytes,
+        preferredPartSizeBytes: typeof multipart === 'object' ? multipart.partSizeBytes ?? defaults.multipartPartSizeBytes : defaults.multipartPartSizeBytes,
+        forceMultipart: prepared.kind === 'stream' || multipart === true || typeof multipart === 'object'
+    });
+    const requested = await operations.request({
+        project,
+        bucket,
+        signal,
+        ...requestInput,
+        fileName: requestInput.fileName ?? prepared.fileName,
+        mimeType: requestInput.mimeType ?? prepared.mimeType,
+        sizeBytes: totalBytes,
+        metadata: normalizeUploadMetadata(metadata),
+        multipart: multipartPlan ? {
+            partNumbers: multipartPlan.partNumbers
+        } : undefined
+    });
+    const completed = await executeUploadLifecycle({
+        transport,
+        requested,
+        prepared,
+        multipartPlan,
+        multipartConcurrency: typeof multipart === 'object' ? multipart.concurrency : defaults.multipartConcurrency,
+        defaultMultipartConcurrency: defaults.multipartConcurrency,
+        processingTimeoutMs,
+        signal,
+        onProgress,
+        operations: {
+            completeMultipart: ({ uploadId, parts, signal: requestSignal })=>operations.completeMultipart({
+                    project,
+                    uploadId,
+                    parts,
+                    signal: requestSignal
+                }),
+            get: ({ uploadId, signal: requestSignal })=>operations.getWithResponse({
+                    project,
+                    uploadId,
+                    signal: requestSignal
+                }),
+            cancel: ({ uploadId })=>operations.cancel({
+                    project,
+                    uploadId
+                })
+        },
+        cleanupPolicy: 'report-failure'
+    });
+    return {
+        ...completed,
+        signedReadUrl: requested.signedReadUrl
+    };
+}
+
+export { uploadManagementFile };

package/dist/sdk.js

@@ -13,7 +13,7 @@ function createEdgeStoreSdk(options) {
     const system = createSystemClient(transport);
     return credentials.kind === 'bearer' ? {
         runtime: createExplicitProjectRuntimeClient(transport, options.upload),
-        management: createManagementClient(transport),
+        management: createManagementClient(transport, options.upload),
         system
     } : {
         runtime: createProjectRuntimeClient(transport, options.upload),

package/dist/upload.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"upload.d.ts","sourceRoot":"","sources":["../src/upload.ts"],"names":[],"mappings":"AAOA,OAAO,EAEL,KAAK,iBAAiB,EACvB,MAAM,8BAA8B,CAAC;AACtC,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AActD,OAAO,EAIL,KAAK,yBAAyB,EAC9B,KAAK,kBAAkB,EACvB,KAAK,mBAAmB,EACxB,KAAK,cAAc,EAIpB,MAAM,eAAe,CAAC;AAEvB,KAAK,mBAAmB,GAAG,kBAAkB,GAAG;IAAE,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC;AACpE,KAAK,0BAA0B,GAAG,yBAAyB,GAAG;IAC5D,OAAO,EAAE,MAAM,CAAC;CACjB,CAAC;AAaF,KAAK,aAAa,GAAG;IACnB,SAAS,EAAE,SAAS,CAAC;IACrB,UAAU,EAAE,iBAAiB,CAAC;CAC/B,CAAC;AAEF,wBAAsB,iBAAiB,CACrC,OAAO,EAAE,aAAa,EACtB,KAAK,EAAE,mBAAmB,EAC1B,QAAQ,GAAE,cAAmB,GAC5B,OAAO,CAAC,mBAAmB,CAAC,CA6J9B;AAED,wBAAsB,wBAAwB,CAC5C,OAAO,EAAE,aAAa,EACtB,KAAK,EAAE,0BAA0B,EACjC,QAAQ,GAAE,cAAmB,GAC5B,OAAO,CAAC,mBAAmB,CAAC,CAsE9B"}
+{"version":3,"file":"upload.d.ts","sourceRoot":"","sources":["../src/upload.ts"],"names":[],"mappings":"AACA,OAAO,EAEL,KAAK,iBAAiB,EACvB,MAAM,8BAA8B,CAAC;AACtC,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AAUtD,OAAO,EAEL,KAAK,yBAAyB,EAC9B,KAAK,kBAAkB,EACvB,KAAK,mBAAmB,EACxB,KAAK,cAAc,EAEpB,MAAM,eAAe,CAAC;AAEvB,KAAK,mBAAmB,GAAG,kBAAkB,GAAG;IAAE,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC;AACpE,KAAK,0BAA0B,GAAG,yBAAyB,GAAG;IAC5D,OAAO,EAAE,MAAM,CAAC;CACjB,CAAC;AAEF,KAAK,aAAa,GAAG;IACnB,SAAS,EAAE,SAAS,CAAC;IACrB,UAAU,EAAE,iBAAiB,CAAC;CAC/B,CAAC;AAEF,wBAAsB,iBAAiB,CACrC,OAAO,EAAE,aAAa,EACtB,KAAK,EAAE,mBAAmB,EAC1B,QAAQ,GAAE,cAAmB,GAC5B,OAAO,CAAC,mBAAmB,CAAC,CA2G9B;AAED,wBAAsB,wBAAwB,CAC5C,OAAO,EAAE,aAAa,EACtB,KAAK,EAAE,0BAA0B,EACjC,QAAQ,GAAE,cAAmB,GAC5B,OAAO,CAAC,mBAAmB,CAAC,CAsE9B"}

package/dist/upload.js

@@ -1,20 +1,20 @@
-import { EdgeStoreAbortError, EdgeStoreNetworkError, EdgeStoreUploadProcessingTimeoutError, EdgeStoreUploadCanceledError } from './errors.js';
-import { uploadStreamParts, uploadParts } from './internal/multipartUpload.js';
+import { EdgeStoreAbortError, EdgeStoreNetworkError } from './errors.js';
 import { createGetUploadRequest } from './internal/runtimeOperations.js';
-import { isAbortError, throwIfAborted, retryOperation, getRetryAfterMs, sleep } from './internal/uploadRetry.js';
-import { putWithRetry } from './internal/uploadTransfer.js';
-import { assertNonNegative, getPositiveInteger } from './internal/uploadValidation.js';
+import { executeUploadLifecycle } from './internal/uploadLifecycle.js';
+import { isAbortError, throwIfAborted } from './internal/uploadRetry.js';
+import { prepareUploadSource, reportUploadProgress, normalizeUploadMetadata } from './internal/uploadSource.js';
+import { assertNonNegative } from './internal/uploadValidation.js';
 import { planMultipartUpload } from './multipartPlan.js';
-import { DEFAULT_PROCESSING_TIMEOUT_MS, DEFAULT_MULTIPART_CONCURRENCY } from './uploadTypes.js';
+import { DEFAULT_PROCESSING_TIMEOUT_MS } from './uploadTypes.js';
 
 async function uploadRuntimeFile(context, input, defaults = {}) {
     const { transport, operations } = context;
     const { project, bucket, source, metadata, signal, onProgress, multipart, fileName, mimeType, temporary, path, extension, replaceTarget, signedReadUrl, processingTimeoutMs = defaults.processingTimeoutMs ?? DEFAULT_PROCESSING_TIMEOUT_MS } = input;
-    const prepared = prepareSource(source);
+    const prepared = prepareUploadSource(source);
     const totalBytes = prepared.sizeBytes;
     assertNonNegative(processingTimeoutMs, 'processingTimeoutMs');
     throwIfAborted(signal);
-    reportProgress(onProgress, {
+    reportUploadProgress(onProgress, {
         transferredBytes: 0,
         totalBytes,
         phase: 'preparing'
@@ -42,7 +42,7 @@ async function uploadRuntimeFile(context, input, defaults = {}) {
         temporary,
         path,
         extension,
-        metadata: normalizeMetadata(metadata),
+        metadata: normalizeUploadMetadata(metadata),
         replaceTarget,
         multipart: partNumbers ? {
             partNumbers
@@ -50,77 +50,39 @@ async function uploadRuntimeFile(context, input, defaults = {}) {
         signedReadUrl,
         signal
     });
-    const uploadId = requested.upload.id;
-    try {
-        reportProgress(onProgress, {
-            transferredBytes: 0,
-            totalBytes,
-            phase: 'uploading'
-        });
-        if (prepared.kind === 'body' && requested.upload.kind === 'single') {
-            await putWithRetry(transport, {
-                uploadId,
-                url: requested.upload.signedUrl,
-                body: prepared.body,
-                signal
-            });
-            reportProgress(onProgress, {
-                transferredBytes: totalBytes,
-                totalBytes,
-                phase: 'uploading'
-            });
-        } else {
-            if (requested.upload.kind !== 'multipart') {
-                throw new TypeError('The API returned a single upload URL for a stream source.');
-            }
-            if (!multipartPlan) {
-                throw new TypeError('The API returned a multipart upload for a single-upload request.');
-            }
-            const concurrency = getPositiveInteger(typeof multipart === 'object' ? multipart.concurrency : defaults.multipartConcurrency, defaults.multipartConcurrency ?? DEFAULT_MULTIPART_CONCURRENCY, 'multipart.concurrency');
-            const transferOptions = {
-                uploadId,
-                parts: requested.upload.parts,
-                partSizeBytes: multipartPlan.partSizeBytes,
-                signal,
-                onProgress
-            };
-            const completedParts = prepared.kind === 'stream' ? await uploadStreamParts(transport, {
-                ...transferOptions,
-                stream: prepared.stream,
-                totalBytes
-            }) : await uploadParts(transport, {
-                ...transferOptions,
-                body: prepared.body,
-                concurrency
-            });
-            await operations.uploads.completeMultipart({
-                project,
-                uploadId,
-                parts: completedParts,
-                signal
-            });
-        }
-        reportProgress(onProgress, {
-            transferredBytes: totalBytes,
-            totalBytes,
-            phase: 'processing'
-        });
-        const completed = await waitForUpload(context, {
-            project,
-            uploadId,
-            signal,
-            timeoutMs: processingTimeoutMs
-        });
-        return {
-            ...completed,
-            signedReadUrl: requested.signedReadUrl
-        };
-    } catch (error) {
-        if (!(error instanceof EdgeStoreUploadProcessingTimeoutError)) {
-            await cancelUpload(operations, project, uploadId);
-        }
-        throw error;
-    }
+    const completed = await executeUploadLifecycle({
+        transport,
+        requested,
+        prepared,
+        multipartPlan,
+        multipartConcurrency: typeof multipart === 'object' ? multipart.concurrency : defaults.multipartConcurrency,
+        defaultMultipartConcurrency: defaults.multipartConcurrency,
+        processingTimeoutMs,
+        signal,
+        onProgress,
+        operations: {
+            completeMultipart: ({ uploadId, parts, signal: requestSignal })=>operations.uploads.completeMultipart({
+                    project,
+                    uploadId,
+                    parts,
+                    signal: requestSignal
+                }),
+            get: ({ uploadId, signal: requestSignal })=>context.transport.executeWithResponse(createGetUploadRequest({
+                    project,
+                    uploadId,
+                    signal: requestSignal
+                })),
+            cancel: ({ uploadId })=>operations.uploads.cancel({
+                    project,
+                    uploadId
+                })
+        },
+        cleanupPolicy: 'preserve-original'
+    });
+    return {
+        ...completed,
+        signedReadUrl: requested.signedReadUrl
+    };
 }
 async function uploadRuntimeFileFromUrl(context, input, defaults = {}) {
     const { transport } = context;
@@ -178,115 +140,6 @@ async function cancelResponseBody(body) {
     if (!body) return;
     await body.cancel().catch(()=>undefined);
 }
-async function waitForUpload(context, options) {
-    const deadline = Date.now() + options.timeoutMs;
-    const timeoutError = ()=>new EdgeStoreUploadProcessingTimeoutError('Timed out while EdgeStore was processing the upload.', options.uploadId);
-    while(true){
-        const { data, response } = await retryOperation((signal)=>context.transport.executeWithResponse(createGetUploadRequest({
-                project: options.project,
-                uploadId: options.uploadId,
-                signal
-            })), {
-            signal: options.signal,
-            deadline,
-            timeoutError
-        });
-        if (data.upload.status === 'completed' && 'file' in data) return data;
-        if (data.upload.status === 'canceled') {
-            throw new EdgeStoreUploadCanceledError('The EdgeStore upload was canceled.', options.uploadId);
-        }
-        const delayMs = getRetryAfterMs(response) ?? 1000;
-        if (Date.now() + delayMs > deadline) {
-            throw timeoutError();
-        }
-        await sleep(delayMs, options.signal);
-    }
-}
-async function cancelUpload(operations, project, uploadId) {
-    try {
-        await operations.uploads.cancel({
-            project,
-            uploadId
-        });
-    } catch  {
-    // Preserve the original upload failure.
-    }
-}
-function normalizeMetadata(metadata) {
-    if (!metadata) return undefined;
-    const entries = Object.entries(metadata).flatMap(([key, value])=>value === null || value === undefined ? [] : [
-            [
-                key,
-                String(value)
-            ]
-        ]);
-    return entries.length ? Object.fromEntries(entries) : undefined;
-}
-function prepareSource(source) {
-    if (typeof source === 'string') {
-        const body = new Blob([
-            source
-        ], {
-            type: 'text/plain'
-        });
-        return {
-            kind: 'body',
-            body,
-            sizeBytes: body.size,
-            mimeType: body.type
-        };
-    }
-    if (isStreamSource(source)) {
-        if (!Number.isSafeInteger(source.sizeBytes) || source.sizeBytes < 0) {
-            throw new RangeError('source.sizeBytes must be a non-negative integer.');
-        }
-        return {
-            kind: 'stream',
-            stream: source.stream,
-            sizeBytes: source.sizeBytes
-        };
-    }
-    if (source instanceof Blob) {
-        return {
-            kind: 'body',
-            body: source,
-            sizeBytes: source.size,
-            fileName: 'name' in source && typeof source.name === 'string' ? source.name : undefined,
-            mimeType: source.type || undefined
-        };
-    }
-    if (source instanceof ArrayBuffer) {
-        const body = new Blob([
-            source
-        ]);
-        return {
-            kind: 'body',
-            body,
-            sizeBytes: body.size
-        };
-    }
-    const body = new Blob([
-        Uint8Array.from(new Uint8Array(source.buffer, source.byteOffset, source.byteLength))
-    ]);
-    return {
-        kind: 'body',
-        body,
-        sizeBytes: body.size
-    };
-}
-function isStreamSource(source) {
-    const stream = typeof source === 'object' && source !== null && 'stream' in source ? Reflect.get(source, 'stream') : undefined;
-    return typeof stream === 'object' && stream !== null && 'getReader' in stream && typeof Reflect.get(stream, 'getReader') === 'function';
-}
-function reportProgress(onProgress, progress) {
-    const { transferredBytes, totalBytes, phase } = progress;
-    onProgress?.({
-        transferredBytes,
-        totalBytes,
-        percentage: totalBytes === 0 ? phase === 'preparing' ? 0 : 100 : Math.round(transferredBytes / totalBytes * 10000) / 100,
-        phase
-    });
-}
 function getFileNameFromUrl(url) {
     const name = new URL(url).pathname.split('/').filter(Boolean).at(-1);
     return name ? decodeURIComponent(name) : undefined;

package/dist/version.d.ts

@@ -1,3 +1,3 @@
 export declare const EDGE_STORE_PACKAGE_NAME = "@edgestore/sdk";
-export declare const EDGE_STORE_PACKAGE_VERSION = "1.0.0-next.1";
+export declare const EDGE_STORE_PACKAGE_VERSION = "1.0.0-next.2";
 //# sourceMappingURL=version.d.ts.map

package/dist/version.js

@@ -1,4 +1,4 @@
 const EDGE_STORE_PACKAGE_NAME = '@edgestore/sdk';
-const EDGE_STORE_PACKAGE_VERSION = '1.0.0-next.1';
+const EDGE_STORE_PACKAGE_VERSION = '1.0.0-next.2';
 
 export { EDGE_STORE_PACKAGE_NAME, EDGE_STORE_PACKAGE_VERSION };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@edgestore/sdk",
-  "version": "1.0.0-next.1",
+  "version": "1.0.0-next.2",
   "description": "Official low-level TypeScript SDK for the EdgeStore API",
   "homepage": "https://edgestore.dev",
   "license": "MIT",
@@ -60,7 +60,7 @@
     "build": "pnpm codegen:check && rollup --config rollup.config.ts --configPlugin rollup-plugin-swc3",
     "dev": "pnpm build --watch",
     "codegen:api": "openapi-typescript ./src/generated/openapi-v2.json -o ./src/generated/api-v2.ts --export-type",
-    "codegen:check": "pnpm codegen:api --check",
+    "codegen:check": "openapi-typescript ./src/generated/openapi-v2.json -o ./src/generated/api-v2.ts --export-type --check",
     "codegen:entrypoints": "tsx entrypoints.script.ts",
     "schema:sync": "node ./sync-openapi.mjs",
     "test": "vitest run",

package/src/errors.ts

@@ -43,6 +43,15 @@ export class EdgeStoreNetworkError extends EdgeStoreError {
   }
 }
 
+/** A control-plane request that exceeded the configured deadline. */
+export class EdgeStoreTimeoutError extends EdgeStoreError {
+  override readonly name = 'EdgeStoreTimeoutError';
+
+  constructor(message: string, options?: ErrorOptions) {
+    super(message, options);
+  }
+}
+
 /** A request or upload canceled through an `AbortSignal`. */
 export class EdgeStoreAbortError extends EdgeStoreError {
   override readonly name = 'EdgeStoreAbortError';
@@ -77,6 +86,25 @@ export class EdgeStoreUploadProcessingTimeoutError extends EdgeStoreUploadError
   override readonly name = 'EdgeStoreUploadProcessingTimeoutError';
 }
 
+/** An upload failure whose automatic cancellation also failed. */
+export class EdgeStoreUploadCleanupError extends EdgeStoreUploadError {
+  override readonly name = 'EdgeStoreUploadCleanupError';
+
+  readonly uploadCause: unknown;
+  readonly cleanupCause: unknown;
+
+  constructor(options: {
+    message: string;
+    uploadId: string;
+    uploadCause: unknown;
+    cleanupCause: unknown;
+  }) {
+    super(options.message, options.uploadId, { cause: options.uploadCause });
+    this.uploadCause = options.uploadCause;
+    this.cleanupCause = options.cleanupCause;
+  }
+}
+
 /** Failure returned for a singular file mutation. */
 export class EdgeStoreFileMutationError<
   TFileReference = { id: string } | { key: string } | { url: string },