nuxt-files-sdk 0.0.5 → 0.1.0

package/LICENSE

@@ -1,6 +1,6 @@
 MIT License
 
-Copyright (c) 2026 Liry24
+Copyright (c) 2026 Liria
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

package/README.md

@@ -1,20 +1,46 @@
-# nuxt-files-sdk
+<p align="center">
+  <img alt="nuxt-files-sdk" src="https://shieldcn.dev/header/transparent.svg?title=Nuxt+Files+SDK&amp;subtitle=Files+SDK+integration+for+Nuxt+with+DevTools.&amp;logo=nuxt&amp;mode=dark&amp;font=geist&amp;border=false" />
+</p>
 
-Native-first [Files SDK](https://files-sdk.dev/docs) integration for Nuxt and Nitro.
+<p align="center">
+  <a href="https://npmx.dev/package/nuxt-files-sdk"><img alt="badge" src="https://shieldcn.dev/npm/nuxt-files-sdk.svg?size=xs&amp;font=geist&amp;split=true" /></a>
+  <a href="https://github.com/liria24/nuxt-files-sdk"><img alt="license" src="https://shieldcn.dev/github/liria24/nuxt-files-sdk/license.svg?size=xs&amp;font=geist&amp;split=true" /></a>
+  <a href="https://github.com/liria24/nuxt-files-sdk/actions"><img alt="CI" src="https://shieldcn.dev/github/liria24/nuxt-files-sdk/ci.svg?size=xs&amp;font=geist&amp;split=true" /></a>
+  <a href="https://github.com/liria24/nuxt-files-sdk/commits"><img alt="last commit" src="https://shieldcn.dev/github/liria24/nuxt-files-sdk/last-commit.svg?size=xs&amp;font=geist&amp;split=true" /></a>
+</p>
 
-- [Documentation source](./docs/content/index.md)
-- [Installation](./docs/content/1.getting-started/2.installation.md)
-- [Canonical compiled examples](./test/fixtures/nuxt4)
+<p align="center">
+Unofficial <a href="https://files-sdk.dev">Files SDK</a> integration for Nuxt and Nitro.
+</p>
+
+<p align="center">
+Docs: <a href="https://nuxt-files-sdk.liria.me">https://nuxt-files-sdk.liria.me</a>
+</p>
 
 ```bash
-bun add nuxt-files-sdk
+npm i nuxt-files-sdk
 ```
 
 ```ts
 // nuxt.config.ts
-export default defineNuxtConfig({ modules: ['nuxt-files-sdk'] })
+export default defineNuxtConfig({
+    modules: ['nuxt-files-sdk'],
+})
+
+// files.config.ts
+export default defineFilesConfig({
+    storage: {
+        adapter: 'fs',
+        config: { root: '.data/files-devtools' },
+    },
+    $test: { storage: { adapter: 'memory' } },
+})
 ```
 
-Run `bun run dev` to build the package once, then start the documentation site with both Nuxt DevTools integrations. Restart it after package source changes. Production serves the Markdown directly from GitHub through the Cloudflare Worker, so content-only updates do not require a new app deployment.
+<p align="center">
+  <a href="https://github.com/liria24/nuxt-files-sdk/graphs/contributors"><img alt="contributors" src="https://shieldcn.dev/contributors/liria24/nuxt-files-sdk.svg?title=false&amp;mode=dark&amp;font=geist" /></a>
+</p>
 
-Cloudflare deployment settings are documented in [`docs/README.md`](./docs/README.md).
+<p align="center">
+  <img alt="npm downloads chart" src="https://shieldcn.dev/chart/npm/nuxt-files-sdk.svg?font=geist&amp;logo=false&amp;height=300" />
+</p>

package/dist/config/load.js

@@ -0,0 +1,67 @@
+import { normalizeFilesConfig } from "../runtime/normalize.js";
+import { mergeFilesConfig } from "./merge.js";
+import { basename, dirname } from "node:path";
+import { readFile } from "node:fs/promises";
+import { fileURLToPath } from "node:url";
+import { loadConfig } from "c12";
+import { createJiti } from "jiti";
+//#region src/config/load.ts
+const isObject = (value) => value !== null && typeof value === "object" && !Array.isArray(value);
+const isResolvedFilesConfig = (value) => {
+	normalizeFilesConfig(value);
+	return true;
+};
+const hasEnvironmentStorage = (config) => [
+	config.$development,
+	config.$production,
+	config.$test,
+	config.$prerender,
+	...isObject(config.$env) ? Object.values(config.$env) : []
+].some((branch) => isObject(branch) && branch.storage !== void 0);
+/** c12 selects the first environment; a later prerender override is applied with the same merger. */
+const loadFilesConfig = async ({ configPath, environments, alias, injectImports }) => {
+	const jiti = createJiti(import.meta.url, {
+		alias: {
+			...alias,
+			"nuxt-files-sdk/config": fileURLToPath(new URL("../config.js", import.meta.url))
+		},
+		interopDefault: true,
+		moduleCache: false
+	});
+	const importer = Object.assign(jiti, { import: async (id) => {
+		const source = await readFile(id, "utf8");
+		const code = injectImports ? (await injectImports(source, id)).code : source;
+		const loaded = await jiti.evalModule(code, {
+			filename: id,
+			async: true
+		});
+		return loaded && typeof loaded === "object" && "default" in loaded ? loaded.default : loaded;
+	} });
+	const { config } = await loadConfig({
+		cwd: dirname(configPath),
+		configFile: basename(configPath),
+		configFileRequired: true,
+		rcFile: false,
+		extend: false,
+		envName: environments[0] ?? false,
+		jiti: importer,
+		merger: mergeFilesConfig
+	});
+	let resolved = config;
+	for (const environment of environments.slice(1)) {
+		const direct = resolved[`$${environment}`];
+		const named = isObject(resolved.$env) ? resolved.$env[environment] : void 0;
+		resolved = mergeFilesConfig({
+			...isObject(direct) ? direct : {},
+			...isObject(named) ? named : {}
+		}, resolved);
+	}
+	const result = Object.fromEntries(Object.entries(resolved).filter(([key]) => !key.startsWith("$")));
+	if (isObject(result) && result.storage === void 0 && hasEnvironmentStorage(resolved)) return void 0;
+	if (!isResolvedFilesConfig(result)) throw new Error("[nuxt-files-sdk:invalid-config] Invalid resolved configuration.");
+	return result;
+};
+//#endregion
+export { loadFilesConfig };
+
+//# sourceMappingURL=load.js.map

package/dist/config/load.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"load.js","names":[],"sources":["../../src/config/load.ts"],"sourcesContent":["import { readFile } from 'node:fs/promises'\nimport { basename, dirname } from 'node:path'\nimport { fileURLToPath } from 'node:url'\n\nimport { loadConfig } from 'c12'\nimport { createJiti } from 'jiti'\n\nimport type { FilesConfig } from '../config'\nimport { normalizeFilesConfig } from '../runtime/normalize'\nimport { mergeFilesConfig } from './merge'\n\nexport interface FilesConfigLoaderOptions {\n    configPath: string\n    environments: readonly string[]\n    alias?: Record<string, string> | undefined\n    injectImports?: ((code: string, id?: string) => Promise<{ code: string }>) | undefined\n}\n\nconst isObject = (value: unknown): value is Record<string, unknown> =>\n    value !== null && typeof value === 'object' && !Array.isArray(value)\nconst isResolvedFilesConfig = (value: unknown): value is FilesConfig => {\n    normalizeFilesConfig(value)\n    return true\n}\n\nconst hasEnvironmentStorage = (config: Record<string, unknown>): boolean =>\n    [\n        config.$development,\n        config.$production,\n        config.$test,\n        config.$prerender,\n        ...(isObject(config.$env) ? Object.values(config.$env) : []),\n    ].some((branch) => isObject(branch) && branch.storage !== undefined)\n\n/** c12 selects the first environment; a later prerender override is applied with the same merger. */\nexport const loadFilesConfig = async ({\n    configPath,\n    environments,\n    alias,\n    injectImports,\n}: FilesConfigLoaderOptions): Promise<FilesConfig | undefined> => {\n    const jiti = createJiti(import.meta.url, {\n        alias: {\n            ...alias,\n            'nuxt-files-sdk/config': fileURLToPath(new URL('../config.js', import.meta.url)),\n        },\n        interopDefault: true,\n        moduleCache: false,\n    })\n    const importer = Object.assign(jiti, {\n        import: async (id: string) => {\n            const source = await readFile(id, 'utf8')\n            const code = injectImports ? (await injectImports(source, id)).code : source\n            const loaded: unknown = await jiti.evalModule(code, { filename: id, async: true })\n            return loaded && typeof loaded === 'object' && 'default' in loaded ? loaded.default : loaded\n        },\n    })\n    const { config } = await loadConfig<Record<string, unknown>>({\n        cwd: dirname(configPath),\n        configFile: basename(configPath),\n        configFileRequired: true,\n        rcFile: false,\n        extend: false,\n        envName: environments[0] ?? false,\n        jiti: importer,\n        merger: mergeFilesConfig,\n    })\n    let resolved: Record<string, unknown> = config\n    for (const environment of environments.slice(1)) {\n        const direct = resolved[`$${environment}`]\n        const named = isObject(resolved.$env) ? resolved.$env[environment] : undefined\n        resolved = mergeFilesConfig(\n            { ...(isObject(direct) ? direct : {}), ...(isObject(named) ? named : {}) },\n            resolved,\n        )\n    }\n    const result: unknown = Object.fromEntries(Object.entries(resolved).filter(([key]) => !key.startsWith('$')))\n    if (isObject(result) && result.storage === undefined && hasEnvironmentStorage(resolved)) return undefined\n    if (!isResolvedFilesConfig(result))\n        throw new Error('[nuxt-files-sdk:invalid-config] Invalid resolved configuration.')\n    return result\n}\n"],"mappings":";;;;;;;;AAkBA,MAAM,YAAY,UACd,UAAU,QAAQ,OAAO,UAAU,YAAY,CAAC,MAAM,QAAQ,KAAK;AACvE,MAAM,yBAAyB,UAAyC;CACpE,qBAAqB,KAAK;CAC1B,OAAO;AACX;AAEA,MAAM,yBAAyB,WAC3B;CACI,OAAO;CACP,OAAO;CACP,OAAO;CACP,OAAO;CACP,GAAI,SAAS,OAAO,IAAI,IAAI,OAAO,OAAO,OAAO,IAAI,IAAI,CAAC;AAC9D,CAAC,CAAC,MAAM,WAAW,SAAS,MAAM,KAAK,OAAO,YAAY,KAAA,CAAS;;AAGvE,MAAa,kBAAkB,OAAO,EAClC,YACA,cACA,OACA,oBAC8D;CAC9D,MAAM,OAAO,WAAW,YAAY,KAAK;EACrC,OAAO;GACH,GAAG;GACH,yBAAyB,cAAc,IAAI,IAAI,gBAAgB,YAAY,GAAG,CAAC;EACnF;EACA,gBAAgB;EAChB,aAAa;CACjB,CAAC;CACD,MAAM,WAAW,OAAO,OAAO,MAAM,EACjC,QAAQ,OAAO,OAAe;EAC1B,MAAM,SAAS,MAAM,SAAS,IAAI,MAAM;EACxC,MAAM,OAAO,iBAAiB,MAAM,cAAc,QAAQ,EAAE,EAAA,CAAG,OAAO;EACtE,MAAM,SAAkB,MAAM,KAAK,WAAW,MAAM;GAAE,UAAU;GAAI,OAAO;EAAK,CAAC;EACjF,OAAO,UAAU,OAAO,WAAW,YAAY,aAAa,SAAS,OAAO,UAAU;CAC1F,EACJ,CAAC;CACD,MAAM,EAAE,WAAW,MAAM,WAAoC;EACzD,KAAK,QAAQ,UAAU;EACvB,YAAY,SAAS,UAAU;EAC/B,oBAAoB;EACpB,QAAQ;EACR,QAAQ;EACR,SAAS,aAAa,MAAM;EAC5B,MAAM;EACN,QAAQ;CACZ,CAAC;CACD,IAAI,WAAoC;CACxC,KAAK,MAAM,eAAe,aAAa,MAAM,CAAC,GAAG;EAC7C,MAAM,SAAS,SAAS,IAAI;EAC5B,MAAM,QAAQ,SAAS,SAAS,IAAI,IAAI,SAAS,KAAK,eAAe,KAAA;EACrE,WAAW,iBACP;GAAE,GAAI,SAAS,MAAM,IAAI,SAAS,CAAC;GAAI,GAAI,SAAS,KAAK,IAAI,QAAQ,CAAC;EAAG,GACzE,QACJ;CACJ;CACA,MAAM,SAAkB,OAAO,YAAY,OAAO,QAAQ,QAAQ,CAAC,CAAC,QAAQ,CAAC,SAAS,CAAC,IAAI,WAAW,GAAG,CAAC,CAAC;CAC3G,IAAI,SAAS,MAAM,KAAK,OAAO,YAAY,KAAA,KAAa,sBAAsB,QAAQ,GAAG,OAAO,KAAA;CAChG,IAAI,CAAC,sBAAsB,MAAM,GAC7B,MAAM,IAAI,MAAM,iEAAiE;CACrF,OAAO;AACX"}

package/dist/config/merge.d.ts

@@ -0,0 +1,5 @@
+//#region src/config/merge.d.ts
+/** c12 merger with Files provider boundaries and replacement arrays. Sources are highest priority first. */
+export declare const mergeFilesConfig: (...sources: Array<Record<string, unknown> | null | undefined>) => Record<string, unknown>;
+//#endregion
+//# sourceMappingURL=merge.d.ts.map

package/dist/config/merge.js

@@ -0,0 +1,22 @@
+//#region src/config/merge.ts
+const isObject = (value) => value !== null && typeof value === "object" && !Array.isArray(value);
+const merge = (override, base, path) => {
+	if (override === void 0) return base;
+	if (!isObject(override) || !isObject(base)) return override;
+	const providerChanged = path[0] === "storage" && path.length <= 2 && "adapter" in override && override.adapter !== base.adapter;
+	const result = { ...base };
+	if (providerChanged) delete result.config;
+	for (const [key, value] of Object.entries(override)) result[key] = merge(value, result[key], [...path, key]);
+	return result;
+};
+/** c12 merger with Files provider boundaries and replacement arrays. Sources are highest priority first. */
+const mergeFilesConfig = (...sources) => {
+	return sources.reduceRight((base, source) => {
+		const value = merge(source, base, []);
+		return isObject(value) ? value : base;
+	}, {});
+};
+//#endregion
+export { mergeFilesConfig };
+
+//# sourceMappingURL=merge.js.map

package/dist/config/merge.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"merge.js","names":[],"sources":["../../src/config/merge.ts"],"sourcesContent":["const isObject = (value: unknown): value is Record<string, unknown> =>\n    value !== null && typeof value === 'object' && !Array.isArray(value)\n\nconst merge = (override: unknown, base: unknown, path: string[]): unknown => {\n    if (override === undefined) return base\n    if (!isObject(override) || !isObject(base)) return override\n    const providerChanged =\n        path[0] === 'storage' && path.length <= 2 && 'adapter' in override && override.adapter !== base.adapter\n    const result: Record<string, unknown> = { ...base }\n    if (providerChanged) delete result.config\n    for (const [key, value] of Object.entries(override)) {\n        result[key] = merge(value, result[key], [...path, key])\n    }\n    return result\n}\n\n/** c12 merger with Files provider boundaries and replacement arrays. Sources are highest priority first. */\nexport const mergeFilesConfig = (\n    ...sources: Array<Record<string, unknown> | null | undefined>\n): Record<string, unknown> => {\n    return sources.reduceRight<Record<string, unknown>>((base, source) => {\n        const value = merge(source, base, [])\n        return isObject(value) ? value : base\n    }, {})\n}\n"],"mappings":";AAAA,MAAM,YAAY,UACd,UAAU,QAAQ,OAAO,UAAU,YAAY,CAAC,MAAM,QAAQ,KAAK;AAEvE,MAAM,SAAS,UAAmB,MAAe,SAA4B;CACzE,IAAI,aAAa,KAAA,GAAW,OAAO;CACnC,IAAI,CAAC,SAAS,QAAQ,KAAK,CAAC,SAAS,IAAI,GAAG,OAAO;CACnD,MAAM,kBACF,KAAK,OAAO,aAAa,KAAK,UAAU,KAAK,aAAa,YAAY,SAAS,YAAY,KAAK;CACpG,MAAM,SAAkC,EAAE,GAAG,KAAK;CAClD,IAAI,iBAAiB,OAAO,OAAO;CACnC,KAAK,MAAM,CAAC,KAAK,UAAU,OAAO,QAAQ,QAAQ,GAC9C,OAAO,OAAO,MAAM,OAAO,OAAO,MAAM,CAAC,GAAG,MAAM,GAAG,CAAC;CAE1D,OAAO;AACX;;AAGA,MAAa,oBACT,GAAG,YACuB;CAC1B,OAAO,QAAQ,aAAsC,MAAM,WAAW;EAClE,MAAM,QAAQ,MAAM,QAAQ,MAAM,CAAC,CAAC;EACpC,OAAO,SAAS,KAAK,IAAI,QAAQ;CACrC,GAAG,CAAC,CAAC;AACT"}

package/dist/config/prune.js

@@ -0,0 +1,55 @@
+import { dirname, resolve } from "node:path";
+import { parse } from "@babel/parser";
+//#region src/config/prune.ts
+const unwrap = (node) => node.type === "TSAsExpression" || node.type === "TSSatisfiesExpression" || node.type === "ParenthesizedExpression" ? unwrap(node.expression) : node;
+const keyOf = (node) => node.key?.type === "Identifier" ? node.key.name : typeof node.key?.value === "string" ? node.key.value : void 0;
+/** Remove inactive environment literals before bundling the user config. */
+const pruneFilesConfigSource = (source, configPath, environments) => {
+	const body = parse(source, {
+		sourceType: "module",
+		plugins: ["typescript"]
+	}).program.body;
+	const exported = body.find((node) => node.type === "ExportDefaultDeclaration")?.declaration;
+	if (!exported) throw new Error("[nuxt-files-sdk:invalid-config] files.config.ts needs a default export.");
+	let root = unwrap(exported);
+	if (root.type === "CallExpression") root = unwrap(root.arguments?.[0] ?? root);
+	if (root.type === "Identifier") {
+		const declaration = body.flatMap((node) => node.declarations ?? []).find((node) => node.id?.name === root.name);
+		if (declaration?.init) root = unwrap(declaration.init);
+	}
+	if (root.type !== "ObjectExpression") throw new Error("[nuxt-files-sdk:invalid-config] The default Files config must be a static object literal.");
+	const edits = [];
+	const active = new Set(environments);
+	for (const property of root.properties ?? []) {
+		const key = keyOf(property);
+		if (!key?.startsWith("$")) continue;
+		if (key === "$env" && property.value) {
+			const env = unwrap(property.value);
+			if (env.type !== "ObjectExpression") throw new Error("[nuxt-files-sdk:invalid-config] $env must be an object.");
+			for (const entry of env.properties ?? []) if (!active.has(keyOf(entry) ?? "")) edits.push({
+				start: entry.start,
+				end: entry.end,
+				text: "...{}"
+			});
+		} else if (!active.has(key.slice(1))) edits.push({
+			start: property.start,
+			end: property.end,
+			text: "...{}"
+		});
+	}
+	for (const node of body) {
+		if (!node.source || typeof node.source.value !== "string" || !node.source.value.startsWith(".")) continue;
+		edits.push({
+			start: node.source.start,
+			end: node.source.end,
+			text: JSON.stringify(resolve(dirname(configPath), node.source.value).replaceAll("\\", "/"))
+		});
+	}
+	let result = source;
+	for (const edit of edits.toSorted((left, right) => right.start - left.start)) result = result.slice(0, edit.start) + edit.text + result.slice(edit.end);
+	return result;
+};
+//#endregion
+export { pruneFilesConfigSource };
+
+//# sourceMappingURL=prune.js.map

package/dist/config/prune.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prune.js","names":[],"sources":["../../src/config/prune.ts"],"sourcesContent":["import { dirname, resolve } from 'node:path'\n\nimport { parse } from '@babel/parser'\n\ninterface SyntaxNode {\n    type: string\n    start: number\n    end: number\n    name?: string\n    value?: unknown\n    key?: SyntaxNode\n    source?: SyntaxNode\n    declaration?: SyntaxNode\n    declarations?: SyntaxNode[]\n    id?: SyntaxNode\n    init?: SyntaxNode\n    expression?: SyntaxNode\n    callee?: SyntaxNode\n    arguments?: SyntaxNode[]\n    properties?: SyntaxNode[]\n    body?: SyntaxNode[]\n}\n\nconst unwrap = (node: SyntaxNode): SyntaxNode =>\n    node.type === 'TSAsExpression' || node.type === 'TSSatisfiesExpression' || node.type === 'ParenthesizedExpression'\n        ? unwrap(node.expression!)\n        : node\nconst keyOf = (node: SyntaxNode): string | undefined =>\n    node.key?.type === 'Identifier' ? node.key.name : typeof node.key?.value === 'string' ? node.key.value : undefined\n\n/** Remove inactive environment literals before bundling the user config. */\nexport const pruneFilesConfigSource = (source: string, configPath: string, environments: readonly string[]): string => {\n    // Babel's node union is wider than the fields inspected here.\n    // oxlint-disable typescript/no-unsafe-type-assertion\n    const body = (\n        parse(source, { sourceType: 'module', plugins: ['typescript'] }) as unknown as { program: SyntaxNode }\n    ).program.body!\n    // oxlint-enable typescript/no-unsafe-type-assertion\n    const exported = body.find((node) => node.type === 'ExportDefaultDeclaration')?.declaration\n    if (!exported) throw new Error('[nuxt-files-sdk:invalid-config] files.config.ts needs a default export.')\n    let root = unwrap(exported)\n    if (root.type === 'CallExpression') root = unwrap(root.arguments?.[0] ?? root)\n    if (root.type === 'Identifier') {\n        const declaration = body.flatMap((node) => node.declarations ?? []).find((node) => node.id?.name === root.name)\n        if (declaration?.init) root = unwrap(declaration.init)\n    }\n    if (root.type !== 'ObjectExpression') {\n        throw new Error('[nuxt-files-sdk:invalid-config] The default Files config must be a static object literal.')\n    }\n    const edits: Array<{ start: number; end: number; text: string }> = []\n    const active = new Set(environments)\n    for (const property of root.properties ?? []) {\n        const key = keyOf(property)\n        if (!key?.startsWith('$')) continue\n        if (key === '$env' && property.value) {\n            // oxlint-disable-next-line typescript/no-unsafe-type-assertion\n            const env = unwrap(property.value as SyntaxNode)\n            if (env.type !== 'ObjectExpression')\n                throw new Error('[nuxt-files-sdk:invalid-config] $env must be an object.')\n            for (const entry of env.properties ?? []) {\n                if (!active.has(keyOf(entry) ?? '')) edits.push({ start: entry.start, end: entry.end, text: '...{}' })\n            }\n        } else if (!active.has(key.slice(1))) {\n            edits.push({ start: property.start, end: property.end, text: '...{}' })\n        }\n    }\n    // The selected module lives under the build directory; preserve relative import resolution.\n    for (const node of body) {\n        if (!node.source || typeof node.source.value !== 'string' || !node.source.value.startsWith('.')) continue\n        edits.push({\n            start: node.source.start,\n            end: node.source.end,\n            text: JSON.stringify(resolve(dirname(configPath), node.source.value).replaceAll('\\\\', '/')),\n        })\n    }\n    let result = source\n    for (const edit of edits.toSorted((left, right) => right.start - left.start)) {\n        result = result.slice(0, edit.start) + edit.text + result.slice(edit.end)\n    }\n    return result\n}\n"],"mappings":";;;AAuBA,MAAM,UAAU,SACZ,KAAK,SAAS,oBAAoB,KAAK,SAAS,2BAA2B,KAAK,SAAS,4BACnF,OAAO,KAAK,UAAW,IACvB;AACV,MAAM,SAAS,SACX,KAAK,KAAK,SAAS,eAAe,KAAK,IAAI,OAAO,OAAO,KAAK,KAAK,UAAU,WAAW,KAAK,IAAI,QAAQ,KAAA;;AAG7G,MAAa,0BAA0B,QAAgB,YAAoB,iBAA4C;CAGnH,MAAM,OACF,MAAM,QAAQ;EAAE,YAAY;EAAU,SAAS,CAAC,YAAY;CAAE,CAAC,CAAC,CAClE,QAAQ;CAEV,MAAM,WAAW,KAAK,MAAM,SAAS,KAAK,SAAS,0BAA0B,CAAC,EAAE;CAChF,IAAI,CAAC,UAAU,MAAM,IAAI,MAAM,yEAAyE;CACxG,IAAI,OAAO,OAAO,QAAQ;CAC1B,IAAI,KAAK,SAAS,kBAAkB,OAAO,OAAO,KAAK,YAAY,MAAM,IAAI;CAC7E,IAAI,KAAK,SAAS,cAAc;EAC5B,MAAM,cAAc,KAAK,SAAS,SAAS,KAAK,gBAAgB,CAAC,CAAC,CAAC,CAAC,MAAM,SAAS,KAAK,IAAI,SAAS,KAAK,IAAI;EAC9G,IAAI,aAAa,MAAM,OAAO,OAAO,YAAY,IAAI;CACzD;CACA,IAAI,KAAK,SAAS,oBACd,MAAM,IAAI,MAAM,2FAA2F;CAE/G,MAAM,QAA6D,CAAC;CACpE,MAAM,SAAS,IAAI,IAAI,YAAY;CACnC,KAAK,MAAM,YAAY,KAAK,cAAc,CAAC,GAAG;EAC1C,MAAM,MAAM,MAAM,QAAQ;EAC1B,IAAI,CAAC,KAAK,WAAW,GAAG,GAAG;EAC3B,IAAI,QAAQ,UAAU,SAAS,OAAO;GAElC,MAAM,MAAM,OAAO,SAAS,KAAmB;GAC/C,IAAI,IAAI,SAAS,oBACb,MAAM,IAAI,MAAM,yDAAyD;GAC7E,KAAK,MAAM,SAAS,IAAI,cAAc,CAAC,GACnC,IAAI,CAAC,OAAO,IAAI,MAAM,KAAK,KAAK,EAAE,GAAG,MAAM,KAAK;IAAE,OAAO,MAAM;IAAO,KAAK,MAAM;IAAK,MAAM;GAAQ,CAAC;EAE7G,OAAO,IAAI,CAAC,OAAO,IAAI,IAAI,MAAM,CAAC,CAAC,GAC/B,MAAM,KAAK;GAAE,OAAO,SAAS;GAAO,KAAK,SAAS;GAAK,MAAM;EAAQ,CAAC;CAE9E;CAEA,KAAK,MAAM,QAAQ,MAAM;EACrB,IAAI,CAAC,KAAK,UAAU,OAAO,KAAK,OAAO,UAAU,YAAY,CAAC,KAAK,OAAO,MAAM,WAAW,GAAG,GAAG;EACjG,MAAM,KAAK;GACP,OAAO,KAAK,OAAO;GACnB,KAAK,KAAK,OAAO;GACjB,MAAM,KAAK,UAAU,QAAQ,QAAQ,UAAU,GAAG,KAAK,OAAO,KAAK,CAAC,CAAC,WAAW,MAAM,GAAG,CAAC;EAC9F,CAAC;CACL;CACA,IAAI,SAAS;CACb,KAAK,MAAM,QAAQ,MAAM,UAAU,MAAM,UAAU,MAAM,QAAQ,KAAK,KAAK,GACvE,SAAS,OAAO,MAAM,GAAG,KAAK,KAAK,IAAI,KAAK,OAAO,OAAO,MAAM,KAAK,GAAG;CAE5E,OAAO;AACX"}

package/dist/config.d.ts

@@ -1,115 +1,113 @@
-import { FilesHooks, FilesPlugin, ProviderSlug } from "files-sdk";
+import { ProviderFactories } from "./runtime/provider-types.js";
+import { Adapter, FilesHooks, FilesOptions, FilesPlugin, ProviderSlug } from "files-sdk";
+import { AuthorizeContext, AuthorizeResult, CreateFilesRouterOptions } from "files-sdk/api";
+import { H3Event } from "h3";
 //#region src/config.d.ts
-interface ProviderFactories {
-  akamai: typeof import('files-sdk/akamai').akamai;
-  alibaba: typeof import('files-sdk/alibaba').alibaba;
-  appwrite: typeof import('files-sdk/appwrite').appwrite;
-  archil: typeof import('files-sdk/archil').archil;
-  azure: typeof import('files-sdk/azure').azure;
-  'backblaze-b2': typeof import('files-sdk/backblaze-b2').backblazeB2;
-  box: typeof import('files-sdk/box').box;
-  'bun-s3': typeof import('files-sdk/bun-s3').bunS3;
-  'bunny-storage': typeof import('files-sdk/bunny-storage').bunnyStorage;
-  cloudinary: typeof import('files-sdk/cloudinary').cloudinaryAdapter;
-  convex: typeof import('files-sdk/convex').convex;
-  'digitalocean-spaces': typeof import('files-sdk/digitalocean-spaces').digitaloceanSpaces;
-  dropbox: typeof import('files-sdk/dropbox').dropbox;
-  exoscale: typeof import('files-sdk/exoscale').exoscale;
-  filebase: typeof import('files-sdk/filebase').filebase;
-  'firebase-storage': typeof import('files-sdk/firebase-storage').firebaseStorage;
-  fs: typeof import('files-sdk/fs').fs;
-  ftp: typeof import('files-sdk/ftp').ftp;
-  gcs: typeof import('files-sdk/gcs').gcs;
-  'google-drive': typeof import('files-sdk/google-drive').googleDrive;
-  hetzner: typeof import('files-sdk/hetzner').hetzner;
-  'ibm-cos': typeof import('files-sdk/ibm-cos').ibmCos;
-  'idrive-e2': typeof import('files-sdk/idrive-e2').idriveE2;
-  memory: typeof import('files-sdk/memory').memory;
-  minio: typeof import('files-sdk/minio').minio;
-  neon: typeof import('files-sdk/neon').neon;
-  'netlify-blobs': typeof import('files-sdk/netlify-blobs').netlifyBlobs;
-  onedrive: typeof import('files-sdk/onedrive').onedrive;
-  'oracle-cloud': typeof import('files-sdk/oracle-cloud').oracleCloud;
-  ovhcloud: typeof import('files-sdk/ovhcloud').ovhcloud;
-  pocketbase: typeof import('files-sdk/pocketbase').pocketbase;
-  r2: typeof import('files-sdk/r2').r2;
-  s3: typeof import('files-sdk/s3').s3;
-  's3-fetch': typeof import('files-sdk/s3-fetch').s3Fetch;
-  scaleway: typeof import('files-sdk/scaleway').scaleway;
-  sftp: typeof import('files-sdk/sftp').sftp;
-  sharepoint: typeof import('files-sdk/sharepoint').sharepoint;
-  storj: typeof import('files-sdk/storj').storj;
-  supabase: typeof import('files-sdk/supabase').supabase;
-  tencent: typeof import('files-sdk/tencent').tencent;
-  tigris: typeof import('files-sdk/tigris').tigris;
-  uploadthing: typeof import('files-sdk/uploadthing').uploadthing;
-  'vercel-blob': typeof import('files-sdk/vercel-blob').vercelBlob;
-  vultr: typeof import('files-sdk/vultr').vultr;
-  wasabi: typeof import('files-sdk/wasabi').wasabi;
-  webdav: typeof import('files-sdk/webdav').webdav;
-  yandex: typeof import('files-sdk/yandex').yandex;
-}
-type ProviderOptions<Provider extends ProviderSlug> = Parameters<ProviderFactories[Provider]>[0];
-type ConfigValue<Provider extends ProviderSlug> = Exclude<ProviderOptions<Provider>, undefined>;
-type ConfigInput<Provider extends ProviderSlug> = ConfigValue<Provider> | (() => ConfigValue<Provider>);
-type ProviderConfig<Provider extends ProviderSlug> = {
-  /** Native provider factory options, or a synchronous runtime resolver for them. */
-  config?: ConfigInput<Provider>;
-} & (undefined extends ProviderOptions<Provider> ? unknown : {
-  config: ConfigInput<Provider>;
+export type AdapterFactory = (...args: never[]) => Adapter;
+type StorageAdapter = ProviderSlug | AdapterFactory;
+export type FilesPluginContext = {
+  storage: (name: string) => Adapter;
+};
+type FactoryFor<A extends StorageAdapter> = A extends ProviderSlug ? ProviderFactories[A] : A;
+type AdapterOptions<A extends StorageAdapter> = Parameters<FactoryFor<A>> extends [] ? undefined : [Parameters<FactoryFor<A>>[0]] extends [never] ? unknown : Parameters<FactoryFor<A>>[0];
+type AdapterConfig<A extends StorageAdapter> = {
+  /** Native adapter factory options, or a synchronous runtime resolver for them. */
+  config?: Exclude<AdapterOptions<A>, undefined> | (() => Exclude<AdapterOptions<A>, undefined>);
+} & (undefined extends AdapterOptions<A> ? unknown : {
+  config: Exclude<AdapterOptions<A>, undefined> | (() => Exclude<AdapterOptions<A>, undefined>);
 });
+type CommonFilesOptions<A extends StorageAdapter> = Omit<FilesOptions<ReturnType<FactoryFor<A>>>, 'adapter' | 'hooks' | 'plugins'>;
 /** Configuration for one Files SDK storage. */
-export type StorageConfig<Provider extends ProviderSlug = ProviderSlug, Plugins extends readonly FilesPlugin[] = readonly FilesPlugin[]> = Provider extends ProviderSlug ? {
-  /** Files SDK provider slug, for example `r2`, `s3`, or `fs`. */
+export type StorageConfig<Provider extends StorageAdapter = StorageAdapter, Plugins extends readonly FilesPlugin[] = readonly FilesPlugin[]> = Provider extends StorageAdapter ? {
+  /** Files SDK provider slug or a compatible adapter factory. */
   adapter: Provider;
-  /** Native Files SDK plugins applied in array order. */
-  plugins?: Plugins;
-  /** Native Files SDK lifecycle hooks. */
+  plugins?: Plugins | ((context: FilesPluginContext) => Plugins);
   hooks?: FilesHooks;
-  /** Scope every operation under this key prefix. */
-  prefix?: string;
-  /** Retry provider failures up to this many times. */
-  retries?: number;
-  /** Per-attempt timeout in milliseconds. */
-  timeout?: number;
-} & ProviderConfig<Provider> : never;
-/** Development-only provider settings for a storage. */
-export type DevStorageConfig<Provider extends ProviderSlug = ProviderSlug> = Provider extends ProviderSlug ? {
-  adapter: Provider;
-} & ProviderConfig<Provider> : never;
-/** One unnamed storage, available through `useServerFiles()`. */
-export interface SingleFilesConfig<Storage extends StorageConfig = StorageConfig> {
-  /** Files SDK storage configuration. */
-  storage: Storage;
-  /** Development-only provider settings. */
-  devStorage?: DevStorageConfig;
+} & CommonFilesOptions<Provider> & AdapterConfig<Provider> : never;
+export type FilesRoute = Omit<CreateFilesRouterOptions, 'files' | 'authorize'> & {
+  path: string;
+  storage?: string;
+  authorize?: (context: AuthorizeContext & {
+    event: H3Event;
+  }) => AuthorizeResult | Promise<AuthorizeResult>;
+};
+export type StorageSet = StorageConfig | Record<string, StorageConfig>;
+/** One environment's Files options, before or after resolution. */
+export interface FilesEnvironmentConfig {
+  storage?: StorageSet;
+  routes?: readonly FilesRoute[];
+}
+/** User-authored configuration. Environment blocks can override every Files option. */
+export interface FilesConfigInput extends FilesEnvironmentConfig {
+  /** Overrides applied by the development server. */
+  $development?: FilesEnvironmentConfig;
+  $production?: FilesEnvironmentConfig;
+  $test?: FilesEnvironmentConfig;
+  $prerender?: FilesEnvironmentConfig;
+  $env?: Record<string, FilesEnvironmentConfig>;
 }
-/** Named storages, each requiring its name when accessed. */
-export interface NamedFilesConfig<Storages extends Record<string, StorageConfig> = Record<string, StorageConfig>> {
+/** Environment-resolved runtime configuration. */
+export interface FilesConfig extends FilesEnvironmentConfig {
+  storage: StorageSet;
+}
+export interface SingleFilesConfig extends FilesConfig {
   /** Files SDK storage configuration. */
-  storage: Storages;
-  /** Development-only provider settings keyed by storage name. */
-  devStorage?: Partial<{ [Name in keyof Storages]: DevStorageConfig; }>;
+  storage: StorageConfig;
 }
-/** One unnamed storage that exists only while the development server is running. */
-export interface DevelopmentOnlySingleFilesConfig<Storage extends StorageConfig = StorageConfig> {
-  storage?: never;
-  devStorage: Storage;
+export interface NamedFilesConfig extends FilesConfig {
+  storage: Record<string, StorageConfig>;
 }
-/** Named storages that exist only while the development server is running. */
-export interface DevelopmentOnlyNamedFilesConfig<Storages extends Record<string, StorageConfig> = Record<string, StorageConfig>> {
+type EntryCheck<T> = T extends {
+  adapter: infer A extends StorageAdapter;
+} ? T extends StorageConfig<A> ? Record<Exclude<keyof T, keyof StorageConfig<A>>, never> : StorageConfig<A> : never;
+type StorageCheck<T> = T extends {
+  adapter: unknown;
+} ? EntryCheck<T> : T extends Record<string, unknown> ? { [K in keyof T]: EntryCheck<T[K]>; } : never;
+type StorageOf<T> = T extends {
+  storage: infer S;
+} ? S : never;
+type StorageBranches<T> = StorageOf<T> | StorageOf<T extends {
+  $development: infer E;
+} ? E : never> | StorageOf<T extends {
+  $production: infer E;
+} ? E : never> | StorageOf<T extends {
+  $test: infer E;
+} ? E : never> | StorageOf<T extends {
+  $prerender: infer E;
+} ? E : never> | StorageOf<T extends {
+  $env: infer E;
+} ? E[keyof E] : never>;
+type StorageNames<T> = StorageBranches<T> extends (infer S) ? S extends {
+  adapter: unknown;
+} ? never : S extends object ? Extract<keyof S, string> : never : never;
+type RouteCheck<T> = FilesRoute & ([StorageNames<T>] extends [never] ? {
   storage?: never;
-  devStorage: Storages;
-}
-/** Files SDK configuration used by the Nuxt/Nitro integration. */
-export type FilesConfig = SingleFilesConfig | NamedFilesConfig | DevelopmentOnlySingleFilesConfig | DevelopmentOnlyNamedFilesConfig;
-/** Define one unnamed Files SDK storage while preserving its provider and plugin types. */
-export declare function defineFilesConfig<const Storage extends StorageConfig>(config: SingleFilesConfig<Storage>): SingleFilesConfig<Storage>;
-/** Define named Files SDK storages while preserving their names, providers, and plugin types. */
-export declare function defineFilesConfig<const Storages extends Record<string, StorageConfig>>(config: NamedFilesConfig<Storages>): NamedFilesConfig<Storages>;
-/** Define one unnamed development-only storage. */
-export declare function defineFilesConfig<const Storage extends StorageConfig>(config: DevelopmentOnlySingleFilesConfig<Storage>): DevelopmentOnlySingleFilesConfig<Storage>;
-/** Define named development-only storages. */
-export declare function defineFilesConfig<const Storages extends Record<string, StorageConfig>>(config: DevelopmentOnlyNamedFilesConfig<Storages>): DevelopmentOnlyNamedFilesConfig<Storages>;
+} : {
+  storage: StorageNames<T>;
+});
+type EnvironmentCheck<T, Root> = T extends object ? Record<Exclude<keyof T, 'storage' | 'routes'>, never> & (T extends {
+  storage: infer S;
+} ? {
+  storage: S & StorageCheck<S>;
+} : unknown) & (T extends {
+  routes: unknown;
+} ? {
+  routes: readonly RouteCheck<Root>[];
+} : unknown) : never;
+type InputCheck<T> = Record<Exclude<keyof T, 'storage' | 'routes' | '$development' | '$production' | '$test' | '$prerender' | '$env'>, never> & (T extends {
+  storage: infer S;
+} ? {
+  storage: S & StorageCheck<S>;
+} : unknown) & (T extends {
+  routes: unknown;
+} ? {
+  routes: readonly RouteCheck<T>[];
+} : unknown) & { [K in Extract<keyof T, '$development' | '$production' | '$test' | '$prerender'>]: T[K] & EnvironmentCheck<T[K], T>; } & (T extends {
+  $env: infer E extends Record<string, unknown>;
+} ? {
+  $env: { [K in keyof E]: E[K] & EnvironmentCheck<E[K], T>; };
+} : unknown);
+/** Preserve storage names, adapters, and plugin literals without resolving an environment. */
+export declare function defineFilesConfig<const C extends object>(config: C & FilesConfigInput & InputCheck<NoInfer<C>>): C;
 //#endregion
 //# sourceMappingURL=config.d.ts.map

package/dist/config.js

@@ -1,7 +1,7 @@
 //#region src/config.ts
+/** Preserve storage names, adapters, and plugin literals without resolving an environment. */
 function defineFilesConfig(config) {
-	if (process.env.NODE_ENV !== "production") return config;
-	return { storage: config.storage };
+	return config;
 }
 //#endregion
 export { defineFilesConfig };

package/dist/config.js.map

@@ -1 +1 @@
-{"version":3,"file":"config.js","names":[],"sources":["../src/config.ts"],"sourcesContent":["import type { FilesHooks, FilesPlugin, ProviderSlug } from 'files-sdk'\n\ninterface ProviderFactories {\n    akamai: typeof import('files-sdk/akamai').akamai\n    alibaba: typeof import('files-sdk/alibaba').alibaba\n    appwrite: typeof import('files-sdk/appwrite').appwrite\n    archil: typeof import('files-sdk/archil').archil\n    azure: typeof import('files-sdk/azure').azure\n    'backblaze-b2': typeof import('files-sdk/backblaze-b2').backblazeB2\n    box: typeof import('files-sdk/box').box\n    'bun-s3': typeof import('files-sdk/bun-s3').bunS3\n    'bunny-storage': typeof import('files-sdk/bunny-storage').bunnyStorage\n    cloudinary: typeof import('files-sdk/cloudinary').cloudinaryAdapter\n    convex: typeof import('files-sdk/convex').convex\n    'digitalocean-spaces': typeof import('files-sdk/digitalocean-spaces').digitaloceanSpaces\n    dropbox: typeof import('files-sdk/dropbox').dropbox\n    exoscale: typeof import('files-sdk/exoscale').exoscale\n    filebase: typeof import('files-sdk/filebase').filebase\n    'firebase-storage': typeof import('files-sdk/firebase-storage').firebaseStorage\n    fs: typeof import('files-sdk/fs').fs\n    ftp: typeof import('files-sdk/ftp').ftp\n    gcs: typeof import('files-sdk/gcs').gcs\n    'google-drive': typeof import('files-sdk/google-drive').googleDrive\n    hetzner: typeof import('files-sdk/hetzner').hetzner\n    'ibm-cos': typeof import('files-sdk/ibm-cos').ibmCos\n    'idrive-e2': typeof import('files-sdk/idrive-e2').idriveE2\n    memory: typeof import('files-sdk/memory').memory\n    minio: typeof import('files-sdk/minio').minio\n    neon: typeof import('files-sdk/neon').neon\n    'netlify-blobs': typeof import('files-sdk/netlify-blobs').netlifyBlobs\n    onedrive: typeof import('files-sdk/onedrive').onedrive\n    'oracle-cloud': typeof import('files-sdk/oracle-cloud').oracleCloud\n    ovhcloud: typeof import('files-sdk/ovhcloud').ovhcloud\n    pocketbase: typeof import('files-sdk/pocketbase').pocketbase\n    r2: typeof import('files-sdk/r2').r2\n    s3: typeof import('files-sdk/s3').s3\n    's3-fetch': typeof import('files-sdk/s3-fetch').s3Fetch\n    scaleway: typeof import('files-sdk/scaleway').scaleway\n    sftp: typeof import('files-sdk/sftp').sftp\n    sharepoint: typeof import('files-sdk/sharepoint').sharepoint\n    storj: typeof import('files-sdk/storj').storj\n    supabase: typeof import('files-sdk/supabase').supabase\n    tencent: typeof import('files-sdk/tencent').tencent\n    tigris: typeof import('files-sdk/tigris').tigris\n    uploadthing: typeof import('files-sdk/uploadthing').uploadthing\n    'vercel-blob': typeof import('files-sdk/vercel-blob').vercelBlob\n    vultr: typeof import('files-sdk/vultr').vultr\n    wasabi: typeof import('files-sdk/wasabi').wasabi\n    webdav: typeof import('files-sdk/webdav').webdav\n    yandex: typeof import('files-sdk/yandex').yandex\n}\n\ntype ProviderOptions<Provider extends ProviderSlug> = Parameters<ProviderFactories[Provider]>[0]\ntype ConfigValue<Provider extends ProviderSlug> = Exclude<ProviderOptions<Provider>, undefined>\ntype ConfigInput<Provider extends ProviderSlug> = ConfigValue<Provider> | (() => ConfigValue<Provider>)\ntype ProviderConfig<Provider extends ProviderSlug> = {\n    /** Native provider factory options, or a synchronous runtime resolver for them. */\n    config?: ConfigInput<Provider>\n} & (undefined extends ProviderOptions<Provider> ? unknown : { config: ConfigInput<Provider> })\n\n/** Configuration for one Files SDK storage. */\nexport type StorageConfig<\n    Provider extends ProviderSlug = ProviderSlug,\n    Plugins extends readonly FilesPlugin[] = readonly FilesPlugin[],\n> = Provider extends ProviderSlug\n    ? {\n          /** Files SDK provider slug, for example `r2`, `s3`, or `fs`. */\n          adapter: Provider\n          /** Native Files SDK plugins applied in array order. */\n          plugins?: Plugins\n          /** Native Files SDK lifecycle hooks. */\n          hooks?: FilesHooks\n          /** Scope every operation under this key prefix. */\n          prefix?: string\n          /** Retry provider failures up to this many times. */\n          retries?: number\n          /** Per-attempt timeout in milliseconds. */\n          timeout?: number\n      } & ProviderConfig<Provider>\n    : never\n\n/** Development-only provider settings for a storage. */\nexport type DevStorageConfig<Provider extends ProviderSlug = ProviderSlug> = Provider extends ProviderSlug\n    ? { adapter: Provider } & ProviderConfig<Provider>\n    : never\n\n/** One unnamed storage, available through `useServerFiles()`. */\nexport interface SingleFilesConfig<Storage extends StorageConfig = StorageConfig> {\n    /** Files SDK storage configuration. */\n    storage: Storage\n    /** Development-only provider settings. */\n    devStorage?: DevStorageConfig\n}\n\n/** Named storages, each requiring its name when accessed. */\nexport interface NamedFilesConfig<Storages extends Record<string, StorageConfig> = Record<string, StorageConfig>> {\n    /** Files SDK storage configuration. */\n    storage: Storages\n    /** Development-only provider settings keyed by storage name. */\n    devStorage?: Partial<{ [Name in keyof Storages]: DevStorageConfig }>\n}\n\n/** One unnamed storage that exists only while the development server is running. */\nexport interface DevelopmentOnlySingleFilesConfig<Storage extends StorageConfig = StorageConfig> {\n    storage?: never\n    devStorage: Storage\n}\n\n/** Named storages that exist only while the development server is running. */\nexport interface DevelopmentOnlyNamedFilesConfig<\n    Storages extends Record<string, StorageConfig> = Record<string, StorageConfig>,\n> {\n    storage?: never\n    devStorage: Storages\n}\n\n/** Files SDK configuration used by the Nuxt/Nitro integration. */\nexport type FilesConfig =\n    | SingleFilesConfig\n    | NamedFilesConfig\n    | DevelopmentOnlySingleFilesConfig\n    | DevelopmentOnlyNamedFilesConfig\n\n/** Define one unnamed Files SDK storage while preserving its provider and plugin types. */\nexport function defineFilesConfig<const Storage extends StorageConfig>(\n    config: SingleFilesConfig<Storage>,\n): SingleFilesConfig<Storage>\n/** Define named Files SDK storages while preserving their names, providers, and plugin types. */\nexport function defineFilesConfig<const Storages extends Record<string, StorageConfig>>(\n    config: NamedFilesConfig<Storages>,\n): NamedFilesConfig<Storages>\n/** Define one unnamed development-only storage. */\nexport function defineFilesConfig<const Storage extends StorageConfig>(\n    config: DevelopmentOnlySingleFilesConfig<Storage>,\n): DevelopmentOnlySingleFilesConfig<Storage>\n/** Define named development-only storages. */\nexport function defineFilesConfig<const Storages extends Record<string, StorageConfig>>(\n    config: DevelopmentOnlyNamedFilesConfig<Storages>,\n): DevelopmentOnlyNamedFilesConfig<Storages>\nexport function defineFilesConfig(config: FilesConfig): FilesConfig | { storage: FilesConfig['storage'] } {\n    if (process.env.NODE_ENV !== 'production') return config\n    return { storage: config.storage }\n}\n"],"mappings":";AA2IA,SAAgB,kBAAkB,QAAwE;CACtG,IAAI,QAAQ,IAAI,aAAa,cAAc,OAAO;CAClD,OAAO,EAAE,SAAS,OAAO,QAAQ;AACrC"}
+{"version":3,"file":"config.js","names":[],"sources":["../src/config.ts"],"sourcesContent":["import type { Adapter, FilesHooks, FilesOptions, FilesPlugin, ProviderSlug } from 'files-sdk'\nimport type { AuthorizeContext, AuthorizeResult, CreateFilesRouterOptions } from 'files-sdk/api'\nimport type { H3Event } from 'h3'\n\nimport type { ProviderFactories } from './runtime/provider-types'\n\nexport type AdapterFactory = (...args: never[]) => Adapter\ntype StorageAdapter = ProviderSlug | AdapterFactory\nexport type FilesPluginContext = { storage: (name: string) => Adapter }\ntype FactoryFor<A extends StorageAdapter> = A extends ProviderSlug ? ProviderFactories[A] : A\ntype AdapterOptions<A extends StorageAdapter> =\n    Parameters<FactoryFor<A>> extends []\n        ? undefined\n        : [Parameters<FactoryFor<A>>[0]] extends [never]\n          ? unknown\n          : Parameters<FactoryFor<A>>[0]\ntype AdapterConfig<A extends StorageAdapter> = {\n    /** Native adapter factory options, or a synchronous runtime resolver for them. */\n    config?: Exclude<AdapterOptions<A>, undefined> | (() => Exclude<AdapterOptions<A>, undefined>)\n} & (undefined extends AdapterOptions<A>\n    ? unknown\n    : { config: Exclude<AdapterOptions<A>, undefined> | (() => Exclude<AdapterOptions<A>, undefined>) })\ntype CommonFilesOptions<A extends StorageAdapter> = Omit<\n    FilesOptions<ReturnType<FactoryFor<A>>>,\n    'adapter' | 'hooks' | 'plugins'\n>\n\n/** Configuration for one Files SDK storage. */\nexport type StorageConfig<\n    Provider extends StorageAdapter = StorageAdapter,\n    Plugins extends readonly FilesPlugin[] = readonly FilesPlugin[],\n> = Provider extends StorageAdapter\n    ? {\n          /** Files SDK provider slug or a compatible adapter factory. */\n          adapter: Provider\n          plugins?: Plugins | ((context: FilesPluginContext) => Plugins)\n          hooks?: FilesHooks\n      } & CommonFilesOptions<Provider> &\n          AdapterConfig<Provider>\n    : never\n\nexport type FilesRoute = Omit<CreateFilesRouterOptions, 'files' | 'authorize'> & {\n    path: string\n    storage?: string\n    authorize?: (context: AuthorizeContext & { event: H3Event }) => AuthorizeResult | Promise<AuthorizeResult>\n}\n\nexport type StorageSet = StorageConfig | Record<string, StorageConfig>\n/** One environment's Files options, before or after resolution. */\nexport interface FilesEnvironmentConfig {\n    storage?: StorageSet\n    routes?: readonly FilesRoute[]\n}\n/** User-authored configuration. Environment blocks can override every Files option. */\nexport interface FilesConfigInput extends FilesEnvironmentConfig {\n    /** Overrides applied by the development server. */\n    $development?: FilesEnvironmentConfig\n    $production?: FilesEnvironmentConfig\n    $test?: FilesEnvironmentConfig\n    $prerender?: FilesEnvironmentConfig\n    $env?: Record<string, FilesEnvironmentConfig>\n}\n/** Environment-resolved runtime configuration. */\nexport interface FilesConfig extends FilesEnvironmentConfig {\n    storage: StorageSet\n}\nexport interface SingleFilesConfig extends FilesConfig {\n    /** Files SDK storage configuration. */\n    storage: StorageConfig\n}\nexport interface NamedFilesConfig extends FilesConfig {\n    storage: Record<string, StorageConfig>\n}\n\ntype EntryCheck<T> = T extends { adapter: infer A extends StorageAdapter }\n    ? T extends StorageConfig<A>\n        ? Record<Exclude<keyof T, keyof StorageConfig<A>>, never>\n        : StorageConfig<A>\n    : never\ntype StorageCheck<T> = T extends { adapter: unknown }\n    ? EntryCheck<T>\n    : T extends Record<string, unknown>\n      ? { [K in keyof T]: EntryCheck<T[K]> }\n      : never\ntype StorageOf<T> = T extends { storage: infer S } ? S : never\ntype StorageBranches<T> =\n    | StorageOf<T>\n    | StorageOf<T extends { $development: infer E } ? E : never>\n    | StorageOf<T extends { $production: infer E } ? E : never>\n    | StorageOf<T extends { $test: infer E } ? E : never>\n    | StorageOf<T extends { $prerender: infer E } ? E : never>\n    | StorageOf<T extends { $env: infer E } ? E[keyof E] : never>\ntype StorageNames<T> =\n    StorageBranches<T> extends infer S\n        ? S extends { adapter: unknown }\n            ? never\n            : S extends object\n              ? Extract<keyof S, string>\n              : never\n        : never\ntype RouteCheck<T> = FilesRoute &\n    ([StorageNames<T>] extends [never] ? { storage?: never } : { storage: StorageNames<T> })\ntype EnvironmentCheck<T, Root> = T extends object\n    ? Record<Exclude<keyof T, 'storage' | 'routes'>, never> &\n          (T extends { storage: infer S } ? { storage: S & StorageCheck<S> } : unknown) &\n          (T extends { routes: unknown } ? { routes: readonly RouteCheck<Root>[] } : unknown)\n    : never\ntype InputCheck<T> = Record<\n    Exclude<keyof T, 'storage' | 'routes' | '$development' | '$production' | '$test' | '$prerender' | '$env'>,\n    never\n> &\n    (T extends { storage: infer S } ? { storage: S & StorageCheck<S> } : unknown) &\n    (T extends { routes: unknown } ? { routes: readonly RouteCheck<T>[] } : unknown) & {\n        [K in Extract<keyof T, '$development' | '$production' | '$test' | '$prerender'>]: T[K] &\n            EnvironmentCheck<T[K], T>\n    } & (T extends { $env: infer E extends Record<string, unknown> }\n        ? { $env: { [K in keyof E]: E[K] & EnvironmentCheck<E[K], T> } }\n        : unknown)\n\n/** Preserve storage names, adapters, and plugin literals without resolving an environment. */\nexport function defineFilesConfig<const C extends object>(config: C & FilesConfigInput & InputCheck<NoInfer<C>>): C {\n    return config\n}\n"],"mappings":";;AAwHA,SAAgB,kBAA0C,QAA0D;CAChH,OAAO;AACX"}

package/dist/devtools/auth.js

@@ -0,0 +1,49 @@
+//#region src/devtools/auth.ts
+const FILES_DEVTOOLS_TOKEN_TTL = 6e4;
+const encoder = new TextEncoder();
+const base64Url = (bytes) => btoa(String.fromCharCode(...bytes)).replaceAll("+", "-").replaceAll("/", "_").replaceAll("=", "");
+const decodeBase64Url = (value) => {
+	const base64 = value.replaceAll("-", "+").replaceAll("_", "/");
+	const decoded = atob(`${base64}${"=".repeat((4 - base64.length % 4) % 4)}`);
+	const bytes = new Uint8Array(new ArrayBuffer(decoded.length));
+	for (let index = 0; index < decoded.length; index += 1) bytes[index] = decoded.charCodeAt(index);
+	return bytes.buffer;
+};
+const key = (secret) => crypto.subtle.importKey("raw", encoder.encode(secret), {
+	name: "HMAC",
+	hash: "SHA-256"
+}, false, ["sign", "verify"]);
+const createFilesDevtoolsToken = async (secret, now = Date.now()) => {
+	const expiresAt = now + FILES_DEVTOOLS_TOKEN_TTL;
+	const payload = String(expiresAt);
+	const signature = await crypto.subtle.sign("HMAC", await key(secret), encoder.encode(payload));
+	return {
+		token: `${payload}.${base64Url(new Uint8Array(signature))}`,
+		expiresAt
+	};
+};
+const verifyFilesDevtoolsToken = async (token, secret, now = Date.now()) => {
+	const separator = token.indexOf(".");
+	if (separator < 1) return false;
+	const payload = token.slice(0, separator);
+	const expiresAt = Number(payload);
+	if (!Number.isSafeInteger(expiresAt) || expiresAt <= now || expiresAt > now + 6e4) return false;
+	try {
+		return await crypto.subtle.verify("HMAC", await key(secret), decodeBase64Url(token.slice(separator + 1)), encoder.encode(payload));
+	} catch {
+		return false;
+	}
+};
+const authorizationHeader = (headers) => {
+	if (headers instanceof Headers) return headers.get("authorization") ?? void 0;
+	const value = headers.get?.("authorization") ?? headers.authorization;
+	return Array.isArray(value) ? value[0] : value;
+};
+const authorizeFilesDevtoolsRequest = async (request, secret) => {
+	const authorization = authorizationHeader(request.headers);
+	return authorization?.startsWith("Bearer ") ? verifyFilesDevtoolsToken(authorization.slice(7), secret) : false;
+};
+//#endregion
+export { FILES_DEVTOOLS_TOKEN_TTL, authorizeFilesDevtoolsRequest, createFilesDevtoolsToken, verifyFilesDevtoolsToken };
+
+//# sourceMappingURL=auth.js.map

package/dist/devtools/auth.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth.js","names":[],"sources":["../../src/devtools/auth.ts"],"sourcesContent":["export interface FilesDevtoolsToken {\n    token: string\n    expiresAt: number\n}\n\nexport const FILES_DEVTOOLS_TOKEN_TTL = 60_000\n\nconst encoder = new TextEncoder()\nconst base64Url = (bytes: Uint8Array): string =>\n    btoa(String.fromCharCode(...bytes))\n        .replaceAll('+', '-')\n        .replaceAll('/', '_')\n        .replaceAll('=', '')\nconst decodeBase64Url = (value: string): ArrayBuffer => {\n    const base64 = value.replaceAll('-', '+').replaceAll('_', '/')\n    const decoded = atob(`${base64}${'='.repeat((4 - (base64.length % 4)) % 4)}`)\n    const bytes = new Uint8Array(new ArrayBuffer(decoded.length))\n    for (let index = 0; index < decoded.length; index += 1) bytes[index] = decoded.charCodeAt(index)\n    return bytes.buffer\n}\nconst key = (secret: string): Promise<CryptoKey> =>\n    crypto.subtle.importKey('raw', encoder.encode(secret), { name: 'HMAC', hash: 'SHA-256' }, false, ['sign', 'verify'])\n\nexport const createFilesDevtoolsToken = async (secret: string, now = Date.now()): Promise<FilesDevtoolsToken> => {\n    const expiresAt = now + FILES_DEVTOOLS_TOKEN_TTL\n    const payload = String(expiresAt)\n    const signature = await crypto.subtle.sign('HMAC', await key(secret), encoder.encode(payload))\n    return { token: `${payload}.${base64Url(new Uint8Array(signature))}`, expiresAt }\n}\n\nexport const verifyFilesDevtoolsToken = async (token: string, secret: string, now = Date.now()): Promise<boolean> => {\n    const separator = token.indexOf('.')\n    if (separator < 1) return false\n    const payload = token.slice(0, separator)\n    const expiresAt = Number(payload)\n    if (!Number.isSafeInteger(expiresAt) || expiresAt <= now || expiresAt > now + FILES_DEVTOOLS_TOKEN_TTL) return false\n    try {\n        return await crypto.subtle.verify(\n            'HMAC',\n            await key(secret),\n            decodeBase64Url(token.slice(separator + 1)),\n            encoder.encode(payload),\n        )\n    } catch {\n        return false\n    }\n}\n\ntype RequestHeaders =\n    | Headers\n    | {\n          authorization?: string | string[] | undefined\n          get?: ((name: string) => string | null | undefined) | undefined\n      }\n\nconst authorizationHeader = (headers: RequestHeaders): string | undefined => {\n    if (headers instanceof Headers) return headers.get('authorization') ?? undefined\n    const value = headers.get?.('authorization') ?? headers.authorization\n    return Array.isArray(value) ? value[0] : value\n}\n\nexport const authorizeFilesDevtoolsRequest = async (\n    request: { headers: RequestHeaders },\n    secret: string,\n): Promise<boolean> => {\n    const authorization = authorizationHeader(request.headers)\n    return authorization?.startsWith('Bearer ')\n        ? verifyFilesDevtoolsToken(authorization.slice('Bearer '.length), secret)\n        : false\n}\n"],"mappings":";AAKA,MAAa,2BAA2B;AAExC,MAAM,UAAU,IAAI,YAAY;AAChC,MAAM,aAAa,UACf,KAAK,OAAO,aAAa,GAAG,KAAK,CAAC,CAAC,CAC9B,WAAW,KAAK,GAAG,CAAC,CACpB,WAAW,KAAK,GAAG,CAAC,CACpB,WAAW,KAAK,EAAE;AAC3B,MAAM,mBAAmB,UAA+B;CACpD,MAAM,SAAS,MAAM,WAAW,KAAK,GAAG,CAAC,CAAC,WAAW,KAAK,GAAG;CAC7D,MAAM,UAAU,KAAK,GAAG,SAAS,IAAI,QAAQ,IAAK,OAAO,SAAS,KAAM,CAAC,GAAG;CAC5E,MAAM,QAAQ,IAAI,WAAW,IAAI,YAAY,QAAQ,MAAM,CAAC;CAC5D,KAAK,IAAI,QAAQ,GAAG,QAAQ,QAAQ,QAAQ,SAAS,GAAG,MAAM,SAAS,QAAQ,WAAW,KAAK;CAC/F,OAAO,MAAM;AACjB;AACA,MAAM,OAAO,WACT,OAAO,OAAO,UAAU,OAAO,QAAQ,OAAO,MAAM,GAAG;CAAE,MAAM;CAAQ,MAAM;AAAU,GAAG,OAAO,CAAC,QAAQ,QAAQ,CAAC;AAEvH,MAAa,2BAA2B,OAAO,QAAgB,MAAM,KAAK,IAAI,MAAmC;CAC7G,MAAM,YAAY,MAAM;CACxB,MAAM,UAAU,OAAO,SAAS;CAChC,MAAM,YAAY,MAAM,OAAO,OAAO,KAAK,QAAQ,MAAM,IAAI,MAAM,GAAG,QAAQ,OAAO,OAAO,CAAC;CAC7F,OAAO;EAAE,OAAO,GAAG,QAAQ,GAAG,UAAU,IAAI,WAAW,SAAS,CAAC;EAAK;CAAU;AACpF;AAEA,MAAa,2BAA2B,OAAO,OAAe,QAAgB,MAAM,KAAK,IAAI,MAAwB;CACjH,MAAM,YAAY,MAAM,QAAQ,GAAG;CACnC,IAAI,YAAY,GAAG,OAAO;CAC1B,MAAM,UAAU,MAAM,MAAM,GAAG,SAAS;CACxC,MAAM,YAAY,OAAO,OAAO;CAChC,IAAI,CAAC,OAAO,cAAc,SAAS,KAAK,aAAa,OAAO,YAAY,MAAA,KAAgC,OAAO;CAC/G,IAAI;EACA,OAAO,MAAM,OAAO,OAAO,OACvB,QACA,MAAM,IAAI,MAAM,GAChB,gBAAgB,MAAM,MAAM,YAAY,CAAC,CAAC,GAC1C,QAAQ,OAAO,OAAO,CAC1B;CACJ,QAAQ;EACJ,OAAO;CACX;AACJ;AASA,MAAM,uBAAuB,YAAgD;CACzE,IAAI,mBAAmB,SAAS,OAAO,QAAQ,IAAI,eAAe,KAAK,KAAA;CACvE,MAAM,QAAQ,QAAQ,MAAM,eAAe,KAAK,QAAQ;CACxD,OAAO,MAAM,QAAQ,KAAK,IAAI,MAAM,KAAK;AAC7C;AAEA,MAAa,gCAAgC,OACzC,SACA,WACmB;CACnB,MAAM,gBAAgB,oBAAoB,QAAQ,OAAO;CACzD,OAAO,eAAe,WAAW,SAAS,IACpC,yBAAyB,cAAc,MAAM,CAAgB,GAAG,MAAM,IACtE;AACV"}