nuxt-files-sdk 0.0.4 → 0.1.0

package/dist/runtime/provider-types.d.ts

@@ -0,0 +1,53 @@
+//#region src/runtime/provider-types.d.ts
+export interface ProviderFactories {
+  akamai: typeof import('files-sdk/akamai').akamai;
+  alibaba: typeof import('files-sdk/alibaba').alibaba;
+  appwrite: typeof import('files-sdk/appwrite').appwrite;
+  archil: typeof import('files-sdk/archil').archil;
+  azure: typeof import('files-sdk/azure').azure;
+  'backblaze-b2': typeof import('files-sdk/backblaze-b2').backblazeB2;
+  box: typeof import('files-sdk/box').box;
+  'bun-s3': typeof import('files-sdk/bun-s3').bunS3;
+  'bunny-storage': typeof import('files-sdk/bunny-storage').bunnyStorage;
+  cloudinary: typeof import('files-sdk/cloudinary').cloudinaryAdapter;
+  convex: typeof import('files-sdk/convex').convex;
+  'digitalocean-spaces': typeof import('files-sdk/digitalocean-spaces').digitaloceanSpaces;
+  dropbox: typeof import('files-sdk/dropbox').dropbox;
+  exoscale: typeof import('files-sdk/exoscale').exoscale;
+  filebase: typeof import('files-sdk/filebase').filebase;
+  'firebase-storage': typeof import('files-sdk/firebase-storage').firebaseStorage;
+  fs: typeof import('files-sdk/fs').fs;
+  ftp: typeof import('files-sdk/ftp').ftp;
+  gcs: typeof import('files-sdk/gcs').gcs;
+  'google-drive': typeof import('files-sdk/google-drive').googleDrive;
+  hetzner: typeof import('files-sdk/hetzner').hetzner;
+  'ibm-cos': typeof import('files-sdk/ibm-cos').ibmCos;
+  'idrive-e2': typeof import('files-sdk/idrive-e2').idriveE2;
+  memory: typeof import('files-sdk/memory').memory;
+  minio: typeof import('files-sdk/minio').minio;
+  neon: typeof import('files-sdk/neon').neon;
+  'netlify-blobs': typeof import('files-sdk/netlify-blobs').netlifyBlobs;
+  onedrive: typeof import('files-sdk/onedrive').onedrive;
+  'oracle-cloud': typeof import('files-sdk/oracle-cloud').oracleCloud;
+  ovhcloud: typeof import('files-sdk/ovhcloud').ovhcloud;
+  pocketbase: typeof import('files-sdk/pocketbase').pocketbase;
+  r2: typeof import('files-sdk/r2').r2;
+  rustfs: typeof import('files-sdk/rustfs').rustfs;
+  s3: typeof import('files-sdk/s3').s3;
+  's3-fetch': typeof import('files-sdk/s3-fetch').s3Fetch;
+  scaleway: typeof import('files-sdk/scaleway').scaleway;
+  sftp: typeof import('files-sdk/sftp').sftp;
+  sharepoint: typeof import('files-sdk/sharepoint').sharepoint;
+  storj: typeof import('files-sdk/storj').storj;
+  supabase: typeof import('files-sdk/supabase').supabase;
+  tencent: typeof import('files-sdk/tencent').tencent;
+  tigris: typeof import('files-sdk/tigris').tigris;
+  uploadthing: typeof import('files-sdk/uploadthing').uploadthing;
+  'vercel-blob': typeof import('files-sdk/vercel-blob').vercelBlob;
+  vultr: typeof import('files-sdk/vultr').vultr;
+  wasabi: typeof import('files-sdk/wasabi').wasabi;
+  webdav: typeof import('files-sdk/webdav').webdav;
+  yandex: typeof import('files-sdk/yandex').yandex;
+}
+//#endregion
+//# sourceMappingURL=provider-types.d.ts.map

package/dist/runtime/registry.d.ts

@@ -1,13 +1,44 @@
-import { FilesConfig, NamedFilesConfig, SingleFilesConfig, StorageConfig } from "../config.js";
-import { FilesDevtoolsSnapshot } from "../devtools/snapshot.js";
+import { ProviderFactories } from "./provider-types.js";
+import { FilesConfig, FilesConfigInput } from "../config.js";
+import { FilesDevtoolsDiagnosticCode } from "../devtools/diagnostics.js";
 import { Adapter, ExtensionsOf, Files, FilesActionEvent, FilesErrorEvent, FilesRetryEvent, ProviderSlug } from "files-sdk";
 //#region src/runtime/registry.d.ts
 /** Native Files client plus the methods contributed by a storage's plugins. */
-export type FilesForStorage<T extends StorageConfig> = Files & ExtensionsOf<NonNullable<T['plugins']>>;
+type AdapterFor<A> = A extends ProviderSlug ? ReturnType<ProviderFactories[A]> : A extends ((...args: never[]) => Adapter) ? ReturnType<A> : never;
+type PluginsFor<T> = T extends {
+  plugins: infer V;
+} ? V extends ((...args: never[]) => infer P) ? P extends readonly import('files-sdk').FilesPlugin[] ? P : never : V extends readonly import('files-sdk').FilesPlugin[] ? V : never : never;
+export type FilesForStorage<T extends {
+  adapter: ProviderSlug | ((...args: never[]) => Adapter);
+}> = Files<AdapterFor<T['adapter']>> & ExtensionsOf<PluginsFor<T>>;
+type StorageOf<C> = C extends {
+  storage: infer S;
+} ? S : never;
+type StorageBranch<C> = StorageOf<C> | StorageOf<C extends {
+  $development: infer E;
+} ? E : never> | StorageOf<C extends {
+  $production: infer E;
+} ? E : never> | StorageOf<C extends {
+  $test: infer E;
+} ? E : never> | StorageOf<C extends {
+  $prerender: infer E;
+} ? E : never> | StorageOf<C extends {
+  $env: infer E;
+} ? E[keyof E] : never>;
+type SingleEntry<C> = Extract<StorageBranch<C>, {
+  adapter: ProviderSlug | ((...args: never[]) => Adapter);
+}>;
+type NamedSet<C> = Exclude<StorageBranch<C>, {
+  adapter: unknown;
+}>;
+type StorageNames<C> = NamedSet<C> extends (infer S) ? (S extends object ? keyof S : never) : never;
+type NamedEntry<C, Name extends PropertyKey> = NamedSet<C> extends (infer S) ? (S extends object ? (Name extends keyof S ? S[Name] : never) : never) : never;
 /** Map each configured storage name to its native Files client and plugin extensions. */
-export type StorageRegistry<C extends FilesConfig> = C extends NamedFilesConfig<infer Storages> ? { [Name in keyof Storages]: FilesForStorage<Storages[Name]>; } : Record<never, never>;
+export type StorageRegistry<C extends FilesConfigInput> = { [Name in StorageNames<C>]: FilesForStorage<Extract<NamedEntry<C, Name>, {
+  adapter: ProviderSlug | ((...args: never[]) => Adapter);
+}>>; };
 /** Files client returned by an unnamed single-storage configuration. */
-export type SingleStorage<C extends FilesConfig> = C extends SingleFilesConfig<infer Storage> ? FilesForStorage<Storage> : never;
+export type SingleStorage<C extends FilesConfigInput> = FilesForStorage<SingleEntry<C>>;
 /** Hooks emitted by the Nuxt/Nitro bridge after the storage's native hooks. */
 export interface FilesRuntimeHooks {
   /** Observe a failed native Files operation. */
@@ -21,21 +52,37 @@ export interface FilesRuntimeHooks {
 export type FilesProviderFactory = (config: never) => Adapter;
 /** Provider factories available in the current build. */
 export type FilesProviderFactories = Partial<Record<ProviderSlug, FilesProviderFactory>>;
+export type ProviderEnvironment = Partial<Record<ProviderSlug, readonly (readonly string[])[]>>;
+export interface RegistryDiagnostic {
+  code: FilesDevtoolsDiagnosticCode;
+  name?: string;
+  adapter?: string;
+}
 /** Lazily construct and memoize native Files clients for a validated project configuration. */
 export declare class FilesRegistry<const C extends FilesConfig = FilesConfig> {
   #private;
   /** Create a registry without constructing a provider. */
   constructor(config: C, options: {
-    development?: boolean;
+    environment?: ProviderEnvironment;
     factories: FilesProviderFactories;
     hooks?: FilesRuntimeHooks;
   });
   /** Return the client from an unnamed single-storage configuration. */
-  get(...args: C extends SingleFilesConfig ? [] : [name: never]): SingleStorage<C>;
+  get(...args: SingleEntry<C> extends never ? [name: never] : []): SingleStorage<C>;
   /** Return one named storage client. */
   get<Name extends Extract<keyof StorageRegistry<C>, string>>(name: Name): StorageRegistry<C>[Name];
   /** Return secret-free storage metadata and initialization state for development diagnostics. */
-  inspect(): FilesDevtoolsSnapshot;
+  inspect(): {
+    storages: {
+      name?: string;
+      adapter: string;
+      plugins: any[];
+      initialized: boolean;
+    }[];
+    diagnostics: RegistryDiagnostic[];
+  };
+  /** Resolve one selected adapter without constructing its Files client. */
+  resolveAdapter(name?: string): Adapter;
 }
 //#endregion
 //# sourceMappingURL=registry.d.ts.map

package/dist/runtime/registry.js

@@ -1,4 +1,4 @@
-import { getProvider, listEnvVars } from "files-sdk/providers";
+import { normalizeFilesConfig } from "./normalize.js";
 import { createFiles } from "files-sdk";
 //#region src/runtime/registry.ts
 const runHooks = async (...hooks) => {
@@ -6,113 +6,180 @@ const runHooks = async (...hooks) => {
 		await hook();
 	} catch {}
 };
-const isStorageConfig = (value) => Boolean(value && typeof value === "object" && "adapter" in value && typeof value.adapter === "string");
-const isStorageRecord = (value) => Boolean(value && typeof value === "object" && Object.values(value).every(isStorageConfig));
+const nativeFilesOptions = ({ adapter: _adapter, config: _config, hooks: _hooks, plugins: _plugins, ...options }) => options;
 /** Lazily construct and memoize native Files clients for a validated project configuration. */
 var FilesRegistry = class {
-	#config;
-	#development;
+	#entries;
+	#environment;
 	#factories;
 	#hooks;
+	#adapters = /* @__PURE__ */ new Map();
+	#adapterInitializing = /* @__PURE__ */ new Set();
 	#instances = /* @__PURE__ */ new Map();
-	#initializing = /* @__PURE__ */ new Set();
+	#filesInitializing = /* @__PURE__ */ new Set();
+	#pluginNames = /* @__PURE__ */ new Map();
+	#diagnostics = /* @__PURE__ */ new Map();
 	/** Create a registry without constructing a provider. */
 	constructor(config, options) {
-		if ("default" in config) throw new Error("[nuxt-files-sdk:invalid-config] The default option has been removed.");
-		if (!config.storage || !isStorageConfig(config.storage) && (!isStorageRecord(config.storage) || Object.keys(config.storage).length === 0)) throw new Error("[nuxt-files-sdk:invalid-config] At least one storage is required.");
-		if (!isStorageConfig(config.storage)) {
-			if (config.devStorage && !isStorageRecord(config.devStorage)) throw new Error("[nuxt-files-sdk:invalid-config] Named storage requires named devStorage overrides.");
-			for (const name of Object.keys(config.devStorage ?? {})) if (!Object.hasOwn(config.storage, name)) throw new Error(`[nuxt-files-sdk:unknown-storage] Unknown storage "${name}".`);
-		}
-		this.#config = config;
-		this.#development = options.development ?? false;
+		this.#entries = normalizeFilesConfig(config);
+		if (!this.#entries.size) throw new Error("[nuxt-files-sdk:invalid-config] At least one storage is required.");
+		this.#environment = options.environment ?? {};
 		this.#factories = options.factories;
 		this.#hooks = options.hooks ?? {};
 	}
-	get(name) {
+	get(...args) {
+		const name = args[0];
 		const entry = this.#entry(name);
-		const key = entry.name ?? "";
+		const key = entry.name;
 		const cached = this.#instances.get(key);
 		if (cached) return cached;
-		if (this.#initializing.has(key)) throw new Error("[nuxt-files-sdk:circular-initialization] Storage configuration cannot access itself.");
-		this.#initializing.add(key);
+		if (this.#filesInitializing.has(key)) throw this.#circular(key);
+		this.#filesInitializing.add(key);
 		try {
 			const files = this.#create(entry);
 			this.#instances.set(key, files);
+			this.#diagnostics.delete(key);
 			return files;
+		} catch (error) {
+			this.#diagnostics.set(key, {
+				code: "NUXT_FILES_ADAPTER_INIT_FAILED",
+				...entry.name === void 0 ? {} : { name: entry.name },
+				adapter: typeof entry.storage.adapter === "string" ? entry.storage.adapter : "custom"
+			});
+			throw error;
 		} finally {
-			this.#initializing.delete(key);
+			this.#filesInitializing.delete(key);
 		}
 	}
 	/** Return secret-free storage metadata and initialization state for development diagnostics. */
 	inspect() {
 		return {
-			storages: this.#entries().map(({ name, storage, override }) => ({
+			storages: [...this.#entries.values()].map(({ name, storage }) => ({
 				...name === void 0 ? {} : { name },
-				adapter: override?.adapter ?? storage.adapter,
-				plugins: storage.plugins?.map((plugin) => plugin.name) ?? [],
-				source: override ? "devStorage" : "storage",
-				initialized: this.#instances.has(name ?? "")
+				adapter: typeof storage.adapter === "string" ? storage.adapter : "custom",
+				plugins: this.#pluginNames.get(name) ?? (Array.isArray(storage.plugins) ? storage.plugins.map((plugin) => plugin.name) : []),
+				initialized: this.#instances.has(name)
 			})),
-			diagnostics: []
+			diagnostics: [...this.#diagnostics.values()]
 		};
 	}
-	#entries() {
-		const storage = this.#config.storage;
-		const devStorage = this.#config.devStorage;
-		if (isStorageConfig(storage)) return [{
-			name: void 0,
-			storage,
-			override: this.#development && isStorageConfig(devStorage) ? devStorage : void 0
-		}];
-		const overrides = this.#development && isStorageRecord(devStorage) ? devStorage : void 0;
-		return Object.entries(storage).map(([name, namedStorage]) => ({
-			name,
-			storage: namedStorage,
-			override: overrides?.[name]
-		}));
-	}
 	#entry(name) {
-		if (isStorageConfig(this.#config.storage)) {
-			if (name !== void 0) throw new Error(`[nuxt-files-sdk:unknown-storage] Unknown storage "${name}".`);
-			return this.#entries()[0];
-		}
-		if (name === void 0) throw new Error("[nuxt-files-sdk:storage-name-required] A storage name is required.");
-		const entry = this.#entries().find((candidate) => candidate.name === name);
+		if (name === void 0 && !this.#entries.has(void 0)) throw new Error("[nuxt-files-sdk:storage-name-required] A storage name is required.");
+		const entry = this.#entries.get(name);
 		if (!entry) throw new Error(`[nuxt-files-sdk:unknown-storage] Unknown storage "${name}".`);
 		return entry;
 	}
-	#create({ name, storage, override }) {
-		const selected = override ?? storage;
-		const factory = this.#factories[selected.adapter];
-		if (!factory) throw new Error(`[nuxt-files-sdk:adapter-not-generated] Adapter "${selected.adapter}" is not available in this build.`);
-		const adapter = withNuxtEnvironment(selected.adapter, () => {
+	/** Resolve one selected adapter without constructing its Files client. */
+	resolveAdapter(name) {
+		const entry = this.#entry(name);
+		const key = entry.name;
+		const cached = this.#adapters.get(key);
+		if (cached) return cached;
+		if (this.#adapterInitializing.has(key)) throw this.#circular(key);
+		this.#adapterInitializing.add(key);
+		try {
+			const adapter = this.#createAdapter(entry);
+			this.#adapters.set(key, adapter);
+			return adapter;
+		} finally {
+			this.#adapterInitializing.delete(key);
+		}
+	}
+	#circular(name) {
+		return /* @__PURE__ */ new Error(`[nuxt-files-sdk:circular-initialization] Circular storage dependency${name ? ` at "${name}"` : ""}.`);
+	}
+	#createAdapter({ storage: selected }) {
+		const factory = typeof selected.adapter === "string" ? this.#factories[selected.adapter] : selected.adapter;
+		if (!factory) throw new Error(`[nuxt-files-sdk:adapter-not-generated] Adapter "${typeof selected.adapter === "string" ? selected.adapter : "custom"}" is not available in this build.`);
+		const environment = typeof selected.adapter === "string" ? this.#environment[selected.adapter] ?? [] : [];
+		return withNuxtEnvironment(environment, () => {
 			const input = typeof selected.config === "function" ? selected.config() : selected.config;
 			if (input && typeof input === "object" && "then" in input) throw new Error("[nuxt-files-sdk:async-config] Storage config functions must be synchronous.");
-			return factory(input);
+			const value = selected.adapter === "s3" ? withS3NuxtCredentials(input) : selected.adapter === "bun-s3" ? withBunS3NuxtOptions(input) : input;
+			return factory(value);
 		});
-		return createFiles({
+	}
+	#create({ name, storage }) {
+		const adapter = this.resolveAdapter(name);
+		const plugins = typeof storage.plugins === "function" ? storage.plugins({ storage: (storageName) => this.resolveAdapter(storageName) }) : storage.plugins;
+		const files = createFiles({
 			adapter,
+			...nativeFilesOptions(storage),
 			hooks: {
 				onAction: (event) => runHooks(() => storage.hooks?.onAction?.(event), () => this.#hooks.onAction?.(event, name)),
 				onError: (event) => runHooks(() => storage.hooks?.onError?.(event), () => this.#hooks.onError?.(event, name)),
 				onRetry: (event) => runHooks(() => storage.hooks?.onRetry?.(event), () => this.#hooks.onRetry?.(event, name))
 			},
-			...storage.plugins ? { plugins: storage.plugins } : {},
-			...storage.prefix === void 0 ? {} : { prefix: storage.prefix },
-			...storage.retries === void 0 ? {} : { retries: storage.retries },
-			...storage.timeout === void 0 ? {} : { timeout: storage.timeout }
+			...plugins ? { plugins } : {}
 		});
+		if (plugins) this.#pluginNames.set(name, plugins.map((plugin) => plugin.name));
+		return files;
+	}
+};
+/** Pass NUXT_ credentials explicitly because the AWS SDK resolves its chain after construction. */
+const withS3NuxtCredentials = (input) => {
+	if (!input || typeof input !== "object" || "credentials" in input) return input;
+	if ([
+		"AWS_ACCESS_KEY_ID",
+		"AWS_SECRET_ACCESS_KEY",
+		"AWS_PROFILE",
+		"AWS_WEB_IDENTITY_TOKEN_FILE",
+		"AWS_CONTAINER_CREDENTIALS_RELATIVE_URI",
+		"AWS_CONTAINER_CREDENTIALS_FULL_URI"
+	].some((key) => process.env[key] !== void 0)) return input;
+	const accessKeyId = process.env.NUXT_AWS_ACCESS_KEY_ID;
+	const secretAccessKey = process.env.NUXT_AWS_SECRET_ACCESS_KEY;
+	if (!accessKeyId || !secretAccessKey) return input;
+	return {
+		...input,
+		credentials: {
+			accessKeyId,
+			secretAccessKey,
+			...(process.env.AWS_SESSION_TOKEN ?? process.env.NUXT_AWS_SESSION_TOKEN) && { sessionToken: process.env.AWS_SESSION_TOKEN ?? process.env.NUXT_AWS_SESSION_TOKEN }
+		}
+	};
+};
+/** Bun resolves these environment keys in its own client; pass NUXT_ aliases as explicit options. */
+const withBunS3NuxtOptions = (input) => {
+	if (input && (typeof input !== "object" || "client" in input)) return input;
+	const options = { ...typeof input === "object" && input ? input : {} };
+	for (const [field, key, alias] of [
+		[
+			"accessKeyId",
+			"AWS_ACCESS_KEY_ID",
+			"S3_ACCESS_KEY_ID"
+		],
+		[
+			"secretAccessKey",
+			"AWS_SECRET_ACCESS_KEY",
+			"S3_SECRET_ACCESS_KEY"
+		],
+		[
+			"sessionToken",
+			"AWS_SESSION_TOKEN",
+			"S3_SESSION_TOKEN"
+		],
+		[
+			"region",
+			"AWS_REGION",
+			"S3_REGION"
+		],
+		[
+			"bucket",
+			"AWS_BUCKET",
+			"S3_BUCKET"
+		]
+	]) {
+		if (Object.hasOwn(options, field) || process.env[key] !== void 0 || process.env[alias] !== void 0) continue;
+		const value = process.env[`NUXT_${key}`] ?? process.env[`NUXT_${alias}`];
+		if (value !== void 0) options[field] = value;
 	}
+	return options;
 };
 /** Bridge only NUXT_ aliases declared by the configured native provider during synchronous construction. */
-const withNuxtEnvironment = (provider, load) => {
-	if (!getProvider(provider)) return load();
-	const variables = listEnvVars(provider);
-	if (variables.length === 0) return load();
+const withNuxtEnvironment = (variables, load) => {
 	const injected = [];
-	for (const variable of variables) {
-		const keys = [variable.key, ...variable.aliases ?? []];
+	for (const keys of variables) {
 		if (keys.some((key) => process.env[key] !== void 0)) continue;
 		for (const key of keys) {
 			const value = process.env[`NUXT_${key}`];

package/dist/runtime/registry.js.map

@@ -1 +1 @@
-{"version":3,"file":"registry.js","names":[],"sources":["../../src/runtime/registry.ts"],"sourcesContent":["import {\n    createFiles,\n    type Adapter,\n    type ExtensionsOf,\n    type Files,\n    type FilesActionEvent,\n    type FilesErrorEvent,\n    type FilesRetryEvent,\n    type ProviderSlug,\n} from 'files-sdk'\nimport { getProvider, listEnvVars } from 'files-sdk/providers'\n\nimport type { FilesConfig, NamedFilesConfig, SingleFilesConfig, StorageConfig } from '../config'\nimport type { FilesDevtoolsSnapshot } from '../devtools/snapshot'\n\n/** Native Files client plus the methods contributed by a storage's plugins. */\nexport type FilesForStorage<T extends StorageConfig> = Files & ExtensionsOf<NonNullable<T['plugins']>>\n\n/** Map each configured storage name to its native Files client and plugin extensions. */\nexport type StorageRegistry<C extends FilesConfig> =\n    C extends NamedFilesConfig<infer Storages>\n        ? { [Name in keyof Storages]: FilesForStorage<Storages[Name]> }\n        : Record<never, never>\n\n/** Files client returned by an unnamed single-storage configuration. */\nexport type SingleStorage<C extends FilesConfig> =\n    C extends SingleFilesConfig<infer Storage> ? FilesForStorage<Storage> : never\n\n/** Hooks emitted by the Nuxt/Nitro bridge after the storage's native hooks. */\nexport interface FilesRuntimeHooks {\n    /** Observe a failed native Files operation. */\n    onError?: (event: FilesErrorEvent, storage?: string) => void | Promise<void>\n    /** Observe a completed native Files operation. */\n    onAction?: (event: FilesActionEvent, storage?: string) => void | Promise<void>\n    /** Observe a native Files retry. */\n    onRetry?: (event: FilesRetryEvent, storage?: string) => void | Promise<void>\n}\n\n/** One provider factory statically supplied by the generated Nitro plugin. */\nexport type FilesProviderFactory = (config: never) => Adapter\n/** Provider factories available in the current build. */\nexport type FilesProviderFactories = Partial<Record<ProviderSlug, FilesProviderFactory>>\n\nconst runHooks = async (...hooks: (() => void | Promise<void> | undefined)[]): Promise<void> => {\n    for (const hook of hooks) {\n        try {\n            // Preserve user-before-bridge ordering without exposing hook failures to native operations.\n            // oxlint-disable-next-line no-await-in-loop\n            await hook()\n        } catch {}\n    }\n}\n\nconst isStorageConfig = (value: unknown): value is StorageConfig =>\n    Boolean(value && typeof value === 'object' && 'adapter' in value && typeof value.adapter === 'string')\nconst isStorageRecord = (value: unknown): value is Record<string, StorageConfig> =>\n    Boolean(value && typeof value === 'object' && Object.values(value).every(isStorageConfig))\n\ntype StorageEntry = { name: string | undefined; storage: StorageConfig; override: StorageConfig | undefined }\n\n/** Lazily construct and memoize native Files clients for a validated project configuration. */\nexport class FilesRegistry<const C extends FilesConfig = FilesConfig> {\n    readonly #config: C\n    readonly #development: boolean\n    readonly #factories: FilesProviderFactories\n    readonly #hooks: FilesRuntimeHooks\n    readonly #instances = new Map<string, Files>()\n    readonly #initializing = new Set<string>()\n\n    /** Create a registry without constructing a provider. */\n    constructor(\n        config: C,\n        options: {\n            development?: boolean\n            factories: FilesProviderFactories\n            hooks?: FilesRuntimeHooks\n        },\n    ) {\n        if ('default' in config) {\n            throw new Error('[nuxt-files-sdk:invalid-config] The default option has been removed.')\n        }\n        if (\n            !config.storage ||\n            (!isStorageConfig(config.storage) &&\n                (!isStorageRecord(config.storage) || Object.keys(config.storage).length === 0))\n        ) {\n            throw new Error('[nuxt-files-sdk:invalid-config] At least one storage is required.')\n        }\n        if (!isStorageConfig(config.storage)) {\n            if (config.devStorage && !isStorageRecord(config.devStorage)) {\n                throw new Error('[nuxt-files-sdk:invalid-config] Named storage requires named devStorage overrides.')\n            }\n            for (const name of Object.keys(config.devStorage ?? {})) {\n                if (!Object.hasOwn(config.storage, name)) {\n                    throw new Error(`[nuxt-files-sdk:unknown-storage] Unknown storage \"${name}\".`)\n                }\n            }\n        }\n        this.#config = config\n        this.#development = options.development ?? false\n        this.#factories = options.factories\n        this.#hooks = options.hooks ?? {}\n    }\n\n    /** Return the client from an unnamed single-storage configuration. */\n    get(...args: C extends SingleFilesConfig ? [] : [name: never]): SingleStorage<C>\n    /** Return one named storage client. */\n    get<Name extends Extract<keyof StorageRegistry<C>, string>>(name: Name): StorageRegistry<C>[Name]\n    get(name?: string): Files {\n        const entry = this.#entry(name)\n        const key = entry.name ?? ''\n        const cached = this.#instances.get(key)\n        if (cached) return cached\n        if (this.#initializing.has(key)) {\n            throw new Error('[nuxt-files-sdk:circular-initialization] Storage configuration cannot access itself.')\n        }\n        this.#initializing.add(key)\n        try {\n            const files = this.#create(entry)\n            this.#instances.set(key, files)\n            return files\n        } finally {\n            this.#initializing.delete(key)\n        }\n    }\n\n    /** Return secret-free storage metadata and initialization state for development diagnostics. */\n    inspect(): FilesDevtoolsSnapshot {\n        return {\n            storages: this.#entries().map(({ name, storage, override }) => ({\n                ...(name === undefined ? {} : { name }),\n                adapter: override?.adapter ?? storage.adapter,\n                plugins: storage.plugins?.map((plugin) => plugin.name) ?? [],\n                source: override ? 'devStorage' : 'storage',\n                initialized: this.#instances.has(name ?? ''),\n            })),\n            diagnostics: [],\n        }\n    }\n\n    #entries(): StorageEntry[] {\n        const storage = this.#config.storage\n        const devStorage = this.#config.devStorage\n        if (isStorageConfig(storage)) {\n            const override = this.#development && isStorageConfig(devStorage) ? devStorage : undefined\n            return [{ name: undefined, storage, override }]\n        }\n        const overrides = this.#development && isStorageRecord(devStorage) ? devStorage : undefined\n        return Object.entries(storage).map(([name, namedStorage]) => ({\n            name,\n            storage: namedStorage,\n            override: overrides?.[name],\n        }))\n    }\n\n    #entry(name?: string): StorageEntry {\n        if (isStorageConfig(this.#config.storage)) {\n            if (name !== undefined) {\n                throw new Error(`[nuxt-files-sdk:unknown-storage] Unknown storage \"${name}\".`)\n            }\n            return this.#entries()[0]!\n        }\n        if (name === undefined) {\n            throw new Error('[nuxt-files-sdk:storage-name-required] A storage name is required.')\n        }\n        const entry = this.#entries().find((candidate) => candidate.name === name)\n        if (!entry) throw new Error(`[nuxt-files-sdk:unknown-storage] Unknown storage \"${name}\".`)\n        return entry\n    }\n\n    #create({ name, storage, override }: StorageEntry): Files {\n        const selected = override ?? storage\n        const factory = this.#factories[selected.adapter]\n        if (!factory) {\n            throw new Error(\n                `[nuxt-files-sdk:adapter-not-generated] Adapter \"${selected.adapter}\" is not available in this build.`,\n            )\n        }\n        const adapter = withNuxtEnvironment(selected.adapter, () => {\n            const input = typeof selected.config === 'function' ? selected.config() : selected.config\n            if (input && typeof input === 'object' && 'then' in input) {\n                throw new Error('[nuxt-files-sdk:async-config] Storage config functions must be synchronous.')\n            }\n            // Generated factories and configs share an adapter key; the broad registry type erases that correlation.\n            // oxlint-disable-next-line typescript/no-unsafe-type-assertion\n            return factory(input as never)\n        })\n        return createFiles({\n            adapter,\n            hooks: {\n                onAction: (event) =>\n                    runHooks(\n                        () => storage.hooks?.onAction?.(event),\n                        () => this.#hooks.onAction?.(event, name),\n                    ),\n                onError: (event) =>\n                    runHooks(\n                        () => storage.hooks?.onError?.(event),\n                        () => this.#hooks.onError?.(event, name),\n                    ),\n                onRetry: (event) =>\n                    runHooks(\n                        () => storage.hooks?.onRetry?.(event),\n                        () => this.#hooks.onRetry?.(event, name),\n                    ),\n            },\n            ...(storage.plugins ? { plugins: storage.plugins } : {}),\n            ...(storage.prefix === undefined ? {} : { prefix: storage.prefix }),\n            ...(storage.retries === undefined ? {} : { retries: storage.retries }),\n            ...(storage.timeout === undefined ? {} : { timeout: storage.timeout }),\n        })\n    }\n}\n\n/** Bridge only NUXT_ aliases declared by the configured native provider during synchronous construction. */\nexport const withNuxtEnvironment = <T>(provider: ProviderSlug, load: () => T): T => {\n    const metadata = getProvider(provider)\n    if (!metadata) return load()\n    const variables = listEnvVars(provider)\n    if (variables.length === 0) return load()\n    const injected: string[] = []\n    for (const variable of variables) {\n        const keys = [variable.key, ...(variable.aliases ?? [])]\n        if (keys.some((key) => process.env[key] !== undefined)) continue\n        for (const key of keys) {\n            const value = process.env[`NUXT_${key}`]\n            if (value !== undefined && process.env[key] === undefined) {\n                process.env[key] = value\n                injected.push(key)\n            }\n        }\n    }\n    try {\n        return load()\n    } finally {\n        for (const key of injected) delete process.env[key]\n    }\n}\n"],"mappings":"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"}
+{"version":3,"file":"registry.js","names":[],"sources":["../../src/runtime/registry.ts"],"sourcesContent":["import {\n    createFiles,\n    type Adapter,\n    type ExtensionsOf,\n    type Files,\n    type FilesActionEvent,\n    type FilesErrorEvent,\n    type FilesRetryEvent,\n    type ProviderSlug,\n} from 'files-sdk'\n\nimport type { FilesConfig, FilesConfigInput, StorageConfig } from '../config'\nimport type { FilesDevtoolsDiagnosticCode } from '../devtools/diagnostics'\nimport { normalizeFilesConfig, type StorageEntry } from './normalize'\nimport type { ProviderFactories } from './provider-types'\n\n/** Native Files client plus the methods contributed by a storage's plugins. */\ntype AdapterFor<A> = A extends ProviderSlug\n    ? ReturnType<ProviderFactories[A]>\n    : A extends (...args: never[]) => Adapter\n      ? ReturnType<A>\n      : never\ntype PluginsFor<T> = T extends { plugins: infer V }\n    ? V extends (...args: never[]) => infer P\n        ? P extends readonly import('files-sdk').FilesPlugin[]\n            ? P\n            : never\n        : V extends readonly import('files-sdk').FilesPlugin[]\n          ? V\n          : never\n    : never\nexport type FilesForStorage<T extends { adapter: ProviderSlug | ((...args: never[]) => Adapter) }> = Files<\n    AdapterFor<T['adapter']>\n> &\n    ExtensionsOf<PluginsFor<T>>\n\ntype StorageOf<C> = C extends { storage: infer S } ? S : never\ntype StorageBranch<C> =\n    | StorageOf<C>\n    | StorageOf<C extends { $development: infer E } ? E : never>\n    | StorageOf<C extends { $production: infer E } ? E : never>\n    | StorageOf<C extends { $test: infer E } ? E : never>\n    | StorageOf<C extends { $prerender: infer E } ? E : never>\n    | StorageOf<C extends { $env: infer E } ? E[keyof E] : never>\ntype SingleEntry<C> = Extract<StorageBranch<C>, { adapter: ProviderSlug | ((...args: never[]) => Adapter) }>\ntype NamedSet<C> = Exclude<StorageBranch<C>, { adapter: unknown }>\ntype StorageNames<C> = NamedSet<C> extends infer S ? (S extends object ? keyof S : never) : never\ntype NamedEntry<C, Name extends PropertyKey> =\n    NamedSet<C> extends infer S ? (S extends object ? (Name extends keyof S ? S[Name] : never) : never) : never\n/** Map each configured storage name to its native Files client and plugin extensions. */\nexport type StorageRegistry<C extends FilesConfigInput> = {\n    [Name in StorageNames<C>]: FilesForStorage<\n        Extract<NamedEntry<C, Name>, { adapter: ProviderSlug | ((...args: never[]) => Adapter) }>\n    >\n}\n\n/** Files client returned by an unnamed single-storage configuration. */\nexport type SingleStorage<C extends FilesConfigInput> = FilesForStorage<SingleEntry<C>>\n\n/** Hooks emitted by the Nuxt/Nitro bridge after the storage's native hooks. */\nexport interface FilesRuntimeHooks {\n    /** Observe a failed native Files operation. */\n    onError?: (event: FilesErrorEvent, storage?: string) => void | Promise<void>\n    /** Observe a completed native Files operation. */\n    onAction?: (event: FilesActionEvent, storage?: string) => void | Promise<void>\n    /** Observe a native Files retry. */\n    onRetry?: (event: FilesRetryEvent, storage?: string) => void | Promise<void>\n}\n\n/** One provider factory statically supplied by the generated Nitro plugin. */\nexport type FilesProviderFactory = (config: never) => Adapter\n/** Provider factories available in the current build. */\nexport type FilesProviderFactories = Partial<Record<ProviderSlug, FilesProviderFactory>>\n\nconst runHooks = async (...hooks: (() => void | Promise<void> | undefined)[]): Promise<void> => {\n    for (const hook of hooks) {\n        try {\n            // Preserve user-before-bridge ordering without exposing hook failures to native operations.\n            // oxlint-disable-next-line no-await-in-loop\n            await hook()\n        } catch {}\n    }\n}\n\nconst nativeFilesOptions = ({\n    adapter: _adapter,\n    config: _config,\n    hooks: _hooks,\n    plugins: _plugins,\n    ...options\n}: StorageConfig) => options\n\nexport type ProviderEnvironment = Partial<Record<ProviderSlug, readonly (readonly string[])[]>>\nexport interface RegistryDiagnostic {\n    code: FilesDevtoolsDiagnosticCode\n    name?: string\n    adapter?: string\n}\n\n/** Lazily construct and memoize native Files clients for a validated project configuration. */\nexport class FilesRegistry<const C extends FilesConfig = FilesConfig> {\n    readonly #entries: Map<string | undefined, StorageEntry>\n    readonly #environment: ProviderEnvironment\n    readonly #factories: FilesProviderFactories\n    readonly #hooks: FilesRuntimeHooks\n    readonly #adapters = new Map<string | undefined, Adapter>()\n    readonly #adapterInitializing = new Set<string | undefined>()\n    readonly #instances = new Map<string | undefined, Files>()\n    readonly #filesInitializing = new Set<string | undefined>()\n    readonly #pluginNames = new Map<string | undefined, string[]>()\n    readonly #diagnostics = new Map<string | undefined, RegistryDiagnostic>()\n\n    /** Create a registry without constructing a provider. */\n    constructor(\n        config: C,\n        options: {\n            environment?: ProviderEnvironment\n            factories: FilesProviderFactories\n            hooks?: FilesRuntimeHooks\n        },\n    ) {\n        this.#entries = normalizeFilesConfig(config)\n        if (!this.#entries.size) throw new Error('[nuxt-files-sdk:invalid-config] At least one storage is required.')\n        this.#environment = options.environment ?? {}\n        this.#factories = options.factories\n        this.#hooks = options.hooks ?? {}\n    }\n\n    /** Return the client from an unnamed single-storage configuration. */\n    get(...args: SingleEntry<C> extends never ? [name: never] : []): SingleStorage<C>\n    /** Return one named storage client. */\n    get<Name extends Extract<keyof StorageRegistry<C>, string>>(name: Name): StorageRegistry<C>[Name]\n    get(...args: [] | [string]): unknown {\n        const name = args[0]\n        const entry = this.#entry(name)\n        const key = entry.name\n        const cached = this.#instances.get(key)\n        if (cached) return cached\n        if (this.#filesInitializing.has(key)) throw this.#circular(key)\n        this.#filesInitializing.add(key)\n        try {\n            const files = this.#create(entry)\n            this.#instances.set(key, files)\n            this.#diagnostics.delete(key)\n            return files\n        } catch (error) {\n            this.#diagnostics.set(key, {\n                code: 'NUXT_FILES_ADAPTER_INIT_FAILED',\n                ...(entry.name === undefined ? {} : { name: entry.name }),\n                adapter: typeof entry.storage.adapter === 'string' ? entry.storage.adapter : 'custom',\n            })\n            throw error\n        } finally {\n            this.#filesInitializing.delete(key)\n        }\n    }\n\n    /** Return secret-free storage metadata and initialization state for development diagnostics. */\n    inspect() {\n        return {\n            storages: [...this.#entries.values()].map(({ name, storage }) => ({\n                ...(name === undefined ? {} : { name }),\n                adapter: typeof storage.adapter === 'string' ? storage.adapter : 'custom',\n                plugins:\n                    this.#pluginNames.get(name) ??\n                    (Array.isArray(storage.plugins) ? storage.plugins.map((plugin) => plugin.name) : []),\n                initialized: this.#instances.has(name),\n            })),\n            diagnostics: [...this.#diagnostics.values()],\n        }\n    }\n\n    #entry(name?: string): StorageEntry {\n        if (name === undefined && !this.#entries.has(undefined)) {\n            throw new Error('[nuxt-files-sdk:storage-name-required] A storage name is required.')\n        }\n        const entry = this.#entries.get(name)\n        if (!entry) throw new Error(`[nuxt-files-sdk:unknown-storage] Unknown storage \"${name}\".`)\n        return entry\n    }\n\n    /** Resolve one selected adapter without constructing its Files client. */\n    resolveAdapter(name?: string): Adapter {\n        const entry = this.#entry(name)\n        const key = entry.name\n        const cached = this.#adapters.get(key)\n        if (cached) return cached\n        if (this.#adapterInitializing.has(key)) throw this.#circular(key)\n        this.#adapterInitializing.add(key)\n        try {\n            const adapter = this.#createAdapter(entry)\n            this.#adapters.set(key, adapter)\n            return adapter\n        } finally {\n            this.#adapterInitializing.delete(key)\n        }\n    }\n\n    #circular(name?: string): Error {\n        return new Error(\n            `[nuxt-files-sdk:circular-initialization] Circular storage dependency${name ? ` at \"${name}\"` : ''}.`,\n        )\n    }\n\n    #createAdapter({ storage: selected }: StorageEntry): Adapter {\n        const factory = typeof selected.adapter === 'string' ? this.#factories[selected.adapter] : selected.adapter\n        if (!factory) {\n            throw new Error(\n                `[nuxt-files-sdk:adapter-not-generated] Adapter \"${typeof selected.adapter === 'string' ? selected.adapter : 'custom'}\" is not available in this build.`,\n            )\n        }\n        const environment = typeof selected.adapter === 'string' ? (this.#environment[selected.adapter] ?? []) : []\n        return withNuxtEnvironment(environment, () => {\n            const input = typeof selected.config === 'function' ? selected.config() : selected.config\n            if (input && typeof input === 'object' && 'then' in input) {\n                throw new Error('[nuxt-files-sdk:async-config] Storage config functions must be synchronous.')\n            }\n            const value =\n                selected.adapter === 's3'\n                    ? withS3NuxtCredentials(input)\n                    : selected.adapter === 'bun-s3'\n                      ? withBunS3NuxtOptions(input)\n                      : input\n            // Generated factories and configs share an adapter key; the broad registry type erases that correlation.\n            // oxlint-disable-next-line typescript/no-unsafe-type-assertion\n            return factory(value as never)\n        })\n    }\n\n    #create({ name, storage }: StorageEntry): Files {\n        const adapter = this.resolveAdapter(name)\n        const plugins =\n            typeof storage.plugins === 'function'\n                ? storage.plugins({ storage: (storageName) => this.resolveAdapter(storageName) })\n                : storage.plugins\n        const files = createFiles({\n            adapter,\n            ...nativeFilesOptions(storage),\n            hooks: {\n                onAction: (event) =>\n                    runHooks(\n                        () => storage.hooks?.onAction?.(event),\n                        () => this.#hooks.onAction?.(event, name),\n                    ),\n                onError: (event) =>\n                    runHooks(\n                        () => storage.hooks?.onError?.(event),\n                        () => this.#hooks.onError?.(event, name),\n                    ),\n                onRetry: (event) =>\n                    runHooks(\n                        () => storage.hooks?.onRetry?.(event),\n                        () => this.#hooks.onRetry?.(event, name),\n                    ),\n            },\n            ...(plugins ? { plugins } : {}),\n        })\n        if (plugins)\n            this.#pluginNames.set(\n                name,\n                plugins.map((plugin) => plugin.name),\n            )\n        return files\n    }\n}\n\n/** Pass NUXT_ credentials explicitly because the AWS SDK resolves its chain after construction. */\nconst withS3NuxtCredentials = (input: unknown): unknown => {\n    if (!input || typeof input !== 'object' || 'credentials' in input) return input\n    if (\n        [\n            'AWS_ACCESS_KEY_ID',\n            'AWS_SECRET_ACCESS_KEY',\n            'AWS_PROFILE',\n            'AWS_WEB_IDENTITY_TOKEN_FILE',\n            'AWS_CONTAINER_CREDENTIALS_RELATIVE_URI',\n            'AWS_CONTAINER_CREDENTIALS_FULL_URI',\n        ].some((key) => process.env[key] !== undefined)\n    )\n        return input\n    const accessKeyId = process.env.NUXT_AWS_ACCESS_KEY_ID\n    const secretAccessKey = process.env.NUXT_AWS_SECRET_ACCESS_KEY\n    if (!accessKeyId || !secretAccessKey) return input\n    return {\n        ...input,\n        credentials: {\n            accessKeyId,\n            secretAccessKey,\n            ...((process.env.AWS_SESSION_TOKEN ?? process.env.NUXT_AWS_SESSION_TOKEN) && {\n                sessionToken: process.env.AWS_SESSION_TOKEN ?? process.env.NUXT_AWS_SESSION_TOKEN,\n            }),\n        },\n    }\n}\n\n/** Bun resolves these environment keys in its own client; pass NUXT_ aliases as explicit options. */\nconst withBunS3NuxtOptions = (input: unknown): unknown => {\n    if (input && (typeof input !== 'object' || 'client' in input)) return input\n    const options: Record<string, unknown> = { ...(typeof input === 'object' && input ? input : {}) }\n    for (const [field, key, alias] of [\n        ['accessKeyId', 'AWS_ACCESS_KEY_ID', 'S3_ACCESS_KEY_ID'],\n        ['secretAccessKey', 'AWS_SECRET_ACCESS_KEY', 'S3_SECRET_ACCESS_KEY'],\n        ['sessionToken', 'AWS_SESSION_TOKEN', 'S3_SESSION_TOKEN'],\n        ['region', 'AWS_REGION', 'S3_REGION'],\n        ['bucket', 'AWS_BUCKET', 'S3_BUCKET'],\n    ] as const) {\n        if (Object.hasOwn(options, field) || process.env[key] !== undefined || process.env[alias] !== undefined)\n            continue\n        const value = process.env[`NUXT_${key}`] ?? process.env[`NUXT_${alias}`]\n        if (value !== undefined) options[field] = value\n    }\n    return options\n}\n\n/** Bridge only NUXT_ aliases declared by the configured native provider during synchronous construction. */\nexport const withNuxtEnvironment = <T>(variables: readonly (readonly string[])[], load: () => T): T => {\n    const injected: string[] = []\n    for (const keys of variables) {\n        if (keys.some((key) => process.env[key] !== undefined)) continue\n        for (const key of keys) {\n            const value = process.env[`NUXT_${key}`]\n            if (value !== undefined && process.env[key] === undefined) {\n                process.env[key] = value\n                injected.push(key)\n            }\n        }\n    }\n    try {\n        return load()\n    } finally {\n        for (const key of injected) delete process.env[key]\n    }\n}\n"],"mappings":"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"}

package/dist/runtime.d.ts

@@ -1,22 +1,21 @@
-import { FilesConfig } from "./config.js";
-import { FilesDevtoolsSnapshot } from "./devtools/snapshot.js";
-import { FilesForStorage, FilesProviderFactories, FilesProviderFactory, FilesRegistry, FilesRuntimeHooks, SingleStorage, StorageRegistry } from "./runtime/registry.js";
-import { Files } from "files-sdk";
+import { FilesForStorage, SingleStorage, StorageRegistry } from "./runtime/registry.js";
+import { Files, SyncOptions, TransferOptions } from "files-sdk";
 //#region src/runtime.d.ts
 /** Project storage names and plugin-extended Files clients supplied by generated declarations. */
 export interface NuxtFilesStorageRegistry {}
 /** Project single Files client supplied by generated declarations. */
 export interface NuxtFilesSingleStorage {}
-/** Configure the process-local Files registry used by {@link useServerFiles}. */
-export declare const configureFiles: <const C extends FilesConfig>(config: C, options: ConstructorParameters<typeof FilesRegistry<C>>[1]) => FilesRegistry<C>;
-/** Return secret-free diagnostics for the configured process-local Files registry. */
-export declare const inspectFiles: () => FilesDevtoolsSnapshot;
 /** Return the project's unnamed Files client, including its configured plugin extensions. */
 export declare function useServerFiles(...args: keyof NuxtFilesStorageRegistry extends never ? [] : [name: never]): NuxtFilesSingleStorage extends {
   value: infer Single;
 } ? Single : Files;
 /** Return a named project Files client, including that storage's configured plugin extensions. */
 export declare function useServerFiles<Name extends Extract<keyof NuxtFilesStorageRegistry, string>>(name: Name): NuxtFilesStorageRegistry[Name];
+type FilesInput<Name extends string = Extract<keyof NuxtFilesStorageRegistry, string>> = Files | Name;
+/** Delegate a mirror operation to the native Files SDK. */
+export declare const syncFiles: (source: FilesInput, destination: FilesInput, options?: SyncOptions) => Promise<import("files-sdk").SyncResult>;
+/** Delegate a transfer operation to the native Files SDK. */
+export declare const transferFiles: (source: FilesInput, destination: FilesInput, options?: TransferOptions) => Promise<import("files-sdk").TransferResult>;
 //#endregion
-export { type FilesForStorage, type FilesProviderFactories, type FilesProviderFactory, FilesRegistry, type FilesRuntimeHooks, type SingleStorage, type StorageRegistry };
+export type { FilesForStorage, SingleStorage, StorageRegistry };
 //# sourceMappingURL=runtime.d.ts.map

package/dist/runtime.js

@@ -1,26 +1,14 @@
-import { FilesRegistry } from "./runtime/registry.js";
+import { getFiles } from "./runtime/internal.js";
+import { sync, transfer } from "files-sdk";
 //#region src/runtime.ts
-let registry;
-/** Configure the process-local Files registry used by {@link useServerFiles}. */
-const configureFiles = (config, options) => {
-	const value = new FilesRegistry(config, options);
-	registry = value;
-	return value;
-};
-/** Return secret-free diagnostics for the configured process-local Files registry. */
-const inspectFiles = () => registry?.inspect() ?? {
-	storages: [],
-	diagnostics: [{
-		code: "NUXT_FILES_NOT_CONFIGURED",
-		level: "warning",
-		message: "The Files registry has not been configured."
-	}]
-};
 function useServerFiles(name) {
-	if (!registry) throw new Error("[nuxt-files-sdk:not-configured] The Files registry has not been configured.");
-	return name === void 0 ? registry.get() : registry.get(name);
+	return getFiles(name);
 }
+/** Delegate a mirror operation to the native Files SDK. */
+const syncFiles = (source, destination, options) => sync(typeof source === "string" ? getFiles(source) : source, typeof destination === "string" ? getFiles(destination) : destination, options);
+/** Delegate a transfer operation to the native Files SDK. */
+const transferFiles = (source, destination, options) => transfer(typeof source === "string" ? getFiles(source) : source, typeof destination === "string" ? getFiles(destination) : destination, options);
 //#endregion
-export { FilesRegistry, configureFiles, inspectFiles, useServerFiles };
+export { syncFiles, transferFiles, useServerFiles };
 
 //# sourceMappingURL=runtime.js.map

package/dist/runtime.js.map

@@ -1 +1 @@
-{"version":3,"file":"runtime.js","names":[],"sources":["../src/runtime.ts"],"sourcesContent":["import type { Files } from 'files-sdk'\n\nimport type { FilesConfig } from './config'\nimport type { FilesDevtoolsSnapshot } from './devtools/snapshot'\nimport { FilesRegistry } from './runtime/registry'\n\nexport { FilesRegistry } from './runtime/registry'\nexport type {\n    FilesForStorage,\n    FilesProviderFactories,\n    FilesProviderFactory,\n    FilesRuntimeHooks,\n    SingleStorage,\n    StorageRegistry,\n} from './runtime/registry'\n\n/** Project storage names and plugin-extended Files clients supplied by generated declarations. */\nexport interface NuxtFilesStorageRegistry {}\n/** Project single Files client supplied by generated declarations. */\nexport interface NuxtFilesSingleStorage {}\n\nlet registry: FilesRegistry | undefined\n\n/** Configure the process-local Files registry used by {@link useServerFiles}. */\nexport const configureFiles = <const C extends FilesConfig>(\n    config: C,\n    options: ConstructorParameters<typeof FilesRegistry<C>>[1],\n): FilesRegistry<C> => {\n    const value = new FilesRegistry(config, options)\n    registry = value\n    return value\n}\n\n/** Return secret-free diagnostics for the configured process-local Files registry. */\nexport const inspectFiles = (): FilesDevtoolsSnapshot =>\n    registry?.inspect() ?? {\n        storages: [],\n        diagnostics: [\n            {\n                code: 'NUXT_FILES_NOT_CONFIGURED',\n                level: 'warning',\n                message: 'The Files registry has not been configured.',\n            },\n        ],\n    }\n\n/** Return the project's unnamed Files client, including its configured plugin extensions. */\nexport function useServerFiles(\n    ...args: keyof NuxtFilesStorageRegistry extends never ? [] : [name: never]\n): NuxtFilesSingleStorage extends { value: infer Single } ? Single : Files\n/** Return a named project Files client, including that storage's configured plugin extensions. */\nexport function useServerFiles<Name extends Extract<keyof NuxtFilesStorageRegistry, string>>(\n    name: Name,\n): NuxtFilesStorageRegistry[Name]\nexport function useServerFiles(name?: string): Files {\n    if (!registry) {\n        throw new Error('[nuxt-files-sdk:not-configured] The Files registry has not been configured.')\n    }\n    return name === undefined ? registry.get() : (registry.get as (storage: string) => Files)(name)\n}\n"],"mappings":";;AAqBA,IAAI;;AAGJ,MAAa,kBACT,QACA,YACmB;CACnB,MAAM,QAAQ,IAAI,cAAc,QAAQ,OAAO;CAC/C,WAAW;CACX,OAAO;AACX;;AAGA,MAAa,qBACT,UAAU,QAAQ,KAAK;CACnB,UAAU,CAAC;CACX,aAAa,CACT;EACI,MAAM;EACN,OAAO;EACP,SAAS;CACb,CACJ;AACJ;AAUJ,SAAgB,eAAe,MAAsB;CACjD,IAAI,CAAC,UACD,MAAM,IAAI,MAAM,6EAA6E;CAEjG,OAAO,SAAS,KAAA,IAAY,SAAS,IAAI,IAAK,SAAS,IAAmC,IAAI;AAClG"}
+{"version":3,"file":"runtime.js","names":[],"sources":["../src/runtime.ts"],"sourcesContent":["import { sync, transfer, type Files, type SyncOptions, type TransferOptions } from 'files-sdk'\n\nimport { getFiles } from './runtime/internal'\n\nexport type { FilesForStorage, SingleStorage, StorageRegistry } from './runtime/registry'\n\n/** Project storage names and plugin-extended Files clients supplied by generated declarations. */\nexport interface NuxtFilesStorageRegistry {}\n/** Project single Files client supplied by generated declarations. */\nexport interface NuxtFilesSingleStorage {}\n\n/** Return the project's unnamed Files client, including its configured plugin extensions. */\nexport function useServerFiles(\n    ...args: keyof NuxtFilesStorageRegistry extends never ? [] : [name: never]\n): NuxtFilesSingleStorage extends { value: infer Single } ? Single : Files\n/** Return a named project Files client, including that storage's configured plugin extensions. */\nexport function useServerFiles<Name extends Extract<keyof NuxtFilesStorageRegistry, string>>(\n    name: Name,\n): NuxtFilesStorageRegistry[Name]\nexport function useServerFiles(name?: string): Files {\n    return getFiles(name)\n}\n\ntype FilesInput<Name extends string = Extract<keyof NuxtFilesStorageRegistry, string>> = Files | Name\n\n/** Delegate a mirror operation to the native Files SDK. */\nexport const syncFiles = (source: FilesInput, destination: FilesInput, options?: SyncOptions) =>\n    sync(\n        typeof source === 'string' ? getFiles(source) : source,\n        typeof destination === 'string' ? getFiles(destination) : destination,\n        options,\n    )\n\n/** Delegate a transfer operation to the native Files SDK. */\nexport const transferFiles = (source: FilesInput, destination: FilesInput, options?: TransferOptions) =>\n    transfer(\n        typeof source === 'string' ? getFiles(source) : source,\n        typeof destination === 'string' ? getFiles(destination) : destination,\n        options,\n    )\n"],"mappings":";;;AAmBA,SAAgB,eAAe,MAAsB;CACjD,OAAO,SAAS,IAAI;AACxB;;AAKA,MAAa,aAAa,QAAoB,aAAyB,YACnE,KACI,OAAO,WAAW,WAAW,SAAS,MAAM,IAAI,QAChD,OAAO,gBAAgB,WAAW,SAAS,WAAW,IAAI,aAC1D,OACJ;;AAGJ,MAAa,iBAAiB,QAAoB,aAAyB,YACvE,SACI,OAAO,WAAW,WAAW,SAAS,MAAM,IAAI,QAChD,OAAO,gBAAgB,WAAW,SAAS,WAAW,IAAI,aAC1D,OACJ"}