@nestm/storage 0.1.0-alpha.2 → 0.1.0-alpha.20

package/dist/storage-etag.js

@@ -0,0 +1,31 @@
+/** Maximum UTF-8 byte length of a normalized storage ETag. */
+export const MAX_STORAGE_ETAG_BYTES = 1024;
+// Deliberately narrower than RFC 9110's etagc grammar. Commas and backslashes
+// are excluded so a normalized value cannot be confused with an entity-tag
+// list or be interpreted differently by legacy HTTP implementations.
+const canonicalStorageEtag = /^(?!\*$)(?![Ww]\/)[\x21\x23-\x2B\x2D-\x5B\x5D-\x7E]+$/u;
+/** Returns whether a value is the package's canonical bare ETag form. */
+export function isCanonicalStorageEtag(value) {
+    return (typeof value === 'string' &&
+        value.length <= MAX_STORAGE_ETAG_BYTES &&
+        canonicalStorageEtag.test(value));
+}
+/**
+ * Normalizes one provider-returned strong entity tag to the canonical bare
+ * form. Providers may return either the HTTP-quoted representation or an
+ * already-normalized value; lists, weak tags, and malformed values fail.
+ */
+export function normalizeProviderStorageEtag(value) {
+    if (typeof value !== 'string') {
+        return undefined;
+    }
+    const opaque = value.startsWith('"') && value.endsWith('"') && value.length >= 3
+        ? value.slice(1, -1)
+        : value;
+    return isCanonicalStorageEtag(opaque) ? opaque : undefined;
+}
+/** Serializes one canonical bare ETag as exactly one HTTP entity tag. */
+export function storageEtagHeader(value) {
+    return isCanonicalStorageEtag(value) ? `"${value}"` : undefined;
+}
+//# sourceMappingURL=storage-etag.js.map

package/dist/storage-etag.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"storage-etag.js","sourceRoot":"","sources":["../src/storage-etag.ts"],"names":[],"mappings":"AAAA,8DAA8D;AAC9D,MAAM,CAAC,MAAM,sBAAsB,GAAG,IAAI,CAAC;AAE3C,8EAA8E;AAC9E,2EAA2E;AAC3E,qEAAqE;AACrE,MAAM,oBAAoB,GACxB,wDAAwD,CAAC;AAE3D,yEAAyE;AACzE,MAAM,UAAU,sBAAsB,CAAC,KAAc;IACnD,OAAO,CACL,OAAO,KAAK,KAAK,QAAQ;QACzB,KAAK,CAAC,MAAM,IAAI,sBAAsB;QACtC,oBAAoB,CAAC,IAAI,CAAC,KAAK,CAAC,CACjC,CAAC;AACJ,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,4BAA4B,CAC1C,KAAc;IAEd,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC9B,OAAO,SAAS,CAAC;IACnB,CAAC;IACD,MAAM,MAAM,GACV,KAAK,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,KAAK,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,KAAK,CAAC,MAAM,IAAI,CAAC;QAC/D,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;QACpB,CAAC,CAAC,KAAK,CAAC;IACZ,OAAO,sBAAsB,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC;AAC7D,CAAC;AAED,yEAAyE;AACzE,MAAM,UAAU,iBAAiB,CAAC,KAAc;IAC9C,OAAO,sBAAsB,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,KAAK,GAAG,CAAC,CAAC,CAAC,SAAS,CAAC;AAClE,CAAC","sourcesContent":["/** Maximum UTF-8 byte length of a normalized storage ETag. */\nexport const MAX_STORAGE_ETAG_BYTES = 1024;\n\n// Deliberately narrower than RFC 9110's etagc grammar. Commas and backslashes\n// are excluded so a normalized value cannot be confused with an entity-tag\n// list or be interpreted differently by legacy HTTP implementations.\nconst canonicalStorageEtag =\n  /^(?!\\*$)(?![Ww]\\/)[\\x21\\x23-\\x2B\\x2D-\\x5B\\x5D-\\x7E]+$/u;\n\n/** Returns whether a value is the package's canonical bare ETag form. */\nexport function isCanonicalStorageEtag(value: unknown): value is string {\n  return (\n    typeof value === 'string' &&\n    value.length <= MAX_STORAGE_ETAG_BYTES &&\n    canonicalStorageEtag.test(value)\n  );\n}\n\n/**\n * Normalizes one provider-returned strong entity tag to the canonical bare\n * form. Providers may return either the HTTP-quoted representation or an\n * already-normalized value; lists, weak tags, and malformed values fail.\n */\nexport function normalizeProviderStorageEtag(\n  value: unknown,\n): string | undefined {\n  if (typeof value !== 'string') {\n    return undefined;\n  }\n  const opaque =\n    value.startsWith('\"') && value.endsWith('\"') && value.length >= 3\n      ? value.slice(1, -1)\n      : value;\n  return isCanonicalStorageEtag(opaque) ? opaque : undefined;\n}\n\n/** Serializes one canonical bare ETag as exactly one HTTP entity tag. */\nexport function storageEtagHeader(value: unknown): string | undefined {\n  return isCanonicalStorageEtag(value) ? `\"${value}\"` : undefined;\n}\n"]}

package/dist/storage-upload-control.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"storage-upload-control.d.ts","sourceRoot":"","sources":["../src/storage-upload-control.ts"],"names":[],"mappings":"AAIA,MAAM,MAAM,mBAAmB,GAC7B,MAAM,GAAG,WAAW,GAAG,QAAQ,GAAG,WAAW,GAAG,SAAS,GAAG,OAAO,CAAC;AAEtE;;;GAGG;AACH,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,OAAO,EAAE,CAAC,CAAC;IACpB,QAAQ,CAAC,MAAM,EAAE,0BAA0B,CAAC;IAC5C,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;CAC3B;AAkHD,qBAAa,oBAAoB;;IAK/B,MAAM,CAAC,IAAI,CAAC,KAAK,EAAE,OAAO,GAAG,oBAAoB;IAmBjD,IAAI,MAAM,IAAI,mBAAmB,CAEhC;IAED,IAAI,MAAM,IAAI,MAAM,CAEnB;IAED,IAAI,KAAK,IAAI,MAAM,GAAG,SAAS,CAE9B;IAED,KAAK,IAAI,IAAI;IAIb,MAAM,IAAI,IAAI;IAId,KAAK,CAAC,MAAM,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;IAItC,MAAM,IAAI,qBAAqB,GAAG,SAAS;CAY5C"}
+{"version":3,"file":"storage-upload-control.d.ts","sourceRoot":"","sources":["../src/storage-upload-control.ts"],"names":[],"mappings":"AAIA,MAAM,MAAM,mBAAmB,GAC7B,MAAM,GAAG,WAAW,GAAG,QAAQ,GAAG,WAAW,GAAG,SAAS,GAAG,OAAO,CAAC;AAEtE;;;GAGG;AACH,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,OAAO,EAAE,CAAC,CAAC;IACpB,QAAQ,CAAC,MAAM,EAAE,0BAA0B,CAAC;IAC5C,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;CAC3B;AAkHD,qBAAa,oBAAoB;IAC/B,cAEC;IAED,MAAM,CAAC,IAAI,CAAC,KAAK,EAAE,OAAO,GAAG,oBAAoB,CAiBhD;IAED,IAAI,MAAM,IAAI,mBAAmB,CAEhC;IAED,IAAI,MAAM,IAAI,MAAM,CAEnB;IAED,IAAI,KAAK,IAAI,MAAM,GAAG,SAAS,CAE9B;IAED,KAAK,IAAI,IAAI,CAEZ;IAED,MAAM,IAAI,IAAI,CAEb;IAED,KAAK,CAAC,MAAM,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAErC;IAED,MAAM,IAAI,qBAAqB,GAAG,SAAS,CAW1C;CACF"}

package/dist/storage.client.d.ts

@@ -1,21 +1,26 @@
 import type { StorageDriver } from './storage.driver.js';
-import type { StorageBody, StorageBufferedDownloadOptions, StorageBulkOptions, StorageCapabilities, StorageDeleteManyResult, StorageDownloadManyResult, StorageDownloadOptions, StorageExistsManyResult, StorageHeadManyResult, StorageListOptions, StorageListResult, StorageObject, StorageObjectMetadata, StorageOperationOptions, StoragePlugin, StorageSearchOptions, StorageSignedDownloadOptions, StorageSignedUpload, StorageSignedUploadOptions, StorageUploadManyItem, StorageUploadManyOptions, StorageUploadManyResult, StorageUploadOptions, StorageUploadResult } from './storage.types.js';
+import type { StorageBody, StorageBufferedDownloadOptions, StorageBulkOptions, StorageCapabilities, StorageConditionalDeleteOptions, StorageConditionalReadOptions, StorageConditionalUploadOptions, StorageDeleteManyResult, StorageDownloadManyResult, StorageDownloadOptions, StorageExistsManyResult, StorageHeadManyResult, StorageListOptions, StorageListResult, StorageObject, StorageObjectMetadata, StorageOperationOptions, StoragePlugin, StoragePromotionOptions, StorageSearchOptions, StorageSignedDownloadOptions, StorageSignedUpload, StorageSignedUploadOptions, StorageUploadManyItem, StorageUploadManyOptions, StorageUploadManyResult, StorageUploadOptions, StorageUploadResult } from './storage.types.js';
 export declare const DEFAULT_BUFFER_LIMIT: number;
 type BulkOperationOptions = StorageBulkOptions & StorageOperationOptions;
 type DownloadManyOptions = StorageBulkOptions & StorageDownloadOptions;
 export interface StorageFileHandle {
     readonly key: string;
     upload(body: StorageBody, options?: StorageUploadOptions): Promise<StorageUploadResult>;
+    uploadConditional(body: StorageBody, options: StorageConditionalUploadOptions): Promise<StorageUploadResult>;
     download(options?: StorageDownloadOptions): Promise<StorageObject>;
+    downloadConditional(options: StorageConditionalReadOptions): Promise<StorageObject>;
     bytes(options?: StorageBufferedDownloadOptions): Promise<Uint8Array>;
     text(options?: StorageBufferedDownloadOptions): Promise<string>;
     head(options?: StorageOperationOptions): Promise<StorageObjectMetadata>;
     exists(options?: StorageOperationOptions): Promise<boolean>;
     delete(options?: StorageOperationOptions): Promise<void>;
+    deleteConditional(options: StorageConditionalDeleteOptions): Promise<void>;
     signDownload(options?: StorageSignedDownloadOptions): Promise<string>;
     signUpload(options: StorageSignedUploadOptions): Promise<StorageSignedUpload>;
     copyTo(destinationKey: string, options?: StorageOperationOptions): Promise<void>;
     moveTo(destinationKey: string, options?: StorageOperationOptions): Promise<void>;
+    /** Conditionally copies this staged object and deliberately retains it. */
+    promoteTo(destinationKey: string, options: StoragePromotionOptions): Promise<void>;
 }
 export declare class StorageClient {
     #private;
@@ -25,15 +30,23 @@ export declare class StorageClient {
     get capabilities(): Readonly<StorageCapabilities>;
     file(key: string): StorageFileHandle;
     upload(key: string, body: StorageBody, options?: StorageUploadOptions): Promise<StorageUploadResult>;
+    uploadConditional(key: string, body: StorageBody, options: StorageConditionalUploadOptions): Promise<StorageUploadResult>;
     downloadStream(key: string, options?: StorageDownloadOptions): Promise<StorageObject>;
+    downloadConditional(key: string, options: StorageConditionalReadOptions): Promise<StorageObject>;
     downloadBytes(key: string, options?: StorageBufferedDownloadOptions): Promise<Uint8Array>;
     downloadText(key: string, options?: StorageBufferedDownloadOptions): Promise<string>;
     downloadJson<Result = unknown>(key: string, options?: StorageBufferedDownloadOptions): Promise<Result>;
     head(key: string, options?: StorageOperationOptions): Promise<StorageObjectMetadata>;
     exists(key: string, options?: StorageOperationOptions): Promise<boolean>;
     delete(key: string, options?: StorageOperationOptions): Promise<void>;
+    deleteConditional(key: string, options: StorageConditionalDeleteOptions): Promise<void>;
     copy(sourceKey: string, destinationKey: string, options?: StorageOperationOptions): Promise<void>;
     move(sourceKey: string, destinationKey: string, options?: StorageOperationOptions): Promise<void>;
+    /**
+     * Conditionally copies a staged object to a final key. This operation does
+     * not delete the source; delete it after the application commit succeeds.
+     */
+    promote(sourceKey: string, destinationKey: string, options: StoragePromotionOptions): Promise<void>;
     list(options?: StorageListOptions): Promise<StorageListResult>;
     listAll(options?: StorageListOptions): AsyncGenerator<StorageObjectMetadata, void>;
     search(pattern: string | RegExp, options?: StorageSearchOptions): AsyncIterable<StorageObjectMetadata>;

package/dist/storage.client.d.ts.map

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

package/dist/storage.client.js

@@ -1,4 +1,5 @@
 import { settleMany } from './internal/settle-many.js';
+import { isCanonicalStorageEtag } from './storage-etag.js';
 import { StorageError, StorageErrorCode, normalizeStorageError, } from './storage.error.js';
 export const DEFAULT_BUFFER_LIMIT = 10 * 1024 * 1024;
 function assertKey(key, label = 'key') {
@@ -146,27 +147,116 @@ export class StorageClient {
         return {
             copyTo: (destinationKey, options) => this.copy(key, destinationKey, options),
             delete: (options) => this.delete(key, options),
+            deleteConditional: (options) => this.deleteConditional(key, options),
             download: (options) => this.downloadStream(key, options),
+            downloadConditional: (options) => this.downloadConditional(key, options),
             exists: (options) => this.exists(key, options),
             head: (options) => this.head(key, options),
             key,
             moveTo: (destinationKey, options) => this.move(key, destinationKey, options),
+            promoteTo: (destinationKey, options) => this.promote(key, destinationKey, options),
             signDownload: (options) => this.signDownload(key, options),
             signUpload: (options) => this.signUpload(key, options),
             bytes: (options) => this.downloadBytes(key, options),
             text: (options) => this.downloadText(key, options),
             upload: (body, options) => this.upload(key, body, options),
+            uploadConditional: (body, options) => this.uploadConditional(key, body, options),
         };
     }
     upload(key, body, options) {
         assertKey(key);
         return this.#execute({ key, operation: 'upload', store: this.name }, () => this.#driver.upload(key, body, options));
     }
+    uploadConditional(key, body, options) {
+        assertKey(key);
+        const condition = options.condition;
+        if (condition === undefined ||
+            (condition.type !== 'create' && condition.type !== 'replace')) {
+            invalidArgument('condition.type must be "create" or "replace".');
+        }
+        if (condition.type === 'replace' &&
+            !isCanonicalStorageEtag(condition.etag)) {
+            invalidArgument('condition.etag must be a canonical storage ETag.');
+        }
+        const capability = condition.type === 'create'
+            ? this.#driver.capabilities.conditionalCreate
+            : this.#driver.capabilities.conditionalReplace;
+        const uploadConditional = this.#driver.uploadConditional;
+        const multipartRequested = options.multipart !== undefined && options.multipart !== false;
+        const multipartCapability = this.#driver.capabilities.conditionalMultipartCompletion;
+        const multipartSupported = !multipartRequested ||
+            (condition.type === 'create'
+                ? multipartCapability?.create === true
+                : multipartCapability?.replace === true);
+        if (capability === undefined ||
+            !multipartSupported ||
+            uploadConditional === undefined) {
+            throw new StorageError(`Store "${this.name}" does not support the requested conditional upload.`, {
+                code: StorageErrorCode.NOT_SUPPORTED,
+                key,
+                operation: 'upload',
+                permanent: true,
+                store: this.name,
+            });
+        }
+        return this.#execute({ key, operation: 'upload', store: this.name }, () => uploadConditional.call(this.#driver, key, body, options), (result) => {
+            if (capability.resultEtag && !isCanonicalStorageEtag(result.etag)) {
+                throw new StorageError(`Store "${this.name}" committed a conditional upload without the advertised result ETag.`, {
+                    code: StorageErrorCode.PROVIDER,
+                    key,
+                    operation: 'upload',
+                    permanent: true,
+                    store: this.name,
+                });
+            }
+            return {
+                ...(isCanonicalStorageEtag(result.etag) && {
+                    appliedEtag: result.etag,
+                }),
+            };
+        });
+    }
     downloadStream(key, options) {
         assertKey(key);
         assertDownloadOptions(options);
         return this.#execute({ key, operation: 'download', store: this.name }, () => this.#driver.download(key, options));
     }
+    downloadConditional(key, options) {
+        assertKey(key);
+        assertDownloadOptions(options);
+        if (options === undefined ||
+            options.condition === undefined ||
+            typeof options.condition !== 'object' ||
+            options.condition === null) {
+            invalidArgument('conditional read requires a condition object.');
+        }
+        const { etag, version } = options.condition;
+        if (etag !== undefined && !isCanonicalStorageEtag(etag)) {
+            invalidArgument('condition.etag must be a canonical storage ETag.');
+        }
+        if (version !== undefined &&
+            (typeof version !== 'string' || version.length === 0)) {
+            invalidArgument('condition.version must be a non-empty string.');
+        }
+        if (etag === undefined && version === undefined) {
+            invalidArgument('conditional read requires an etag, version, or both.');
+        }
+        const capability = this.#driver.capabilities.conditionalRead;
+        const downloadConditional = this.#driver.downloadConditional;
+        if (downloadConditional === undefined ||
+            capability === undefined ||
+            (etag !== undefined && !capability.etag) ||
+            (version !== undefined && !capability.version)) {
+            throw new StorageError(`Store "${this.name}" does not support the requested conditional read.`, {
+                code: StorageErrorCode.NOT_SUPPORTED,
+                key,
+                operation: 'download',
+                permanent: true,
+                store: this.name,
+            });
+        }
+        return this.#execute({ key, operation: 'download', store: this.name }, () => downloadConditional.call(this.#driver, key, options));
+    }
     async downloadBytes(key, options) {
         const { maxBytes = DEFAULT_BUFFER_LIMIT, ...download } = options ?? {};
         const object = await this.downloadStream(key, download);
@@ -203,6 +293,25 @@ export class StorageClient {
         assertKey(key);
         return this.#execute({ key, operation: 'delete', store: this.name }, () => this.#driver.delete(key, options));
     }
+    deleteConditional(key, options) {
+        assertKey(key);
+        if (options.condition === undefined ||
+            !isCanonicalStorageEtag(options.condition.etag)) {
+            invalidArgument('condition.etag must be a canonical storage ETag.');
+        }
+        const capability = this.#driver.capabilities.conditionalDelete;
+        const deleteConditional = this.#driver.deleteConditional;
+        if (capability?.etag !== true || deleteConditional === undefined) {
+            throw new StorageError(`Store "${this.name}" does not support conditional delete.`, {
+                code: StorageErrorCode.NOT_SUPPORTED,
+                key,
+                operation: 'delete',
+                permanent: true,
+                store: this.name,
+            });
+        }
+        return this.#execute({ key, operation: 'delete', store: this.name }, () => deleteConditional.call(this.#driver, key, options), () => ({}));
+    }
     copy(sourceKey, destinationKey, options) {
         assertKey(sourceKey, 'source key');
         assertKey(destinationKey, 'destination key');
@@ -223,6 +332,73 @@ export class StorageClient {
             to: destinationKey,
         }, () => this.#driver.move(sourceKey, destinationKey, options));
     }
+    /**
+     * Conditionally copies a staged object to a final key. This operation does
+     * not delete the source; delete it after the application commit succeeds.
+     */
+    promote(sourceKey, destinationKey, options) {
+        assertKey(sourceKey, 'source key');
+        assertKey(destinationKey, 'destination key');
+        const sourceEtag = options.sourceEtag;
+        const sourceVersion = options.sourceVersion;
+        if (sourceEtag !== undefined && !isCanonicalStorageEtag(sourceEtag)) {
+            invalidArgument('sourceEtag must be a canonical storage ETag.');
+        }
+        if (sourceVersion !== undefined &&
+            (typeof sourceVersion !== 'string' || sourceVersion.length === 0)) {
+            invalidArgument('sourceVersion must be a non-empty string.');
+        }
+        const destination = options.destination;
+        if (destination !== undefined &&
+            (typeof destination !== 'object' ||
+                destination === null ||
+                (destination.type !== 'create' && destination.type !== 'replace'))) {
+            invalidArgument('destination.type must be "create" or "replace".');
+        }
+        if (sourceEtag === undefined &&
+            sourceVersion === undefined &&
+            destination === undefined) {
+            invalidArgument('promote requires a source or destination precondition.');
+        }
+        if (destination?.type === 'replace' &&
+            !isCanonicalStorageEtag(destination.etag)) {
+            invalidArgument('destination.etag must be a canonical storage ETag.');
+        }
+        const sourceCapability = this.#driver.capabilities.conditionalCopySource;
+        const destinationCapability = this.#driver.capabilities.conditionalCopyDestination;
+        const promote = this.#driver.promote;
+        const hasSourcePredicate = sourceEtag !== undefined || sourceVersion !== undefined;
+        if (promote === undefined ||
+            (sourceEtag !== undefined && sourceCapability?.etag !== true) ||
+            (sourceVersion !== undefined && sourceCapability?.version !== true) ||
+            (hasSourcePredicate &&
+                destination === undefined &&
+                sourceCapability?.requiresDestinationPredicate === true) ||
+            (destination?.type === 'create' &&
+                destinationCapability?.create !== true) ||
+            (destination?.type === 'replace' &&
+                destinationCapability?.replace !== true) ||
+            (destination !== undefined &&
+                !hasSourcePredicate &&
+                destinationCapability?.requiresSourcePredicate === true) ||
+            (destination !== undefined &&
+                hasSourcePredicate &&
+                destinationCapability?.atomicWithSource !== true)) {
+            throw new StorageError(`Store "${this.name}" does not support the requested conditional promotion.`, {
+                code: StorageErrorCode.NOT_SUPPORTED,
+                key: sourceKey,
+                operation: 'promote',
+                permanent: true,
+                store: this.name,
+            });
+        }
+        return this.#execute({
+            from: sourceKey,
+            operation: 'promote',
+            store: this.name,
+            to: destinationKey,
+        }, () => promote.call(this.#driver, sourceKey, destinationKey, options), () => ({}));
+    }
     list(options) {
         assertListOptions(options);
         return this.#execute({ operation: 'list', store: this.name }, () => this.#driver.list(options));
@@ -363,23 +539,49 @@ export class StorageClient {
         this.#closed = true;
         await this.#driver.close?.();
     }
-    async #execute(context, operation) {
+    async #execute(context, operation, appliedMutation) {
+        let appliedSettlement;
         try {
             for (const plugin of this.#plugins) {
                 await plugin.beforeOperation?.(context);
             }
             const result = await operation();
+            if (appliedMutation !== undefined) {
+                // Settle before describing the result so even an unexpected local
+                // result-validation failure cannot turn a committed mutation into a
+                // safe-to-retry error.
+                appliedSettlement = {};
+                appliedSettlement = appliedMutation(result);
+            }
             for (const plugin of this.#plugins) {
                 await plugin.afterOperation?.(context, result);
             }
             return result;
         }
         catch (error) {
-            const normalized = normalizeStorageError(error, {
+            let normalized = normalizeStorageError(error, {
                 ...(context.key !== undefined && { key: context.key }),
                 operation: context.operation,
                 store: this.name,
             });
+            if (appliedSettlement !== undefined) {
+                normalized = new StorageError(normalized.message, {
+                    aborted: normalized.aborted,
+                    applied: true,
+                    ...(isCanonicalStorageEtag(appliedSettlement.appliedEtag) && {
+                        appliedEtag: appliedSettlement.appliedEtag,
+                    }),
+                    cause: normalized.cause,
+                    code: normalized.code,
+                    ...(normalized.key !== undefined && { key: normalized.key }),
+                    ...(normalized.operation !== undefined && {
+                        operation: normalized.operation,
+                    }),
+                    permanent: normalized.permanent,
+                    ...(normalized.store !== undefined && { store: normalized.store }),
+                    timedOut: normalized.timedOut,
+                });
+            }
             for (const plugin of this.#plugins) {
                 try {
                     await plugin.onError?.(context, normalized);

package/dist/storage.client.js.map

@@ -1 +1 @@
-{"version":3,"file":"storage.client.js","sourceRoot":"","sources":["../src/storage.client.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAC;AACvD,OAAO,EACL,YAAY,EACZ,gBAAgB,EAChB,qBAAqB,GACtB,MAAM,oBAAoB,CAAC;AA8B5B,MAAM,CAAC,MAAM,oBAAoB,GAAG,EAAE,GAAG,IAAI,GAAG,IAAI,CAAC;AAKrD,SAAS,SAAS,CAAC,GAAW,EAAE,KAAK,GAAG,KAAK;IAC3C,IAAI,OAAO,GAAG,KAAK,QAAQ,IAAI,GAAG,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAChD,MAAM,IAAI,YAAY,CAAC,GAAG,KAAK,8BAA8B,EAAE;YAC7D,IAAI,EAAE,gBAAgB,CAAC,gBAAgB;YACvC,SAAS,EAAE,IAAI;SAChB,CAAC,CAAC;IACL,CAAC;AACH,CAAC;AAED,SAAS,eAAe,CAAC,OAAe;IACtC,MAAM,IAAI,YAAY,CAAC,OAAO,EAAE;QAC9B,IAAI,EAAE,gBAAgB,CAAC,gBAAgB;QACvC,SAAS,EAAE,IAAI;KAChB,CAAC,CAAC;AACL,CAAC;AAED,SAAS,yBAAyB,CAChC,KAAyB,EACzB,KAAa;IAEb,IAAI,KAAK,KAAK,SAAS,IAAI,CAAC,CAAC,MAAM,CAAC,aAAa,CAAC,KAAK,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC,EAAE,CAAC;QACxE,eAAe,CAAC,GAAG,KAAK,mCAAmC,CAAC,CAAC;IAC/D,CAAC;AACH,CAAC;AAED,SAAS,qBAAqB,CAAC,OAAgC;IAC7D,MAAM,KAAK,GAAG,OAAO,EAAE,KAAK,CAAC;IAC7B,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;QACxB,OAAO;IACT,CAAC;IACD,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,KAAK,GAAG,CAAC,EAAE,CAAC;QAC1D,eAAe,CAAC,kDAAkD,CAAC,CAAC;IACtE,CAAC;IACD,IACE,KAAK,CAAC,GAAG,KAAK,SAAS;QACvB,CAAC,CAAC,MAAM,CAAC,aAAa,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,KAAK,CAAC,GAAG,GAAG,KAAK,CAAC,KAAK,CAAC,EAC7D,CAAC;QACD,eAAe,CACb,wEAAwE,CACzE,CAAC;IACJ,CAAC;AACH,CAAC;AAED,SAAS,iBAAiB,CAAC,OAA4B;IACrD,IAAI,OAAO,EAAE,SAAS,KAAK,SAAS,IAAI,OAAO,CAAC,SAAS,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACvE,eAAe,CAAC,uCAAuC,CAAC,CAAC;IAC3D,CAAC;IACD,yBAAyB,CAAC,OAAO,EAAE,KAAK,EAAE,OAAO,CAAC,CAAC;AACrD,CAAC;AAED,SAAS,mBAAmB,CAAC,OAA8B;IACzD,yBAAyB,CAAC,OAAO,EAAE,KAAK,EAAE,OAAO,CAAC,CAAC;IACnD,yBAAyB,CAAC,OAAO,EAAE,UAAU,EAAE,YAAY,CAAC,CAAC;AAC/D,CAAC;AAED,SAAS,yBAAyB,CAAC,OAAmC;IACpE,yBAAyB,CAAC,OAAO,CAAC,SAAS,EAAE,WAAW,CAAC,CAAC;IAC1D,yBAAyB,CAAC,OAAO,CAAC,OAAO,EAAE,SAAS,CAAC,CAAC;IACtD,IACE,OAAO,CAAC,OAAO,KAAK,SAAS;QAC7B,CAAC,CAAC,MAAM,CAAC,aAAa,CAAC,OAAO,CAAC,OAAO,CAAC,IAAI,OAAO,CAAC,OAAO,GAAG,CAAC,CAAC,EAC/D,CAAC;QACD,eAAe,CAAC,8CAA8C,CAAC,CAAC;IAClE,CAAC;IACD,IACE,OAAO,CAAC,OAAO,KAAK,SAAS;QAC7B,OAAO,CAAC,OAAO,KAAK,SAAS;QAC7B,OAAO,CAAC,OAAO,GAAG,OAAO,CAAC,OAAO,EACjC,CAAC;QACD,eAAe,CAAC,yCAAyC,CAAC,CAAC;IAC7D,CAAC;AACH,CAAC;AAED,SAAS,gBAAgB,CACvB,OAA8B;IAE9B,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;QAC1B,OAAO,SAAS,CAAC;IACnB,CAAC;IACD,OAAO;QACL,GAAG,CAAC,OAAO,CAAC,OAAO,KAAK,SAAS,IAAI,EAAE,OAAO,EAAE,OAAO,CAAC,OAAO,EAAE,CAAC;QAClE,GAAG,CAAC,OAAO,CAAC,MAAM,KAAK,SAAS,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,CAAC;QAC/D,GAAG,CAAC,OAAO,CAAC,OAAO,KAAK,SAAS,IAAI,EAAE,OAAO,EAAE,OAAO,CAAC,OAAO,EAAE,CAAC;KACnE,CAAC;AACJ,CAAC;AAED,SAAS,eAAe,CACtB,OAA6B;IAE7B,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;QAC1B,OAAO,SAAS,CAAC;IACnB,CAAC;IACD,OAAO;QACL,GAAG,gBAAgB,CAAC,OAAO,CAAC;QAC5B,GAAG,CAAC,OAAO,CAAC,KAAK,KAAK,SAAS,IAAI,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,EAAE,CAAC;KAC7D,CAAC;AACJ,CAAC;AAED,KAAK,UAAU,WAAW,CACxB,MAAqB,EACrB,QAAgB;IAEhB,IAAI,QAAQ,KAAK,QAAQ,IAAI,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,QAAQ,GAAG,CAAC,CAAC,EAAE,CAAC;QAC1E,MAAM,MAAM,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;QAClD,MAAM,IAAI,YAAY,CACpB,4DAA4D,EAC5D;YACE,IAAI,EAAE,gBAAgB,CAAC,gBAAgB;YACvC,GAAG,EAAE,MAAM,CAAC,GAAG;YACf,SAAS,EAAE,IAAI;SAChB,CACF,CAAC;IACJ,CAAC;IAED,IAAI,QAAQ,KAAK,QAAQ,IAAI,MAAM,CAAC,IAAI,GAAG,QAAQ,EAAE,CAAC;QACpD,MAAM,MAAM,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;QAClD,MAAM,IAAI,YAAY,CACpB,WAAW,MAAM,CAAC,GAAG,QAAQ,MAAM,CAAC,IAAI,yBAAyB,QAAQ,qBAAqB,EAC9F;YACE,IAAI,EAAE,gBAAgB,CAAC,cAAc;YACrC,GAAG,EAAE,MAAM,CAAC,GAAG;YACf,SAAS,EAAE,IAAI;SAChB,CACF,CAAC;IACJ,CAAC;IAED,MAAM,MAAM,GAAiB,EAAE,CAAC;IAChC,IAAI,KAAK,GAAG,CAAC,CAAC;IACd,MAAM,MAAM,GAAG,MAAM,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC;IAEvC,IAAI,CAAC;QACH,OAAO,IAAI,EAAE,CAAC;YACZ,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,MAAM,MAAM,CAAC,IAAI,EAAE,CAAC;YAC5C,IAAI,IAAI,EAAE,CAAC;gBACT,MAAM;YACR,CAAC;YACD,KAAK,IAAI,KAAK,CAAC,UAAU,CAAC;YAC1B,IAAI,QAAQ,KAAK,QAAQ,IAAI,KAAK,GAAG,QAAQ,EAAE,CAAC;gBAC9C,MAAM,MAAM,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;gBAC7C,MAAM,IAAI,YAAY,CACpB,WAAW,MAAM,CAAC,GAAG,kBAAkB,QAAQ,uCAAuC,EACtF;oBACE,IAAI,EAAE,gBAAgB,CAAC,cAAc;oBACrC,GAAG,EAAE,MAAM,CAAC,GAAG;oBACf,SAAS,EAAE,IAAI;iBAChB,CACF,CAAC;YACJ,CAAC;YACD,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACrB,CAAC;IACH,CAAC;YAAS,CAAC;QACT,MAAM,CAAC,WAAW,EAAE,CAAC;IACvB,CAAC;IAED,MAAM,KAAK,GAAG,IAAI,UAAU,CAAC,KAAK,CAAC,CAAC;IACpC,IAAI,MAAM,GAAG,CAAC,CAAC;IACf,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QAC3B,KAAK,CAAC,GAAG,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;QACzB,MAAM,IAAI,KAAK,CAAC,UAAU,CAAC;IAC7B,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AA0BD,MAAM,OAAO,aAAa;IAMb;IALF,OAAO,CAAgB;IACvB,QAAQ,CAA2B;IAC5C,OAAO,GAAG,KAAK,CAAC;IAEhB,YACW,IAAY,EACrB,MAAqB,EACrB,UAAoC,EAAE;QAF7B,SAAI,GAAJ,IAAI,CAAQ;QAIrB,SAAS,CAAC,IAAI,EAAE,YAAY,CAAC,CAAC;QAC9B,IAAI,CAAC,OAAO,GAAG,MAAM,CAAC;QACtB,IAAI,CAAC,QAAQ,GAAG,CAAC,GAAG,OAAO,CAAC,CAAC;IAC/B,CAAC;IAED,IAAI,UAAU;QACZ,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC;IAC3B,CAAC;IAED,IAAI,YAAY;QACd,OAAO,IAAI,CAAC,OAAO,CAAC,YAAY,CAAC;IACnC,CAAC;IAED,IAAI,CAAC,GAAW;QACd,SAAS,CAAC,GAAG,CAAC,CAAC;QACf,OAAO;YACL,MAAM,EAAE,CAAC,cAAc,EAAE,OAAO,EAAE,EAAE,CAClC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,cAAc,EAAE,OAAO,CAAC;YACzC,MAAM,EAAE,CAAC,OAAO,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,GAAG,EAAE,OAAO,CAAC;YAC9C,QAAQ,EAAE,CAAC,OAAO,EAAE,EAAE,CAAC,IAAI,CAAC,cAAc,CAAC,GAAG,EAAE,OAAO,CAAC;YACxD,MAAM,EAAE,CAAC,OAAO,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,GAAG,EAAE,OAAO,CAAC;YAC9C,IAAI,EAAE,CAAC,OAAO,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,OAAO,CAAC;YAC1C,GAAG;YACH,MAAM,EAAE,CAAC,cAAc,EAAE,OAAO,EAAE,EAAE,CAClC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,cAAc,EAAE,OAAO,CAAC;YACzC,YAAY,EAAE,CAAC,OAAO,EAAE,EAAE,CAAC,IAAI,CAAC,YAAY,CAAC,GAAG,EAAE,OAAO,CAAC;YAC1D,UAAU,EAAE,CAAC,OAAO,EAAE,EAAE,CAAC,IAAI,CAAC,UAAU,CAAC,GAAG,EAAE,OAAO,CAAC;YACtD,KAAK,EAAE,CAAC,OAAO,EAAE,EAAE,CAAC,IAAI,CAAC,aAAa,CAAC,GAAG,EAAE,OAAO,CAAC;YACpD,IAAI,EAAE,CAAC,OAAO,EAAE,EAAE,CAAC,IAAI,CAAC,YAAY,CAAC,GAAG,EAAE,OAAO,CAAC;YAClD,MAAM,EAAE,CAAC,IAAI,EAAE,OAAO,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,GAAG,EAAE,IAAI,EAAE,OAAO,CAAC;SAC3D,CAAC;IACJ,CAAC;IAED,MAAM,CACJ,GAAW,EACX,IAAiB,EACjB,OAA8B;QAE9B,SAAS,CAAC,GAAG,CAAC,CAAC;QACf,OAAO,IAAI,CAAC,QAAQ,CAAC,EAAE,GAAG,EAAE,SAAS,EAAE,QAAQ,EAAE,KAAK,EAAE,IAAI,CAAC,IAAI,EAAE,EAAE,GAAG,EAAE,CACxE,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,GAAG,EAAE,IAAI,EAAE,OAAO,CAAC,CACxC,CAAC;IACJ,CAAC;IAED,cAAc,CACZ,GAAW,EACX,OAAgC;QAEhC,SAAS,CAAC,GAAG,CAAC,CAAC;QACf,qBAAqB,CAAC,OAAO,CAAC,CAAC;QAC/B,OAAO,IAAI,CAAC,QAAQ,CAAC,EAAE,GAAG,EAAE,SAAS,EAAE,UAAU,EAAE,KAAK,EAAE,IAAI,CAAC,IAAI,EAAE,EAAE,GAAG,EAAE,CAC1E,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,GAAG,EAAE,OAAO,CAAC,CACpC,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,aAAa,CACjB,GAAW,EACX,OAAwC;QAExC,MAAM,EAAE,QAAQ,GAAG,oBAAoB,EAAE,GAAG,QAAQ,EAAE,GAAG,OAAO,IAAI,EAAE,CAAC;QACvE,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,cAAc,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC;QACxD,OAAO,WAAW,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;IACvC,CAAC;IAED,KAAK,CAAC,YAAY,CAChB,GAAW,EACX,OAAwC;QAExC,OAAO,IAAI,WAAW,EAAE,CAAC,MAAM,CAAC,MAAM,IAAI,CAAC,aAAa,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC,CAAC;IAC1E,CAAC;IAED,KAAK,CAAC,YAAY,CAChB,GAAW,EACX,OAAwC;QAExC,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,YAAY,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;QACnD,IAAI,CAAC;YACH,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAW,CAAC;QACpC,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,IAAI,YAAY,CAAC,WAAW,GAAG,gCAAgC,EAAE;gBACrE,KAAK,EAAE,KAAK;gBACZ,IAAI,EAAE,gBAAgB,CAAC,gBAAgB;gBACvC,GAAG;gBACH,SAAS,EAAE,UAAU;gBACrB,SAAS,EAAE,IAAI;gBACf,KAAK,EAAE,IAAI,CAAC,IAAI;aACjB,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED,IAAI,CACF,GAAW,EACX,OAAiC;QAEjC,SAAS,CAAC,GAAG,CAAC,CAAC;QACf,OAAO,IAAI,CAAC,QAAQ,CAAC,EAAE,GAAG,EAAE,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,CAAC,IAAI,EAAE,EAAE,GAAG,EAAE,CACtE,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,GAAG,EAAE,OAAO,CAAC,CAChC,CAAC;IACJ,CAAC;IAED,MAAM,CAAC,GAAW,EAAE,OAAiC;QACnD,SAAS,CAAC,GAAG,CAAC,CAAC;QACf,OAAO,IAAI,CAAC,QAAQ,CAAC,EAAE,GAAG,EAAE,SAAS,EAAE,QAAQ,EAAE,KAAK,EAAE,IAAI,CAAC,IAAI,EAAE,EAAE,GAAG,EAAE,CACxE,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,GAAG,EAAE,OAAO,CAAC,CAClC,CAAC;IACJ,CAAC;IAED,MAAM,CAAC,GAAW,EAAE,OAAiC;QACnD,SAAS,CAAC,GAAG,CAAC,CAAC;QACf,OAAO,IAAI,CAAC,QAAQ,CAAC,EAAE,GAAG,EAAE,SAAS,EAAE,QAAQ,EAAE,KAAK,EAAE,IAAI,CAAC,IAAI,EAAE,EAAE,GAAG,EAAE,CACxE,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,GAAG,EAAE,OAAO,CAAC,CAClC,CAAC;IACJ,CAAC;IAED,IAAI,CACF,SAAiB,EACjB,cAAsB,EACtB,OAAiC;QAEjC,SAAS,CAAC,SAAS,EAAE,YAAY,CAAC,CAAC;QACnC,SAAS,CAAC,cAAc,EAAE,iBAAiB,CAAC,CAAC;QAC7C,OAAO,IAAI,CAAC,QAAQ,CAClB;YACE,IAAI,EAAE,SAAS;YACf,SAAS,EAAE,MAAM;YACjB,KAAK,EAAE,IAAI,CAAC,IAAI;YAChB,EAAE,EAAE,cAAc;SACnB,EACD,GAAG,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,SAAS,EAAE,cAAc,EAAE,OAAO,CAAC,CAC5D,CAAC;IACJ,CAAC;IAED,IAAI,CACF,SAAiB,EACjB,cAAsB,EACtB,OAAiC;QAEjC,SAAS,CAAC,SAAS,EAAE,YAAY,CAAC,CAAC;QACnC,SAAS,CAAC,cAAc,EAAE,iBAAiB,CAAC,CAAC;QAC7C,OAAO,IAAI,CAAC,QAAQ,CAClB;YACE,IAAI,EAAE,SAAS;YACf,SAAS,EAAE,MAAM;YACjB,KAAK,EAAE,IAAI,CAAC,IAAI;YAChB,EAAE,EAAE,cAAc;SACnB,EACD,GAAG,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,SAAS,EAAE,cAAc,EAAE,OAAO,CAAC,CAC5D,CAAC;IACJ,CAAC;IAED,IAAI,CAAC,OAA4B;QAC/B,iBAAiB,CAAC,OAAO,CAAC,CAAC;QAC3B,OAAO,IAAI,CAAC,QAAQ,CAAC,EAAE,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,CAAC,IAAI,EAAE,EAAE,GAAG,EAAE,CACjE,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,CAC3B,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,CAAC,OAAO,CACZ,OAA4B;QAE5B,MAAM,EAAE,SAAS,EAAE,UAAU,EAAE,GAAG,WAAW,EAAE,GAAG,OAAO,IAAI,EAAE,CAAC;QAChE,KAAK,UAAU,CAAC;QAChB,IAAI,MAAM,GAAG,WAAW,CAAC,MAAM,CAAC;QAChC,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;QAE/B,GAAG,CAAC;YACF,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC;gBAC3B,GAAG,WAAW;gBACd,GAAG,CAAC,MAAM,KAAK,SAAS,IAAI,EAAE,MAAM,EAAE,CAAC;aACxC,CAAC,CAAC;YACH,KAAK,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC;YAClB,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC;YACrB,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;gBACzB,IAAI,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC;oBACrB,MAAM,IAAI,YAAY,CACpB,UAAU,IAAI,CAAC,IAAI,0CAA0C,EAC7D;wBACE,IAAI,EAAE,gBAAgB,CAAC,QAAQ;wBAC/B,SAAS,EAAE,MAAM;wBACjB,SAAS,EAAE,IAAI;wBACf,KAAK,EAAE,IAAI,CAAC,IAAI;qBACjB,CACF,CAAC;gBACJ,CAAC;gBACD,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;YACnB,CAAC;QACH,CAAC,QAAQ,MAAM,KAAK,SAAS,EAAE;IACjC,CAAC;IAED,MAAM,CACJ,OAAwB,EACxB,OAA8B;QAE9B,mBAAmB,CAAC,OAAO,CAAC,CAAC;QAC7B,OAAO,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;IACxC,CAAC;IAED,KAAK,CAAC,CAAC,OAAO,CACZ,OAAwB,EACxB,OAA8B;QAE9B,MAAM,OAAO,GAA4B;YACvC,SAAS,EAAE,QAAQ;YACnB,KAAK,EAAE,IAAI,CAAC,IAAI;SACjB,CAAC;QACF,IAAI,CAAC;YACH,KAAK,MAAM,MAAM,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;gBACnC,MAAM,MAAM,CAAC,eAAe,EAAE,CAAC,OAAO,CAAC,CAAC;YAC1C,CAAC;YACD,IAAI,KAAK,EAAE,MAAM,MAAM,IAAI,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,OAAO,EAAE,OAAO,CAAC,EAAE,CAAC;gBACjE,MAAM,MAAM,CAAC;YACf,CAAC;YACD,KAAK,MAAM,MAAM,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;gBACnC,MAAM,MAAM,CAAC,cAAc,EAAE,CAAC,OAAO,EAAE,SAAS,CAAC,CAAC;YACpD,CAAC;QACH,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,UAAU,GAAG,qBAAqB,CAAC,KAAK,EAAE;gBAC9C,SAAS,EAAE,QAAQ;gBACnB,KAAK,EAAE,IAAI,CAAC,IAAI;aACjB,CAAC,CAAC;YACH,KAAK,MAAM,MAAM,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;gBACnC,IAAI,CAAC;oBACH,MAAM,MAAM,CAAC,OAAO,EAAE,CAAC,OAAO,EAAE,UAAU,CAAC,CAAC;gBAC9C,CAAC;gBAAC,MAAM,CAAC;oBACP,uCAAuC;gBACzC,CAAC;YACH,CAAC;YACD,MAAM,UAAU,CAAC;QACnB,CAAC;IACH,CAAC;IAED,YAAY,CACV,GAAW,EACX,OAAsC;QAEtC,SAAS,CAAC,GAAG,CAAC,CAAC;QACf,OAAO,IAAI,CAAC,QAAQ,CAClB,EAAE,GAAG,EAAE,SAAS,EAAE,cAAc,EAAE,KAAK,EAAE,IAAI,CAAC,IAAI,EAAE,EACpD,GAAG,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,YAAY,CAAC,GAAG,EAAE,OAAO,CAAC,CAC9C,CAAC;IACJ,CAAC;IAED,UAAU,CACR,GAAW,EACX,OAAmC;QAEnC,SAAS,CAAC,GAAG,CAAC,CAAC;QACf,yBAAyB,CAAC,OAAO,CAAC,CAAC;QACnC,OAAO,IAAI,CAAC,QAAQ,CAClB,EAAE,GAAG,EAAE,SAAS,EAAE,YAAY,EAAE,KAAK,EAAE,IAAI,CAAC,IAAI,EAAE,EAClD,GAAG,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,GAAG,EAAE,OAAO,CAAC,CAC5C,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,UAAU,CACd,KAAuC,EACvC,OAAkC;QAElC,MAAM,OAAO,GAAG,MAAM,UAAU,CAC9B,KAAK,EACL,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,GAAG,EAClB,CAAC,IAAI,EAAE,EAAE,CACP,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,IAAI,EAAE;YAC/B,GAAG,gBAAgB,CAAC,OAAO,CAAC;YAC5B,GAAG,CAAC,IAAI,CAAC,YAAY,KAAK,SAAS,IAAI;gBACrC,YAAY,EAAE,IAAI,CAAC,YAAY;aAChC,CAAC;YACF,GAAG,CAAC,IAAI,CAAC,WAAW,KAAK,SAAS,IAAI;gBACpC,WAAW,EAAE,IAAI,CAAC,WAAW;aAC9B,CAAC;YACF,GAAG,CAAC,IAAI,CAAC,QAAQ,KAAK,SAAS,IAAI,EAAE,QAAQ,EAAE,IAAI,CAAC,QAAQ,EAAE,CAAC;YAC/D,GAAG,CAAC,IAAI,CAAC,SAAS,KAAK,SAAS,IAAI;gBAClC,SAAS,EAAE,IAAI,CAAC,SAAS;aAC1B,CAAC;YACF,GAAG,CAAC,OAAO,EAAE,UAAU,KAAK,SAAS,IAAI;gBACvC,UAAU,EAAE,CAAC,QAAQ,EAAE,EAAE,CACvB,OAAO,CAAC,UAAU,EAAE,CAAC,EAAE,GAAG,QAAQ,EAAE,GAAG,EAAE,IAAI,CAAC,GAAG,EAAE,CAAC;aACvD,CAAC;SACH,CAAC,EACJ,OAAO,CACR,CAAC;QAEF,OAAO;YACL,QAAQ,EAAE,OAAO,CAAC,OAAO;YACzB,GAAG,CAAC,OAAO,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,CAAC;SAC7D,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,YAAY,CAChB,IAAuB,EACvB,OAA6B;QAE7B,MAAM,OAAO,GAAG,MAAM,UAAU,CAC9B,IAAI,EACJ,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,EACZ,CAAC,GAAG,EAAE,EAAE,CAAC,IAAI,CAAC,cAAc,CAAC,GAAG,EAAE,eAAe,CAAC,OAAO,CAAC,CAAC,EAC3D,OAAO,CACR,CAAC;QACF,OAAO;YACL,UAAU,EAAE,OAAO,CAAC,OAAO;YAC3B,GAAG,CAAC,OAAO,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,CAAC;SAC7D,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,QAAQ,CACZ,IAAuB,EACvB,OAA8B;QAE9B,MAAM,OAAO,GAAG,MAAM,UAAU,CAC9B,IAAI,EACJ,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,EACZ,CAAC,GAAG,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,gBAAgB,CAAC,OAAO,CAAC,CAAC,EAClD,OAAO,CACR,CAAC;QACF,OAAO;YACL,OAAO,EAAE,OAAO,CAAC,OAAO;YACxB,GAAG,CAAC,OAAO,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,CAAC;SAC7D,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,UAAU,CACd,IAAuB,EACvB,OAA8B;QAE9B,MAAM,OAAO,GAAG,MAAM,UAAU,CAC9B,IAAI,EACJ,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,EACZ,KAAK,EAAE,GAAG,EAAE,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,IAAI,CAAC,MAAM,CAAC,GAAG,EAAE,OAAO,CAAC,EAAE,GAAG,EAAE,CAAC,EACjE,OAAO,CACR,CAAC;QACF,MAAM,QAAQ,GAAa,EAAE,CAAC;QAC9B,MAAM,OAAO,GAAa,EAAE,CAAC;QAC7B,KAAK,MAAM,MAAM,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC;YACrC,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QACxD,CAAC;QACD,OAAO;YACL,QAAQ;YACR,OAAO;YACP,GAAG,CAAC,OAAO,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,CAAC;SAC7D,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,UAAU,CACd,IAAuB,EACvB,OAA8B;QAE9B,MAAM,OAAO,GAAG,MAAM,UAAU,CAC9B,IAAI,EACJ,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,EACZ,KAAK,EAAE,GAAG,EAAE,EAAE;YACZ,MAAM,IAAI,CAAC,MAAM,CAAC,GAAG,EAAE,gBAAgB,CAAC,OAAO,CAAC,CAAC,CAAC;YAClD,OAAO,GAAG,CAAC;QACb,CAAC,EACD,OAAO,CACR,CAAC;QACF,OAAO;YACL,OAAO,EAAE,OAAO,CAAC,OAAO;YACxB,GAAG,CAAC,OAAO,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,CAAC;SAC7D,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,qBAAqB;QACzB,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;YACjB,OAAO;QACT,CAAC;QACD,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC;QACpB,MAAM,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC;IAC/B,CAAC;IAED,KAAK,CAAC,QAAQ,CACZ,OAAgC,EAChC,SAAgC;QAEhC,IAAI,CAAC;YACH,KAAK,MAAM,MAAM,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;gBACnC,MAAM,MAAM,CAAC,eAAe,EAAE,CAAC,OAAO,CAAC,CAAC;YAC1C,CAAC;YACD,MAAM,MAAM,GAAG,MAAM,SAAS,EAAE,CAAC;YACjC,KAAK,MAAM,MAAM,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;gBACnC,MAAM,MAAM,CAAC,cAAc,EAAE,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;YACjD,CAAC;YACD,OAAO,MAAM,CAAC;QAChB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,UAAU,GAAG,qBAAqB,CAAC,KAAK,EAAE;gBAC9C,GAAG,CAAC,OAAO,CAAC,GAAG,KAAK,SAAS,IAAI,EAAE,GAAG,EAAE,OAAO,CAAC,GAAG,EAAE,CAAC;gBACtD,SAAS,EAAE,OAAO,CAAC,SAAS;gBAC5B,KAAK,EAAE,IAAI,CAAC,IAAI;aACjB,CAAC,CAAC;YACH,KAAK,MAAM,MAAM,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;gBACnC,IAAI,CAAC;oBACH,MAAM,MAAM,CAAC,OAAO,EAAE,CAAC,OAAO,EAAE,UAAU,CAAC,CAAC;gBAC9C,CAAC;gBAAC,MAAM,CAAC;oBACP,uCAAuC;gBACzC,CAAC;YACH,CAAC;YACD,MAAM,UAAU,CAAC;QACnB,CAAC;IACH,CAAC;CACF","sourcesContent":["import { settleMany } from './internal/settle-many.js';\nimport {\n  StorageError,\n  StorageErrorCode,\n  normalizeStorageError,\n} from './storage.error.js';\nimport type { StorageDriver } from './storage.driver.js';\nimport type {\n  StorageBody,\n  StorageBufferedDownloadOptions,\n  StorageBulkOptions,\n  StorageCapabilities,\n  StorageDeleteManyResult,\n  StorageDownloadManyResult,\n  StorageDownloadOptions,\n  StorageExistsManyResult,\n  StorageHeadManyResult,\n  StorageListOptions,\n  StorageListResult,\n  StorageObject,\n  StorageObjectMetadata,\n  StorageOperationContext,\n  StorageOperationOptions,\n  StoragePlugin,\n  StorageSearchOptions,\n  StorageSignedDownloadOptions,\n  StorageSignedUpload,\n  StorageSignedUploadOptions,\n  StorageUploadManyItem,\n  StorageUploadManyOptions,\n  StorageUploadManyResult,\n  StorageUploadOptions,\n  StorageUploadResult,\n} from './storage.types.js';\n\nexport const DEFAULT_BUFFER_LIMIT = 10 * 1024 * 1024;\n\ntype BulkOperationOptions = StorageBulkOptions & StorageOperationOptions;\ntype DownloadManyOptions = StorageBulkOptions & StorageDownloadOptions;\n\nfunction assertKey(key: string, label = 'key'): void {\n  if (typeof key !== 'string' || key.length === 0) {\n    throw new StorageError(`${label} must be a non-empty string.`, {\n      code: StorageErrorCode.INVALID_ARGUMENT,\n      permanent: true,\n    });\n  }\n}\n\nfunction invalidArgument(message: string): never {\n  throw new StorageError(message, {\n    code: StorageErrorCode.INVALID_ARGUMENT,\n    permanent: true,\n  });\n}\n\nfunction assertPositiveSafeInteger(\n  value: number | undefined,\n  label: string,\n): void {\n  if (value !== undefined && (!Number.isSafeInteger(value) || value <= 0)) {\n    invalidArgument(`${label} must be a positive safe integer.`);\n  }\n}\n\nfunction assertDownloadOptions(options?: StorageDownloadOptions): void {\n  const range = options?.range;\n  if (range === undefined) {\n    return;\n  }\n  if (!Number.isSafeInteger(range.start) || range.start < 0) {\n    invalidArgument('range.start must be a non-negative safe integer.');\n  }\n  if (\n    range.end !== undefined &&\n    (!Number.isSafeInteger(range.end) || range.end < range.start)\n  ) {\n    invalidArgument(\n      'range.end must be a safe integer greater than or equal to range.start.',\n    );\n  }\n}\n\nfunction assertListOptions(options?: StorageListOptions): void {\n  if (options?.delimiter !== undefined && options.delimiter.length === 0) {\n    invalidArgument('delimiter must be a non-empty string.');\n  }\n  assertPositiveSafeInteger(options?.limit, 'limit');\n}\n\nfunction assertSearchOptions(options?: StorageSearchOptions): void {\n  assertPositiveSafeInteger(options?.limit, 'limit');\n  assertPositiveSafeInteger(options?.maxResults, 'maxResults');\n}\n\nfunction assertSignedUploadOptions(options: StorageSignedUploadOptions): void {\n  assertPositiveSafeInteger(options.expiresIn, 'expiresIn');\n  assertPositiveSafeInteger(options.maxSize, 'maxSize');\n  if (\n    options.minSize !== undefined &&\n    (!Number.isSafeInteger(options.minSize) || options.minSize < 0)\n  ) {\n    invalidArgument('minSize must be a non-negative safe integer.');\n  }\n  if (\n    options.minSize !== undefined &&\n    options.maxSize !== undefined &&\n    options.minSize > options.maxSize\n  ) {\n    invalidArgument('minSize cannot be greater than maxSize.');\n  }\n}\n\nfunction operationOptions(\n  options?: BulkOperationOptions,\n): StorageOperationOptions | undefined {\n  if (options === undefined) {\n    return undefined;\n  }\n  return {\n    ...(options.retries !== undefined && { retries: options.retries }),\n    ...(options.signal !== undefined && { signal: options.signal }),\n    ...(options.timeout !== undefined && { timeout: options.timeout }),\n  };\n}\n\nfunction downloadOptions(\n  options?: DownloadManyOptions,\n): StorageDownloadOptions | undefined {\n  if (options === undefined) {\n    return undefined;\n  }\n  return {\n    ...operationOptions(options),\n    ...(options.range !== undefined && { range: options.range }),\n  };\n}\n\nasync function collectBody(\n  object: StorageObject,\n  maxBytes: number,\n): Promise<Uint8Array> {\n  if (maxBytes !== Infinity && (!Number.isFinite(maxBytes) || maxBytes < 0)) {\n    await object.body.cancel().catch(() => undefined);\n    throw new StorageError(\n      'maxBytes must be a non-negative finite number or Infinity.',\n      {\n        code: StorageErrorCode.INVALID_ARGUMENT,\n        key: object.key,\n        permanent: true,\n      },\n    );\n  }\n\n  if (maxBytes !== Infinity && object.size > maxBytes) {\n    await object.body.cancel().catch(() => undefined);\n    throw new StorageError(\n      `Object \"${object.key}\" is ${object.size} bytes, exceeding the ${maxBytes}-byte buffer limit.`,\n      {\n        code: StorageErrorCode.LIMIT_EXCEEDED,\n        key: object.key,\n        permanent: true,\n      },\n    );\n  }\n\n  const chunks: Uint8Array[] = [];\n  let total = 0;\n  const reader = object.body.getReader();\n\n  try {\n    while (true) {\n      const { done, value } = await reader.read();\n      if (done) {\n        break;\n      }\n      total += value.byteLength;\n      if (maxBytes !== Infinity && total > maxBytes) {\n        await reader.cancel().catch(() => undefined);\n        throw new StorageError(\n          `Object \"${object.key}\" exceeded the ${maxBytes}-byte buffer limit while downloading.`,\n          {\n            code: StorageErrorCode.LIMIT_EXCEEDED,\n            key: object.key,\n            permanent: true,\n          },\n        );\n      }\n      chunks.push(value);\n    }\n  } finally {\n    reader.releaseLock();\n  }\n\n  const bytes = new Uint8Array(total);\n  let offset = 0;\n  for (const chunk of chunks) {\n    bytes.set(chunk, offset);\n    offset += chunk.byteLength;\n  }\n  return bytes;\n}\n\nexport interface StorageFileHandle {\n  readonly key: string;\n  upload(\n    body: StorageBody,\n    options?: StorageUploadOptions,\n  ): Promise<StorageUploadResult>;\n  download(options?: StorageDownloadOptions): Promise<StorageObject>;\n  bytes(options?: StorageBufferedDownloadOptions): Promise<Uint8Array>;\n  text(options?: StorageBufferedDownloadOptions): Promise<string>;\n  head(options?: StorageOperationOptions): Promise<StorageObjectMetadata>;\n  exists(options?: StorageOperationOptions): Promise<boolean>;\n  delete(options?: StorageOperationOptions): Promise<void>;\n  signDownload(options?: StorageSignedDownloadOptions): Promise<string>;\n  signUpload(options: StorageSignedUploadOptions): Promise<StorageSignedUpload>;\n  copyTo(\n    destinationKey: string,\n    options?: StorageOperationOptions,\n  ): Promise<void>;\n  moveTo(\n    destinationKey: string,\n    options?: StorageOperationOptions,\n  ): Promise<void>;\n}\n\nexport class StorageClient {\n  readonly #driver: StorageDriver;\n  readonly #plugins: readonly StoragePlugin[];\n  #closed = false;\n\n  constructor(\n    readonly name: string,\n    driver: StorageDriver,\n    plugins: readonly StoragePlugin[] = [],\n  ) {\n    assertKey(name, 'store name');\n    this.#driver = driver;\n    this.#plugins = [...plugins];\n  }\n\n  get driverName(): string {\n    return this.#driver.name;\n  }\n\n  get capabilities(): Readonly<StorageCapabilities> {\n    return this.#driver.capabilities;\n  }\n\n  file(key: string): StorageFileHandle {\n    assertKey(key);\n    return {\n      copyTo: (destinationKey, options) =>\n        this.copy(key, destinationKey, options),\n      delete: (options) => this.delete(key, options),\n      download: (options) => this.downloadStream(key, options),\n      exists: (options) => this.exists(key, options),\n      head: (options) => this.head(key, options),\n      key,\n      moveTo: (destinationKey, options) =>\n        this.move(key, destinationKey, options),\n      signDownload: (options) => this.signDownload(key, options),\n      signUpload: (options) => this.signUpload(key, options),\n      bytes: (options) => this.downloadBytes(key, options),\n      text: (options) => this.downloadText(key, options),\n      upload: (body, options) => this.upload(key, body, options),\n    };\n  }\n\n  upload(\n    key: string,\n    body: StorageBody,\n    options?: StorageUploadOptions,\n  ): Promise<StorageUploadResult> {\n    assertKey(key);\n    return this.#execute({ key, operation: 'upload', store: this.name }, () =>\n      this.#driver.upload(key, body, options),\n    );\n  }\n\n  downloadStream(\n    key: string,\n    options?: StorageDownloadOptions,\n  ): Promise<StorageObject> {\n    assertKey(key);\n    assertDownloadOptions(options);\n    return this.#execute({ key, operation: 'download', store: this.name }, () =>\n      this.#driver.download(key, options),\n    );\n  }\n\n  async downloadBytes(\n    key: string,\n    options?: StorageBufferedDownloadOptions,\n  ): Promise<Uint8Array> {\n    const { maxBytes = DEFAULT_BUFFER_LIMIT, ...download } = options ?? {};\n    const object = await this.downloadStream(key, download);\n    return collectBody(object, maxBytes);\n  }\n\n  async downloadText(\n    key: string,\n    options?: StorageBufferedDownloadOptions,\n  ): Promise<string> {\n    return new TextDecoder().decode(await this.downloadBytes(key, options));\n  }\n\n  async downloadJson<Result = unknown>(\n    key: string,\n    options?: StorageBufferedDownloadOptions,\n  ): Promise<Result> {\n    const text = await this.downloadText(key, options);\n    try {\n      return JSON.parse(text) as Result;\n    } catch (error) {\n      throw new StorageError(`Object \"${key}\" does not contain valid JSON.`, {\n        cause: error,\n        code: StorageErrorCode.INVALID_ARGUMENT,\n        key,\n        operation: 'download',\n        permanent: true,\n        store: this.name,\n      });\n    }\n  }\n\n  head(\n    key: string,\n    options?: StorageOperationOptions,\n  ): Promise<StorageObjectMetadata> {\n    assertKey(key);\n    return this.#execute({ key, operation: 'head', store: this.name }, () =>\n      this.#driver.head(key, options),\n    );\n  }\n\n  exists(key: string, options?: StorageOperationOptions): Promise<boolean> {\n    assertKey(key);\n    return this.#execute({ key, operation: 'exists', store: this.name }, () =>\n      this.#driver.exists(key, options),\n    );\n  }\n\n  delete(key: string, options?: StorageOperationOptions): Promise<void> {\n    assertKey(key);\n    return this.#execute({ key, operation: 'delete', store: this.name }, () =>\n      this.#driver.delete(key, options),\n    );\n  }\n\n  copy(\n    sourceKey: string,\n    destinationKey: string,\n    options?: StorageOperationOptions,\n  ): Promise<void> {\n    assertKey(sourceKey, 'source key');\n    assertKey(destinationKey, 'destination key');\n    return this.#execute(\n      {\n        from: sourceKey,\n        operation: 'copy',\n        store: this.name,\n        to: destinationKey,\n      },\n      () => this.#driver.copy(sourceKey, destinationKey, options),\n    );\n  }\n\n  move(\n    sourceKey: string,\n    destinationKey: string,\n    options?: StorageOperationOptions,\n  ): Promise<void> {\n    assertKey(sourceKey, 'source key');\n    assertKey(destinationKey, 'destination key');\n    return this.#execute(\n      {\n        from: sourceKey,\n        operation: 'move',\n        store: this.name,\n        to: destinationKey,\n      },\n      () => this.#driver.move(sourceKey, destinationKey, options),\n    );\n  }\n\n  list(options?: StorageListOptions): Promise<StorageListResult> {\n    assertListOptions(options);\n    return this.#execute({ operation: 'list', store: this.name }, () =>\n      this.#driver.list(options),\n    );\n  }\n\n  async *listAll(\n    options?: StorageListOptions,\n  ): AsyncGenerator<StorageObjectMetadata, void> {\n    const { delimiter: _delimiter, ...walkOptions } = options ?? {};\n    void _delimiter;\n    let cursor = walkOptions.cursor;\n    const seen = new Set<string>();\n\n    do {\n      const page = await this.list({\n        ...walkOptions,\n        ...(cursor !== undefined && { cursor }),\n      });\n      yield* page.items;\n      cursor = page.cursor;\n      if (cursor !== undefined) {\n        if (seen.has(cursor)) {\n          throw new StorageError(\n            `Store \"${this.name}\" returned a repeated pagination cursor.`,\n            {\n              code: StorageErrorCode.PROVIDER,\n              operation: 'list',\n              permanent: true,\n              store: this.name,\n            },\n          );\n        }\n        seen.add(cursor);\n      }\n    } while (cursor !== undefined);\n  }\n\n  search(\n    pattern: string | RegExp,\n    options?: StorageSearchOptions,\n  ): AsyncIterable<StorageObjectMetadata> {\n    assertSearchOptions(options);\n    return this.#search(pattern, options);\n  }\n\n  async *#search(\n    pattern: string | RegExp,\n    options?: StorageSearchOptions,\n  ): AsyncGenerator<StorageObjectMetadata, void> {\n    const context: StorageOperationContext = {\n      operation: 'search',\n      store: this.name,\n    };\n    try {\n      for (const plugin of this.#plugins) {\n        await plugin.beforeOperation?.(context);\n      }\n      for await (const object of this.#driver.search(pattern, options)) {\n        yield object;\n      }\n      for (const plugin of this.#plugins) {\n        await plugin.afterOperation?.(context, undefined);\n      }\n    } catch (error) {\n      const normalized = normalizeStorageError(error, {\n        operation: 'search',\n        store: this.name,\n      });\n      for (const plugin of this.#plugins) {\n        try {\n          await plugin.onError?.(context, normalized);\n        } catch {\n          // Preserve the original storage error.\n        }\n      }\n      throw normalized;\n    }\n  }\n\n  signDownload(\n    key: string,\n    options?: StorageSignedDownloadOptions,\n  ): Promise<string> {\n    assertKey(key);\n    return this.#execute(\n      { key, operation: 'signDownload', store: this.name },\n      () => this.#driver.signDownload(key, options),\n    );\n  }\n\n  signUpload(\n    key: string,\n    options: StorageSignedUploadOptions,\n  ): Promise<StorageSignedUpload> {\n    assertKey(key);\n    assertSignedUploadOptions(options);\n    return this.#execute(\n      { key, operation: 'signUpload', store: this.name },\n      () => this.#driver.signUpload(key, options),\n    );\n  }\n\n  async uploadMany(\n    items: readonly StorageUploadManyItem[],\n    options?: StorageUploadManyOptions,\n  ): Promise<StorageUploadManyResult> {\n    const settled = await settleMany(\n      items,\n      (item) => item.key,\n      (item) =>\n        this.upload(item.key, item.body, {\n          ...operationOptions(options),\n          ...(item.cacheControl !== undefined && {\n            cacheControl: item.cacheControl,\n          }),\n          ...(item.contentType !== undefined && {\n            contentType: item.contentType,\n          }),\n          ...(item.metadata !== undefined && { metadata: item.metadata }),\n          ...(item.multipart !== undefined && {\n            multipart: item.multipart,\n          }),\n          ...(options?.onProgress !== undefined && {\n            onProgress: (progress) =>\n              options.onProgress?.({ ...progress, key: item.key }),\n          }),\n        }),\n      options,\n    );\n\n    return {\n      uploaded: settled.results,\n      ...(settled.errors.length > 0 && { errors: settled.errors }),\n    };\n  }\n\n  async downloadMany(\n    keys: readonly string[],\n    options?: DownloadManyOptions,\n  ): Promise<StorageDownloadManyResult> {\n    const settled = await settleMany(\n      keys,\n      (key) => key,\n      (key) => this.downloadStream(key, downloadOptions(options)),\n      options,\n    );\n    return {\n      downloaded: settled.results,\n      ...(settled.errors.length > 0 && { errors: settled.errors }),\n    };\n  }\n\n  async headMany(\n    keys: readonly string[],\n    options?: BulkOperationOptions,\n  ): Promise<StorageHeadManyResult> {\n    const settled = await settleMany(\n      keys,\n      (key) => key,\n      (key) => this.head(key, operationOptions(options)),\n      options,\n    );\n    return {\n      objects: settled.results,\n      ...(settled.errors.length > 0 && { errors: settled.errors }),\n    };\n  }\n\n  async existsMany(\n    keys: readonly string[],\n    options?: BulkOperationOptions,\n  ): Promise<StorageExistsManyResult> {\n    const settled = await settleMany(\n      keys,\n      (key) => key,\n      async (key) => ({ exists: await this.exists(key, options), key }),\n      options,\n    );\n    const existing: string[] = [];\n    const missing: string[] = [];\n    for (const result of settled.results) {\n      (result.exists ? existing : missing).push(result.key);\n    }\n    return {\n      existing,\n      missing,\n      ...(settled.errors.length > 0 && { errors: settled.errors }),\n    };\n  }\n\n  async deleteMany(\n    keys: readonly string[],\n    options?: BulkOperationOptions,\n  ): Promise<StorageDeleteManyResult> {\n    const settled = await settleMany(\n      keys,\n      (key) => key,\n      async (key) => {\n        await this.delete(key, operationOptions(options));\n        return key;\n      },\n      options,\n    );\n    return {\n      deleted: settled.results,\n      ...(settled.errors.length > 0 && { errors: settled.errors }),\n    };\n  }\n\n  async onApplicationShutdown(): Promise<void> {\n    if (this.#closed) {\n      return;\n    }\n    this.#closed = true;\n    await this.#driver.close?.();\n  }\n\n  async #execute<Result>(\n    context: StorageOperationContext,\n    operation: () => Promise<Result>,\n  ): Promise<Result> {\n    try {\n      for (const plugin of this.#plugins) {\n        await plugin.beforeOperation?.(context);\n      }\n      const result = await operation();\n      for (const plugin of this.#plugins) {\n        await plugin.afterOperation?.(context, result);\n      }\n      return result;\n    } catch (error) {\n      const normalized = normalizeStorageError(error, {\n        ...(context.key !== undefined && { key: context.key }),\n        operation: context.operation,\n        store: this.name,\n      });\n      for (const plugin of this.#plugins) {\n        try {\n          await plugin.onError?.(context, normalized);\n        } catch {\n          // Preserve the original storage error.\n        }\n      }\n      throw normalized;\n    }\n  }\n}\n"]}
+{"version":3,"file":"storage.client.js","sourceRoot":"","sources":["../src/storage.client.ts"],"names":[],"mappings":"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","sourcesContent":["import { settleMany } from './internal/settle-many.js';\nimport { isCanonicalStorageEtag } from './storage-etag.js';\nimport {\n  StorageError,\n  StorageErrorCode,\n  normalizeStorageError,\n} from './storage.error.js';\nimport type { StorageDriver } from './storage.driver.js';\nimport type {\n  StorageBody,\n  StorageBufferedDownloadOptions,\n  StorageBulkOptions,\n  StorageCapabilities,\n  StorageConditionalDeleteOptions,\n  StorageConditionalReadOptions,\n  StorageConditionalUploadOptions,\n  StorageDeleteManyResult,\n  StorageDownloadManyResult,\n  StorageDownloadOptions,\n  StorageExistsManyResult,\n  StorageHeadManyResult,\n  StorageListOptions,\n  StorageListResult,\n  StorageObject,\n  StorageObjectMetadata,\n  StorageOperationContext,\n  StorageOperationOptions,\n  StoragePlugin,\n  StoragePromotionOptions,\n  StorageSearchOptions,\n  StorageSignedDownloadOptions,\n  StorageSignedUpload,\n  StorageSignedUploadOptions,\n  StorageUploadManyItem,\n  StorageUploadManyOptions,\n  StorageUploadManyResult,\n  StorageUploadOptions,\n  StorageUploadResult,\n} from './storage.types.js';\n\nexport const DEFAULT_BUFFER_LIMIT = 10 * 1024 * 1024;\n\ntype BulkOperationOptions = StorageBulkOptions & StorageOperationOptions;\ntype DownloadManyOptions = StorageBulkOptions & StorageDownloadOptions;\n\ninterface AppliedMutationSettlement {\n  readonly appliedEtag?: string;\n}\n\nfunction assertKey(key: string, label = 'key'): void {\n  if (typeof key !== 'string' || key.length === 0) {\n    throw new StorageError(`${label} must be a non-empty string.`, {\n      code: StorageErrorCode.INVALID_ARGUMENT,\n      permanent: true,\n    });\n  }\n}\n\nfunction invalidArgument(message: string): never {\n  throw new StorageError(message, {\n    code: StorageErrorCode.INVALID_ARGUMENT,\n    permanent: true,\n  });\n}\n\nfunction assertPositiveSafeInteger(\n  value: number | undefined,\n  label: string,\n): void {\n  if (value !== undefined && (!Number.isSafeInteger(value) || value <= 0)) {\n    invalidArgument(`${label} must be a positive safe integer.`);\n  }\n}\n\nfunction assertDownloadOptions(options?: StorageDownloadOptions): void {\n  const range = options?.range;\n  if (range === undefined) {\n    return;\n  }\n  if (!Number.isSafeInteger(range.start) || range.start < 0) {\n    invalidArgument('range.start must be a non-negative safe integer.');\n  }\n  if (\n    range.end !== undefined &&\n    (!Number.isSafeInteger(range.end) || range.end < range.start)\n  ) {\n    invalidArgument(\n      'range.end must be a safe integer greater than or equal to range.start.',\n    );\n  }\n}\n\nfunction assertListOptions(options?: StorageListOptions): void {\n  if (options?.delimiter !== undefined && options.delimiter.length === 0) {\n    invalidArgument('delimiter must be a non-empty string.');\n  }\n  assertPositiveSafeInteger(options?.limit, 'limit');\n}\n\nfunction assertSearchOptions(options?: StorageSearchOptions): void {\n  assertPositiveSafeInteger(options?.limit, 'limit');\n  assertPositiveSafeInteger(options?.maxResults, 'maxResults');\n}\n\nfunction assertSignedUploadOptions(options: StorageSignedUploadOptions): void {\n  assertPositiveSafeInteger(options.expiresIn, 'expiresIn');\n  assertPositiveSafeInteger(options.maxSize, 'maxSize');\n  if (\n    options.minSize !== undefined &&\n    (!Number.isSafeInteger(options.minSize) || options.minSize < 0)\n  ) {\n    invalidArgument('minSize must be a non-negative safe integer.');\n  }\n  if (\n    options.minSize !== undefined &&\n    options.maxSize !== undefined &&\n    options.minSize > options.maxSize\n  ) {\n    invalidArgument('minSize cannot be greater than maxSize.');\n  }\n}\n\nfunction operationOptions(\n  options?: BulkOperationOptions,\n): StorageOperationOptions | undefined {\n  if (options === undefined) {\n    return undefined;\n  }\n  return {\n    ...(options.retries !== undefined && { retries: options.retries }),\n    ...(options.signal !== undefined && { signal: options.signal }),\n    ...(options.timeout !== undefined && { timeout: options.timeout }),\n  };\n}\n\nfunction downloadOptions(\n  options?: DownloadManyOptions,\n): StorageDownloadOptions | undefined {\n  if (options === undefined) {\n    return undefined;\n  }\n  return {\n    ...operationOptions(options),\n    ...(options.range !== undefined && { range: options.range }),\n  };\n}\n\nasync function collectBody(\n  object: StorageObject,\n  maxBytes: number,\n): Promise<Uint8Array> {\n  if (maxBytes !== Infinity && (!Number.isFinite(maxBytes) || maxBytes < 0)) {\n    await object.body.cancel().catch(() => undefined);\n    throw new StorageError(\n      'maxBytes must be a non-negative finite number or Infinity.',\n      {\n        code: StorageErrorCode.INVALID_ARGUMENT,\n        key: object.key,\n        permanent: true,\n      },\n    );\n  }\n\n  if (maxBytes !== Infinity && object.size > maxBytes) {\n    await object.body.cancel().catch(() => undefined);\n    throw new StorageError(\n      `Object \"${object.key}\" is ${object.size} bytes, exceeding the ${maxBytes}-byte buffer limit.`,\n      {\n        code: StorageErrorCode.LIMIT_EXCEEDED,\n        key: object.key,\n        permanent: true,\n      },\n    );\n  }\n\n  const chunks: Uint8Array[] = [];\n  let total = 0;\n  const reader = object.body.getReader();\n\n  try {\n    while (true) {\n      const { done, value } = await reader.read();\n      if (done) {\n        break;\n      }\n      total += value.byteLength;\n      if (maxBytes !== Infinity && total > maxBytes) {\n        await reader.cancel().catch(() => undefined);\n        throw new StorageError(\n          `Object \"${object.key}\" exceeded the ${maxBytes}-byte buffer limit while downloading.`,\n          {\n            code: StorageErrorCode.LIMIT_EXCEEDED,\n            key: object.key,\n            permanent: true,\n          },\n        );\n      }\n      chunks.push(value);\n    }\n  } finally {\n    reader.releaseLock();\n  }\n\n  const bytes = new Uint8Array(total);\n  let offset = 0;\n  for (const chunk of chunks) {\n    bytes.set(chunk, offset);\n    offset += chunk.byteLength;\n  }\n  return bytes;\n}\n\nexport interface StorageFileHandle {\n  readonly key: string;\n  upload(\n    body: StorageBody,\n    options?: StorageUploadOptions,\n  ): Promise<StorageUploadResult>;\n  uploadConditional(\n    body: StorageBody,\n    options: StorageConditionalUploadOptions,\n  ): Promise<StorageUploadResult>;\n  download(options?: StorageDownloadOptions): Promise<StorageObject>;\n  downloadConditional(\n    options: StorageConditionalReadOptions,\n  ): Promise<StorageObject>;\n  bytes(options?: StorageBufferedDownloadOptions): Promise<Uint8Array>;\n  text(options?: StorageBufferedDownloadOptions): Promise<string>;\n  head(options?: StorageOperationOptions): Promise<StorageObjectMetadata>;\n  exists(options?: StorageOperationOptions): Promise<boolean>;\n  delete(options?: StorageOperationOptions): Promise<void>;\n  deleteConditional(options: StorageConditionalDeleteOptions): Promise<void>;\n  signDownload(options?: StorageSignedDownloadOptions): Promise<string>;\n  signUpload(options: StorageSignedUploadOptions): Promise<StorageSignedUpload>;\n  copyTo(\n    destinationKey: string,\n    options?: StorageOperationOptions,\n  ): Promise<void>;\n  moveTo(\n    destinationKey: string,\n    options?: StorageOperationOptions,\n  ): Promise<void>;\n  /** Conditionally copies this staged object and deliberately retains it. */\n  promoteTo(\n    destinationKey: string,\n    options: StoragePromotionOptions,\n  ): Promise<void>;\n}\n\nexport class StorageClient {\n  readonly #driver: StorageDriver;\n  readonly #plugins: readonly StoragePlugin[];\n  #closed = false;\n\n  constructor(\n    readonly name: string,\n    driver: StorageDriver,\n    plugins: readonly StoragePlugin[] = [],\n  ) {\n    assertKey(name, 'store name');\n    this.#driver = driver;\n    this.#plugins = [...plugins];\n  }\n\n  get driverName(): string {\n    return this.#driver.name;\n  }\n\n  get capabilities(): Readonly<StorageCapabilities> {\n    return this.#driver.capabilities;\n  }\n\n  file(key: string): StorageFileHandle {\n    assertKey(key);\n    return {\n      copyTo: (destinationKey, options) =>\n        this.copy(key, destinationKey, options),\n      delete: (options) => this.delete(key, options),\n      deleteConditional: (options) => this.deleteConditional(key, options),\n      download: (options) => this.downloadStream(key, options),\n      downloadConditional: (options) => this.downloadConditional(key, options),\n      exists: (options) => this.exists(key, options),\n      head: (options) => this.head(key, options),\n      key,\n      moveTo: (destinationKey, options) =>\n        this.move(key, destinationKey, options),\n      promoteTo: (destinationKey, options) =>\n        this.promote(key, destinationKey, options),\n      signDownload: (options) => this.signDownload(key, options),\n      signUpload: (options) => this.signUpload(key, options),\n      bytes: (options) => this.downloadBytes(key, options),\n      text: (options) => this.downloadText(key, options),\n      upload: (body, options) => this.upload(key, body, options),\n      uploadConditional: (body, options) =>\n        this.uploadConditional(key, body, options),\n    };\n  }\n\n  upload(\n    key: string,\n    body: StorageBody,\n    options?: StorageUploadOptions,\n  ): Promise<StorageUploadResult> {\n    assertKey(key);\n    return this.#execute({ key, operation: 'upload', store: this.name }, () =>\n      this.#driver.upload(key, body, options),\n    );\n  }\n\n  uploadConditional(\n    key: string,\n    body: StorageBody,\n    options: StorageConditionalUploadOptions,\n  ): Promise<StorageUploadResult> {\n    assertKey(key);\n    const condition = options.condition;\n    if (\n      condition === undefined ||\n      (condition.type !== 'create' && condition.type !== 'replace')\n    ) {\n      invalidArgument('condition.type must be \"create\" or \"replace\".');\n    }\n    if (\n      condition.type === 'replace' &&\n      !isCanonicalStorageEtag(condition.etag)\n    ) {\n      invalidArgument('condition.etag must be a canonical storage ETag.');\n    }\n\n    const capability =\n      condition.type === 'create'\n        ? this.#driver.capabilities.conditionalCreate\n        : this.#driver.capabilities.conditionalReplace;\n    const uploadConditional = this.#driver.uploadConditional;\n    const multipartRequested =\n      options.multipart !== undefined && options.multipart !== false;\n    const multipartCapability =\n      this.#driver.capabilities.conditionalMultipartCompletion;\n    const multipartSupported =\n      !multipartRequested ||\n      (condition.type === 'create'\n        ? multipartCapability?.create === true\n        : multipartCapability?.replace === true);\n    if (\n      capability === undefined ||\n      !multipartSupported ||\n      uploadConditional === undefined\n    ) {\n      throw new StorageError(\n        `Store \"${this.name}\" does not support the requested conditional upload.`,\n        {\n          code: StorageErrorCode.NOT_SUPPORTED,\n          key,\n          operation: 'upload',\n          permanent: true,\n          store: this.name,\n        },\n      );\n    }\n\n    return this.#execute(\n      { key, operation: 'upload', store: this.name },\n      () => uploadConditional.call(this.#driver, key, body, options),\n      (result) => {\n        if (capability.resultEtag && !isCanonicalStorageEtag(result.etag)) {\n          throw new StorageError(\n            `Store \"${this.name}\" committed a conditional upload without the advertised result ETag.`,\n            {\n              code: StorageErrorCode.PROVIDER,\n              key,\n              operation: 'upload',\n              permanent: true,\n              store: this.name,\n            },\n          );\n        }\n        return {\n          ...(isCanonicalStorageEtag(result.etag) && {\n            appliedEtag: result.etag,\n          }),\n        };\n      },\n    );\n  }\n\n  downloadStream(\n    key: string,\n    options?: StorageDownloadOptions,\n  ): Promise<StorageObject> {\n    assertKey(key);\n    assertDownloadOptions(options);\n    return this.#execute({ key, operation: 'download', store: this.name }, () =>\n      this.#driver.download(key, options),\n    );\n  }\n\n  downloadConditional(\n    key: string,\n    options: StorageConditionalReadOptions,\n  ): Promise<StorageObject> {\n    assertKey(key);\n    assertDownloadOptions(options);\n    if (\n      options === undefined ||\n      options.condition === undefined ||\n      typeof options.condition !== 'object' ||\n      options.condition === null\n    ) {\n      invalidArgument('conditional read requires a condition object.');\n    }\n    const { etag, version } = options.condition;\n    if (etag !== undefined && !isCanonicalStorageEtag(etag)) {\n      invalidArgument('condition.etag must be a canonical storage ETag.');\n    }\n    if (\n      version !== undefined &&\n      (typeof version !== 'string' || version.length === 0)\n    ) {\n      invalidArgument('condition.version must be a non-empty string.');\n    }\n    if (etag === undefined && version === undefined) {\n      invalidArgument('conditional read requires an etag, version, or both.');\n    }\n\n    const capability = this.#driver.capabilities.conditionalRead;\n    const downloadConditional = this.#driver.downloadConditional;\n    if (\n      downloadConditional === undefined ||\n      capability === undefined ||\n      (etag !== undefined && !capability.etag) ||\n      (version !== undefined && !capability.version)\n    ) {\n      throw new StorageError(\n        `Store \"${this.name}\" does not support the requested conditional read.`,\n        {\n          code: StorageErrorCode.NOT_SUPPORTED,\n          key,\n          operation: 'download',\n          permanent: true,\n          store: this.name,\n        },\n      );\n    }\n\n    return this.#execute({ key, operation: 'download', store: this.name }, () =>\n      downloadConditional.call(this.#driver, key, options),\n    );\n  }\n\n  async downloadBytes(\n    key: string,\n    options?: StorageBufferedDownloadOptions,\n  ): Promise<Uint8Array> {\n    const { maxBytes = DEFAULT_BUFFER_LIMIT, ...download } = options ?? {};\n    const object = await this.downloadStream(key, download);\n    return collectBody(object, maxBytes);\n  }\n\n  async downloadText(\n    key: string,\n    options?: StorageBufferedDownloadOptions,\n  ): Promise<string> {\n    return new TextDecoder().decode(await this.downloadBytes(key, options));\n  }\n\n  async downloadJson<Result = unknown>(\n    key: string,\n    options?: StorageBufferedDownloadOptions,\n  ): Promise<Result> {\n    const text = await this.downloadText(key, options);\n    try {\n      return JSON.parse(text) as Result;\n    } catch (error) {\n      throw new StorageError(`Object \"${key}\" does not contain valid JSON.`, {\n        cause: error,\n        code: StorageErrorCode.INVALID_ARGUMENT,\n        key,\n        operation: 'download',\n        permanent: true,\n        store: this.name,\n      });\n    }\n  }\n\n  head(\n    key: string,\n    options?: StorageOperationOptions,\n  ): Promise<StorageObjectMetadata> {\n    assertKey(key);\n    return this.#execute({ key, operation: 'head', store: this.name }, () =>\n      this.#driver.head(key, options),\n    );\n  }\n\n  exists(key: string, options?: StorageOperationOptions): Promise<boolean> {\n    assertKey(key);\n    return this.#execute({ key, operation: 'exists', store: this.name }, () =>\n      this.#driver.exists(key, options),\n    );\n  }\n\n  delete(key: string, options?: StorageOperationOptions): Promise<void> {\n    assertKey(key);\n    return this.#execute({ key, operation: 'delete', store: this.name }, () =>\n      this.#driver.delete(key, options),\n    );\n  }\n\n  deleteConditional(\n    key: string,\n    options: StorageConditionalDeleteOptions,\n  ): Promise<void> {\n    assertKey(key);\n    if (\n      options.condition === undefined ||\n      !isCanonicalStorageEtag(options.condition.etag)\n    ) {\n      invalidArgument('condition.etag must be a canonical storage ETag.');\n    }\n\n    const capability = this.#driver.capabilities.conditionalDelete;\n    const deleteConditional = this.#driver.deleteConditional;\n    if (capability?.etag !== true || deleteConditional === undefined) {\n      throw new StorageError(\n        `Store \"${this.name}\" does not support conditional delete.`,\n        {\n          code: StorageErrorCode.NOT_SUPPORTED,\n          key,\n          operation: 'delete',\n          permanent: true,\n          store: this.name,\n        },\n      );\n    }\n\n    return this.#execute(\n      { key, operation: 'delete', store: this.name },\n      () => deleteConditional.call(this.#driver, key, options),\n      () => ({}),\n    );\n  }\n\n  copy(\n    sourceKey: string,\n    destinationKey: string,\n    options?: StorageOperationOptions,\n  ): Promise<void> {\n    assertKey(sourceKey, 'source key');\n    assertKey(destinationKey, 'destination key');\n    return this.#execute(\n      {\n        from: sourceKey,\n        operation: 'copy',\n        store: this.name,\n        to: destinationKey,\n      },\n      () => this.#driver.copy(sourceKey, destinationKey, options),\n    );\n  }\n\n  move(\n    sourceKey: string,\n    destinationKey: string,\n    options?: StorageOperationOptions,\n  ): Promise<void> {\n    assertKey(sourceKey, 'source key');\n    assertKey(destinationKey, 'destination key');\n    return this.#execute(\n      {\n        from: sourceKey,\n        operation: 'move',\n        store: this.name,\n        to: destinationKey,\n      },\n      () => this.#driver.move(sourceKey, destinationKey, options),\n    );\n  }\n\n  /**\n   * Conditionally copies a staged object to a final key. This operation does\n   * not delete the source; delete it after the application commit succeeds.\n   */\n  promote(\n    sourceKey: string,\n    destinationKey: string,\n    options: StoragePromotionOptions,\n  ): Promise<void> {\n    assertKey(sourceKey, 'source key');\n    assertKey(destinationKey, 'destination key');\n    const sourceEtag = options.sourceEtag;\n    const sourceVersion = options.sourceVersion;\n    if (sourceEtag !== undefined && !isCanonicalStorageEtag(sourceEtag)) {\n      invalidArgument('sourceEtag must be a canonical storage ETag.');\n    }\n    if (\n      sourceVersion !== undefined &&\n      (typeof sourceVersion !== 'string' || sourceVersion.length === 0)\n    ) {\n      invalidArgument('sourceVersion must be a non-empty string.');\n    }\n    const destination = options.destination;\n    if (\n      destination !== undefined &&\n      (typeof destination !== 'object' ||\n        destination === null ||\n        (destination.type !== 'create' && destination.type !== 'replace'))\n    ) {\n      invalidArgument('destination.type must be \"create\" or \"replace\".');\n    }\n    if (\n      sourceEtag === undefined &&\n      sourceVersion === undefined &&\n      destination === undefined\n    ) {\n      invalidArgument('promote requires a source or destination precondition.');\n    }\n    if (\n      destination?.type === 'replace' &&\n      !isCanonicalStorageEtag(destination.etag)\n    ) {\n      invalidArgument('destination.etag must be a canonical storage ETag.');\n    }\n\n    const sourceCapability = this.#driver.capabilities.conditionalCopySource;\n    const destinationCapability =\n      this.#driver.capabilities.conditionalCopyDestination;\n    const promote = this.#driver.promote;\n    const hasSourcePredicate =\n      sourceEtag !== undefined || sourceVersion !== undefined;\n    if (\n      promote === undefined ||\n      (sourceEtag !== undefined && sourceCapability?.etag !== true) ||\n      (sourceVersion !== undefined && sourceCapability?.version !== true) ||\n      (hasSourcePredicate &&\n        destination === undefined &&\n        sourceCapability?.requiresDestinationPredicate === true) ||\n      (destination?.type === 'create' &&\n        destinationCapability?.create !== true) ||\n      (destination?.type === 'replace' &&\n        destinationCapability?.replace !== true) ||\n      (destination !== undefined &&\n        !hasSourcePredicate &&\n        destinationCapability?.requiresSourcePredicate === true) ||\n      (destination !== undefined &&\n        hasSourcePredicate &&\n        destinationCapability?.atomicWithSource !== true)\n    ) {\n      throw new StorageError(\n        `Store \"${this.name}\" does not support the requested conditional promotion.`,\n        {\n          code: StorageErrorCode.NOT_SUPPORTED,\n          key: sourceKey,\n          operation: 'promote',\n          permanent: true,\n          store: this.name,\n        },\n      );\n    }\n\n    return this.#execute(\n      {\n        from: sourceKey,\n        operation: 'promote',\n        store: this.name,\n        to: destinationKey,\n      },\n      () => promote.call(this.#driver, sourceKey, destinationKey, options),\n      () => ({}),\n    );\n  }\n\n  list(options?: StorageListOptions): Promise<StorageListResult> {\n    assertListOptions(options);\n    return this.#execute({ operation: 'list', store: this.name }, () =>\n      this.#driver.list(options),\n    );\n  }\n\n  async *listAll(\n    options?: StorageListOptions,\n  ): AsyncGenerator<StorageObjectMetadata, void> {\n    const { delimiter: _delimiter, ...walkOptions } = options ?? {};\n    void _delimiter;\n    let cursor = walkOptions.cursor;\n    const seen = new Set<string>();\n\n    do {\n      const page = await this.list({\n        ...walkOptions,\n        ...(cursor !== undefined && { cursor }),\n      });\n      yield* page.items;\n      cursor = page.cursor;\n      if (cursor !== undefined) {\n        if (seen.has(cursor)) {\n          throw new StorageError(\n            `Store \"${this.name}\" returned a repeated pagination cursor.`,\n            {\n              code: StorageErrorCode.PROVIDER,\n              operation: 'list',\n              permanent: true,\n              store: this.name,\n            },\n          );\n        }\n        seen.add(cursor);\n      }\n    } while (cursor !== undefined);\n  }\n\n  search(\n    pattern: string | RegExp,\n    options?: StorageSearchOptions,\n  ): AsyncIterable<StorageObjectMetadata> {\n    assertSearchOptions(options);\n    return this.#search(pattern, options);\n  }\n\n  async *#search(\n    pattern: string | RegExp,\n    options?: StorageSearchOptions,\n  ): AsyncGenerator<StorageObjectMetadata, void> {\n    const context: StorageOperationContext = {\n      operation: 'search',\n      store: this.name,\n    };\n    try {\n      for (const plugin of this.#plugins) {\n        await plugin.beforeOperation?.(context);\n      }\n      for await (const object of this.#driver.search(pattern, options)) {\n        yield object;\n      }\n      for (const plugin of this.#plugins) {\n        await plugin.afterOperation?.(context, undefined);\n      }\n    } catch (error) {\n      const normalized = normalizeStorageError(error, {\n        operation: 'search',\n        store: this.name,\n      });\n      for (const plugin of this.#plugins) {\n        try {\n          await plugin.onError?.(context, normalized);\n        } catch {\n          // Preserve the original storage error.\n        }\n      }\n      throw normalized;\n    }\n  }\n\n  signDownload(\n    key: string,\n    options?: StorageSignedDownloadOptions,\n  ): Promise<string> {\n    assertKey(key);\n    return this.#execute(\n      { key, operation: 'signDownload', store: this.name },\n      () => this.#driver.signDownload(key, options),\n    );\n  }\n\n  signUpload(\n    key: string,\n    options: StorageSignedUploadOptions,\n  ): Promise<StorageSignedUpload> {\n    assertKey(key);\n    assertSignedUploadOptions(options);\n    return this.#execute(\n      { key, operation: 'signUpload', store: this.name },\n      () => this.#driver.signUpload(key, options),\n    );\n  }\n\n  async uploadMany(\n    items: readonly StorageUploadManyItem[],\n    options?: StorageUploadManyOptions,\n  ): Promise<StorageUploadManyResult> {\n    const settled = await settleMany(\n      items,\n      (item) => item.key,\n      (item) =>\n        this.upload(item.key, item.body, {\n          ...operationOptions(options),\n          ...(item.cacheControl !== undefined && {\n            cacheControl: item.cacheControl,\n          }),\n          ...(item.contentType !== undefined && {\n            contentType: item.contentType,\n          }),\n          ...(item.metadata !== undefined && { metadata: item.metadata }),\n          ...(item.multipart !== undefined && {\n            multipart: item.multipart,\n          }),\n          ...(options?.onProgress !== undefined && {\n            onProgress: (progress) =>\n              options.onProgress?.({ ...progress, key: item.key }),\n          }),\n        }),\n      options,\n    );\n\n    return {\n      uploaded: settled.results,\n      ...(settled.errors.length > 0 && { errors: settled.errors }),\n    };\n  }\n\n  async downloadMany(\n    keys: readonly string[],\n    options?: DownloadManyOptions,\n  ): Promise<StorageDownloadManyResult> {\n    const settled = await settleMany(\n      keys,\n      (key) => key,\n      (key) => this.downloadStream(key, downloadOptions(options)),\n      options,\n    );\n    return {\n      downloaded: settled.results,\n      ...(settled.errors.length > 0 && { errors: settled.errors }),\n    };\n  }\n\n  async headMany(\n    keys: readonly string[],\n    options?: BulkOperationOptions,\n  ): Promise<StorageHeadManyResult> {\n    const settled = await settleMany(\n      keys,\n      (key) => key,\n      (key) => this.head(key, operationOptions(options)),\n      options,\n    );\n    return {\n      objects: settled.results,\n      ...(settled.errors.length > 0 && { errors: settled.errors }),\n    };\n  }\n\n  async existsMany(\n    keys: readonly string[],\n    options?: BulkOperationOptions,\n  ): Promise<StorageExistsManyResult> {\n    const settled = await settleMany(\n      keys,\n      (key) => key,\n      async (key) => ({ exists: await this.exists(key, options), key }),\n      options,\n    );\n    const existing: string[] = [];\n    const missing: string[] = [];\n    for (const result of settled.results) {\n      (result.exists ? existing : missing).push(result.key);\n    }\n    return {\n      existing,\n      missing,\n      ...(settled.errors.length > 0 && { errors: settled.errors }),\n    };\n  }\n\n  async deleteMany(\n    keys: readonly string[],\n    options?: BulkOperationOptions,\n  ): Promise<StorageDeleteManyResult> {\n    const settled = await settleMany(\n      keys,\n      (key) => key,\n      async (key) => {\n        await this.delete(key, operationOptions(options));\n        return key;\n      },\n      options,\n    );\n    return {\n      deleted: settled.results,\n      ...(settled.errors.length > 0 && { errors: settled.errors }),\n    };\n  }\n\n  async onApplicationShutdown(): Promise<void> {\n    if (this.#closed) {\n      return;\n    }\n    this.#closed = true;\n    await this.#driver.close?.();\n  }\n\n  async #execute<Result>(\n    context: StorageOperationContext,\n    operation: () => Promise<Result>,\n    appliedMutation?: (result: Result) => AppliedMutationSettlement,\n  ): Promise<Result> {\n    let appliedSettlement: AppliedMutationSettlement | undefined;\n    try {\n      for (const plugin of this.#plugins) {\n        await plugin.beforeOperation?.(context);\n      }\n      const result = await operation();\n      if (appliedMutation !== undefined) {\n        // Settle before describing the result so even an unexpected local\n        // result-validation failure cannot turn a committed mutation into a\n        // safe-to-retry error.\n        appliedSettlement = {};\n        appliedSettlement = appliedMutation(result);\n      }\n      for (const plugin of this.#plugins) {\n        await plugin.afterOperation?.(context, result);\n      }\n      return result;\n    } catch (error) {\n      let normalized = normalizeStorageError(error, {\n        ...(context.key !== undefined && { key: context.key }),\n        operation: context.operation,\n        store: this.name,\n      });\n      if (appliedSettlement !== undefined) {\n        normalized = new StorageError(normalized.message, {\n          aborted: normalized.aborted,\n          applied: true,\n          ...(isCanonicalStorageEtag(appliedSettlement.appliedEtag) && {\n            appliedEtag: appliedSettlement.appliedEtag,\n          }),\n          cause: normalized.cause,\n          code: normalized.code,\n          ...(normalized.key !== undefined && { key: normalized.key }),\n          ...(normalized.operation !== undefined && {\n            operation: normalized.operation,\n          }),\n          permanent: normalized.permanent,\n          ...(normalized.store !== undefined && { store: normalized.store }),\n          timedOut: normalized.timedOut,\n        });\n      }\n      for (const plugin of this.#plugins) {\n        try {\n          await plugin.onError?.(context, normalized);\n        } catch {\n          // Preserve the original storage error.\n        }\n      }\n      throw normalized;\n    }\n  }\n}\n"]}