@nestm/storage 0.1.0-alpha.5 → 0.1.0-alpha.7

package/dist/storage.client.d.ts

@@ -1,17 +1,19 @@
 import type { StorageDriver } from './storage.driver.js';
-import type { StorageBody, StorageBufferedDownloadOptions, StorageBulkOptions, StorageCapabilities, 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';
+import type { StorageBody, StorageBufferedDownloadOptions, StorageBulkOptions, StorageCapabilities, StorageConditionalDeleteOptions, 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>;
     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>;
@@ -27,6 +29,7 @@ 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>;
     downloadBytes(key: string, options?: StorageBufferedDownloadOptions): Promise<Uint8Array>;
     downloadText(key: string, options?: StorageBufferedDownloadOptions): Promise<string>;
@@ -34,6 +37,7 @@ export declare class StorageClient {
     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>;
     /**

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

@@ -146,6 +146,7 @@ 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),
             exists: (options) => this.exists(key, options),
             head: (options) => this.head(key, options),
@@ -157,12 +158,40 @@ export class StorageClient {
             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' &&
+            (typeof condition.etag !== 'string' || condition.etag.length === 0)) {
+            invalidArgument('condition.etag must be a non-empty string.');
+        }
+        const capability = this.#driver.capabilities.conditionalMutation;
+        const uploadConditional = this.#driver.uploadConditional;
+        const supported = condition.type === 'create'
+            ? capability?.create === true
+            : capability?.replace === true;
+        if (!supported || 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));
+    }
     downloadStream(key, options) {
         assertKey(key);
         assertDownloadOptions(options);
@@ -204,6 +233,26 @@ 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 ||
+            typeof options.condition.etag !== 'string' ||
+            options.condition.etag.length === 0) {
+            invalidArgument('condition.etag must be a non-empty string.');
+        }
+        const capability = this.#driver.capabilities.conditionalMutation;
+        const deleteConditional = this.#driver.deleteConditional;
+        if (capability?.delete !== 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');

package/dist/storage.client.js.map

@@ -1 +1 @@
-{"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 {\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  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\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  /** 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      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      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    };\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  /**\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 && sourceEtag.length === 0) {\n      invalidArgument('sourceEtag must be a non-empty string.');\n    }\n    if (sourceVersion !== undefined && sourceVersion.length === 0) {\n      invalidArgument('sourceVersion must be a non-empty string.');\n    }\n    if (sourceEtag === undefined && sourceVersion === undefined) {\n      invalidArgument('promote requires sourceEtag, sourceVersion, or both.');\n    }\n\n    const capability = this.#driver.capabilities.conditionalCopy;\n    const promote = this.#driver.promote;\n    if (\n      capability?.supported !== true ||\n      promote === undefined ||\n      (sourceEtag !== undefined && !capability.etag) ||\n      (sourceVersion !== undefined && !capability.version)\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  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":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAC;AACvD,OAAO,EACL,YAAY,EACZ,gBAAgB,EAChB,qBAAqB,GACtB,MAAM,oBAAoB,CAAC;AAiC5B,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;AAoCD,MAAM,OAAO,aAAa;IAMb,IAAI;IALN,OAAO,CAAgB;IACvB,QAAQ,CAA2B;IAC5C,OAAO,GAAG,KAAK,CAAC;IAEhB,YACW,IAAY,EACrB,MAAqB,EACrB,OAAO,GAA6B,EAAE;oBAF7B,IAAI;QAIb,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,iBAAiB,EAAE,CAAC,OAAO,EAAE,EAAE,CAAC,IAAI,CAAC,iBAAiB,CAAC,GAAG,EAAE,OAAO,CAAC;YACpE,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,SAAS,EAAE,CAAC,cAAc,EAAE,OAAO,EAAE,EAAE,CACrC,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,cAAc,EAAE,OAAO,CAAC;YAC5C,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;YAC1D,iBAAiB,EAAE,CAAC,IAAI,EAAE,OAAO,EAAE,EAAE,CACnC,IAAI,CAAC,iBAAiB,CAAC,GAAG,EAAE,IAAI,EAAE,OAAO,CAAC;SAC7C,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,iBAAiB,CACf,GAAW,EACX,IAAiB,EACjB,OAAwC;QAExC,SAAS,CAAC,GAAG,CAAC,CAAC;QACf,MAAM,SAAS,GAAG,OAAO,CAAC,SAAS,CAAC;QACpC,IACE,SAAS,KAAK,SAAS;YACvB,CAAC,SAAS,CAAC,IAAI,KAAK,QAAQ,IAAI,SAAS,CAAC,IAAI,KAAK,SAAS,CAAC,EAC7D,CAAC;YACD,eAAe,CAAC,+CAA+C,CAAC,CAAC;QACnE,CAAC;QACD,IACE,SAAS,CAAC,IAAI,KAAK,SAAS;YAC5B,CAAC,OAAO,SAAS,CAAC,IAAI,KAAK,QAAQ,IAAI,SAAS,CAAC,IAAI,CAAC,MAAM,KAAK,CAAC,CAAC,EACnE,CAAC;YACD,eAAe,CAAC,4CAA4C,CAAC,CAAC;QAChE,CAAC;QAED,MAAM,UAAU,GAAG,IAAI,CAAC,OAAO,CAAC,YAAY,CAAC,mBAAmB,CAAC;QACjE,MAAM,iBAAiB,GAAG,IAAI,CAAC,OAAO,CAAC,iBAAiB,CAAC;QACzD,MAAM,SAAS,GACb,SAAS,CAAC,IAAI,KAAK,QAAQ;YACzB,CAAC,CAAC,UAAU,EAAE,MAAM,KAAK,IAAI;YAC7B,CAAC,CAAC,UAAU,EAAE,OAAO,KAAK,IAAI,CAAC;QACnC,IAAI,CAAC,SAAS,IAAI,iBAAiB,KAAK,SAAS,EAAE,CAAC;YAClD,MAAM,IAAI,YAAY,CACpB,UAAU,IAAI,CAAC,IAAI,sDAAsD,EACzE;gBACE,IAAI,EAAE,gBAAgB,CAAC,aAAa;gBACpC,GAAG;gBACH,SAAS,EAAE,QAAQ;gBACnB,SAAS,EAAE,IAAI;gBACf,KAAK,EAAE,IAAI,CAAC,IAAI;aACjB,CACF,CAAC;QACJ,CAAC;QAED,OAAO,IAAI,CAAC,QAAQ,CAAC,EAAE,GAAG,EAAE,SAAS,EAAE,QAAQ,EAAE,KAAK,EAAE,IAAI,CAAC,IAAI,EAAE,EAAE,GAAG,EAAE,CACxE,iBAAiB,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,GAAG,EAAE,IAAI,EAAE,OAAO,CAAC,CACzD,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,iBAAiB,CACf,GAAW,EACX,OAAwC;QAExC,SAAS,CAAC,GAAG,CAAC,CAAC;QACf,IACE,OAAO,CAAC,SAAS,KAAK,SAAS;YAC/B,OAAO,OAAO,CAAC,SAAS,CAAC,IAAI,KAAK,QAAQ;YAC1C,OAAO,CAAC,SAAS,CAAC,IAAI,CAAC,MAAM,KAAK,CAAC,EACnC,CAAC;YACD,eAAe,CAAC,4CAA4C,CAAC,CAAC;QAChE,CAAC;QAED,MAAM,UAAU,GAAG,IAAI,CAAC,OAAO,CAAC,YAAY,CAAC,mBAAmB,CAAC;QACjE,MAAM,iBAAiB,GAAG,IAAI,CAAC,OAAO,CAAC,iBAAiB,CAAC;QACzD,IAAI,UAAU,EAAE,MAAM,KAAK,IAAI,IAAI,iBAAiB,KAAK,SAAS,EAAE,CAAC;YACnE,MAAM,IAAI,YAAY,CACpB,UAAU,IAAI,CAAC,IAAI,wCAAwC,EAC3D;gBACE,IAAI,EAAE,gBAAgB,CAAC,aAAa;gBACpC,GAAG;gBACH,SAAS,EAAE,QAAQ;gBACnB,SAAS,EAAE,IAAI;gBACf,KAAK,EAAE,IAAI,CAAC,IAAI;aACjB,CACF,CAAC;QACJ,CAAC;QAED,OAAO,IAAI,CAAC,QAAQ,CAAC,EAAE,GAAG,EAAE,SAAS,EAAE,QAAQ,EAAE,KAAK,EAAE,IAAI,CAAC,IAAI,EAAE,EAAE,GAAG,EAAE,CACxE,iBAAiB,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,GAAG,EAAE,OAAO,CAAC,CACnD,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;;;OAGG;IACH,OAAO,CACL,SAAiB,EACjB,cAAsB,EACtB,OAAgC;QAEhC,SAAS,CAAC,SAAS,EAAE,YAAY,CAAC,CAAC;QACnC,SAAS,CAAC,cAAc,EAAE,iBAAiB,CAAC,CAAC;QAC7C,MAAM,UAAU,GAAG,OAAO,CAAC,UAAU,CAAC;QACtC,MAAM,aAAa,GAAG,OAAO,CAAC,aAAa,CAAC;QAC5C,IAAI,UAAU,KAAK,SAAS,IAAI,UAAU,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACxD,eAAe,CAAC,wCAAwC,CAAC,CAAC;QAC5D,CAAC;QACD,IAAI,aAAa,KAAK,SAAS,IAAI,aAAa,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC9D,eAAe,CAAC,2CAA2C,CAAC,CAAC;QAC/D,CAAC;QACD,IAAI,UAAU,KAAK,SAAS,IAAI,aAAa,KAAK,SAAS,EAAE,CAAC;YAC5D,eAAe,CAAC,sDAAsD,CAAC,CAAC;QAC1E,CAAC;QAED,MAAM,UAAU,GAAG,IAAI,CAAC,OAAO,CAAC,YAAY,CAAC,eAAe,CAAC;QAC7D,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC;QACrC,IACE,UAAU,EAAE,SAAS,KAAK,IAAI;YAC9B,OAAO,KAAK,SAAS;YACrB,CAAC,UAAU,KAAK,SAAS,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC;YAC9C,CAAC,aAAa,KAAK,SAAS,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,EACpD,CAAC;YACD,MAAM,IAAI,YAAY,CACpB,UAAU,IAAI,CAAC,IAAI,yDAAyD,EAC5E;gBACE,IAAI,EAAE,gBAAgB,CAAC,aAAa;gBACpC,GAAG,EAAE,SAAS;gBACd,SAAS,EAAE,SAAS;gBACpB,SAAS,EAAE,IAAI;gBACf,KAAK,EAAE,IAAI,CAAC,IAAI;aACjB,CACF,CAAC;QACJ,CAAC;QAED,OAAO,IAAI,CAAC,QAAQ,CAClB;YACE,IAAI,EAAE,SAAS;YACf,SAAS,EAAE,SAAS;YACpB,KAAK,EAAE,IAAI,CAAC,IAAI;YAChB,EAAE,EAAE,cAAc;SACnB,EACD,GAAG,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,SAAS,EAAE,cAAc,EAAE,OAAO,CAAC,CACrE,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  StorageConditionalDeleteOptions,\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\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  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      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      (typeof condition.etag !== 'string' || condition.etag.length === 0)\n    ) {\n      invalidArgument('condition.etag must be a non-empty string.');\n    }\n\n    const capability = this.#driver.capabilities.conditionalMutation;\n    const uploadConditional = this.#driver.uploadConditional;\n    const supported =\n      condition.type === 'create'\n        ? capability?.create === true\n        : capability?.replace === true;\n    if (!supported || uploadConditional === undefined) {\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({ key, operation: 'upload', store: this.name }, () =>\n      uploadConditional.call(this.#driver, 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  deleteConditional(\n    key: string,\n    options: StorageConditionalDeleteOptions,\n  ): Promise<void> {\n    assertKey(key);\n    if (\n      options.condition === undefined ||\n      typeof options.condition.etag !== 'string' ||\n      options.condition.etag.length === 0\n    ) {\n      invalidArgument('condition.etag must be a non-empty string.');\n    }\n\n    const capability = this.#driver.capabilities.conditionalMutation;\n    const deleteConditional = this.#driver.deleteConditional;\n    if (capability?.delete !== 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({ key, operation: 'delete', store: this.name }, () =>\n      deleteConditional.call(this.#driver, 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  /**\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 && sourceEtag.length === 0) {\n      invalidArgument('sourceEtag must be a non-empty string.');\n    }\n    if (sourceVersion !== undefined && sourceVersion.length === 0) {\n      invalidArgument('sourceVersion must be a non-empty string.');\n    }\n    if (sourceEtag === undefined && sourceVersion === undefined) {\n      invalidArgument('promote requires sourceEtag, sourceVersion, or both.');\n    }\n\n    const capability = this.#driver.capabilities.conditionalCopy;\n    const promote = this.#driver.promote;\n    if (\n      capability?.supported !== true ||\n      promote === undefined ||\n      (sourceEtag !== undefined && !capability.etag) ||\n      (sourceVersion !== undefined && !capability.version)\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  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"]}

package/dist/storage.driver.d.ts

@@ -1,12 +1,14 @@
-import type { StorageBody, StorageCapabilities, StorageDownloadOptions, StorageListOptions, StorageListResult, StorageObject, StorageObjectMetadata, StorageOperationOptions, StoragePromotionOptions, StorageSearchOptions, StorageSignedDownloadOptions, StorageSignedUpload, StorageSignedUploadOptions, StorageUploadOptions, StorageUploadResult } from './storage.types.js';
+import type { StorageBody, StorageCapabilities, StorageConditionalDeleteOptions, StorageConditionalUploadOptions, StorageDownloadOptions, StorageListOptions, StorageListResult, StorageObject, StorageObjectMetadata, StorageOperationOptions, StoragePromotionOptions, StorageSearchOptions, StorageSignedDownloadOptions, StorageSignedUpload, StorageSignedUploadOptions, StorageUploadOptions, StorageUploadResult } from './storage.types.js';
 export interface StorageDriver {
     readonly name: string;
     readonly capabilities: StorageCapabilities;
     upload(key: string, body: StorageBody, options?: StorageUploadOptions): Promise<StorageUploadResult>;
+    uploadConditional?(key: string, body: StorageBody, options: StorageConditionalUploadOptions): Promise<StorageUploadResult>;
     download(key: string, options?: StorageDownloadOptions): Promise<StorageObject>;
     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>;
     /**

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

@@ -1 +1 @@
-{"version":3,"file":"storage.driver.d.ts","sourceRoot":"","sources":["../src/storage.driver.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,WAAW,EACX,mBAAmB,EACnB,sBAAsB,EACtB,kBAAkB,EAClB,iBAAiB,EACjB,aAAa,EACb,qBAAqB,EACrB,uBAAuB,EACvB,uBAAuB,EACvB,oBAAoB,EACpB,4BAA4B,EAC5B,mBAAmB,EACnB,0BAA0B,EAC1B,oBAAoB,EACpB,mBAAmB,EACpB,MAAM,oBAAoB,CAAC;AAE5B,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,YAAY,EAAE,mBAAmB,CAAC;IAE3C,MAAM,CACJ,GAAG,EAAE,MAAM,EACX,IAAI,EAAE,WAAW,EACjB,OAAO,CAAC,EAAE,oBAAoB,GAC7B,OAAO,CAAC,mBAAmB,CAAC,CAAC;IAChC,QAAQ,CACN,GAAG,EAAE,MAAM,EACX,OAAO,CAAC,EAAE,sBAAsB,GAC/B,OAAO,CAAC,aAAa,CAAC,CAAC;IAC1B,IAAI,CACF,GAAG,EAAE,MAAM,EACX,OAAO,CAAC,EAAE,uBAAuB,GAChC,OAAO,CAAC,qBAAqB,CAAC,CAAC;IAClC,MAAM,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,uBAAuB,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IACzE,MAAM,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,uBAAuB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACtE,IAAI,CACF,SAAS,EAAE,MAAM,EACjB,cAAc,EAAE,MAAM,EACtB,OAAO,CAAC,EAAE,uBAAuB,GAChC,OAAO,CAAC,IAAI,CAAC,CAAC;IACjB,IAAI,CACF,SAAS,EAAE,MAAM,EACjB,cAAc,EAAE,MAAM,EACtB,OAAO,CAAC,EAAE,uBAAuB,GAChC,OAAO,CAAC,IAAI,CAAC,CAAC;IACjB;;;OAGG;IACH,OAAO,CAAC,CACN,SAAS,EAAE,MAAM,EACjB,cAAc,EAAE,MAAM,EACtB,OAAO,EAAE,uBAAuB,GAC/B,OAAO,CAAC,IAAI,CAAC,CAAC;IACjB,IAAI,CAAC,OAAO,CAAC,EAAE,kBAAkB,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAAC;IAC/D,MAAM,CACJ,OAAO,EAAE,MAAM,GAAG,MAAM,EACxB,OAAO,CAAC,EAAE,oBAAoB,GAC7B,aAAa,CAAC,qBAAqB,CAAC,CAAC;IACxC,YAAY,CACV,GAAG,EAAE,MAAM,EACX,OAAO,CAAC,EAAE,4BAA4B,GACrC,OAAO,CAAC,MAAM,CAAC,CAAC;IACnB,UAAU,CACR,GAAG,EAAE,MAAM,EACX,OAAO,EAAE,0BAA0B,GAClC,OAAO,CAAC,mBAAmB,CAAC,CAAC;IAChC,KAAK,CAAC,IAAI,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAChC"}
+{"version":3,"file":"storage.driver.d.ts","sourceRoot":"","sources":["../src/storage.driver.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,WAAW,EACX,mBAAmB,EACnB,+BAA+B,EAC/B,+BAA+B,EAC/B,sBAAsB,EACtB,kBAAkB,EAClB,iBAAiB,EACjB,aAAa,EACb,qBAAqB,EACrB,uBAAuB,EACvB,uBAAuB,EACvB,oBAAoB,EACpB,4BAA4B,EAC5B,mBAAmB,EACnB,0BAA0B,EAC1B,oBAAoB,EACpB,mBAAmB,EACpB,MAAM,oBAAoB,CAAC;AAE5B,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,YAAY,EAAE,mBAAmB,CAAC;IAE3C,MAAM,CACJ,GAAG,EAAE,MAAM,EACX,IAAI,EAAE,WAAW,EACjB,OAAO,CAAC,EAAE,oBAAoB,GAC7B,OAAO,CAAC,mBAAmB,CAAC,CAAC;IAChC,iBAAiB,CAAC,CAChB,GAAG,EAAE,MAAM,EACX,IAAI,EAAE,WAAW,EACjB,OAAO,EAAE,+BAA+B,GACvC,OAAO,CAAC,mBAAmB,CAAC,CAAC;IAChC,QAAQ,CACN,GAAG,EAAE,MAAM,EACX,OAAO,CAAC,EAAE,sBAAsB,GAC/B,OAAO,CAAC,aAAa,CAAC,CAAC;IAC1B,IAAI,CACF,GAAG,EAAE,MAAM,EACX,OAAO,CAAC,EAAE,uBAAuB,GAChC,OAAO,CAAC,qBAAqB,CAAC,CAAC;IAClC,MAAM,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,uBAAuB,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IACzE,MAAM,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,uBAAuB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACtE,iBAAiB,CAAC,CAChB,GAAG,EAAE,MAAM,EACX,OAAO,EAAE,+BAA+B,GACvC,OAAO,CAAC,IAAI,CAAC,CAAC;IACjB,IAAI,CACF,SAAS,EAAE,MAAM,EACjB,cAAc,EAAE,MAAM,EACtB,OAAO,CAAC,EAAE,uBAAuB,GAChC,OAAO,CAAC,IAAI,CAAC,CAAC;IACjB,IAAI,CACF,SAAS,EAAE,MAAM,EACjB,cAAc,EAAE,MAAM,EACtB,OAAO,CAAC,EAAE,uBAAuB,GAChC,OAAO,CAAC,IAAI,CAAC,CAAC;IACjB;;;OAGG;IACH,OAAO,CAAC,CACN,SAAS,EAAE,MAAM,EACjB,cAAc,EAAE,MAAM,EACtB,OAAO,EAAE,uBAAuB,GAC/B,OAAO,CAAC,IAAI,CAAC,CAAC;IACjB,IAAI,CAAC,OAAO,CAAC,EAAE,kBAAkB,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAAC;IAC/D,MAAM,CACJ,OAAO,EAAE,MAAM,GAAG,MAAM,EACxB,OAAO,CAAC,EAAE,oBAAoB,GAC7B,aAAa,CAAC,qBAAqB,CAAC,CAAC;IACxC,YAAY,CACV,GAAG,EAAE,MAAM,EACX,OAAO,CAAC,EAAE,4BAA4B,GACrC,OAAO,CAAC,MAAM,CAAC,CAAC;IACnB,UAAU,CACR,GAAG,EAAE,MAAM,EACX,OAAO,EAAE,0BAA0B,GAClC,OAAO,CAAC,mBAAmB,CAAC,CAAC;IAChC,KAAK,CAAC,IAAI,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAChC"}

package/dist/storage.driver.js.map

@@ -1 +1 @@
-{"version":3,"file":"storage.driver.js","sourceRoot":"","sources":["../src/storage.driver.ts"],"names":[],"mappings":"","sourcesContent":["import type {\n  StorageBody,\n  StorageCapabilities,\n  StorageDownloadOptions,\n  StorageListOptions,\n  StorageListResult,\n  StorageObject,\n  StorageObjectMetadata,\n  StorageOperationOptions,\n  StoragePromotionOptions,\n  StorageSearchOptions,\n  StorageSignedDownloadOptions,\n  StorageSignedUpload,\n  StorageSignedUploadOptions,\n  StorageUploadOptions,\n  StorageUploadResult,\n} from './storage.types.js';\n\nexport interface StorageDriver {\n  readonly name: string;\n  readonly capabilities: StorageCapabilities;\n\n  upload(\n    key: string,\n    body: StorageBody,\n    options?: StorageUploadOptions,\n  ): Promise<StorageUploadResult>;\n  download(\n    key: string,\n    options?: StorageDownloadOptions,\n  ): Promise<StorageObject>;\n  head(\n    key: string,\n    options?: StorageOperationOptions,\n  ): Promise<StorageObjectMetadata>;\n  exists(key: string, options?: StorageOperationOptions): Promise<boolean>;\n  delete(key: string, options?: StorageOperationOptions): Promise<void>;\n  copy(\n    sourceKey: string,\n    destinationKey: string,\n    options?: StorageOperationOptions,\n  ): Promise<void>;\n  move(\n    sourceKey: string,\n    destinationKey: string,\n    options?: StorageOperationOptions,\n  ): Promise<void>;\n  /**\n   * Conditionally copies a staged object to its final key. The source remains\n   * in place so applications can delete it only after their metadata commit.\n   */\n  promote?(\n    sourceKey: string,\n    destinationKey: string,\n    options: StoragePromotionOptions,\n  ): Promise<void>;\n  list(options?: StorageListOptions): Promise<StorageListResult>;\n  search(\n    pattern: string | RegExp,\n    options?: StorageSearchOptions,\n  ): AsyncIterable<StorageObjectMetadata>;\n  signDownload(\n    key: string,\n    options?: StorageSignedDownloadOptions,\n  ): Promise<string>;\n  signUpload(\n    key: string,\n    options: StorageSignedUploadOptions,\n  ): Promise<StorageSignedUpload>;\n  close?(): void | Promise<void>;\n}\n"]}
+{"version":3,"file":"storage.driver.js","sourceRoot":"","sources":["../src/storage.driver.ts"],"names":[],"mappings":"","sourcesContent":["import type {\n  StorageBody,\n  StorageCapabilities,\n  StorageConditionalDeleteOptions,\n  StorageConditionalUploadOptions,\n  StorageDownloadOptions,\n  StorageListOptions,\n  StorageListResult,\n  StorageObject,\n  StorageObjectMetadata,\n  StorageOperationOptions,\n  StoragePromotionOptions,\n  StorageSearchOptions,\n  StorageSignedDownloadOptions,\n  StorageSignedUpload,\n  StorageSignedUploadOptions,\n  StorageUploadOptions,\n  StorageUploadResult,\n} from './storage.types.js';\n\nexport interface StorageDriver {\n  readonly name: string;\n  readonly capabilities: StorageCapabilities;\n\n  upload(\n    key: string,\n    body: StorageBody,\n    options?: StorageUploadOptions,\n  ): Promise<StorageUploadResult>;\n  uploadConditional?(\n    key: string,\n    body: StorageBody,\n    options: StorageConditionalUploadOptions,\n  ): Promise<StorageUploadResult>;\n  download(\n    key: string,\n    options?: StorageDownloadOptions,\n  ): Promise<StorageObject>;\n  head(\n    key: string,\n    options?: StorageOperationOptions,\n  ): Promise<StorageObjectMetadata>;\n  exists(key: string, options?: StorageOperationOptions): Promise<boolean>;\n  delete(key: string, options?: StorageOperationOptions): Promise<void>;\n  deleteConditional?(\n    key: string,\n    options: StorageConditionalDeleteOptions,\n  ): Promise<void>;\n  copy(\n    sourceKey: string,\n    destinationKey: string,\n    options?: StorageOperationOptions,\n  ): Promise<void>;\n  move(\n    sourceKey: string,\n    destinationKey: string,\n    options?: StorageOperationOptions,\n  ): Promise<void>;\n  /**\n   * Conditionally copies a staged object to its final key. The source remains\n   * in place so applications can delete it only after their metadata commit.\n   */\n  promote?(\n    sourceKey: string,\n    destinationKey: string,\n    options: StoragePromotionOptions,\n  ): Promise<void>;\n  list(options?: StorageListOptions): Promise<StorageListResult>;\n  search(\n    pattern: string | RegExp,\n    options?: StorageSearchOptions,\n  ): AsyncIterable<StorageObjectMetadata>;\n  signDownload(\n    key: string,\n    options?: StorageSignedDownloadOptions,\n  ): Promise<string>;\n  signUpload(\n    key: string,\n    options: StorageSignedUploadOptions,\n  ): Promise<StorageSignedUpload>;\n  close?(): void | Promise<void>;\n}\n"]}

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

@@ -1 +1 @@
-{"version":3,"file":"storage.service.d.ts","sourceRoot":"","sources":["../src/storage.service.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAGpD,OAAO,KAAK,EAIV,kBAAkB,EAElB,iBAAiB,EACjB,sBAAsB,EAEtB,qBAAqB,EACtB,MAAM,oBAAoB,CAAC;AAuD5B,qBAAa,cAAc;;IAKvB,OAAO,CAAC,QAAQ,CAAC,WAAW;IAF9B,YACE,OAAO,EAAE,WAAW,CAAC,MAAM,EAAE,aAAa,CAAC,EAC1B,WAAW,EAAE,MAAM,GAAG,IAAI,EAG5C;IAED,IAAI,KAAK,IAAI,SAAS,MAAM,EAAE,CAE7B;IAED,GAAG,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,aAAa,CA6BhC;IAEK,QAAQ,CACZ,OAAO,EAAE,sBAAsB,GAC9B,OAAO,CAAC,qBAAqB,CAAC,CA6EhC;IAEK,IAAI,CAAC,OAAO,EAAE,kBAAkB,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAqIlE;CACF"}
+{"version":3,"file":"storage.service.d.ts","sourceRoot":"","sources":["../src/storage.service.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAGpD,OAAO,KAAK,EAIV,kBAAkB,EAElB,iBAAiB,EACjB,sBAAsB,EAEtB,qBAAqB,EACtB,MAAM,oBAAoB,CAAC;AAwF5B,qBAAa,cAAc;;IAKvB,OAAO,CAAC,QAAQ,CAAC,WAAW;IAF9B,YACE,OAAO,EAAE,WAAW,CAAC,MAAM,EAAE,aAAa,CAAC,EAC1B,WAAW,EAAE,MAAM,GAAG,IAAI,EAG5C;IAED,IAAI,KAAK,IAAI,SAAS,MAAM,EAAE,CAE7B;IAED,GAAG,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,aAAa,CA6BhC;IAEK,QAAQ,CACZ,OAAO,EAAE,sBAAsB,GAC9B,OAAO,CAAC,qBAAqB,CAAC,CA6EhC;IAEK,IAAI,CAAC,OAAO,EAAE,kBAAkB,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAuIlE;CACF"}

package/dist/storage.service.js

@@ -3,6 +3,30 @@ import { StorageClient } from './storage.client.js';
 import { StorageError, StorageErrorCode } from './storage.error.js';
 import { normalizeStorageName } from './storage.tokens.js';
 const identity = (key) => key;
+function joinStorageKey(prefix, key) {
+    if (prefix === undefined || prefix.length === 0) {
+        return key;
+    }
+    const normalizedPrefix = prefix.replace(/\/+$/u, '');
+    for (const [label, value] of [
+        ['destinationPrefix', normalizedPrefix],
+        ['transformed destination key', key],
+    ]) {
+        if (value.length === 0 ||
+            value.startsWith('/') ||
+            value.includes('\\') ||
+            value.includes('\0') ||
+            value
+                .split('/')
+                .some((segment) => segment.length === 0 || segment === '.' || segment === '..')) {
+            throw new StorageError(`${label} must be a canonical relative POSIX storage key.`, {
+                code: StorageErrorCode.INVALID_ARGUMENT,
+                permanent: true,
+            });
+        }
+    }
+    return `${normalizedPrefix}/${key}`;
+}
 function assertDifferentStores(from, to) {
     if (from === to) {
         throw new StorageError('Cross-store transfer and sync require different source and destination stores.', {
@@ -137,6 +161,7 @@ export class StorageService {
         const source = this.use(fromName);
         const destination = this.use(toName);
         const transformKey = options.transformKey ?? identity;
+        const destinationKeyOf = (key) => joinStorageKey(options.destinationPrefix, transformKey(key));
         const compare = options.compare ?? 'etag';
         const sourceObjects = await walk(source, options);
         const destinationObjects = await walk(destination, {
@@ -149,7 +174,7 @@ export class StorageService {
             ...(options.signal !== undefined && { signal: options.signal }),
         });
         const destinationIndex = new Map(destinationObjects.map((object) => [object.key, object]));
-        const desiredDestinationKeys = new Set(sourceObjects.map((object) => transformKey(object.key)));
+        const desiredDestinationKeys = new Set(sourceObjects.map((object) => destinationKeyOf(object.key)));
         const deleteKeys = (options.prune ?? false)
             ? destinationObjects
                 .map((object) => object.key)
@@ -158,7 +183,7 @@ export class StorageService {
         const plannedUploads = [];
         const plannedSkips = [];
         for (const object of sourceObjects) {
-            const existing = destinationIndex.get(transformKey(object.key));
+            const existing = destinationIndex.get(destinationKeyOf(object.key));
             (existing && unchanged(object, existing, compare)
                 ? plannedSkips
                 : plannedUploads).push(object.key);
@@ -178,7 +203,7 @@ export class StorageService {
         };
         const skipped = new Set();
         const settled = await settleMany(sourceObjects, (object) => object.key, async (object) => {
-            const destinationKey = transformKey(object.key);
+            const destinationKey = destinationKeyOf(object.key);
             const existing = destinationIndex.get(destinationKey);
             if (existing && unchanged(object, existing, compare)) {
                 skipped.add(object.key);

package/dist/storage.service.js.map

@@ -1 +1 @@
-{"version":3,"file":"storage.service.js","sourceRoot":"","sources":["../src/storage.service.ts"],"names":[],"mappings":"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","sourcesContent":["import { settleMany } from './internal/settle-many.js';\nimport { StorageClient } from './storage.client.js';\nimport { StorageError, StorageErrorCode } from './storage.error.js';\nimport { normalizeStorageName } from './storage.tokens.js';\nimport type {\n  StorageBulkError,\n  StorageObjectMetadata,\n  StorageSyncCompare,\n  StorageSyncOptions,\n  StorageSyncProgress,\n  StorageSyncResult,\n  StorageTransferOptions,\n  StorageTransferProgress,\n  StorageTransferResult,\n} from './storage.types.js';\n\nconst identity = (key: string): string => key;\n\nfunction assertDifferentStores(from: string, to: string): void {\n  if (from === to) {\n    throw new StorageError(\n      'Cross-store transfer and sync require different source and destination stores.',\n      {\n        code: StorageErrorCode.INVALID_ARGUMENT,\n        permanent: true,\n        store: from,\n      },\n    );\n  }\n}\n\nfunction unchanged(\n  source: StorageObjectMetadata,\n  destination: StorageObjectMetadata,\n  compare: StorageSyncCompare,\n): boolean {\n  if (typeof compare === 'function') {\n    return compare(source, destination);\n  }\n  if (compare === 'size') {\n    return source.size === destination.size;\n  }\n  return (\n    source.size === destination.size &&\n    source.etag !== undefined &&\n    destination.etag !== undefined &&\n    source.etag === destination.etag\n  );\n}\n\nasync function walk(\n  client: StorageClient,\n  options: {\n    prefix?: string;\n    limit?: number;\n    signal?: AbortSignal;\n  },\n): Promise<StorageObjectMetadata[]> {\n  const objects: StorageObjectMetadata[] = [];\n  for await (const object of client.listAll({\n    ...(options.limit !== undefined && { limit: options.limit }),\n    ...(options.prefix !== undefined && { prefix: options.prefix }),\n    ...(options.signal !== undefined && { signal: options.signal }),\n  })) {\n    objects.push(object);\n  }\n  return objects;\n}\n\nexport class StorageService {\n  readonly #clients: ReadonlyMap<string, StorageClient>;\n\n  constructor(\n    clients: ReadonlyMap<string, StorageClient>,\n    private readonly defaultName: string | null,\n  ) {\n    this.#clients = new Map(clients);\n  }\n\n  get names(): readonly string[] {\n    return [...this.#clients.keys()].sort();\n  }\n\n  use(name?: string): StorageClient {\n    const resolved =\n      name === undefined ? this.defaultName : normalizeStorageName(name);\n\n    if (resolved === null) {\n      throw new StorageError(\n        'No default storage store is configured; call storage.use(name).',\n        {\n          code: StorageErrorCode.INVALID_ARGUMENT,\n          permanent: true,\n        },\n      );\n    }\n\n    const client = this.#clients.get(resolved);\n    if (client === undefined) {\n      const available = this.names;\n      throw new StorageError(\n        available.length === 0\n          ? `Storage store \"${resolved}\" is not registered.`\n          : `Storage store \"${resolved}\" is not registered. Available stores: ${available.join(', ')}.`,\n        {\n          code: StorageErrorCode.INVALID_ARGUMENT,\n          permanent: true,\n          store: resolved,\n        },\n      );\n    }\n    return client;\n  }\n\n  async transfer(\n    options: StorageTransferOptions,\n  ): Promise<StorageTransferResult> {\n    const fromName = normalizeStorageName(options.from);\n    const toName = normalizeStorageName(options.to);\n    assertDifferentStores(fromName, toName);\n    const source = this.use(fromName);\n    const destination = this.use(toName);\n    const transformKey = options.transformKey ?? identity;\n    const overwrite = options.overwrite ?? true;\n    const objects = await walk(source, options);\n    const total = objects.length;\n    let done = 0;\n    const skipped = new Set<string>();\n\n    const report = (\n      key: string,\n      status: StorageTransferProgress['status'],\n    ): void => {\n      done += 1;\n      options.onProgress?.({ done, key, status, total });\n    };\n\n    const settled = await settleMany(\n      objects,\n      (object) => object.key,\n      async (object) => {\n        const destinationKey = transformKey(object.key);\n        if (\n          !overwrite &&\n          (await destination.exists(destinationKey, {\n            ...(options.signal !== undefined && {\n              signal: options.signal,\n            }),\n          }))\n        ) {\n          skipped.add(object.key);\n          report(object.key, 'skipped');\n          return object.key;\n        }\n\n        const downloaded = await source.downloadStream(object.key, {\n          ...(options.signal !== undefined && {\n            signal: options.signal,\n          }),\n        });\n        try {\n          await destination.upload(destinationKey, downloaded.body, {\n            contentType: downloaded.contentType,\n            ...(downloaded.metadata !== undefined && {\n              metadata: downloaded.metadata,\n            }),\n            ...(options.signal !== undefined && {\n              signal: options.signal,\n            }),\n          });\n        } catch (error) {\n          if (!downloaded.body.locked) {\n            await downloaded.body.cancel().catch(() => undefined);\n          }\n          throw error;\n        }\n        report(object.key, 'transferred');\n        return object.key;\n      },\n      options,\n    );\n\n    const transferred: string[] = [];\n    const skippedKeys: string[] = [];\n    for (const key of settled.results) {\n      (skipped.has(key) ? skippedKeys : transferred).push(key);\n    }\n\n    return {\n      transferred,\n      ...(skippedKeys.length > 0 && { skipped: skippedKeys }),\n      ...(settled.errors.length > 0 && { errors: settled.errors }),\n    };\n  }\n\n  async sync(options: StorageSyncOptions): Promise<StorageSyncResult> {\n    const fromName = normalizeStorageName(options.from);\n    const toName = normalizeStorageName(options.to);\n    assertDifferentStores(fromName, toName);\n    const source = this.use(fromName);\n    const destination = this.use(toName);\n    const transformKey = options.transformKey ?? identity;\n    const compare = options.compare ?? 'etag';\n    const sourceObjects = await walk(source, options);\n    const destinationObjects = await walk(destination, {\n      ...(options.destinationPrefix !== undefined\n        ? { prefix: options.destinationPrefix }\n        : options.prefix !== undefined\n          ? { prefix: options.prefix }\n          : {}),\n      ...(options.limit !== undefined && { limit: options.limit }),\n      ...(options.signal !== undefined && { signal: options.signal }),\n    });\n    const destinationIndex = new Map(\n      destinationObjects.map((object) => [object.key, object]),\n    );\n    const desiredDestinationKeys = new Set(\n      sourceObjects.map((object) => transformKey(object.key)),\n    );\n    const deleteKeys =\n      (options.prune ?? false)\n        ? destinationObjects\n            .map((object) => object.key)\n            .filter((key) => !desiredDestinationKeys.has(key))\n        : [];\n\n    const plannedUploads: string[] = [];\n    const plannedSkips: string[] = [];\n    for (const object of sourceObjects) {\n      const existing = destinationIndex.get(transformKey(object.key));\n      (existing && unchanged(object, existing, compare)\n        ? plannedSkips\n        : plannedUploads\n      ).push(object.key);\n    }\n\n    if (options.dryRun) {\n      return {\n        uploaded: plannedUploads,\n        skipped: plannedSkips,\n        ...(options.prune && { deleted: deleteKeys }),\n      };\n    }\n\n    const total =\n      sourceObjects.length + (options.prune ? deleteKeys.length : 0);\n    let done = 0;\n    const report = (\n      key: string,\n      status: StorageSyncProgress['status'],\n    ): void => {\n      done += 1;\n      options.onProgress?.({ done, key, status, total });\n    };\n    const skipped = new Set<string>();\n\n    const settled = await settleMany(\n      sourceObjects,\n      (object) => object.key,\n      async (object) => {\n        const destinationKey = transformKey(object.key);\n        const existing = destinationIndex.get(destinationKey);\n        if (existing && unchanged(object, existing, compare)) {\n          skipped.add(object.key);\n          report(object.key, 'skipped');\n          return object.key;\n        }\n        const downloaded = await source.downloadStream(object.key, {\n          ...(options.signal !== undefined && {\n            signal: options.signal,\n          }),\n        });\n        try {\n          await destination.upload(destinationKey, downloaded.body, {\n            contentType: downloaded.contentType,\n            ...(downloaded.metadata !== undefined && {\n              metadata: downloaded.metadata,\n            }),\n            ...(options.signal !== undefined && {\n              signal: options.signal,\n            }),\n          });\n        } catch (error) {\n          if (!downloaded.body.locked) {\n            await downloaded.body.cancel().catch(() => undefined);\n          }\n          throw error;\n        }\n        report(object.key, 'uploaded');\n        return object.key;\n      },\n      options,\n    );\n\n    const uploaded: string[] = [];\n    const skippedKeys: string[] = [];\n    for (const key of settled.results) {\n      (skipped.has(key) ? skippedKeys : uploaded).push(key);\n    }\n\n    let deleted: string[] | undefined;\n    let deleteErrors: StorageBulkError[] = [];\n    const canPrune =\n      options.prune && !(options.stopOnError && settled.errors.length > 0);\n    if (canPrune) {\n      const deleteResult = await destination.deleteMany(deleteKeys, {\n        ...(options.concurrency !== undefined && {\n          concurrency: options.concurrency,\n        }),\n        ...(options.signal !== undefined && { signal: options.signal }),\n        ...(options.stopOnError !== undefined && {\n          stopOnError: options.stopOnError,\n        }),\n      });\n      deleted = deleteResult.deleted;\n      deleteErrors = deleteResult.errors ?? [];\n      for (const key of deleted) {\n        report(key, 'deleted');\n      }\n    }\n\n    const errors = [...settled.errors, ...deleteErrors];\n    return {\n      uploaded,\n      skipped: skippedKeys,\n      ...(options.prune && { deleted: deleted ?? [] }),\n      ...(errors.length > 0 && { errors }),\n    };\n  }\n}\n"]}
+{"version":3,"file":"storage.service.js","sourceRoot":"","sources":["../src/storage.service.ts"],"names":[],"mappings":"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","sourcesContent":["import { settleMany } from './internal/settle-many.js';\nimport { StorageClient } from './storage.client.js';\nimport { StorageError, StorageErrorCode } from './storage.error.js';\nimport { normalizeStorageName } from './storage.tokens.js';\nimport type {\n  StorageBulkError,\n  StorageObjectMetadata,\n  StorageSyncCompare,\n  StorageSyncOptions,\n  StorageSyncProgress,\n  StorageSyncResult,\n  StorageTransferOptions,\n  StorageTransferProgress,\n  StorageTransferResult,\n} from './storage.types.js';\n\nconst identity = (key: string): string => key;\n\nfunction joinStorageKey(prefix: string | undefined, key: string): string {\n  if (prefix === undefined || prefix.length === 0) {\n    return key;\n  }\n  const normalizedPrefix = prefix.replace(/\\/+$/u, '');\n  for (const [label, value] of [\n    ['destinationPrefix', normalizedPrefix],\n    ['transformed destination key', key],\n  ] as const) {\n    if (\n      value.length === 0 ||\n      value.startsWith('/') ||\n      value.includes('\\\\') ||\n      value.includes('\\0') ||\n      value\n        .split('/')\n        .some(\n          (segment) =>\n            segment.length === 0 || segment === '.' || segment === '..',\n        )\n    ) {\n      throw new StorageError(\n        `${label} must be a canonical relative POSIX storage key.`,\n        {\n          code: StorageErrorCode.INVALID_ARGUMENT,\n          permanent: true,\n        },\n      );\n    }\n  }\n  return `${normalizedPrefix}/${key}`;\n}\n\nfunction assertDifferentStores(from: string, to: string): void {\n  if (from === to) {\n    throw new StorageError(\n      'Cross-store transfer and sync require different source and destination stores.',\n      {\n        code: StorageErrorCode.INVALID_ARGUMENT,\n        permanent: true,\n        store: from,\n      },\n    );\n  }\n}\n\nfunction unchanged(\n  source: StorageObjectMetadata,\n  destination: StorageObjectMetadata,\n  compare: StorageSyncCompare,\n): boolean {\n  if (typeof compare === 'function') {\n    return compare(source, destination);\n  }\n  if (compare === 'size') {\n    return source.size === destination.size;\n  }\n  return (\n    source.size === destination.size &&\n    source.etag !== undefined &&\n    destination.etag !== undefined &&\n    source.etag === destination.etag\n  );\n}\n\nasync function walk(\n  client: StorageClient,\n  options: {\n    prefix?: string;\n    limit?: number;\n    signal?: AbortSignal;\n  },\n): Promise<StorageObjectMetadata[]> {\n  const objects: StorageObjectMetadata[] = [];\n  for await (const object of client.listAll({\n    ...(options.limit !== undefined && { limit: options.limit }),\n    ...(options.prefix !== undefined && { prefix: options.prefix }),\n    ...(options.signal !== undefined && { signal: options.signal }),\n  })) {\n    objects.push(object);\n  }\n  return objects;\n}\n\nexport class StorageService {\n  readonly #clients: ReadonlyMap<string, StorageClient>;\n\n  constructor(\n    clients: ReadonlyMap<string, StorageClient>,\n    private readonly defaultName: string | null,\n  ) {\n    this.#clients = new Map(clients);\n  }\n\n  get names(): readonly string[] {\n    return [...this.#clients.keys()].sort();\n  }\n\n  use(name?: string): StorageClient {\n    const resolved =\n      name === undefined ? this.defaultName : normalizeStorageName(name);\n\n    if (resolved === null) {\n      throw new StorageError(\n        'No default storage store is configured; call storage.use(name).',\n        {\n          code: StorageErrorCode.INVALID_ARGUMENT,\n          permanent: true,\n        },\n      );\n    }\n\n    const client = this.#clients.get(resolved);\n    if (client === undefined) {\n      const available = this.names;\n      throw new StorageError(\n        available.length === 0\n          ? `Storage store \"${resolved}\" is not registered.`\n          : `Storage store \"${resolved}\" is not registered. Available stores: ${available.join(', ')}.`,\n        {\n          code: StorageErrorCode.INVALID_ARGUMENT,\n          permanent: true,\n          store: resolved,\n        },\n      );\n    }\n    return client;\n  }\n\n  async transfer(\n    options: StorageTransferOptions,\n  ): Promise<StorageTransferResult> {\n    const fromName = normalizeStorageName(options.from);\n    const toName = normalizeStorageName(options.to);\n    assertDifferentStores(fromName, toName);\n    const source = this.use(fromName);\n    const destination = this.use(toName);\n    const transformKey = options.transformKey ?? identity;\n    const overwrite = options.overwrite ?? true;\n    const objects = await walk(source, options);\n    const total = objects.length;\n    let done = 0;\n    const skipped = new Set<string>();\n\n    const report = (\n      key: string,\n      status: StorageTransferProgress['status'],\n    ): void => {\n      done += 1;\n      options.onProgress?.({ done, key, status, total });\n    };\n\n    const settled = await settleMany(\n      objects,\n      (object) => object.key,\n      async (object) => {\n        const destinationKey = transformKey(object.key);\n        if (\n          !overwrite &&\n          (await destination.exists(destinationKey, {\n            ...(options.signal !== undefined && {\n              signal: options.signal,\n            }),\n          }))\n        ) {\n          skipped.add(object.key);\n          report(object.key, 'skipped');\n          return object.key;\n        }\n\n        const downloaded = await source.downloadStream(object.key, {\n          ...(options.signal !== undefined && {\n            signal: options.signal,\n          }),\n        });\n        try {\n          await destination.upload(destinationKey, downloaded.body, {\n            contentType: downloaded.contentType,\n            ...(downloaded.metadata !== undefined && {\n              metadata: downloaded.metadata,\n            }),\n            ...(options.signal !== undefined && {\n              signal: options.signal,\n            }),\n          });\n        } catch (error) {\n          if (!downloaded.body.locked) {\n            await downloaded.body.cancel().catch(() => undefined);\n          }\n          throw error;\n        }\n        report(object.key, 'transferred');\n        return object.key;\n      },\n      options,\n    );\n\n    const transferred: string[] = [];\n    const skippedKeys: string[] = [];\n    for (const key of settled.results) {\n      (skipped.has(key) ? skippedKeys : transferred).push(key);\n    }\n\n    return {\n      transferred,\n      ...(skippedKeys.length > 0 && { skipped: skippedKeys }),\n      ...(settled.errors.length > 0 && { errors: settled.errors }),\n    };\n  }\n\n  async sync(options: StorageSyncOptions): Promise<StorageSyncResult> {\n    const fromName = normalizeStorageName(options.from);\n    const toName = normalizeStorageName(options.to);\n    assertDifferentStores(fromName, toName);\n    const source = this.use(fromName);\n    const destination = this.use(toName);\n    const transformKey = options.transformKey ?? identity;\n    const destinationKeyOf = (key: string): string =>\n      joinStorageKey(options.destinationPrefix, transformKey(key));\n    const compare = options.compare ?? 'etag';\n    const sourceObjects = await walk(source, options);\n    const destinationObjects = await walk(destination, {\n      ...(options.destinationPrefix !== undefined\n        ? { prefix: options.destinationPrefix }\n        : options.prefix !== undefined\n          ? { prefix: options.prefix }\n          : {}),\n      ...(options.limit !== undefined && { limit: options.limit }),\n      ...(options.signal !== undefined && { signal: options.signal }),\n    });\n    const destinationIndex = new Map(\n      destinationObjects.map((object) => [object.key, object]),\n    );\n    const desiredDestinationKeys = new Set(\n      sourceObjects.map((object) => destinationKeyOf(object.key)),\n    );\n    const deleteKeys =\n      (options.prune ?? false)\n        ? destinationObjects\n            .map((object) => object.key)\n            .filter((key) => !desiredDestinationKeys.has(key))\n        : [];\n\n    const plannedUploads: string[] = [];\n    const plannedSkips: string[] = [];\n    for (const object of sourceObjects) {\n      const existing = destinationIndex.get(destinationKeyOf(object.key));\n      (existing && unchanged(object, existing, compare)\n        ? plannedSkips\n        : plannedUploads\n      ).push(object.key);\n    }\n\n    if (options.dryRun) {\n      return {\n        uploaded: plannedUploads,\n        skipped: plannedSkips,\n        ...(options.prune && { deleted: deleteKeys }),\n      };\n    }\n\n    const total =\n      sourceObjects.length + (options.prune ? deleteKeys.length : 0);\n    let done = 0;\n    const report = (\n      key: string,\n      status: StorageSyncProgress['status'],\n    ): void => {\n      done += 1;\n      options.onProgress?.({ done, key, status, total });\n    };\n    const skipped = new Set<string>();\n\n    const settled = await settleMany(\n      sourceObjects,\n      (object) => object.key,\n      async (object) => {\n        const destinationKey = destinationKeyOf(object.key);\n        const existing = destinationIndex.get(destinationKey);\n        if (existing && unchanged(object, existing, compare)) {\n          skipped.add(object.key);\n          report(object.key, 'skipped');\n          return object.key;\n        }\n        const downloaded = await source.downloadStream(object.key, {\n          ...(options.signal !== undefined && {\n            signal: options.signal,\n          }),\n        });\n        try {\n          await destination.upload(destinationKey, downloaded.body, {\n            contentType: downloaded.contentType,\n            ...(downloaded.metadata !== undefined && {\n              metadata: downloaded.metadata,\n            }),\n            ...(options.signal !== undefined && {\n              signal: options.signal,\n            }),\n          });\n        } catch (error) {\n          if (!downloaded.body.locked) {\n            await downloaded.body.cancel().catch(() => undefined);\n          }\n          throw error;\n        }\n        report(object.key, 'uploaded');\n        return object.key;\n      },\n      options,\n    );\n\n    const uploaded: string[] = [];\n    const skippedKeys: string[] = [];\n    for (const key of settled.results) {\n      (skipped.has(key) ? skippedKeys : uploaded).push(key);\n    }\n\n    let deleted: string[] | undefined;\n    let deleteErrors: StorageBulkError[] = [];\n    const canPrune =\n      options.prune && !(options.stopOnError && settled.errors.length > 0);\n    if (canPrune) {\n      const deleteResult = await destination.deleteMany(deleteKeys, {\n        ...(options.concurrency !== undefined && {\n          concurrency: options.concurrency,\n        }),\n        ...(options.signal !== undefined && { signal: options.signal }),\n        ...(options.stopOnError !== undefined && {\n          stopOnError: options.stopOnError,\n        }),\n      });\n      deleted = deleteResult.deleted;\n      deleteErrors = deleteResult.errors ?? [];\n      for (const key of deleted) {\n        report(key, 'deleted');\n      }\n    }\n\n    const errors = [...settled.errors, ...deleteErrors];\n    return {\n      uploaded,\n      skipped: skippedKeys,\n      ...(options.prune && { deleted: deleted ?? [] }),\n      ...(errors.length > 0 && { errors }),\n    };\n  }\n}\n"]}

package/dist/storage.types.d.ts

@@ -41,6 +41,24 @@ export interface StorageUploadOptions extends StorageOperationOptions {
     multipart?: boolean | StorageMultipartOptions;
     control?: StorageUploadControl;
 }
+export type StorageConditionalUploadOptions = StorageUploadOptions & ({
+    /** Atomically create the object only when its key does not exist. */
+    condition: {
+        type: 'create';
+    };
+} | {
+    /** Atomically replace the object only when its current ETag matches. */
+    condition: {
+        type: 'replace';
+        etag: string;
+    };
+});
+export interface StorageConditionalDeleteOptions extends StorageOperationOptions {
+    /** Atomically delete the object only when its current ETag matches. */
+    condition: {
+        etag: string;
+    };
+}
 export interface StorageUploadResult {
     key: string;
     size: number;
@@ -121,6 +139,19 @@ export interface StorageConditionalCopyCapability {
     etag: boolean;
     version: boolean;
 }
+export interface StorageConditionalMutationCapability {
+    /** Native create-if-absent support. */
+    create: boolean;
+    /** Native replace-if-current-ETag-matches support. */
+    replace: boolean;
+    /** Native delete-if-current-ETag-matches support. */
+    delete: boolean;
+    /**
+     * Successful conditional uploads return an ETag usable for CAS. A provider
+     * that commits without returning one must fail rather than report success.
+     */
+    etag: boolean;
+}
 export interface StorageSignedUploadPolicyCapability {
     /** The signed request fixes the exact declared content type. */
     contentType: boolean;
@@ -146,6 +177,11 @@ export interface StorageCapabilities {
      * compatibility with drivers built against earlier package versions.
      */
     conditionalCopy?: StorageConditionalCopyCapability;
+    /**
+     * Native conditional mutations. Absent means unsupported; callers must not
+     * emulate these operations with a separate `exists()` or `head()` request.
+     */
+    conditionalMutation?: StorageConditionalMutationCapability;
     signedDownload: StorageSignedUrlCapability;
     /** Expiry guarantees enforced by the provider adapter. */
     signedDownloadPolicy?: StorageSignedDownloadPolicyCapability;