nuxt-files-sdk 0.0.1 → 0.0.2

package/dist/config.d.ts

@@ -1,28 +1,34 @@
 import { FilesHooks, FilesPlugin, ProviderSlug } from "files-sdk";
 import { LoadFilesOptions } from "files-sdk/loader";
 //#region src/config.d.ts
+/** Configuration for one named Files SDK storage. */
 export type StorageConfig<Plugins extends readonly FilesPlugin[] = readonly FilesPlugin[]> = Omit<LoadFilesOptions, 'provider'> & {
-  /** Files SDK provider subpath, for example `r2`, `s3`, or `fs`. */
+  /** Files SDK provider slug, for example `r2`, `s3`, or `fs`. */
   adapter: ProviderSlug;
-  /** Native Files SDK plugins, applied in array order. */
+  /** Native Files SDK plugins applied in array order. Their extensions are reflected in the storage type. */
   plugins?: Plugins;
-  /** Native Files SDK hooks. They run before the integration hook bridge. */
+  /** Native Files SDK lifecycle hooks. They run before the Nuxt/Nitro integration hooks. */
   hooks?: FilesHooks;
 };
+/** Development-only connection settings for a storage declared in {@link FilesConfig.storage}. */
 export type DevStorageConfig = Omit<StorageConfig, 'plugins' | 'hooks'> & {
   /** Plugins belong to the logical storage and cannot be replaced in development. */
   plugins?: never;
   /** Hooks belong to the logical storage and cannot be replaced in development. */
   hooks?: never;
 };
+/** Files SDK storages and development overrides used by the Nuxt/Nitro integration. */
 export interface FilesConfig<Storage extends Record<string, StorageConfig> = Record<string, StorageConfig>> {
-  /** Storage used when useServerFiles() is called without a name. */
+  /** Storage used by `useServerFiles()` and `FilesRegistry.get()` when no name is passed. */
   default?: keyof Storage & string;
-  /** Explicit development overrides. These never act as failure fallbacks. */
+  /** Development-only connection overrides keyed by a name in {@link storage}; never used as failure fallbacks. */
   devStorage?: Partial<{ [Name in keyof Storage]: DevStorageConfig; }>;
+  /** Named storages, each initialized lazily on first access. */
   storage: Storage;
 }
-/** Preserve storage names and plugin tuples for generated/project types. */
-export declare const defineFilesConfig: <const Config extends FilesConfig>(config: Config) => Config;
+/** Define a Files SDK configuration while preserving storage names and plugin tuples for generated types. */
+export declare const defineFilesConfig: <const Storage extends Record<string, StorageConfig>, const Config extends FilesConfig<Storage>>(config: Config & FilesConfig<Storage> & {
+  storage: Storage;
+}) => Config;
 //#endregion
 //# sourceMappingURL=config.d.ts.map

package/dist/config.js

@@ -1,5 +1,5 @@
 //#region src/config.ts
-/** Preserve storage names and plugin tuples for generated/project types. */
+/** Define a Files SDK configuration while preserving storage names and plugin tuples for generated types. */
 const defineFilesConfig = (config) => config;
 //#endregion
 export { defineFilesConfig };

package/dist/config.js.map

@@ -1 +1 @@
-{"version":3,"file":"config.js","names":[],"sources":["../src/config.ts"],"sourcesContent":["import type { FilesHooks, FilesPlugin, ProviderSlug } from 'files-sdk'\nimport type { LoadFilesOptions } from 'files-sdk/loader'\n\nexport type StorageConfig<Plugins extends readonly FilesPlugin[] = readonly FilesPlugin[]> = Omit<\n    LoadFilesOptions,\n    'provider'\n> & {\n    /** Files SDK provider subpath, for example `r2`, `s3`, or `fs`. */\n    adapter: ProviderSlug\n    /** Native Files SDK plugins, applied in array order. */\n    plugins?: Plugins\n    /** Native Files SDK hooks. They run before the integration hook bridge. */\n    hooks?: FilesHooks\n}\n\nexport type DevStorageConfig = Omit<StorageConfig, 'plugins' | 'hooks'> & {\n    /** Plugins belong to the logical storage and cannot be replaced in development. */\n    plugins?: never\n    /** Hooks belong to the logical storage and cannot be replaced in development. */\n    hooks?: never\n}\n\nexport interface FilesConfig<Storage extends Record<string, StorageConfig> = Record<string, StorageConfig>> {\n    /** Storage used when useServerFiles() is called without a name. */\n    default?: keyof Storage & string\n    /** Explicit development overrides. These never act as failure fallbacks. */\n    devStorage?: Partial<{ [Name in keyof Storage]: DevStorageConfig }>\n    storage: Storage\n}\n\n/** Preserve storage names and plugin tuples for generated/project types. */\nexport const defineFilesConfig = <const Config extends FilesConfig>(config: Config): Config => config\n"],"mappings":";;AA+BA,MAAa,qBAAuD,WAA2B"}
+{"version":3,"file":"config.js","names":[],"sources":["../src/config.ts"],"sourcesContent":["import type { FilesHooks, FilesPlugin, ProviderSlug } from 'files-sdk'\nimport type { LoadFilesOptions } from 'files-sdk/loader'\n\n/** Configuration for one named Files SDK storage. */\nexport type StorageConfig<Plugins extends readonly FilesPlugin[] = readonly FilesPlugin[]> = Omit<\n    LoadFilesOptions,\n    'provider'\n> & {\n    /** Files SDK provider slug, for example `r2`, `s3`, or `fs`. */\n    adapter: ProviderSlug\n    /** Native Files SDK plugins applied in array order. Their extensions are reflected in the storage type. */\n    plugins?: Plugins\n    /** Native Files SDK lifecycle hooks. They run before the Nuxt/Nitro integration hooks. */\n    hooks?: FilesHooks\n}\n\n/** Development-only connection settings for a storage declared in {@link FilesConfig.storage}. */\nexport type DevStorageConfig = Omit<StorageConfig, 'plugins' | 'hooks'> & {\n    /** Plugins belong to the logical storage and cannot be replaced in development. */\n    plugins?: never\n    /** Hooks belong to the logical storage and cannot be replaced in development. */\n    hooks?: never\n}\n\n/** Files SDK storages and development overrides used by the Nuxt/Nitro integration. */\nexport interface FilesConfig<Storage extends Record<string, StorageConfig> = Record<string, StorageConfig>> {\n    /** Storage used by `useServerFiles()` and `FilesRegistry.get()` when no name is passed. */\n    default?: keyof Storage & string\n    /** Development-only connection overrides keyed by a name in {@link storage}; never used as failure fallbacks. */\n    devStorage?: Partial<{ [Name in keyof Storage]: DevStorageConfig }>\n    /** Named storages, each initialized lazily on first access. */\n    storage: Storage\n}\n\n/** Define a Files SDK configuration while preserving storage names and plugin tuples for generated types. */\nexport const defineFilesConfig = <\n    const Storage extends Record<string, StorageConfig>,\n    const Config extends FilesConfig<Storage>,\n>(\n    config: Config & FilesConfig<Storage> & { storage: Storage },\n): Config => config\n"],"mappings":";;AAmCA,MAAa,qBAIT,WACS"}

package/dist/integration/nitro.d.ts

@@ -12,6 +12,14 @@ export interface NitroIntegration {
       inline?: unknown[];
     };
   };
+  unimport?: {
+    getInternalContext(): {
+      addons: {
+        name?: string;
+        declaration?: (declarations: string) => string;
+      }[];
+    };
+  };
   hooks: {
     hook(name: 'types:extend', callback: (types: {
       tsConfig?: {

package/dist/integration/nitro.js

@@ -22,6 +22,10 @@ export {}
 `;
 const setupNitroFilesIntegration = async (nitro, options) => {
 	const configPath = options.configPath.replaceAll("\\", "/");
+	nitro.unimport?.getInternalContext().addons.push({
+		name: "nuxt-files-sdk-jsdoc",
+		declaration: (declarations) => declarations.replace(/^(\s*)(const useServerFiles: typeof .*\.useServerFiles)$/mu, "$1/** Return the project's default Files client, including its configured plugin extensions. */\n$1$2")
+	});
 	const externals = nitro.options.externals ??= {};
 	(externals.inline ??= []).push("nuxt-files-sdk");
 	if (!nitro.options.dev) externals.inline.push("files-sdk");

package/dist/integration/nitro.js.map

@@ -1 +1 @@
-{"version":3,"file":"nitro.js","names":[],"sources":["../../src/integration/nitro.ts"],"sourcesContent":["import { mkdir, writeFile } from 'node:fs/promises'\nimport { resolve } from 'node:path'\n\nexport interface NitroIntegration {\n    meta?: { majorVersion?: number }\n    options: { rootDir: string; buildDir: string; dev?: boolean; plugins: string[]; externals?: { inline?: unknown[] } }\n    hooks: {\n        hook(\n            name: 'types:extend',\n            callback: (types: { tsConfig?: { include?: string[] } }) => void | Promise<void>,\n        ): void\n    }\n}\n\nexport interface NitroFilesIntegrationOptions {\n    configPath: string\n    development: boolean\n}\n\nconst hookTypes = (moduleName: 'nitropack/types' | 'nitro/types'): string => `\ndeclare module ${JSON.stringify(moduleName)} {\n  interface NitroRuntimeHooks {\n    'files:action': (payload: { event: import('files-sdk').FilesActionEvent; storage: string }) => void | Promise<void>\n    'files:error': (payload: { event: import('files-sdk').FilesErrorEvent; storage: string }) => void | Promise<void>\n    'files:retry': (payload: { event: import('files-sdk').FilesRetryEvent; storage: string }) => void | Promise<void>\n  }\n}\n`\n\nexport const storageTypes = (\n    configPath: string,\n    nitroMajor: number,\n): string => `import type config from ${JSON.stringify(configPath)}\nimport type { DefaultStorage, StorageRegistry } from 'nuxt-files-sdk/runtime'\n\ndeclare module 'nuxt-files-sdk/runtime' {\n  interface NuxtFilesStorageRegistry extends StorageRegistry<typeof config> {}\n  interface NuxtFilesDefaultStorage { value: DefaultStorage<typeof config> }\n}\n${hookTypes(nitroMajor >= 3 ? 'nitro/types' : 'nitropack/types')}\nexport {}\n`\n\nexport const setupNitroFilesIntegration = async (\n    nitro: NitroIntegration,\n    options: NitroFilesIntegrationOptions,\n): Promise<void> => {\n    const configPath = options.configPath.replaceAll('\\\\', '/')\n    // Inline both packages so installed consumers also tree-shake the plugin barrel.\n    const externals = (nitro.options.externals ??= {})\n    ;(externals.inline ??= []).push('nuxt-files-sdk')\n    // Nitro's single-file dev build would eagerly import every native provider SDK.\n    if (!nitro.options.dev) externals.inline.push('files-sdk')\n    const directory = resolve(nitro.options.buildDir, 'nuxt-files-sdk')\n    const pluginPath = resolve(directory, 'plugin.mjs')\n    const typesPath = resolve(directory, 'storage-registry.d.ts')\n    // Development also externalizes local .mjs files unless explicitly inlined.\n    externals.inline.push(pluginPath.replaceAll('\\\\', '/'), configPath)\n    nitro.options.plugins.push(pluginPath.replaceAll('\\\\', '/'))\n    nitro.hooks.hook('types:extend', async (types) => {\n        await mkdir(directory, { recursive: true })\n        await Promise.all([\n            writeFile(\n                pluginPath,\n                `import config from ${JSON.stringify(configPath)}\nimport { configureFiles } from 'nuxt-files-sdk/runtime'\n\nexport default (nitroApp) => configureFiles(config, {\n  development: ${JSON.stringify(options.development)},\n  hooks: {\n    onAction: (event, storage) => nitroApp.hooks.callHook('files:action', { event, storage }),\n    onError: (event, storage) => nitroApp.hooks.callHook('files:error', { event, storage }),\n    onRetry: (event, storage) => nitroApp.hooks.callHook('files:retry', { event, storage }),\n  },\n})\n`,\n            ),\n            // Older v2 and current v3 omit meta; only v3 exposes the routing API.\n            writeFile(typesPath, storageTypes(configPath, nitro.meta?.majorVersion ?? ('routing' in nitro ? 3 : 2))),\n        ])\n        types.tsConfig?.include?.push(typesPath)\n    })\n}\n"],"mappings":";;;AAmBA,MAAM,aAAa,eAA0D;iBAC5D,KAAK,UAAU,UAAU,EAAE;;;;;;;;AAS5C,MAAa,gBACT,YACA,eACS,2BAA2B,KAAK,UAAU,UAAU,EAAE;;;;;;;EAOjE,UAAU,cAAc,IAAI,gBAAgB,iBAAiB,EAAE;;;AAIjE,MAAa,6BAA6B,OACtC,OACA,YACgB;CAChB,MAAM,aAAa,QAAQ,WAAW,WAAW,MAAM,GAAG;CAE1D,MAAM,YAAa,MAAM,QAAQ,cAAc,CAAC;CAC/C,CAAC,UAAU,WAAW,CAAC,EAAA,CAAG,KAAK,gBAAgB;CAEhD,IAAI,CAAC,MAAM,QAAQ,KAAK,UAAU,OAAO,KAAK,WAAW;CACzD,MAAM,YAAY,QAAQ,MAAM,QAAQ,UAAU,gBAAgB;CAClE,MAAM,aAAa,QAAQ,WAAW,YAAY;CAClD,MAAM,YAAY,QAAQ,WAAW,uBAAuB;CAE5D,UAAU,OAAO,KAAK,WAAW,WAAW,MAAM,GAAG,GAAG,UAAU;CAClE,MAAM,QAAQ,QAAQ,KAAK,WAAW,WAAW,MAAM,GAAG,CAAC;CAC3D,MAAM,MAAM,KAAK,gBAAgB,OAAO,UAAU;EAC9C,MAAM,MAAM,WAAW,EAAE,WAAW,KAAK,CAAC;EAC1C,MAAM,QAAQ,IAAI,CACd,UACI,YACA,sBAAsB,KAAK,UAAU,UAAU,EAAE;;;;iBAIhD,KAAK,UAAU,QAAQ,WAAW,EAAE;;;;;;;CAQzC,GAEA,UAAU,WAAW,aAAa,YAAY,MAAM,MAAM,iBAAiB,aAAa,QAAQ,IAAI,EAAE,CAAC,CAC3G,CAAC;EACD,MAAM,UAAU,SAAS,KAAK,SAAS;CAC3C,CAAC;AACL"}
+{"version":3,"file":"nitro.js","names":[],"sources":["../../src/integration/nitro.ts"],"sourcesContent":["import { mkdir, writeFile } from 'node:fs/promises'\nimport { resolve } from 'node:path'\n\nexport interface NitroIntegration {\n    meta?: { majorVersion?: number }\n    options: { rootDir: string; buildDir: string; dev?: boolean; plugins: string[]; externals?: { inline?: unknown[] } }\n    unimport?: {\n        getInternalContext(): {\n            addons: {\n                name?: string\n                declaration?: (declarations: string) => string\n            }[]\n        }\n    }\n    hooks: {\n        hook(\n            name: 'types:extend',\n            callback: (types: { tsConfig?: { include?: string[] } }) => void | Promise<void>,\n        ): void\n    }\n}\n\nexport interface NitroFilesIntegrationOptions {\n    configPath: string\n    development: boolean\n}\n\nconst hookTypes = (moduleName: 'nitropack/types' | 'nitro/types'): string => `\ndeclare module ${JSON.stringify(moduleName)} {\n  interface NitroRuntimeHooks {\n    'files:action': (payload: { event: import('files-sdk').FilesActionEvent; storage: string }) => void | Promise<void>\n    'files:error': (payload: { event: import('files-sdk').FilesErrorEvent; storage: string }) => void | Promise<void>\n    'files:retry': (payload: { event: import('files-sdk').FilesRetryEvent; storage: string }) => void | Promise<void>\n  }\n}\n`\n\nexport const storageTypes = (\n    configPath: string,\n    nitroMajor: number,\n): string => `import type config from ${JSON.stringify(configPath)}\nimport type { DefaultStorage, StorageRegistry } from 'nuxt-files-sdk/runtime'\n\ndeclare module 'nuxt-files-sdk/runtime' {\n  interface NuxtFilesStorageRegistry extends StorageRegistry<typeof config> {}\n  interface NuxtFilesDefaultStorage { value: DefaultStorage<typeof config> }\n}\n${hookTypes(nitroMajor >= 3 ? 'nitro/types' : 'nitropack/types')}\nexport {}\n`\n\nexport const setupNitroFilesIntegration = async (\n    nitro: NitroIntegration,\n    options: NitroFilesIntegrationOptions,\n): Promise<void> => {\n    const configPath = options.configPath.replaceAll('\\\\', '/')\n    nitro.unimport?.getInternalContext().addons.push({\n        name: 'nuxt-files-sdk-jsdoc',\n        declaration: (declarations) =>\n            declarations.replace(\n                /^(\\s*)(const useServerFiles: typeof .*\\.useServerFiles)$/mu,\n                \"$1/** Return the project's default Files client, including its configured plugin extensions. */\\n$1$2\",\n            ),\n    })\n    // Inline both packages so installed consumers also tree-shake the plugin barrel.\n    const externals = (nitro.options.externals ??= {})\n    ;(externals.inline ??= []).push('nuxt-files-sdk')\n    // Nitro's single-file dev build would eagerly import every native provider SDK.\n    if (!nitro.options.dev) externals.inline.push('files-sdk')\n    const directory = resolve(nitro.options.buildDir, 'nuxt-files-sdk')\n    const pluginPath = resolve(directory, 'plugin.mjs')\n    const typesPath = resolve(directory, 'storage-registry.d.ts')\n    // Development also externalizes local .mjs files unless explicitly inlined.\n    externals.inline.push(pluginPath.replaceAll('\\\\', '/'), configPath)\n    nitro.options.plugins.push(pluginPath.replaceAll('\\\\', '/'))\n    nitro.hooks.hook('types:extend', async (types) => {\n        await mkdir(directory, { recursive: true })\n        await Promise.all([\n            writeFile(\n                pluginPath,\n                `import config from ${JSON.stringify(configPath)}\nimport { configureFiles } from 'nuxt-files-sdk/runtime'\n\nexport default (nitroApp) => configureFiles(config, {\n  development: ${JSON.stringify(options.development)},\n  hooks: {\n    onAction: (event, storage) => nitroApp.hooks.callHook('files:action', { event, storage }),\n    onError: (event, storage) => nitroApp.hooks.callHook('files:error', { event, storage }),\n    onRetry: (event, storage) => nitroApp.hooks.callHook('files:retry', { event, storage }),\n  },\n})\n`,\n            ),\n            // Older v2 and current v3 omit meta; only v3 exposes the routing API.\n            writeFile(typesPath, storageTypes(configPath, nitro.meta?.majorVersion ?? ('routing' in nitro ? 3 : 2))),\n        ])\n        types.tsConfig?.include?.push(typesPath)\n    })\n}\n"],"mappings":";;;AA2BA,MAAM,aAAa,eAA0D;iBAC5D,KAAK,UAAU,UAAU,EAAE;;;;;;;;AAS5C,MAAa,gBACT,YACA,eACS,2BAA2B,KAAK,UAAU,UAAU,EAAE;;;;;;;EAOjE,UAAU,cAAc,IAAI,gBAAgB,iBAAiB,EAAE;;;AAIjE,MAAa,6BAA6B,OACtC,OACA,YACgB;CAChB,MAAM,aAAa,QAAQ,WAAW,WAAW,MAAM,GAAG;CAC1D,MAAM,UAAU,mBAAmB,CAAC,CAAC,OAAO,KAAK;EAC7C,MAAM;EACN,cAAc,iBACV,aAAa,QACT,8DACA,uGACJ;CACR,CAAC;CAED,MAAM,YAAa,MAAM,QAAQ,cAAc,CAAC;CAC/C,CAAC,UAAU,WAAW,CAAC,EAAA,CAAG,KAAK,gBAAgB;CAEhD,IAAI,CAAC,MAAM,QAAQ,KAAK,UAAU,OAAO,KAAK,WAAW;CACzD,MAAM,YAAY,QAAQ,MAAM,QAAQ,UAAU,gBAAgB;CAClE,MAAM,aAAa,QAAQ,WAAW,YAAY;CAClD,MAAM,YAAY,QAAQ,WAAW,uBAAuB;CAE5D,UAAU,OAAO,KAAK,WAAW,WAAW,MAAM,GAAG,GAAG,UAAU;CAClE,MAAM,QAAQ,QAAQ,KAAK,WAAW,WAAW,MAAM,GAAG,CAAC;CAC3D,MAAM,MAAM,KAAK,gBAAgB,OAAO,UAAU;EAC9C,MAAM,MAAM,WAAW,EAAE,WAAW,KAAK,CAAC;EAC1C,MAAM,QAAQ,IAAI,CACd,UACI,YACA,sBAAsB,KAAK,UAAU,UAAU,EAAE;;;;iBAIhD,KAAK,UAAU,QAAQ,WAAW,EAAE;;;;;;;CAQzC,GAEA,UAAU,WAAW,aAAa,YAAY,MAAM,MAAM,iBAAiB,aAAa,QAAQ,IAAI,EAAE,CAAC,CAC3G,CAAC;EACD,MAAM,UAAU,SAAS,KAAK,SAAS;CAC3C,CAAC;AACL"}

package/dist/module.d.ts

@@ -8,12 +8,14 @@ declare module '@nuxt/schema' {
     'nitro:init': (nitro: NitroIntegration) => void | Promise<void>;
   }
 }
+/** Options for the Nuxt Files SDK module. */
 export interface ModuleOptions {
-  /** Files configuration path, relative to the Nuxt root. */
+  /** Path to the Files configuration module, relative to the Nuxt root directory. */
   config: string;
-  /** Enable development diagnostics integrations. */
+  /** Enable Files SDK development diagnostics when Nuxt DevTools is available. */
   devtools: boolean;
 }
+/** Install Files SDK storage configuration, server utilities, Vue composables, and development diagnostics in Nuxt. */
 declare const _default: import("@nuxt/schema").NuxtModule<ModuleOptions, ModuleOptions, false>;
 //#endregion
 export { type DefaultStorage, type DefaultStorageName, type FilesForStorage, FilesRegistry, type FilesRuntimeHooks, NuxtFilesDefaultStorage, NuxtFilesStorageRegistry, type StorageRegistry, configureFiles, _default as default, inspectFiles, useServerFiles };

package/dist/module.js

@@ -6,6 +6,7 @@ import { resolve } from "node:path";
 import { addImports, addServerImports, defineNuxtModule, getNuxtModuleVersion } from "@nuxt/kit";
 export * from "files-sdk";
 //#region src/module.ts
+/** Install Files SDK storage configuration, server utilities, Vue composables, and development diagnostics in Nuxt. */
 var module_default = defineNuxtModule({
 	meta: {
 		name: "nuxt-files-sdk",

package/dist/module.js.map

@@ -1 +1 @@
-{"version":3,"file":"module.js","names":[],"sources":["../src/module.ts"],"sourcesContent":["import { resolve } from 'node:path'\n\nimport { addImports, addServerImports, defineNuxtModule, getNuxtModuleVersion } from '@nuxt/kit'\nimport type { Nuxt } from '@nuxt/schema'\n\nimport { shouldEnableFilesDevtools } from './devtools/enabled'\nimport { setupNitroFilesIntegration, type NitroIntegration } from './integration/nitro'\n\ndeclare module '@nuxt/schema' {\n    interface NuxtHooks {\n        'nitro:init': (nitro: NitroIntegration) => void | Promise<void>\n    }\n}\n\nexport interface ModuleOptions {\n    /** Files configuration path, relative to the Nuxt root. */\n    config: string\n    /** Enable development diagnostics integrations. */\n    devtools: boolean\n}\n\nexport default defineNuxtModule<ModuleOptions>({\n    meta: {\n        name: 'nuxt-files-sdk',\n        configKey: 'files',\n        compatibility: { nuxt: '^4.0.0 || ^5.0.0' },\n    },\n    defaults: {\n        config: 'files.config.ts',\n        devtools: true,\n    },\n    async setup(options, nuxt: Nuxt) {\n        const configPath = resolve(nuxt.options.rootDir, options.config)\n        nuxt.hook('nitro:init', (nitro) =>\n            setupNitroFilesIntegration(nitro, {\n                configPath,\n                development: nuxt.options.dev,\n            }),\n        )\n        nuxt.hook('prepare:types', ({ references }) => {\n            references.push({ path: resolve(nuxt.options.buildDir, 'nuxt-files-sdk/storage-registry.d.ts') })\n        })\n\n        addServerImports({ name: 'useServerFiles', from: 'nuxt-files-sdk/runtime' })\n        for (const name of ['useFiles', 'useFile', 'useList', 'useSearch']) {\n            addImports({ name, from: 'files-sdk/vue' })\n        }\n\n        if (shouldEnableFilesDevtools(nuxt.options.dev, options.devtools, nuxt.options.devtools)) {\n            const version = await getNuxtModuleVersion('@nuxt/devtools', nuxt)\n            const { setupFilesDevtools } = await import('./devtools')\n            setupFilesDevtools(nuxt, version || '3')\n        }\n    },\n})\n\nexport * from 'files-sdk'\nexport * from './runtime'\n"],"mappings":";;;;;;;;AAqBA,IAAA,iBAAe,iBAAgC;CAC3C,MAAM;EACF,MAAM;EACN,WAAW;EACX,eAAe,EAAE,MAAM,mBAAmB;CAC9C;CACA,UAAU;EACN,QAAQ;EACR,UAAU;CACd;CACA,MAAM,MAAM,SAAS,MAAY;EAC7B,MAAM,aAAa,QAAQ,KAAK,QAAQ,SAAS,QAAQ,MAAM;EAC/D,KAAK,KAAK,eAAe,UACrB,2BAA2B,OAAO;GAC9B;GACA,aAAa,KAAK,QAAQ;EAC9B,CAAC,CACL;EACA,KAAK,KAAK,kBAAkB,EAAE,iBAAiB;GAC3C,WAAW,KAAK,EAAE,MAAM,QAAQ,KAAK,QAAQ,UAAU,sCAAsC,EAAE,CAAC;EACpG,CAAC;EAED,iBAAiB;GAAE,MAAM;GAAkB,MAAM;EAAyB,CAAC;EAC3E,KAAK,MAAM,QAAQ;GAAC;GAAY;GAAW;GAAW;EAAW,GAC7D,WAAW;GAAE;GAAM,MAAM;EAAgB,CAAC;EAG9C,IAAI,0BAA0B,KAAK,QAAQ,KAAK,QAAQ,UAAU,KAAK,QAAQ,QAAQ,GAAG;GACtF,MAAM,UAAU,MAAM,qBAAqB,kBAAkB,IAAI;GACjE,MAAM,EAAE,uBAAuB,MAAM,OAAO;GAC5C,mBAAmB,MAAM,WAAW,GAAG;EAC3C;CACJ;AACJ,CAAC"}
+{"version":3,"file":"module.js","names":[],"sources":["../src/module.ts"],"sourcesContent":["import { resolve } from 'node:path'\n\nimport { addImports, addServerImports, defineNuxtModule, getNuxtModuleVersion } from '@nuxt/kit'\nimport type { Nuxt } from '@nuxt/schema'\n\nimport { shouldEnableFilesDevtools } from './devtools/enabled'\nimport { setupNitroFilesIntegration, type NitroIntegration } from './integration/nitro'\n\ndeclare module '@nuxt/schema' {\n    interface NuxtHooks {\n        'nitro:init': (nitro: NitroIntegration) => void | Promise<void>\n    }\n}\n\n/** Options for the Nuxt Files SDK module. */\nexport interface ModuleOptions {\n    /** Path to the Files configuration module, relative to the Nuxt root directory. */\n    config: string\n    /** Enable Files SDK development diagnostics when Nuxt DevTools is available. */\n    devtools: boolean\n}\n\n/** Install Files SDK storage configuration, server utilities, Vue composables, and development diagnostics in Nuxt. */\nexport default defineNuxtModule<ModuleOptions>({\n    meta: {\n        name: 'nuxt-files-sdk',\n        configKey: 'files',\n        compatibility: { nuxt: '^4.0.0 || ^5.0.0' },\n    },\n    defaults: {\n        config: 'files.config.ts',\n        devtools: true,\n    },\n    async setup(options, nuxt: Nuxt) {\n        const configPath = resolve(nuxt.options.rootDir, options.config)\n        nuxt.hook('nitro:init', (nitro) =>\n            setupNitroFilesIntegration(nitro, {\n                configPath,\n                development: nuxt.options.dev,\n            }),\n        )\n        nuxt.hook('prepare:types', ({ references }) => {\n            references.push({ path: resolve(nuxt.options.buildDir, 'nuxt-files-sdk/storage-registry.d.ts') })\n        })\n\n        addServerImports({ name: 'useServerFiles', from: 'nuxt-files-sdk/runtime' })\n        for (const name of ['useFiles', 'useFile', 'useList', 'useSearch']) {\n            addImports({ name, from: 'files-sdk/vue' })\n        }\n\n        if (shouldEnableFilesDevtools(nuxt.options.dev, options.devtools, nuxt.options.devtools)) {\n            const version = await getNuxtModuleVersion('@nuxt/devtools', nuxt)\n            const { setupFilesDevtools } = await import('./devtools')\n            setupFilesDevtools(nuxt, version || '3')\n        }\n    },\n})\n\nexport * from 'files-sdk'\nexport * from './runtime'\n"],"mappings":";;;;;;;;;AAuBA,IAAA,iBAAe,iBAAgC;CAC3C,MAAM;EACF,MAAM;EACN,WAAW;EACX,eAAe,EAAE,MAAM,mBAAmB;CAC9C;CACA,UAAU;EACN,QAAQ;EACR,UAAU;CACd;CACA,MAAM,MAAM,SAAS,MAAY;EAC7B,MAAM,aAAa,QAAQ,KAAK,QAAQ,SAAS,QAAQ,MAAM;EAC/D,KAAK,KAAK,eAAe,UACrB,2BAA2B,OAAO;GAC9B;GACA,aAAa,KAAK,QAAQ;EAC9B,CAAC,CACL;EACA,KAAK,KAAK,kBAAkB,EAAE,iBAAiB;GAC3C,WAAW,KAAK,EAAE,MAAM,QAAQ,KAAK,QAAQ,UAAU,sCAAsC,EAAE,CAAC;EACpG,CAAC;EAED,iBAAiB;GAAE,MAAM;GAAkB,MAAM;EAAyB,CAAC;EAC3E,KAAK,MAAM,QAAQ;GAAC;GAAY;GAAW;GAAW;EAAW,GAC7D,WAAW;GAAE;GAAM,MAAM;EAAgB,CAAC;EAG9C,IAAI,0BAA0B,KAAK,QAAQ,KAAK,QAAQ,UAAU,KAAK,QAAQ,QAAQ,GAAG;GACtF,MAAM,UAAU,MAAM,qBAAqB,kBAAkB,IAAI;GACjE,MAAM,EAAE,uBAAuB,MAAM,OAAO;GAC5C,mBAAmB,MAAM,WAAW,GAAG;EAC3C;CACJ;AACJ,CAAC"}

package/dist/package.js

@@ -1,5 +1,5 @@
 //#region package.json
-var version = "0.0.1";
+var version = "0.0.2";
 //#endregion
 export { version };
 

package/dist/runtime/registry.d.ts

@@ -2,25 +2,41 @@ import { FilesConfig, StorageConfig } from "../config.js";
 import { FilesDevtoolsSnapshot } from "../devtools/snapshot.js";
 import { 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']>>;
+/** Map each configured storage name to its native Files client and plugin extensions. */
 export type StorageRegistry<C extends FilesConfig> = { [Name in keyof C['storage']]: FilesForStorage<C['storage'][Name]>; };
 type IsUnion<T, C = T> = T extends C ? ([C] extends [T] ? false : true) : never;
+/** Resolve the explicit, conventional, or only storage name used by an unnamed access. */
 export type DefaultStorageName<C extends FilesConfig> = C extends {
   default: infer Name extends Extract<keyof C['storage'], string>;
 } ? Name : 'default' extends keyof C['storage'] ? 'default' : IsUnion<Extract<keyof C['storage'], string>> extends false ? Extract<keyof C['storage'], string> : never;
+/** Files client and plugin extensions returned for a configuration's default storage. */
 export type DefaultStorage<C extends FilesConfig> = StorageRegistry<C>[DefaultStorageName<C>];
+/** Hooks emitted by the Nuxt/Nitro bridge after the storage's native hooks. */
 export interface FilesRuntimeHooks {
+  /** Observe a failed native Files operation. */
   onError?: (event: FilesErrorEvent, storage: string) => void | Promise<void>;
+  /** Observe a completed native Files operation. */
   onAction?: (event: FilesActionEvent, storage: string) => void | Promise<void>;
+  /** Observe a native Files retry. */
   onRetry?: (event: FilesRetryEvent, storage: string) => void | Promise<void>;
 }
+/** Lazily initialize and memoize native Files clients for a validated project configuration. */
 export declare class FilesRegistry<const C extends FilesConfig = FilesConfig> {
   #private;
+  /**
+   * Create a registry and validate storage references without initializing or connecting to a provider.
+   */
   constructor(config: C, options?: {
     development?: boolean;
     hooks?: FilesRuntimeHooks;
   });
-  get<Name extends keyof C['storage'] & string>(name?: Name): Promise<StorageRegistry<C>[Name]>;
+  /** Return the default storage, sharing its in-flight initialization Promise. */
+  get(name?: undefined): Promise<DefaultStorage<C>>;
+  /** Return a named storage with its plugin extensions, sharing its in-flight initialization Promise. */
+  get<Name extends keyof C['storage'] & string>(name: Name): Promise<StorageRegistry<C>[Name]>;
+  /** Return secret-free storage metadata and initialization state for development diagnostics. */
   inspect(): FilesDevtoolsSnapshot;
 }
 //#endregion

package/dist/runtime/registry.js

@@ -7,13 +7,18 @@ const runHooks = async (...hooks) => {
 		await hook();
 	} catch {}
 };
+/** Lazily initialize and memoize native Files clients for a validated project configuration. */
 var FilesRegistry = class {
 	#config;
 	#development;
 	#hooks;
 	#instances = /* @__PURE__ */ new Map();
+	/**
+	* Create a registry and validate storage references without initializing or connecting to a provider.
+	*/
 	constructor(config, options = {}) {
 		if (!config.storage || Object.keys(config.storage).length === 0) throw new Error("[nuxt-files-sdk:invalid-config] At least one storage is required.");
+		for (const name of [config.default, ...Object.keys(config.devStorage ?? {})]) if (name !== void 0 && !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.#hooks = options.hooks ?? {};
@@ -29,6 +34,7 @@ var FilesRegistry = class {
 		}
 		return instance;
 	}
+	/** Return secret-free storage metadata and initialization state for development diagnostics. */
 	inspect() {
 		return {
 			storages: Object.entries(this.#config.storage).map(([name, storage]) => {
@@ -45,7 +51,7 @@ var FilesRegistry = class {
 		};
 	}
 	#defaultName() {
-		if (this.#config.default) return this.#config.default;
+		if (this.#config.default !== void 0) return this.#config.default;
 		const names = Object.keys(this.#config.storage);
 		if (names.length === 1 && names[0]) return names[0];
 		if (Object.hasOwn(this.#config.storage, "default")) return "default";

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 ExtensionsOf,\n    type Files,\n    type FilesActionEvent,\n    type FilesErrorEvent,\n    type FilesRetryEvent,\n    type ProviderSlug,\n} from 'files-sdk'\nimport { loadFiles } from 'files-sdk/loader'\nimport { getProvider, listEnvVars } from 'files-sdk/providers'\n\nimport type { FilesConfig, StorageConfig } from '../config'\nimport type { FilesDevtoolsSnapshot } from '../devtools/snapshot'\n\nexport type FilesForStorage<T extends StorageConfig> = Files & ExtensionsOf<NonNullable<T['plugins']>>\n\nexport type StorageRegistry<C extends FilesConfig> = {\n    [Name in keyof C['storage']]: FilesForStorage<C['storage'][Name]>\n}\n\ntype IsUnion<T, C = T> = T extends C ? ([C] extends [T] ? false : true) : never\n\nexport type DefaultStorageName<C extends FilesConfig> = C extends {\n    default: infer Name extends Extract<keyof C['storage'], string>\n}\n    ? Name\n    : 'default' extends keyof C['storage']\n      ? 'default'\n      : IsUnion<Extract<keyof C['storage'], string>> extends false\n        ? Extract<keyof C['storage'], string>\n        : never\n\nexport type DefaultStorage<C extends FilesConfig> = StorageRegistry<C>[DefaultStorageName<C>]\n\nexport interface FilesRuntimeHooks {\n    onError?: (event: FilesErrorEvent, storage: string) => void | Promise<void>\n    onAction?: (event: FilesActionEvent, storage: string) => void | Promise<void>\n    onRetry?: (event: FilesRetryEvent, storage: string) => void | Promise<void>\n}\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\nexport class FilesRegistry<const C extends FilesConfig = FilesConfig> {\n    readonly #config: C\n    readonly #development: boolean\n    readonly #hooks: FilesRuntimeHooks\n    readonly #instances = new Map<string, Promise<Files>>()\n\n    constructor(config: C, options: { development?: boolean; hooks?: FilesRuntimeHooks } = {}) {\n        if (!config.storage || Object.keys(config.storage).length === 0) {\n            throw new Error('[nuxt-files-sdk:invalid-config] At least one storage is required.')\n        }\n        this.#config = config\n        this.#development = options.development ?? false\n        this.#hooks = options.hooks ?? {}\n    }\n\n    get<Name extends keyof C['storage'] & string>(name?: Name): Promise<StorageRegistry<C>[Name]> {\n        const resolvedName = name ?? this.#defaultName()\n        if (!Object.hasOwn(this.#config.storage, resolvedName)) {\n            throw new Error(`[nuxt-files-sdk:unknown-storage] Unknown storage \"${resolvedName}\".`)\n        }\n        let instance = this.#instances.get(resolvedName)\n        if (!instance) {\n            instance = this.#create(resolvedName)\n            this.#instances.set(resolvedName, instance)\n            void instance.catch(() => this.#instances.delete(resolvedName))\n        }\n        // The instance is created from the same named config; the loader cannot express that link.\n        // oxlint-disable-next-line typescript/no-unsafe-type-assertion\n        return instance as Promise<StorageRegistry<C>[Name]>\n    }\n\n    inspect(): FilesDevtoolsSnapshot {\n        return {\n            storages: Object.entries(this.#config.storage).map(([name, storage]) => {\n                const override = this.#development ? this.#config.devStorage?.[name] : undefined\n                return {\n                    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            }),\n            diagnostics: [],\n        }\n    }\n\n    #defaultName(): string {\n        if (this.#config.default) return this.#config.default\n        const names = Object.keys(this.#config.storage)\n        if (names.length === 1 && names[0]) return names[0]\n        if (Object.hasOwn(this.#config.storage, 'default')) return 'default'\n        throw new Error('[nuxt-files-sdk:storage-name-required] A storage name is required.')\n    }\n\n    async #create(name: string): Promise<Files> {\n        const base = this.#config.storage[name]\n        const override = this.#development ? this.#config.devStorage?.[name] : undefined\n        const selected = override ? { ...base, ...override, plugins: base?.plugins, hooks: base?.hooks } : base\n        if (!selected) throw new Error(`[nuxt-files-sdk:unknown-storage] Unknown storage \"${name}\".`)\n        const { adapter, plugins, hooks: userHooks, ...options } = selected\n        const loaded = await withNuxtEnvironment(adapter, () => loadFiles({ ...options, provider: adapter }))\n        // The upstream loader has no hooks/plugins input. Avoid rebuilding the\n        // native instance unless those native capabilities are actually used.\n        if (!plugins && !userHooks && !Object.values(this.#hooks).some(Boolean)) return loaded.files\n        return createFiles({\n            adapter: loaded.files.adapter,\n            hooks: {\n                onAction: (event) =>\n                    runHooks(\n                        () => userHooks?.onAction?.(event),\n                        () => this.#hooks.onAction?.(event, name),\n                    ),\n                onError: (event) =>\n                    runHooks(\n                        () => userHooks?.onError?.(event),\n                        () => this.#hooks.onError?.(event, name),\n                    ),\n                onRetry: (event) =>\n                    runHooks(\n                        () => userHooks?.onRetry?.(event),\n                        () => this.#hooks.onRetry?.(event, name),\n                    ),\n            },\n            ...(plugins ? { plugins } : {}),\n            ...(options.prefix === undefined ? {} : { prefix: options.prefix }),\n            ...(options.retries === undefined ? {} : { retries: options.retries }),\n            ...(options.timeout === undefined ? {} : { timeout: options.timeout }),\n        })\n    }\n}\n\nlet environmentLock = Promise.resolve()\n\n/** Bridge only NUXT_ aliases declared by the configured native provider. */\nexport const withNuxtEnvironment = async <T>(provider: ProviderSlug, load: () => Promise<T>): Promise<T> => {\n    const metadata = getProvider(provider)\n    if (!metadata) return load()\n    const variables = listEnvVars(provider)\n    if (variables.length === 0) return load()\n    // ponytail: module-local env lock; use native env keys to avoid temporary aliases.\n    const previous = environmentLock\n    let release!: () => void\n    environmentLock = new Promise<void>((resolveLock) => (release = resolveLock))\n    await previous\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 await load()\n    } finally {\n        for (const key of injected) delete process.env[key]\n        release()\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 ExtensionsOf,\n    type Files,\n    type FilesActionEvent,\n    type FilesErrorEvent,\n    type FilesRetryEvent,\n    type ProviderSlug,\n} from 'files-sdk'\nimport { loadFiles } from 'files-sdk/loader'\nimport { getProvider, listEnvVars } from 'files-sdk/providers'\n\nimport type { FilesConfig, 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    [Name in keyof C['storage']]: FilesForStorage<C['storage'][Name]>\n}\n\ntype IsUnion<T, C = T> = T extends C ? ([C] extends [T] ? false : true) : never\n\n/** Resolve the explicit, conventional, or only storage name used by an unnamed access. */\nexport type DefaultStorageName<C extends FilesConfig> = C extends {\n    default: infer Name extends Extract<keyof C['storage'], string>\n}\n    ? Name\n    : 'default' extends keyof C['storage']\n      ? 'default'\n      : IsUnion<Extract<keyof C['storage'], string>> extends false\n        ? Extract<keyof C['storage'], string>\n        : never\n\n/** Files client and plugin extensions returned for a configuration's default storage. */\nexport type DefaultStorage<C extends FilesConfig> = StorageRegistry<C>[DefaultStorageName<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\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\n/** Lazily initialize 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 #hooks: FilesRuntimeHooks\n    readonly #instances = new Map<string, Promise<Files>>()\n\n    /**\n     * Create a registry and validate storage references without initializing or connecting to a provider.\n     */\n    constructor(config: C, options: { development?: boolean; hooks?: FilesRuntimeHooks } = {}) {\n        if (!config.storage || Object.keys(config.storage).length === 0) {\n            throw new Error('[nuxt-files-sdk:invalid-config] At least one storage is required.')\n        }\n        for (const name of [config.default, ...Object.keys(config.devStorage ?? {})]) {\n            if (name !== undefined && !Object.hasOwn(config.storage, name)) {\n                throw new Error(`[nuxt-files-sdk:unknown-storage] Unknown storage \"${name}\".`)\n            }\n        }\n        this.#config = config\n        this.#development = options.development ?? false\n        this.#hooks = options.hooks ?? {}\n    }\n\n    /** Return the default storage, sharing its in-flight initialization Promise. */\n    get(name?: undefined): Promise<DefaultStorage<C>>\n    /** Return a named storage with its plugin extensions, sharing its in-flight initialization Promise. */\n    get<Name extends keyof C['storage'] & string>(name: Name): Promise<StorageRegistry<C>[Name]>\n    get(name?: string): Promise<Files> {\n        const resolvedName = name ?? this.#defaultName()\n        if (!Object.hasOwn(this.#config.storage, resolvedName)) {\n            throw new Error(`[nuxt-files-sdk:unknown-storage] Unknown storage \"${resolvedName}\".`)\n        }\n        let instance = this.#instances.get(resolvedName)\n        if (!instance) {\n            instance = this.#create(resolvedName)\n            this.#instances.set(resolvedName, instance)\n            void instance.catch(() => this.#instances.delete(resolvedName))\n        }\n        return instance\n    }\n\n    /** Return secret-free storage metadata and initialization state for development diagnostics. */\n    inspect(): FilesDevtoolsSnapshot {\n        return {\n            storages: Object.entries(this.#config.storage).map(([name, storage]) => {\n                const override = this.#development ? this.#config.devStorage?.[name] : undefined\n                return {\n                    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            }),\n            diagnostics: [],\n        }\n    }\n\n    #defaultName(): string {\n        if (this.#config.default !== undefined) return this.#config.default\n        const names = Object.keys(this.#config.storage)\n        if (names.length === 1 && names[0]) return names[0]\n        if (Object.hasOwn(this.#config.storage, 'default')) return 'default'\n        throw new Error('[nuxt-files-sdk:storage-name-required] A storage name is required.')\n    }\n\n    async #create(name: string): Promise<Files> {\n        const base = this.#config.storage[name]\n        const override = this.#development ? this.#config.devStorage?.[name] : undefined\n        const selected = override ? { ...base, ...override, plugins: base?.plugins, hooks: base?.hooks } : base\n        if (!selected) throw new Error(`[nuxt-files-sdk:unknown-storage] Unknown storage \"${name}\".`)\n        const { adapter, plugins, hooks: userHooks, ...options } = selected\n        const loaded = await withNuxtEnvironment(adapter, () => loadFiles({ ...options, provider: adapter }))\n        // The upstream loader has no hooks/plugins input. Avoid rebuilding the\n        // native instance unless those native capabilities are actually used.\n        if (!plugins && !userHooks && !Object.values(this.#hooks).some(Boolean)) return loaded.files\n        return createFiles({\n            adapter: loaded.files.adapter,\n            hooks: {\n                onAction: (event) =>\n                    runHooks(\n                        () => userHooks?.onAction?.(event),\n                        () => this.#hooks.onAction?.(event, name),\n                    ),\n                onError: (event) =>\n                    runHooks(\n                        () => userHooks?.onError?.(event),\n                        () => this.#hooks.onError?.(event, name),\n                    ),\n                onRetry: (event) =>\n                    runHooks(\n                        () => userHooks?.onRetry?.(event),\n                        () => this.#hooks.onRetry?.(event, name),\n                    ),\n            },\n            ...(plugins ? { plugins } : {}),\n            ...(options.prefix === undefined ? {} : { prefix: options.prefix }),\n            ...(options.retries === undefined ? {} : { retries: options.retries }),\n            ...(options.timeout === undefined ? {} : { timeout: options.timeout }),\n        })\n    }\n}\n\nlet environmentLock = Promise.resolve()\n\n/** Bridge only NUXT_ aliases declared by the configured native provider. */\nexport const withNuxtEnvironment = async <T>(provider: ProviderSlug, load: () => Promise<T>): Promise<T> => {\n    const metadata = getProvider(provider)\n    if (!metadata) return load()\n    const variables = listEnvVars(provider)\n    if (variables.length === 0) return load()\n    // ponytail: module-local env lock; use native env keys to avoid temporary aliases.\n    const previous = environmentLock\n    let release!: () => void\n    environmentLock = new Promise<void>((resolveLock) => (release = resolveLock))\n    await previous\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 await load()\n    } finally {\n        for (const key of injected) delete process.env[key]\n        release()\n    }\n}\n"],"mappings":"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"}

package/dist/runtime.d.ts

@@ -3,15 +3,19 @@ import { FilesDevtoolsSnapshot } from "./devtools/snapshot.js";
 import { DefaultStorage, DefaultStorageName, FilesForStorage, FilesRegistry, FilesRuntimeHooks, StorageRegistry } from "./runtime/registry.js";
 import { Files } from "files-sdk";
 //#region src/runtime.d.ts
-/** Project storage names are merged into this interface by the generated declaration. */
+/** Project storage names and plugin-extended Files clients supplied by generated declarations. */
 export interface NuxtFilesStorageRegistry {}
-/** Generated from the project's default-storage selection. */
+/** Project default Files client supplied by generated declarations. */
 export interface NuxtFilesDefaultStorage {}
+/** 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 default Files client, including its configured plugin extensions. */
 export declare function useServerFiles(): Promise<NuxtFilesDefaultStorage extends {
   value: infer Default;
 } ? Default : 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): Promise<NuxtFilesStorageRegistry[Name]>;
 //#endregion
 export { type DefaultStorage, type DefaultStorageName, type FilesForStorage, FilesRegistry, type FilesRuntimeHooks, type StorageRegistry };

package/dist/runtime.js

@@ -1,11 +1,13 @@
 import { FilesRegistry } from "./runtime/registry.js";
 //#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: [{
@@ -16,7 +18,7 @@ const inspectFiles = () => registry?.inspect() ?? {
 };
 function useServerFiles(name) {
 	if (!registry) throw new Error("[nuxt-files-sdk:not-configured] The Files registry has not been configured.");
-	return registry.get(name);
+	return name === void 0 ? registry.get() : registry.get(name);
 }
 //#endregion
 export { FilesRegistry, configureFiles, inspectFiles, useServerFiles };

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    DefaultStorage,\n    DefaultStorageName,\n    FilesForStorage,\n    FilesRuntimeHooks,\n    StorageRegistry,\n} from './runtime/registry'\n\n/** Project storage names are merged into this interface by the generated declaration. */\nexport interface NuxtFilesStorageRegistry {}\n/** Generated from the project's default-storage selection. */\nexport interface NuxtFilesDefaultStorage {}\n\nlet registry: FilesRegistry | undefined\n\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\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\nexport function useServerFiles(): Promise<NuxtFilesDefaultStorage extends { value: infer Default } ? Default : Files>\nexport function useServerFiles<Name extends Extract<keyof NuxtFilesStorageRegistry, string>>(\n    name: Name,\n): Promise<NuxtFilesStorageRegistry[Name]>\nexport function useServerFiles(name?: string): Promise<Files> {\n    if (!registry) {\n        throw new Error('[nuxt-files-sdk:not-configured] The Files registry has not been configured.')\n    }\n    return registry.get(name)\n}\n"],"mappings":";;AAoBA,IAAI;AAEJ,MAAa,kBACT,QACA,YACmB;CACnB,MAAM,QAAQ,IAAI,cAAc,QAAQ,OAAO;CAC/C,WAAW;CACX,OAAO;AACX;AAEA,MAAa,qBACT,UAAU,QAAQ,KAAK;CACnB,UAAU,CAAC;CACX,aAAa,CACT;EACI,MAAM;EACN,OAAO;EACP,SAAS;CACb,CACJ;AACJ;AAMJ,SAAgB,eAAe,MAA+B;CAC1D,IAAI,CAAC,UACD,MAAM,IAAI,MAAM,6EAA6E;CAEjG,OAAO,SAAS,IAAI,IAAI;AAC5B"}
+{"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    DefaultStorage,\n    DefaultStorageName,\n    FilesForStorage,\n    FilesRuntimeHooks,\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 default Files client supplied by generated declarations. */\nexport interface NuxtFilesDefaultStorage {}\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 default Files client, including its configured plugin extensions. */\nexport function useServerFiles(): Promise<NuxtFilesDefaultStorage extends { value: infer Default } ? Default : 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): Promise<NuxtFilesStorageRegistry[Name]>\nexport function useServerFiles(name?: string): Promise<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(name)\n}\n"],"mappings":";;AAoBA,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;AAQJ,SAAgB,eAAe,MAA+B;CAC1D,IAAI,CAAC,UACD,MAAM,IAAI,MAAM,6EAA6E;CAEjG,OAAO,SAAS,KAAA,IAAY,SAAS,IAAI,IAAI,SAAS,IAAI,IAAI;AAClE"}

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "nuxt-files-sdk",
-    "version": "0.0.1",
+    "version": "0.0.2",
     "description": "Native-first Files SDK integration for Nuxt and Nitro",
     "homepage": "https://github.com/liria24/nuxt-files-sdk#readme",
     "license": "MIT",
@@ -51,12 +51,12 @@
     "dependencies": {
         "@nuxt/kit": "^4.5.2",
         "devframe": "^0.9.12",
-        "files-sdk": "^2.3.1"
+        "files-sdk": "^2.4.0"
     },
     "devDependencies": {
         "@arethetypeswrong/cli": "^0.18.5",
         "@nuxt/schema": "^4.5.2",
-        "@types/node": "^26.4.1",
+        "@types/node": "^26.5.0",
         "publint": "^0.3.24",
         "tsdown": "^0.23.0",
         "typescript": "^7.0.2",