nuxt-files-sdk 0.0.5 → 0.1.0

package/dist/devtools/files.js

@@ -1,4 +1,6 @@
-import { inspectFiles, useServerFiles } from "../runtime.js";
+import { inspectFiles } from "../runtime/internal.js";
+import { useServerFiles } from "../runtime.js";
+import { authorizeFilesDevtoolsRequest } from "./auth.js";
 import { FILES_DEVTOOLS_MAX_UPLOAD_SIZE } from "./snapshot.js";
 import { createFilesRouter } from "files-sdk/api";
 import { createRouteHandler } from "files-sdk/nitro";
@@ -33,12 +35,13 @@ const createFilesDevtoolsHandler = (write) => {
 		maxUploadSize: FILES_DEVTOOLS_MAX_UPLOAD_SIZE,
 		secret: crypto.randomUUID()
 	}));
-	return (event) => {
+	return async (event, secret) => {
+		if (!await authorizeFilesDevtoolsRequest(event.node.req, secret)) return new Response(null, { status: 401 });
 		const url = new URL(event.node.req.url ?? "/", "http://nuxt-files-sdk.local");
-		if (event.node.req.method === "GET" && url.searchParams.get("op") === "devtools") return Promise.resolve(Response.json({
+		if (event.node.req.method === "GET" && url.searchParams.get("op") === "devtools") return Response.json({
 			write,
 			maxUploadSize: FILES_DEVTOOLS_MAX_UPLOAD_SIZE
-		}));
+		});
 		return handleFiles(event);
 	};
 };

package/dist/devtools/files.js.map

@@ -1 +1 @@
-{"version":3,"file":"files.js","names":[],"sources":["../../src/devtools/files.ts"],"sourcesContent":["import type { Files } from 'files-sdk'\nimport { createFilesRouter, type FilesOperation } from 'files-sdk/api'\nimport { createRouteHandler } from 'files-sdk/nitro'\n\nimport { inspectFiles, useServerFiles } from '../runtime'\nimport { FILES_DEVTOOLS_MAX_UPLOAD_SIZE } from './snapshot'\n\nconst readOperations = ['capabilities', 'list', 'exists', 'download'] as const satisfies readonly FilesOperation[]\nconst writeOperations = [...readOperations, 'upload', 'delete'] as const satisfies readonly FilesOperation[]\nexport const filesDevtoolsOperations = (write: boolean): readonly FilesOperation[] =>\n    write ? writeOperations : readOperations\nconst getFiles: (name?: string) => Files = useServerFiles\n\nconst resolveFiles = (request: Request): Files => {\n    const requested = new URL(request.url).searchParams.get('storage') ?? undefined\n    const storages = inspectFiles().storages\n    if (storages.length === 1 && storages[0]?.name === undefined) {\n        if (requested !== undefined) throw new Error(`[nuxt-files-sdk:unknown-storage] Unknown storage \"${requested}\".`)\n        return getFiles()\n    }\n    if (requested === undefined || !storages.some(({ name }) => name === requested)) {\n        throw new Error('[nuxt-files-sdk:unknown-storage] Select a configured storage.')\n    }\n    return getFiles(requested)\n}\n\nexport const createFilesDevtoolsHandler = (write: boolean) => {\n    const handleFiles = createRouteHandler(\n        createFilesRouter({\n            files: resolveFiles,\n            operations: filesDevtoolsOperations(write),\n            maxUploadSize: FILES_DEVTOOLS_MAX_UPLOAD_SIZE,\n            secret: crypto.randomUUID(),\n        }),\n    )\n    return (event: Parameters<typeof handleFiles>[0]): Promise<Response> => {\n        const url = new URL(event.node.req.url ?? '/', 'http://nuxt-files-sdk.local')\n        if (event.node.req.method === 'GET' && url.searchParams.get('op') === 'devtools') {\n            return Promise.resolve(Response.json({ write, maxUploadSize: FILES_DEVTOOLS_MAX_UPLOAD_SIZE }))\n        }\n        return handleFiles(event)\n    }\n}\n"],"mappings":";;;;;AAOA,MAAM,iBAAiB;CAAC;CAAgB;CAAQ;CAAU;AAAU;AACpE,MAAM,kBAAkB;CAAC,GAAG;CAAgB;CAAU;AAAQ;AAC9D,MAAa,2BAA2B,UACpC,QAAQ,kBAAkB;AAC9B,MAAM,WAAqC;AAE3C,MAAM,gBAAgB,YAA4B;CAC9C,MAAM,YAAY,IAAI,IAAI,QAAQ,GAAG,CAAC,CAAC,aAAa,IAAI,SAAS,KAAK,KAAA;CACtE,MAAM,WAAW,aAAa,CAAC,CAAC;CAChC,IAAI,SAAS,WAAW,KAAK,SAAS,EAAE,EAAE,SAAS,KAAA,GAAW;EAC1D,IAAI,cAAc,KAAA,GAAW,MAAM,IAAI,MAAM,qDAAqD,UAAU,GAAG;EAC/G,OAAO,SAAS;CACpB;CACA,IAAI,cAAc,KAAA,KAAa,CAAC,SAAS,MAAM,EAAE,WAAW,SAAS,SAAS,GAC1E,MAAM,IAAI,MAAM,+DAA+D;CAEnF,OAAO,SAAS,SAAS;AAC7B;AAEA,MAAa,8BAA8B,UAAmB;CAC1D,MAAM,cAAc,mBAChB,kBAAkB;EACd,OAAO;EACP,YAAY,wBAAwB,KAAK;EACzC,eAAe;EACf,QAAQ,OAAO,WAAW;CAC9B,CAAC,CACL;CACA,QAAQ,UAAgE;EACpE,MAAM,MAAM,IAAI,IAAI,MAAM,KAAK,IAAI,OAAO,KAAK,6BAA6B;EAC5E,IAAI,MAAM,KAAK,IAAI,WAAW,SAAS,IAAI,aAAa,IAAI,IAAI,MAAM,YAClE,OAAO,QAAQ,QAAQ,SAAS,KAAK;GAAE;GAAO,eAAe;EAA+B,CAAC,CAAC;EAElG,OAAO,YAAY,KAAK;CAC5B;AACJ"}
+{"version":3,"file":"files.js","names":[],"sources":["../../src/devtools/files.ts"],"sourcesContent":["import type { Files } from 'files-sdk'\nimport { createFilesRouter, type FilesOperation } from 'files-sdk/api'\nimport { createRouteHandler } from 'files-sdk/nitro'\n\nimport { useServerFiles } from '../runtime'\nimport { inspectFiles } from '../runtime/internal'\nimport { authorizeFilesDevtoolsRequest } from './auth'\nimport { FILES_DEVTOOLS_MAX_UPLOAD_SIZE } from './snapshot'\n\nconst readOperations = ['capabilities', 'list', 'exists', 'download'] as const satisfies readonly FilesOperation[]\nconst writeOperations = [...readOperations, 'upload', 'delete'] as const satisfies readonly FilesOperation[]\nexport const filesDevtoolsOperations = (write: boolean): readonly FilesOperation[] =>\n    write ? writeOperations : readOperations\nconst getFiles: (name?: string) => Files = useServerFiles\n\nconst resolveFiles = (request: Request): Files => {\n    const requested = new URL(request.url).searchParams.get('storage') ?? undefined\n    const storages = inspectFiles().storages\n    if (storages.length === 1 && storages[0]?.name === undefined) {\n        if (requested !== undefined) throw new Error(`[nuxt-files-sdk:unknown-storage] Unknown storage \"${requested}\".`)\n        return getFiles()\n    }\n    if (requested === undefined || !storages.some(({ name }) => name === requested)) {\n        throw new Error('[nuxt-files-sdk:unknown-storage] Select a configured storage.')\n    }\n    return getFiles(requested)\n}\n\nexport const createFilesDevtoolsHandler = (write: boolean) => {\n    const handleFiles = createRouteHandler(\n        createFilesRouter({\n            files: resolveFiles,\n            operations: filesDevtoolsOperations(write),\n            maxUploadSize: FILES_DEVTOOLS_MAX_UPLOAD_SIZE,\n            secret: crypto.randomUUID(),\n        }),\n    )\n    return async (event: Parameters<typeof handleFiles>[0], secret: string): Promise<Response> => {\n        if (!(await authorizeFilesDevtoolsRequest(event.node.req, secret))) {\n            return new Response(null, { status: 401 })\n        }\n        const url = new URL(event.node.req.url ?? '/', 'http://nuxt-files-sdk.local')\n        if (event.node.req.method === 'GET' && url.searchParams.get('op') === 'devtools') {\n            return Response.json({ write, maxUploadSize: FILES_DEVTOOLS_MAX_UPLOAD_SIZE })\n        }\n        return handleFiles(event)\n    }\n}\n"],"mappings":";;;;;;;AASA,MAAM,iBAAiB;CAAC;CAAgB;CAAQ;CAAU;AAAU;AACpE,MAAM,kBAAkB;CAAC,GAAG;CAAgB;CAAU;AAAQ;AAC9D,MAAa,2BAA2B,UACpC,QAAQ,kBAAkB;AAC9B,MAAM,WAAqC;AAE3C,MAAM,gBAAgB,YAA4B;CAC9C,MAAM,YAAY,IAAI,IAAI,QAAQ,GAAG,CAAC,CAAC,aAAa,IAAI,SAAS,KAAK,KAAA;CACtE,MAAM,WAAW,aAAa,CAAC,CAAC;CAChC,IAAI,SAAS,WAAW,KAAK,SAAS,EAAE,EAAE,SAAS,KAAA,GAAW;EAC1D,IAAI,cAAc,KAAA,GAAW,MAAM,IAAI,MAAM,qDAAqD,UAAU,GAAG;EAC/G,OAAO,SAAS;CACpB;CACA,IAAI,cAAc,KAAA,KAAa,CAAC,SAAS,MAAM,EAAE,WAAW,SAAS,SAAS,GAC1E,MAAM,IAAI,MAAM,+DAA+D;CAEnF,OAAO,SAAS,SAAS;AAC7B;AAEA,MAAa,8BAA8B,UAAmB;CAC1D,MAAM,cAAc,mBAChB,kBAAkB;EACd,OAAO;EACP,YAAY,wBAAwB,KAAK;EACzC,eAAe;EACf,QAAQ,OAAO,WAAW;CAC9B,CAAC,CACL;CACA,OAAO,OAAO,OAA0C,WAAsC;EAC1F,IAAI,CAAE,MAAM,8BAA8B,MAAM,KAAK,KAAK,MAAM,GAC5D,OAAO,IAAI,SAAS,MAAM,EAAE,QAAQ,IAAI,CAAC;EAE7C,MAAM,MAAM,IAAI,IAAI,MAAM,KAAK,IAAI,OAAO,KAAK,6BAA6B;EAC5E,IAAI,MAAM,KAAK,IAAI,WAAW,SAAS,IAAI,aAAa,IAAI,IAAI,MAAM,YAClE,OAAO,SAAS,KAAK;GAAE;GAAO,eAAe;EAA+B,CAAC;EAEjF,OAAO,YAAY,KAAK;CAC5B;AACJ"}

package/dist/devtools/index.js

@@ -1,24 +1,42 @@
-import { FILES_DEVTOOLS_MAX_UPLOAD_SIZE, FILES_DEVTOOLS_PATH, FILES_GATEWAY_PATH, FILES_SNAPSHOT_PATH } from "./snapshot.js";
+import { FILES_DEVTOOLS_MAX_UPLOAD_SIZE, FILES_DEVTOOLS_PATH, FILES_GATEWAY_PATH, FILES_SNAPSHOT_PATH, FILES_TOKEN_PATH } from "./snapshot.js";
 import nuxt_v3_handler_default from "./nuxt-v3-handler.js";
+import token_default from "./token.js";
 import { setupNuxtV3Devtools } from "./nuxt-v3.js";
 import { setupNuxtV4Devtools } from "./nuxt-v4.js";
-import { addDevServerHandler, addServerHandler } from "@nuxt/kit";
+import { addDevServerHandler, addServerHandler, addServerTemplate } from "@nuxt/kit";
 import { fileURLToPath } from "node:url";
 //#region src/devtools/index.ts
-const setupFilesDevtools = (nuxt, version, write) => {
+const authenticatedHandler = (name, path, arguments_) => {
+	const filename = `#nuxt-files-sdk/${name}`;
+	addServerTemplate({
+		filename,
+		getContents: () => `import handler from ${JSON.stringify(path.replaceAll("\\", "/"))}\nexport default event => handler(event, ${arguments_.map((value) => JSON.stringify(value)).join(", ")})\n`
+	});
+	return filename;
+};
+const setupFilesDevtools = (nuxt, version, write, secrets) => {
 	addServerHandler({
 		route: FILES_SNAPSHOT_PATH,
-		handler: fileURLToPath(new URL("./snapshot.js", import.meta.url))
+		handler: authenticatedHandler("snapshot", fileURLToPath(new URL("./snapshot.js", import.meta.url)), [secrets.token])
 	});
 	addServerHandler({
 		route: FILES_GATEWAY_PATH,
-		handler: fileURLToPath(new URL(write ? "./files-write.js" : "./files-read.js", import.meta.url))
+		handler: authenticatedHandler("files", fileURLToPath(new URL(write ? "./files-write.js" : "./files-read.js", import.meta.url)), [secrets.token])
 	});
 	if (Number.parseInt(version) >= 4) setupNuxtV4Devtools(nuxt, {
 		write,
-		maxUploadSize: FILES_DEVTOOLS_MAX_UPLOAD_SIZE
+		maxUploadSize: FILES_DEVTOOLS_MAX_UPLOAD_SIZE,
+		tokenSecret: secrets.token
 	});
 	else {
+		addDevServerHandler({
+			route: FILES_TOKEN_PATH,
+			handler: (event) => token_default(event, secrets.token, async (token) => {
+				const host = "devtools" in nuxt ? nuxt.devtools : void 0;
+				if (!host || typeof host !== "object" || !("ensureDevAuthToken" in host) || typeof host.ensureDevAuthToken !== "function") throw new Error("Nuxt DevTools authentication is unavailable.");
+				await host.ensureDevAuthToken(token);
+			})
+		});
 		addDevServerHandler({
 			route: FILES_DEVTOOLS_PATH,
 			handler: nuxt_v3_handler_default

package/dist/devtools/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","names":["uiHandler"],"sources":["../../src/devtools/index.ts"],"sourcesContent":["import { fileURLToPath } from 'node:url'\n\nimport { addDevServerHandler, addServerHandler } from '@nuxt/kit'\nimport type { Nuxt } from '@nuxt/schema'\n\nimport { setupNuxtV3Devtools } from './nuxt-v3'\nimport uiHandler from './nuxt-v3-handler'\nimport { setupNuxtV4Devtools } from './nuxt-v4'\nimport {\n    FILES_DEVTOOLS_MAX_UPLOAD_SIZE,\n    FILES_DEVTOOLS_PATH,\n    FILES_GATEWAY_PATH,\n    FILES_SNAPSHOT_PATH,\n} from './snapshot'\n\nexport const setupFilesDevtools = (nuxt: Nuxt, version: string, write: boolean): void => {\n    // Snapshot must run inside Nitro's worker, where the runtime registry lives.\n    addServerHandler({\n        route: FILES_SNAPSHOT_PATH,\n        handler: fileURLToPath(new URL('./snapshot.js', import.meta.url)),\n    })\n    addServerHandler({\n        route: FILES_GATEWAY_PATH,\n        handler: fileURLToPath(new URL(write ? './files-write.js' : './files-read.js', import.meta.url)),\n    })\n    if (Number.parseInt(version) >= 4) {\n        setupNuxtV4Devtools(nuxt, { write, maxUploadSize: FILES_DEVTOOLS_MAX_UPLOAD_SIZE })\n    } else {\n        addDevServerHandler({\n            route: FILES_DEVTOOLS_PATH,\n            handler: uiHandler,\n        })\n        setupNuxtV3Devtools(nuxt)\n    }\n}\n"],"mappings":";;;;;;;AAeA,MAAa,sBAAsB,MAAY,SAAiB,UAAyB;CAErF,iBAAiB;EACb,OAAO;EACP,SAAS,cAAc,IAAI,IAAI,iBAAiB,YAAY,GAAG,CAAC;CACpE,CAAC;CACD,iBAAiB;EACb,OAAO;EACP,SAAS,cAAc,IAAI,IAAI,QAAQ,qBAAqB,mBAAmB,YAAY,GAAG,CAAC;CACnG,CAAC;CACD,IAAI,OAAO,SAAS,OAAO,KAAK,GAC5B,oBAAoB,MAAM;EAAE;EAAO,eAAe;CAA+B,CAAC;MAC/E;EACH,oBAAoB;GAChB,OAAO;GACP,SAASA;EACb,CAAC;EACD,oBAAoB,IAAI;CAC5B;AACJ"}
+{"version":3,"file":"index.js","names":["tokenHandler","uiHandler"],"sources":["../../src/devtools/index.ts"],"sourcesContent":["import { fileURLToPath } from 'node:url'\n\nimport { addDevServerHandler, addServerHandler, addServerTemplate } from '@nuxt/kit'\nimport type { Nuxt } from '@nuxt/schema'\n\nimport { setupNuxtV3Devtools } from './nuxt-v3'\nimport uiHandler from './nuxt-v3-handler'\nimport { setupNuxtV4Devtools } from './nuxt-v4'\nimport {\n    FILES_DEVTOOLS_MAX_UPLOAD_SIZE,\n    FILES_DEVTOOLS_PATH,\n    FILES_GATEWAY_PATH,\n    FILES_SNAPSHOT_PATH,\n    FILES_TOKEN_PATH,\n} from './snapshot'\nimport tokenHandler from './token'\n\nconst authenticatedHandler = (name: string, path: string, arguments_: string[]): string => {\n    const filename = `#nuxt-files-sdk/${name}`\n    addServerTemplate({\n        filename,\n        getContents: () =>\n            `import handler from ${JSON.stringify(path.replaceAll('\\\\', '/'))}\\nexport default event => handler(event, ${arguments_.map((value) => JSON.stringify(value)).join(', ')})\\n`,\n    })\n    return filename\n}\n\nexport const setupFilesDevtools = (nuxt: Nuxt, version: string, write: boolean, secrets: { token: string }): void => {\n    // Snapshot must run inside Nitro's worker, where the runtime registry lives.\n    addServerHandler({\n        route: FILES_SNAPSHOT_PATH,\n        handler: authenticatedHandler('snapshot', fileURLToPath(new URL('./snapshot.js', import.meta.url)), [\n            secrets.token,\n        ]),\n    })\n    addServerHandler({\n        route: FILES_GATEWAY_PATH,\n        handler: authenticatedHandler(\n            'files',\n            fileURLToPath(new URL(write ? './files-write.js' : './files-read.js', import.meta.url)),\n            [secrets.token],\n        ),\n    })\n    if (Number.parseInt(version) >= 4) {\n        setupNuxtV4Devtools(nuxt, {\n            write,\n            maxUploadSize: FILES_DEVTOOLS_MAX_UPLOAD_SIZE,\n            tokenSecret: secrets.token,\n        })\n    } else {\n        addDevServerHandler({\n            route: FILES_TOKEN_PATH,\n            handler: (event) =>\n                tokenHandler(event, secrets.token, async (token) => {\n                    const host = 'devtools' in nuxt ? nuxt.devtools : undefined\n                    if (\n                        !host ||\n                        typeof host !== 'object' ||\n                        !('ensureDevAuthToken' in host) ||\n                        typeof host.ensureDevAuthToken !== 'function'\n                    ) {\n                        throw new Error('Nuxt DevTools authentication is unavailable.')\n                    }\n                    await host.ensureDevAuthToken(token)\n                }),\n        })\n        addDevServerHandler({\n            route: FILES_DEVTOOLS_PATH,\n            handler: uiHandler,\n        })\n        setupNuxtV3Devtools(nuxt)\n    }\n}\n"],"mappings":";;;;;;;;AAiBA,MAAM,wBAAwB,MAAc,MAAc,eAAiC;CACvF,MAAM,WAAW,mBAAmB;CACpC,kBAAkB;EACd;EACA,mBACI,uBAAuB,KAAK,UAAU,KAAK,WAAW,MAAM,GAAG,CAAC,EAAE,2CAA2C,WAAW,KAAK,UAAU,KAAK,UAAU,KAAK,CAAC,CAAC,CAAC,KAAK,IAAI,EAAE;CACjL,CAAC;CACD,OAAO;AACX;AAEA,MAAa,sBAAsB,MAAY,SAAiB,OAAgB,YAAqC;CAEjH,iBAAiB;EACb,OAAO;EACP,SAAS,qBAAqB,YAAY,cAAc,IAAI,IAAI,iBAAiB,YAAY,GAAG,CAAC,GAAG,CAChG,QAAQ,KACZ,CAAC;CACL,CAAC;CACD,iBAAiB;EACb,OAAO;EACP,SAAS,qBACL,SACA,cAAc,IAAI,IAAI,QAAQ,qBAAqB,mBAAmB,YAAY,GAAG,CAAC,GACtF,CAAC,QAAQ,KAAK,CAClB;CACJ,CAAC;CACD,IAAI,OAAO,SAAS,OAAO,KAAK,GAC5B,oBAAoB,MAAM;EACtB;EACA,eAAe;EACf,aAAa,QAAQ;CACzB,CAAC;MACE;EACH,oBAAoB;GAChB,OAAO;GACP,UAAU,UACNA,cAAa,OAAO,QAAQ,OAAO,OAAO,UAAU;IAChD,MAAM,OAAO,cAAc,OAAO,KAAK,WAAW,KAAA;IAClD,IACI,CAAC,QACD,OAAO,SAAS,YAChB,EAAE,wBAAwB,SAC1B,OAAO,KAAK,uBAAuB,YAEnC,MAAM,IAAI,MAAM,8CAA8C;IAElE,MAAM,KAAK,mBAAmB,KAAK;GACvC,CAAC;EACT,CAAC;EACD,oBAAoB;GAChB,OAAO;GACP,SAASC;EACb,CAAC;EACD,oBAAoB,IAAI;CAC5B;AACJ"}

package/dist/devtools/nuxt-v3-handler.js

@@ -13,7 +13,7 @@ const assets = /* @__PURE__ */ new Map([
 	}]
 ]);
 var nuxt_v3_handler_default = async (event) => {
-	const asset = assets.get(event.path);
+	const asset = assets.get(new URL(event.path, "http://localhost").pathname);
 	if (!asset) return void 0;
 	event.node.res.setHeader("content-type", asset.contentType);
 	return asset.content;

package/dist/devtools/nuxt-v3-handler.js.map

@@ -1 +1 @@
-{"version":3,"file":"nuxt-v3-handler.js","names":[],"sources":["../../src/devtools/nuxt-v3-handler.ts"],"sourcesContent":["import { readFile } from 'node:fs/promises'\n\nconst html = {\n    contentType: 'text/html; charset=utf-8',\n    content: readFile(new URL('./client/index.html', import.meta.url), 'utf8'),\n}\nconst assets = new Map([\n    ['/', html],\n    ['/index.html', html],\n    [\n        '/app.js',\n        {\n            contentType: 'text/javascript; charset=utf-8',\n            content: readFile(new URL('./client/app.js', import.meta.url), 'utf8'),\n        },\n    ],\n])\n\nexport default async (event: { path: string; node: { res: { setHeader(name: string, value: string): void } } }) => {\n    const asset = assets.get(event.path)\n    if (!asset) return undefined\n    event.node.res.setHeader('content-type', asset.contentType)\n    return asset.content\n}\n"],"mappings":";;AAEA,MAAM,OAAO;CACT,aAAa;CACb,SAAS,SAAS,IAAI,IAAI,uBAAuB,YAAY,GAAG,GAAG,MAAM;AAC7E;AACA,MAAM,yBAAS,IAAI,IAAI;CACnB,CAAC,KAAK,IAAI;CACV,CAAC,eAAe,IAAI;CACpB,CACI,WACA;EACI,aAAa;EACb,SAAS,SAAS,IAAI,IAAI,mBAAmB,YAAY,GAAG,GAAG,MAAM;CACzE,CACJ;AACJ,CAAC;AAED,IAAA,0BAAe,OAAO,UAA6F;CAC/G,MAAM,QAAQ,OAAO,IAAI,MAAM,IAAI;CACnC,IAAI,CAAC,OAAO,OAAO,KAAA;CACnB,MAAM,KAAK,IAAI,UAAU,gBAAgB,MAAM,WAAW;CAC1D,OAAO,MAAM;AACjB"}
+{"version":3,"file":"nuxt-v3-handler.js","names":[],"sources":["../../src/devtools/nuxt-v3-handler.ts"],"sourcesContent":["import { readFile } from 'node:fs/promises'\n\nconst html = {\n    contentType: 'text/html; charset=utf-8',\n    content: readFile(new URL('./client/index.html', import.meta.url), 'utf8'),\n}\nconst assets = new Map([\n    ['/', html],\n    ['/index.html', html],\n    [\n        '/app.js',\n        {\n            contentType: 'text/javascript; charset=utf-8',\n            content: readFile(new URL('./client/app.js', import.meta.url), 'utf8'),\n        },\n    ],\n])\n\nexport default async (event: { path: string; node: { res: { setHeader(name: string, value: string): void } } }) => {\n    const asset = assets.get(new URL(event.path, 'http://localhost').pathname)\n    if (!asset) return undefined\n    event.node.res.setHeader('content-type', asset.contentType)\n    return asset.content\n}\n"],"mappings":";;AAEA,MAAM,OAAO;CACT,aAAa;CACb,SAAS,SAAS,IAAI,IAAI,uBAAuB,YAAY,GAAG,GAAG,MAAM;AAC7E;AACA,MAAM,yBAAS,IAAI,IAAI;CACnB,CAAC,KAAK,IAAI;CACV,CAAC,eAAe,IAAI;CACpB,CACI,WACA;EACI,aAAa;EACb,SAAS,SAAS,IAAI,IAAI,mBAAmB,YAAY,GAAG,GAAG,MAAM;CACzE,CACJ;AACJ,CAAC;AAED,IAAA,0BAAe,OAAO,UAA6F;CAC/G,MAAM,QAAQ,OAAO,IAAI,IAAI,IAAI,MAAM,MAAM,kBAAkB,CAAC,CAAC,QAAQ;CACzE,IAAI,CAAC,OAAO,OAAO,KAAA;CACnB,MAAM,KAAK,IAAI,UAAU,gBAAgB,MAAM,WAAW;CAC1D,OAAO,MAAM;AACjB"}

package/dist/devtools/nuxt-v3.js

@@ -8,7 +8,7 @@ const setupNuxtV3Devtools = (nuxt) => {
 			icon: "ph:files-duotone",
 			view: {
 				type: "iframe",
-				src: FILES_DEVTOOLS_PATH
+				src: `${FILES_DEVTOOLS_PATH}?host=nuxt-v3`
 			}
 		});
 	});

package/dist/devtools/nuxt-v3.js.map

@@ -1 +1 @@
-{"version":3,"file":"nuxt-v3.js","names":[],"sources":["../../src/devtools/nuxt-v3.ts"],"sourcesContent":["import type { Nuxt } from '@nuxt/schema'\n\nimport { FILES_DEVTOOLS_PATH } from './snapshot'\n\ninterface CustomTab {\n    name: string\n    title: string\n    icon: string\n    view: { type: 'iframe'; src: string }\n}\n\ndeclare module '@nuxt/schema' {\n    interface NuxtHooks {\n        'devtools:customTabs': (tabs: CustomTab[]) => void\n    }\n}\n\nexport const setupNuxtV3Devtools = (nuxt: Nuxt): void => {\n    nuxt.hook('devtools:customTabs', (tabs) => {\n        tabs.push({\n            name: 'nuxt-files-sdk',\n            title: 'Files',\n            icon: 'ph:files-duotone',\n            view: { type: 'iframe', src: FILES_DEVTOOLS_PATH },\n        })\n    })\n}\n"],"mappings":";;AAiBA,MAAa,uBAAuB,SAAqB;CACrD,KAAK,KAAK,wBAAwB,SAAS;EACvC,KAAK,KAAK;GACN,MAAM;GACN,OAAO;GACP,MAAM;GACN,MAAM;IAAE,MAAM;IAAU,KAAK;GAAoB;EACrD,CAAC;CACL,CAAC;AACL"}
+{"version":3,"file":"nuxt-v3.js","names":[],"sources":["../../src/devtools/nuxt-v3.ts"],"sourcesContent":["import type { Nuxt } from '@nuxt/schema'\n\nimport { FILES_DEVTOOLS_PATH } from './snapshot'\n\ninterface CustomTab {\n    name: string\n    title: string\n    icon: string\n    view: { type: 'iframe'; src: string }\n}\n\ndeclare module '@nuxt/schema' {\n    interface NuxtHooks {\n        'devtools:customTabs': (tabs: CustomTab[]) => void\n    }\n}\n\nexport const setupNuxtV3Devtools = (nuxt: Nuxt): void => {\n    nuxt.hook('devtools:customTabs', (tabs) => {\n        tabs.push({\n            name: 'nuxt-files-sdk',\n            title: 'Files',\n            icon: 'ph:files-duotone',\n            view: { type: 'iframe', src: `${FILES_DEVTOOLS_PATH}?host=nuxt-v3` },\n        })\n    })\n}\n"],"mappings":";;AAiBA,MAAa,uBAAuB,SAAqB;CACrD,KAAK,KAAK,wBAAwB,SAAS;EACvC,KAAK,KAAK;GACN,MAAM;GACN,OAAO;GACP,MAAM;GACN,MAAM;IAAE,MAAM;IAAU,KAAK,GAAG,oBAAoB;GAAe;EACvE,CAAC;CACL,CAAC;AACL"}

package/dist/devtools/nuxt-v4.js.map

@@ -1 +1 @@
-{"version":3,"file":"nuxt-v4.js","names":[],"sources":["../../src/devtools/nuxt-v4.ts"],"sourcesContent":["import { NUXT_DEVTOOLS_GROUP_ID, onDevtoolsReady } from '@nuxt/devtools-kit'\nimport type { Nuxt } from '@nuxt/schema'\nimport { createEmbedded } from 'devframe/adapters/embedded'\n\nimport { createFilesDevframe } from './devframe'\nimport { FILES_DEVTOOLS_PATH } from './snapshot'\n\nexport const setupNuxtV4Devtools = (nuxt: Nuxt, options: { write: boolean; maxUploadSize: number }): void => {\n    onDevtoolsReady(async (context) => {\n        await createEmbedded(\n            createFilesDevframe({\n                ...options,\n                notifyFailure: (message) => context.messages.add(message),\n            }),\n            { ctx: context },\n        )\n        context.docks.register({\n            id: 'nuxt-files-sdk',\n            title: 'Files',\n            icon: 'ph:files-duotone',\n            type: 'iframe',\n            url: FILES_DEVTOOLS_PATH,\n            groupId: NUXT_DEVTOOLS_GROUP_ID,\n        })\n\n        const broadcast = (method: 'refresh' | 'copy-diagnostics') =>\n            context.scope('nuxt-files-sdk').rpc.broadcast({ method, args: [], optional: true, event: true })\n        context.commands.register({\n            id: 'nuxt-files-sdk:open',\n            title: 'Files: Open',\n            icon: 'ph:files-duotone',\n            category: 'tools',\n            handler: () => context.docks.activate('nuxt-files-sdk'),\n        })\n        context.commands.register({\n            id: 'nuxt-files-sdk:refresh',\n            title: 'Files: Refresh',\n            icon: 'ph:arrow-clockwise-duotone',\n            category: 'tools',\n            handler: () => broadcast('refresh'),\n        })\n        context.commands.register({\n            id: 'nuxt-files-sdk:copy-diagnostics',\n            title: 'Files: Copy Diagnostics',\n            icon: 'ph:copy-duotone',\n            category: 'tools',\n            handler: () => broadcast('copy-diagnostics'),\n        })\n    }, nuxt)\n}\n"],"mappings":";;;;;AAOA,MAAa,uBAAuB,MAAY,YAA6D;CACzG,gBAAgB,OAAO,YAAY;EAC/B,MAAM,eACF,oBAAoB;GAChB,GAAG;GACH,gBAAgB,YAAY,QAAQ,SAAS,IAAI,OAAO;EAC5D,CAAC,GACD,EAAE,KAAK,QAAQ,CACnB;EACA,QAAQ,MAAM,SAAS;GACnB,IAAI;GACJ,OAAO;GACP,MAAM;GACN,MAAM;GACN,KAAK;GACL,SAAS;EACb,CAAC;EAED,MAAM,aAAa,WACf,QAAQ,MAAM,gBAAgB,CAAC,CAAC,IAAI,UAAU;GAAE;GAAQ,MAAM,CAAC;GAAG,UAAU;GAAM,OAAO;EAAK,CAAC;EACnG,QAAQ,SAAS,SAAS;GACtB,IAAI;GACJ,OAAO;GACP,MAAM;GACN,UAAU;GACV,eAAe,QAAQ,MAAM,SAAS,gBAAgB;EAC1D,CAAC;EACD,QAAQ,SAAS,SAAS;GACtB,IAAI;GACJ,OAAO;GACP,MAAM;GACN,UAAU;GACV,eAAe,UAAU,SAAS;EACtC,CAAC;EACD,QAAQ,SAAS,SAAS;GACtB,IAAI;GACJ,OAAO;GACP,MAAM;GACN,UAAU;GACV,eAAe,UAAU,kBAAkB;EAC/C,CAAC;CACL,GAAG,IAAI;AACX"}
+{"version":3,"file":"nuxt-v4.js","names":[],"sources":["../../src/devtools/nuxt-v4.ts"],"sourcesContent":["import { NUXT_DEVTOOLS_GROUP_ID, onDevtoolsReady } from '@nuxt/devtools-kit'\nimport type { Nuxt } from '@nuxt/schema'\nimport { createEmbedded } from 'devframe/adapters/embedded'\n\nimport { createFilesDevframe } from './devframe'\nimport { FILES_DEVTOOLS_PATH } from './snapshot'\n\nexport const setupNuxtV4Devtools = (\n    nuxt: Nuxt,\n    options: { write: boolean; maxUploadSize: number; tokenSecret: string },\n): void => {\n    onDevtoolsReady(async (context) => {\n        await createEmbedded(\n            createFilesDevframe({\n                ...options,\n                notifyFailure: (message) => context.messages.add(message),\n            }),\n            { ctx: context },\n        )\n        context.docks.register({\n            id: 'nuxt-files-sdk',\n            title: 'Files',\n            icon: 'ph:files-duotone',\n            type: 'iframe',\n            url: FILES_DEVTOOLS_PATH,\n            groupId: NUXT_DEVTOOLS_GROUP_ID,\n        })\n\n        const broadcast = (method: 'refresh' | 'copy-diagnostics') =>\n            context.scope('nuxt-files-sdk').rpc.broadcast({ method, args: [], optional: true, event: true })\n        context.commands.register({\n            id: 'nuxt-files-sdk:open',\n            title: 'Files: Open',\n            icon: 'ph:files-duotone',\n            category: 'tools',\n            handler: () => context.docks.activate('nuxt-files-sdk'),\n        })\n        context.commands.register({\n            id: 'nuxt-files-sdk:refresh',\n            title: 'Files: Refresh',\n            icon: 'ph:arrow-clockwise-duotone',\n            category: 'tools',\n            handler: () => broadcast('refresh'),\n        })\n        context.commands.register({\n            id: 'nuxt-files-sdk:copy-diagnostics',\n            title: 'Files: Copy Diagnostics',\n            icon: 'ph:copy-duotone',\n            category: 'tools',\n            handler: () => broadcast('copy-diagnostics'),\n        })\n    }, nuxt)\n}\n"],"mappings":";;;;;AAOA,MAAa,uBACT,MACA,YACO;CACP,gBAAgB,OAAO,YAAY;EAC/B,MAAM,eACF,oBAAoB;GAChB,GAAG;GACH,gBAAgB,YAAY,QAAQ,SAAS,IAAI,OAAO;EAC5D,CAAC,GACD,EAAE,KAAK,QAAQ,CACnB;EACA,QAAQ,MAAM,SAAS;GACnB,IAAI;GACJ,OAAO;GACP,MAAM;GACN,MAAM;GACN,KAAK;GACL,SAAS;EACb,CAAC;EAED,MAAM,aAAa,WACf,QAAQ,MAAM,gBAAgB,CAAC,CAAC,IAAI,UAAU;GAAE;GAAQ,MAAM,CAAC;GAAG,UAAU;GAAM,OAAO;EAAK,CAAC;EACnG,QAAQ,SAAS,SAAS;GACtB,IAAI;GACJ,OAAO;GACP,MAAM;GACN,UAAU;GACV,eAAe,QAAQ,MAAM,SAAS,gBAAgB;EAC1D,CAAC;EACD,QAAQ,SAAS,SAAS;GACtB,IAAI;GACJ,OAAO;GACP,MAAM;GACN,UAAU;GACV,eAAe,UAAU,SAAS;EACtC,CAAC;EACD,QAAQ,SAAS,SAAS;GACtB,IAAI;GACJ,OAAO;GACP,MAAM;GACN,UAAU;GACV,eAAe,UAAU,kBAAkB;EAC/C,CAAC;CACL,GAAG,IAAI;AACX"}

package/dist/devtools/snapshot.d.ts

@@ -5,7 +5,6 @@ export interface FilesDevtoolsSnapshot {
     name?: string;
     adapter: string;
     plugins: string[];
-    source: 'storage' | 'devStorage';
     initialized: boolean;
   }>;
   diagnostics: FilesDevtoolsDiagnostic[];
@@ -13,8 +12,15 @@ export interface FilesDevtoolsSnapshot {
 export declare const FILES_DEVTOOLS_PATH = "/__nuxt-files-sdk/";
 export declare const FILES_SNAPSHOT_PATH = "/__nuxt-files-sdk/snapshot";
 export declare const FILES_GATEWAY_PATH = "/__nuxt-files-sdk/files";
+export declare const FILES_TOKEN_PATH = "/__nuxt-files-sdk/token";
 export declare const FILES_DEVTOOLS_MAX_UPLOAD_SIZE: number;
-declare function _default(): FilesDevtoolsSnapshot;
+declare function _default(event: {
+  node: {
+    req: {
+      headers: Headers;
+    };
+  };
+}, secret: string): Promise<Response>;
 //#endregion
 export { _default as default };
 //# sourceMappingURL=snapshot.d.ts.map

package/dist/devtools/snapshot.js

@@ -1,11 +1,21 @@
-import { inspectFiles } from "../runtime.js";
+import { inspectFiles } from "../runtime/internal.js";
+import { authorizeFilesDevtoolsRequest } from "./auth.js";
+import { createFilesDevtoolsDiagnostic } from "./diagnostics.js";
 //#region src/devtools/snapshot.ts
 const FILES_DEVTOOLS_PATH = "/__nuxt-files-sdk/";
 const FILES_SNAPSHOT_PATH = `${FILES_DEVTOOLS_PATH}snapshot`;
 const FILES_GATEWAY_PATH = `${FILES_DEVTOOLS_PATH}files`;
+const FILES_TOKEN_PATH = `${FILES_DEVTOOLS_PATH}token`;
 const FILES_DEVTOOLS_MAX_UPLOAD_SIZE = 10485760;
-var snapshot_default = () => inspectFiles();
+var snapshot_default = async (event, secret) => {
+	if (!await authorizeFilesDevtoolsRequest(event.node.req, secret)) return new Response(null, { status: 401 });
+	const snapshot = inspectFiles();
+	return Response.json({
+		...snapshot,
+		diagnostics: snapshot.diagnostics.map(({ code, name, adapter }) => createFilesDevtoolsDiagnostic(code, adapter ? `${name === void 0 ? "The single storage" : `Storage "${name}"`} (${adapter}) could not be initialized.` : void 0))
+	});
+};
 //#endregion
-export { FILES_DEVTOOLS_MAX_UPLOAD_SIZE, FILES_DEVTOOLS_PATH, FILES_GATEWAY_PATH, FILES_SNAPSHOT_PATH, snapshot_default as default };
+export { FILES_DEVTOOLS_MAX_UPLOAD_SIZE, FILES_DEVTOOLS_PATH, FILES_GATEWAY_PATH, FILES_SNAPSHOT_PATH, FILES_TOKEN_PATH, snapshot_default as default };
 
 //# sourceMappingURL=snapshot.js.map

package/dist/devtools/snapshot.js.map

@@ -1 +1 @@
-{"version":3,"file":"snapshot.js","names":[],"sources":["../../src/devtools/snapshot.ts"],"sourcesContent":["import { inspectFiles } from '../runtime'\nimport type { FilesDevtoolsDiagnostic } from './diagnostics'\n\nexport interface FilesDevtoolsSnapshot {\n    storages: Array<{\n        name?: string\n        adapter: string\n        plugins: string[]\n        source: 'storage' | 'devStorage'\n        initialized: boolean\n    }>\n    diagnostics: FilesDevtoolsDiagnostic[]\n}\n\nexport const FILES_DEVTOOLS_PATH = '/__nuxt-files-sdk/'\nexport const FILES_SNAPSHOT_PATH = `${FILES_DEVTOOLS_PATH}snapshot`\nexport const FILES_GATEWAY_PATH = `${FILES_DEVTOOLS_PATH}files`\nexport const FILES_DEVTOOLS_MAX_UPLOAD_SIZE = 10 * 1024 * 1024\n\nexport default () => inspectFiles()\n"],"mappings":";;AAcA,MAAa,sBAAsB;AACnC,MAAa,sBAAsB,GAAG,oBAAoB;AAC1D,MAAa,qBAAqB,GAAG,oBAAoB;AACzD,MAAa,iCAAiC;AAE9C,IAAA,yBAAqB,aAAa"}
+{"version":3,"file":"snapshot.js","names":[],"sources":["../../src/devtools/snapshot.ts"],"sourcesContent":["import { inspectFiles } from '../runtime/internal'\nimport { authorizeFilesDevtoolsRequest } from './auth'\nimport { createFilesDevtoolsDiagnostic, type FilesDevtoolsDiagnostic } from './diagnostics'\n\nexport interface FilesDevtoolsSnapshot {\n    storages: Array<{\n        name?: string\n        adapter: string\n        plugins: string[]\n        initialized: boolean\n    }>\n    diagnostics: FilesDevtoolsDiagnostic[]\n}\n\nexport const FILES_DEVTOOLS_PATH = '/__nuxt-files-sdk/'\nexport const FILES_SNAPSHOT_PATH = `${FILES_DEVTOOLS_PATH}snapshot`\nexport const FILES_GATEWAY_PATH = `${FILES_DEVTOOLS_PATH}files`\nexport const FILES_TOKEN_PATH = `${FILES_DEVTOOLS_PATH}token`\nexport const FILES_DEVTOOLS_MAX_UPLOAD_SIZE = 10 * 1024 * 1024\n\nexport default async (event: { node: { req: { headers: Headers } } }, secret: string) => {\n    if (!(await authorizeFilesDevtoolsRequest(event.node.req, secret))) {\n        return new Response(null, { status: 401 })\n    }\n    const snapshot = inspectFiles()\n    return Response.json({\n        ...snapshot,\n        diagnostics: snapshot.diagnostics.map(({ code, name, adapter }) =>\n            createFilesDevtoolsDiagnostic(\n                code,\n                adapter\n                    ? `${name === undefined ? 'The single storage' : `Storage \"${name}\"`} (${adapter}) could not be initialized.`\n                    : undefined,\n            ),\n        ),\n    })\n}\n"],"mappings":";;;;AAcA,MAAa,sBAAsB;AACnC,MAAa,sBAAsB,GAAG,oBAAoB;AAC1D,MAAa,qBAAqB,GAAG,oBAAoB;AACzD,MAAa,mBAAmB,GAAG,oBAAoB;AACvD,MAAa,iCAAiC;AAE9C,IAAA,mBAAe,OAAO,OAAgD,WAAmB;CACrF,IAAI,CAAE,MAAM,8BAA8B,MAAM,KAAK,KAAK,MAAM,GAC5D,OAAO,IAAI,SAAS,MAAM,EAAE,QAAQ,IAAI,CAAC;CAE7C,MAAM,WAAW,aAAa;CAC9B,OAAO,SAAS,KAAK;EACjB,GAAG;EACH,aAAa,SAAS,YAAY,KAAK,EAAE,MAAM,MAAM,cACjD,8BACI,MACA,UACM,GAAG,SAAS,KAAA,IAAY,uBAAuB,YAAY,KAAK,GAAG,IAAI,QAAQ,+BAC/E,KAAA,CACV,CACJ;CACJ,CAAC;AACL"}

package/dist/devtools/token.d.ts

@@ -0,0 +1,14 @@
+//#region src/devtools/token.d.ts
+declare function _default(event: {
+  node: {
+    req: {
+      headers: {
+        get?: (name: string) => string | null | undefined;
+        [key: string]: unknown;
+      };
+    };
+  };
+}, secret: string, authorize: (token: string) => Promise<void>): Promise<Response>;
+//#endregion
+export { _default as default };
+//# sourceMappingURL=token.d.ts.map

package/dist/devtools/token.js

@@ -0,0 +1,17 @@
+import { createFilesDevtoolsToken } from "./auth.js";
+//#region src/devtools/token.ts
+var token_default = async (event, secret, authorize) => {
+	const headers = event.node.req.headers;
+	const received = headers.get?.("x-nuxt-devtools-token") ?? headers["x-nuxt-devtools-token"];
+	if (typeof received !== "string" || !received) return new Response(null, { status: 401 });
+	try {
+		await authorize(received);
+	} catch {
+		return new Response(null, { status: 401 });
+	}
+	return Response.json(await createFilesDevtoolsToken(secret), { headers: { "cache-control": "no-store" } });
+};
+//#endregion
+export { token_default as default };
+
+//# sourceMappingURL=token.js.map

package/dist/devtools/token.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"token.js","names":[],"sources":["../../src/devtools/token.ts"],"sourcesContent":["import { createFilesDevtoolsToken } from './auth'\n\nexport default async (\n    event: {\n        node: { req: { headers: { get?: (name: string) => string | null | undefined; [key: string]: unknown } } }\n    },\n    secret: string,\n    authorize: (token: string) => Promise<void>,\n) => {\n    const headers = event.node.req.headers\n    const received = headers.get?.('x-nuxt-devtools-token') ?? headers['x-nuxt-devtools-token']\n    if (typeof received !== 'string' || !received) return new Response(null, { status: 401 })\n    try {\n        await authorize(received)\n    } catch {\n        return new Response(null, { status: 401 })\n    }\n    return Response.json(await createFilesDevtoolsToken(secret), { headers: { 'cache-control': 'no-store' } })\n}\n"],"mappings":";;AAEA,IAAA,gBAAe,OACX,OAGA,QACA,cACC;CACD,MAAM,UAAU,MAAM,KAAK,IAAI;CAC/B,MAAM,WAAW,QAAQ,MAAM,uBAAuB,KAAK,QAAQ;CACnE,IAAI,OAAO,aAAa,YAAY,CAAC,UAAU,OAAO,IAAI,SAAS,MAAM,EAAE,QAAQ,IAAI,CAAC;CACxF,IAAI;EACA,MAAM,UAAU,QAAQ;CAC5B,QAAQ;EACJ,OAAO,IAAI,SAAS,MAAM,EAAE,QAAQ,IAAI,CAAC;CAC7C;CACA,OAAO,SAAS,KAAK,MAAM,yBAAyB,MAAM,GAAG,EAAE,SAAS,EAAE,iBAAiB,WAAW,EAAE,CAAC;AAC7G"}

package/dist/integration/nitro.d.ts

@@ -8,7 +8,13 @@ export interface NitroIntegration {
     rootDir: string;
     buildDir: string;
     dev?: boolean;
+    static?: boolean;
+    preset?: string;
     plugins: string[];
+    handlers?: {
+      route: string;
+      handler: string;
+    }[];
     alias?: Record<string, string>;
     externals?: {
       inline?: unknown[];

package/dist/integration/nitro.js

@@ -1,40 +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, readFile, writeFile } from "node:fs/promises";
-import { getProvider } from "files-sdk/providers";
-import { createJiti } from "jiti";
+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) => {
-	if (!config || typeof config !== "object") throw new Error("[nuxt-files-sdk:invalid-config] Files configuration must be an object.");
-	const typedConfig = config;
-	const storage = typedConfig.storage;
-	const devStorage = typedConfig.devStorage;
-	if (!storage && !development) return void 0;
-	if (!storage && !devStorage) throw new Error("[nuxt-files-sdk:invalid-config] At least one storage is required.");
-	const selected = [];
-	const single = isStorageConfig(storage ?? devStorage);
-	if (!storage) {
-		if (isStorageConfig(devStorage)) selected.push(devStorage);
-		else if (isStorageRecord(devStorage) && Object.keys(devStorage).length > 0) selected.push(...Object.values(devStorage));
-		else throw new Error("[nuxt-files-sdk:invalid-config] At least one development storage is required.");
-	} else if (!isStorageConfig(storage) && (!isStorageRecord(storage) || Object.keys(storage).length === 0)) throw new Error("[nuxt-files-sdk:invalid-config] At least one storage is required.");
-	else if (isStorageConfig(storage)) {
-		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.");
-		const overrides = isStorageRecord(devStorage) ? devStorage : void 0;
-		for (const name of Object.keys(overrides ?? {})) 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 ? overrides?.[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"),
@@ -49,71 +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 jiti = createJiti(import.meta.url, {
-		...nitro.options.alias ? { alias: nitro.options.alias } : {},
-		interopDefault: true,
-		moduleCache: false
+	const config = await loadFilesConfig({
+		configPath,
+		environments: options.environments,
+		alias: nitro.options.alias,
+		injectImports: nitro.unimport?.injectImports.bind(nitro.unimport)
 	});
-	const source = await readFile(configPath, "utf8");
-	const code = nitro.unimport ? (await nitro.unimport.injectImports(source, configPath)).code : source;
-	const loaded = await jiti.evalModule(code, {
-		filename: configPath,
-		async: true
+	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 config = loaded && typeof loaded === "object" && "default" in loaded ? loaded.default : loaded;
-	const selected = selectedAdapters(config, options.development);
-	if (!selected) return;
-	const { adapters, single } = selected;
+	const routes = gatewayRoutes(config);
+	const { adapters } = selected;
 	const providers = providerCode(adapters);
-	const runtimeConfig = options.development ? "config" : "{ storage: config.storage }";
+	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");
-	const filesSdkTypes = resolve(nitro.options.rootDir, "node_modules/files-sdk/dist").replaceAll("\\", "/");
-	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(${runtimeConfig}, {
-  development: ${JSON.stringify(options.development)},
+export default (nitroApp) => configureFiles(config, {
   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))]);
-		const tsConfig = types.tsConfig ??= {};
-		(tsConfig.include ??= []).push(typesPath);
-		const paths = (tsConfig.compilerOptions ??= {}).paths ??= {};
-		paths["files-sdk"] ??= [`${filesSdkTypes}/index.d.ts`];
-		paths["files-sdk/*"] ??= [`${filesSdkTypes}/*/index.d.ts`];
-	});
+`);
+		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