nuxt-files-sdk 0.1.0 → 0.2.0

package/dist/integration/nitro.js

@@ -1,11 +1,14 @@
-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, readFile, writeFile } from "node:fs/promises";
-import { createRequire } from "node:module";
-import { fileURLToPath } from "node:url";
-import { getProvider, listEnvVars } from "files-sdk/providers";
+import { fileHash } from "../runtime/development.js";
+import { registerSdkAliases, resolveOwnedSdk, resolvePackage, sdkTypePaths } from "./resolve.js";
+import { prepareFilesConfig } from "../config/prepare.js";
+import { deploymentTarget, storageDependencies } from "./dependencies.js";
+import { dependencySession, diagnoseDependencies, reportDependencyIssues } from "./diagnostics.js";
+import { configSources, subpathDependencies } from "./imports.js";
+import { watchFiles, writeChanged } from "./update.js";
+import { basename, resolve } from "node:path";
+import { mkdir } from "node:fs/promises";
+import { fileURLToPath, pathToFileURL } from "node:url";
+import { getProvider } from "files-sdk/providers";
 //#region src/integration/nitro.ts
 const AWS_CORE_DEPENDENCIES = [
 	"@aws-sdk/client-s3",
@@ -29,48 +32,38 @@ const optionalAwsSdkDependencies = (adapters, options) => {
 	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 });
+const missingAwsSdkShim = (dependency) => `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 awsVirtualId = (dependency) => `virtual:nuxt-files-sdk/optional/${dependency.replaceAll(/[^a-z0-9]+/giu, "-")}`;
+/** Apply the retained Nitro 2 workerd compatibility after native preset resolution. */
+const wireNuxtNitroAwsOptions = (value, options) => {
+	const nitro = value;
+	const aliases = nitro.options.alias ??= {};
+	for (const dependency of [...AWS_CORE_DEPENDENCIES, AWS_MULTIPART_DEPENDENCY]) {
+		const id = awsVirtualId(dependency);
+		if (aliases[dependency] === id && nitro.options.virtual?.[id] === missingAwsSdkShim(dependency)) {
+			delete aliases[dependency];
+			delete nitro.options.virtual[id];
+		}
+	}
+	const missing = optionalAwsSdkDependencies(options.adapters, {
+		nitroMajor: options.nitroMajor,
+		preset: nitro.options.preset,
+		resolvable: (dependency) => Object.hasOwn(aliases, dependency) || resolvePackage(dependency, pathToFileURL(options.sdk.manifestPath)).status === "resolved"
+	});
+	for (const dependency of missing) {
+		const id = awsVirtualId(dependency);
+		aliases[dependency] = id;
+		(nitro.options.virtual ??= {})[id] = missingAwsSdkShim(dependency);
 	}
-	return selected;
+	return missing;
 };
-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"),
-	factories: adapters.map((adapter, index) => `${JSON.stringify(adapter)}: provider${index}`).join(", ")
-});
+const nitroMajorVersion = (nitro) => nitro.meta?.majorVersion ?? ("routing" in nitro ? 3 : 2);
 const hookTypes = (moduleName) => `
 declare module ${JSON.stringify(moduleName)} {
   interface NitroRuntimeHooks {
-    'files:action': (payload: { event: import('files-sdk').FilesActionEvent; storage?: string }) => void | Promise<void>
-    'files:error': (payload: { event: import('files-sdk').FilesErrorEvent; storage?: string }) => void | Promise<void>
-    'files:retry': (payload: { event: import('files-sdk').FilesRetryEvent; storage?: string }) => void | Promise<void>
+    'files:action': (payload: { event: import('#files-sdk').FilesActionEvent; storage?: string }) => void | Promise<void>
+    'files:error': (payload: { event: import('#files-sdk').FilesErrorEvent; storage?: string }) => void | Promise<void>
+    'files:retry': (payload: { event: import('#files-sdk').FilesRetryEvent; storage?: string }) => void | Promise<void>
   }
 }
 `;
@@ -81,25 +74,77 @@ declare module 'nuxt-files-sdk/runtime' {
   interface NuxtFilesSingleStorage { value: SingleStorage<typeof config> }
   interface NuxtFilesStorageRegistry extends StorageRegistry<typeof config> {}
 }
-${hookTypes(nitroMajor >= 3 ? "nitro/types" : "nitropack/types")}
+${nitroMajor === 0 ? "" : hookTypes(nitroMajor >= 3 ? "nitro/types" : "nitropack/types")}
 export {}
 `;
 const setupNitroFilesIntegration = async (nitro, options) => {
+	const sdk = resolveOwnedSdk();
+	for (const dependency of [...AWS_CORE_DEPENDENCIES, AWS_MULTIPART_DEPENDENCY]) {
+		const shim = resolve(nitro.options.rootDir, nitro.options.buildDir, "nuxt-files-sdk", `${dependency.replaceAll(/[^a-z0-9]+/giu, "-")}.mjs`).replaceAll("\\", "/");
+		if (nitro.options.alias?.[dependency]?.replaceAll("\\", "/") === shim) delete nitro.options.alias[dependency];
+	}
+	nitro.options.alias = registerSdkAliases(nitro.options.alias ?? {}, sdk);
 	const configPath = options.configPath.replaceAll("\\", "/");
-	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 graph = configSources(configPath, nitro.options.alias);
+	const inputHashes = Object.fromEntries(graph.files.map((path) => [path, fileHash(path)]));
+	let prepared;
+	try {
+		prepared = await prepareFilesConfig({
+			configPath,
+			environments: options.environments,
+			alias: nitro.options.alias,
+			injectImports: nitro.unimport?.injectImports.bind(nitro.unimport)
+		});
+	} catch (error) {
+		try {
+			const requirements = graph.sdkImports.flatMap((subpath) => subpathDependencies(sdk, subpath));
+			reportDependencyIssues(diagnoseDependencies(sdk, requirements, nitro.options.alias), dependencySession(nitro.options.rootDir), (message) => nitro.logger?.warn(message));
+		} catch {}
+		throw error;
+	}
+	if (Object.entries(inputHashes).some(([path, hash]) => fileHash(path) !== hash)) throw new Error("[nuxt-files-sdk:config-changed] Files configuration changed during preparation. Retry preparation.");
+	let watcher;
+	if (nitro.options.dev) {
+		const roots = /* @__PURE__ */ new Set([
+			nitro.options.rootDir,
+			nitro.options.workspaceDir ?? nitro.options.rootDir,
+			...graph.files.map((path) => resolve(path, ".."))
+		]);
+		const watched = [
+			...graph.files,
+			sdk.manifestPath,
+			...[...roots].flatMap((root) => [
+				"package.json",
+				"bun.lock",
+				"package-lock.json",
+				"pnpm-lock.yaml",
+				"yarn.lock",
+				"node_modules/.package-lock.json"
+			].map((name) => resolve(root, name)))
+		];
+		watcher = watchFiles(watched, async () => {
+			watcher?.add(configSources(configPath, nitro.options.alias).files);
+			await prepareFilesConfig({
+				configPath,
+				environments: options.environments,
+				alias: nitro.options.alias,
+				injectImports: nitro.unimport?.injectImports.bind(nitro.unimport)
+			});
+			await (options.restart ? options.restart() : nitro.hooks.callHook?.("restart"));
+		}, (error) => nitro.logger?.warn(error instanceof Error ? error.message : String(error)));
+		nitro.hooks.hook("close", () => watcher?.close());
+	}
+	if (!prepared) return false;
 	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 writeChanged(typesPath, storageTypes(configPath, nitroMajorVersion(nitro)));
+		await writeChanged(resolve(directory, "tsconfig.json"), JSON.stringify({
+			compilerOptions: { paths: sdkTypePaths(sdk) },
+			include: [typesPath.replaceAll("\\", "/")]
+		}, null, 2));
 	};
 	await writeTypes();
 	nitro.hooks.hook("types:extend", async (types) => {
@@ -108,28 +153,29 @@ const setupNitroFilesIntegration = async (nitro, options) => {
 		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("\\", "/")];
+		Object.assign(paths, sdkTypePaths(sdk));
 	});
-	const routes = gatewayRoutes(config);
-	const { adapters } = selected;
-	const providers = providerCode(adapters);
+	const { routes, adapters, providers, environment } = prepared;
 	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, {
+	const awsShims = 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;
-			}
+			return resolvePackage(dependency, pathToFileURL(sdk.manifestPath)).status === "resolved";
 		}
-	}).map((dependency) => ({
+	});
+	const adapterDependencies = new Map(prepared.adapters.map((adapter) => [adapter, subpathDependencies(sdk, `files-sdk/${adapter}`)]));
+	const requirements = [...prepared.entries.values()].flatMap((entry) => storageDependencies(entry, deploymentTarget(nitro.options.preset), typeof entry.storage.adapter === "string" ? adapterDependencies.get(entry.storage.adapter) : []));
+	for (const subpath of graph.sdkImports) requirements.push(...subpathDependencies(sdk, subpath));
+	const dependencyDiagnostics = diagnoseDependencies(sdk, requirements, aliases, awsShims);
+	watcher?.add(requirements.flatMap(({ dependency, conditions }) => {
+		const result = resolvePackage(dependency, pathToFileURL(sdk.manifestPath), conditions);
+		return result.status === "missing" ? [] : [result.package.manifestPath];
+	}));
+	reportDependencyIssues(dependencyDiagnostics, dependencySession(nitro.options.rootDir), (message) => nitro.logger?.warn(message));
+	const shimFiles = awsShims.map((dependency) => ({
 		dependency,
 		path: resolve(directory, `${dependency.replaceAll(/[^a-z0-9]+/giu, "-")}.mjs`)
 	}));
@@ -139,7 +185,7 @@ const setupNitroFilesIntegration = async (nitro, options) => {
 	}
 	nitro.unimport?.getInternalContext().addons.push({
 		name: "nuxt-files-sdk-jsdoc",
-		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}`)
+		declaration: (declarations) => declarations.replace(/^([ \t]*)const (defineFilesConfig|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/${name === "defineFilesConfig" ? "config" : "runtime"}').${name}`)
 	});
 	const externals = nitro.options.externals ??= {};
 	(externals.inline ??= []).push("nuxt-files-sdk");
@@ -156,18 +202,17 @@ const setupNitroFilesIntegration = async (nitro, options) => {
 	nitro.options.plugins.push(pluginPath.replaceAll("\\", "/"));
 	writeRuntime = async () => {
 		await mkdir(directory, { recursive: true });
-		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));
+		await Promise.all(shimFiles.map(({ dependency, path }) => writeChanged(path, missingAwsSdkShim(dependency))));
+		await writeChanged(selectedPath, prepared.source);
 		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("\\", "/"))}
+		await writeChanged(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 writeChanged(pluginPath, `import config from ${JSON.stringify(resolvedPath.replaceAll("\\", "/"))}
 ${providers.imports}
 import { configureFiles } from ${JSON.stringify(internalPath)}
 
 export default (nitroApp) => configureFiles(config, {
+  ${nitro.options.dev ? `dependencies: ${JSON.stringify(dependencyDiagnostics)},` : ""}
   factories: { ${providers.factories} },
   environment: ${JSON.stringify(environment)},
   hooks: {
@@ -179,20 +224,18 @@ export default (nitroApp) => configureFiles(config, {
 `);
 		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'"}
+			const request = nitroMajorVersion(nitro) >= 3 ? "event.req" : "toWebRequest(event)";
+			return writeChanged(path, `import config from ${JSON.stringify(resolvedPath.replaceAll("\\", "/"))}
+import { createFilesRouter } from '#files-sdk/api'
+${nitroMajorVersion(nitro) >= 3 ? "" : "import { toWebRequest } from 'h3'"}
+import { nitroRequestEvent, nitroResponse } from ${JSON.stringify(fileURLToPath(new URL("./nitro-event.js", import.meta.url)).replaceAll("\\", "/"))}
 import { getFiles } from ${JSON.stringify(internalPath)}
+import { resolveGatewaySecret } from ${JSON.stringify(fileURLToPath(new URL("../runtime/gateway-secret.js", import.meta.url)).replaceAll("\\", "/"))}
+${nitro.options.dev ? `import { developmentConfigCurrent } from ${JSON.stringify(fileURLToPath(new URL("../runtime/development.js", import.meta.url)).replaceAll("\\", "/"))}\nconst inputHashes = ${JSON.stringify(inputHashes)}` : ""}
 
 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.')
-}
+const secret = await resolveGatewaySecret(route.secret, environmentSecret)
 let sharedRouter
 const makeRouter = (event) => createFilesRouter({
   ...route,
@@ -200,9 +243,11 @@ const makeRouter = (event) => createFilesRouter({
   secret,
   authorize: route.authorize && ((context) => route.authorize({ ...context, event })),
 })
-export default (event) => {
-  const router = route.authorize ? makeRouter(event) : (sharedRouter ??= makeRouter(event))
-  return ${handler}
+export default async (event) => {
+  ${nitro.options.dev ? `if (!developmentConfigCurrent(inputHashes)) return new Response('Files configuration is being updated.', { status: 503 })` : ""}
+  const portable = nitroRequestEvent(${request}, event.context)
+  const router = route.authorize ? makeRouter(portable) : (sharedRouter ??= makeRouter(portable))
+  return nitroResponse(await router.handle(portable.req), portable)
 }
 `);
 		}));
@@ -210,7 +255,41 @@ export default (event) => {
 	await writeRuntime();
 	return true;
 };
+/** Preserve TypeScript compilation when Nuxt places its build directory inside node_modules. */
+const selectedSourcePlugin = (options) => {
+	const selected = options.selected.replaceAll("\\", "/");
+	const id = `nuxt-files-sdk:${basename(selected)}`;
+	return {
+		name: "nuxt-files-sdk-selected-source",
+		resolveId(source, importer) {
+			if (source.replaceAll("\\", "/") === selected) return id;
+			if (importer === id) return this.resolve(source, options.configPath, { skipSelf: true });
+			return null;
+		},
+		load(source) {
+			return source === id ? options.source : null;
+		}
+	};
+};
+/** Preserve Nuxt's runtime inline rules when Nitro 2 receives native Windows resolver paths. */
+const inlineNuxtRuntime = (id) => id.includes("\\") && /^(?:nuxt|nuxt3|nuxt-nightly)\/dist\//u.test(id.replaceAll("\\", "/").split("node_modules/").at(-1));
+/** Native bundle settings stay in the Nitro adapter, including Nuxt's Nitro-backed path. */
+const wireNuxtNitroOptions = (value, options) => {
+	const config = value;
+	config.alias = registerSdkAliases({
+		...config.alias,
+		"nuxt-files-sdk/runtime": options.runtime,
+		"#nuxt-files-sdk/registry": options.registry
+	}, options.sdk);
+	const inline = (config.externals ??= {}).inline ??= [];
+	inline.push("nuxt-files-sdk", options.runtime, options.registry, options.resolved, options.selected);
+	inline.push(inlineNuxtRuntime);
+	if (!options.development) inline.push("files-sdk");
+	((config.rollupConfig ??= {}).plugins ??= []).push(selectedSourcePlugin({
+		selected: options.selected,
+		source: options.selectedSource,
+		configPath: options.configPath
+	}));
+};
 //#endregion
-export { gatewayRoutes, optionalAwsSdkDependencies, providerCode, selectedAdapters, setupNitroFilesIntegration, storageTypes };
-
-//# sourceMappingURL=nitro.js.map
+export { inlineNuxtRuntime, optionalAwsSdkDependencies, selectedSourcePlugin, setupNitroFilesIntegration, storageTypes, wireNuxtNitroAwsOptions, wireNuxtNitroOptions };

package/dist/integration/nuxt-diagnostics.js

@@ -0,0 +1,23 @@
+import { reportDependencyIssues } from "./diagnostics.js";
+import { getAddDependencyCommand } from "@nuxt/kit";
+//#region src/integration/nuxt-diagnostics.ts
+/** Advice only: Nuxt's installer cannot guarantee zero prompts/installs on every host. */
+const reportNuxtDependencyIssues = async (diagnostics, previous, logger, root) => {
+	let message;
+	reportDependencyIssues(diagnostics, previous, (value) => {
+		message = value;
+	});
+	if (!message) return;
+	const packages = [...new Set(diagnostics.filter((entry) => entry.necessity === "required" && (entry.status === "missing" || entry.status === "incompatible")).map((entry) => {
+		const name = entry.dependency.split("/").slice(0, entry.dependency.startsWith("@") ? 2 : 1).join("/");
+		return entry.range ? `${name}@${entry.range}` : name;
+	}))];
+	if (!packages.length) {
+		logger.warn(message);
+		return;
+	}
+	const command = await getAddDependencyCommand(packages, root, { dev: false }).catch(() => void 0);
+	logger.warn(`${message}\n${command ? `Run: ${command}` : `Add production dependencies: ${packages.join(", ")}`}`);
+};
+//#endregion
+export { reportNuxtDependencyIssues };

package/dist/integration/nuxt.js

@@ -0,0 +1,235 @@
+import { filesBuilderCapabilities, requireFilesGateway } from "./capabilities.js";
+import { fileHash } from "../runtime/development.js";
+import { registerSdkAliases, resolveOwnedSdk, resolvePackage, sdkTypePaths } from "./resolve.js";
+import { prepareFilesConfig } from "../config/prepare.js";
+import { deploymentTarget, storageDependencies } from "./dependencies.js";
+import { dependencySession, diagnoseDependencies } from "./diagnostics.js";
+import { configSources, subpathDependencies } from "./imports.js";
+import { watchFiles } from "./update.js";
+import { optionalAwsSdkDependencies, storageTypes, wireNuxtNitroAwsOptions, wireNuxtNitroOptions } from "./nitro.js";
+import { stopNitroDevReloadOnClose } from "./nitro-dev-close.js";
+import { reportNuxtDependencyIssues } from "./nuxt-diagnostics.js";
+import { withFilesTask } from "./terminal.js";
+import { dirname, resolve } from "node:path";
+import { addServerHandler, addTemplate, addTypeTemplate, resolveServerVariant, useLogger, useTerminal } from "@nuxt/kit";
+import { fileURLToPath, pathToFileURL } from "node:url";
+import { parseSync } from "oxc-parser";
+//#region src/integration/nuxt.ts
+const normalized = (path) => path.replaceAll("\\", "/");
+const runtimeFile = (path) => normalized(fileURLToPath(new URL(path, import.meta.url)));
+/** Supply the module's configuration helper without evaluating any runtime resolver. */
+const injectConfigImports = async (source, filename) => {
+	return { code: parseSync(filename ?? "files.config.ts", source, { lang: "ts" }).program.body.some((node) => node.type === "ImportDeclaration" ? node.specifiers.some((specifier) => specifier.local.name === "defineFilesConfig") : node.type === "FunctionDeclaration" ? node.id?.name === "defineFilesConfig" : node.type === "VariableDeclaration" && node.declarations.some((declaration) => declaration.id.type === "Identifier" && declaration.id.name === "defineFilesConfig")) ? source : `import { defineFilesConfig } from ${JSON.stringify(runtimeFile("../config.js"))}\n${source}` };
+};
+/** Generate one runtime import graph; Nuxt never initializes Files through a Nitro startup plugin. */
+const setupNuxtFilesIntegration = async (nuxt, options) => {
+	const logger = useLogger("nuxt-files-sdk");
+	const terminal = useTerminal();
+	const configPath = normalized(options.configPath);
+	const sdk = resolveOwnedSdk();
+	nuxt.options.alias = registerSdkAliases(nuxt.options.alias, sdk, ["browser", "import"]);
+	const preparationAliases = () => {
+		const native = nuxt.options.nitro;
+		const aliases = "alias" in native && native.alias && typeof native.alias === "object" ? native.alias : {};
+		return registerSdkAliases({
+			...nuxt.options.alias,
+			...Object.fromEntries(Object.entries(aliases).filter((entry) => typeof entry[1] === "string"))
+		}, sdk, ["node", "import"]);
+	};
+	const graph = configSources(configPath, preparationAliases());
+	const inputHashes = Object.fromEntries(graph.files.map((path) => [path, fileHash(path)]));
+	const environments = nuxt.options.nitro.static ? ["production", "prerender"] : [nuxt.options.envName || (nuxt.options.dev ? "development" : "production")];
+	const prepare = () => prepareFilesConfig({
+		configPath,
+		environments,
+		alias: preparationAliases(),
+		injectImports: injectConfigImports
+	});
+	let prepared;
+	try {
+		prepared = await withFilesTask(terminal, "Preparing Files configuration", prepare);
+	} catch (error) {
+		try {
+			await reportNuxtDependencyIssues(diagnoseDependencies(sdk, graph.sdkImports.flatMap((subpath) => subpathDependencies(sdk, subpath)), preparationAliases()), dependencySession(nuxt.options.rootDir), logger, nuxt.options.rootDir);
+		} catch {}
+		throw error;
+	}
+	if (Object.entries(inputHashes).some(([path, hash]) => fileHash(path) !== hash)) throw new Error("[nuxt-files-sdk:config-changed] Files configuration changed during preparation. Retry preparation.");
+	let watcher;
+	if (nuxt.options.dev) {
+		const roots = /* @__PURE__ */ new Set([
+			nuxt.options.rootDir,
+			nuxt.options.workspaceDir,
+			...graph.files.map(dirname)
+		]);
+		watcher = watchFiles([
+			...graph.files,
+			sdk.manifestPath,
+			...[...roots].flatMap((root) => [
+				"package.json",
+				"bun.lock",
+				"package-lock.json",
+				"pnpm-lock.yaml",
+				"yarn.lock",
+				"node_modules/.package-lock.json"
+			].map((name) => resolve(root, name)))
+		], async () => {
+			watcher?.add(configSources(configPath, preparationAliases()).files);
+			await withFilesTask(terminal, "Updating Files configuration", prepare);
+			await nuxt.callHook("restart");
+		}, (error) => logger.warn(error instanceof Error ? error.message : String(error)));
+		nuxt.hook("close", () => watcher?.close());
+	}
+	if (!prepared) return false;
+	const major = resolveServerVariant({
+		nitro2: 2,
+		nitro3: 3,
+		nuxt: 0
+	}) ?? 0;
+	if (nuxt.options.dev && major === 2) nuxt.hook("nitro:init", stopNitroDevReloadOnClose);
+	let awsShims = [];
+	if (major === 2 && optionalAwsSdkDependencies(prepared.adapters, {
+		nitroMajor: major,
+		preset: "cloudflare-module",
+		resolvable: () => false
+	}).length) nuxt.hook("nitro:init", (nitro) => {
+		awsShims = wireNuxtNitroAwsOptions(nitro, {
+			sdk,
+			adapters: prepared.adapters,
+			nitroMajor: major
+		});
+	});
+	const capabilities = filesBuilderCapabilities(major === 2 ? "nitro2" : major === 3 ? "nitro3" : "nuxt");
+	requireFilesGateway(prepared.routes.length > 0, capabilities.gateway);
+	const mode = nuxt.options.dev ? ".dev" : "";
+	const template = (name, contents) => normalized(addTemplate({
+		filename: `nuxt-files-sdk/${name}${mode}.mjs`,
+		write: true,
+		getContents: () => contents
+	}).dst);
+	const selected = normalized(addTemplate({
+		filename: `nuxt-files-sdk/selected${mode}.ts`,
+		write: true,
+		getContents: () => prepared.source
+	}).dst);
+	const branches = environments.flatMap((name) => [`raw[${JSON.stringify(`$${name}`)}]`, `raw.$env?.[${JSON.stringify(name)}]`]).toReversed();
+	const resolved = template("resolved", `import raw from ${JSON.stringify(selected)}\nimport { mergeFilesConfig } from ${JSON.stringify(runtimeFile("../config/merge.js"))}\nconst resolved = mergeFilesConfig(${[...branches, "raw"].join(", ")})\nexport default { storage: resolved.storage, routes: resolved.routes }\n`);
+	const adapterDependencies = new Map(prepared.adapters.map((adapter) => [adapter, subpathDependencies(sdk, `files-sdk/${adapter}`)]));
+	const requirementsFor = (preset) => [...prepared.entries.values()].flatMap((entry) => storageDependencies(entry, deploymentTarget(preset), typeof entry.storage.adapter === "string" ? adapterDependencies.get(entry.storage.adapter) : []));
+	const requirements = requirementsFor("preset" in nuxt.options.nitro && typeof nuxt.options.nitro.preset === "string" ? nuxt.options.nitro.preset : void 0);
+	for (const subpath of graph.sdkImports) requirements.push(...subpathDependencies(sdk, subpath));
+	const diagnostics = diagnoseDependencies(sdk, requirements, preparationAliases());
+	const previous = dependencySession(nuxt.options.rootDir);
+	if (!major) await reportNuxtDependencyIssues(diagnostics, previous, logger, nuxt.options.rootDir);
+	if (major && requirements.length) nuxt.hook("nitro:init", async (value) => {
+		const native = value;
+		const resolvedRequirements = requirementsFor(native.options.preset);
+		for (const subpath of graph.sdkImports) resolvedRequirements.push(...subpathDependencies(sdk, subpath));
+		await reportNuxtDependencyIssues(diagnoseDependencies(sdk, resolvedRequirements, native.options.alias, awsShims), previous, logger, nuxt.options.rootDir);
+	});
+	watcher?.add(requirements.flatMap(({ dependency, conditions }) => {
+		const result = resolvePackage(dependency, pathToFileURL(sdk.manifestPath), conditions);
+		return result.status === "missing" ? [] : [result.package.manifestPath];
+	}));
+	const hooksImport = major === 2 ? "import { useNitroApp } from 'nitropack/runtime'" : major === 3 ? "import { useNitroHooks } from 'nitro/app'" : "";
+	const callHook = major === 2 ? "useNitroApp().hooks.callHook" : "useNitroHooks().callHook";
+	const registry = template("registry", `import config from ${JSON.stringify(resolved)}\n${prepared.providers.imports}\nimport { configureFiles } from ${JSON.stringify(runtimeFile("../runtime/internal.js"))}\n${hooksImport}\n\nexport const registry = configureFiles(config, {\n  factories: { ${prepared.providers.factories} },\n  environment: ${JSON.stringify(prepared.environment)},\n  ${nuxt.options.dev ? `dependencies: ${JSON.stringify(diagnostics)},` : ""}\n  ${major ? `hooks: {\n    onAction: (event, storage) => ${callHook}('files:action', { event, storage }),\n    onError: (event, storage) => ${callHook}('files:error', { event, storage }),\n    onRetry: (event, storage) => ${callHook}('files:retry', { event, storage }),\n  },` : ""}\n})\n`);
+	const runtime = template("runtime", `import { registry } from '#nuxt-files-sdk/registry'
+import { sync, transfer } from '#files-sdk'
+export const useServerFiles = name => name === undefined ? registry.get() : registry.get(name)
+const files = value => typeof value === 'string' ? registry.get(value) : value
+export const syncFiles = (source, destination, options) => sync(files(source), files(destination), options)
+export const transferFiles = (source, destination, options) => transfer(files(source), files(destination), options)
+`);
+	addTypeTemplate({
+		filename: `nuxt-files-sdk/runtime${mode}.d.ts`,
+		getContents: () => `export * from ${JSON.stringify(runtimeFile("../runtime.js"))}\n`
+	}, { nuxt: false });
+	nuxt.options.alias["nuxt-files-sdk/runtime"] = runtime;
+	nuxt.options.alias["#nuxt-files-sdk/registry"] = registry;
+	nuxt.hook("nitro:config", (config) => wireNuxtNitroOptions(config, {
+		sdk,
+		runtime,
+		registry,
+		resolved,
+		selected,
+		selectedSource: prepared.source,
+		configPath,
+		development: nuxt.options.dev
+	}));
+	const declarations = addTypeTemplate({
+		filename: "nuxt-files-sdk/storage-registry.d.ts",
+		getContents: () => storageTypes(configPath, major) + `
+declare global {
+  /** Return the project's Files client, including its configured plugin extensions. */
+  const useServerFiles: typeof import('nuxt-files-sdk/runtime').useServerFiles
+  /** Delegate a mirror operation to the native Files SDK. */
+  const syncFiles: typeof import('nuxt-files-sdk/runtime').syncFiles
+  /** Delegate a transfer operation to the native Files SDK. */
+  const transferFiles: typeof import('nuxt-files-sdk/runtime').transferFiles
+}
+`
+	}, {
+		nuxt: true,
+		nitro: true,
+		shared: true
+	});
+	nuxt.hook("prepare:types", ({ references, nodeReferences, sharedReferences, serverReferences, tsConfig, nodeTsConfig, sharedTsConfig, serverTsConfig }) => {
+		for (const values of [
+			references,
+			nodeReferences,
+			sharedReferences,
+			serverReferences
+		]) if (!values.some((entry) => "path" in entry && entry.path === declarations.dst)) values.push({ path: declarations.dst });
+		for (const config of [
+			tsConfig,
+			nodeTsConfig,
+			sharedTsConfig,
+			serverTsConfig
+		]) {
+			(config.include ??= []).push(configPath);
+			Object.assign((config.compilerOptions ??= {}).paths ??= {}, sdkTypePaths(sdk), { "nuxt-files-sdk/runtime": [runtimeFile("../runtime.d.ts")] });
+		}
+	});
+	for (const [index, route] of prepared.routes.entries()) {
+		const handler = template(`gateway-${index}`, `import { defineEventHandler, deriveSecret } from 'nuxt/server'
+import config from ${JSON.stringify(resolved)}
+import { createFilesRouter } from '#files-sdk/api'
+import { useServerFiles } from 'nuxt-files-sdk/runtime'
+import { resolveGatewaySecret } from ${JSON.stringify(runtimeFile("../runtime/gateway-secret.js"))}
+${nuxt.options.dev ? `import { developmentConfigCurrent } from ${JSON.stringify(runtimeFile("../runtime/development.js"))}\nconst inputHashes = ${JSON.stringify(inputHashes)}` : ""}
+const route = config.routes[${index}]
+let secretPromise
+const gatewaySecret = () => secretPromise ??= resolveGatewaySecret(
+  route.secret,
+  typeof process === 'undefined' ? undefined : process.env?.FILES_API_SECRET,
+  () => deriveSecret(${JSON.stringify(`nuxt-files-sdk:gateway:${route.path}`)}),
+).catch(error => {
+  secretPromise = undefined
+  throw error
+})
+let sharedRouter
+const makeRouter = (event, secret) => createFilesRouter({
+  ...route,
+  files: () => useServerFiles(${route.storage === void 0 ? "" : JSON.stringify(route.storage)}),
+  secret,
+  authorize: route.authorize && ((context) => route.authorize({ ...context, event })),
+})
+export default defineEventHandler(async event => {
+  ${nuxt.options.dev ? "if (!developmentConfigCurrent(inputHashes)) return new Response('Files configuration is being updated.', { status: 503 })" : ""}
+  const secret = await gatewaySecret()
+  const router = route.authorize
+    ? makeRouter(event, secret)
+    : (sharedRouter ??= makeRouter(event, secret))
+  return router.handle(event.req)
+})
+`);
+		addServerHandler({
+			route: route.path,
+			handler: { nuxt: handler }
+		});
+	}
+	return true;
+};
+//#endregion
+export { setupNuxtFilesIntegration };

package/dist/integration/resolve.d.ts

@@ -0,0 +1 @@
+import { getPackageInfoSync } from "local-pkg";