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

package/CHANGELOG.md

@@ -1,5 +1,34 @@
 # @nestm/storage
 
+## 0.1.0-alpha.4
+
+### Minor Changes
+
+- 79ad3af: Add runtime provider selection and a package-owned filesystem driver.
+
+  `@nestm/storage/files-sdk/provider` builds a driver from a provider slug carried
+  as data — `createProviderStorageDriver({ provider: 's3' | 'gcs' | 'azure' | 'r2'
+| 'fs' | … })` — importing that provider's adapter, and only that one, on
+  demand. A deployment now selects its store with an environment variable and
+  installs a single native SDK instead of the application hard-coding a driver per
+  backend. The same entry point exposes the provider catalog (`listStorageProviders`,
+  `getStorageProvider`, `listStorageProviderEnvVars`,
+  `listStorageProviderSecretEnvVars`, `isStorageProvider`) as pure data, so config
+  validation and health checks can read a provider's env contract without loading
+  an adapter. An unknown slug fails closed with `INVALID_ARGUMENT` before anything
+  is imported.
+
+  `@nestm/storage/files-sdk/fs` adds `createFsStorageDriver` for local filesystem
+  storage, mirroring the S3 factory. Its adapter reaches only `node:fs`, so it adds
+  no native SDK to an install.
+
+  `@nestm/storage/files-sdk/s3` additionally exports `withS3Capabilities`, which
+  applies S3's conditional-copy promotion and signed-policy declarations to an
+  adapter built by `s3(...)`. The provider factory uses it so the `s3` slug keeps
+  those capabilities without re-deriving `S3AdapterOptions` from flat config.
+  `EnhancedS3Adapter` is now `S3StorageAdapter`; the type was not previously
+  exported.
+
 ## 0.1.0-alpha.3
 
 ### Minor Changes

package/README.md

@@ -33,7 +33,7 @@ pinned engine explicitly only when the application imports another adapter
 such as `files-sdk/gcs`:
 
 ```sh
-pnpm add files-sdk@2.2.2
+pnpm add files-sdk@2.2.3
 ```
 
 Install only the native SDKs required by the chosen provider. For example:
@@ -225,6 +225,71 @@ modules retain their own DI scope rather than mutating an application-wide
 registry. Names are case-sensitive and cannot contain leading or trailing
 whitespace.
 
+### Select the provider at runtime
+
+An application that ships to more than one environment usually cannot name its
+provider at build time. `createProviderStorageDriver` takes the slug as data and
+imports that provider's adapter — and only that one — on demand, so a deployment
+picks its store with an environment variable and installs one native SDK:
+
+```ts
+import { createProviderStorageDriver } from '@nestm/storage/files-sdk/provider';
+
+StorageModule.forRootAsync({
+  imports: [ConfigModule],
+  stores: [
+    {
+      name: 'media',
+      inject: [ConfigService],
+      useFactory: (config: ConfigService) =>
+        createProviderStorageDriver({
+          provider: config.getOrThrow('STORAGE_PROVIDER'),
+          prefix: config.get('STORAGE_PREFIX'),
+          config: {
+            bucket: config.get('STORAGE_BUCKET'),
+            region: config.get('STORAGE_REGION'),
+            root: config.get('STORAGE_ROOT'),
+          },
+        }),
+    },
+  ],
+});
+```
+
+`config` is one flat bag of provider settings — `bucket` and `region` for an
+object store, `root` for the filesystem, `accountName` and `container` for
+Azure. Each provider reads what it needs and ignores the rest, so the same shape
+survives a provider change. Credentials may be omitted wherever the provider's
+SDK resolves its own chain (an IAM role, Application Default Credentials, a
+shared profile).
+
+An unknown slug fails closed with `INVALID_ARGUMENT` before anything is
+imported. Validate untrusted input up front with `isStorageProvider`, and drive
+config validation from the catalog rather than a hand-kept list:
+
+```ts
+import {
+  getStorageProvider,
+  isStorageProvider,
+  listStorageProviders,
+  listStorageProviderSecretEnvVars,
+} from '@nestm/storage/files-sdk/provider';
+
+listStorageProviders().map((provider) => provider.slug); // 'akamai', 'alibaba', …
+getStorageProvider('gcs')?.peerDeps; // ['@google-cloud/storage', …]
+listStorageProviderSecretEnvVars('s3').map((variable) => variable.key);
+```
+
+The catalog is pure data and pulls in no adapter, so it is safe in config UIs,
+health checks, and startup validation.
+
+The `s3` slug additionally carries the conditional-promotion and signed-policy
+capabilities described under
+[Race-free staged-object promotion](#race-free-staged-object-promotion); every
+other provider exposes exactly what its adapter declares. When the provider _is_
+known at build time, import `@nestm/storage/files-sdk/s3` or
+`@nestm/storage/files-sdk/fs` directly and skip the indirection.
+
 ## Storage API
 
 `StorageClient` exposes:
@@ -510,8 +575,26 @@ StorageModule.forRoot({
 });
 ```
 
-For local filesystem storage, import `fs` from `files-sdk/fs` and pass it to
-`createFilesSdkDriver` exactly like a cloud adapter.
+For local filesystem storage, use the package-owned factory. The adapter reaches
+only `node:fs`, so it needs no native SDK:
+
+```ts
+import { createFsStorageDriver } from '@nestm/storage/files-sdk/fs';
+
+StorageModule.forRoot({
+  stores: [
+    {
+      name: 'artifacts',
+      driver: createFsStorageDriver({ adapter: { root: './var/artifacts' } }),
+    },
+  ],
+});
+```
+
+Bodies are written verbatim at `<root>/<key>`. A `<key>.meta.json` sidecar beside
+each one carries the content type, ETag, and custom metadata a filesystem has
+nowhere else to put; sidecars never surface as keys, and uploading a key ending
+in `.meta.json` fails closed rather than colliding with one.
 
 ## License
 

package/dist/files-sdk/files-sdk.driver.d.ts

@@ -23,30 +23,30 @@ export declare class FilesSdkStorageDriver<AdapterType extends Adapter = Adapter
     constructor(options: FilesSdkDriverOptions<AdapterType>);
     get name(): string;
     get capabilities(): {
-        nativeUploadProgress: boolean;
-        signedUploadPolicy?: {
-            contentType: boolean;
-            sizeRange: boolean;
-        };
-        signedUpload: "runtime";
-        signedDownloadPolicy?: {
-            expiresIn: boolean;
-        };
-        signedDownload: {
-            supported: boolean;
-            maxExpiresIn?: number;
-        };
-        conditionalCopy?: {
-            supported: boolean;
-            etag: boolean;
-            version: boolean;
-        };
         cacheControl: boolean;
         delimiter: boolean;
         metadata: boolean;
         rangeRead: boolean;
         resumableUpload: boolean;
         serverSideCopy: boolean;
+        conditionalCopy?: {
+            supported: boolean;
+            etag: boolean;
+            version: boolean;
+        };
+        signedDownload: {
+            supported: boolean;
+            maxExpiresIn?: number;
+        };
+        signedDownloadPolicy?: {
+            expiresIn: boolean;
+        };
+        signedUpload: 'runtime';
+        signedUploadPolicy?: {
+            contentType: boolean;
+            sizeRange: boolean;
+        };
+        nativeUploadProgress: boolean;
     };
     upload(key: string, body: StorageBody, options?: StorageUploadOptions): Promise<StorageUploadResult>;
     download(key: string, options?: StorageDownloadOptions): Promise<StorageObject>;

package/dist/files-sdk/files-sdk.driver.d.ts.map

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

package/dist/files-sdk/fs/index.d.ts

@@ -0,0 +1,21 @@
+import { type FsAdapter, type FsAdapterOptions } from 'files-sdk/fs';
+import { type FilesSdkDriverOptions, type FilesSdkStorageDriver } from '../files-sdk.driver.js';
+export interface FsStorageDriverOptions extends Omit<FilesSdkDriverOptions<FsAdapter>, 'adapter'> {
+    adapter: FsAdapterOptions;
+}
+/**
+ * Creates the files-sdk filesystem driver from the storage package's own
+ * dependency context. The adapter reaches only `node:fs`, so this entry point
+ * adds no native SDK to the install — unlike every object-store provider, it is
+ * always available.
+ *
+ * The adapter keeps a `<key>.meta.json` sidecar beside each body to carry the
+ * content type, ETag, and custom metadata that a filesystem has nowhere else to
+ * put. Sidecars never surface as keys: `list` and `search` skip them, and
+ * uploading a key that ends in `.meta.json` fails closed rather than colliding
+ * with one.
+ */
+export declare function createFsStorageDriver(options: FsStorageDriverOptions): FilesSdkStorageDriver<FsAdapter>;
+export { fs, mapFsError } from 'files-sdk/fs';
+export type { FsAdapter, FsAdapterOptions } from 'files-sdk/fs';
+//# sourceMappingURL=index.d.ts.map

package/dist/files-sdk/fs/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/files-sdk/fs/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAM,KAAK,SAAS,EAAE,KAAK,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAEzE,OAAO,EAEL,KAAK,qBAAqB,EAC1B,KAAK,qBAAqB,EAC3B,MAAM,wBAAwB,CAAC;AAEhC,MAAM,WAAW,sBAAuB,SAAQ,IAAI,CAClD,qBAAqB,CAAC,SAAS,CAAC,EAChC,SAAS,CACV;IACC,OAAO,EAAE,gBAAgB,CAAC;CAC3B;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,sBAAsB,GAC9B,qBAAqB,CAAC,SAAS,CAAC,CAGlC;AAED,OAAO,EAAE,EAAE,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC9C,YAAY,EAAE,SAAS,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC"}

package/dist/files-sdk/fs/index.js

@@ -0,0 +1,20 @@
+import { fs } from 'files-sdk/fs';
+import { createFilesSdkDriver, } from '../files-sdk.driver.js';
+/**
+ * Creates the files-sdk filesystem driver from the storage package's own
+ * dependency context. The adapter reaches only `node:fs`, so this entry point
+ * adds no native SDK to the install — unlike every object-store provider, it is
+ * always available.
+ *
+ * The adapter keeps a `<key>.meta.json` sidecar beside each body to carry the
+ * content type, ETag, and custom metadata that a filesystem has nowhere else to
+ * put. Sidecars never surface as keys: `list` and `search` skip them, and
+ * uploading a key that ends in `.meta.json` fails closed rather than colliding
+ * with one.
+ */
+export function createFsStorageDriver(options) {
+    const { adapter: adapterOptions, ...filesOptions } = options;
+    return createFilesSdkDriver({ ...filesOptions, adapter: fs(adapterOptions) });
+}
+export { fs, mapFsError } from 'files-sdk/fs';
+//# sourceMappingURL=index.js.map

package/dist/files-sdk/fs/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/files-sdk/fs/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,EAAE,EAAyC,MAAM,cAAc,CAAC;AAEzE,OAAO,EACL,oBAAoB,GAGrB,MAAM,wBAAwB,CAAC;AAShC;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,qBAAqB,CACnC,OAA+B;IAE/B,MAAM,EAAE,OAAO,EAAE,cAAc,EAAE,GAAG,YAAY,EAAE,GAAG,OAAO,CAAC;IAC7D,OAAO,oBAAoB,CAAC,EAAE,GAAG,YAAY,EAAE,OAAO,EAAE,EAAE,CAAC,cAAc,CAAC,EAAE,CAAC,CAAC;AAChF,CAAC;AAED,OAAO,EAAE,EAAE,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC","sourcesContent":["import { fs, type FsAdapter, type FsAdapterOptions } from 'files-sdk/fs';\n\nimport {\n  createFilesSdkDriver,\n  type FilesSdkDriverOptions,\n  type FilesSdkStorageDriver,\n} from '../files-sdk.driver.js';\n\nexport interface FsStorageDriverOptions extends Omit<\n  FilesSdkDriverOptions<FsAdapter>,\n  'adapter'\n> {\n  adapter: FsAdapterOptions;\n}\n\n/**\n * Creates the files-sdk filesystem driver from the storage package's own\n * dependency context. The adapter reaches only `node:fs`, so this entry point\n * adds no native SDK to the install — unlike every object-store provider, it is\n * always available.\n *\n * The adapter keeps a `<key>.meta.json` sidecar beside each body to carry the\n * content type, ETag, and custom metadata that a filesystem has nowhere else to\n * put. Sidecars never surface as keys: `list` and `search` skip them, and\n * uploading a key that ends in `.meta.json` fails closed rather than colliding\n * with one.\n */\nexport function createFsStorageDriver(\n  options: FsStorageDriverOptions,\n): FilesSdkStorageDriver<FsAdapter> {\n  const { adapter: adapterOptions, ...filesOptions } = options;\n  return createFilesSdkDriver({ ...filesOptions, adapter: fs(adapterOptions) });\n}\n\nexport { fs, mapFsError } from 'files-sdk/fs';\nexport type { FsAdapter, FsAdapterOptions } from 'files-sdk/fs';\n"]}

package/dist/files-sdk/provider/index.d.ts

@@ -0,0 +1,54 @@
+import type { Adapter } from 'files-sdk';
+import { type LoadFilesOptions } from 'files-sdk/loader';
+import { type EnvVar, type Provider, type ProviderSlug } from 'files-sdk/providers';
+import { type FilesSdkDriverOptions, type FilesSdkStorageDriver } from '../files-sdk.driver.js';
+/** Slug of a storage provider this package can build a driver for. */
+export type StorageProviderName = ProviderSlug;
+/**
+ * Flat, provider-specific settings — `bucket` and `region` for an object store,
+ * `root` for the filesystem, `accountName` and `container` for Azure, and so
+ * on. Every provider reads what it needs and ignores the rest, so one config
+ * shape serves a deployment that switches providers by name.
+ *
+ * Credentials may be omitted for any provider whose SDK resolves its own chain
+ * (an IAM role, Application Default Credentials, a shared profile).
+ */
+export type StorageProviderConfig = Omit<LoadFilesOptions, 'provider'>;
+export interface ProviderStorageDriverOptions extends Omit<FilesSdkDriverOptions<Adapter>, 'adapter'> {
+    /** Which provider to build. Validate untrusted input with {@link isStorageProvider}. */
+    provider: StorageProviderName;
+    config?: StorageProviderConfig;
+}
+/**
+ * Builds a {@link FilesSdkStorageDriver} for a provider named at runtime,
+ * importing that provider's adapter — and only that one — on demand. A
+ * deployment selects its store with a string (`'s3'`, `'gcs'`, `'azure'`,
+ * `'r2'`, `'fs'`, …) and installs one native SDK, instead of the application
+ * hard-coding a driver per backend.
+ *
+ * The `s3` slug additionally gets the conditional-promotion and signed-policy
+ * capabilities {@link createS3StorageDriver} attaches; every other provider
+ * exposes exactly what its adapter declares. Import
+ * `@nestm/storage/files-sdk/s3` directly when the provider is known at build
+ * time and the extra indirection buys nothing.
+ *
+ * @throws StorageError `INVALID_ARGUMENT` for an unknown slug, and whatever the
+ * adapter reports (mapped) when required config or credentials are missing.
+ */
+export declare function createProviderStorageDriver(options: ProviderStorageDriverOptions): Promise<FilesSdkStorageDriver>;
+/** Narrows an untrusted string — an env var, a config file — to a known slug. */
+export declare function isStorageProvider(value: string): value is StorageProviderName;
+/** Every provider that can be named, sorted by slug. */
+export declare function listStorageProviders(): readonly Provider[];
+/** One provider's display name, description, native SDKs, and env contract. */
+export declare function getStorageProvider(slug: string): Provider | undefined;
+/**
+ * Every environment variable a provider reads, flattened across required, all
+ * credential modes, and optional. Useful for validating a deployment's config
+ * before the first upload rather than at it.
+ */
+export declare function listStorageProviderEnvVars(slug: string): EnvVar[];
+/** The subset of {@link listStorageProviderEnvVars} that carries secrets. */
+export declare function listStorageProviderSecretEnvVars(slug: string): EnvVar[];
+export type { EnvVar as StorageProviderEnvVar, Provider as StorageProviderInfo, } from 'files-sdk/providers';
+//# sourceMappingURL=index.d.ts.map

package/dist/files-sdk/provider/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/files-sdk/provider/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,EAAa,KAAK,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AACpE,OAAO,EAKL,KAAK,MAAM,EACX,KAAK,QAAQ,EACb,KAAK,YAAY,EAClB,MAAM,qBAAqB,CAAC;AAG7B,OAAO,EAGL,KAAK,qBAAqB,EAC1B,KAAK,qBAAqB,EAC3B,MAAM,wBAAwB,CAAC;AAEhC,sEAAsE;AACtE,MAAM,MAAM,mBAAmB,GAAG,YAAY,CAAC;AAE/C;;;;;;;;GAQG;AACH,MAAM,MAAM,qBAAqB,GAAG,IAAI,CAAC,gBAAgB,EAAE,UAAU,CAAC,CAAC;AAEvE,MAAM,WAAW,4BAA6B,SAAQ,IAAI,CACxD,qBAAqB,CAAC,OAAO,CAAC,EAC9B,SAAS,CACV;IACC,wFAAwF;IACxF,QAAQ,EAAE,mBAAmB,CAAC;IAC9B,MAAM,CAAC,EAAE,qBAAqB,CAAC;CAChC;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAsB,2BAA2B,CAC/C,OAAO,EAAE,4BAA4B,GACpC,OAAO,CAAC,qBAAqB,CAAC,CAWhC;AAoCD,iFAAiF;AACjF,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,GAAG,KAAK,IAAI,mBAAmB,CAE7E;AAED,wDAAwD;AACxD,wBAAgB,oBAAoB,IAAI,SAAS,QAAQ,EAAE,CAE1D;AAED,+EAA+E;AAC/E,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,QAAQ,GAAG,SAAS,CAErE;AAED;;;;GAIG;AACH,wBAAgB,0BAA0B,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,CAEjE;AAED,6EAA6E;AAC7E,wBAAgB,gCAAgC,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,CAEvE;AAED,YAAY,EACV,MAAM,IAAI,qBAAqB,EAC/B,QAAQ,IAAI,mBAAmB,GAChC,MAAM,qBAAqB,CAAC"}

package/dist/files-sdk/provider/index.js

@@ -0,0 +1,80 @@
+import { loadFiles } from 'files-sdk/loader';
+import { PROVIDER_NAMES, getProvider, getSecretEnvVars, listEnvVars, } from 'files-sdk/providers';
+import { StorageError, StorageErrorCode } from '../../storage.error.js';
+import { createFilesSdkDriver, mapFilesSdkError, } from '../files-sdk.driver.js';
+/**
+ * Builds a {@link FilesSdkStorageDriver} for a provider named at runtime,
+ * importing that provider's adapter — and only that one — on demand. A
+ * deployment selects its store with a string (`'s3'`, `'gcs'`, `'azure'`,
+ * `'r2'`, `'fs'`, …) and installs one native SDK, instead of the application
+ * hard-coding a driver per backend.
+ *
+ * The `s3` slug additionally gets the conditional-promotion and signed-policy
+ * capabilities {@link createS3StorageDriver} attaches; every other provider
+ * exposes exactly what its adapter declares. Import
+ * `@nestm/storage/files-sdk/s3` directly when the provider is known at build
+ * time and the extra indirection buys nothing.
+ *
+ * @throws StorageError `INVALID_ARGUMENT` for an unknown slug, and whatever the
+ * adapter reports (mapped) when required config or credentials are missing.
+ */
+export async function createProviderStorageDriver(options) {
+    const { provider, config, ...filesOptions } = options;
+    if (!isStorageProvider(provider)) {
+        throw unknownProvider(provider);
+    }
+    // `loadFiles` owns the slug → adapter mapping and keeps the import lazy; the
+    // client it returns is discarded so the caller's own driver options (prefix,
+    // hooks, plugins, readonly, retries) apply to the instance the bridge builds.
+    const adapter = await resolveAdapter(provider, config);
+    return createFilesSdkDriver({ ...filesOptions, adapter });
+}
+async function resolveAdapter(provider, config) {
+    let resolved;
+    try {
+        resolved = await loadFiles({ ...config, provider });
+    }
+    catch (error) {
+        throw mapFilesSdkError(error);
+    }
+    const { adapter } = resolved.files;
+    if (provider !== 's3') {
+        return adapter;
+    }
+    // Built by `s3(...)`, so its `raw` is an S3Client and the promotion path
+    // holds. The S3-compatible wrappers keep only what they declare themselves.
+    const { withS3Capabilities } = await import('../s3/index.js');
+    return withS3Capabilities(adapter, {
+        ...(config?.publicBaseUrl !== undefined && {
+            publicBaseUrl: config.publicBaseUrl,
+        }),
+    });
+}
+function unknownProvider(provider) {
+    return new StorageError(`Unknown storage provider: ${JSON.stringify(provider)}. Known providers: ${PROVIDER_NAMES.join(', ')}.`, { code: StorageErrorCode.INVALID_ARGUMENT, permanent: true });
+}
+/** Narrows an untrusted string — an env var, a config file — to a known slug. */
+export function isStorageProvider(value) {
+    return getProvider(value) !== undefined;
+}
+/** Every provider that can be named, sorted by slug. */
+export function listStorageProviders() {
+    return PROVIDER_NAMES.flatMap((slug) => getProvider(slug) ?? []);
+}
+/** One provider's display name, description, native SDKs, and env contract. */
+export function getStorageProvider(slug) {
+    return getProvider(slug);
+}
+/**
+ * Every environment variable a provider reads, flattened across required, all
+ * credential modes, and optional. Useful for validating a deployment's config
+ * before the first upload rather than at it.
+ */
+export function listStorageProviderEnvVars(slug) {
+    return listEnvVars(slug);
+}
+/** The subset of {@link listStorageProviderEnvVars} that carries secrets. */
+export function listStorageProviderSecretEnvVars(slug) {
+    return getSecretEnvVars(slug);
+}
+//# sourceMappingURL=index.js.map

package/dist/files-sdk/provider/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/files-sdk/provider/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAyB,MAAM,kBAAkB,CAAC;AACpE,OAAO,EACL,cAAc,EACd,WAAW,EACX,gBAAgB,EAChB,WAAW,GAIZ,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AACxE,OAAO,EACL,oBAAoB,EACpB,gBAAgB,GAGjB,MAAM,wBAAwB,CAAC;AAyBhC;;;;;;;;;;;;;;;GAeG;AACH,MAAM,CAAC,KAAK,UAAU,2BAA2B,CAC/C,OAAqC;IAErC,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,GAAG,YAAY,EAAE,GAAG,OAAO,CAAC;IACtD,IAAI,CAAC,iBAAiB,CAAC,QAAQ,CAAC,EAAE,CAAC;QACjC,MAAM,eAAe,CAAC,QAAQ,CAAC,CAAC;IAClC,CAAC;IAED,6EAA6E;IAC7E,6EAA6E;IAC7E,8EAA8E;IAC9E,MAAM,OAAO,GAAG,MAAM,cAAc,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;IACvD,OAAO,oBAAoB,CAAC,EAAE,GAAG,YAAY,EAAE,OAAO,EAAE,CAAC,CAAC;AAC5D,CAAC;AAED,KAAK,UAAU,cAAc,CAC3B,QAA6B,EAC7B,MAAyC;IAEzC,IAAI,QAAQ,CAAC;IACb,IAAI,CAAC;QACH,QAAQ,GAAG,MAAM,SAAS,CAAC,EAAE,GAAG,MAAM,EAAE,QAAQ,EAAE,CAAC,CAAC;IACtD,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,gBAAgB,CAAC,KAAK,CAAC,CAAC;IAChC,CAAC;IACD,MAAM,EAAE,OAAO,EAAE,GAAG,QAAQ,CAAC,KAAK,CAAC;IACnC,IAAI,QAAQ,KAAK,IAAI,EAAE,CAAC;QACtB,OAAO,OAAO,CAAC;IACjB,CAAC;IACD,yEAAyE;IACzE,4EAA4E;IAC5E,MAAM,EAAE,kBAAkB,EAAE,GAAG,MAAM,MAAM,CAAC,gBAAgB,CAAC,CAAC;IAC9D,OAAO,kBAAkB,CACvB,OAAmD,EACnD;QACE,GAAG,CAAC,MAAM,EAAE,aAAa,KAAK,SAAS,IAAI;YACzC,aAAa,EAAE,MAAM,CAAC,aAAa;SACpC,CAAC;KACH,CACF,CAAC;AACJ,CAAC;AAED,SAAS,eAAe,CAAC,QAAgB;IACvC,OAAO,IAAI,YAAY,CACrB,6BAA6B,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,sBAAsB,cAAc,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EACvG,EAAE,IAAI,EAAE,gBAAgB,CAAC,gBAAgB,EAAE,SAAS,EAAE,IAAI,EAAE,CAC7D,CAAC;AACJ,CAAC;AAED,iFAAiF;AACjF,MAAM,UAAU,iBAAiB,CAAC,KAAa;IAC7C,OAAO,WAAW,CAAC,KAAK,CAAC,KAAK,SAAS,CAAC;AAC1C,CAAC;AAED,wDAAwD;AACxD,MAAM,UAAU,oBAAoB;IAClC,OAAO,cAAc,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,WAAW,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;AACnE,CAAC;AAED,+EAA+E;AAC/E,MAAM,UAAU,kBAAkB,CAAC,IAAY;IAC7C,OAAO,WAAW,CAAC,IAAI,CAAC,CAAC;AAC3B,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,0BAA0B,CAAC,IAAY;IACrD,OAAO,WAAW,CAAC,IAAI,CAAC,CAAC;AAC3B,CAAC;AAED,6EAA6E;AAC7E,MAAM,UAAU,gCAAgC,CAAC,IAAY;IAC3D,OAAO,gBAAgB,CAAC,IAAI,CAAC,CAAC;AAChC,CAAC","sourcesContent":["import type { Adapter } from 'files-sdk';\nimport { loadFiles, type LoadFilesOptions } from 'files-sdk/loader';\nimport {\n  PROVIDER_NAMES,\n  getProvider,\n  getSecretEnvVars,\n  listEnvVars,\n  type EnvVar,\n  type Provider,\n  type ProviderSlug,\n} from 'files-sdk/providers';\n\nimport { StorageError, StorageErrorCode } from '../../storage.error.js';\nimport {\n  createFilesSdkDriver,\n  mapFilesSdkError,\n  type FilesSdkDriverOptions,\n  type FilesSdkStorageDriver,\n} from '../files-sdk.driver.js';\n\n/** Slug of a storage provider this package can build a driver for. */\nexport type StorageProviderName = ProviderSlug;\n\n/**\n * Flat, provider-specific settings — `bucket` and `region` for an object store,\n * `root` for the filesystem, `accountName` and `container` for Azure, and so\n * on. Every provider reads what it needs and ignores the rest, so one config\n * shape serves a deployment that switches providers by name.\n *\n * Credentials may be omitted for any provider whose SDK resolves its own chain\n * (an IAM role, Application Default Credentials, a shared profile).\n */\nexport type StorageProviderConfig = Omit<LoadFilesOptions, 'provider'>;\n\nexport interface ProviderStorageDriverOptions extends Omit<\n  FilesSdkDriverOptions<Adapter>,\n  'adapter'\n> {\n  /** Which provider to build. Validate untrusted input with {@link isStorageProvider}. */\n  provider: StorageProviderName;\n  config?: StorageProviderConfig;\n}\n\n/**\n * Builds a {@link FilesSdkStorageDriver} for a provider named at runtime,\n * importing that provider's adapter — and only that one — on demand. A\n * deployment selects its store with a string (`'s3'`, `'gcs'`, `'azure'`,\n * `'r2'`, `'fs'`, …) and installs one native SDK, instead of the application\n * hard-coding a driver per backend.\n *\n * The `s3` slug additionally gets the conditional-promotion and signed-policy\n * capabilities {@link createS3StorageDriver} attaches; every other provider\n * exposes exactly what its adapter declares. Import\n * `@nestm/storage/files-sdk/s3` directly when the provider is known at build\n * time and the extra indirection buys nothing.\n *\n * @throws StorageError `INVALID_ARGUMENT` for an unknown slug, and whatever the\n * adapter reports (mapped) when required config or credentials are missing.\n */\nexport async function createProviderStorageDriver(\n  options: ProviderStorageDriverOptions,\n): Promise<FilesSdkStorageDriver> {\n  const { provider, config, ...filesOptions } = options;\n  if (!isStorageProvider(provider)) {\n    throw unknownProvider(provider);\n  }\n\n  // `loadFiles` owns the slug → adapter mapping and keeps the import lazy; the\n  // client it returns is discarded so the caller's own driver options (prefix,\n  // hooks, plugins, readonly, retries) apply to the instance the bridge builds.\n  const adapter = await resolveAdapter(provider, config);\n  return createFilesSdkDriver({ ...filesOptions, adapter });\n}\n\nasync function resolveAdapter(\n  provider: StorageProviderName,\n  config: StorageProviderConfig | undefined,\n): Promise<Adapter> {\n  let resolved;\n  try {\n    resolved = await loadFiles({ ...config, provider });\n  } catch (error) {\n    throw mapFilesSdkError(error);\n  }\n  const { adapter } = resolved.files;\n  if (provider !== 's3') {\n    return adapter;\n  }\n  // Built by `s3(...)`, so its `raw` is an S3Client and the promotion path\n  // holds. The S3-compatible wrappers keep only what they declare themselves.\n  const { withS3Capabilities } = await import('../s3/index.js');\n  return withS3Capabilities(\n    adapter as Parameters<typeof withS3Capabilities>[0],\n    {\n      ...(config?.publicBaseUrl !== undefined && {\n        publicBaseUrl: config.publicBaseUrl,\n      }),\n    },\n  );\n}\n\nfunction unknownProvider(provider: string): StorageError {\n  return new StorageError(\n    `Unknown storage provider: ${JSON.stringify(provider)}. Known providers: ${PROVIDER_NAMES.join(', ')}.`,\n    { code: StorageErrorCode.INVALID_ARGUMENT, permanent: true },\n  );\n}\n\n/** Narrows an untrusted string — an env var, a config file — to a known slug. */\nexport function isStorageProvider(value: string): value is StorageProviderName {\n  return getProvider(value) !== undefined;\n}\n\n/** Every provider that can be named, sorted by slug. */\nexport function listStorageProviders(): readonly Provider[] {\n  return PROVIDER_NAMES.flatMap((slug) => getProvider(slug) ?? []);\n}\n\n/** One provider's display name, description, native SDKs, and env contract. */\nexport function getStorageProvider(slug: string): Provider | undefined {\n  return getProvider(slug);\n}\n\n/**\n * Every environment variable a provider reads, flattened across required, all\n * credential modes, and optional. Useful for validating a deployment's config\n * before the first upload rather than at it.\n */\nexport function listStorageProviderEnvVars(slug: string): EnvVar[] {\n  return listEnvVars(slug);\n}\n\n/** The subset of {@link listStorageProviderEnvVars} that carries secrets. */\nexport function listStorageProviderSecretEnvVars(slug: string): EnvVar[] {\n  return getSecretEnvVars(slug);\n}\n\nexport type {\n  EnvVar as StorageProviderEnvVar,\n  Provider as StorageProviderInfo,\n} from 'files-sdk/providers';\n"]}

package/dist/files-sdk/s3/index.d.ts

@@ -3,12 +3,23 @@ import { type FilesSdkConditionalCopyAdapter, type FilesSdkDriverOptions, type F
 export interface S3StorageDriverOptions extends Omit<FilesSdkDriverOptions<S3Adapter>, 'adapter'> {
     adapter: S3AdapterOptions;
 }
-type EnhancedS3Adapter = S3Adapter & FilesSdkConditionalCopyAdapter & FilesSdkSignedDownloadPolicyAdapter & FilesSdkSignedUploadPolicyAdapter;
+export type S3StorageAdapter = S3Adapter & FilesSdkConditionalCopyAdapter & FilesSdkSignedDownloadPolicyAdapter & FilesSdkSignedUploadPolicyAdapter;
+/**
+ * Adds the S3-only capabilities to an adapter already built by `s3(...)`: an
+ * ETag/version-conditional server-side promotion, and the signed upload and
+ * download policies the bridge advertises through `capabilities`.
+ *
+ * Exported so the provider factory can apply them to the adapter `loadFiles`
+ * resolved for the `s3` slug instead of re-deriving {@link S3AdapterOptions}
+ * from flat provider config. It expects an adapter whose `raw` is an `S3Client`
+ * — pass one built by `s3(...)`, not an S3-compatible wrapper.
+ */
+export declare function withS3Capabilities(base: S3Adapter, options?: Pick<S3AdapterOptions, 'publicBaseUrl'>): S3StorageAdapter;
 /**
  * Creates the files-sdk S3 driver from the storage package's own dependency
  * context and adds an ETag/version-conditional server-side promotion.
  */
-export declare function createS3StorageDriver(options: S3StorageDriverOptions): FilesSdkStorageDriver<EnhancedS3Adapter>;
+export declare function createS3StorageDriver(options: S3StorageDriverOptions): FilesSdkStorageDriver<S3StorageAdapter>;
 export { mapS3Error, s3 } from 'files-sdk/s3';
 export type { S3Adapter, S3AdapterOptions, S3Sdk } from 'files-sdk/s3';
 //# sourceMappingURL=index.d.ts.map

package/dist/files-sdk/s3/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/files-sdk/s3/index.ts"],"names":[],"mappings":"AACA,OAAO,EAGL,KAAK,SAAS,EACd,KAAK,gBAAgB,EACtB,MAAM,cAAc,CAAC;AAGtB,OAAO,EAEL,KAAK,8BAA8B,EACnC,KAAK,qBAAqB,EAC1B,KAAK,iCAAiC,EACtC,KAAK,mCAAmC,EACxC,KAAK,qBAAqB,EAE3B,MAAM,wBAAwB,CAAC;AAEhC,MAAM,WAAW,sBAAuB,SAAQ,IAAI,CAClD,qBAAqB,CAAC,SAAS,CAAC,EAChC,SAAS,CACV;IACC,OAAO,EAAE,gBAAgB,CAAC;CAC3B;AAED,KAAK,iBAAiB,GAAG,SAAS,GAChC,8BAA8B,GAC9B,mCAAmC,GACnC,iCAAiC,CAAC;AA6DpC;;;GAGG;AACH,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,sBAAsB,GAC9B,qBAAqB,CAAC,iBAAiB,CAAC,CAyE1C;AAED,OAAO,EAAE,UAAU,EAAE,EAAE,EAAE,MAAM,cAAc,CAAC;AAC9C,YAAY,EAAE,SAAS,EAAE,gBAAgB,EAAE,KAAK,EAAE,MAAM,cAAc,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/files-sdk/s3/index.ts"],"names":[],"mappings":"AACA,OAAO,EAGL,KAAK,SAAS,EACd,KAAK,gBAAgB,EACtB,MAAM,cAAc,CAAC;AAGtB,OAAO,EAEL,KAAK,8BAA8B,EACnC,KAAK,qBAAqB,EAC1B,KAAK,iCAAiC,EACtC,KAAK,mCAAmC,EACxC,KAAK,qBAAqB,EAE3B,MAAM,wBAAwB,CAAC;AAEhC,MAAM,WAAW,sBAAuB,SAAQ,IAAI,CAClD,qBAAqB,CAAC,SAAS,CAAC,EAChC,SAAS,CACV;IACC,OAAO,EAAE,gBAAgB,CAAC;CAC3B;AAED,MAAM,MAAM,gBAAgB,GAAG,SAAS,GACtC,8BAA8B,GAC9B,mCAAmC,GACnC,iCAAiC,CAAC;AA6DpC;;;;;;;;;GASG;AACH,wBAAgB,kBAAkB,CAChC,IAAI,EAAE,SAAS,EACf,OAAO,GAAE,IAAI,CAAC,gBAAgB,EAAE,eAAe,CAAM,GACpD,gBAAgB,CAkElB;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,sBAAsB,GAC9B,qBAAqB,CAAC,gBAAgB,CAAC,CAMzC;AAED,OAAO,EAAE,UAAU,EAAE,EAAE,EAAE,MAAM,cAAc,CAAC;AAC9C,YAAY,EAAE,SAAS,EAAE,gBAAgB,EAAE,KAAK,EAAE,MAAM,cAAc,CAAC"}

package/dist/files-sdk/s3/index.js

@@ -43,13 +43,17 @@ async function waitForRetry(milliseconds, signal) {
     });
 }
 /**
- * Creates the files-sdk S3 driver from the storage package's own dependency
- * context and adds an ETag/version-conditional server-side promotion.
+ * Adds the S3-only capabilities to an adapter already built by `s3(...)`: an
+ * ETag/version-conditional server-side promotion, and the signed upload and
+ * download policies the bridge advertises through `capabilities`.
+ *
+ * Exported so the provider factory can apply them to the adapter `loadFiles`
+ * resolved for the `s3` slug instead of re-deriving {@link S3AdapterOptions}
+ * from flat provider config. It expects an adapter whose `raw` is an `S3Client`
+ * — pass one built by `s3(...)`, not an S3-compatible wrapper.
  */
-export function createS3StorageDriver(options) {
-    const { adapter: adapterOptions, ...filesOptions } = options;
-    const base = s3(adapterOptions);
-    const adapter = Object.assign(base, {
+export function withS3Capabilities(base, options = {}) {
+    return Object.assign(base, {
         conditionalCopy: Object.freeze({
             etag: true,
             supported: true,
@@ -60,7 +64,7 @@ export function createS3StorageDriver(options) {
             sizeRange: true,
         }),
         signedDownloadPolicy: Object.freeze({
-            expiresIn: adapterOptions.publicBaseUrl === undefined,
+            expiresIn: options.publicBaseUrl === undefined,
         }),
         async promote(sourceKey, destinationKey, promotion) {
             const retries = maxRetries(promotion);
@@ -99,9 +103,16 @@ export function createS3StorageDriver(options) {
             }
         },
     });
+}
+/**
+ * Creates the files-sdk S3 driver from the storage package's own dependency
+ * context and adds an ETag/version-conditional server-side promotion.
+ */
+export function createS3StorageDriver(options) {
+    const { adapter: adapterOptions, ...filesOptions } = options;
     return createFilesSdkDriver({
         ...filesOptions,
-        adapter,
+        adapter: withS3Capabilities(s3(adapterOptions), adapterOptions),
     });
 }
 export { mapS3Error, s3 } from 'files-sdk/s3';

package/dist/files-sdk/s3/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/files-sdk/s3/index.ts"],"names":[],"mappings":"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","sourcesContent":["import { CopyObjectCommand } from '@aws-sdk/client-s3';\nimport {\n  mapS3Error,\n  s3,\n  type S3Adapter,\n  type S3AdapterOptions,\n} from 'files-sdk/s3';\n\nimport type { StoragePromotionOptions } from '../../storage.types.js';\nimport {\n  createFilesSdkDriver,\n  type FilesSdkConditionalCopyAdapter,\n  type FilesSdkDriverOptions,\n  type FilesSdkSignedUploadPolicyAdapter,\n  type FilesSdkSignedDownloadPolicyAdapter,\n  type FilesSdkStorageDriver,\n  mapFilesSdkError,\n} from '../files-sdk.driver.js';\n\nexport interface S3StorageDriverOptions extends Omit<\n  FilesSdkDriverOptions<S3Adapter>,\n  'adapter'\n> {\n  adapter: S3AdapterOptions;\n}\n\ntype EnhancedS3Adapter = S3Adapter &\n  FilesSdkConditionalCopyAdapter &\n  FilesSdkSignedDownloadPolicyAdapter &\n  FilesSdkSignedUploadPolicyAdapter;\n\nfunction copySource(\n  bucket: string,\n  key: string,\n  version: string | undefined,\n): string {\n  const source = `${encodeURIComponent(bucket)}/${encodeURIComponent(key)}`;\n  return version === undefined\n    ? source\n    : `${source}?versionId=${encodeURIComponent(version)}`;\n}\n\nfunction operationSignal(\n  options: StoragePromotionOptions,\n): AbortSignal | undefined {\n  const timeoutSignal =\n    options.timeout === undefined || options.timeout <= 0\n      ? undefined\n      : AbortSignal.timeout(options.timeout);\n  if (options.signal === undefined) {\n    return timeoutSignal;\n  }\n  return timeoutSignal === undefined\n    ? options.signal\n    : AbortSignal.any([options.signal, timeoutSignal]);\n}\n\nfunction maxRetries(options: StoragePromotionOptions): number {\n  const configured =\n    typeof options.retries === 'number'\n      ? options.retries\n      : options.retries?.max;\n  return Math.max(0, Math.floor(configured ?? 0));\n}\n\nasync function waitForRetry(\n  milliseconds: number,\n  signal: AbortSignal | undefined,\n): Promise<void> {\n  if (signal?.aborted === true) {\n    throw signal.reason;\n  }\n  await new Promise<void>((resolve, reject) => {\n    const cleanup = (): void => signal?.removeEventListener('abort', abort);\n    const timer = setTimeout(\n      () => {\n        cleanup();\n        resolve();\n      },\n      Math.max(0, milliseconds),\n    );\n    const abort = (): void => {\n      clearTimeout(timer);\n      cleanup();\n      reject(signal?.reason);\n    };\n    signal?.addEventListener('abort', abort, { once: true });\n  });\n}\n\n/**\n * Creates the files-sdk S3 driver from the storage package's own dependency\n * context and adds an ETag/version-conditional server-side promotion.\n */\nexport function createS3StorageDriver(\n  options: S3StorageDriverOptions,\n): FilesSdkStorageDriver<EnhancedS3Adapter> {\n  const { adapter: adapterOptions, ...filesOptions } = options;\n  const base = s3(adapterOptions);\n  const adapter: EnhancedS3Adapter = Object.assign(base, {\n    conditionalCopy: Object.freeze({\n      etag: true,\n      supported: true,\n      version: true,\n    }),\n    signedUploadPolicy: Object.freeze({\n      contentType: true,\n      sizeRange: true,\n    }),\n    signedDownloadPolicy: Object.freeze({\n      expiresIn: adapterOptions.publicBaseUrl === undefined,\n    }),\n    async promote(\n      sourceKey: string,\n      destinationKey: string,\n      promotion: StoragePromotionOptions,\n    ): Promise<void> {\n      const retries = maxRetries(promotion);\n      for (let attempt = 0; ; attempt += 1) {\n        const signal = operationSignal(promotion);\n        try {\n          await base.raw.send(\n            new CopyObjectCommand({\n              Bucket: base.bucket,\n              CopySource: copySource(\n                base.bucket,\n                sourceKey,\n                promotion.sourceVersion,\n              ),\n              ...(promotion.sourceEtag !== undefined && {\n                CopySourceIfMatch: promotion.sourceEtag,\n              }),\n              Key: destinationKey,\n            }),\n            signal === undefined ? undefined : { abortSignal: signal },\n          );\n          return;\n        } catch (error) {\n          const mapped = mapS3Error(error);\n          if (\n            attempt >= retries ||\n            mapped.code !== 'Provider' ||\n            mapped.aborted ||\n            mapped.permanent ||\n            signal?.aborted === true\n          ) {\n            throw mapped;\n          }\n          const storageError = mapFilesSdkError(mapped);\n          const delay =\n            typeof promotion.retries === 'object' &&\n            promotion.retries.backoff !== undefined\n              ? promotion.retries.backoff({\n                  attempt: attempt + 1,\n                  error: storageError,\n                })\n              : Math.min(1000, 100 * 2 ** attempt);\n          await waitForRetry(delay, promotion.signal);\n        }\n      }\n    },\n  } satisfies FilesSdkConditionalCopyAdapter &\n    FilesSdkSignedDownloadPolicyAdapter &\n    FilesSdkSignedUploadPolicyAdapter);\n\n  return createFilesSdkDriver({\n    ...filesOptions,\n    adapter,\n  });\n}\n\nexport { mapS3Error, s3 } from 'files-sdk/s3';\nexport type { S3Adapter, S3AdapterOptions, S3Sdk } from 'files-sdk/s3';\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/files-sdk/s3/index.ts"],"names":[],"mappings":"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","sourcesContent":["import { CopyObjectCommand } from '@aws-sdk/client-s3';\nimport {\n  mapS3Error,\n  s3,\n  type S3Adapter,\n  type S3AdapterOptions,\n} from 'files-sdk/s3';\n\nimport type { StoragePromotionOptions } from '../../storage.types.js';\nimport {\n  createFilesSdkDriver,\n  type FilesSdkConditionalCopyAdapter,\n  type FilesSdkDriverOptions,\n  type FilesSdkSignedUploadPolicyAdapter,\n  type FilesSdkSignedDownloadPolicyAdapter,\n  type FilesSdkStorageDriver,\n  mapFilesSdkError,\n} from '../files-sdk.driver.js';\n\nexport interface S3StorageDriverOptions extends Omit<\n  FilesSdkDriverOptions<S3Adapter>,\n  'adapter'\n> {\n  adapter: S3AdapterOptions;\n}\n\nexport type S3StorageAdapter = S3Adapter &\n  FilesSdkConditionalCopyAdapter &\n  FilesSdkSignedDownloadPolicyAdapter &\n  FilesSdkSignedUploadPolicyAdapter;\n\nfunction copySource(\n  bucket: string,\n  key: string,\n  version: string | undefined,\n): string {\n  const source = `${encodeURIComponent(bucket)}/${encodeURIComponent(key)}`;\n  return version === undefined\n    ? source\n    : `${source}?versionId=${encodeURIComponent(version)}`;\n}\n\nfunction operationSignal(\n  options: StoragePromotionOptions,\n): AbortSignal | undefined {\n  const timeoutSignal =\n    options.timeout === undefined || options.timeout <= 0\n      ? undefined\n      : AbortSignal.timeout(options.timeout);\n  if (options.signal === undefined) {\n    return timeoutSignal;\n  }\n  return timeoutSignal === undefined\n    ? options.signal\n    : AbortSignal.any([options.signal, timeoutSignal]);\n}\n\nfunction maxRetries(options: StoragePromotionOptions): number {\n  const configured =\n    typeof options.retries === 'number'\n      ? options.retries\n      : options.retries?.max;\n  return Math.max(0, Math.floor(configured ?? 0));\n}\n\nasync function waitForRetry(\n  milliseconds: number,\n  signal: AbortSignal | undefined,\n): Promise<void> {\n  if (signal?.aborted === true) {\n    throw signal.reason;\n  }\n  await new Promise<void>((resolve, reject) => {\n    const cleanup = (): void => signal?.removeEventListener('abort', abort);\n    const timer = setTimeout(\n      () => {\n        cleanup();\n        resolve();\n      },\n      Math.max(0, milliseconds),\n    );\n    const abort = (): void => {\n      clearTimeout(timer);\n      cleanup();\n      reject(signal?.reason);\n    };\n    signal?.addEventListener('abort', abort, { once: true });\n  });\n}\n\n/**\n * Adds the S3-only capabilities to an adapter already built by `s3(...)`: an\n * ETag/version-conditional server-side promotion, and the signed upload and\n * download policies the bridge advertises through `capabilities`.\n *\n * Exported so the provider factory can apply them to the adapter `loadFiles`\n * resolved for the `s3` slug instead of re-deriving {@link S3AdapterOptions}\n * from flat provider config. It expects an adapter whose `raw` is an `S3Client`\n * — pass one built by `s3(...)`, not an S3-compatible wrapper.\n */\nexport function withS3Capabilities(\n  base: S3Adapter,\n  options: Pick<S3AdapterOptions, 'publicBaseUrl'> = {},\n): S3StorageAdapter {\n  return Object.assign(base, {\n    conditionalCopy: Object.freeze({\n      etag: true,\n      supported: true,\n      version: true,\n    }),\n    signedUploadPolicy: Object.freeze({\n      contentType: true,\n      sizeRange: true,\n    }),\n    signedDownloadPolicy: Object.freeze({\n      expiresIn: options.publicBaseUrl === undefined,\n    }),\n    async promote(\n      sourceKey: string,\n      destinationKey: string,\n      promotion: StoragePromotionOptions,\n    ): Promise<void> {\n      const retries = maxRetries(promotion);\n      for (let attempt = 0; ; attempt += 1) {\n        const signal = operationSignal(promotion);\n        try {\n          await base.raw.send(\n            new CopyObjectCommand({\n              Bucket: base.bucket,\n              CopySource: copySource(\n                base.bucket,\n                sourceKey,\n                promotion.sourceVersion,\n              ),\n              ...(promotion.sourceEtag !== undefined && {\n                CopySourceIfMatch: promotion.sourceEtag,\n              }),\n              Key: destinationKey,\n            }),\n            signal === undefined ? undefined : { abortSignal: signal },\n          );\n          return;\n        } catch (error) {\n          const mapped = mapS3Error(error);\n          if (\n            attempt >= retries ||\n            mapped.code !== 'Provider' ||\n            mapped.aborted ||\n            mapped.permanent ||\n            signal?.aborted === true\n          ) {\n            throw mapped;\n          }\n          const storageError = mapFilesSdkError(mapped);\n          const delay =\n            typeof promotion.retries === 'object' &&\n            promotion.retries.backoff !== undefined\n              ? promotion.retries.backoff({\n                  attempt: attempt + 1,\n                  error: storageError,\n                })\n              : Math.min(1000, 100 * 2 ** attempt);\n          await waitForRetry(delay, promotion.signal);\n        }\n      }\n    },\n  } satisfies FilesSdkConditionalCopyAdapter &\n    FilesSdkSignedDownloadPolicyAdapter &\n    FilesSdkSignedUploadPolicyAdapter);\n}\n\n/**\n * Creates the files-sdk S3 driver from the storage package's own dependency\n * context and adds an ETag/version-conditional server-side promotion.\n */\nexport function createS3StorageDriver(\n  options: S3StorageDriverOptions,\n): FilesSdkStorageDriver<S3StorageAdapter> {\n  const { adapter: adapterOptions, ...filesOptions } = options;\n  return createFilesSdkDriver({\n    ...filesOptions,\n    adapter: withS3Capabilities(s3(adapterOptions), adapterOptions),\n  });\n}\n\nexport { mapS3Error, s3 } from 'files-sdk/s3';\nexport type { S3Adapter, S3AdapterOptions, S3Sdk } from 'files-sdk/s3';\n"]}

package/dist/gateway/storage-gateway-fastify-parser.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"storage-gateway-fastify-parser.d.ts","sourceRoot":"","sources":["../../src/gateway/storage-gateway-fastify-parser.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,KAAK,YAAY,EAClB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAqB/C,eAAO,MAAM,6BAA6B,8BAA8B,CAAC;AAqBzE,qBACa,2BAA4B,YAAW,YAAY;IAClD,OAAO,CAAC,QAAQ,CAAC,WAAW;gBAAX,WAAW,EAAE,eAAe;IAEzD,YAAY,IAAI,IAAI;CAyBrB"}
+{"version":3,"file":"storage-gateway-fastify-parser.d.ts","sourceRoot":"","sources":["../../src/gateway/storage-gateway-fastify-parser.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,KAAK,YAAY,EAClB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAqB/C,eAAO,MAAM,6BAA6B,8BAA8B,CAAC;AAqBzE,qBACa,2BAA4B,YAAW,YAAY;IAClD,OAAO,CAAC,QAAQ,CAAC,WAAW;IAAxC,YAA6B,WAAW,EAAE,eAAe,EAAI;IAE7D,YAAY,IAAI,IAAI,CAwBnB;CACF"}

package/dist/gateway/storage-gateway-fastify-parser.js.map

@@ -1 +1 @@
-{"version":3,"file":"storage-gateway-fastify-parser.js","sourceRoot":"","sources":["../../src/gateway/storage-gateway-fastify-parser.ts"],"names":[],"mappings":";;;;;;;;;AAAA,OAAO,EACL,UAAU,EACV,6BAA6B,GAE9B,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAqB/C,MAAM,CAAC,MAAM,6BAA6B,GAAG,2BAA2B,CAAC;AAEzE,SAAS,oBAAoB;IAC3B,OAAO,IAAI,6BAA6B,CACtC,kDAAkD,CACnD,CAAC;AACJ,CAAC;AAED,SAAS,uBAAuB,CAC9B,KAAc;IAEd,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;QAChD,OAAO,KAAK,CAAC;IACf,CAAC;IACD,MAAM,SAAS,GAAG,KAAuC,CAAC;IAC1D,OAAO,CACL,OAAO,SAAS,CAAC,oBAAoB,KAAK,UAAU;QACpD,OAAO,SAAS,CAAC,oBAAoB,KAAK,UAAU,CACrD,CAAC;AACJ,CAAC;AAGM,IAAM,2BAA2B,GAAjC,MAAM,2BAA2B;IACT;IAA7B,YAA6B,WAA4B;QAA5B,gBAAW,GAAX,WAAW,CAAiB;IAAG,CAAC;IAE7D,YAAY;QACV,MAAM,QAAQ,GAAG,IAAI,CAAC,WAAW,CAAC,WAAW,CAAC,WAAW,EAAE,CAAC;QAC5D,IACE,CAAC,uBAAuB,CAAC,QAAQ,CAAC;YAClC,QAAQ,CAAC,oBAAoB,CAAC,0BAA0B,CAAC,EACzD,CAAC;YACD,OAAO;QACT,CAAC;QAED,QAAQ,CAAC,oBAAoB,CAC3B,0BAA0B,EAC1B,CAAC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,EAAE;YACzB,MAAM,aAAa,GAAG,OAA+B,CAAC;YACtD,IACE,aAAa,CAAC,YAAY,EAAE,MAAM,EAAE,CAClC,6BAA6B,CAC9B,KAAK,IAAI,EACV,CAAC;gBACD,IAAI,CAAC,oBAAoB,EAAE,CAAC,CAAC;gBAC7B,OAAO;YACT,CAAC;YACD,IAAI,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;QACtB,CAAC,CACF,CAAC;IACJ,CAAC;CACF,CAAA;AA5BY,2BAA2B;IADvC,UAAU,EAAE;qCAE+B,eAAe;GAD9C,2BAA2B,CA4BvC","sourcesContent":["import {\n  Injectable,\n  UnsupportedMediaTypeException,\n  type OnModuleInit,\n} from '@nestjs/common';\nimport { HttpAdapterHost } from '@nestjs/core';\nimport type { Readable } from 'node:stream';\n\ninterface FastifyParserInstance {\n  hasContentTypeParser(contentType: string): boolean;\n  addContentTypeParser(\n    contentType: string,\n    parser: (\n      request: unknown,\n      payload: Readable,\n      done: (error: Error | null, body?: unknown) => void,\n    ) => void,\n  ): void;\n}\n\ninterface FastifyParserRequest {\n  routeOptions?: {\n    config?: Record<string, unknown>;\n  };\n}\n\nexport const FASTIFY_STORAGE_UPLOAD_CONFIG = 'nestmStorageGatewayUpload';\n\nfunction unsupportedMediaType(): Error {\n  return new UnsupportedMediaTypeException(\n    'Unsupported Media Type: application/octet-stream',\n  );\n}\n\nfunction isFastifyParserInstance(\n  value: unknown,\n): value is FastifyParserInstance {\n  if (typeof value !== 'object' || value === null) {\n    return false;\n  }\n  const candidate = value as Partial<FastifyParserInstance>;\n  return (\n    typeof candidate.addContentTypeParser === 'function' &&\n    typeof candidate.hasContentTypeParser === 'function'\n  );\n}\n\n@Injectable()\nexport class StorageGatewayFastifyParser implements OnModuleInit {\n  constructor(private readonly adapterHost: HttpAdapterHost) {}\n\n  onModuleInit(): void {\n    const instance = this.adapterHost.httpAdapter.getInstance();\n    if (\n      !isFastifyParserInstance(instance) ||\n      instance.hasContentTypeParser('application/octet-stream')\n    ) {\n      return;\n    }\n\n    instance.addContentTypeParser(\n      'application/octet-stream',\n      (request, payload, done) => {\n        const parserRequest = request as FastifyParserRequest;\n        if (\n          parserRequest.routeOptions?.config?.[\n            FASTIFY_STORAGE_UPLOAD_CONFIG\n          ] !== true\n        ) {\n          done(unsupportedMediaType());\n          return;\n        }\n        done(null, payload);\n      },\n    );\n  }\n}\n"]}
+{"version":3,"file":"storage-gateway-fastify-parser.js","sourceRoot":"","sources":["../../src/gateway/storage-gateway-fastify-parser.ts"],"names":[],"mappings":";;;;;;;;;AAAA,OAAO,EACL,UAAU,EACV,6BAA6B,GAE9B,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAqB/C,MAAM,CAAC,MAAM,6BAA6B,GAAG,2BAA2B,CAAC;AAEzE,SAAS,oBAAoB;IAC3B,OAAO,IAAI,6BAA6B,CACtC,kDAAkD,CACnD,CAAC;AACJ,CAAC;AAED,SAAS,uBAAuB,CAC9B,KAAc;IAEd,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;QAChD,OAAO,KAAK,CAAC;IACf,CAAC;IACD,MAAM,SAAS,GAAG,KAAuC,CAAC;IAC1D,OAAO,CACL,OAAO,SAAS,CAAC,oBAAoB,KAAK,UAAU;QACpD,OAAO,SAAS,CAAC,oBAAoB,KAAK,UAAU,CACrD,CAAC;AACJ,CAAC;AAGM,IAAM,2BAA2B,GAAjC,MAAM,2BAA2B;IACT,WAAW;IAAxC,YAA6B,WAA4B;2BAA5B,WAAW;IAAoB,CAAC;IAE7D,YAAY;QACV,MAAM,QAAQ,GAAG,IAAI,CAAC,WAAW,CAAC,WAAW,CAAC,WAAW,EAAE,CAAC;QAC5D,IACE,CAAC,uBAAuB,CAAC,QAAQ,CAAC;YAClC,QAAQ,CAAC,oBAAoB,CAAC,0BAA0B,CAAC,EACzD,CAAC;YACD,OAAO;QACT,CAAC;QAED,QAAQ,CAAC,oBAAoB,CAC3B,0BAA0B,EAC1B,CAAC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,EAAE;YACzB,MAAM,aAAa,GAAG,OAA+B,CAAC;YACtD,IACE,aAAa,CAAC,YAAY,EAAE,MAAM,EAAE,CAClC,6BAA6B,CAC9B,KAAK,IAAI,EACV,CAAC;gBACD,IAAI,CAAC,oBAAoB,EAAE,CAAC,CAAC;gBAC7B,OAAO;YACT,CAAC;YACD,IAAI,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;QACtB,CAAC,CACF,CAAC;IACJ,CAAC;CACF,CAAA;AA5BY,2BAA2B;IADvC,UAAU,EAAE;qCAE+B,eAAe;GAD9C,2BAA2B,CA4BvC","sourcesContent":["import {\n  Injectable,\n  UnsupportedMediaTypeException,\n  type OnModuleInit,\n} from '@nestjs/common';\nimport { HttpAdapterHost } from '@nestjs/core';\nimport type { Readable } from 'node:stream';\n\ninterface FastifyParserInstance {\n  hasContentTypeParser(contentType: string): boolean;\n  addContentTypeParser(\n    contentType: string,\n    parser: (\n      request: unknown,\n      payload: Readable,\n      done: (error: Error | null, body?: unknown) => void,\n    ) => void,\n  ): void;\n}\n\ninterface FastifyParserRequest {\n  routeOptions?: {\n    config?: Record<string, unknown>;\n  };\n}\n\nexport const FASTIFY_STORAGE_UPLOAD_CONFIG = 'nestmStorageGatewayUpload';\n\nfunction unsupportedMediaType(): Error {\n  return new UnsupportedMediaTypeException(\n    'Unsupported Media Type: application/octet-stream',\n  );\n}\n\nfunction isFastifyParserInstance(\n  value: unknown,\n): value is FastifyParserInstance {\n  if (typeof value !== 'object' || value === null) {\n    return false;\n  }\n  const candidate = value as Partial<FastifyParserInstance>;\n  return (\n    typeof candidate.addContentTypeParser === 'function' &&\n    typeof candidate.hasContentTypeParser === 'function'\n  );\n}\n\n@Injectable()\nexport class StorageGatewayFastifyParser implements OnModuleInit {\n  constructor(private readonly adapterHost: HttpAdapterHost) {}\n\n  onModuleInit(): void {\n    const instance = this.adapterHost.httpAdapter.getInstance();\n    if (\n      !isFastifyParserInstance(instance) ||\n      instance.hasContentTypeParser('application/octet-stream')\n    ) {\n      return;\n    }\n\n    instance.addContentTypeParser(\n      'application/octet-stream',\n      (request, payload, done) => {\n        const parserRequest = request as FastifyParserRequest;\n        if (\n          parserRequest.routeOptions?.config?.[\n            FASTIFY_STORAGE_UPLOAD_CONFIG\n          ] !== true\n        ) {\n          done(unsupportedMediaType());\n          return;\n        }\n        done(null, payload);\n      },\n    );\n  }\n}\n"]}

package/dist/gateway/storage-gateway.controller.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"storage-gateway.controller.d.ts","sourceRoot":"","sources":["../../src/gateway/storage-gateway.controller.ts"],"names":[],"mappings":"AA4BA,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAcvD,OAAO,EAGL,KAAK,6BAA6B,EAClC,KAAK,uBAAuB,EAG7B,MAAM,4BAA4B,CAAC;AAEpC,UAAU,gBAAgB,CAAC,MAAM;IAC/B,IAAI,EAAE,MAAM,CAAC;CACd;AAoWD,qBAEa,wBAAwB;;IAEjC,OAAO,CAAC,QAAQ,CAAC,OAAO;IAExB,OAAO,CAAC,QAAQ,CAAC,OAAO;IAExB,OAAO,CAAC,QAAQ,CAAC,SAAS;gBAJT,OAAO,EAAE,cAAc,EAEvB,OAAO,EAAE,6BAA6B,EAEtC,SAAS,EAAE,uBAAuB;IAI/C,QAAQ,CACE,GAAG,EAAE,MAAM,GAAG,SAAS,EACrB,KAAK,EAAE,MAAM,GAAG,SAAS,EACpB,UAAU,EAAE,MAAM,GAAG,SAAS,EAChC,QAAQ,EAAE,MAAM,GAAG,SAAS,EACzB,WAAW,EAAE,MAAM,GAAG,SAAS,EAC9C,OAAO,EAAE,OAAO,EAChB,QAAQ,EAAE,OAAO,GACvB,OAAO,CAAC,IAAI,CAAC;IAuHV,MAAM,CACI,GAAG,EAAE,MAAM,GAAG,SAAS,EAC9B,OAAO,EAAE,OAAO,GACtB,OAAO,CAAC,gBAAgB,CAAC,OAAO,CAAC,CAAC;IA8D/B,IAAI,CACM,GAAG,EAAE,MAAM,GAAG,SAAS,EAC9B,OAAO,EAAE,OAAO,EAChB,QAAQ,EAAE,OAAO,GACvB,OAAO,CAAC,IAAI,CAAC;IAoBV,MAAM,CACI,GAAG,EAAE,MAAM,GAAG,SAAS,EAC9B,OAAO,EAAE,OAAO,GACtB,OAAO,CAAC,gBAAgB,CAAC;QAAE,OAAO,EAAE,IAAI,CAAA;KAAE,CAAC,CAAC;IAezC,IAAI,CACS,MAAM,EAAE,MAAM,GAAG,SAAS,EAC1B,MAAM,EAAE,MAAM,GAAG,SAAS,EAC3B,KAAK,EAAE,MAAM,GAAG,SAAS,EACrB,SAAS,EAAE,MAAM,GAAG,SAAS,EAC1C,OAAO,EAAE,OAAO,GACtB,OAAO,CAAC,gBAAgB,CAAC,OAAO,CAAC,CAAC;IA2B/B,MAAM,CACQ,OAAO,EAAE,MAAM,GAAG,SAAS,EAC5B,MAAM,EAAE,MAAM,GAAG,SAAS,EAC3B,KAAK,EAAE,MAAM,GAAG,SAAS,EACpB,UAAU,EAAE,MAAM,GAAG,SAAS,EACnC,KAAK,EAAE,MAAM,GAAG,SAAS,EACf,eAAe,EAAE,MAAM,GAAG,SAAS,EACtD,OAAO,EAAE,OAAO,GACtB,OAAO,CAAC,gBAAgB,CAAC,OAAO,CAAC,CAAC;IAkE/B,YAAY,CACR,IAAI,EAAE,OAAO,EACd,OAAO,EAAE,OAAO,GACtB,OAAO,CAAC,gBAAgB,CAAC;QAAE,GAAG,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IA8CvC,UAAU,CACN,IAAI,EAAE,OAAO,EACd,OAAO,EAAE,OAAO,GACtB,OAAO,CAAC,gBAAgB,CAAC,OAAO,CAAC,CAAC;IA+E/B,IAAI,CACA,IAAI,EAAE,OAAO,EACd,OAAO,EAAE,OAAO,GACtB,OAAO,CAAC,gBAAgB,CAAC;QAAE,MAAM,EAAE,IAAI,CAAA;KAAE,CAAC,CAAC;IAwBxC,IAAI,CACA,IAAI,EAAE,OAAO,EACd,OAAO,EAAE,OAAO,GACtB,OAAO,CAAC,gBAAgB,CAAC;QAAE,KAAK,EAAE,IAAI,CAAA;KAAE,CAAC,CAAC;CAmF9C"}
+{"version":3,"file":"storage-gateway.controller.d.ts","sourceRoot":"","sources":["../../src/gateway/storage-gateway.controller.ts"],"names":[],"mappings":"AA4BA,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAcvD,OAAO,EAGL,KAAK,6BAA6B,EAClC,KAAK,uBAAuB,EAG7B,MAAM,4BAA4B,CAAC;AAEpC,UAAU,gBAAgB,CAAC,MAAM;IAC/B,IAAI,EAAE,MAAM,CAAC;CACd;AAoWD,qBAEa,wBAAwB;;IAEjC,OAAO,CAAC,QAAQ,CAAC,OAAO;IAExB,OAAO,CAAC,QAAQ,CAAC,OAAO;IAExB,OAAO,CAAC,QAAQ,CAAC,SAAS;IAL5B,YACmB,OAAO,EAAE,cAAc,EAEvB,OAAO,EAAE,6BAA6B,EAEtC,SAAS,EAAE,uBAAuB,EACjD;IAGE,QAAQ,CACE,GAAG,EAAE,MAAM,GAAG,SAAS,EACrB,KAAK,EAAE,MAAM,GAAG,SAAS,EACpB,UAAU,EAAE,MAAM,GAAG,SAAS,EAChC,QAAQ,EAAE,MAAM,GAAG,SAAS,EACzB,WAAW,EAAE,MAAM,GAAG,SAAS,EAC9C,OAAO,EAAE,OAAO,EAChB,QAAQ,EAAE,OAAO,GACvB,OAAO,CAAC,IAAI,CAAC,CAiHf;IAMK,MAAM,CACI,GAAG,EAAE,MAAM,GAAG,SAAS,EAC9B,OAAO,EAAE,OAAO,GACtB,OAAO,CAAC,gBAAgB,CAAC,OAAO,CAAC,CAAC,CA2DpC;IAGK,IAAI,CACM,GAAG,EAAE,MAAM,GAAG,SAAS,EAC9B,OAAO,EAAE,OAAO,EAChB,QAAQ,EAAE,OAAO,GACvB,OAAO,CAAC,IAAI,CAAC,CAiBf;IAGK,MAAM,CACI,GAAG,EAAE,MAAM,GAAG,SAAS,EAC9B,OAAO,EAAE,OAAO,GACtB,OAAO,CAAC,gBAAgB,CAAC;QAAE,OAAO,EAAE,IAAI,CAAA;KAAE,CAAC,CAAC,CAY9C;IAGK,IAAI,CACS,MAAM,EAAE,MAAM,GAAG,SAAS,EAC1B,MAAM,EAAE,MAAM,GAAG,SAAS,EAC3B,KAAK,EAAE,MAAM,GAAG,SAAS,EACrB,SAAS,EAAE,MAAM,GAAG,SAAS,EAC1C,OAAO,EAAE,OAAO,GACtB,OAAO,CAAC,gBAAgB,CAAC,OAAO,CAAC,CAAC,CAwBpC;IAGK,MAAM,CACQ,OAAO,EAAE,MAAM,GAAG,SAAS,EAC5B,MAAM,EAAE,MAAM,GAAG,SAAS,EAC3B,KAAK,EAAE,MAAM,GAAG,SAAS,EACpB,UAAU,EAAE,MAAM,GAAG,SAAS,EACnC,KAAK,EAAE,MAAM,GAAG,SAAS,EACf,eAAe,EAAE,MAAM,GAAG,SAAS,EACtD,OAAO,EAAE,OAAO,GACtB,OAAO,CAAC,gBAAgB,CAAC,OAAO,CAAC,CAAC,CA+DpC;IAGK,YAAY,CACR,IAAI,EAAE,OAAO,EACd,OAAO,EAAE,OAAO,GACtB,OAAO,CAAC,gBAAgB,CAAC;QAAE,GAAG,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC,CA2C5C;IAGK,UAAU,CACN,IAAI,EAAE,OAAO,EACd,OAAO,EAAE,OAAO,GACtB,OAAO,CAAC,gBAAgB,CAAC,OAAO,CAAC,CAAC,CA4EpC;IAGK,IAAI,CACA,IAAI,EAAE,OAAO,EACd,OAAO,EAAE,OAAO,GACtB,OAAO,CAAC,gBAAgB,CAAC;QAAE,MAAM,EAAE,IAAI,CAAA;KAAE,CAAC,CAAC,CAqB7C;IAGK,IAAI,CACA,IAAI,EAAE,OAAO,EACd,OAAO,EAAE,OAAO,GACtB,OAAO,CAAC,gBAAgB,CAAC;QAAE,KAAK,EAAE,IAAI,CAAA;KAAE,CAAC,CAAC,CAqB5C;CA8DF"}