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

package/dist/storage.client.js

@@ -151,6 +151,7 @@ export class StorageClient {
             head: (options) => this.head(key, options),
             key,
             moveTo: (destinationKey, options) => this.move(key, destinationKey, options),
+            promoteTo: (destinationKey, options) => this.promote(key, destinationKey, options),
             signDownload: (options) => this.signDownload(key, options),
             signUpload: (options) => this.signUpload(key, options),
             bytes: (options) => this.downloadBytes(key, options),
@@ -223,6 +224,45 @@ export class StorageClient {
             to: destinationKey,
         }, () => this.#driver.move(sourceKey, destinationKey, options));
     }
+    /**
+     * Conditionally copies a staged object to a final key. This operation does
+     * not delete the source; delete it after the application commit succeeds.
+     */
+    promote(sourceKey, destinationKey, options) {
+        assertKey(sourceKey, 'source key');
+        assertKey(destinationKey, 'destination key');
+        const sourceEtag = options.sourceEtag;
+        const sourceVersion = options.sourceVersion;
+        if (sourceEtag !== undefined && sourceEtag.length === 0) {
+            invalidArgument('sourceEtag must be a non-empty string.');
+        }
+        if (sourceVersion !== undefined && sourceVersion.length === 0) {
+            invalidArgument('sourceVersion must be a non-empty string.');
+        }
+        if (sourceEtag === undefined && sourceVersion === undefined) {
+            invalidArgument('promote requires sourceEtag, sourceVersion, or both.');
+        }
+        const capability = this.#driver.capabilities.conditionalCopy;
+        const promote = this.#driver.promote;
+        if (capability?.supported !== true ||
+            promote === undefined ||
+            (sourceEtag !== undefined && !capability.etag) ||
+            (sourceVersion !== undefined && !capability.version)) {
+            throw new StorageError(`Store "${this.name}" does not support the requested conditional promotion.`, {
+                code: StorageErrorCode.NOT_SUPPORTED,
+                key: sourceKey,
+                operation: 'promote',
+                permanent: true,
+                store: this.name,
+            });
+        }
+        return this.#execute({
+            from: sourceKey,
+            operation: 'promote',
+            store: this.name,
+            to: destinationKey,
+        }, () => promote.call(this.#driver, sourceKey, destinationKey, options));
+    }
     list(options) {
         assertListOptions(options);
         return this.#execute({ operation: 'list', store: this.name }, () => this.#driver.list(options));

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  StorageSearchOptions,\n  StorageSignedDownloadOptions,\n  StorageSignedUpload,\n  StorageSignedUploadOptions,\n  StorageUploadManyItem,\n  StorageUploadManyOptions,\n  StorageUploadManyResult,\n  StorageUploadOptions,\n  StorageUploadResult,\n} from './storage.types.js';\n\nexport const DEFAULT_BUFFER_LIMIT = 10 * 1024 * 1024;\n\ntype BulkOperationOptions = StorageBulkOptions & StorageOperationOptions;\ntype DownloadManyOptions = StorageBulkOptions & StorageDownloadOptions;\n\nfunction assertKey(key: string, label = 'key'): void {\n  if (typeof key !== 'string' || key.length === 0) {\n    throw new StorageError(`${label} must be a non-empty string.`, {\n      code: StorageErrorCode.INVALID_ARGUMENT,\n      permanent: true,\n    });\n  }\n}\n\nfunction invalidArgument(message: string): never {\n  throw new StorageError(message, {\n    code: StorageErrorCode.INVALID_ARGUMENT,\n    permanent: true,\n  });\n}\n\nfunction assertPositiveSafeInteger(\n  value: number | undefined,\n  label: string,\n): void {\n  if (value !== undefined && (!Number.isSafeInteger(value) || value <= 0)) {\n    invalidArgument(`${label} must be a positive safe integer.`);\n  }\n}\n\nfunction assertDownloadOptions(options?: StorageDownloadOptions): void {\n  const range = options?.range;\n  if (range === undefined) {\n    return;\n  }\n  if (!Number.isSafeInteger(range.start) || range.start < 0) {\n    invalidArgument('range.start must be a non-negative safe integer.');\n  }\n  if (\n    range.end !== undefined &&\n    (!Number.isSafeInteger(range.end) || range.end < range.start)\n  ) {\n    invalidArgument(\n      'range.end must be a safe integer greater than or equal to range.start.',\n    );\n  }\n}\n\nfunction assertListOptions(options?: StorageListOptions): void {\n  if (options?.delimiter !== undefined && options.delimiter.length === 0) {\n    invalidArgument('delimiter must be a non-empty string.');\n  }\n  assertPositiveSafeInteger(options?.limit, 'limit');\n}\n\nfunction assertSearchOptions(options?: StorageSearchOptions): void {\n  assertPositiveSafeInteger(options?.limit, 'limit');\n  assertPositiveSafeInteger(options?.maxResults, 'maxResults');\n}\n\nfunction assertSignedUploadOptions(options: StorageSignedUploadOptions): void {\n  assertPositiveSafeInteger(options.expiresIn, 'expiresIn');\n  assertPositiveSafeInteger(options.maxSize, 'maxSize');\n  if (\n    options.minSize !== undefined &&\n    (!Number.isSafeInteger(options.minSize) || options.minSize < 0)\n  ) {\n    invalidArgument('minSize must be a non-negative safe integer.');\n  }\n  if (\n    options.minSize !== undefined &&\n    options.maxSize !== undefined &&\n    options.minSize > options.maxSize\n  ) {\n    invalidArgument('minSize cannot be greater than maxSize.');\n  }\n}\n\nfunction operationOptions(\n  options?: BulkOperationOptions,\n): StorageOperationOptions | undefined {\n  if (options === undefined) {\n    return undefined;\n  }\n  return {\n    ...(options.retries !== undefined && { retries: options.retries }),\n    ...(options.signal !== undefined && { signal: options.signal }),\n    ...(options.timeout !== undefined && { timeout: options.timeout }),\n  };\n}\n\nfunction downloadOptions(\n  options?: DownloadManyOptions,\n): StorageDownloadOptions | undefined {\n  if (options === undefined) {\n    return undefined;\n  }\n  return {\n    ...operationOptions(options),\n    ...(options.range !== undefined && { range: options.range }),\n  };\n}\n\nasync function collectBody(\n  object: StorageObject,\n  maxBytes: number,\n): Promise<Uint8Array> {\n  if (maxBytes !== Infinity && (!Number.isFinite(maxBytes) || maxBytes < 0)) {\n    await object.body.cancel().catch(() => undefined);\n    throw new StorageError(\n      'maxBytes must be a non-negative finite number or Infinity.',\n      {\n        code: StorageErrorCode.INVALID_ARGUMENT,\n        key: object.key,\n        permanent: true,\n      },\n    );\n  }\n\n  if (maxBytes !== Infinity && object.size > maxBytes) {\n    await object.body.cancel().catch(() => undefined);\n    throw new StorageError(\n      `Object \"${object.key}\" is ${object.size} bytes, exceeding the ${maxBytes}-byte buffer limit.`,\n      {\n        code: StorageErrorCode.LIMIT_EXCEEDED,\n        key: object.key,\n        permanent: true,\n      },\n    );\n  }\n\n  const chunks: Uint8Array[] = [];\n  let total = 0;\n  const reader = object.body.getReader();\n\n  try {\n    while (true) {\n      const { done, value } = await reader.read();\n      if (done) {\n        break;\n      }\n      total += value.byteLength;\n      if (maxBytes !== Infinity && total > maxBytes) {\n        await reader.cancel().catch(() => undefined);\n        throw new StorageError(\n          `Object \"${object.key}\" exceeded the ${maxBytes}-byte buffer limit while downloading.`,\n          {\n            code: StorageErrorCode.LIMIT_EXCEEDED,\n            key: object.key,\n            permanent: true,\n          },\n        );\n      }\n      chunks.push(value);\n    }\n  } finally {\n    reader.releaseLock();\n  }\n\n  const bytes = new Uint8Array(total);\n  let offset = 0;\n  for (const chunk of chunks) {\n    bytes.set(chunk, offset);\n    offset += chunk.byteLength;\n  }\n  return bytes;\n}\n\nexport interface StorageFileHandle {\n  readonly key: string;\n  upload(\n    body: StorageBody,\n    options?: StorageUploadOptions,\n  ): Promise<StorageUploadResult>;\n  download(options?: StorageDownloadOptions): Promise<StorageObject>;\n  bytes(options?: StorageBufferedDownloadOptions): Promise<Uint8Array>;\n  text(options?: StorageBufferedDownloadOptions): Promise<string>;\n  head(options?: StorageOperationOptions): Promise<StorageObjectMetadata>;\n  exists(options?: StorageOperationOptions): Promise<boolean>;\n  delete(options?: StorageOperationOptions): Promise<void>;\n  signDownload(options?: StorageSignedDownloadOptions): Promise<string>;\n  signUpload(options: StorageSignedUploadOptions): Promise<StorageSignedUpload>;\n  copyTo(\n    destinationKey: string,\n    options?: StorageOperationOptions,\n  ): Promise<void>;\n  moveTo(\n    destinationKey: string,\n    options?: StorageOperationOptions,\n  ): Promise<void>;\n}\n\nexport class StorageClient {\n  readonly #driver: StorageDriver;\n  readonly #plugins: readonly StoragePlugin[];\n  #closed = false;\n\n  constructor(\n    readonly name: string,\n    driver: StorageDriver,\n    plugins: readonly StoragePlugin[] = [],\n  ) {\n    assertKey(name, 'store name');\n    this.#driver = driver;\n    this.#plugins = [...plugins];\n  }\n\n  get driverName(): string {\n    return this.#driver.name;\n  }\n\n  get capabilities(): Readonly<StorageCapabilities> {\n    return this.#driver.capabilities;\n  }\n\n  file(key: string): StorageFileHandle {\n    assertKey(key);\n    return {\n      copyTo: (destinationKey, options) =>\n        this.copy(key, destinationKey, options),\n      delete: (options) => this.delete(key, options),\n      download: (options) => this.downloadStream(key, options),\n      exists: (options) => this.exists(key, options),\n      head: (options) => this.head(key, options),\n      key,\n      moveTo: (destinationKey, options) =>\n        this.move(key, destinationKey, options),\n      signDownload: (options) => this.signDownload(key, options),\n      signUpload: (options) => this.signUpload(key, options),\n      bytes: (options) => this.downloadBytes(key, options),\n      text: (options) => this.downloadText(key, options),\n      upload: (body, options) => this.upload(key, body, options),\n    };\n  }\n\n  upload(\n    key: string,\n    body: StorageBody,\n    options?: StorageUploadOptions,\n  ): Promise<StorageUploadResult> {\n    assertKey(key);\n    return this.#execute({ key, operation: 'upload', store: this.name }, () =>\n      this.#driver.upload(key, body, options),\n    );\n  }\n\n  downloadStream(\n    key: string,\n    options?: StorageDownloadOptions,\n  ): Promise<StorageObject> {\n    assertKey(key);\n    assertDownloadOptions(options);\n    return this.#execute({ key, operation: 'download', store: this.name }, () =>\n      this.#driver.download(key, options),\n    );\n  }\n\n  async downloadBytes(\n    key: string,\n    options?: StorageBufferedDownloadOptions,\n  ): Promise<Uint8Array> {\n    const { maxBytes = DEFAULT_BUFFER_LIMIT, ...download } = options ?? {};\n    const object = await this.downloadStream(key, download);\n    return collectBody(object, maxBytes);\n  }\n\n  async downloadText(\n    key: string,\n    options?: StorageBufferedDownloadOptions,\n  ): Promise<string> {\n    return new TextDecoder().decode(await this.downloadBytes(key, options));\n  }\n\n  async downloadJson<Result = unknown>(\n    key: string,\n    options?: StorageBufferedDownloadOptions,\n  ): Promise<Result> {\n    const text = await this.downloadText(key, options);\n    try {\n      return JSON.parse(text) as Result;\n    } catch (error) {\n      throw new StorageError(`Object \"${key}\" does not contain valid JSON.`, {\n        cause: error,\n        code: StorageErrorCode.INVALID_ARGUMENT,\n        key,\n        operation: 'download',\n        permanent: true,\n        store: this.name,\n      });\n    }\n  }\n\n  head(\n    key: string,\n    options?: StorageOperationOptions,\n  ): Promise<StorageObjectMetadata> {\n    assertKey(key);\n    return this.#execute({ key, operation: 'head', store: this.name }, () =>\n      this.#driver.head(key, options),\n    );\n  }\n\n  exists(key: string, options?: StorageOperationOptions): Promise<boolean> {\n    assertKey(key);\n    return this.#execute({ key, operation: 'exists', store: this.name }, () =>\n      this.#driver.exists(key, options),\n    );\n  }\n\n  delete(key: string, options?: StorageOperationOptions): Promise<void> {\n    assertKey(key);\n    return this.#execute({ key, operation: 'delete', store: this.name }, () =>\n      this.#driver.delete(key, options),\n    );\n  }\n\n  copy(\n    sourceKey: string,\n    destinationKey: string,\n    options?: StorageOperationOptions,\n  ): Promise<void> {\n    assertKey(sourceKey, 'source key');\n    assertKey(destinationKey, 'destination key');\n    return this.#execute(\n      {\n        from: sourceKey,\n        operation: 'copy',\n        store: this.name,\n        to: destinationKey,\n      },\n      () => this.#driver.copy(sourceKey, destinationKey, options),\n    );\n  }\n\n  move(\n    sourceKey: string,\n    destinationKey: string,\n    options?: StorageOperationOptions,\n  ): Promise<void> {\n    assertKey(sourceKey, 'source key');\n    assertKey(destinationKey, 'destination key');\n    return this.#execute(\n      {\n        from: sourceKey,\n        operation: 'move',\n        store: this.name,\n        to: destinationKey,\n      },\n      () => this.#driver.move(sourceKey, destinationKey, options),\n    );\n  }\n\n  list(options?: StorageListOptions): Promise<StorageListResult> {\n    assertListOptions(options);\n    return this.#execute({ operation: 'list', store: this.name }, () =>\n      this.#driver.list(options),\n    );\n  }\n\n  async *listAll(\n    options?: StorageListOptions,\n  ): AsyncGenerator<StorageObjectMetadata, void> {\n    const { delimiter: _delimiter, ...walkOptions } = options ?? {};\n    void _delimiter;\n    let cursor = walkOptions.cursor;\n    const seen = new Set<string>();\n\n    do {\n      const page = await this.list({\n        ...walkOptions,\n        ...(cursor !== undefined && { cursor }),\n      });\n      yield* page.items;\n      cursor = page.cursor;\n      if (cursor !== undefined) {\n        if (seen.has(cursor)) {\n          throw new StorageError(\n            `Store \"${this.name}\" returned a repeated pagination cursor.`,\n            {\n              code: StorageErrorCode.PROVIDER,\n              operation: 'list',\n              permanent: true,\n              store: this.name,\n            },\n          );\n        }\n        seen.add(cursor);\n      }\n    } while (cursor !== undefined);\n  }\n\n  search(\n    pattern: string | RegExp,\n    options?: StorageSearchOptions,\n  ): AsyncIterable<StorageObjectMetadata> {\n    assertSearchOptions(options);\n    return this.#search(pattern, options);\n  }\n\n  async *#search(\n    pattern: string | RegExp,\n    options?: StorageSearchOptions,\n  ): AsyncGenerator<StorageObjectMetadata, void> {\n    const context: StorageOperationContext = {\n      operation: 'search',\n      store: this.name,\n    };\n    try {\n      for (const plugin of this.#plugins) {\n        await plugin.beforeOperation?.(context);\n      }\n      for await (const object of this.#driver.search(pattern, options)) {\n        yield object;\n      }\n      for (const plugin of this.#plugins) {\n        await plugin.afterOperation?.(context, undefined);\n      }\n    } catch (error) {\n      const normalized = normalizeStorageError(error, {\n        operation: 'search',\n        store: this.name,\n      });\n      for (const plugin of this.#plugins) {\n        try {\n          await plugin.onError?.(context, normalized);\n        } catch {\n          // Preserve the original storage error.\n        }\n      }\n      throw normalized;\n    }\n  }\n\n  signDownload(\n    key: string,\n    options?: StorageSignedDownloadOptions,\n  ): Promise<string> {\n    assertKey(key);\n    return this.#execute(\n      { key, operation: 'signDownload', store: this.name },\n      () => this.#driver.signDownload(key, options),\n    );\n  }\n\n  signUpload(\n    key: string,\n    options: StorageSignedUploadOptions,\n  ): Promise<StorageSignedUpload> {\n    assertKey(key);\n    assertSignedUploadOptions(options);\n    return this.#execute(\n      { key, operation: 'signUpload', store: this.name },\n      () => this.#driver.signUpload(key, options),\n    );\n  }\n\n  async uploadMany(\n    items: readonly StorageUploadManyItem[],\n    options?: StorageUploadManyOptions,\n  ): Promise<StorageUploadManyResult> {\n    const settled = await settleMany(\n      items,\n      (item) => item.key,\n      (item) =>\n        this.upload(item.key, item.body, {\n          ...operationOptions(options),\n          ...(item.cacheControl !== undefined && {\n            cacheControl: item.cacheControl,\n          }),\n          ...(item.contentType !== undefined && {\n            contentType: item.contentType,\n          }),\n          ...(item.metadata !== undefined && { metadata: item.metadata }),\n          ...(item.multipart !== undefined && {\n            multipart: item.multipart,\n          }),\n          ...(options?.onProgress !== undefined && {\n            onProgress: (progress) =>\n              options.onProgress?.({ ...progress, key: item.key }),\n          }),\n        }),\n      options,\n    );\n\n    return {\n      uploaded: settled.results,\n      ...(settled.errors.length > 0 && { errors: settled.errors }),\n    };\n  }\n\n  async downloadMany(\n    keys: readonly string[],\n    options?: DownloadManyOptions,\n  ): Promise<StorageDownloadManyResult> {\n    const settled = await settleMany(\n      keys,\n      (key) => key,\n      (key) => this.downloadStream(key, downloadOptions(options)),\n      options,\n    );\n    return {\n      downloaded: settled.results,\n      ...(settled.errors.length > 0 && { errors: settled.errors }),\n    };\n  }\n\n  async headMany(\n    keys: readonly string[],\n    options?: BulkOperationOptions,\n  ): Promise<StorageHeadManyResult> {\n    const settled = await settleMany(\n      keys,\n      (key) => key,\n      (key) => this.head(key, operationOptions(options)),\n      options,\n    );\n    return {\n      objects: settled.results,\n      ...(settled.errors.length > 0 && { errors: settled.errors }),\n    };\n  }\n\n  async existsMany(\n    keys: readonly string[],\n    options?: BulkOperationOptions,\n  ): Promise<StorageExistsManyResult> {\n    const settled = await settleMany(\n      keys,\n      (key) => key,\n      async (key) => ({ exists: await this.exists(key, options), key }),\n      options,\n    );\n    const existing: string[] = [];\n    const missing: string[] = [];\n    for (const result of settled.results) {\n      (result.exists ? existing : missing).push(result.key);\n    }\n    return {\n      existing,\n      missing,\n      ...(settled.errors.length > 0 && { errors: settled.errors }),\n    };\n  }\n\n  async deleteMany(\n    keys: readonly string[],\n    options?: BulkOperationOptions,\n  ): Promise<StorageDeleteManyResult> {\n    const settled = await settleMany(\n      keys,\n      (key) => key,\n      async (key) => {\n        await this.delete(key, operationOptions(options));\n        return key;\n      },\n      options,\n    );\n    return {\n      deleted: settled.results,\n      ...(settled.errors.length > 0 && { errors: settled.errors }),\n    };\n  }\n\n  async onApplicationShutdown(): Promise<void> {\n    if (this.#closed) {\n      return;\n    }\n    this.#closed = true;\n    await this.#driver.close?.();\n  }\n\n  async #execute<Result>(\n    context: StorageOperationContext,\n    operation: () => Promise<Result>,\n  ): Promise<Result> {\n    try {\n      for (const plugin of this.#plugins) {\n        await plugin.beforeOperation?.(context);\n      }\n      const result = await operation();\n      for (const plugin of this.#plugins) {\n        await plugin.afterOperation?.(context, result);\n      }\n      return result;\n    } catch (error) {\n      const normalized = normalizeStorageError(error, {\n        ...(context.key !== undefined && { key: context.key }),\n        operation: context.operation,\n        store: this.name,\n      });\n      for (const plugin of this.#plugins) {\n        try {\n          await plugin.onError?.(context, normalized);\n        } catch {\n          // Preserve the original storage error.\n        }\n      }\n      throw normalized;\n    }\n  }\n}\n"]}
+{"version":3,"file":"storage.client.js","sourceRoot":"","sources":["../src/storage.client.ts"],"names":[],"mappings":"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","sourcesContent":["import { settleMany } from './internal/settle-many.js';\nimport {\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"]}

package/dist/storage.driver.d.ts

@@ -1,4 +1,4 @@
-import type { StorageBody, StorageCapabilities, StorageDownloadOptions, StorageListOptions, StorageListResult, StorageObject, StorageObjectMetadata, StorageOperationOptions, StorageSearchOptions, StorageSignedDownloadOptions, StorageSignedUpload, StorageSignedUploadOptions, StorageUploadOptions, StorageUploadResult } from './storage.types.js';
+import type { StorageBody, StorageCapabilities, 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;
@@ -9,6 +9,11 @@ export interface StorageDriver {
     delete(key: string, options?: StorageOperationOptions): Promise<void>;
     copy(sourceKey: string, destinationKey: string, options?: StorageOperationOptions): Promise<void>;
     move(sourceKey: string, destinationKey: string, options?: StorageOperationOptions): Promise<void>;
+    /**
+     * Conditionally copies a staged object to its final key. The source remains
+     * in place so applications can delete it only after their metadata commit.
+     */
+    promote?(sourceKey: string, destinationKey: string, options: StoragePromotionOptions): Promise<void>;
     list(options?: StorageListOptions): Promise<StorageListResult>;
     search(pattern: string | RegExp, options?: StorageSearchOptions): AsyncIterable<StorageObjectMetadata>;
     signDownload(key: string, options?: StorageSignedDownloadOptions): Promise<string>;

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,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,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,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"}

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  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  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  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"]}

package/dist/storage.error.d.ts

@@ -11,6 +11,7 @@ export declare const StorageErrorCode: {
     readonly PROVIDER: "PROVIDER";
 };
 export type StorageErrorCode = (typeof StorageErrorCode)[keyof typeof StorageErrorCode];
+declare const STORAGE_ERROR_BRAND: unique symbol;
 export interface StorageErrorOptions {
     code: StorageErrorCode;
     store?: string;
@@ -22,6 +23,7 @@ export interface StorageErrorOptions {
     cause?: unknown;
 }
 export declare class StorageError extends Error {
+    readonly [STORAGE_ERROR_BRAND]: true;
     readonly code: StorageErrorCode;
     readonly store: string | undefined;
     readonly operation: string | undefined;
@@ -36,4 +38,5 @@ export declare function isStorageError(error: unknown): error is StorageError;
 export declare function normalizeStorageError(error: unknown, options?: Omit<StorageErrorOptions, 'code' | 'cause'> & {
     code?: StorageErrorCode;
 }): StorageError;
+export {};
 //# sourceMappingURL=storage.error.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"storage.error.d.ts","sourceRoot":"","sources":["../src/storage.error.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,gBAAgB;;;;;;;;;;;CAWnB,CAAC;AAEX,MAAM,MAAM,gBAAgB,GAC1B,CAAC,OAAO,gBAAgB,CAAC,CAAC,MAAM,OAAO,gBAAgB,CAAC,CAAC;AAE3D,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,gBAAgB,CAAC;IACvB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED,qBAAa,YAAa,SAAQ,KAAK;IACrC,QAAQ,CAAC,IAAI,EAAE,gBAAgB,CAAC;IAChC,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,CAAC;IACnC,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,SAAS,CAAC;IACvC,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,CAAC;IACjC,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;IAC3B,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAC5B,SAAkB,KAAK,CAAC,EAAE,OAAO,CAAC;gBAEtB,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,mBAAmB;CAY1D;AAED,wBAAgB,cAAc,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,YAAY,CAEpE;AAED,wBAAgB,qBAAqB,CACnC,KAAK,EAAE,OAAO,EACd,OAAO,GAAE,IAAI,CAAC,mBAAmB,EAAE,MAAM,GAAG,OAAO,CAAC,GAAG;IACrD,IAAI,CAAC,EAAE,gBAAgB,CAAC;CACpB,GACL,YAAY,CAYd"}
+{"version":3,"file":"storage.error.d.ts","sourceRoot":"","sources":["../src/storage.error.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,gBAAgB;;;;;;;;;;;CAWnB,CAAC;AAEX,MAAM,MAAM,gBAAgB,GAC1B,CAAC,OAAO,gBAAgB,CAAC,CAAC,MAAM,OAAO,gBAAgB,CAAC,CAAC;AAE3D,QAAA,MAAM,mBAAmB,eAA4C,CAAC;AAMtE,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,gBAAgB,CAAC;IACvB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED,qBAAa,YAAa,SAAQ,KAAK;IACrC,SAAiB,CAAC,mBAAmB,CAAC,EAAE,IAAI,CAAC;IAC7C,QAAQ,CAAC,IAAI,EAAE,gBAAgB,CAAC;IAChC,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,CAAC;IACnC,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,SAAS,CAAC;IACvC,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,CAAC;IACjC,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;IAC3B,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAC5B,SAAkB,KAAK,CAAC,EAAE,OAAO,CAAC;gBAEtB,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,mBAAmB;CAkB1D;AAED,wBAAgB,cAAc,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,YAAY,CAoCpE;AAED,wBAAgB,qBAAqB,CACnC,KAAK,EAAE,OAAO,EACd,OAAO,GAAE,IAAI,CAAC,mBAAmB,EAAE,MAAM,GAAG,OAAO,CAAC,GAAG;IACrD,IAAI,CAAC,EAAE,gBAAgB,CAAC;CACpB,GACL,YAAY,CAYd"}

package/dist/storage.error.js

@@ -10,6 +10,10 @@ export const StorageErrorCode = {
     LIMIT_EXCEEDED: 'LIMIT_EXCEEDED',
     PROVIDER: 'PROVIDER',
 };
+const STORAGE_ERROR_BRAND = Symbol.for('@nestm/storage/StorageError');
+function isStorageErrorCode(value) {
+    return Object.values(StorageErrorCode).includes(value);
+}
 export class StorageError extends Error {
     code;
     store;
@@ -21,6 +25,12 @@ export class StorageError extends Error {
     cause;
     constructor(message, options) {
         super(message, { cause: options.cause });
+        Object.defineProperty(this, STORAGE_ERROR_BRAND, {
+            configurable: false,
+            enumerable: false,
+            value: true,
+            writable: false,
+        });
         this.name = 'StorageError';
         this.code = options.code;
         this.store = options.store;
@@ -33,7 +43,29 @@ export class StorageError extends Error {
     }
 }
 export function isStorageError(error) {
-    return error instanceof StorageError;
+    if (error instanceof StorageError) {
+        return true;
+    }
+    if (!(error instanceof Error) || error.name !== 'StorageError') {
+        return false;
+    }
+    try {
+        const candidate = error;
+        const hasCompatibleBrand = candidate[STORAGE_ERROR_BRAND] === true ||
+            candidate[STORAGE_ERROR_BRAND] === undefined;
+        return (hasCompatibleBrand &&
+            isStorageErrorCode(candidate.code) &&
+            typeof candidate.aborted === 'boolean' &&
+            typeof candidate.timedOut === 'boolean' &&
+            typeof candidate.permanent === 'boolean' &&
+            (candidate.store === undefined || typeof candidate.store === 'string') &&
+            (candidate.operation === undefined ||
+                typeof candidate.operation === 'string') &&
+            (candidate.key === undefined || typeof candidate.key === 'string'));
+    }
+    catch {
+        return false;
+    }
 }
 export function normalizeStorageError(error, options = {}) {
     if (isStorageError(error)) {

package/dist/storage.error.js.map

@@ -1 +1 @@
-{"version":3,"file":"storage.error.js","sourceRoot":"","sources":["../src/storage.error.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,gBAAgB,GAAG;IAC9B,SAAS,EAAE,WAAW;IACtB,YAAY,EAAE,cAAc;IAC5B,QAAQ,EAAE,UAAU;IACpB,SAAS,EAAE,WAAW;IACtB,gBAAgB,EAAE,kBAAkB;IACpC,aAAa,EAAE,eAAe;IAC9B,OAAO,EAAE,SAAS;IAClB,OAAO,EAAE,SAAS;IAClB,cAAc,EAAE,gBAAgB;IAChC,QAAQ,EAAE,UAAU;CACZ,CAAC;AAgBX,MAAM,OAAO,YAAa,SAAQ,KAAK;IAC5B,IAAI,CAAmB;IACvB,KAAK,CAAqB;IAC1B,SAAS,CAAqB;IAC9B,GAAG,CAAqB;IACxB,OAAO,CAAU;IACjB,QAAQ,CAAU;IAClB,SAAS,CAAU;IACV,KAAK,CAAW;IAElC,YAAY,OAAe,EAAE,OAA4B;QACvD,KAAK,CAAC,OAAO,EAAE,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,EAAE,CAAC,CAAC;QACzC,IAAI,CAAC,IAAI,GAAG,cAAc,CAAC;QAC3B,IAAI,CAAC,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;QACzB,IAAI,CAAC,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC;QAC3B,IAAI,CAAC,SAAS,GAAG,OAAO,CAAC,SAAS,CAAC;QACnC,IAAI,CAAC,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC;QACvB,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC,OAAO,KAAK,IAAI,CAAC;QACxC,IAAI,CAAC,QAAQ,GAAG,OAAO,CAAC,QAAQ,KAAK,IAAI,CAAC;QAC1C,IAAI,CAAC,SAAS,GAAG,OAAO,CAAC,SAAS,KAAK,IAAI,CAAC;QAC5C,IAAI,CAAC,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC;IAC7B,CAAC;CACF;AAED,MAAM,UAAU,cAAc,CAAC,KAAc;IAC3C,OAAO,KAAK,YAAY,YAAY,CAAC;AACvC,CAAC;AAED,MAAM,UAAU,qBAAqB,CACnC,KAAc,EACd,UAEI,EAAE;IAEN,IAAI,cAAc,CAAC,KAAK,CAAC,EAAE,CAAC;QAC1B,OAAO,KAAK,CAAC;IACf,CAAC;IAED,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IAEvE,OAAO,IAAI,YAAY,CAAC,OAAO,EAAE;QAC/B,GAAG,OAAO;QACV,KAAK,EAAE,KAAK;QACZ,IAAI,EAAE,OAAO,CAAC,IAAI,IAAI,gBAAgB,CAAC,QAAQ;KAChD,CAAC,CAAC;AACL,CAAC","sourcesContent":["export const StorageErrorCode = {\n  NOT_FOUND: 'NOT_FOUND',\n  UNAUTHORIZED: 'UNAUTHORIZED',\n  CONFLICT: 'CONFLICT',\n  READ_ONLY: 'READ_ONLY',\n  INVALID_ARGUMENT: 'INVALID_ARGUMENT',\n  NOT_SUPPORTED: 'NOT_SUPPORTED',\n  ABORTED: 'ABORTED',\n  TIMEOUT: 'TIMEOUT',\n  LIMIT_EXCEEDED: 'LIMIT_EXCEEDED',\n  PROVIDER: 'PROVIDER',\n} as const;\n\nexport type StorageErrorCode =\n  (typeof StorageErrorCode)[keyof typeof StorageErrorCode];\n\nexport interface StorageErrorOptions {\n  code: StorageErrorCode;\n  store?: string;\n  operation?: string;\n  key?: string;\n  aborted?: boolean;\n  timedOut?: boolean;\n  permanent?: boolean;\n  cause?: unknown;\n}\n\nexport class StorageError extends Error {\n  readonly code: StorageErrorCode;\n  readonly store: string | undefined;\n  readonly operation: string | undefined;\n  readonly key: string | undefined;\n  readonly aborted: boolean;\n  readonly timedOut: boolean;\n  readonly permanent: boolean;\n  override readonly cause?: unknown;\n\n  constructor(message: string, options: StorageErrorOptions) {\n    super(message, { cause: options.cause });\n    this.name = 'StorageError';\n    this.code = options.code;\n    this.store = options.store;\n    this.operation = options.operation;\n    this.key = options.key;\n    this.aborted = options.aborted === true;\n    this.timedOut = options.timedOut === true;\n    this.permanent = options.permanent === true;\n    this.cause = options.cause;\n  }\n}\n\nexport function isStorageError(error: unknown): error is StorageError {\n  return error instanceof StorageError;\n}\n\nexport function normalizeStorageError(\n  error: unknown,\n  options: Omit<StorageErrorOptions, 'code' | 'cause'> & {\n    code?: StorageErrorCode;\n  } = {},\n): StorageError {\n  if (isStorageError(error)) {\n    return error;\n  }\n\n  const message = error instanceof Error ? error.message : String(error);\n\n  return new StorageError(message, {\n    ...options,\n    cause: error,\n    code: options.code ?? StorageErrorCode.PROVIDER,\n  });\n}\n"]}
+{"version":3,"file":"storage.error.js","sourceRoot":"","sources":["../src/storage.error.ts"],"names":[],"mappings":"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","sourcesContent":["export const StorageErrorCode = {\n  NOT_FOUND: 'NOT_FOUND',\n  UNAUTHORIZED: 'UNAUTHORIZED',\n  CONFLICT: 'CONFLICT',\n  READ_ONLY: 'READ_ONLY',\n  INVALID_ARGUMENT: 'INVALID_ARGUMENT',\n  NOT_SUPPORTED: 'NOT_SUPPORTED',\n  ABORTED: 'ABORTED',\n  TIMEOUT: 'TIMEOUT',\n  LIMIT_EXCEEDED: 'LIMIT_EXCEEDED',\n  PROVIDER: 'PROVIDER',\n} as const;\n\nexport type StorageErrorCode =\n  (typeof StorageErrorCode)[keyof typeof StorageErrorCode];\n\nconst STORAGE_ERROR_BRAND = Symbol.for('@nestm/storage/StorageError');\n\nfunction isStorageErrorCode(value: unknown): value is StorageErrorCode {\n  return Object.values(StorageErrorCode).includes(value as StorageErrorCode);\n}\n\nexport interface StorageErrorOptions {\n  code: StorageErrorCode;\n  store?: string;\n  operation?: string;\n  key?: string;\n  aborted?: boolean;\n  timedOut?: boolean;\n  permanent?: boolean;\n  cause?: unknown;\n}\n\nexport class StorageError extends Error {\n  declare readonly [STORAGE_ERROR_BRAND]: true;\n  readonly code: StorageErrorCode;\n  readonly store: string | undefined;\n  readonly operation: string | undefined;\n  readonly key: string | undefined;\n  readonly aborted: boolean;\n  readonly timedOut: boolean;\n  readonly permanent: boolean;\n  override readonly cause?: unknown;\n\n  constructor(message: string, options: StorageErrorOptions) {\n    super(message, { cause: options.cause });\n    Object.defineProperty(this, STORAGE_ERROR_BRAND, {\n      configurable: false,\n      enumerable: false,\n      value: true,\n      writable: false,\n    });\n    this.name = 'StorageError';\n    this.code = options.code;\n    this.store = options.store;\n    this.operation = options.operation;\n    this.key = options.key;\n    this.aborted = options.aborted === true;\n    this.timedOut = options.timedOut === true;\n    this.permanent = options.permanent === true;\n    this.cause = options.cause;\n  }\n}\n\nexport function isStorageError(error: unknown): error is StorageError {\n  if (error instanceof StorageError) {\n    return true;\n  }\n  if (!(error instanceof Error) || error.name !== 'StorageError') {\n    return false;\n  }\n\n  try {\n    const candidate = error as Error & {\n      readonly [STORAGE_ERROR_BRAND]?: unknown;\n      readonly aborted?: unknown;\n      readonly code?: unknown;\n      readonly key?: unknown;\n      readonly operation?: unknown;\n      readonly permanent?: unknown;\n      readonly store?: unknown;\n      readonly timedOut?: unknown;\n    };\n    const hasCompatibleBrand =\n      candidate[STORAGE_ERROR_BRAND] === true ||\n      candidate[STORAGE_ERROR_BRAND] === undefined;\n    return (\n      hasCompatibleBrand &&\n      isStorageErrorCode(candidate.code) &&\n      typeof candidate.aborted === 'boolean' &&\n      typeof candidate.timedOut === 'boolean' &&\n      typeof candidate.permanent === 'boolean' &&\n      (candidate.store === undefined || typeof candidate.store === 'string') &&\n      (candidate.operation === undefined ||\n        typeof candidate.operation === 'string') &&\n      (candidate.key === undefined || typeof candidate.key === 'string')\n    );\n  } catch {\n    return false;\n  }\n}\n\nexport function normalizeStorageError(\n  error: unknown,\n  options: Omit<StorageErrorOptions, 'code' | 'cause'> & {\n    code?: StorageErrorCode;\n  } = {},\n): StorageError {\n  if (isStorageError(error)) {\n    return error;\n  }\n\n  const message = error instanceof Error ? error.message : String(error);\n\n  return new StorageError(message, {\n    ...options,\n    cause: error,\n    code: options.code ?? StorageErrorCode.PROVIDER,\n  });\n}\n"]}

package/dist/storage.types.d.ts

@@ -15,6 +15,16 @@ export interface StorageOperationOptions {
     timeout?: number;
     retries?: StorageRetryOptions;
 }
+/**
+ * Preconditions for promoting a staged object to its final key. At least one
+ * source identity must be supplied; unsupported identities fail closed.
+ */
+export interface StoragePromotionOptions extends StorageOperationOptions {
+    /** Copy only the source object whose provider ETag exactly matches. */
+    sourceEtag?: string;
+    /** Copy this immutable provider version of the source object. */
+    sourceVersion?: string;
+}
 export interface StorageMultipartOptions {
     partSize?: number;
     concurrency?: number;
@@ -106,6 +116,21 @@ export interface StorageSignedUrlCapability {
     supported: boolean;
     maxExpiresIn?: number;
 }
+export interface StorageConditionalCopyCapability {
+    supported: boolean;
+    etag: boolean;
+    version: boolean;
+}
+export interface StorageSignedUploadPolicyCapability {
+    /** The signed request fixes the exact declared content type. */
+    contentType: boolean;
+    /** The signed request enforces the requested min/max byte range. */
+    sizeRange: boolean;
+}
+export interface StorageSignedDownloadPolicyCapability {
+    /** Every generated URL honors the requested expiry. */
+    expiresIn: boolean;
+}
 export interface StorageCapabilities {
     rangeRead: boolean;
     /** True when the provider reports native byte-level upload progress. */
@@ -115,12 +140,25 @@ export interface StorageCapabilities {
     cacheControl: boolean;
     resumableUpload: boolean;
     serverSideCopy: boolean;
+    /**
+     * Conditional server-side copy used to promote an already verified staged
+     * object without a validation/copy race. Absent means unsupported for
+     * compatibility with drivers built against earlier package versions.
+     */
+    conditionalCopy?: StorageConditionalCopyCapability;
     signedDownload: StorageSignedUrlCapability;
+    /** Expiry guarantees enforced by the provider adapter. */
+    signedDownloadPolicy?: StorageSignedDownloadPolicyCapability;
     /**
      * Some providers decide support from credentials or requested constraints,
      * so direct-upload support can only be known when the call is attempted.
      */
     signedUpload: boolean | 'runtime';
+    /**
+     * Constraints cryptographically/provider-policy enforced by direct upload.
+     * Absent means callers must not assume request options are enforced.
+     */
+    signedUploadPolicy?: StorageSignedUploadPolicyCapability;
 }
 export interface StorageBulkOptions {
     concurrency?: number;
@@ -164,7 +202,7 @@ export interface StorageDeleteManyResult {
     deleted: string[];
     errors?: StorageBulkError[];
 }
-export type StorageOperationName = 'upload' | 'download' | 'head' | 'exists' | 'delete' | 'copy' | 'move' | 'list' | 'search' | 'signDownload' | 'signUpload';
+export type StorageOperationName = 'upload' | 'download' | 'head' | 'exists' | 'delete' | 'copy' | 'move' | 'promote' | 'list' | 'search' | 'signDownload' | 'signUpload';
 export interface StorageOperationContext {
     store: string;
     operation: StorageOperationName;

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

@@ -1 +1 @@
-{"version":3,"file":"storage.types.d.ts","sourceRoot":"","sources":["../src/storage.types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAE5C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AACvD,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAC;AAExE,MAAM,MAAM,WAAW,GACnB,IAAI,GACJ,IAAI,GACJ,cAAc,CAAC,UAAU,CAAC,GAC1B,QAAQ,GACR,WAAW,GACX,eAAe,GACf,UAAU,GACV,MAAM,CAAC;AAEX,MAAM,WAAW,mBAAmB;IAClC,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,YAAY,CAAC;CACrB;AAED,MAAM,MAAM,mBAAmB,GAC3B,MAAM,GACN;IACE,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,CAAC,EAAE,CAAC,OAAO,EAAE,mBAAmB,KAAK,MAAM,CAAC;CACpD,CAAC;AAEN,MAAM,WAAW,uBAAuB;IACtC,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,mBAAmB,CAAC;CAC/B;AAED,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,qBAAqB;IACpC,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,oBAAqB,SAAQ,uBAAuB;IACnE,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAClC,UAAU,CAAC,EAAE,CAAC,QAAQ,EAAE,qBAAqB,KAAK,IAAI,CAAC;IACvD,SAAS,CAAC,EAAE,OAAO,GAAG,uBAAuB,CAAC;IAC9C,OAAO,CAAC,EAAE,oBAAoB,CAAC;CAChC;AAED,MAAM,WAAW,mBAAmB;IAClC,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,YAAY,CAAC,EAAE,IAAI,CAAC;CACrB;AAED,MAAM,WAAW,qBAAqB;IACpC,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,YAAY,CAAC,EAAE,IAAI,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACnC;AAED,MAAM,WAAW,aAAc,SAAQ,qBAAqB;IAC1D,IAAI,EAAE,cAAc,CAAC,UAAU,CAAC,CAAC;CAClC;AAED,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,sBAAuB,SAAQ,uBAAuB;IACrE,KAAK,CAAC,EAAE,gBAAgB,CAAC;CAC1B;AAED,MAAM,WAAW,8BAA+B,SAAQ,sBAAsB;IAC5E;;;OAGG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,kBAAmB,SAAQ,uBAAuB;IACjE,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,iBAAiB;IAChC,KAAK,EAAE,qBAAqB,EAAE,CAAC;IAC/B,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,MAAM,kBAAkB,GAAG,MAAM,GAAG,OAAO,GAAG,WAAW,GAAG,OAAO,CAAC;AAE1E,MAAM,WAAW,oBAAqB,SAAQ,uBAAuB;IACnE,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,KAAK,CAAC,EAAE,kBAAkB,CAAC;IAC3B,eAAe,CAAC,EAAE,OAAO,CAAC;CAC3B;AAED,MAAM,WAAW,4BAA6B,SAAQ,uBAAuB;IAC3E,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,0BAA0B,CAAC,EAAE,MAAM,CAAC;CACrC;AAED,MAAM,WAAW,0BAA2B,SAAQ,uBAAuB;IACzE,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,MAAM,mBAAmB,GAC3B;IACE,MAAM,EAAE,KAAK,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAClC,GACD;IACE,MAAM,EAAE,MAAM,CAAC;IACf,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAChC,CAAC;AAEN,MAAM,WAAW,0BAA0B;IACzC,SAAS,EAAE,OAAO,CAAC;IACnB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,mBAAmB;IAClC,SAAS,EAAE,OAAO,CAAC;IACnB,wEAAwE;IACxE,oBAAoB,EAAE,OAAO,CAAC;IAC9B,SAAS,EAAE,OAAO,CAAC;IACnB,QAAQ,EAAE,OAAO,CAAC;IAClB,YAAY,EAAE,OAAO,CAAC;IACtB,eAAe,EAAE,OAAO,CAAC;IACzB,cAAc,EAAE,OAAO,CAAC;IACxB,cAAc,EAAE,0BAA0B,CAAC;IAC3C;;;OAGG;IACH,YAAY,EAAE,OAAO,GAAG,SAAS,CAAC;CACnC;AAED,MAAM,WAAW,kBAAkB;IACjC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AAED,MAAM,WAAW,gBAAgB;IAC/B,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,YAAY,CAAC;CACrB;AAED,MAAM,WAAW,qBAAqB;IACpC,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,WAAW,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAClC,SAAS,CAAC,EAAE,OAAO,GAAG,uBAAuB,CAAC;CAC/C;AAED,MAAM,WAAW,wBACf,SAAQ,kBAAkB,EAAE,uBAAuB;IACnD,UAAU,CAAC,EAAE,CAAC,QAAQ,EAAE,qBAAqB,GAAG;QAAE,GAAG,EAAE,MAAM,CAAA;KAAE,KAAK,IAAI,CAAC;CAC1E;AAED,MAAM,WAAW,uBAAuB;IACtC,QAAQ,EAAE,mBAAmB,EAAE,CAAC;IAChC,MAAM,CAAC,EAAE,gBAAgB,EAAE,CAAC;CAC7B;AAED,MAAM,WAAW,yBAAyB;IACxC,UAAU,EAAE,aAAa,EAAE,CAAC;IAC5B,MAAM,CAAC,EAAE,gBAAgB,EAAE,CAAC;CAC7B;AAED,MAAM,WAAW,qBAAqB;IACpC,OAAO,EAAE,qBAAqB,EAAE,CAAC;IACjC,MAAM,CAAC,EAAE,gBAAgB,EAAE,CAAC;CAC7B;AAED,MAAM,WAAW,uBAAuB;IACtC,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,MAAM,CAAC,EAAE,gBAAgB,EAAE,CAAC;CAC7B;AAED,MAAM,WAAW,uBAAuB;IACtC,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,MAAM,CAAC,EAAE,gBAAgB,EAAE,CAAC;CAC7B;AAED,MAAM,MAAM,oBAAoB,GAC5B,QAAQ,GACR,UAAU,GACV,MAAM,GACN,QAAQ,GACR,QAAQ,GACR,MAAM,GACN,MAAM,GACN,MAAM,GACN,QAAQ,GACR,cAAc,GACd,YAAY,CAAC;AAEjB,MAAM,WAAW,uBAAuB;IACtC,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,oBAAoB,CAAC;IAChC,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,EAAE,CAAC,EAAE,MAAM,CAAC;CACb;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd;;;OAGG;IACH,eAAe,CAAC,EAAE,CAAC,OAAO,EAAE,uBAAuB,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC7E;;;;;;;OAOG;IACH,cAAc,CAAC,EAAE,CACf,OAAO,EAAE,uBAAuB,EAChC,MAAM,EAAE,OAAO,KACZ,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1B;;;OAGG;IACH,OAAO,CAAC,EAAE,CACR,OAAO,EAAE,uBAAuB,EAChC,KAAK,EAAE,YAAY,KAChB,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC3B;AAED,MAAM,WAAW,uBAAuB;IACtC,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,aAAa,GAAG,SAAS,CAAC;CACnC;AAED,MAAM,WAAW,sBAAuB,SAAQ,kBAAkB;IAChE,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,YAAY,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,MAAM,CAAC;IACvC,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,UAAU,CAAC,EAAE,CAAC,QAAQ,EAAE,uBAAuB,KAAK,IAAI,CAAC;CAC1D;AAED,MAAM,WAAW,qBAAqB;IACpC,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,MAAM,CAAC,EAAE,gBAAgB,EAAE,CAAC;CAC7B;AAED,MAAM,MAAM,kBAAkB,GAC1B,MAAM,GACN,MAAM,GACN,CAAC,CACC,MAAM,EAAE,qBAAqB,EAC7B,WAAW,EAAE,qBAAqB,KAC/B,OAAO,CAAC,CAAC;AAElB,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,UAAU,GAAG,SAAS,GAAG,SAAS,CAAC;CAC5C;AAED,MAAM,WAAW,kBAAmB,SAAQ,kBAAkB;IAC5D,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,YAAY,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,MAAM,CAAC;IACvC,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,OAAO,CAAC,EAAE,kBAAkB,CAAC;IAC7B,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,UAAU,CAAC,EAAE,CAAC,QAAQ,EAAE,mBAAmB,KAAK,IAAI,CAAC;CACtD;AAED,MAAM,WAAW,iBAAiB;IAChC,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,MAAM,CAAC,EAAE,gBAAgB,EAAE,CAAC;CAC7B"}
+{"version":3,"file":"storage.types.d.ts","sourceRoot":"","sources":["../src/storage.types.ts"],"names":[],"mappings":"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"}

package/dist/storage.types.js.map

@@ -1 +1 @@
-{"version":3,"file":"storage.types.js","sourceRoot":"","sources":["../src/storage.types.ts"],"names":[],"mappings":"","sourcesContent":["import type { Readable } from 'node:stream';\n\nimport type { StorageError } from './storage.error.js';\nimport type { StorageUploadControl } from './storage-upload-control.js';\n\nexport type StorageBody =\n  | Blob\n  | File\n  | ReadableStream<Uint8Array>\n  | Readable\n  | ArrayBuffer\n  | ArrayBufferView\n  | Uint8Array\n  | string;\n\nexport interface StorageRetryContext {\n  attempt: number;\n  error: StorageError;\n}\n\nexport type StorageRetryOptions =\n  | number\n  | {\n      max: number;\n      backoff?: (context: StorageRetryContext) => number;\n    };\n\nexport interface StorageOperationOptions {\n  signal?: AbortSignal;\n  timeout?: number;\n  retries?: StorageRetryOptions;\n}\n\nexport interface StorageMultipartOptions {\n  partSize?: number;\n  concurrency?: number;\n}\n\nexport interface StorageUploadProgress {\n  loaded: number;\n  total?: number;\n}\n\nexport interface StorageUploadOptions extends StorageOperationOptions {\n  contentType?: string;\n  cacheControl?: string;\n  metadata?: Record<string, string>;\n  onProgress?: (progress: StorageUploadProgress) => void;\n  multipart?: boolean | StorageMultipartOptions;\n  control?: StorageUploadControl;\n}\n\nexport interface StorageUploadResult {\n  key: string;\n  size: number;\n  contentType: string;\n  etag?: string;\n  lastModified?: Date;\n}\n\nexport interface StorageObjectMetadata {\n  key: string;\n  name: string;\n  size: number;\n  contentType: string;\n  etag?: string;\n  lastModified?: Date;\n  metadata?: Record<string, string>;\n}\n\nexport interface StorageObject extends StorageObjectMetadata {\n  body: ReadableStream<Uint8Array>;\n}\n\nexport interface StorageByteRange {\n  start: number;\n  end?: number;\n}\n\nexport interface StorageDownloadOptions extends StorageOperationOptions {\n  range?: StorageByteRange;\n}\n\nexport interface StorageBufferedDownloadOptions extends StorageDownloadOptions {\n  /**\n   * Maximum number of bytes buffered in memory. Defaults to 10 MiB.\n   * Pass `Infinity` only when the caller has independently bounded the object.\n   */\n  maxBytes?: number;\n}\n\nexport interface StorageListOptions extends StorageOperationOptions {\n  prefix?: string;\n  cursor?: string;\n  limit?: number;\n  delimiter?: string;\n}\n\nexport interface StorageListResult {\n  items: StorageObjectMetadata[];\n  prefixes?: string[];\n  cursor?: string;\n}\n\nexport type StorageSearchMatch = 'glob' | 'regex' | 'substring' | 'exact';\n\nexport interface StorageSearchOptions extends StorageOperationOptions {\n  prefix?: string;\n  limit?: number;\n  maxResults?: number;\n  match?: StorageSearchMatch;\n  caseInsensitive?: boolean;\n}\n\nexport interface StorageSignedDownloadOptions extends StorageOperationOptions {\n  expiresIn?: number;\n  responseContentDisposition?: string;\n}\n\nexport interface StorageSignedUploadOptions extends StorageOperationOptions {\n  expiresIn: number;\n  contentType?: string;\n  maxSize?: number;\n  minSize?: number;\n}\n\nexport type StorageSignedUpload =\n  | {\n      method: 'PUT';\n      url: string;\n      headers?: Record<string, string>;\n    }\n  | {\n      method: 'POST';\n      url: string;\n      fields: Record<string, string>;\n    };\n\nexport interface StorageSignedUrlCapability {\n  supported: boolean;\n  maxExpiresIn?: number;\n}\n\nexport interface StorageCapabilities {\n  rangeRead: boolean;\n  /** True when the provider reports native byte-level upload progress. */\n  nativeUploadProgress: boolean;\n  delimiter: boolean;\n  metadata: boolean;\n  cacheControl: boolean;\n  resumableUpload: boolean;\n  serverSideCopy: boolean;\n  signedDownload: StorageSignedUrlCapability;\n  /**\n   * Some providers decide support from credentials or requested constraints,\n   * so direct-upload support can only be known when the call is attempted.\n   */\n  signedUpload: boolean | 'runtime';\n}\n\nexport interface StorageBulkOptions {\n  concurrency?: number;\n  stopOnError?: boolean;\n}\n\nexport interface StorageBulkError {\n  key: string;\n  error: StorageError;\n}\n\nexport interface StorageUploadManyItem {\n  key: string;\n  body: StorageBody;\n  contentType?: string;\n  cacheControl?: string;\n  metadata?: Record<string, string>;\n  multipart?: boolean | StorageMultipartOptions;\n}\n\nexport interface StorageUploadManyOptions\n  extends StorageBulkOptions, StorageOperationOptions {\n  onProgress?: (progress: StorageUploadProgress & { key: string }) => void;\n}\n\nexport interface StorageUploadManyResult {\n  uploaded: StorageUploadResult[];\n  errors?: StorageBulkError[];\n}\n\nexport interface StorageDownloadManyResult {\n  downloaded: StorageObject[];\n  errors?: StorageBulkError[];\n}\n\nexport interface StorageHeadManyResult {\n  objects: StorageObjectMetadata[];\n  errors?: StorageBulkError[];\n}\n\nexport interface StorageExistsManyResult {\n  existing: string[];\n  missing: string[];\n  errors?: StorageBulkError[];\n}\n\nexport interface StorageDeleteManyResult {\n  deleted: string[];\n  errors?: StorageBulkError[];\n}\n\nexport type StorageOperationName =\n  | 'upload'\n  | 'download'\n  | 'head'\n  | 'exists'\n  | 'delete'\n  | 'copy'\n  | 'move'\n  | 'list'\n  | 'search'\n  | 'signDownload'\n  | 'signUpload';\n\nexport interface StorageOperationContext {\n  store: string;\n  operation: StorageOperationName;\n  key?: string;\n  from?: string;\n  to?: string;\n}\n\nexport interface StoragePlugin {\n  name?: string;\n  /**\n   * Runs before the driver and may reject an operation, for example to enforce\n   * policy. Hooks run in registration order.\n   */\n  beforeOperation?: (context: StorageOperationContext) => void | Promise<void>;\n  /**\n   * Observes a successful operation. Throwing turns the call into a failure,\n   * which is useful for mandatory audit sinks.\n   *\n   * For streaming downloads, success means the provider returned a stream.\n   * Later consumption failures are normalized for the stream consumer but do\n   * not re-enter plugin hooks.\n   */\n  afterOperation?: (\n    context: StorageOperationContext,\n    result: unknown,\n  ) => void | Promise<void>;\n  /**\n   * Best-effort error observation. Hook failures never replace the original\n   * storage error.\n   */\n  onError?: (\n    context: StorageOperationContext,\n    error: StorageError,\n  ) => void | Promise<void>;\n}\n\nexport interface StorageTransferProgress {\n  done: number;\n  total: number;\n  key: string;\n  status: 'transferred' | 'skipped';\n}\n\nexport interface StorageTransferOptions extends StorageBulkOptions {\n  from: string;\n  to: string;\n  prefix?: string;\n  transformKey?: (key: string) => string;\n  overwrite?: boolean;\n  limit?: number;\n  signal?: AbortSignal;\n  onProgress?: (progress: StorageTransferProgress) => void;\n}\n\nexport interface StorageTransferResult {\n  transferred: string[];\n  skipped?: string[];\n  errors?: StorageBulkError[];\n}\n\nexport type StorageSyncCompare =\n  | 'etag'\n  | 'size'\n  | ((\n      source: StorageObjectMetadata,\n      destination: StorageObjectMetadata,\n    ) => boolean);\n\nexport interface StorageSyncProgress {\n  done: number;\n  total: number;\n  key: string;\n  status: 'uploaded' | 'skipped' | 'deleted';\n}\n\nexport interface StorageSyncOptions extends StorageBulkOptions {\n  from: string;\n  to: string;\n  prefix?: string;\n  destinationPrefix?: string;\n  transformKey?: (key: string) => string;\n  prune?: boolean;\n  compare?: StorageSyncCompare;\n  dryRun?: boolean;\n  limit?: number;\n  signal?: AbortSignal;\n  onProgress?: (progress: StorageSyncProgress) => void;\n}\n\nexport interface StorageSyncResult {\n  uploaded: string[];\n  skipped: string[];\n  deleted?: string[];\n  errors?: StorageBulkError[];\n}\n"]}
+{"version":3,"file":"storage.types.js","sourceRoot":"","sources":["../src/storage.types.ts"],"names":[],"mappings":"","sourcesContent":["import type { Readable } from 'node:stream';\n\nimport type { StorageError } from './storage.error.js';\nimport type { StorageUploadControl } from './storage-upload-control.js';\n\nexport type StorageBody =\n  | Blob\n  | File\n  | ReadableStream<Uint8Array>\n  | Readable\n  | ArrayBuffer\n  | ArrayBufferView\n  | Uint8Array\n  | string;\n\nexport interface StorageRetryContext {\n  attempt: number;\n  error: StorageError;\n}\n\nexport type StorageRetryOptions =\n  | number\n  | {\n      max: number;\n      backoff?: (context: StorageRetryContext) => number;\n    };\n\nexport interface StorageOperationOptions {\n  signal?: AbortSignal;\n  timeout?: number;\n  retries?: StorageRetryOptions;\n}\n\n/**\n * Preconditions for promoting a staged object to its final key. At least one\n * source identity must be supplied; unsupported identities fail closed.\n */\nexport interface StoragePromotionOptions extends StorageOperationOptions {\n  /** Copy only the source object whose provider ETag exactly matches. */\n  sourceEtag?: string;\n  /** Copy this immutable provider version of the source object. */\n  sourceVersion?: string;\n}\n\nexport interface StorageMultipartOptions {\n  partSize?: number;\n  concurrency?: number;\n}\n\nexport interface StorageUploadProgress {\n  loaded: number;\n  total?: number;\n}\n\nexport interface StorageUploadOptions extends StorageOperationOptions {\n  contentType?: string;\n  cacheControl?: string;\n  metadata?: Record<string, string>;\n  onProgress?: (progress: StorageUploadProgress) => void;\n  multipart?: boolean | StorageMultipartOptions;\n  control?: StorageUploadControl;\n}\n\nexport interface StorageUploadResult {\n  key: string;\n  size: number;\n  contentType: string;\n  etag?: string;\n  lastModified?: Date;\n}\n\nexport interface StorageObjectMetadata {\n  key: string;\n  name: string;\n  size: number;\n  contentType: string;\n  etag?: string;\n  lastModified?: Date;\n  metadata?: Record<string, string>;\n}\n\nexport interface StorageObject extends StorageObjectMetadata {\n  body: ReadableStream<Uint8Array>;\n}\n\nexport interface StorageByteRange {\n  start: number;\n  end?: number;\n}\n\nexport interface StorageDownloadOptions extends StorageOperationOptions {\n  range?: StorageByteRange;\n}\n\nexport interface StorageBufferedDownloadOptions extends StorageDownloadOptions {\n  /**\n   * Maximum number of bytes buffered in memory. Defaults to 10 MiB.\n   * Pass `Infinity` only when the caller has independently bounded the object.\n   */\n  maxBytes?: number;\n}\n\nexport interface StorageListOptions extends StorageOperationOptions {\n  prefix?: string;\n  cursor?: string;\n  limit?: number;\n  delimiter?: string;\n}\n\nexport interface StorageListResult {\n  items: StorageObjectMetadata[];\n  prefixes?: string[];\n  cursor?: string;\n}\n\nexport type StorageSearchMatch = 'glob' | 'regex' | 'substring' | 'exact';\n\nexport interface StorageSearchOptions extends StorageOperationOptions {\n  prefix?: string;\n  limit?: number;\n  maxResults?: number;\n  match?: StorageSearchMatch;\n  caseInsensitive?: boolean;\n}\n\nexport interface StorageSignedDownloadOptions extends StorageOperationOptions {\n  expiresIn?: number;\n  responseContentDisposition?: string;\n}\n\nexport interface StorageSignedUploadOptions extends StorageOperationOptions {\n  expiresIn: number;\n  contentType?: string;\n  maxSize?: number;\n  minSize?: number;\n}\n\nexport type StorageSignedUpload =\n  | {\n      method: 'PUT';\n      url: string;\n      headers?: Record<string, string>;\n    }\n  | {\n      method: 'POST';\n      url: string;\n      fields: Record<string, string>;\n    };\n\nexport interface StorageSignedUrlCapability {\n  supported: boolean;\n  maxExpiresIn?: number;\n}\n\nexport interface StorageConditionalCopyCapability {\n  supported: boolean;\n  etag: boolean;\n  version: boolean;\n}\n\nexport interface StorageSignedUploadPolicyCapability {\n  /** The signed request fixes the exact declared content type. */\n  contentType: boolean;\n  /** The signed request enforces the requested min/max byte range. */\n  sizeRange: boolean;\n}\n\nexport interface StorageSignedDownloadPolicyCapability {\n  /** Every generated URL honors the requested expiry. */\n  expiresIn: boolean;\n}\n\nexport interface StorageCapabilities {\n  rangeRead: boolean;\n  /** True when the provider reports native byte-level upload progress. */\n  nativeUploadProgress: boolean;\n  delimiter: boolean;\n  metadata: boolean;\n  cacheControl: boolean;\n  resumableUpload: boolean;\n  serverSideCopy: boolean;\n  /**\n   * Conditional server-side copy used to promote an already verified staged\n   * object without a validation/copy race. Absent means unsupported for\n   * compatibility with drivers built against earlier package versions.\n   */\n  conditionalCopy?: StorageConditionalCopyCapability;\n  signedDownload: StorageSignedUrlCapability;\n  /** Expiry guarantees enforced by the provider adapter. */\n  signedDownloadPolicy?: StorageSignedDownloadPolicyCapability;\n  /**\n   * Some providers decide support from credentials or requested constraints,\n   * so direct-upload support can only be known when the call is attempted.\n   */\n  signedUpload: boolean | 'runtime';\n  /**\n   * Constraints cryptographically/provider-policy enforced by direct upload.\n   * Absent means callers must not assume request options are enforced.\n   */\n  signedUploadPolicy?: StorageSignedUploadPolicyCapability;\n}\n\nexport interface StorageBulkOptions {\n  concurrency?: number;\n  stopOnError?: boolean;\n}\n\nexport interface StorageBulkError {\n  key: string;\n  error: StorageError;\n}\n\nexport interface StorageUploadManyItem {\n  key: string;\n  body: StorageBody;\n  contentType?: string;\n  cacheControl?: string;\n  metadata?: Record<string, string>;\n  multipart?: boolean | StorageMultipartOptions;\n}\n\nexport interface StorageUploadManyOptions\n  extends StorageBulkOptions, StorageOperationOptions {\n  onProgress?: (progress: StorageUploadProgress & { key: string }) => void;\n}\n\nexport interface StorageUploadManyResult {\n  uploaded: StorageUploadResult[];\n  errors?: StorageBulkError[];\n}\n\nexport interface StorageDownloadManyResult {\n  downloaded: StorageObject[];\n  errors?: StorageBulkError[];\n}\n\nexport interface StorageHeadManyResult {\n  objects: StorageObjectMetadata[];\n  errors?: StorageBulkError[];\n}\n\nexport interface StorageExistsManyResult {\n  existing: string[];\n  missing: string[];\n  errors?: StorageBulkError[];\n}\n\nexport interface StorageDeleteManyResult {\n  deleted: string[];\n  errors?: StorageBulkError[];\n}\n\nexport type StorageOperationName =\n  | 'upload'\n  | 'download'\n  | 'head'\n  | 'exists'\n  | 'delete'\n  | 'copy'\n  | 'move'\n  | 'promote'\n  | 'list'\n  | 'search'\n  | 'signDownload'\n  | 'signUpload';\n\nexport interface StorageOperationContext {\n  store: string;\n  operation: StorageOperationName;\n  key?: string;\n  from?: string;\n  to?: string;\n}\n\nexport interface StoragePlugin {\n  name?: string;\n  /**\n   * Runs before the driver and may reject an operation, for example to enforce\n   * policy. Hooks run in registration order.\n   */\n  beforeOperation?: (context: StorageOperationContext) => void | Promise<void>;\n  /**\n   * Observes a successful operation. Throwing turns the call into a failure,\n   * which is useful for mandatory audit sinks.\n   *\n   * For streaming downloads, success means the provider returned a stream.\n   * Later consumption failures are normalized for the stream consumer but do\n   * not re-enter plugin hooks.\n   */\n  afterOperation?: (\n    context: StorageOperationContext,\n    result: unknown,\n  ) => void | Promise<void>;\n  /**\n   * Best-effort error observation. Hook failures never replace the original\n   * storage error.\n   */\n  onError?: (\n    context: StorageOperationContext,\n    error: StorageError,\n  ) => void | Promise<void>;\n}\n\nexport interface StorageTransferProgress {\n  done: number;\n  total: number;\n  key: string;\n  status: 'transferred' | 'skipped';\n}\n\nexport interface StorageTransferOptions extends StorageBulkOptions {\n  from: string;\n  to: string;\n  prefix?: string;\n  transformKey?: (key: string) => string;\n  overwrite?: boolean;\n  limit?: number;\n  signal?: AbortSignal;\n  onProgress?: (progress: StorageTransferProgress) => void;\n}\n\nexport interface StorageTransferResult {\n  transferred: string[];\n  skipped?: string[];\n  errors?: StorageBulkError[];\n}\n\nexport type StorageSyncCompare =\n  | 'etag'\n  | 'size'\n  | ((\n      source: StorageObjectMetadata,\n      destination: StorageObjectMetadata,\n    ) => boolean);\n\nexport interface StorageSyncProgress {\n  done: number;\n  total: number;\n  key: string;\n  status: 'uploaded' | 'skipped' | 'deleted';\n}\n\nexport interface StorageSyncOptions extends StorageBulkOptions {\n  from: string;\n  to: string;\n  prefix?: string;\n  destinationPrefix?: string;\n  transformKey?: (key: string) => string;\n  prune?: boolean;\n  compare?: StorageSyncCompare;\n  dryRun?: boolean;\n  limit?: number;\n  signal?: AbortSignal;\n  onProgress?: (progress: StorageSyncProgress) => void;\n}\n\nexport interface StorageSyncResult {\n  uploaded: string[];\n  skipped: string[];\n  deleted?: string[];\n  errors?: StorageBulkError[];\n}\n"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nestm/storage",
-  "version": "0.1.0-alpha.2",
+  "version": "0.1.0-alpha.3",
   "description": "Framework-neutral storage clients with NestJS 12 integration, named stores, streaming I/O, and an optional guarded HTTP gateway.",
   "license": "MIT",
   "author": "Kauan Guesser",
@@ -27,6 +27,10 @@
       "types": "./dist/files-sdk/index.d.ts",
       "import": "./dist/files-sdk/index.js"
     },
+    "./files-sdk/s3": {
+      "types": "./dist/files-sdk/s3/index.d.ts",
+      "import": "./dist/files-sdk/s3/index.js"
+    },
     "./gateway": {
       "types": "./dist/gateway/index.d.ts",
       "import": "./dist/gateway/index.js"
@@ -69,12 +73,28 @@
     "files-sdk": "2.2.2"
   },
   "peerDependencies": {
+    "@aws-sdk/client-s3": "^3.700.0",
+    "@aws-sdk/lib-storage": "^3.700.0",
+    "@aws-sdk/s3-presigned-post": "^3.700.0",
+    "@aws-sdk/s3-request-presigner": "^3.700.0",
     "@nestjs/common": "^12.0.0-alpha.5",
     "@nestjs/core": "^12.0.0-alpha.5",
     "reflect-metadata": "^0.2.2",
     "rxjs": "^7.8.1"
   },
   "peerDependenciesMeta": {
+    "@aws-sdk/client-s3": {
+      "optional": true
+    },
+    "@aws-sdk/lib-storage": {
+      "optional": true
+    },
+    "@aws-sdk/s3-presigned-post": {
+      "optional": true
+    },
+    "@aws-sdk/s3-request-presigner": {
+      "optional": true
+    },
     "@nestjs/common": {
       "optional": true
     },
@@ -89,6 +109,10 @@
     }
   },
   "devDependencies": {
+    "@aws-sdk/client-s3": "3.1101.0",
+    "@aws-sdk/lib-storage": "3.1101.0",
+    "@aws-sdk/s3-presigned-post": "3.1101.0",
+    "@aws-sdk/s3-request-presigner": "3.1101.0",
     "@changesets/cli": "2.31.1",
     "@nestjs/common": "12.0.0-alpha.5",
     "@nestjs/core": "12.0.0-alpha.5",