nuxt-files-sdk 0.0.4 → 0.1.0

package/dist/integration/nitro.js

@@ -1,31 +1,65 @@
+import { normalizeFilesConfig } from "../runtime/normalize.js";
+import { loadFilesConfig } from "../config/load.js";
+import { pruneFilesConfigSource } from "../config/prune.js";
 import { resolve } from "node:path";
-import { mkdir, writeFile } from "node:fs/promises";
-import { getProvider } from "files-sdk/providers";
-import { createJiti } from "jiti";
+import { mkdir, readFile, writeFile } from "node:fs/promises";
+import { createRequire } from "node:module";
+import { fileURLToPath } from "node:url";
+import { getProvider, listEnvVars } from "files-sdk/providers";
 //#region src/integration/nitro.ts
-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 selectedAdapters = (config, development) => {
-	const storage = config.storage;
-	const devStorage = config.devStorage;
-	if (!storage || !isStorageConfig(storage) && (!isStorageRecord(storage) || Object.keys(storage).length === 0)) throw new Error("[nuxt-files-sdk:invalid-config] At least one storage is required.");
-	const selected = [];
-	const single = isStorageConfig(storage);
-	if (single) {
-		if (devStorage && !isStorageConfig(devStorage)) throw new Error("[nuxt-files-sdk:invalid-config] A single storage requires a single devStorage override.");
-		selected.push(development && isStorageConfig(devStorage) ? devStorage : storage);
-	} else {
-		if (devStorage && !isStorageRecord(devStorage)) throw new Error("[nuxt-files-sdk:invalid-config] Named storage requires named devStorage overrides.");
-		for (const name of Object.keys(devStorage ?? {})) if (!Object.hasOwn(storage, name)) throw new Error(`[nuxt-files-sdk:unknown-storage] Unknown storage "${name}".`);
-		for (const [name, namedStorage] of Object.entries(storage)) selected.push(development ? devStorage?.[name] ?? namedStorage : namedStorage);
-	}
-	const adapters = [...new Set(selected.map(({ adapter }) => adapter))].toSorted();
+const AWS_CORE_DEPENDENCIES = [
+	"@aws-sdk/client-s3",
+	"@aws-sdk/s3-presigned-post",
+	"@aws-sdk/s3-request-presigner"
+];
+const AWS_MULTIPART_DEPENDENCY = "@aws-sdk/lib-storage";
+const FETCH_CAPABLE_S3_ADAPTERS = /* @__PURE__ */ new Set([
+	"minio",
+	"r2",
+	"rustfs"
+]);
+const WORKERD_PRESETS = /* @__PURE__ */ new Set([
+	"cloudflare-module",
+	"cloudflare-durable",
+	"cloudflare-pages"
+]);
+const optionalAwsSdkDependencies = (adapters, options) => {
+	if (options.nitroMajor >= 3 || !options.preset || !WORKERD_PRESETS.has(options.preset)) return [];
+	const s3Adapters = adapters.filter((adapter) => getProvider(adapter)?.peerDeps.includes("@aws-sdk/client-s3"));
+	if (s3Adapters.length === 0) return [];
+	return (s3Adapters.every((adapter) => FETCH_CAPABLE_S3_ADAPTERS.has(adapter)) ? [...AWS_CORE_DEPENDENCIES, AWS_MULTIPART_DEPENDENCY] : [AWS_MULTIPART_DEPENDENCY]).filter((dependency) => !options.resolvable(dependency));
+};
+const nitroMajorVersion = (nitro) => nitro.meta?.majorVersion ?? ("routing" in nitro ? 3 : 2);
+const selectedAdapters = (config) => {
+	const entries = normalizeFilesConfig(config);
+	const single = entries.has(void 0);
+	const adapters = [...new Set([...entries.values()].map(({ storage }) => storage.adapter).filter((adapter) => typeof adapter === "string"))].toSorted();
 	for (const adapter of adapters) if (!getProvider(adapter)) throw new Error(`[nuxt-files-sdk:unknown-adapter] Unknown adapter "${adapter}".`);
 	return {
 		adapters,
 		single
 	};
 };
+const gatewayRoutes = (config) => {
+	const routes = config && typeof config === "object" && "routes" in config ? config.routes : void 0;
+	if (routes === void 0) return [];
+	if (!Array.isArray(routes)) throw new Error("[nuxt-files-sdk:invalid-route] routes must be an array.");
+	const storages = normalizeFilesConfig(config);
+	const paths = /* @__PURE__ */ new Set();
+	const selected = [];
+	for (const route of routes) {
+		if (!route || typeof route !== "object" || !("path" in route) || typeof route.path !== "string" || !/^\/(?:[\w.~-]+(?:\/[\w.~-]+)*)?$/u.test(route.path)) throw new Error("[nuxt-files-sdk:invalid-route] Each route needs a static absolute path.");
+		if (paths.has(route.path)) throw new Error(`[nuxt-files-sdk:duplicate-route] Duplicate route "${route.path}".`);
+		paths.add(route.path);
+		const name = "storage" in route ? route.storage : void 0;
+		if (storages.has(void 0) ? name !== void 0 : typeof name !== "string" || !storages.has(name)) throw new Error(`[nuxt-files-sdk:unknown-storage] Invalid storage for route "${route.path}".`);
+		selected.push(typeof name === "string" ? {
+			path: route.path,
+			storage: name
+		} : { path: route.path });
+	}
+	return selected;
+};
 const factoryName = (adapter) => adapter === "cloudinary" ? "cloudinaryAdapter" : adapter.replaceAll(/-([a-z0-9])/gu, (_, character) => character.toUpperCase());
 const providerCode = (adapters) => ({
 	imports: adapters.map((adapter, index) => `import { ${factoryName(adapter)} as provider${index} } from ${JSON.stringify(`files-sdk/${adapter}`)}`).join("\n"),
@@ -40,56 +74,143 @@ declare module ${JSON.stringify(moduleName)} {
   }
 }
 `;
-const storageTypes = (configPath, nitroMajor, single) => `import type config from ${JSON.stringify(configPath)}
+const storageTypes = (configPath, nitroMajor) => `import type config from ${JSON.stringify(configPath)}
 import type { SingleStorage, StorageRegistry } from 'nuxt-files-sdk/runtime'
 
 declare module 'nuxt-files-sdk/runtime' {
-  ${single ? "interface NuxtFilesSingleStorage { value: SingleStorage<typeof config> }" : "interface NuxtFilesStorageRegistry extends StorageRegistry<typeof config> {}"}
+  interface NuxtFilesSingleStorage { value: SingleStorage<typeof config> }
+  interface NuxtFilesStorageRegistry extends StorageRegistry<typeof config> {}
 }
 ${hookTypes(nitroMajor >= 3 ? "nitro/types" : "nitropack/types")}
 export {}
 `;
 const setupNitroFilesIntegration = async (nitro, options) => {
 	const configPath = options.configPath.replaceAll("\\", "/");
-	const config = await createJiti(import.meta.url, {
-		...nitro.options.alias ? { alias: nitro.options.alias } : {},
-		interopDefault: true,
-		moduleCache: false
-	}).import(configPath, { default: true });
-	const { adapters, single } = selectedAdapters(config, options.development);
+	const config = await loadFilesConfig({
+		configPath,
+		environments: options.environments,
+		alias: nitro.options.alias,
+		injectImports: nitro.unimport?.injectImports.bind(nitro.unimport)
+	});
+	if (!config) return false;
+	const selected = selectedAdapters(config);
+	const directory = resolve(nitro.options.rootDir, nitro.options.buildDir, "nuxt-files-sdk");
+	const typesPath = resolve(directory, "storage-registry.d.ts");
+	let writeRuntime;
+	const writeTypes = async () => {
+		await mkdir(directory, { recursive: true });
+		await writeFile(typesPath, storageTypes(configPath, nitroMajorVersion(nitro)));
+	};
+	await writeTypes();
+	nitro.hooks.hook("types:extend", async (types) => {
+		await writeTypes();
+		await writeRuntime?.();
+		const tsConfig = types.tsConfig ??= {};
+		(tsConfig.include ??= []).push(typesPath);
+		const paths = (tsConfig.compilerOptions ??= {}).paths ??= {};
+		paths["files-sdk"] ??= [resolve(nitro.options.rootDir, "node_modules/files-sdk").replaceAll("\\", "/")];
+	});
+	const routes = gatewayRoutes(config);
+	const { adapters } = selected;
 	const providers = providerCode(adapters);
+	const internalPath = fileURLToPath(new URL("../runtime/internal.js", import.meta.url)).replaceAll("\\", "/");
+	const environment = Object.fromEntries(adapters.map((adapter) => [adapter, listEnvVars(adapter).filter((variable) => variable.readBy === "files-sdk").map((variable) => [variable.key, ...variable.aliases ?? []])]));
+	const require = createRequire(resolve(nitro.options.rootDir, "package.json"));
+	const aliases = nitro.options.alias ?? {};
+	const shimFiles = optionalAwsSdkDependencies(adapters, {
+		nitroMajor: nitroMajorVersion(nitro),
+		preset: nitro.options.preset,
+		resolvable: (dependency) => {
+			if (Object.hasOwn(aliases, dependency)) return true;
+			try {
+				require.resolve(dependency);
+				return true;
+			} catch {
+				return false;
+			}
+		}
+	}).map((dependency) => ({
+		dependency,
+		path: resolve(directory, `${dependency.replaceAll(/[^a-z0-9]+/giu, "-")}.mjs`)
+	}));
+	if (shimFiles.length > 0) {
+		nitro.options.alias = aliases;
+		for (const { dependency, path } of shimFiles) aliases[dependency] = path.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 Files client, including its configured plugin extensions. */\n$1const useServerFiles: typeof import('nuxt-files-sdk/runtime').useServerFiles")
+		declaration: (declarations) => declarations.replace(/^([ \t]*)const (useServerFiles|syncFiles|transferFiles): typeof .*\.\2$/gmu, (_, indent, name) => `${name === "useServerFiles" ? `${indent}/** Return the project's Files client, including its configured plugin extensions. */\n` : ""}${indent}const ${name}: typeof import('nuxt-files-sdk/runtime').${name}`)
 	});
 	const externals = nitro.options.externals ??= {};
 	(externals.inline ??= []).push("nuxt-files-sdk");
 	if (!nitro.options.dev) externals.inline.push("files-sdk");
-	const directory = resolve(nitro.options.buildDir, "nuxt-files-sdk");
-	const pluginPath = resolve(directory, options.development ? "plugin.dev.mjs" : "plugin.mjs");
-	const typesPath = resolve(directory, "storage-registry.d.ts");
-	externals.inline.push(pluginPath.replaceAll("\\", "/"), configPath);
+	const pluginPath = resolve(directory, nitro.options.dev ? "plugin.dev.mjs" : "plugin.mjs");
+	const resolvedPath = resolve(directory, nitro.options.dev ? "resolved.dev.mjs" : "resolved.mjs");
+	const selectedPath = resolve(directory, nitro.options.dev ? "selected.dev.ts" : "selected.ts");
+	const routePaths = routes.map((_, index) => resolve(directory, `gateway-${index}${nitro.options.dev ? ".dev" : ""}.mjs`).replaceAll("\\", "/"));
+	for (const [index, route] of routes.entries()) (nitro.options.handlers ??= []).push({
+		route: route.path,
+		handler: routePaths[index]
+	});
+	externals.inline.push(pluginPath.replaceAll("\\", "/"), resolvedPath.replaceAll("\\", "/"), selectedPath.replaceAll("\\", "/"), ...routePaths);
 	nitro.options.plugins.push(pluginPath.replaceAll("\\", "/"));
-	nitro.hooks.hook("types:extend", async (types) => {
+	writeRuntime = async () => {
 		await mkdir(directory, { recursive: true });
-		await Promise.all([writeFile(pluginPath, `import config from ${JSON.stringify(configPath)}
+		await Promise.all(shimFiles.map(({ dependency, path }) => writeFile(path, `throw new Error(${JSON.stringify(`[nuxt-files-sdk:missing-optional-dependency] ${dependency} is required for this Files SDK operation. Install it or select the provider's fetch client.`)})\n`)));
+		const originalSource = await readFile(configPath, "utf8");
+		const importedSource = nitro.unimport ? (await nitro.unimport.injectImports(originalSource, configPath)).code : originalSource;
+		await writeFile(selectedPath, pruneFilesConfigSource(importedSource, configPath, options.environments));
+		const mergePath = fileURLToPath(new URL("../config/merge.js", import.meta.url)).replaceAll("\\", "/");
+		const selectedBranches = options.environments.flatMap((name) => [`raw[${JSON.stringify(`$${name}`)}]`, `raw.$env?.[${JSON.stringify(name)}]`]).toReversed();
+		await writeFile(resolvedPath, `import raw from ${JSON.stringify(selectedPath.replaceAll("\\", "/"))}\nimport { mergeFilesConfig } from ${JSON.stringify(mergePath)}\nconst resolved = mergeFilesConfig(${[...selectedBranches, "raw"].join(", ")})\nexport default { storage: resolved.storage, routes: resolved.routes }\n`);
+		await writeFile(pluginPath, `import config from ${JSON.stringify(resolvedPath.replaceAll("\\", "/"))}
 ${providers.imports}
-import { configureFiles } from 'nuxt-files-sdk/runtime'
+import { configureFiles } from ${JSON.stringify(internalPath)}
 
 export default (nitroApp) => configureFiles(config, {
-  development: ${JSON.stringify(options.development)},
   factories: { ${providers.factories} },
+  environment: ${JSON.stringify(environment)},
   hooks: {
     onAction: (event, storage) => nitroApp.hooks.callHook('files:action', { event, storage }),
     onError: (event, storage) => nitroApp.hooks.callHook('files:error', { event, storage }),
     onRetry: (event, storage) => nitroApp.hooks.callHook('files:retry', { event, storage }),
   },
 })
-`), writeFile(typesPath, storageTypes(configPath, nitro.meta?.majorVersion ?? ("routing" in nitro ? 3 : 2), single))]);
-		types.tsConfig?.include?.push(typesPath);
-	});
+`);
+		await Promise.all(routePaths.map((path, index) => {
+			const route = routes[index];
+			const handler = nitroMajorVersion(nitro) >= 3 ? "router.handle(event.req)" : "createRouteHandler(router)(event)";
+			return writeFile(path, `import config from ${JSON.stringify(resolvedPath.replaceAll("\\", "/"))}
+import { createFilesRouter } from 'files-sdk/api'
+${nitroMajorVersion(nitro) >= 3 ? "" : "import { createRouteHandler } from 'files-sdk/nitro'"}
+import { getFiles } from ${JSON.stringify(internalPath)}
+
+const route = config.routes[${index}]
+const environmentSecret = typeof process === 'undefined' ? undefined : process.env?.FILES_API_SECRET
+const secret = route.authorize
+  ? route.secret || environmentSecret || crypto.randomUUID() + crypto.randomUUID()
+  : route.secret
+if (route.authorize && !route.secret && !environmentSecret) {
+  console.warn('[nuxt-files-sdk:gateway-secret] Set FILES_API_SECRET for upload tokens shared across processes.')
+}
+let sharedRouter
+const makeRouter = (event) => createFilesRouter({
+  ...route,
+  files: () => getFiles(${route.storage === void 0 ? "" : JSON.stringify(route.storage)}),
+  secret,
+  authorize: route.authorize && ((context) => route.authorize({ ...context, event })),
+})
+export default (event) => {
+  const router = route.authorize ? makeRouter(event) : (sharedRouter ??= makeRouter(event))
+  return ${handler}
+}
+`);
+		}));
+	};
+	await writeRuntime();
+	return true;
 };
 //#endregion
-export { providerCode, selectedAdapters, setupNitroFilesIntegration, storageTypes };
+export { gatewayRoutes, optionalAwsSdkDependencies, providerCode, selectedAdapters, setupNitroFilesIntegration, storageTypes };
 
 //# sourceMappingURL=nitro.js.map

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\nimport type { ProviderSlug } from 'files-sdk'\nimport { getProvider } from 'files-sdk/providers'\nimport { createJiti } from 'jiti'\n\nimport type { FilesConfig, StorageConfig } from '../config'\n\nexport interface NitroIntegration {\n    meta?: { majorVersion?: number }\n    options: {\n        rootDir: string\n        buildDir: string\n        dev?: boolean\n        plugins: string[]\n        alias?: Record<string, string>\n        externals?: { inline?: unknown[] }\n    }\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 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\nexport const selectedAdapters = (\n    config: FilesConfig,\n    development: boolean,\n): { adapters: ProviderSlug[]; single: boolean } => {\n    const storage = config.storage\n    const devStorage = config.devStorage\n    if (!storage || (!isStorageConfig(storage) && (!isStorageRecord(storage) || Object.keys(storage).length === 0))) {\n        throw new Error('[nuxt-files-sdk:invalid-config] At least one storage is required.')\n    }\n    const selected: StorageConfig[] = []\n    const single = isStorageConfig(storage)\n    if (single) {\n        if (devStorage && !isStorageConfig(devStorage)) {\n            throw new Error('[nuxt-files-sdk:invalid-config] A single storage requires a single devStorage override.')\n        }\n        selected.push(development && isStorageConfig(devStorage) ? devStorage : storage)\n    } else {\n        if (devStorage && !isStorageRecord(devStorage)) {\n            throw new Error('[nuxt-files-sdk:invalid-config] Named storage requires named devStorage overrides.')\n        }\n        for (const name of Object.keys(devStorage ?? {})) {\n            if (!Object.hasOwn(storage, name)) {\n                throw new Error(`[nuxt-files-sdk:unknown-storage] Unknown storage \"${name}\".`)\n            }\n        }\n        for (const [name, namedStorage] of Object.entries(storage)) {\n            selected.push(development ? (devStorage?.[name] ?? namedStorage) : namedStorage)\n        }\n    }\n    const adapters = [...new Set(selected.map(({ adapter }) => adapter))].toSorted()\n    for (const adapter of adapters) {\n        if (!getProvider(adapter)) {\n            throw new Error(`[nuxt-files-sdk:unknown-adapter] Unknown adapter \"${adapter}\".`)\n        }\n    }\n    return { adapters, single }\n}\n\nconst factoryName = (adapter: ProviderSlug): string =>\n    adapter === 'cloudinary'\n        ? 'cloudinaryAdapter'\n        : adapter.replaceAll(/-([a-z0-9])/gu, (_, character: string) => character.toUpperCase())\n\nexport const providerCode = (adapters: ProviderSlug[]): { imports: string; factories: string } => ({\n    imports: adapters\n        .map(\n            (adapter, index) =>\n                `import { ${factoryName(adapter)} as provider${index} } from ${JSON.stringify(`files-sdk/${adapter}`)}`,\n        )\n        .join('\\n'),\n    factories: adapters.map((adapter, index) => `${JSON.stringify(adapter)}: provider${index}`).join(', '),\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    single: boolean,\n): string => `import type config from ${JSON.stringify(configPath)}\nimport type { SingleStorage, StorageRegistry } from 'nuxt-files-sdk/runtime'\n\ndeclare module 'nuxt-files-sdk/runtime' {\n  ${single ? 'interface NuxtFilesSingleStorage { value: SingleStorage<typeof config> }' : 'interface NuxtFilesStorageRegistry extends StorageRegistry<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    const config = await createJiti(import.meta.url, {\n        ...(nitro.options.alias ? { alias: nitro.options.alias } : {}),\n        interopDefault: true,\n        moduleCache: false,\n    }).import<FilesConfig>(configPath, { default: true })\n    const { adapters, single } = selectedAdapters(config, options.development)\n    const providers = providerCode(adapters)\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 Files client, including its configured plugin extensions. */\\n$1const useServerFiles: typeof import('nuxt-files-sdk/runtime').useServerFiles\",\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, options.development ? 'plugin.dev.mjs' : '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)}\n${providers.imports}\nimport { configureFiles } from 'nuxt-files-sdk/runtime'\n\nexport default (nitroApp) => configureFiles(config, {\n  development: ${JSON.stringify(options.development)},\n  factories: { ${providers.factories} },\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(\n                typesPath,\n                storageTypes(configPath, nitro.meta?.majorVersion ?? ('routing' in nitro ? 3 : 2), single),\n            ),\n        ])\n        types.tsConfig?.include?.push(typesPath)\n    })\n}\n"],"mappings":"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"}
+{"version":3,"file":"nitro.js","names":[],"sources":["../../src/integration/nitro.ts"],"sourcesContent":["import { mkdir, readFile, writeFile } from 'node:fs/promises'\nimport { createRequire } from 'node:module'\nimport { resolve } from 'node:path'\nimport { fileURLToPath } from 'node:url'\n\nimport type { ProviderSlug } from 'files-sdk'\nimport { getProvider, listEnvVars } from 'files-sdk/providers'\n\nimport { loadFilesConfig } from '../config/load'\nimport { pruneFilesConfigSource } from '../config/prune'\nimport { normalizeFilesConfig } from '../runtime/normalize'\n\nexport interface NitroIntegration {\n    meta?: { majorVersion?: number }\n    options: {\n        rootDir: string\n        buildDir: string\n        dev?: boolean\n        static?: boolean\n        preset?: string\n        plugins: string[]\n        handlers?: { route: string; handler: string }[]\n        alias?: Record<string, string>\n        externals?: { inline?: unknown[] }\n    }\n    unimport?: {\n        injectImports(code: string, id?: string): Promise<{ code: string }>\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: {\n                tsConfig?: {\n                    include?: string[]\n                    compilerOptions?: { paths?: Record<string, string[]> }\n                }\n            }) => void | Promise<void>,\n        ): void\n    }\n}\n\nexport interface NitroFilesIntegrationOptions {\n    configPath: string\n    environments: readonly string[]\n}\n\nconst AWS_CORE_DEPENDENCIES = [\n    '@aws-sdk/client-s3',\n    '@aws-sdk/s3-presigned-post',\n    '@aws-sdk/s3-request-presigner',\n] as const\nconst AWS_MULTIPART_DEPENDENCY = '@aws-sdk/lib-storage'\nconst FETCH_CAPABLE_S3_ADAPTERS = new Set<ProviderSlug>(['minio', 'r2', 'rustfs'])\nconst WORKERD_PRESETS = new Set(['cloudflare-module', 'cloudflare-durable', 'cloudflare-pages'])\n\nexport const optionalAwsSdkDependencies = (\n    adapters: ProviderSlug[],\n    options: { nitroMajor: number; preset?: string | undefined; resolvable: (dependency: string) => boolean },\n): string[] => {\n    if (options.nitroMajor >= 3 || !options.preset || !WORKERD_PRESETS.has(options.preset)) return []\n    const s3Adapters = adapters.filter((adapter) => getProvider(adapter)?.peerDeps.includes('@aws-sdk/client-s3'))\n    if (s3Adapters.length === 0) return []\n    const optional = s3Adapters.every((adapter) => FETCH_CAPABLE_S3_ADAPTERS.has(adapter))\n        ? [...AWS_CORE_DEPENDENCIES, AWS_MULTIPART_DEPENDENCY]\n        : [AWS_MULTIPART_DEPENDENCY]\n    return optional.filter((dependency) => !options.resolvable(dependency))\n}\n\nconst nitroMajorVersion = (nitro: NitroIntegration): number => nitro.meta?.majorVersion ?? ('routing' in nitro ? 3 : 2)\n\nexport const selectedAdapters = (config: unknown): { adapters: ProviderSlug[]; single: boolean } => {\n    const entries = normalizeFilesConfig(config)\n    const single = entries.has(undefined)\n    const adapters = [\n        ...new Set(\n            [...entries.values()]\n                .map(({ storage }) => storage.adapter)\n                .filter((adapter): adapter is ProviderSlug => typeof adapter === 'string'),\n        ),\n    ].toSorted()\n    for (const adapter of adapters) {\n        if (!getProvider(adapter)) {\n            throw new Error(`[nuxt-files-sdk:unknown-adapter] Unknown adapter \"${adapter}\".`)\n        }\n    }\n    return { adapters, single }\n}\n\nexport const gatewayRoutes = (config: unknown): { path: string; storage?: string }[] => {\n    const routes = config && typeof config === 'object' && 'routes' in config ? config.routes : undefined\n    if (routes === undefined) return []\n    if (!Array.isArray(routes)) throw new Error('[nuxt-files-sdk:invalid-route] routes must be an array.')\n    const storages = normalizeFilesConfig(config)\n    const paths = new Set<string>()\n    const selected: { path: string; storage?: string }[] = []\n    for (const route of routes as unknown[]) {\n        if (\n            !route ||\n            typeof route !== 'object' ||\n            !('path' in route) ||\n            typeof route.path !== 'string' ||\n            !/^\\/(?:[\\w.~-]+(?:\\/[\\w.~-]+)*)?$/u.test(route.path)\n        ) {\n            throw new Error('[nuxt-files-sdk:invalid-route] Each route needs a static absolute path.')\n        }\n        if (paths.has(route.path)) throw new Error(`[nuxt-files-sdk:duplicate-route] Duplicate route \"${route.path}\".`)\n        paths.add(route.path)\n        const name = 'storage' in route ? route.storage : undefined\n        if (storages.has(undefined) ? name !== undefined : typeof name !== 'string' || !storages.has(name)) {\n            throw new Error(`[nuxt-files-sdk:unknown-storage] Invalid storage for route \"${route.path}\".`)\n        }\n        selected.push(typeof name === 'string' ? { path: route.path, storage: name } : { path: route.path })\n    }\n    return selected\n}\n\nconst factoryName = (adapter: ProviderSlug): string =>\n    adapter === 'cloudinary'\n        ? 'cloudinaryAdapter'\n        : adapter.replaceAll(/-([a-z0-9])/gu, (_, character: string) => character.toUpperCase())\n\nexport const providerCode = (adapters: ProviderSlug[]): { imports: string; factories: string } => ({\n    imports: adapters\n        .map(\n            (adapter, index) =>\n                `import { ${factoryName(adapter)} as provider${index} } from ${JSON.stringify(`files-sdk/${adapter}`)}`,\n        )\n        .join('\\n'),\n    factories: adapters.map((adapter, index) => `${JSON.stringify(adapter)}: provider${index}`).join(', '),\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 { SingleStorage, StorageRegistry } from 'nuxt-files-sdk/runtime'\n\ndeclare module 'nuxt-files-sdk/runtime' {\n  interface NuxtFilesSingleStorage { value: SingleStorage<typeof config> }\n  interface NuxtFilesStorageRegistry extends StorageRegistry<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<boolean> => {\n    const configPath = options.configPath.replaceAll('\\\\', '/')\n    const config = await loadFilesConfig({\n        configPath,\n        environments: options.environments,\n        alias: nitro.options.alias,\n        injectImports: nitro.unimport?.injectImports.bind(nitro.unimport),\n    })\n    if (!config) return false\n    const selected = selectedAdapters(config)\n    const directory = resolve(nitro.options.rootDir, nitro.options.buildDir, 'nuxt-files-sdk')\n    const typesPath = resolve(directory, 'storage-registry.d.ts')\n    let writeRuntime: (() => Promise<void>) | undefined\n    const writeTypes = async (): Promise<void> => {\n        await mkdir(directory, { recursive: true })\n        await writeFile(typesPath, storageTypes(configPath, nitroMajorVersion(nitro)))\n    }\n    await writeTypes()\n    nitro.hooks.hook('types:extend', async (types) => {\n        await writeTypes()\n        await writeRuntime?.()\n        const tsConfig = (types.tsConfig ??= {})\n        ;(tsConfig.include ??= []).push(typesPath)\n        const paths = ((tsConfig.compilerOptions ??= {}).paths ??= {})\n        paths['files-sdk'] ??= [resolve(nitro.options.rootDir, 'node_modules/files-sdk').replaceAll('\\\\', '/')]\n    })\n    const routes = gatewayRoutes(config)\n    const { adapters } = selected\n    const providers = providerCode(adapters)\n    const internalPath = fileURLToPath(new URL('../runtime/internal.js', import.meta.url)).replaceAll('\\\\', '/')\n    const environment = Object.fromEntries(\n        adapters.map((adapter) => [\n            adapter,\n            listEnvVars(adapter)\n                .filter((variable) => variable.readBy === 'files-sdk')\n                .map((variable) => [variable.key, ...(variable.aliases ?? [])]),\n        ]),\n    )\n    const require = createRequire(resolve(nitro.options.rootDir, 'package.json'))\n    const aliases = nitro.options.alias ?? {}\n    const awsShims = optionalAwsSdkDependencies(adapters, {\n        nitroMajor: nitroMajorVersion(nitro),\n        preset: nitro.options.preset,\n        resolvable: (dependency) => {\n            if (Object.hasOwn(aliases, dependency)) return true\n            try {\n                require.resolve(dependency)\n                return true\n            } catch {\n                return false\n            }\n        },\n    })\n    const shimFiles = awsShims.map((dependency) => ({\n        dependency,\n        path: resolve(directory, `${dependency.replaceAll(/[^a-z0-9]+/giu, '-')}.mjs`),\n    }))\n    if (shimFiles.length > 0) {\n        nitro.options.alias = aliases\n        for (const { dependency, path } of shimFiles) aliases[dependency] = path.replaceAll('\\\\', '/')\n    }\n    nitro.unimport?.getInternalContext().addons.push({\n        name: 'nuxt-files-sdk-jsdoc',\n        declaration: (declarations) =>\n            declarations.replace(\n                /^([ \\t]*)const (useServerFiles|syncFiles|transferFiles): typeof .*\\.\\2$/gmu,\n                (_, indent: string, name: string) =>\n                    `${name === 'useServerFiles' ? `${indent}/** Return the project's Files client, including its configured plugin extensions. */\\n` : ''}${indent}const ${name}: typeof import('nuxt-files-sdk/runtime').${name}`,\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 pluginPath = resolve(directory, nitro.options.dev ? 'plugin.dev.mjs' : 'plugin.mjs')\n    const resolvedPath = resolve(directory, nitro.options.dev ? 'resolved.dev.mjs' : 'resolved.mjs')\n    const selectedPath = resolve(directory, nitro.options.dev ? 'selected.dev.ts' : 'selected.ts')\n    const routePaths = routes.map((_, index) =>\n        resolve(directory, `gateway-${index}${nitro.options.dev ? '.dev' : ''}.mjs`).replaceAll('\\\\', '/'),\n    )\n    for (const [index, route] of routes.entries()) {\n        ;(nitro.options.handlers ??= []).push({ route: route.path, handler: routePaths[index]! })\n    }\n    // Development also externalizes local .mjs files unless explicitly inlined.\n    externals.inline.push(\n        pluginPath.replaceAll('\\\\', '/'),\n        resolvedPath.replaceAll('\\\\', '/'),\n        selectedPath.replaceAll('\\\\', '/'),\n        ...routePaths,\n    )\n    nitro.options.plugins.push(pluginPath.replaceAll('\\\\', '/'))\n    writeRuntime = async (): Promise<void> => {\n        await mkdir(directory, { recursive: true })\n        await Promise.all(\n            shimFiles.map(({ dependency, path }) =>\n                writeFile(\n                    path,\n                    `throw new Error(${JSON.stringify(`[nuxt-files-sdk:missing-optional-dependency] ${dependency} is required for this Files SDK operation. Install it or select the provider's fetch client.`)})\\n`,\n                ),\n            ),\n        )\n        const originalSource = await readFile(configPath, 'utf8')\n        const importedSource = nitro.unimport\n            ? (await nitro.unimport.injectImports(originalSource, configPath)).code\n            : originalSource\n        await writeFile(selectedPath, pruneFilesConfigSource(importedSource, configPath, options.environments))\n        const mergePath = fileURLToPath(new URL('../config/merge.js', import.meta.url)).replaceAll('\\\\', '/')\n        const selectedBranches = options.environments\n            .flatMap((name) => [`raw[${JSON.stringify(`$${name}`)}]`, `raw.$env?.[${JSON.stringify(name)}]`])\n            .toReversed()\n        await writeFile(\n            resolvedPath,\n            `import raw from ${JSON.stringify(selectedPath.replaceAll('\\\\', '/'))}\\nimport { mergeFilesConfig } from ${JSON.stringify(mergePath)}\\nconst resolved = mergeFilesConfig(${[...selectedBranches, 'raw'].join(', ')})\\nexport default { storage: resolved.storage, routes: resolved.routes }\\n`,\n        )\n        await writeFile(\n            pluginPath,\n            `import config from ${JSON.stringify(resolvedPath.replaceAll('\\\\', '/'))}\n${providers.imports}\nimport { configureFiles } from ${JSON.stringify(internalPath)}\n\nexport default (nitroApp) => configureFiles(config, {\n  factories: { ${providers.factories} },\n  environment: ${JSON.stringify(environment)},\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        await Promise.all(\n            routePaths.map((path, index) => {\n                const route = routes[index]!\n                const handler =\n                    nitroMajorVersion(nitro) >= 3 ? 'router.handle(event.req)' : 'createRouteHandler(router)(event)'\n                return writeFile(\n                    path,\n                    `import config from ${JSON.stringify(resolvedPath.replaceAll('\\\\', '/'))}\nimport { createFilesRouter } from 'files-sdk/api'\n${nitroMajorVersion(nitro) >= 3 ? '' : \"import { createRouteHandler } from 'files-sdk/nitro'\"}\nimport { getFiles } from ${JSON.stringify(internalPath)}\n\nconst route = config.routes[${index}]\nconst environmentSecret = typeof process === 'undefined' ? undefined : process.env?.FILES_API_SECRET\nconst secret = route.authorize\n  ? route.secret || environmentSecret || crypto.randomUUID() + crypto.randomUUID()\n  : route.secret\nif (route.authorize && !route.secret && !environmentSecret) {\n  console.warn('[nuxt-files-sdk:gateway-secret] Set FILES_API_SECRET for upload tokens shared across processes.')\n}\nlet sharedRouter\nconst makeRouter = (event) => createFilesRouter({\n  ...route,\n  files: () => getFiles(${route.storage === undefined ? '' : JSON.stringify(route.storage)}),\n  secret,\n  authorize: route.authorize && ((context) => route.authorize({ ...context, event })),\n})\nexport default (event) => {\n  const router = route.authorize ? makeRouter(event) : (sharedRouter ??= makeRouter(event))\n  return ${handler}\n}\n`,\n                )\n            }),\n        )\n    }\n    await writeRuntime()\n    return true\n}\n"],"mappings":"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"}

package/dist/module.d.ts

@@ -1,7 +1,5 @@
+import { FilesDevtoolsOptions } from "./devtools/enabled.js";
 import { NitroIntegration } from "./integration/nitro.js";
-import { FilesForStorage, FilesProviderFactories, FilesProviderFactory, FilesRegistry, FilesRuntimeHooks, SingleStorage, StorageRegistry } from "./runtime/registry.js";
-import { NuxtFilesSingleStorage, NuxtFilesStorageRegistry, configureFiles, inspectFiles, useServerFiles } from "./runtime.js";
-export * from "files-sdk";
 //#region src/module.d.ts
 declare module '@nuxt/schema' {
   interface NuxtHooks {
@@ -12,11 +10,11 @@ declare module '@nuxt/schema' {
 export interface ModuleOptions {
   /** Path to the Files configuration module, relative to the Nuxt root directory. */
   config: string;
-  /** Enable Files SDK development diagnostics when Nuxt DevTools is available. */
-  devtools: boolean;
+  /** Enable Files SDK development tools. File writes are enabled unless explicitly disabled. */
+  devtools: boolean | FilesDevtoolsOptions;
 }
 /** 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 FilesForStorage, type FilesProviderFactories, type FilesProviderFactory, FilesRegistry, type FilesRuntimeHooks, NuxtFilesSingleStorage, NuxtFilesStorageRegistry, type SingleStorage, type StorageRegistry, configureFiles, _default as default, inspectFiles, useServerFiles };
+export { type FilesDevtoolsOptions, _default as default };
 //# sourceMappingURL=module.d.ts.map

package/dist/module.js

@@ -1,10 +1,8 @@
-import { shouldEnableFilesDevtools } from "./devtools/enabled.js";
+import { filesDevtoolsWriteEnabled, shouldEnableFilesDevtools } from "./devtools/enabled.js";
 import { setupNitroFilesIntegration } from "./integration/nitro.js";
-import { FilesRegistry } from "./runtime/registry.js";
-import { configureFiles, inspectFiles, useServerFiles } from "./runtime.js";
+import { randomUUID } from "node:crypto";
 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({
@@ -19,16 +17,40 @@ var module_default = defineNuxtModule({
 	},
 	async setup(options, nuxt) {
 		const configPath = resolve(nuxt.options.rootDir, options.config);
-		nuxt.hook("nitro:init", (nitro) => setupNitroFilesIntegration(nitro, {
-			configPath,
-			development: nuxt.options.dev
-		}));
+		(nuxt.options.typescript.tsConfig.include ??= []).push(configPath);
+		const paths = (nuxt.options.typescript.tsConfig.compilerOptions ??= {}).paths ??= {};
+		paths["files-sdk"] ??= [resolve(nuxt.options.rootDir, "node_modules/files-sdk").replaceAll("\\", "/")];
+		let active = false;
+		nuxt.hook("nitro:init", async (nitro) => {
+			active = await setupNitroFilesIntegration(nitro, {
+				configPath,
+				environments: nitro.options.static ? ["production", "prerender"] : [nuxt.options.envName || (nuxt.options.dev ? "development" : "production")]
+			});
+		});
 		nuxt.hook("prepare:types", ({ references }) => {
-			references.push({ path: resolve(nuxt.options.buildDir, "nuxt-files-sdk/storage-registry.d.ts") });
+			if (active) references.push({ path: resolve(nuxt.options.buildDir, "nuxt-files-sdk/storage-registry.d.ts") });
 		});
-		addServerImports({
-			name: "useServerFiles",
-			from: "nuxt-files-sdk/runtime"
+		addServerImports([
+			{
+				name: "defineFilesConfig",
+				from: "nuxt-files-sdk/config"
+			},
+			{
+				name: "useServerFiles",
+				from: "nuxt-files-sdk/runtime"
+			},
+			{
+				name: "syncFiles",
+				from: "nuxt-files-sdk/runtime"
+			},
+			{
+				name: "transferFiles",
+				from: "nuxt-files-sdk/runtime"
+			}
+		]);
+		addImports({
+			name: "defineFilesConfig",
+			from: "nuxt-files-sdk/config"
 		});
 		for (const name of [
 			"useFiles",
@@ -42,11 +64,12 @@ var module_default = defineNuxtModule({
 		if (shouldEnableFilesDevtools(nuxt.options.dev, options.devtools, nuxt.options.devtools)) {
 			const version = await getNuxtModuleVersion("@nuxt/devtools", nuxt);
 			const { setupFilesDevtools } = await import("./devtools/index.js");
-			setupFilesDevtools(nuxt, version || "3");
+			const secrets = { token: randomUUID() };
+			setupFilesDevtools(nuxt, version || "3", filesDevtoolsWriteEnabled(options.devtools), secrets);
 		}
 	}
 });
 //#endregion
-export { FilesRegistry, configureFiles, module_default as default, inspectFiles, useServerFiles };
+export { module_default as default };
 
 //# sourceMappingURL=module.js.map

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\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"}
+{"version":3,"file":"module.js","names":[],"sources":["../src/module.ts"],"sourcesContent":["import { randomUUID } from 'node:crypto'\nimport { resolve } from 'node:path'\n\nimport { addImports, addServerImports, defineNuxtModule, getNuxtModuleVersion } from '@nuxt/kit'\nimport type { Nuxt } from '@nuxt/schema'\n\nimport { filesDevtoolsWriteEnabled, shouldEnableFilesDevtools, type FilesDevtoolsOptions } 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 tools. File writes are enabled unless explicitly disabled. */\n    devtools: boolean | FilesDevtoolsOptions\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.options.typescript.tsConfig.include ??= []).push(configPath)\n        const paths = ((nuxt.options.typescript.tsConfig.compilerOptions ??= {}).paths ??= {})\n        paths['files-sdk'] ??= [resolve(nuxt.options.rootDir, 'node_modules/files-sdk').replaceAll('\\\\', '/')]\n        let active = false\n        nuxt.hook('nitro:init', async (nitro) => {\n            active = await setupNitroFilesIntegration(nitro, {\n                configPath,\n                environments: nitro.options.static\n                    ? ['production', 'prerender']\n                    : [nuxt.options.envName || (nuxt.options.dev ? 'development' : 'production')],\n            })\n        })\n        nuxt.hook('prepare:types', ({ references }) => {\n            if (active)\n                references.push({ path: resolve(nuxt.options.buildDir, 'nuxt-files-sdk/storage-registry.d.ts') })\n        })\n\n        addServerImports([\n            { name: 'defineFilesConfig', from: 'nuxt-files-sdk/config' },\n            { name: 'useServerFiles', from: 'nuxt-files-sdk/runtime' },\n            { name: 'syncFiles', from: 'nuxt-files-sdk/runtime' },\n            { name: 'transferFiles', from: 'nuxt-files-sdk/runtime' },\n        ])\n        addImports({ name: 'defineFilesConfig', from: 'nuxt-files-sdk/config' })\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            const secrets = { token: randomUUID() }\n            setupFilesDevtools(nuxt, version || '3', filesDevtoolsWriteEnabled(options.devtools), secrets)\n        }\n    },\n})\n\nexport type { FilesDevtoolsOptions } from './devtools/enabled'\n"],"mappings":";;;;;;;AAwBA,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;EAC9D,CAAC,KAAK,QAAQ,WAAW,SAAS,YAAY,CAAC,EAAA,CAAG,KAAK,UAAU;EAClE,MAAM,QAAS,CAAC,KAAK,QAAQ,WAAW,SAAS,oBAAoB,CAAC,EAAA,CAAG,UAAU,CAAC;EACpF,MAAM,iBAAiB,CAAC,QAAQ,KAAK,QAAQ,SAAS,wBAAwB,CAAC,CAAC,WAAW,MAAM,GAAG,CAAC;EACrG,IAAI,SAAS;EACb,KAAK,KAAK,cAAc,OAAO,UAAU;GACrC,SAAS,MAAM,2BAA2B,OAAO;IAC7C;IACA,cAAc,MAAM,QAAQ,SACtB,CAAC,cAAc,WAAW,IAC1B,CAAC,KAAK,QAAQ,YAAY,KAAK,QAAQ,MAAM,gBAAgB,aAAa;GACpF,CAAC;EACL,CAAC;EACD,KAAK,KAAK,kBAAkB,EAAE,iBAAiB;GAC3C,IAAI,QACA,WAAW,KAAK,EAAE,MAAM,QAAQ,KAAK,QAAQ,UAAU,sCAAsC,EAAE,CAAC;EACxG,CAAC;EAED,iBAAiB;GACb;IAAE,MAAM;IAAqB,MAAM;GAAwB;GAC3D;IAAE,MAAM;IAAkB,MAAM;GAAyB;GACzD;IAAE,MAAM;IAAa,MAAM;GAAyB;GACpD;IAAE,MAAM;IAAiB,MAAM;GAAyB;EAC5D,CAAC;EACD,WAAW;GAAE,MAAM;GAAqB,MAAM;EAAwB,CAAC;EACvE,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,MAAM,UAAU,EAAE,OAAO,WAAW,EAAE;GACtC,mBAAmB,MAAM,WAAW,KAAK,0BAA0B,QAAQ,QAAQ,GAAG,OAAO;EACjG;CACJ;AACJ,CAAC"}

package/dist/nitro.d.ts

@@ -1,6 +1,4 @@
 import { NitroIntegration } from "./integration/nitro.js";
-import { FilesForStorage, FilesProviderFactories, FilesProviderFactory, FilesRegistry, FilesRuntimeHooks, SingleStorage, StorageRegistry } from "./runtime/registry.js";
-import { NuxtFilesSingleStorage, NuxtFilesStorageRegistry, configureFiles, inspectFiles, useServerFiles } from "./runtime.js";
 //#region src/nitro.d.ts
 /**
  * A structurally compatible Nitro v2/v3 module. Nitro loads this export
@@ -8,8 +6,8 @@ import { NuxtFilesSingleStorage, NuxtFilesStorageRegistry, configureFiles, inspe
  */
 declare const _default: {
   name: string;
-  setup: (nitro: NitroIntegration) => Promise<void>;
+  setup: (nitro: NitroIntegration) => Promise<boolean>;
 };
 //#endregion
-export { type FilesForStorage, type FilesProviderFactories, type FilesProviderFactory, FilesRegistry, type FilesRuntimeHooks, NuxtFilesSingleStorage, NuxtFilesStorageRegistry, type SingleStorage, type StorageRegistry, configureFiles, _default as default, inspectFiles, useServerFiles };
+export { _default as default };
 //# sourceMappingURL=nitro.d.ts.map

package/dist/nitro.js

@@ -1,6 +1,4 @@
 import { setupNitroFilesIntegration } from "./integration/nitro.js";
-import { FilesRegistry } from "./runtime/registry.js";
-import { configureFiles, inspectFiles, useServerFiles } from "./runtime.js";
 import { resolve } from "node:path";
 //#region src/nitro.ts
 /**
@@ -11,10 +9,10 @@ var nitro_default = {
 	name: "nuxt-files-sdk",
 	setup: (nitro) => setupNitroFilesIntegration(nitro, {
 		configPath: resolve(nitro.options.rootDir, "files.config.ts"),
-		development: Boolean(nitro.options.dev)
+		environments: nitro.options.static ? ["production", "prerender"] : [nitro.options.dev ? "development" : "production"]
 	})
 };
 //#endregion
-export { FilesRegistry, configureFiles, nitro_default as default, inspectFiles, useServerFiles };
+export { nitro_default as default };
 
 //# sourceMappingURL=nitro.js.map

package/dist/nitro.js.map

@@ -1 +1 @@
-{"version":3,"file":"nitro.js","names":[],"sources":["../src/nitro.ts"],"sourcesContent":["import { resolve } from 'node:path'\n\nimport { setupNitroFilesIntegration, type NitroIntegration } from './integration/nitro'\n\n/**\n * A structurally compatible Nitro v2/v3 module. Nitro loads this export\n * directly from `modules: ['nuxt-files-sdk/nitro']`.\n */\nexport default {\n    name: 'nuxt-files-sdk',\n    setup: (nitro: NitroIntegration) =>\n        setupNitroFilesIntegration(nitro, {\n            configPath: resolve(nitro.options.rootDir, 'files.config.ts'),\n            development: Boolean(nitro.options.dev),\n        }),\n}\n\nexport * from './runtime'\n"],"mappings":";;;;;;;;;AAQA,IAAA,gBAAe;CACX,MAAM;CACN,QAAQ,UACJ,2BAA2B,OAAO;EAC9B,YAAY,QAAQ,MAAM,QAAQ,SAAS,iBAAiB;EAC5D,aAAa,QAAQ,MAAM,QAAQ,GAAG;CAC1C,CAAC;AACT"}
+{"version":3,"file":"nitro.js","names":[],"sources":["../src/nitro.ts"],"sourcesContent":["import { resolve } from 'node:path'\n\nimport { setupNitroFilesIntegration, type NitroIntegration } from './integration/nitro'\n\n/**\n * A structurally compatible Nitro v2/v3 module. Nitro loads this export\n * directly from `modules: ['nuxt-files-sdk/nitro']`.\n */\nexport default {\n    name: 'nuxt-files-sdk',\n    setup: (nitro: NitroIntegration) =>\n        setupNitroFilesIntegration(nitro, {\n            configPath: resolve(nitro.options.rootDir, 'files.config.ts'),\n            environments: nitro.options.static\n                ? ['production', 'prerender']\n                : [nitro.options.dev ? 'development' : 'production'],\n        }),\n}\n"],"mappings":";;;;;;;AAQA,IAAA,gBAAe;CACX,MAAM;CACN,QAAQ,UACJ,2BAA2B,OAAO;EAC9B,YAAY,QAAQ,MAAM,QAAQ,SAAS,iBAAiB;EAC5D,cAAc,MAAM,QAAQ,SACtB,CAAC,cAAc,WAAW,IAC1B,CAAC,MAAM,QAAQ,MAAM,gBAAgB,YAAY;CAC3D,CAAC;AACT"}

package/dist/package.js

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

package/dist/runtime/internal.d.ts

@@ -0,0 +1,11 @@
+import { FilesConfig } from "../config.js";
+import { FilesRegistry } from "./registry.js";
+import { Files } from "files-sdk";
+//#region src/runtime/internal.d.ts
+/** 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: () => ReturnType<FilesRegistry['inspect']>;
+export declare const getFiles: (name?: string) => Files;
+//#endregion
+//# sourceMappingURL=internal.d.ts.map

package/dist/runtime/internal.js

@@ -0,0 +1,30 @@
+import { FilesRegistry } from "./registry.js";
+//#region src/runtime/internal.ts
+let registry;
+let registryDiagnostic;
+/** Configure the process-local Files registry used by {@link useServerFiles}. */
+const configureFiles = (config, options) => {
+	try {
+		const value = new FilesRegistry(config, options);
+		registry = value;
+		registryDiagnostic = void 0;
+		return value;
+	} catch (error) {
+		registry = void 0;
+		registryDiagnostic = { code: "NUXT_FILES_INVALID_CONFIG" };
+		throw error;
+	}
+};
+/** Return secret-free diagnostics for the configured process-local Files registry. */
+const inspectFiles = () => registry?.inspect() ?? {
+	storages: [],
+	diagnostics: [registryDiagnostic ?? { code: "NUXT_FILES_NOT_CONFIGURED" }]
+};
+const getFiles = (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);
+};
+//#endregion
+export { configureFiles, getFiles, inspectFiles };
+
+//# sourceMappingURL=internal.js.map

package/dist/runtime/internal.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"internal.js","names":[],"sources":["../../src/runtime/internal.ts"],"sourcesContent":["import type { Files } from 'files-sdk'\n\nimport type { FilesConfig } from '../config'\nimport { FilesRegistry, type RegistryDiagnostic } from './registry'\n\nlet registry: FilesRegistry | undefined\nlet registryDiagnostic: RegistryDiagnostic | 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    try {\n        const value = new FilesRegistry(config, options)\n        registry = value\n        registryDiagnostic = undefined\n        return value\n    } catch (error) {\n        registry = undefined\n        registryDiagnostic = { code: 'NUXT_FILES_INVALID_CONFIG' }\n        throw error\n    }\n}\n\n/** Return secret-free diagnostics for the configured process-local Files registry. */\nexport const inspectFiles = (): ReturnType<FilesRegistry['inspect']> =>\n    registry?.inspect() ?? {\n        storages: [],\n        diagnostics: [registryDiagnostic ?? { code: 'NUXT_FILES_NOT_CONFIGURED' }],\n    }\n\nexport const getFiles = (name?: string): Files => {\n    if (!registry) throw new Error('[nuxt-files-sdk:not-configured] The Files registry has not been configured.')\n    return name === undefined ? registry.get() : (registry.get as (storage: string) => Files)(name)\n}\n"],"mappings":";;AAKA,IAAI;AACJ,IAAI;;AAGJ,MAAa,kBACT,QACA,YACmB;CACnB,IAAI;EACA,MAAM,QAAQ,IAAI,cAAc,QAAQ,OAAO;EAC/C,WAAW;EACX,qBAAqB,KAAA;EACrB,OAAO;CACX,SAAS,OAAO;EACZ,WAAW,KAAA;EACX,qBAAqB,EAAE,MAAM,4BAA4B;EACzD,MAAM;CACV;AACJ;;AAGA,MAAa,qBACT,UAAU,QAAQ,KAAK;CACnB,UAAU,CAAC;CACX,aAAa,CAAC,sBAAsB,EAAE,MAAM,4BAA4B,CAAC;AAC7E;AAEJ,MAAa,YAAY,SAAyB;CAC9C,IAAI,CAAC,UAAU,MAAM,IAAI,MAAM,6EAA6E;CAC5G,OAAO,SAAS,KAAA,IAAY,SAAS,IAAI,IAAK,SAAS,IAAmC,IAAI;AAClG"}

package/dist/runtime/normalize.js

@@ -0,0 +1,29 @@
+//#region src/runtime/normalize.ts
+const isObject = (value) => value !== null && typeof value === "object" && !Array.isArray(value);
+const isStorage = (value) => isObject(value) && (typeof value.adapter === "string" || typeof value.adapter === "function");
+/** Validate one resolved config without selecting an environment or evaluating provider options. */
+const normalizeFilesConfig = (config) => {
+	if (!isObject(config)) throw new Error("[nuxt-files-sdk:invalid-config] Files configuration must be an object.");
+	const { storage } = config;
+	if (!isObject(storage)) throw new Error("[nuxt-files-sdk:invalid-config] At least one storage is required.");
+	const entries = /* @__PURE__ */ new Map();
+	if (isStorage(storage)) entries.set(void 0, {
+		name: void 0,
+		storage
+	});
+	else {
+		if (!Object.keys(storage).length) throw new Error("[nuxt-files-sdk:invalid-config] At least one storage is required.");
+		for (const [name, value] of Object.entries(storage)) {
+			if (!isStorage(value)) throw new Error(`[nuxt-files-sdk:invalid-config] Invalid storage "${name}".`);
+			entries.set(name, {
+				name,
+				storage: value
+			});
+		}
+	}
+	return entries;
+};
+//#endregion
+export { normalizeFilesConfig };
+
+//# sourceMappingURL=normalize.js.map

package/dist/runtime/normalize.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"normalize.js","names":[],"sources":["../../src/runtime/normalize.ts"],"sourcesContent":["import type { StorageConfig } from '../config'\n\nexport interface StorageEntry {\n    name: string | undefined\n    storage: StorageConfig\n}\n\nconst isObject = (value: unknown): value is Record<string, unknown> =>\n    value !== null && typeof value === 'object' && !Array.isArray(value)\nconst isStorage = (value: unknown): value is StorageConfig =>\n    isObject(value) && (typeof value.adapter === 'string' || typeof value.adapter === 'function')\n\n/** Validate one resolved config without selecting an environment or evaluating provider options. */\nexport const normalizeFilesConfig = (config: unknown): Map<string | undefined, StorageEntry> => {\n    if (!isObject(config)) throw new Error('[nuxt-files-sdk:invalid-config] Files configuration must be an object.')\n    const { storage } = config\n    if (!isObject(storage)) throw new Error('[nuxt-files-sdk:invalid-config] At least one storage is required.')\n    const entries = new Map<string | undefined, StorageEntry>()\n    if (isStorage(storage)) {\n        entries.set(undefined, { name: undefined, storage })\n    } else {\n        if (!Object.keys(storage).length)\n            throw new Error('[nuxt-files-sdk:invalid-config] At least one storage is required.')\n        for (const [name, value] of Object.entries(storage)) {\n            if (!isStorage(value)) throw new Error(`[nuxt-files-sdk:invalid-config] Invalid storage \"${name}\".`)\n            entries.set(name, { name, storage: value })\n        }\n    }\n    return entries\n}\n"],"mappings":";AAOA,MAAM,YAAY,UACd,UAAU,QAAQ,OAAO,UAAU,YAAY,CAAC,MAAM,QAAQ,KAAK;AACvE,MAAM,aAAa,UACf,SAAS,KAAK,MAAM,OAAO,MAAM,YAAY,YAAY,OAAO,MAAM,YAAY;;AAGtF,MAAa,wBAAwB,WAA2D;CAC5F,IAAI,CAAC,SAAS,MAAM,GAAG,MAAM,IAAI,MAAM,wEAAwE;CAC/G,MAAM,EAAE,YAAY;CACpB,IAAI,CAAC,SAAS,OAAO,GAAG,MAAM,IAAI,MAAM,mEAAmE;CAC3G,MAAM,0BAAU,IAAI,IAAsC;CAC1D,IAAI,UAAU,OAAO,GACjB,QAAQ,IAAI,KAAA,GAAW;EAAE,MAAM,KAAA;EAAW;CAAQ,CAAC;MAChD;EACH,IAAI,CAAC,OAAO,KAAK,OAAO,CAAC,CAAC,QACtB,MAAM,IAAI,MAAM,mEAAmE;EACvF,KAAK,MAAM,CAAC,MAAM,UAAU,OAAO,QAAQ,OAAO,GAAG;GACjD,IAAI,CAAC,UAAU,KAAK,GAAG,MAAM,IAAI,MAAM,oDAAoD,KAAK,GAAG;GACnG,QAAQ,IAAI,MAAM;IAAE;IAAM,SAAS;GAAM,CAAC;EAC9C;CACJ;CACA,OAAO;AACX"}