nuxt-files-sdk 0.0.0 → 0.0.2

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Liry24
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,3 +1,5 @@
 # nuxt-files-sdk
 
-This is a stub package published by setup-trusted-publishing to enable OIDC trusted publishing configuration.
+Native-first integration of [Files SDK](https://github.com/haydenbleasel/files-sdk) with Nuxt and Nitro.
+
+> This repository is under initial development.

package/dist/config.d.ts

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

package/dist/config.js

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

package/dist/config.js.map

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

package/dist/devtools/client/index.html

@@ -0,0 +1,113 @@
+<!doctype html>
+<html lang="en">
+    <head>
+        <meta charset="UTF-8" />
+        <meta name="viewport" content="width=device-width, initial-scale=1" />
+        <title>Files</title>
+        <style>
+            :root {
+                color-scheme: light dark;
+                font-family: system-ui, sans-serif;
+            }
+            body {
+                margin: 0;
+                padding: 20px;
+                background: Canvas;
+                color: CanvasText;
+            }
+            h1 {
+                margin: 0 0 4px;
+                font-size: 20px;
+            }
+            #summary {
+                margin: 0 0 20px;
+                color: GrayText;
+            }
+            table {
+                width: 100%;
+                border-collapse: collapse;
+            }
+            th,
+            td {
+                padding: 10px;
+                border-bottom: 1px solid color-mix(in srgb, CanvasText 18%, transparent);
+                text-align: left;
+            }
+            th {
+                font-size: 12px;
+                color: GrayText;
+                text-transform: uppercase;
+            }
+            code {
+                font-family: ui-monospace, monospace;
+            }
+            .warning,
+            .error {
+                padding: 10px;
+                border-radius: 6px;
+                background: color-mix(in srgb, orange 16%, Canvas);
+            }
+            .error {
+                background: color-mix(in srgb, red 16%, Canvas);
+            }
+        </style>
+    </head>
+    <body>
+        <main>
+            <h1>Files</h1>
+            <p id="summary" aria-live="polite">Loading resolved configuration…</p>
+            <section aria-labelledby="storages-heading">
+                <h2 id="storages-heading">Storages</h2>
+                <table>
+                    <thead>
+                        <tr>
+                            <th>Name</th>
+                            <th>Adapter</th>
+                            <th>Plugins</th>
+                            <th>Source</th>
+                            <th>Status</th>
+                        </tr>
+                    </thead>
+                    <tbody id="storages"></tbody>
+                </table>
+            </section>
+            <section aria-labelledby="diagnostics-heading">
+                <h2 id="diagnostics-heading">Diagnostics</h2>
+                <div id="diagnostics"></div>
+            </section>
+        </main>
+        <script type="module">
+            const snapshot = await fetch('./snapshot').then((response) => response.json())
+            document.querySelector('#summary').textContent =
+                `${snapshot.storages.length} configured storage${snapshot.storages.length === 1 ? '' : 's'}`
+            document.querySelector('#storages').replaceChildren(
+                ...snapshot.storages.map((storage) => {
+                    const row = document.createElement('tr')
+                    for (const value of [
+                        storage.name,
+                        storage.adapter,
+                        storage.plugins.join(', ') || '—',
+                        storage.source,
+                        storage.initialized ? 'Initialized' : 'Not initialized',
+                    ]) {
+                        const cell = document.createElement('td')
+                        cell.textContent = value
+                        row.append(cell)
+                    }
+                    return row
+                }),
+            )
+            const diagnostics = document.querySelector('#diagnostics')
+            if (!snapshot.diagnostics.length) diagnostics.textContent = 'No integration diagnostics.'
+            else
+                diagnostics.replaceChildren(
+                    ...snapshot.diagnostics.map((item) => {
+                        const message = document.createElement('p')
+                        message.className = item.level
+                        message.textContent = `${item.code}: ${item.message}`
+                        return message
+                    }),
+                )
+        </script>
+    </body>
+</html>

package/dist/devtools/devframe.js

@@ -0,0 +1,24 @@
+import { FILES_DEVTOOLS_PATH } from "./snapshot.js";
+import { version } from "../package.js";
+import { fileURLToPath } from "node:url";
+import { defineDevframe } from "devframe";
+//#region src/devtools/devframe.ts
+var devframe_default = defineDevframe({
+	id: "nuxt-files-sdk",
+	name: "Files",
+	version,
+	packageName: "nuxt-files-sdk",
+	importMetaUrl: import.meta.url,
+	homepage: "https://github.com/liria24/nuxt-files-sdk",
+	description: "Files SDK storage and integration diagnostics for Nuxt.",
+	icon: "ph:files-duotone",
+	basePath: FILES_DEVTOOLS_PATH,
+	cli: { distDir: fileURLToPath(new URL("./client", import.meta.url)) },
+	setup(context) {
+		context.views.hostStatic(FILES_DEVTOOLS_PATH, fileURLToPath(new URL("./client", import.meta.url)));
+	}
+});
+//#endregion
+export { devframe_default as default };
+
+//# sourceMappingURL=devframe.js.map

package/dist/devtools/devframe.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"devframe.js","names":[],"sources":["../../src/devtools/devframe.ts"],"sourcesContent":["import { fileURLToPath } from 'node:url'\n\nimport { defineDevframe } from 'devframe'\n\nimport { version } from '../../package.json'\nimport { FILES_DEVTOOLS_PATH } from './snapshot'\n\nexport default defineDevframe({\n    id: 'nuxt-files-sdk',\n    name: 'Files',\n    version,\n    packageName: 'nuxt-files-sdk',\n    importMetaUrl: import.meta.url,\n    homepage: 'https://github.com/liria24/nuxt-files-sdk',\n    description: 'Files SDK storage and integration diagnostics for Nuxt.',\n    icon: 'ph:files-duotone',\n    basePath: FILES_DEVTOOLS_PATH,\n    cli: { distDir: fileURLToPath(new URL('./client', import.meta.url)) },\n    setup(context) {\n        context.views.hostStatic(FILES_DEVTOOLS_PATH, fileURLToPath(new URL('./client', import.meta.url)))\n    },\n})\n"],"mappings":";;;;;AAOA,IAAA,mBAAe,eAAe;CAC1B,IAAI;CACJ,MAAM;CACN;CACA,aAAa;CACb,eAAe,YAAY;CAC3B,UAAU;CACV,aAAa;CACb,MAAM;CACN,UAAU;CACV,KAAK,EAAE,SAAS,cAAc,IAAI,IAAI,YAAY,YAAY,GAAG,CAAC,EAAE;CACpE,MAAM,SAAS;EACX,QAAQ,MAAM,WAAW,qBAAqB,cAAc,IAAI,IAAI,YAAY,YAAY,GAAG,CAAC,CAAC;CACrG;AACJ,CAAC"}

package/dist/devtools/enabled.js

@@ -0,0 +1,6 @@
+//#region src/devtools/enabled.ts
+const shouldEnableFilesDevtools = (development, moduleEnabled, nuxtDevtools) => development && moduleEnabled && (typeof nuxtDevtools === "boolean" ? nuxtDevtools : nuxtDevtools.enabled);
+//#endregion
+export { shouldEnableFilesDevtools };
+
+//# sourceMappingURL=enabled.js.map

package/dist/devtools/enabled.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"enabled.js","names":[],"sources":["../../src/devtools/enabled.ts"],"sourcesContent":["export const shouldEnableFilesDevtools = (\n    development: boolean,\n    moduleEnabled: boolean,\n    nuxtDevtools: boolean | { enabled: boolean },\n): boolean => development && moduleEnabled && (typeof nuxtDevtools === 'boolean' ? nuxtDevtools : nuxtDevtools.enabled)\n"],"mappings":";AAAA,MAAa,6BACT,aACA,eACA,iBACU,eAAe,kBAAkB,OAAO,iBAAiB,YAAY,eAAe,aAAa"}

package/dist/devtools/index.js

@@ -0,0 +1,25 @@
+import nuxt_v3_handler_default from "./nuxt-v3-handler.js";
+import { FILES_DEVTOOLS_PATH, FILES_SNAPSHOT_PATH } from "./snapshot.js";
+import { setupNuxtV3Devtools } from "./nuxt-v3.js";
+import { setupNuxtV4Devtools } from "./nuxt-v4.js";
+import { addDevServerHandler, addServerHandler } from "@nuxt/kit";
+import { fileURLToPath } from "node:url";
+//#region src/devtools/index.ts
+const setupFilesDevtools = (nuxt, version) => {
+	addServerHandler({
+		route: FILES_SNAPSHOT_PATH,
+		handler: fileURLToPath(new URL("./snapshot.js", import.meta.url))
+	});
+	if (Number.parseInt(version) >= 4) setupNuxtV4Devtools(nuxt);
+	else {
+		addDevServerHandler({
+			route: FILES_DEVTOOLS_PATH,
+			handler: nuxt_v3_handler_default
+		});
+		setupNuxtV3Devtools(nuxt);
+	}
+};
+//#endregion
+export { setupFilesDevtools };
+
+//# sourceMappingURL=index.js.map

package/dist/devtools/index.js.map

@@ -0,0 +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 { FILES_DEVTOOLS_PATH, FILES_SNAPSHOT_PATH } from './snapshot'\n\nexport const setupFilesDevtools = (nuxt: Nuxt, version: string): 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    if (Number.parseInt(version) >= 4) {\n        setupNuxtV4Devtools(nuxt)\n    } else {\n        addDevServerHandler({\n            route: FILES_DEVTOOLS_PATH,\n            handler: uiHandler,\n        })\n        setupNuxtV3Devtools(nuxt)\n    }\n}\n"],"mappings":";;;;;;;AAUA,MAAa,sBAAsB,MAAY,YAA0B;CAErE,iBAAiB;EACb,OAAO;EACP,SAAS,cAAc,IAAI,IAAI,iBAAiB,YAAY,GAAG,CAAC;CACpE,CAAC;CACD,IAAI,OAAO,SAAS,OAAO,KAAK,GAC5B,oBAAoB,IAAI;MACrB;EACH,oBAAoB;GAChB,OAAO;GACP,SAASA;EACb,CAAC;EACD,oBAAoB,IAAI;CAC5B;AACJ"}

package/dist/devtools/nuxt-v3-handler.d.ts

@@ -0,0 +1,12 @@
+//#region src/devtools/nuxt-v3-handler.d.ts
+declare function _default(event: {
+  path: string;
+  node: {
+    res: {
+      setHeader(name: string, value: string): void;
+    };
+  };
+}): Promise<string | undefined>;
+//#endregion
+export { _default as default };
+//# sourceMappingURL=nuxt-v3-handler.d.ts.map

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

@@ -0,0 +1,12 @@
+import { readFile } from "node:fs/promises";
+//#region src/devtools/nuxt-v3-handler.ts
+const html = readFile(new URL("./client/index.html", import.meta.url), "utf8");
+var nuxt_v3_handler_default = async (event) => {
+	if (event.path !== "/" && event.path !== "/index.html") return void 0;
+	event.node.res.setHeader("content-type", "text/html; charset=utf-8");
+	return html;
+};
+//#endregion
+export { nuxt_v3_handler_default as default };
+
+//# sourceMappingURL=nuxt-v3-handler.js.map

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

@@ -0,0 +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 = readFile(new URL('./client/index.html', import.meta.url), 'utf8')\n\nexport default async (event: { path: string; node: { res: { setHeader(name: string, value: string): void } } }) => {\n    if (event.path !== '/' && event.path !== '/index.html') return undefined\n    event.node.res.setHeader('content-type', 'text/html; charset=utf-8')\n    return html\n}\n"],"mappings":";;AAEA,MAAM,OAAO,SAAS,IAAI,IAAI,uBAAuB,YAAY,GAAG,GAAG,MAAM;AAE7E,IAAA,0BAAe,OAAO,UAA6F;CAC/G,IAAI,MAAM,SAAS,OAAO,MAAM,SAAS,eAAe,OAAO,KAAA;CAC/D,MAAM,KAAK,IAAI,UAAU,gBAAgB,0BAA0B;CACnE,OAAO;AACX"}

package/dist/devtools/nuxt-v3.js

@@ -0,0 +1,19 @@
+import { FILES_DEVTOOLS_PATH } from "./snapshot.js";
+//#region src/devtools/nuxt-v3.ts
+const setupNuxtV3Devtools = (nuxt) => {
+	nuxt.hook("devtools:customTabs", (tabs) => {
+		tabs.push({
+			name: "nuxt-files-sdk",
+			title: "Files",
+			icon: "ph:files-duotone",
+			view: {
+				type: "iframe",
+				src: FILES_DEVTOOLS_PATH
+			}
+		});
+	});
+};
+//#endregion
+export { setupNuxtV3Devtools };
+
+//# sourceMappingURL=nuxt-v3.js.map

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

@@ -0,0 +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"}

package/dist/devtools/nuxt-v4.js

@@ -0,0 +1,21 @@
+import { FILES_DEVTOOLS_PATH } from "./snapshot.js";
+import devframe_default from "./devframe.js";
+import { createEmbedded } from "devframe/adapters/embedded";
+//#region src/devtools/nuxt-v4.ts
+const setupNuxtV4Devtools = (nuxt) => {
+	nuxt.hook("devtools:ready", async (context) => {
+		await createEmbedded(devframe_default, { ctx: context });
+		context.docks.register({
+			id: "nuxt-files-sdk",
+			title: "Files",
+			icon: "ph:files-duotone",
+			type: "iframe",
+			url: FILES_DEVTOOLS_PATH,
+			groupId: "nuxt"
+		});
+	});
+};
+//#endregion
+export { setupNuxtV4Devtools };
+
+//# sourceMappingURL=nuxt-v4.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"nuxt-v4.js","names":["filesDevframe"],"sources":["../../src/devtools/nuxt-v4.ts"],"sourcesContent":["import type { Nuxt } from '@nuxt/schema'\nimport { createEmbedded } from 'devframe/adapters/embedded'\n\nimport filesDevframe from './devframe'\nimport { FILES_DEVTOOLS_PATH } from './snapshot'\n\ntype DevtoolsContext = Parameters<typeof createEmbedded>[1]['ctx'] & {\n    docks: {\n        register(entry: {\n            id: string\n            title: string\n            icon: string\n            type: 'iframe'\n            url: string\n            groupId: string\n        }): unknown\n    }\n}\n\ndeclare module '@nuxt/schema' {\n    interface NuxtHooks {\n        'devtools:ready': (context: DevtoolsContext) => void | Promise<void>\n    }\n}\n\nexport const setupNuxtV4Devtools = (nuxt: Nuxt): void => {\n    nuxt.hook('devtools:ready', async (context) => {\n        await createEmbedded(filesDevframe, { ctx: context })\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',\n        })\n    })\n}\n"],"mappings":";;;;AAyBA,MAAa,uBAAuB,SAAqB;CACrD,KAAK,KAAK,kBAAkB,OAAO,YAAY;EAC3C,MAAM,eAAeA,kBAAe,EAAE,KAAK,QAAQ,CAAC;EACpD,QAAQ,MAAM,SAAS;GACnB,IAAI;GACJ,OAAO;GACP,MAAM;GACN,MAAM;GACN,KAAK;GACL,SAAS;EACb,CAAC;CACL,CAAC;AACL"}

package/dist/devtools/snapshot.d.ts

@@ -0,0 +1,21 @@
+//#region src/devtools/snapshot.d.ts
+export interface FilesDevtoolsSnapshot {
+  storages: Array<{
+    name: string;
+    adapter: string;
+    plugins: string[];
+    source: 'storage' | 'devStorage';
+    initialized: boolean;
+  }>;
+  diagnostics: Array<{
+    code: string;
+    level: 'info' | 'warning' | 'error';
+    message: string;
+  }>;
+}
+export declare const FILES_DEVTOOLS_PATH = "/__nuxt-files-sdk/";
+export declare const FILES_SNAPSHOT_PATH = "/__nuxt-files-sdk/snapshot";
+declare function _default(): FilesDevtoolsSnapshot;
+//#endregion
+export { _default as default };
+//# sourceMappingURL=snapshot.d.ts.map

package/dist/devtools/snapshot.js

@@ -0,0 +1,9 @@
+import { inspectFiles } from "../runtime.js";
+//#region src/devtools/snapshot.ts
+const FILES_DEVTOOLS_PATH = "/__nuxt-files-sdk/";
+const FILES_SNAPSHOT_PATH = `${FILES_DEVTOOLS_PATH}snapshot`;
+var snapshot_default = () => inspectFiles();
+//#endregion
+export { FILES_DEVTOOLS_PATH, FILES_SNAPSHOT_PATH, snapshot_default as default };
+
+//# sourceMappingURL=snapshot.js.map

package/dist/devtools/snapshot.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"snapshot.js","names":[],"sources":["../../src/devtools/snapshot.ts"],"sourcesContent":["import { inspectFiles } from '../runtime'\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: Array<{\n        code: string\n        level: 'info' | 'warning' | 'error'\n        message: string\n    }>\n}\n\nexport const FILES_DEVTOOLS_PATH = '/__nuxt-files-sdk/'\nexport const FILES_SNAPSHOT_PATH = `${FILES_DEVTOOLS_PATH}snapshot`\n\nexport default () => inspectFiles()\n"],"mappings":";;AAiBA,MAAa,sBAAsB;AACnC,MAAa,sBAAsB,GAAG,oBAAoB;AAE1D,IAAA,yBAAqB,aAAa"}

package/dist/integration/nitro.d.ts

@@ -0,0 +1,32 @@
+//#region src/integration/nitro.d.ts
+export interface NitroIntegration {
+  meta?: {
+    majorVersion?: number;
+  };
+  options: {
+    rootDir: string;
+    buildDir: string;
+    dev?: boolean;
+    plugins: string[];
+    externals?: {
+      inline?: unknown[];
+    };
+  };
+  unimport?: {
+    getInternalContext(): {
+      addons: {
+        name?: string;
+        declaration?: (declarations: string) => string;
+      }[];
+    };
+  };
+  hooks: {
+    hook(name: 'types:extend', callback: (types: {
+      tsConfig?: {
+        include?: string[];
+      };
+    }) => void | Promise<void>): void;
+  };
+}
+//#endregion
+//# sourceMappingURL=nitro.d.ts.map

package/dist/integration/nitro.js

@@ -0,0 +1,57 @@
+import { resolve } from "node:path";
+import { mkdir, writeFile } from "node:fs/promises";
+//#region src/integration/nitro.ts
+const hookTypes = (moduleName) => `
+declare module ${JSON.stringify(moduleName)} {
+  interface NitroRuntimeHooks {
+    'files:action': (payload: { event: import('files-sdk').FilesActionEvent; storage: string }) => void | Promise<void>
+    'files:error': (payload: { event: import('files-sdk').FilesErrorEvent; storage: string }) => void | Promise<void>
+    'files:retry': (payload: { event: import('files-sdk').FilesRetryEvent; storage: string }) => void | Promise<void>
+  }
+}
+`;
+const storageTypes = (configPath, nitroMajor) => `import type config from ${JSON.stringify(configPath)}
+import type { DefaultStorage, StorageRegistry } from 'nuxt-files-sdk/runtime'
+
+declare module 'nuxt-files-sdk/runtime' {
+  interface NuxtFilesStorageRegistry extends StorageRegistry<typeof config> {}
+  interface NuxtFilesDefaultStorage { value: DefaultStorage<typeof config> }
+}
+${hookTypes(nitroMajor >= 3 ? "nitro/types" : "nitropack/types")}
+export {}
+`;
+const setupNitroFilesIntegration = async (nitro, options) => {
+	const configPath = options.configPath.replaceAll("\\", "/");
+	nitro.unimport?.getInternalContext().addons.push({
+		name: "nuxt-files-sdk-jsdoc",
+		declaration: (declarations) => declarations.replace(/^(\s*)(const useServerFiles: typeof .*\.useServerFiles)$/mu, "$1/** Return the project's default Files client, including its configured plugin extensions. */\n$1$2")
+	});
+	const externals = nitro.options.externals ??= {};
+	(externals.inline ??= []).push("nuxt-files-sdk");
+	if (!nitro.options.dev) externals.inline.push("files-sdk");
+	const directory = resolve(nitro.options.buildDir, "nuxt-files-sdk");
+	const pluginPath = resolve(directory, "plugin.mjs");
+	const typesPath = resolve(directory, "storage-registry.d.ts");
+	externals.inline.push(pluginPath.replaceAll("\\", "/"), configPath);
+	nitro.options.plugins.push(pluginPath.replaceAll("\\", "/"));
+	nitro.hooks.hook("types:extend", async (types) => {
+		await mkdir(directory, { recursive: true });
+		await Promise.all([writeFile(pluginPath, `import config from ${JSON.stringify(configPath)}
+import { configureFiles } from 'nuxt-files-sdk/runtime'
+
+export default (nitroApp) => configureFiles(config, {
+  development: ${JSON.stringify(options.development)},
+  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)))]);
+		types.tsConfig?.include?.push(typesPath);
+	});
+};
+//#endregion
+export { setupNitroFilesIntegration, storageTypes };
+
+//# sourceMappingURL=nitro.js.map

package/dist/integration/nitro.js.map

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

package/dist/module.d.ts

@@ -0,0 +1,22 @@
+import { NitroIntegration } from "./integration/nitro.js";
+import { DefaultStorage, DefaultStorageName, FilesForStorage, FilesRegistry, FilesRuntimeHooks, StorageRegistry } from "./runtime/registry.js";
+import { NuxtFilesDefaultStorage, NuxtFilesStorageRegistry, configureFiles, inspectFiles, useServerFiles } from "./runtime.js";
+export * from "files-sdk";
+//#region src/module.d.ts
+declare module '@nuxt/schema' {
+  interface NuxtHooks {
+    'nitro:init': (nitro: NitroIntegration) => void | Promise<void>;
+  }
+}
+/** Options for the Nuxt Files SDK module. */
+export interface ModuleOptions {
+  /** Path to the Files configuration module, relative to the Nuxt root directory. */
+  config: string;
+  /** Enable Files SDK development diagnostics when Nuxt DevTools is available. */
+  devtools: boolean;
+}
+/** Install Files SDK storage configuration, server utilities, Vue composables, and development diagnostics in Nuxt. */
+declare const _default: import("@nuxt/schema").NuxtModule<ModuleOptions, ModuleOptions, false>;
+//#endregion
+export { type DefaultStorage, type DefaultStorageName, type FilesForStorage, FilesRegistry, type FilesRuntimeHooks, NuxtFilesDefaultStorage, NuxtFilesStorageRegistry, type StorageRegistry, configureFiles, _default as default, inspectFiles, useServerFiles };
+//# sourceMappingURL=module.d.ts.map

package/dist/module.js

@@ -0,0 +1,52 @@
+import { shouldEnableFilesDevtools } from "./devtools/enabled.js";
+import { setupNitroFilesIntegration } from "./integration/nitro.js";
+import { FilesRegistry } from "./runtime/registry.js";
+import { configureFiles, inspectFiles, useServerFiles } from "./runtime.js";
+import { resolve } from "node:path";
+import { addImports, addServerImports, defineNuxtModule, getNuxtModuleVersion } from "@nuxt/kit";
+export * from "files-sdk";
+//#region src/module.ts
+/** Install Files SDK storage configuration, server utilities, Vue composables, and development diagnostics in Nuxt. */
+var module_default = defineNuxtModule({
+	meta: {
+		name: "nuxt-files-sdk",
+		configKey: "files",
+		compatibility: { nuxt: "^4.0.0 || ^5.0.0" }
+	},
+	defaults: {
+		config: "files.config.ts",
+		devtools: true
+	},
+	async setup(options, nuxt) {
+		const configPath = resolve(nuxt.options.rootDir, options.config);
+		nuxt.hook("nitro:init", (nitro) => setupNitroFilesIntegration(nitro, {
+			configPath,
+			development: nuxt.options.dev
+		}));
+		nuxt.hook("prepare:types", ({ references }) => {
+			references.push({ path: resolve(nuxt.options.buildDir, "nuxt-files-sdk/storage-registry.d.ts") });
+		});
+		addServerImports({
+			name: "useServerFiles",
+			from: "nuxt-files-sdk/runtime"
+		});
+		for (const name of [
+			"useFiles",
+			"useFile",
+			"useList",
+			"useSearch"
+		]) addImports({
+			name,
+			from: "files-sdk/vue"
+		});
+		if (shouldEnableFilesDevtools(nuxt.options.dev, options.devtools, nuxt.options.devtools)) {
+			const version = await getNuxtModuleVersion("@nuxt/devtools", nuxt);
+			const { setupFilesDevtools } = await import("./devtools/index.js");
+			setupFilesDevtools(nuxt, version || "3");
+		}
+	}
+});
+//#endregion
+export { FilesRegistry, configureFiles, module_default as default, inspectFiles, useServerFiles };
+
+//# sourceMappingURL=module.js.map

package/dist/module.js.map

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

package/dist/nitro.d.ts

@@ -0,0 +1,15 @@
+import { NitroIntegration } from "./integration/nitro.js";
+import { DefaultStorage, DefaultStorageName, FilesForStorage, FilesRegistry, FilesRuntimeHooks, StorageRegistry } from "./runtime/registry.js";
+import { NuxtFilesDefaultStorage, NuxtFilesStorageRegistry, configureFiles, inspectFiles, useServerFiles } from "./runtime.js";
+//#region src/nitro.d.ts
+/**
+ * A structurally compatible Nitro v2/v3 module. Nitro loads this export
+ * directly from `modules: ['nuxt-files-sdk/nitro']`.
+ */
+declare const _default: {
+  name: string;
+  setup: (nitro: NitroIntegration) => Promise<void>;
+};
+//#endregion
+export { type DefaultStorage, type DefaultStorageName, type FilesForStorage, FilesRegistry, type FilesRuntimeHooks, NuxtFilesDefaultStorage, NuxtFilesStorageRegistry, type StorageRegistry, configureFiles, _default as default, inspectFiles, useServerFiles };
+//# sourceMappingURL=nitro.d.ts.map

package/dist/nitro.js

@@ -0,0 +1,20 @@
+import { setupNitroFilesIntegration } from "./integration/nitro.js";
+import { FilesRegistry } from "./runtime/registry.js";
+import { configureFiles, inspectFiles, useServerFiles } from "./runtime.js";
+import { resolve } from "node:path";
+//#region src/nitro.ts
+/**
+* A structurally compatible Nitro v2/v3 module. Nitro loads this export
+* directly from `modules: ['nuxt-files-sdk/nitro']`.
+*/
+var nitro_default = {
+	name: "nuxt-files-sdk",
+	setup: (nitro) => setupNitroFilesIntegration(nitro, {
+		configPath: resolve(nitro.options.rootDir, "files.config.ts"),
+		development: Boolean(nitro.options.dev)
+	})
+};
+//#endregion
+export { FilesRegistry, configureFiles, nitro_default as default, inspectFiles, useServerFiles };
+
+//# sourceMappingURL=nitro.js.map

package/dist/nitro.js.map

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

package/dist/package.js

@@ -0,0 +1,6 @@
+//#region package.json
+var version = "0.0.2";
+//#endregion
+export { version };
+
+//# sourceMappingURL=package.js.map

package/dist/package.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"package.js","names":[],"sources":["../package.json"],"sourcesContent":[""],"mappings":""}

package/dist/plugins.d.ts

@@ -0,0 +1,31 @@
+import { audit } from "files-sdk/audit";
+import { cache } from "files-sdk/cache";
+import { compression } from "files-sdk/compression";
+import { contentType, detectContentType } from "files-sdk/content-type";
+import { dedup } from "files-sdk/dedup";
+import { encryption, generateEncryptionKey } from "files-sdk/encryption";
+import { failover } from "files-sdk/failover";
+import { signedUrlPolicy } from "files-sdk/signed-url-policy";
+import { softDelete } from "files-sdk/soft-delete";
+import { tiering } from "files-sdk/tiering";
+import { tracing } from "files-sdk/tracing";
+import { usage } from "files-sdk/usage";
+import { ValidationError, validation } from "files-sdk/validation";
+import { versioning } from "files-sdk/versioning";
+import { zip } from "files-sdk/zip";
+export type * from "files-sdk/audit";
+export type * from "files-sdk/cache";
+export type * from "files-sdk/compression";
+export type * from "files-sdk/content-type";
+export type * from "files-sdk/dedup";
+export type * from "files-sdk/encryption";
+export type * from "files-sdk/failover";
+export type * from "files-sdk/signed-url-policy";
+export type * from "files-sdk/soft-delete";
+export type * from "files-sdk/tiering";
+export type * from "files-sdk/tracing";
+export type * from "files-sdk/usage";
+export type * from "files-sdk/validation";
+export type * from "files-sdk/versioning";
+export type * from "files-sdk/zip";
+export { ValidationError, audit, cache, compression, contentType, dedup, detectContentType, encryption, failover, generateEncryptionKey, signedUrlPolicy, softDelete, tiering, tracing, usage, validation, versioning, zip };

package/dist/plugins.js

@@ -0,0 +1,16 @@
+import { audit } from "files-sdk/audit";
+import { cache } from "files-sdk/cache";
+import { compression } from "files-sdk/compression";
+import { contentType, detectContentType } from "files-sdk/content-type";
+import { dedup } from "files-sdk/dedup";
+import { encryption, generateEncryptionKey } from "files-sdk/encryption";
+import { failover } from "files-sdk/failover";
+import { signedUrlPolicy } from "files-sdk/signed-url-policy";
+import { softDelete } from "files-sdk/soft-delete";
+import { tiering } from "files-sdk/tiering";
+import { tracing } from "files-sdk/tracing";
+import { usage } from "files-sdk/usage";
+import { ValidationError, validation } from "files-sdk/validation";
+import { versioning } from "files-sdk/versioning";
+import { zip } from "files-sdk/zip";
+export { ValidationError, audit, cache, compression, contentType, dedup, detectContentType, encryption, failover, generateEncryptionKey, signedUrlPolicy, softDelete, tiering, tracing, usage, validation, versioning, zip };

package/dist/runtime/registry.d.ts

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

package/dist/runtime/registry.js

@@ -0,0 +1,122 @@
+import { createFiles } from "files-sdk";
+import { loadFiles } from "files-sdk/loader";
+import { getProvider, listEnvVars } from "files-sdk/providers";
+//#region src/runtime/registry.ts
+const runHooks = async (...hooks) => {
+	for (const hook of hooks) try {
+		await hook();
+	} catch {}
+};
+/** Lazily initialize and memoize native Files clients for a validated project configuration. */
+var FilesRegistry = class {
+	#config;
+	#development;
+	#hooks;
+	#instances = /* @__PURE__ */ new Map();
+	/**
+	* Create a registry and validate storage references without initializing or connecting to a provider.
+	*/
+	constructor(config, options = {}) {
+		if (!config.storage || Object.keys(config.storage).length === 0) throw new Error("[nuxt-files-sdk:invalid-config] At least one storage is required.");
+		for (const name of [config.default, ...Object.keys(config.devStorage ?? {})]) if (name !== void 0 && !Object.hasOwn(config.storage, name)) throw new Error(`[nuxt-files-sdk:unknown-storage] Unknown storage "${name}".`);
+		this.#config = config;
+		this.#development = options.development ?? false;
+		this.#hooks = options.hooks ?? {};
+	}
+	get(name) {
+		const resolvedName = name ?? this.#defaultName();
+		if (!Object.hasOwn(this.#config.storage, resolvedName)) throw new Error(`[nuxt-files-sdk:unknown-storage] Unknown storage "${resolvedName}".`);
+		let instance = this.#instances.get(resolvedName);
+		if (!instance) {
+			instance = this.#create(resolvedName);
+			this.#instances.set(resolvedName, instance);
+			instance.catch(() => this.#instances.delete(resolvedName));
+		}
+		return instance;
+	}
+	/** Return secret-free storage metadata and initialization state for development diagnostics. */
+	inspect() {
+		return {
+			storages: Object.entries(this.#config.storage).map(([name, storage]) => {
+				const override = this.#development ? this.#config.devStorage?.[name] : void 0;
+				return {
+					name,
+					adapter: override?.adapter ?? storage.adapter,
+					plugins: storage.plugins?.map((plugin) => plugin.name) ?? [],
+					source: override ? "devStorage" : "storage",
+					initialized: this.#instances.has(name)
+				};
+			}),
+			diagnostics: []
+		};
+	}
+	#defaultName() {
+		if (this.#config.default !== void 0) return this.#config.default;
+		const names = Object.keys(this.#config.storage);
+		if (names.length === 1 && names[0]) return names[0];
+		if (Object.hasOwn(this.#config.storage, "default")) return "default";
+		throw new Error("[nuxt-files-sdk:storage-name-required] A storage name is required.");
+	}
+	async #create(name) {
+		const base = this.#config.storage[name];
+		const override = this.#development ? this.#config.devStorage?.[name] : void 0;
+		const selected = override ? {
+			...base,
+			...override,
+			plugins: base?.plugins,
+			hooks: base?.hooks
+		} : base;
+		if (!selected) throw new Error(`[nuxt-files-sdk:unknown-storage] Unknown storage "${name}".`);
+		const { adapter, plugins, hooks: userHooks, ...options } = selected;
+		const loaded = await withNuxtEnvironment(adapter, () => loadFiles({
+			...options,
+			provider: adapter
+		}));
+		if (!plugins && !userHooks && !Object.values(this.#hooks).some(Boolean)) return loaded.files;
+		return createFiles({
+			adapter: loaded.files.adapter,
+			hooks: {
+				onAction: (event) => runHooks(() => userHooks?.onAction?.(event), () => this.#hooks.onAction?.(event, name)),
+				onError: (event) => runHooks(() => userHooks?.onError?.(event), () => this.#hooks.onError?.(event, name)),
+				onRetry: (event) => runHooks(() => userHooks?.onRetry?.(event), () => this.#hooks.onRetry?.(event, name))
+			},
+			...plugins ? { plugins } : {},
+			...options.prefix === void 0 ? {} : { prefix: options.prefix },
+			...options.retries === void 0 ? {} : { retries: options.retries },
+			...options.timeout === void 0 ? {} : { timeout: options.timeout }
+		});
+	}
+};
+let environmentLock = Promise.resolve();
+/** Bridge only NUXT_ aliases declared by the configured native provider. */
+const withNuxtEnvironment = async (provider, load) => {
+	if (!getProvider(provider)) return load();
+	const variables = listEnvVars(provider);
+	if (variables.length === 0) return load();
+	const previous = environmentLock;
+	let release;
+	environmentLock = new Promise((resolveLock) => release = resolveLock);
+	await previous;
+	const injected = [];
+	for (const variable of variables) {
+		const keys = [variable.key, ...variable.aliases ?? []];
+		if (keys.some((key) => process.env[key] !== void 0)) continue;
+		for (const key of keys) {
+			const value = process.env[`NUXT_${key}`];
+			if (value !== void 0 && process.env[key] === void 0) {
+				process.env[key] = value;
+				injected.push(key);
+			}
+		}
+	}
+	try {
+		return await load();
+	} finally {
+		for (const key of injected) delete process.env[key];
+		release();
+	}
+};
+//#endregion
+export { FilesRegistry, withNuxtEnvironment };
+
+//# sourceMappingURL=registry.js.map

package/dist/runtime/registry.js.map

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

package/dist/runtime.d.ts

@@ -0,0 +1,22 @@
+import { FilesConfig } from "./config.js";
+import { FilesDevtoolsSnapshot } from "./devtools/snapshot.js";
+import { DefaultStorage, DefaultStorageName, FilesForStorage, FilesRegistry, FilesRuntimeHooks, StorageRegistry } from "./runtime/registry.js";
+import { Files } from "files-sdk";
+//#region src/runtime.d.ts
+/** Project storage names and plugin-extended Files clients supplied by generated declarations. */
+export interface NuxtFilesStorageRegistry {}
+/** Project default Files client supplied by generated declarations. */
+export interface NuxtFilesDefaultStorage {}
+/** Configure the process-local Files registry used by {@link useServerFiles}. */
+export declare const configureFiles: <const C extends FilesConfig>(config: C, options?: ConstructorParameters<typeof FilesRegistry<C>>[1]) => FilesRegistry<C>;
+/** Return secret-free diagnostics for the configured process-local Files registry. */
+export declare const inspectFiles: () => FilesDevtoolsSnapshot;
+/** Return the project's default Files client, including its configured plugin extensions. */
+export declare function useServerFiles(): Promise<NuxtFilesDefaultStorage extends {
+  value: infer Default;
+} ? Default : Files>;
+/** Return a named project Files client, including that storage's configured plugin extensions. */
+export declare function useServerFiles<Name extends Extract<keyof NuxtFilesStorageRegistry, string>>(name: Name): Promise<NuxtFilesStorageRegistry[Name]>;
+//#endregion
+export { type DefaultStorage, type DefaultStorageName, type FilesForStorage, FilesRegistry, type FilesRuntimeHooks, type StorageRegistry };
+//# sourceMappingURL=runtime.d.ts.map

package/dist/runtime.js

@@ -0,0 +1,26 @@
+import { FilesRegistry } from "./runtime/registry.js";
+//#region src/runtime.ts
+let registry;
+/** Configure the process-local Files registry used by {@link useServerFiles}. */
+const configureFiles = (config, options) => {
+	const value = new FilesRegistry(config, options);
+	registry = value;
+	return value;
+};
+/** Return secret-free diagnostics for the configured process-local Files registry. */
+const inspectFiles = () => registry?.inspect() ?? {
+	storages: [],
+	diagnostics: [{
+		code: "NUXT_FILES_NOT_CONFIGURED",
+		level: "warning",
+		message: "The Files registry has not been configured."
+	}]
+};
+function useServerFiles(name) {
+	if (!registry) throw new Error("[nuxt-files-sdk:not-configured] The Files registry has not been configured.");
+	return name === void 0 ? registry.get() : registry.get(name);
+}
+//#endregion
+export { FilesRegistry, configureFiles, inspectFiles, useServerFiles };
+
+//# sourceMappingURL=runtime.js.map

package/dist/runtime.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime.js","names":[],"sources":["../src/runtime.ts"],"sourcesContent":["import type { Files } from 'files-sdk'\n\nimport type { FilesConfig } from './config'\nimport type { FilesDevtoolsSnapshot } from './devtools/snapshot'\nimport { FilesRegistry } from './runtime/registry'\n\nexport { FilesRegistry } from './runtime/registry'\nexport type {\n    DefaultStorage,\n    DefaultStorageName,\n    FilesForStorage,\n    FilesRuntimeHooks,\n    StorageRegistry,\n} from './runtime/registry'\n\n/** Project storage names and plugin-extended Files clients supplied by generated declarations. */\nexport interface NuxtFilesStorageRegistry {}\n/** Project default Files client supplied by generated declarations. */\nexport interface NuxtFilesDefaultStorage {}\n\nlet registry: FilesRegistry | undefined\n\n/** Configure the process-local Files registry used by {@link useServerFiles}. */\nexport const configureFiles = <const C extends FilesConfig>(\n    config: C,\n    options?: ConstructorParameters<typeof FilesRegistry<C>>[1],\n): FilesRegistry<C> => {\n    const value = new FilesRegistry(config, options)\n    registry = value\n    return value\n}\n\n/** Return secret-free diagnostics for the configured process-local Files registry. */\nexport const inspectFiles = (): FilesDevtoolsSnapshot =>\n    registry?.inspect() ?? {\n        storages: [],\n        diagnostics: [\n            {\n                code: 'NUXT_FILES_NOT_CONFIGURED',\n                level: 'warning',\n                message: 'The Files registry has not been configured.',\n            },\n        ],\n    }\n\n/** Return the project's default Files client, including its configured plugin extensions. */\nexport function useServerFiles(): Promise<NuxtFilesDefaultStorage extends { value: infer Default } ? Default : Files>\n/** Return a named project Files client, including that storage's configured plugin extensions. */\nexport function useServerFiles<Name extends Extract<keyof NuxtFilesStorageRegistry, string>>(\n    name: Name,\n): Promise<NuxtFilesStorageRegistry[Name]>\nexport function useServerFiles(name?: string): Promise<Files> {\n    if (!registry) {\n        throw new Error('[nuxt-files-sdk:not-configured] The Files registry has not been configured.')\n    }\n    return name === undefined ? registry.get() : registry.get(name)\n}\n"],"mappings":";;AAoBA,IAAI;;AAGJ,MAAa,kBACT,QACA,YACmB;CACnB,MAAM,QAAQ,IAAI,cAAc,QAAQ,OAAO;CAC/C,WAAW;CACX,OAAO;AACX;;AAGA,MAAa,qBACT,UAAU,QAAQ,KAAK;CACnB,UAAU,CAAC;CACX,aAAa,CACT;EACI,MAAM;EACN,OAAO;EACP,SAAS;CACb,CACJ;AACJ;AAQJ,SAAgB,eAAe,MAA+B;CAC1D,IAAI,CAAC,UACD,MAAM,IAAI,MAAM,6EAA6E;CAEjG,OAAO,SAAS,KAAA,IAAY,SAAS,IAAI,IAAI,SAAS,IAAI,IAAI;AAClE"}

package/package.json

@@ -1,15 +1,73 @@
 {
-  "name": "nuxt-files-sdk",
-  "version": "0.0.0",
-  "main": "index.js",
-  "description": "Native-first Files SDK integration for Nuxt and Nitro",
-  "publishConfig": {
-    "access": "public"
-  },
-  "license": "MIT",
-  "homepage": "https://github.com/liria24/nuxt-files-sdk#readme",
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/liria24/nuxt-files-sdk.git"
-  }
+    "name": "nuxt-files-sdk",
+    "version": "0.0.2",
+    "description": "Native-first Files SDK integration for Nuxt and Nitro",
+    "homepage": "https://github.com/liria24/nuxt-files-sdk#readme",
+    "license": "MIT",
+    "repository": {
+        "type": "git",
+        "url": "git+https://github.com/liria24/nuxt-files-sdk.git"
+    },
+    "files": [
+        "dist"
+    ],
+    "type": "module",
+    "sideEffects": false,
+    "main": "./dist/module.js",
+    "types": "./dist/module.d.ts",
+    "exports": {
+        ".": {
+            "types": "./dist/module.d.ts",
+            "import": "./dist/module.js"
+        },
+        "./config": {
+            "types": "./dist/config.d.ts",
+            "import": "./dist/config.js"
+        },
+        "./nitro": {
+            "types": "./dist/nitro.d.ts",
+            "import": "./dist/nitro.js"
+        },
+        "./plugins": {
+            "types": "./dist/plugins.d.ts",
+            "import": "./dist/plugins.js"
+        },
+        "./runtime": {
+            "types": "./dist/runtime.d.ts",
+            "import": "./dist/runtime.js"
+        },
+        "./package.json": "./package.json"
+    },
+    "publishConfig": {
+        "access": "public",
+        "provenance": true
+    },
+    "scripts": {
+        "build": "tsdown",
+        "dev": "tsdown --watch",
+        "prepack": "bun run build",
+        "typecheck": "tsc --noEmit"
+    },
+    "dependencies": {
+        "@nuxt/kit": "^4.5.2",
+        "devframe": "^0.9.12",
+        "files-sdk": "^2.4.0"
+    },
+    "devDependencies": {
+        "@arethetypeswrong/cli": "^0.18.5",
+        "@nuxt/schema": "^4.5.2",
+        "@types/node": "^26.5.0",
+        "publint": "^0.3.24",
+        "tsdown": "^0.23.0",
+        "typescript": "^7.0.2",
+        "vue": "^3.5.42"
+    },
+    "peerDependencies": {
+        "nuxt": "^4.0.0 || ^5.0.0"
+    },
+    "peerDependenciesMeta": {
+        "nuxt": {
+            "optional": true
+        }
+    }
 }

package/index.js

@@ -1 +0,0 @@
-module.exports = {};