@analogjs/vite-plugin-nitro 3.0.0-alpha.9 → 3.0.0-alpha.91

package/src/lib/options.d.ts

@@ -1,129 +1,163 @@
-import type { PrerenderRoute } from 'nitro/types';
-import type { UserConfig } from 'vite';
+import type { PrerenderRoute } from "nitro/types";
+import type { UserConfig } from "vite";
+export interface I18nPrerenderOptions {
+	/**
+	* The default/source locale for the application.
+	*/
+	defaultLocale: string;
+	/**
+	* List of supported locale identifiers.
+	* Each route will be prerendered once per locale with a locale prefix.
+	*/
+	locales: string[];
+}
 export interface Options {
-    ssr?: boolean;
-    ssrBuildDir?: string;
-    /**
-     * Prerender the static pages without producing the server output.
-     */
-    static?: boolean;
-    prerender?: PrerenderOptions;
-    entryServer?: string;
-    index?: string;
-    /**
-     * Relative path to source files. Default is 'src'.
-     */
-    sourceRoot?: string;
-    /**
-     * Absolute path to workspace root. Default is 'process.cwd()'
-     */
-    workspaceRoot?: string;
-    /**
-     * Additional page paths to include
-     */
-    additionalPagesDirs?: string[];
-    /**
-     * Additional API paths to include
-     */
-    additionalAPIDirs?: string[];
-    apiPrefix?: string;
-    /**
-     * Toggles internal API middleware.
-     * If disabled, a proxy request is used to route /api
-     * requests to / in the production server build.
-     *
-     * @deprecated
-     * Use the src/server/routes/api folder
-     * for API routes.
-     */
-    useAPIMiddleware?: boolean;
-    /**
-     * Vite-native build passthrough. Rolldown-only options such as
-     * `build.rolldownOptions.output.codeSplitting` are forwarded when present.
-     */
-    vite?: {
-        build?: UserConfig['build'];
-    };
+	ssr?: boolean;
+	ssrBuildDir?: string;
+	/**
+	* Prerender the static pages without producing the server output.
+	*/
+	static?: boolean;
+	prerender?: PrerenderOptions;
+	entryServer?: string;
+	index?: string;
+	/**
+	* Relative path to source files. Default is 'src'.
+	*/
+	sourceRoot?: string;
+	/**
+	* Absolute path to workspace root. Default is 'process.cwd()'
+	*/
+	workspaceRoot?: string;
+	/**
+	* Additional page paths to include
+	*/
+	additionalPagesDirs?: string[];
+	/**
+	* Additional API paths to include
+	*/
+	additionalAPIDirs?: string[];
+	/**
+	* Additional directories to scan for `*.server.ts` server-function modules,
+	* beyond `<sourceRoot>`. Paths are relative to the workspace root.
+	*/
+	additionalServerFnDirs?: string[];
+	apiPrefix?: string;
+	/**
+	* Vite-native build passthrough. Rolldown-only options such as
+	* `build.rolldownOptions.output.codeSplitting` are forwarded when present.
+	*/
+	vite?: {
+		build?: UserConfig["build"];
+	};
 }
 export interface PrerenderOptions {
-    /**
-     * Add additional routes to prerender through crawling page links.
-     */
-    discover?: boolean;
-    /**
-     * List of routes to prerender resolved statically or dynamically.
-     */
-    routes?: (string | PrerenderContentDir | PrerenderRouteConfig)[] | (() => Promise<(string | PrerenderContentDir | PrerenderRouteConfig | undefined)[]>);
-    sitemap?: SitemapConfig;
-    /** List of functions that run for each route after pre-rendering is complete. */
-    postRenderingHooks?: ((routes: PrerenderRoute) => Promise<void>)[];
+	/**
+	* Add additional routes to prerender through crawling page links.
+	*/
+	discover?: boolean;
+	/**
+	* List of routes to prerender resolved statically or dynamically.
+	*/
+	routes?: (string | PrerenderContentDir | PrerenderRouteConfig)[] | (() => Promise<(string | PrerenderContentDir | PrerenderRouteConfig | undefined)[]>);
+	sitemap?: SitemapConfig;
+	/** List of functions that run for each route after pre-rendering is complete. */
+	postRenderingHooks?: ((routes: PrerenderRoute) => Promise<void>)[];
+}
+export type SitemapPriority = number | `${number}`;
+export interface SitemapRouteDefinition {
+	route: string;
+	lastmod?: string;
+	changefreq?: "always" | "hourly" | "daily" | "weekly" | "monthly" | "yearly" | "never";
+	priority?: SitemapPriority;
+}
+export interface SitemapEntry extends SitemapRouteDefinition {
+	loc: string;
 }
+export type SitemapRouteInput = string | SitemapRouteDefinition | undefined;
+export type SitemapRouteSource = SitemapRouteInput[] | (() => Promise<SitemapRouteInput[]>);
+export type SitemapExcludeRule = string | RegExp | ((entry: SitemapEntry) => boolean | Promise<boolean>);
+export type SitemapTransform = (entry: SitemapEntry) => SitemapRouteDefinition | false | Promise<SitemapRouteDefinition | false>;
 export interface SitemapConfig {
-    host: string;
+	host: string;
+	include?: SitemapRouteSource;
+	exclude?: SitemapExcludeRule[];
+	defaults?: PrerenderSitemapConfig;
+	transform?: SitemapTransform;
 }
 export interface PrerenderContentDir {
-    /**
-     * The directory where files should be grabbed from.
-     * @example `/src/contents/blog`
-     */
-    contentDir: string;
-    /**
-     * Transform the matching content files path into a route.
-     * The function is called for each matching content file within the specified contentDir.
-     * @param file information of the matching file (`path`, `name`, `extension`, `attributes`, `content`)
-     * @returns a string with the route should be returned (e. g. `/blog/<slug>`) or the value `false`, when the route should not be prerendered.
-     */
-    transform: (file: PrerenderContentFile) => string | false;
-    /**
-     * Customize the sitemap definition for the prerendered route
-     *
-     * https://www.sitemaps.org/protocol.html#xmlTagDefinitions
-     */
-    sitemap?: PrerenderSitemapConfig | ((file: PrerenderContentFile) => PrerenderSitemapConfig);
-    /**
-     * Output the source markdown content alongside the prerendered route.
-     * The source file will be accessible at the route path with a .md extension.
-     * @param file information of the matching file including its content
-     * @returns the markdown content string to output, or `false` to skip outputting for this file
-     */
-    outputSourceFile?: (file: PrerenderContentFile) => string | false;
+	/**
+	* The directory where files should be grabbed from.
+	* @example `/src/contents/blog`
+	*/
+	contentDir: string;
+	/**
+	* Transform the matching content files path into a route.
+	* The function is called for each matching content file within the specified contentDir.
+	* @param file information of the matching file (`path`, `name`, `extension`, `attributes`, `content`)
+	* @returns a string with the route should be returned (e. g. `/blog/<slug>`) or the value `false`, when the route should not be prerendered.
+	*/
+	transform: (file: PrerenderContentFile) => string | false;
+	/**
+	* Customize the sitemap definition for the prerendered route
+	*
+	* https://www.sitemaps.org/protocol.html#xmlTagDefinitions
+	*/
+	sitemap?: PrerenderSitemapConfig | ((file: PrerenderContentFile) => PrerenderSitemapConfig);
+	/**
+	* Output the source markdown content alongside the prerendered route.
+	* The source file will be accessible at the route path with a .md extension.
+	* @param file information of the matching file including its content
+	* @returns the markdown content string to output, or `false` to skip outputting for this file
+	*/
+	outputSourceFile?: (file: PrerenderContentFile) => string | false;
+	/**
+	* Recurse into subdirectories of `contentDir` when discovering files.
+	* When enabled, the matching file's directory relative to `contentDir`
+	* is exposed via `PrerenderContentFile.relativePath` so transforms can
+	* disambiguate identically-named files across subdirectories.
+	* @default false
+	*/
+	recursive?: boolean;
 }
 /**
- * @param path the path to the content file
- * @param name the basename of the matching content file without the file extension
- * @param extension the file extension
- * @param attributes the frontmatter attributes extracted from the frontmatter section of the file
- * @param content the raw file content including frontmatter
- * @returns a string with the route should be returned (e. g. `/blog/<slug>`) or the value `false`, when the route should not be prerendered.
- */
+* @param path the path to the content file
+* @param name the basename of the matching content file without the file extension
+* @param extension the file extension
+* @param attributes the frontmatter attributes extracted from the frontmatter section of the file
+* @param content the raw file content including frontmatter
+* @param relativePath when `recursive` is enabled, the directory of the file relative to `contentDir` (empty string for files at the top level)
+* @returns a string with the route should be returned (e. g. `/blog/<slug>`) or the value `false`, when the route should not be prerendered.
+*/
 export interface PrerenderContentFile {
-    path: string;
-    attributes: Record<string, any>;
-    name: string;
-    extension: string;
-    content: string;
+	path: string;
+	attributes: Record<string, any>;
+	name: string;
+	extension: string;
+	content: string;
+	relativePath?: string;
 }
 export interface PrerenderSitemapConfig {
-    lastmod?: string;
-    changefreq?: 'always' | 'hourly' | 'daily' | 'weekly' | 'monthly' | 'yearly' | 'never';
-    priority?: string;
+	lastmod?: string;
+	changefreq?: "always" | "hourly" | "daily" | "weekly" | "monthly" | "yearly" | "never";
+	priority?: SitemapPriority;
 }
 export interface PrerenderRouteConfig {
-    route: string;
-    /**
-     * Customize the sitemap definition for the prerendered route
-     *
-     * https://www.sitemaps.org/protocol.html#xmlTagDefinitions
-     */
-    sitemap?: PrerenderSitemapConfig | (() => PrerenderSitemapConfig);
-    /**
-     * Prerender static data for the prerendered route
-     */
-    staticData?: boolean;
-    /**
-     * Path to the source markdown file to output alongside the prerendered route.
-     * The source file will be accessible at the route path with a .md extension.
-     * @example 'src/content/overview.md'
-     */
-    outputSourceFile?: string;
+	route: string;
+	/**
+	* Customize the sitemap definition for the prerendered route
+	*
+	* https://www.sitemaps.org/protocol.html#xmlTagDefinitions
+	*/
+	sitemap?: PrerenderSitemapConfig | (() => PrerenderSitemapConfig);
+	/**
+	* Prerender static data for the prerendered route
+	*/
+	staticData?: boolean;
+	/**
+	* Path to the source markdown file to output alongside the prerendered route.
+	* The source file will be accessible at the route path with a .md extension.
+	* @example 'src/content/overview.md'
+	*/
+	outputSourceFile?: string;
 }

package/src/lib/plugins/dev-server-plugin.d.ts

@@ -1,7 +1,7 @@
-import { Plugin } from 'vite';
-import { Options } from '../options.js';
+import { Plugin } from "vite";
+import { Options } from "../options.js";
 type ServerOptions = Options & {
-    routeRules?: Record<string, any> | undefined;
+	routeRules?: Record<string, any> | undefined;
 };
 export declare function devServerPlugin(options: ServerOptions): Plugin;
 export {};

package/src/lib/plugins/dev-server-plugin.js

@@ -1,5 +1,7 @@
 import { writeWebResponseToNode } from "../utils/node-web-bridge.js";
 import { registerDevServerMiddleware } from "../utils/register-dev-middleware.js";
+import { registerI18nWatcher } from "../utils/register-i18n-watcher.js";
+import { detectLocaleFromRoute, setHtmlLang } from "../utils/i18n-prerender.js";
 import { normalizePath } from "vite";
 import { resolve } from "node:path";
 import { readFileSync } from "node:fs";
@@ -29,6 +31,7 @@ function devServerPlugin(options) {
 			return async () => {
 				remove_html_middlewares(viteServer.middlewares);
 				registerDevServerMiddleware(root, sourceRoot, viteServer);
+				if (options.i18n) registerI18nWatcher(viteServer);
 				viteServer.middlewares.use(async (req, res) => {
 					let template = readFileSync(resolve(viteServer.config.root, index), "utf-8");
 					template = await viteServer.transformIndexHtml(req.originalUrl, template);
@@ -48,8 +51,13 @@ function devServerPlugin(options) {
 							await writeWebResponseToNode(res, result);
 							return;
 						}
+						let html = typeof result === "string" ? result : template;
+						if (options.i18n) {
+							const locale = detectLocaleFromRoute(req.originalUrl, options.i18n);
+							html = setHtmlLang(html, locale);
+						}
 						res.setHeader("Content-Type", "text/html");
-						res.end(result);
+						res.end(html);
 					} catch (e) {
 						viteServer.ssrFixStacktrace(e);
 						res.statusCode = 500;

package/src/lib/plugins/dev-server-plugin.js.map

@@ -1 +1 @@
-{"version":3,"file":"dev-server-plugin.js","names":[],"sources":["../../../../../../packages/vite-plugin-nitro/src/lib/plugins/dev-server-plugin.ts"],"sourcesContent":["// SSR dev server, middleware and error page source modified from\n// https://github.com/solidjs/solid-start/blob/main/packages/start/dev/server.js\n\nimport {\n  Connect,\n  Plugin,\n  UserConfig,\n  ViteDevServer,\n  normalizePath,\n} from 'vite';\nimport { resolve } from 'node:path';\nimport { readFileSync } from 'node:fs';\nimport { createRouter as createRadixRouter, toRouteMatcher } from 'radix3';\nimport { defu } from 'defu';\nimport type { NitroRouteRules } from 'nitro/types';\n\nimport { registerDevServerMiddleware } from '../utils/register-dev-middleware.js';\nimport { writeWebResponseToNode } from '../utils/node-web-bridge.js';\nimport { Options } from '../options.js';\n\ntype ServerOptions = Options & { routeRules?: Record<string, any> | undefined };\n\nexport function devServerPlugin(options: ServerOptions): Plugin {\n  const workspaceRoot = options?.workspaceRoot || process.cwd();\n  const sourceRoot = options?.sourceRoot ?? 'src';\n  const index = options.index || 'index.html';\n  let config: UserConfig;\n  let root: string;\n  let isTest = false;\n\n  return {\n    name: 'analogjs-dev-ssr-plugin',\n    config(userConfig, { mode }) {\n      config = userConfig;\n      root = normalizePath(resolve(workspaceRoot, config.root || '.') || '.');\n      isTest = isTest ? isTest : mode === 'test';\n      return {\n        appType: 'custom',\n        resolve: {\n          alias: {\n            '~analog/entry-server':\n              options.entryServer || `${root}/${sourceRoot}/main.server.ts`,\n          },\n        },\n      };\n    },\n    configureServer(viteServer) {\n      if (isTest) {\n        return;\n      }\n\n      return async () => {\n        remove_html_middlewares(viteServer.middlewares);\n        registerDevServerMiddleware(root, sourceRoot, viteServer);\n\n        viteServer.middlewares.use(async (req, res) => {\n          let template = readFileSync(\n            resolve(viteServer.config.root, index),\n            'utf-8',\n          );\n\n          template = await viteServer.transformIndexHtml(\n            req.originalUrl as string,\n            template,\n          );\n\n          const _routeRulesMatcher = toRouteMatcher(\n            createRadixRouter({ routes: options.routeRules }),\n          );\n          const _getRouteRules = (path: string) =>\n            defu(\n              {},\n              ..._routeRulesMatcher.matchAll(path).reverse(),\n            ) as NitroRouteRules;\n\n          try {\n            let result: string | Response;\n            // Check for route rules explicitly disabling SSR\n            if (_getRouteRules(req.originalUrl as string).ssr === false) {\n              result = template;\n            } else {\n              const entryServer = (\n                await viteServer.ssrLoadModule('~analog/entry-server')\n              )['default'];\n              result = await entryServer(req.originalUrl, template, {\n                req,\n                res,\n              });\n            }\n\n            if (result instanceof Response) {\n              await writeWebResponseToNode(res, result);\n              return;\n            }\n            res.setHeader('Content-Type', 'text/html');\n            res.end(result);\n          } catch (e) {\n            viteServer.ssrFixStacktrace(e as Error);\n            res.statusCode = 500;\n            res.end(`\n              <!DOCTYPE html>\n              <html lang=\"en\">\n                <head>\n                  <meta charset=\"UTF-8\" />\n                  <title>Error</title>\n                  <script type=\"module\">\n                    import { ErrorOverlay } from '/@vite/client'\n                    document.body.appendChild(new ErrorOverlay(${JSON.stringify(\n                      prepareError(req, e),\n                    ).replace(/</g, '\\\\u003c')}))\n                  </script>\n                </head>\n                <body>\n                </body>\n              </html>\n            `);\n          }\n        });\n      };\n    },\n  };\n}\n\n/**\n * Removes Vite internal middleware\n *\n * @param server\n */\nfunction remove_html_middlewares(server: ViteDevServer['middlewares']) {\n  const html_middlewares = [\n    'viteIndexHtmlMiddleware',\n    'vite404Middleware',\n    'viteSpaFallbackMiddleware',\n    'viteHtmlFallbackMiddleware',\n  ];\n  for (let i = server.stack.length - 1; i > 0; i--) {\n    const handler = server.stack[i]?.handle;\n    const handlerName =\n      typeof handler === 'function' ? handler.name : undefined;\n    if (handlerName && html_middlewares.includes(handlerName)) {\n      server.stack.splice(i, 1);\n    }\n  }\n}\n\n/**\n * Formats error for SSR message in error overlay\n * @param req\n * @param error\n * @returns\n */\nfunction prepareError(req: Connect.IncomingMessage, error: unknown) {\n  const e = error as Error;\n  return {\n    message: `An error occured while server rendering ${req.url}:\\n\\n\\t${\n      typeof e === 'string' ? e : e.message\n    } `,\n    stack: typeof e === 'string' ? '' : e.stack,\n  };\n}\n"],"mappings":";;;;;;;;AAsBA,SAAgB,gBAAgB,SAAgC;CAC9D,MAAM,gBAAgB,SAAS,iBAAiB,QAAQ,KAAK;CAC7D,MAAM,aAAa,SAAS,cAAc;CAC1C,MAAM,QAAQ,QAAQ,SAAS;CAC/B,IAAI;CACJ,IAAI;CACJ,IAAI,SAAS;AAEb,QAAO;EACL,MAAM;EACN,OAAO,YAAY,EAAE,QAAQ;AAC3B,YAAS;AACT,UAAO,cAAc,QAAQ,eAAe,OAAO,QAAQ,IAAI,IAAI,IAAI;AACvE,YAAS,SAAS,SAAS,SAAS;AACpC,UAAO;IACL,SAAS;IACT,SAAS,EACP,OAAO,EACL,wBACE,QAAQ,eAAe,GAAG,KAAK,GAAG,WAAW,kBAChD,EACF;IACF;;EAEH,gBAAgB,YAAY;AAC1B,OAAI,OACF;AAGF,UAAO,YAAY;AACjB,4BAAwB,WAAW,YAAY;AAC/C,gCAA4B,MAAM,YAAY,WAAW;AAEzD,eAAW,YAAY,IAAI,OAAO,KAAK,QAAQ;KAC7C,IAAI,WAAW,aACb,QAAQ,WAAW,OAAO,MAAM,MAAM,EACtC,QACD;AAED,gBAAW,MAAM,WAAW,mBAC1B,IAAI,aACJ,SACD;KAED,MAAM,qBAAqB,eACzB,aAAkB,EAAE,QAAQ,QAAQ,YAAY,CAAC,CAClD;KACD,MAAM,kBAAkB,SACtB,KACE,EAAE,EACF,GAAG,mBAAmB,SAAS,KAAK,CAAC,SAAS,CAC/C;AAEH,SAAI;MACF,IAAI;AAEJ,UAAI,eAAe,IAAI,YAAsB,CAAC,QAAQ,MACpD,UAAS;WACJ;OACL,MAAM,eACJ,MAAM,WAAW,cAAc,uBAAuB,EACtD;AACF,gBAAS,MAAM,YAAY,IAAI,aAAa,UAAU;QACpD;QACA;QACD,CAAC;;AAGJ,UAAI,kBAAkB,UAAU;AAC9B,aAAM,uBAAuB,KAAK,OAAO;AACzC;;AAEF,UAAI,UAAU,gBAAgB,YAAY;AAC1C,UAAI,IAAI,OAAO;cACR,GAAG;AACV,iBAAW,iBAAiB,EAAW;AACvC,UAAI,aAAa;AACjB,UAAI,IAAI;;;;;;;;iEAQ6C,KAAK,UAChD,aAAa,KAAK,EAAE,CACrB,CAAC,QAAQ,MAAM,UAAU,CAAC;;;;;;cAMjC;;MAEJ;;;EAGP;;;;;;;AAQH,SAAS,wBAAwB,QAAsC;CACrE,MAAM,mBAAmB;EACvB;EACA;EACA;EACA;EACD;AACD,MAAK,IAAI,IAAI,OAAO,MAAM,SAAS,GAAG,IAAI,GAAG,KAAK;EAChD,MAAM,UAAU,OAAO,MAAM,IAAI;EACjC,MAAM,cACJ,OAAO,YAAY,aAAa,QAAQ,OAAO,KAAA;AACjD,MAAI,eAAe,iBAAiB,SAAS,YAAY,CACvD,QAAO,MAAM,OAAO,GAAG,EAAE;;;;;;;;;AAW/B,SAAS,aAAa,KAA8B,OAAgB;CAClE,MAAM,IAAI;AACV,QAAO;EACL,SAAS,2CAA2C,IAAI,IAAI,SAC1D,OAAO,MAAM,WAAW,IAAI,EAAE,QAC/B;EACD,OAAO,OAAO,MAAM,WAAW,KAAK,EAAE;EACvC"}
+{"version":3,"file":"dev-server-plugin.js","names":[],"sources":["../../../../src/lib/plugins/dev-server-plugin.ts"],"sourcesContent":["// SSR dev server, middleware and error page source modified from\n// https://github.com/solidjs/solid-start/blob/main/packages/start/dev/server.js\n\nimport {\n  Connect,\n  Plugin,\n  UserConfig,\n  ViteDevServer,\n  normalizePath,\n} from 'vite';\nimport { resolve } from 'node:path';\nimport { readFileSync } from 'node:fs';\nimport { createRouter as createRadixRouter, toRouteMatcher } from 'radix3';\nimport { defu } from 'defu';\nimport type { NitroRouteRules } from 'nitro/types';\n\nimport { registerDevServerMiddleware } from '../utils/register-dev-middleware.js';\nimport { registerI18nWatcher } from '../utils/register-i18n-watcher.js';\nimport { writeWebResponseToNode } from '../utils/node-web-bridge.js';\nimport { Options } from '../options.js';\nimport { detectLocaleFromRoute, setHtmlLang } from '../utils/i18n-prerender.js';\n\ntype ServerOptions = Options & { routeRules?: Record<string, any> | undefined };\n\nexport function devServerPlugin(options: ServerOptions): Plugin {\n  const workspaceRoot = options?.workspaceRoot || process.cwd();\n  const sourceRoot = options?.sourceRoot ?? 'src';\n  const index = options.index || 'index.html';\n  let config: UserConfig;\n  let root: string;\n  let isTest = false;\n\n  return {\n    name: 'analogjs-dev-ssr-plugin',\n    config(userConfig, { mode }) {\n      config = userConfig;\n      root = normalizePath(resolve(workspaceRoot, config.root || '.') || '.');\n      isTest = isTest ? isTest : mode === 'test';\n      return {\n        appType: 'custom',\n        resolve: {\n          alias: {\n            '~analog/entry-server':\n              options.entryServer || `${root}/${sourceRoot}/main.server.ts`,\n          },\n        },\n      };\n    },\n    configureServer(viteServer) {\n      if (isTest) {\n        return;\n      }\n\n      return async () => {\n        remove_html_middlewares(viteServer.middlewares);\n        registerDevServerMiddleware(root, sourceRoot, viteServer);\n\n        if (options.i18n) {\n          registerI18nWatcher(viteServer);\n        }\n\n        viteServer.middlewares.use(async (req, res) => {\n          let template = readFileSync(\n            resolve(viteServer.config.root, index),\n            'utf-8',\n          );\n\n          template = await viteServer.transformIndexHtml(\n            req.originalUrl as string,\n            template,\n          );\n\n          const _routeRulesMatcher = toRouteMatcher(\n            createRadixRouter({ routes: options.routeRules }),\n          );\n          const _getRouteRules = (path: string) =>\n            defu(\n              {},\n              ..._routeRulesMatcher.matchAll(path).reverse(),\n            ) as NitroRouteRules;\n\n          try {\n            let result: string | Response;\n            // Check for route rules explicitly disabling SSR\n            if (_getRouteRules(req.originalUrl as string).ssr === false) {\n              result = template;\n            } else {\n              const entryServer = (\n                await viteServer.ssrLoadModule('~analog/entry-server')\n              )['default'];\n              result = await entryServer(req.originalUrl, template, {\n                req,\n                res,\n              });\n            }\n\n            if (result instanceof Response) {\n              await writeWebResponseToNode(res, result);\n              return;\n            }\n\n            // Inject lang attribute when i18n is configured\n            let html = typeof result === 'string' ? result : template;\n            if (options.i18n) {\n              const locale = detectLocaleFromRoute(\n                req.originalUrl as string,\n                options.i18n,\n              );\n              html = setHtmlLang(html, locale);\n            }\n\n            res.setHeader('Content-Type', 'text/html');\n            res.end(html);\n          } catch (e) {\n            viteServer.ssrFixStacktrace(e as Error);\n            res.statusCode = 500;\n            res.end(`\n              <!DOCTYPE html>\n              <html lang=\"en\">\n                <head>\n                  <meta charset=\"UTF-8\" />\n                  <title>Error</title>\n                  <script type=\"module\">\n                    import { ErrorOverlay } from '/@vite/client'\n                    document.body.appendChild(new ErrorOverlay(${JSON.stringify(\n                      prepareError(req, e),\n                    ).replace(/</g, '\\\\u003c')}))\n                  </script>\n                </head>\n                <body>\n                </body>\n              </html>\n            `);\n          }\n        });\n      };\n    },\n  };\n}\n\n/**\n * Removes Vite internal middleware\n *\n * @param server\n */\nfunction remove_html_middlewares(server: ViteDevServer['middlewares']) {\n  const html_middlewares = [\n    'viteIndexHtmlMiddleware',\n    'vite404Middleware',\n    'viteSpaFallbackMiddleware',\n    'viteHtmlFallbackMiddleware',\n  ];\n  for (let i = server.stack.length - 1; i > 0; i--) {\n    const handler = server.stack[i]?.handle;\n    const handlerName =\n      typeof handler === 'function' ? handler.name : undefined;\n    if (handlerName && html_middlewares.includes(handlerName)) {\n      server.stack.splice(i, 1);\n    }\n  }\n}\n\n/**\n * Formats error for SSR message in error overlay\n * @param req\n * @param error\n * @returns\n */\nfunction prepareError(req: Connect.IncomingMessage, error: unknown) {\n  const e = error as Error;\n  return {\n    message: `An error occured while server rendering ${req.url}:\\n\\n\\t${\n      typeof e === 'string' ? e : e.message\n    } `,\n    stack: typeof e === 'string' ? '' : e.stack,\n  };\n}\n"],"mappings":";;;;;;;;;;AAwBA,SAAgB,gBAAgB,SAAgC;CAC9D,MAAM,gBAAgB,SAAS,iBAAiB,QAAQ,KAAK;CAC7D,MAAM,aAAa,SAAS,cAAc;CAC1C,MAAM,QAAQ,QAAQ,SAAS;CAC/B,IAAI;CACJ,IAAI;CACJ,IAAI,SAAS;AAEb,QAAO;EACL,MAAM;EACN,OAAO,YAAY,EAAE,QAAQ;AAC3B,YAAS;AACT,UAAO,cAAc,QAAQ,eAAe,OAAO,QAAQ,IAAI,IAAI,IAAI;AACvE,YAAS,SAAS,SAAS,SAAS;AACpC,UAAO;IACL,SAAS;IACT,SAAS,EACP,OAAO,EACL,wBACE,QAAQ,eAAe,GAAG,KAAK,GAAG,WAAW,kBAChD,EACF;IACF;;EAEH,gBAAgB,YAAY;AAC1B,OAAI,OACF;AAGF,UAAO,YAAY;AACjB,4BAAwB,WAAW,YAAY;AAC/C,gCAA4B,MAAM,YAAY,WAAW;AAEzD,QAAI,QAAQ,KACV,qBAAoB,WAAW;AAGjC,eAAW,YAAY,IAAI,OAAO,KAAK,QAAQ;KAC7C,IAAI,WAAW,aACb,QAAQ,WAAW,OAAO,MAAM,MAAM,EACtC,QACD;AAED,gBAAW,MAAM,WAAW,mBAC1B,IAAI,aACJ,SACD;KAED,MAAM,qBAAqB,eACzB,aAAkB,EAAE,QAAQ,QAAQ,YAAY,CAAC,CAClD;KACD,MAAM,kBAAkB,SACtB,KACE,EAAE,EACF,GAAG,mBAAmB,SAAS,KAAK,CAAC,SAAS,CAC/C;AAEH,SAAI;MACF,IAAI;AAEJ,UAAI,eAAe,IAAI,YAAsB,CAAC,QAAQ,MACpD,UAAS;WACJ;OACL,MAAM,eACJ,MAAM,WAAW,cAAc,uBAAuB,EACtD;AACF,gBAAS,MAAM,YAAY,IAAI,aAAa,UAAU;QACpD;QACA;QACD,CAAC;;AAGJ,UAAI,kBAAkB,UAAU;AAC9B,aAAM,uBAAuB,KAAK,OAAO;AACzC;;MAIF,IAAI,OAAO,OAAO,WAAW,WAAW,SAAS;AACjD,UAAI,QAAQ,MAAM;OAChB,MAAM,SAAS,sBACb,IAAI,aACJ,QAAQ,KACT;AACD,cAAO,YAAY,MAAM,OAAO;;AAGlC,UAAI,UAAU,gBAAgB,YAAY;AAC1C,UAAI,IAAI,KAAK;cACN,GAAG;AACV,iBAAW,iBAAiB,EAAW;AACvC,UAAI,aAAa;AACjB,UAAI,IAAI;;;;;;;;iEAQ6C,KAAK,UAChD,aAAa,KAAK,EAAE,CACrB,CAAC,QAAQ,MAAM,UAAU,CAAC;;;;;;cAMjC;;MAEJ;;;EAGP;;;;;;;AAQH,SAAS,wBAAwB,QAAsC;CACrE,MAAM,mBAAmB;EACvB;EACA;EACA;EACA;EACD;AACD,MAAK,IAAI,IAAI,OAAO,MAAM,SAAS,GAAG,IAAI,GAAG,KAAK;EAChD,MAAM,UAAU,OAAO,MAAM,IAAI;EACjC,MAAM,cACJ,OAAO,YAAY,aAAa,QAAQ,OAAO,KAAA;AACjD,MAAI,eAAe,iBAAiB,SAAS,YAAY,CACvD,QAAO,MAAM,OAAO,GAAG,EAAE;;;;;;;;;AAW/B,SAAS,aAAa,KAA8B,OAAgB;CAClE,MAAM,IAAI;AACV,QAAO;EACL,SAAS,2CAA2C,IAAI,IAAI,SAC1D,OAAO,MAAM,WAAW,IAAI,EAAE,QAC/B;EACD,OAAO,OAAO,MAAM,WAAW,KAAK,EAAE;EACvC"}

package/src/lib/plugins/page-endpoints.d.ts

@@ -1,7 +1,7 @@
 export declare function pageEndpointsPlugin(): {
-    name: string;
-    transform(_code: string, id: string): Promise<{
-        code: string;
-        map: null;
-    } | undefined>;
+	name: string;
+	transform(_code: string, id: string): Promise<{
+		code: string;
+		map: null;
+	} | undefined>;
 };

package/src/lib/plugins/page-endpoints.js.map

@@ -1 +1 @@
-{"version":3,"file":"page-endpoints.js","names":[],"sources":["../../../../../../packages/vite-plugin-nitro/src/lib/plugins/page-endpoints.ts"],"sourcesContent":["import { parseSync } from 'oxc-parser';\nimport { normalizePath } from 'vite';\nimport { SERVER_FETCH_FACTORY_SNIPPET } from '../utils/renderers.js';\n\nexport function pageEndpointsPlugin() {\n  return {\n    name: 'analogjs-vite-plugin-nitro-rollup-page-endpoint',\n    async transform(\n      _code: string,\n      id: string,\n    ): Promise<{ code: string; map: null } | undefined> {\n      if (normalizePath(id).includes('/pages/') && id.endsWith('.server.ts')) {\n        const result = parseSync(id, _code, {\n          sourceType: 'module',\n          lang: 'ts',\n        });\n\n        const fileExports: string[] = result.module.staticExports.flatMap((e) =>\n          e.entries\n            .filter((entry) => entry.exportName.name !== null)\n            .map((entry) => entry.exportName.name as string),\n        );\n\n        // In h3 v2 / Nitro v3, event.node is undefined during prerendering\n        // (which uses the fetch-based pipeline, not Node.js http). We use\n        // optional chaining so that page endpoints work in both Node.js\n        // server and fetch-based prerender contexts.\n        // Nitro v3 no longer guarantees the private `nitro/deps/ofetch`\n        // subpath that older codegen relied on.\n        //\n        // Page loaders expect Nitro-style `$fetch` semantics (parsed data plus\n        // internal relative-route support), so construct a request-local fetch\n        // using public APIs:\n        // - `createFetch` from `ofetch` for `$fetch` behavior\n        // - `fetchWithEvent` from `h3` for internal Nitro request routing\n        //\n        // This avoids both unstable private Nitro imports and assumptions about\n        // a global runtime `$fetch` being available during prerender.\n        const code = `\n            import { defineHandler, fetchWithEvent } from 'nitro/h3';\n            import { createFetch } from 'ofetch';\n\n            ${\n              fileExports.includes('load')\n                ? _code\n                : `\n                ${_code}\n                export const load = () => {\n                  return {};\n                }`\n            }\n\n            ${\n              fileExports.includes('action')\n                ? ''\n                : `\n                export const action = () => {\n                  return {};\n                }\n              `\n            }\n\n            export default defineHandler(async(event) => {\n              ${SERVER_FETCH_FACTORY_SNIPPET}\n\n              if (event.method === 'GET') {\n                try {\n                  return await load({\n                    params: event.context.params,\n                    req: event.node?.req,\n                    res: event.node?.res,\n                    fetch: serverFetch,\n                    event\n                  });\n                } catch(e) {\n                  console.error(\\` An error occurred: \\${e}\\`)\n                  throw e;\n                }\n              } else {\n                try {\n                  return await action({\n                    params: event.context.params,\n                    req: event.node?.req,\n                    res: event.node?.res,\n                    fetch: serverFetch,\n                    event\n                  });\n                } catch(e) {\n                  console.error(\\` An error occurred: \\${e}\\`)\n                  throw e;\n                }\n              }\n            });\n          `;\n\n        return {\n          code,\n          map: null,\n        };\n      }\n\n      return;\n    },\n  };\n}\n"],"mappings":";;;;AAIA,SAAgB,sBAAsB;AACpC,QAAO;EACL,MAAM;EACN,MAAM,UACJ,OACA,IACkD;AAClD,OAAI,cAAc,GAAG,CAAC,SAAS,UAAU,IAAI,GAAG,SAAS,aAAa,EAAE;IAMtE,MAAM,cALS,UAAU,IAAI,OAAO;KAClC,YAAY;KACZ,MAAM;KACP,CAAC,CAEmC,OAAO,cAAc,SAAS,MACjE,EAAE,QACC,QAAQ,UAAU,MAAM,WAAW,SAAS,KAAK,CACjD,KAAK,UAAU,MAAM,WAAW,KAAe,CACnD;AA0ED,WAAO;KACL,MA1DW;;;;cAKP,YAAY,SAAS,OAAO,GACxB,QACA;kBACA,MAAM;;;mBAIX;;cAGC,YAAY,SAAS,SAAS,GAC1B,KACA;;;;gBAKL;;;gBAGG,6BAA6B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;KAkCnC,KAAK;KACN;;;EAKN"}
+{"version":3,"file":"page-endpoints.js","names":[],"sources":["../../../../src/lib/plugins/page-endpoints.ts"],"sourcesContent":["import { parseSync } from 'oxc-parser';\nimport { normalizePath } from 'vite';\nimport { SERVER_FETCH_FACTORY_SNIPPET } from '../utils/renderers.js';\n\nexport function pageEndpointsPlugin() {\n  return {\n    name: 'analogjs-vite-plugin-nitro-rollup-page-endpoint',\n    async transform(\n      _code: string,\n      id: string,\n    ): Promise<{ code: string; map: null } | undefined> {\n      if (normalizePath(id).includes('/pages/') && id.endsWith('.server.ts')) {\n        const result = parseSync(id, _code, {\n          sourceType: 'module',\n          lang: 'ts',\n        });\n\n        const fileExports: string[] = result.module.staticExports.flatMap((e) =>\n          e.entries\n            .filter((entry) => entry.exportName.name !== null)\n            .map((entry) => entry.exportName.name as string),\n        );\n\n        // In h3 v2 / Nitro v3, event.node is undefined during prerendering\n        // (which uses the fetch-based pipeline, not Node.js http). We use\n        // optional chaining so that page endpoints work in both Node.js\n        // server and fetch-based prerender contexts.\n        // Nitro v3 no longer guarantees the private `nitro/deps/ofetch`\n        // subpath that older codegen relied on.\n        //\n        // Page loaders expect Nitro-style `$fetch` semantics (parsed data plus\n        // internal relative-route support), so construct a request-local fetch\n        // using public APIs:\n        // - `createFetch` from `ofetch` for `$fetch` behavior\n        // - `fetchWithEvent` from `h3` for internal Nitro request routing\n        //\n        // This avoids both unstable private Nitro imports and assumptions about\n        // a global runtime `$fetch` being available during prerender.\n        const code = `\n            import { defineHandler, fetchWithEvent } from 'nitro/h3';\n            import { createFetch } from 'ofetch';\n\n            ${\n              fileExports.includes('load')\n                ? _code\n                : `\n                ${_code}\n                export const load = () => {\n                  return {};\n                }`\n            }\n\n            ${\n              fileExports.includes('action')\n                ? ''\n                : `\n                export const action = () => {\n                  return {};\n                }\n              `\n            }\n\n            export default defineHandler(async(event) => {\n              ${SERVER_FETCH_FACTORY_SNIPPET}\n\n              if (event.method === 'GET') {\n                try {\n                  return await load({\n                    params: event.context.params,\n                    req: event.node?.req,\n                    res: event.node?.res,\n                    fetch: serverFetch,\n                    event\n                  });\n                } catch(e) {\n                  console.error(\\` An error occurred: \\${e}\\`)\n                  throw e;\n                }\n              } else {\n                try {\n                  return await action({\n                    params: event.context.params,\n                    req: event.node?.req,\n                    res: event.node?.res,\n                    fetch: serverFetch,\n                    event\n                  });\n                } catch(e) {\n                  console.error(\\` An error occurred: \\${e}\\`)\n                  throw e;\n                }\n              }\n            });\n          `;\n\n        return {\n          code,\n          map: null,\n        };\n      }\n\n      return;\n    },\n  };\n}\n"],"mappings":";;;;AAIA,SAAgB,sBAAsB;AACpC,QAAO;EACL,MAAM;EACN,MAAM,UACJ,OACA,IACkD;AAClD,OAAI,cAAc,GAAG,CAAC,SAAS,UAAU,IAAI,GAAG,SAAS,aAAa,EAAE;IAMtE,MAAM,cALS,UAAU,IAAI,OAAO;KAClC,YAAY;KACZ,MAAM;KACP,CAAC,CAEmC,OAAO,cAAc,SAAS,MACjE,EAAE,QACC,QAAQ,UAAU,MAAM,WAAW,SAAS,KAAK,CACjD,KAAK,UAAU,MAAM,WAAW,KAAe,CACnD;AA0ED,WAAO;KACL,MA1DW;;;;cAKP,YAAY,SAAS,OAAO,GACxB,QACA;kBACA,MAAM;;;mBAIX;;cAGC,YAAY,SAAS,SAAS,GAC1B,KACA;;;;gBAKL;;;gBAGG,6BAA6B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;KAkCnC,KAAK;KACN;;;EAKN"}

package/src/lib/plugins/server-fn-id-plugin.d.ts

@@ -0,0 +1,11 @@
+/**
+* Nitro-build transform that stamps the derived id into each `serverFn` config
+* in a `*.server.ts`, so a function registers under the same opaque route the
+* client proxy dispatches to. The SSR app build does the same via the platform
+* plugin; this covers the separate Nitro server graph the dispatch handler pulls
+* the modules into.
+*/
+export declare function serverFnIdPlugin(projectRoot: string): {
+	name: string;
+	transform(code: string, id: string);
+};

package/src/lib/plugins/server-fn-id-plugin.js

@@ -0,0 +1,27 @@
+import { serverFnFileId } from "../utils/derive-server-fn-id.js";
+import { injectServerFnIds } from "../utils/inject-server-fn-ids.js";
+//#region packages/vite-plugin-nitro/src/lib/plugins/server-fn-id-plugin.ts
+/**
+* Nitro-build transform that stamps the derived id into each `serverFn` config
+* in a `*.server.ts`, so a function registers under the same opaque route the
+* client proxy dispatches to. The SSR app build does the same via the platform
+* plugin; this covers the separate Nitro server graph the dispatch handler pulls
+* the modules into.
+*/
+function serverFnIdPlugin(projectRoot) {
+	return {
+		name: "analogjs-server-fn-id",
+		transform(code, id) {
+			if (!id.endsWith(".server.ts")) return;
+			const injected = injectServerFnIds(code, serverFnFileId(id, projectRoot));
+			return injected ? {
+				code: injected.code,
+				map: null
+			} : void 0;
+		}
+	};
+}
+//#endregion
+export { serverFnIdPlugin };
+
+//# sourceMappingURL=server-fn-id-plugin.js.map

package/src/lib/plugins/server-fn-id-plugin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server-fn-id-plugin.js","names":[],"sources":["../../../../src/lib/plugins/server-fn-id-plugin.ts"],"sourcesContent":["import { serverFnFileId } from '../utils/derive-server-fn-id.js';\nimport { injectServerFnIds } from '../utils/inject-server-fn-ids.js';\n\n/**\n * Nitro-build transform that stamps the derived id into each `serverFn` config\n * in a `*.server.ts`, so a function registers under the same opaque route the\n * client proxy dispatches to. The SSR app build does the same via the platform\n * plugin; this covers the separate Nitro server graph the dispatch handler pulls\n * the modules into.\n */\nexport function serverFnIdPlugin(projectRoot: string) {\n  return {\n    name: 'analogjs-server-fn-id',\n    transform(code: string, id: string) {\n      if (!id.endsWith('.server.ts')) {\n        return;\n      }\n      const injected = injectServerFnIds(code, serverFnFileId(id, projectRoot));\n      return injected ? { code: injected.code, map: null } : undefined;\n    },\n  };\n}\n"],"mappings":";;;;;;;;;;AAUA,SAAgB,iBAAiB,aAAqB;AACpD,QAAO;EACL,MAAM;EACN,UAAU,MAAc,IAAY;AAClC,OAAI,CAAC,GAAG,SAAS,aAAa,CAC5B;GAEF,MAAM,WAAW,kBAAkB,MAAM,eAAe,IAAI,YAAY,CAAC;AACzE,UAAO,WAAW;IAAE,MAAM,SAAS;IAAM,KAAK;IAAM,GAAG,KAAA;;EAE1D"}

package/src/lib/utils/debug.d.ts

@@ -0,0 +1,5 @@
+export declare const debugNitro: unknown;
+export declare const debugSsr: unknown;
+export declare const debugPrerender: unknown;
+/** All debug instances in this package, for external wrapping (e.g. file logging). */
+export declare const debugInstances: unknown;

package/src/lib/utils/debug.js

@@ -0,0 +1,15 @@
+import { createDebug } from "obug";
+//#region packages/vite-plugin-nitro/src/lib/utils/debug.ts
+var debugNitro = createDebug("analog:nitro");
+var debugSsr = createDebug("analog:nitro:ssr");
+var debugPrerender = createDebug("analog:nitro:prerender");
+/** All debug instances in this package, for external wrapping (e.g. file logging). */
+var debugInstances = [
+	debugNitro,
+	debugSsr,
+	debugPrerender
+];
+//#endregion
+export { debugInstances, debugNitro, debugPrerender, debugSsr };
+
+//# sourceMappingURL=debug.js.map

package/src/lib/utils/debug.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"debug.js","names":[],"sources":["../../../../src/lib/utils/debug.ts"],"sourcesContent":["import { createDebug } from 'obug';\n\nexport const debugNitro = createDebug('analog:nitro');\nexport const debugSsr = createDebug('analog:nitro:ssr');\nexport const debugPrerender = createDebug('analog:nitro:prerender');\n\n/** All debug instances in this package, for external wrapping (e.g. file logging). */\nexport const debugInstances = [debugNitro, debugSsr, debugPrerender];\n"],"mappings":";;AAEA,IAAa,aAAa,YAAY,eAAe;AACrD,IAAa,WAAW,YAAY,mBAAmB;AACvD,IAAa,iBAAiB,YAAY,yBAAyB;;AAGnE,IAAa,iBAAiB;CAAC;CAAY;CAAU;CAAe"}

package/src/lib/utils/derive-server-fn-id.d.ts

@@ -0,0 +1,25 @@
+/**
+* Server-function ids are derived, never author-chosen, for security:
+*
+* - **Collision-free.** `hash(fileId + exportName)` is unique per file+export, so
+*   two functions can never share a route and hijack each other's dispatch — a
+*   real risk with hand-picked ids where two authors independently pick `getUser`.
+* - **Non-enumerable.** The public route is an opaque digest, not a guessable
+*   verb like `/_analog/fn/deleteAccount`, shrinking the discoverable surface.
+* - **Not author-controlled.** Authors cannot expose a meaningful or duplicate
+*   route by accident; the id is a pure function of location.
+*
+* Both build transforms (server registration + client proxy) MUST derive the
+* same id, so this is the single source of truth for the algorithm and the
+* `fileId` must be the **project-root-relative** POSIX path — identical across
+* the client, SSR, and Nitro builds regardless of absolute checkout location.
+*/
+/** Project-root-relative POSIX module path used as the stable hash input. */
+export declare function serverFnFileId(absPath: string, projectRoot: string): string;
+/**
+* Derives the opaque, collision-free id for a server function from its
+* project-root-relative file id and export name. 16 hex chars (64 bits) is far
+* beyond birthday-collision range for any realistic function count while keeping
+* the route short.
+*/
+export declare function deriveServerFnId(fileId: string, exportName: string): string;

package/src/lib/utils/derive-server-fn-id.js

@@ -0,0 +1,37 @@
+import { relative } from "node:path";
+import { createHash } from "node:crypto";
+//#region packages/vite-plugin-nitro/src/lib/utils/derive-server-fn-id.ts
+var toPosix = (p) => p.replace(/\\/g, "/");
+/**
+* Server-function ids are derived, never author-chosen, for security:
+*
+* - **Collision-free.** `hash(fileId + exportName)` is unique per file+export, so
+*   two functions can never share a route and hijack each other's dispatch — a
+*   real risk with hand-picked ids where two authors independently pick `getUser`.
+* - **Non-enumerable.** The public route is an opaque digest, not a guessable
+*   verb like `/_analog/fn/deleteAccount`, shrinking the discoverable surface.
+* - **Not author-controlled.** Authors cannot expose a meaningful or duplicate
+*   route by accident; the id is a pure function of location.
+*
+* Both build transforms (server registration + client proxy) MUST derive the
+* same id, so this is the single source of truth for the algorithm and the
+* `fileId` must be the **project-root-relative** POSIX path — identical across
+* the client, SSR, and Nitro builds regardless of absolute checkout location.
+*/
+/** Project-root-relative POSIX module path used as the stable hash input. */
+function serverFnFileId(absPath, projectRoot) {
+	return toPosix(relative(projectRoot, absPath));
+}
+/**
+* Derives the opaque, collision-free id for a server function from its
+* project-root-relative file id and export name. 16 hex chars (64 bits) is far
+* beyond birthday-collision range for any realistic function count while keeping
+* the route short.
+*/
+function deriveServerFnId(fileId, exportName) {
+	return createHash("sha256").update(`${fileId}#${exportName}`).digest("hex").slice(0, 16);
+}
+//#endregion
+export { deriveServerFnId, serverFnFileId };
+
+//# sourceMappingURL=derive-server-fn-id.js.map

package/src/lib/utils/derive-server-fn-id.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"derive-server-fn-id.js","names":[],"sources":["../../../../src/lib/utils/derive-server-fn-id.ts"],"sourcesContent":["import { createHash } from 'node:crypto';\nimport { relative } from 'node:path';\n\n// Intentionally dependency-light (node built-ins only): this module is loaded by\n// the client scrub, so it must not drag in vite/nitro. POSIX-normalize inline.\nconst toPosix = (p: string): string => p.replace(/\\\\/g, '/');\n\n/**\n * Server-function ids are derived, never author-chosen, for security:\n *\n * - **Collision-free.** `hash(fileId + exportName)` is unique per file+export, so\n *   two functions can never share a route and hijack each other's dispatch — a\n *   real risk with hand-picked ids where two authors independently pick `getUser`.\n * - **Non-enumerable.** The public route is an opaque digest, not a guessable\n *   verb like `/_analog/fn/deleteAccount`, shrinking the discoverable surface.\n * - **Not author-controlled.** Authors cannot expose a meaningful or duplicate\n *   route by accident; the id is a pure function of location.\n *\n * Both build transforms (server registration + client proxy) MUST derive the\n * same id, so this is the single source of truth for the algorithm and the\n * `fileId` must be the **project-root-relative** POSIX path — identical across\n * the client, SSR, and Nitro builds regardless of absolute checkout location.\n */\n\n/** Project-root-relative POSIX module path used as the stable hash input. */\nexport function serverFnFileId(absPath: string, projectRoot: string): string {\n  return toPosix(relative(projectRoot, absPath));\n}\n\n/**\n * Derives the opaque, collision-free id for a server function from its\n * project-root-relative file id and export name. 16 hex chars (64 bits) is far\n * beyond birthday-collision range for any realistic function count while keeping\n * the route short.\n */\nexport function deriveServerFnId(fileId: string, exportName: string): string {\n  return createHash('sha256')\n    .update(`${fileId}#${exportName}`)\n    .digest('hex')\n    .slice(0, 16);\n}\n"],"mappings":";;;AAKA,IAAM,WAAW,MAAsB,EAAE,QAAQ,OAAO,IAAI;;;;;;;;;;;;;;;;;;AAoB5D,SAAgB,eAAe,SAAiB,aAA6B;AAC3E,QAAO,QAAQ,SAAS,aAAa,QAAQ,CAAC;;;;;;;;AAShD,SAAgB,iBAAiB,QAAgB,YAA4B;AAC3E,QAAO,WAAW,SAAS,CACxB,OAAO,GAAG,OAAO,GAAG,aAAa,CACjC,OAAO,MAAM,CACb,MAAM,GAAG,GAAG"}