@analogjs/platform 3.0.0-alpha.9 → 3.0.0-alpha.90

package/src/lib/router-plugin.d.ts

@@ -1,21 +1,21 @@
-import { Plugin } from 'vite';
-import { Options } from './options.js';
+import { Plugin } from "vite";
+import { Options } from "./options.js";
 /**
- * Router plugin that handles route file discovery and hot module replacement.
- *
- * This plugin provides three main functionalities:
- * 1. Route invalidation when files are added/deleted (HMR workaround)
- * 2. Dynamic route file discovery and import generation
- * 3. Content route file discovery for markdown and Analog content
- *
- * @param options Configuration options for the router plugin
- * @returns Array of Vite plugins for route handling
- *
- * IMPORTANT: This plugin uses tinyglobby for file discovery.
- * Key behavior with { dot: true, absolute: true }:
- * - Returns absolute paths for ALL discovered files
- * - Path normalization is required to match expected output format
- * - Files within project root must use relative paths in object keys
- * - Files outside project root keep absolute paths in object keys
- */
+* Router plugin that handles route file discovery and hot module replacement.
+*
+* This plugin provides three main functionalities:
+* 1. Route invalidation when files are added/deleted (HMR workaround)
+* 2. Dynamic route file discovery and import generation
+* 3. Content route file discovery for markdown and Analog content
+*
+* @param options Configuration options for the router plugin
+* @returns Array of Vite plugins for route handling
+*
+* IMPORTANT: This plugin uses tinyglobby for file discovery.
+* Key behavior with { dot: true, absolute: true }:
+* - Returns absolute paths for ALL discovered files
+* - Path normalization is required to match expected output format
+* - Files within project root must use relative paths in object keys
+* - Files outside project root keep absolute paths in object keys
+*/
 export declare function routerPlugin(options?: Options): Plugin[];

package/src/lib/router-plugin.js

@@ -1,6 +1,8 @@
+import { analyzeAnalogRouteFile, formatAnalogRouteIdiomDiagnostic } from "./route-idiom-diagnostics.js";
+import { isAbsolute, relative, resolve } from "node:path";
+import { readFileSync } from "node:fs";
 import { normalizePath } from "vite";
 import { globSync } from "tinyglobby";
-import { resolve } from "node:path";
 //#region packages/platform/src/lib/router-plugin.ts
 /**
 * Router plugin that handles route file discovery and hot module replacement.
@@ -21,10 +23,105 @@ import { resolve } from "node:path";
 * - Files outside project root keep absolute paths in object keys
 */
 function routerPlugin(options) {
-	const workspaceRoot = normalizePath(options?.workspaceRoot ?? process.cwd());
+	const workspaceRoot = normalizePath(options?.workspaceRoot ?? process.env["NX_WORKSPACE_ROOT"] ?? process.cwd());
 	let config;
 	let root;
-	const isRouteLikeFile = (path) => path.includes(`routes`) || path.includes(`pages`) || path.includes("content");
+	const normalizeWatchedDir = (dir) => {
+		const normalizedDir = normalizePath(dir.startsWith(`${workspaceRoot}/`) || dir === workspaceRoot ? dir : dir.startsWith("/") ? `${workspaceRoot}${dir}` : resolve(workspaceRoot, dir));
+		return normalizedDir.endsWith("/") ? normalizedDir.slice(0, -1) : normalizedDir;
+	};
+	const additionalPagesDirs = (options?.additionalPagesDirs || []).map((dir) => normalizeWatchedDir(dir));
+	const additionalContentDirs = (options?.additionalContentDirs || []).map((dir) => normalizeWatchedDir(dir));
+	const getRouteLikeDirs = () => [
+		...root ? [
+			normalizeWatchedDir(`${root}/app/routes`),
+			normalizeWatchedDir(`${root}/src/app/routes`),
+			normalizeWatchedDir(`${root}/src/app/pages`),
+			normalizeWatchedDir(`${root}/src/content`)
+		] : [],
+		"/app/routes",
+		"/src/app/routes",
+		"/src/app/pages",
+		"/src/content",
+		...additionalPagesDirs,
+		...additionalContentDirs
+	];
+	let routeFilesCache;
+	let pageRouteFilesCache;
+	let contentRouteFilesCache;
+	let endpointFilesCache;
+	const routeDiagnosticCache = /* @__PURE__ */ new Map();
+	const isRouteLikeFile = (path) => {
+		const normalizedPath = normalizePath(path);
+		return getRouteLikeDirs().some((dir) => normalizedPath === dir || normalizedPath.startsWith(`${dir}/`));
+	};
+	const discoverRouteFiles = () => {
+		routeFilesCache ??= globSync([
+			`${root}/app/routes/**/*.ts`,
+			`${root}/src/app/routes/**/*.ts`,
+			`${root}/src/app/pages/**/*.page.ts`,
+			...additionalPagesDirs.map((dir) => `${dir}/**/*.page.ts`)
+		], {
+			dot: true,
+			absolute: true
+		});
+		return routeFilesCache;
+	};
+	const discoverContentRouteFiles = () => {
+		contentRouteFilesCache ??= globSync([
+			`${root}/src/app/routes/**/*.md`,
+			`${root}/src/app/pages/**/*.md`,
+			`${root}/src/content/**/*.md`,
+			...additionalContentDirs.map((dir) => `${dir}/**/*.md`)
+		], {
+			dot: true,
+			absolute: true
+		});
+		return contentRouteFilesCache;
+	};
+	const discoverEndpointFiles = () => {
+		endpointFilesCache ??= globSync([`${root}/src/app/pages/**/*.server.ts`, ...additionalPagesDirs.map((dir) => `${dir}/**/*.server.ts`)], {
+			dot: true,
+			absolute: true
+		});
+		return endpointFilesCache;
+	};
+	const discoverPageRouteFiles = () => {
+		pageRouteFilesCache ??= discoverRouteFiles().filter((file) => file.endsWith(".page.ts"));
+		return pageRouteFilesCache;
+	};
+	const invalidateDiscoveryCaches = () => {
+		routeFilesCache = void 0;
+		pageRouteFilesCache = void 0;
+		contentRouteFilesCache = void 0;
+		endpointFilesCache = void 0;
+	};
+	const reportRouteDiagnostics = (path) => {
+		if (!path.endsWith(".page.ts")) return;
+		try {
+			const rendered = analyzeAnalogRouteFile({
+				filename: path,
+				code: readFileSync(path, "utf-8"),
+				routeFiles: discoverPageRouteFiles()
+			}).map((diagnostic) => formatAnalogRouteIdiomDiagnostic(diagnostic, path, workspaceRoot));
+			const fingerprint = rendered.join("\n\n");
+			if (!fingerprint) {
+				routeDiagnosticCache.delete(path);
+				return;
+			}
+			if (routeDiagnosticCache.get(path) === fingerprint) return;
+			routeDiagnosticCache.set(path, fingerprint);
+			rendered.forEach((message) => console.warn(message));
+		} catch {
+			routeDiagnosticCache.delete(path);
+		}
+	};
+	const getModuleKey = (module) => {
+		if (!root) return `/${normalizePath(relative(workspaceRoot, module))}`;
+		const relToRoot = normalizePath(relative(root, module));
+		if (!relToRoot.startsWith("..") && !isAbsolute(relToRoot)) return `/${relToRoot}`;
+		return `/${normalizePath(relative(workspaceRoot, module))}`;
+	};
 	const invalidateFileModules = (server, path) => {
 		const normalizedPath = normalizePath(path);
 		(server.moduleGraph.getModulesByFile?.(normalizedPath) ?? server.moduleGraph.fileToModulesMap.get(normalizedPath))?.forEach((mod) => {
@@ -44,9 +141,16 @@ function routerPlugin(options) {
 				*
 				* @param path The file path that was added or deleted
 				*/
-				function invalidateRoutes(path) {
+				function invalidateRoutes(path, event) {
 					if (!isRouteLikeFile(path)) return;
+					if (event !== "change") invalidateDiscoveryCaches();
+					if (event === "change") reportRouteDiagnostics(path);
+					else if (event === "unlink") {
+						routeDiagnosticCache.delete(path);
+						discoverPageRouteFiles().forEach((file) => reportRouteDiagnostics(file));
+					} else discoverPageRouteFiles().forEach((file) => reportRouteDiagnostics(file));
 					invalidateFileModules(server, path);
+					if (event === "change") return;
 					server.moduleGraph.fileToModulesMap.forEach((mods) => {
 						mods.forEach((mod) => {
 							if (mod.id?.includes("analogjs") && mod.id?.includes("fesm")) {
@@ -57,11 +161,19 @@ function routerPlugin(options) {
 							}
 						});
 					});
+					server.ws.send("analog:debug-full-reload", {
+						plugin: "platform:router-plugin",
+						reason: "route-graph-shape-changed",
+						event,
+						path
+					});
 					server.ws.send({ type: "full-reload" });
 				}
-				server.watcher.on("add", invalidateRoutes);
-				server.watcher.on("change", invalidateRoutes);
-				server.watcher.on("unlink", invalidateRoutes);
+				server.watcher.on("add", (path) => invalidateRoutes(path, "add"));
+				server.watcher.on("change", (path) => invalidateRoutes(path, "change"));
+				server.watcher.on("unlink", (path) => invalidateRoutes(path, "unlink"));
+				for (const dir of [...additionalPagesDirs, ...additionalContentDirs]) server.watcher.add(dir);
+				discoverPageRouteFiles().forEach((file) => reportRouteDiagnostics(file));
 			}
 		},
 		{
@@ -72,37 +184,22 @@ function routerPlugin(options) {
 				root = normalizePath(resolve(workspaceRoot, config.root || ".") || ".");
 			},
 			transform: {
-				filter: { code: "ANALOG_ROUTE_FILES" },
+				filter: { code: "_ROUTE_FILES" },
 				handler(code) {
 					if (code.includes("ANALOG_ROUTE_FILES") || code.includes("ANALOG_CONTENT_ROUTE_FILES")) {
-						const routeFiles = globSync([
-							`${root}/app/routes/**/*.ts`,
-							`${root}/src/app/routes/**/*.ts`,
-							`${root}/src/app/pages/**/*.page.ts`,
-							...(options?.additionalPagesDirs || []).map((glob) => `${workspaceRoot}${glob}/**/*.page.ts`)
-						], {
-							dot: true,
-							absolute: true
-						});
-						const contentRouteFiles = globSync([
-							`${root}/src/app/routes/**/*.md`,
-							`${root}/src/app/pages/**/*.md`,
-							`${root}/src/content/**/*.md`,
-							...(options?.additionalContentDirs || []).map((glob) => `${workspaceRoot}${glob}/**/*.md`)
-						], {
-							dot: true,
-							absolute: true
-						});
+						const routeFiles = discoverRouteFiles();
+						const contentRouteFiles = discoverContentRouteFiles();
 						let result = code.replace("ANALOG_ROUTE_FILES = {};", `
               ANALOG_ROUTE_FILES = {${routeFiles.map((module) => {
-							return `"${module.startsWith(root) ? module.replace(root, "") : module}": () => import('${module}')`;
+							return `"${getModuleKey(module)}": () => import('${module}')`;
 						})}};
             `);
 						result = result.replace("ANALOG_CONTENT_ROUTE_FILES = {};", `
             ANALOG_CONTENT_ROUTE_FILES = {${contentRouteFiles.map((module) => {
-							return `"${module.startsWith(root) ? module.replace(root, "") : module}": () => import('${module}?analog-content-file=true').then(m => m.default)`;
+							return `"${getModuleKey(module)}": () => import('${module}?analog-content-file=true').then(m => m.default)`;
 						})}};
             `);
+						result = result.replace("ANALOG_CONTENT_FILE_COUNT = 0", `ANALOG_CONTENT_FILE_COUNT = ${contentRouteFiles.length}`);
 						return {
 							code: result,
 							map: { mappings: "" }
@@ -118,14 +215,11 @@ function routerPlugin(options) {
 				filter: { code: "ANALOG_PAGE_ENDPOINTS" },
 				handler(code) {
 					if (code.includes("ANALOG_PAGE_ENDPOINTS")) {
-						const endpointFiles = globSync([`${root}/src/app/pages/**/*.server.ts`, ...(options?.additionalPagesDirs || []).map((glob) => `${workspaceRoot}${glob}/**/*.server.ts`)], {
-							dot: true,
-							absolute: true
-						});
+						const endpointFiles = discoverEndpointFiles();
 						return {
 							code: code.replace("ANALOG_PAGE_ENDPOINTS = {};", `
               ANALOG_PAGE_ENDPOINTS = {${endpointFiles.map((module) => {
-								return `"${module.startsWith(root) ? module.replace(root, "") : module}": () => import('${module}')`;
+								return `"${getModuleKey(module)}": () => import('${module}')`;
 							})}};
             `),
 							map: { mappings: "" }

package/src/lib/router-plugin.js.map

@@ -1 +1 @@
-{"version":3,"file":"router-plugin.js","names":[],"sources":["../../../../../packages/platform/src/lib/router-plugin.ts"],"sourcesContent":["import { normalizePath, Plugin, UserConfig, ViteDevServer } from 'vite';\nimport { globSync } from 'tinyglobby';\nimport { resolve } from 'node:path';\n\nimport { Options } from './options.js';\n\n/**\n * Router plugin that handles route file discovery and hot module replacement.\n *\n * This plugin provides three main functionalities:\n * 1. Route invalidation when files are added/deleted (HMR workaround)\n * 2. Dynamic route file discovery and import generation\n * 3. Content route file discovery for markdown and Analog content\n *\n * @param options Configuration options for the router plugin\n * @returns Array of Vite plugins for route handling\n *\n * IMPORTANT: This plugin uses tinyglobby for file discovery.\n * Key behavior with { dot: true, absolute: true }:\n * - Returns absolute paths for ALL discovered files\n * - Path normalization is required to match expected output format\n * - Files within project root must use relative paths in object keys\n * - Files outside project root keep absolute paths in object keys\n */\nexport function routerPlugin(options?: Options): Plugin[] {\n  const workspaceRoot = normalizePath(options?.workspaceRoot ?? process.cwd());\n  let config: UserConfig;\n  let root: string;\n  const isRouteLikeFile = (path: string) =>\n    path.includes(`routes`) ||\n    path.includes(`pages`) ||\n    path.includes('content');\n  const invalidateFileModules = (server: ViteDevServer, path: string) => {\n    const normalizedPath = normalizePath(path);\n    // A newly added page can be discovered before its final contents settle.\n    // Invalidate the page module itself so later edits don't keep serving the\n    // first incomplete transform from Vite's module graph.\n    const fileModules =\n      server.moduleGraph.getModulesByFile?.(normalizedPath) ??\n      server.moduleGraph.fileToModulesMap.get(normalizedPath);\n\n    fileModules?.forEach((mod) => {\n      server.moduleGraph.invalidateModule(mod);\n\n      mod.importers.forEach((imp) => {\n        server.moduleGraph.invalidateModule(imp);\n      });\n    });\n  };\n\n  return [\n    {\n      name: 'analogjs-router-invalidate-routes',\n      configureServer(server) {\n        /**\n         * Invalidates route modules when files are added or deleted.\n         * This is a workaround for Vite's HMR limitations with dynamic imports.\n         *\n         * @param path The file path that was added or deleted\n         */\n        function invalidateRoutes(path: string) {\n          if (!isRouteLikeFile(path)) {\n            return;\n          }\n\n          invalidateFileModules(server, path);\n\n          server.moduleGraph.fileToModulesMap.forEach((mods) => {\n            mods.forEach((mod) => {\n              if (mod.id?.includes('analogjs') && mod.id?.includes('fesm')) {\n                server.moduleGraph.invalidateModule(mod);\n\n                mod.importers.forEach((imp) => {\n                  server.moduleGraph.invalidateModule(imp);\n                });\n              }\n            });\n          });\n\n          server.ws.send({\n            type: 'full-reload',\n          });\n        }\n\n        server.watcher.on('add', invalidateRoutes);\n        server.watcher.on('change', invalidateRoutes);\n        server.watcher.on('unlink', invalidateRoutes);\n      },\n    },\n    {\n      name: 'analog-glob-routes',\n      // enforce: 'post' ensures this transform runs AFTER the Angular compiler\n      // plugin, which replaces module content with its own compiled output.\n      // Without this, the Angular plugin would overwrite the route replacements.\n      enforce: 'post',\n      config(_config) {\n        config = _config;\n        root = normalizePath(resolve(workspaceRoot, config.root || '.') || '.');\n      },\n      /**\n       * Transforms code to replace ANALOG_ROUTE_FILES and ANALOG_CONTENT_ROUTE_FILES\n       * placeholders with actual dynamic imports of discovered route and content files.\n       *\n       * @param code The source code to transform\n       * @returns Transformed code with dynamic imports or undefined if no transformation needed\n       */\n      // Vite 8 / Rolldown filtered transform: the `filter.code` substring\n      // pre-filter lets the bundler skip modules that don't contain the\n      // marker.  'ANALOG_ROUTE_FILES' also matches 'ANALOG_CONTENT_ROUTE_FILES'\n      // (substring), so a single filter covers both placeholders.\n      transform: {\n        filter: {\n          code: 'ANALOG_ROUTE_FILES',\n        },\n        handler(code) {\n          if (\n            code.includes('ANALOG_ROUTE_FILES') ||\n            code.includes('ANALOG_CONTENT_ROUTE_FILES')\n          ) {\n            // Discover route files using tinyglobby\n            // NOTE: { absolute: true } returns absolute paths for ALL files\n            const routeFiles: string[] = globSync(\n              [\n                `${root}/app/routes/**/*.ts`,\n                `${root}/src/app/routes/**/*.ts`,\n                `${root}/src/app/pages/**/*.page.ts`,\n                ...(options?.additionalPagesDirs || []).map(\n                  (glob) => `${workspaceRoot}${glob}/**/*.page.ts`,\n                ),\n              ],\n              { dot: true, absolute: true },\n            );\n\n            // Discover content files using tinyglobby\n            const contentRouteFiles: string[] = globSync(\n              [\n                `${root}/src/app/routes/**/*.md`,\n                `${root}/src/app/pages/**/*.md`,\n                `${root}/src/content/**/*.md`,\n                ...(options?.additionalContentDirs || []).map(\n                  (glob) => `${workspaceRoot}${glob}/**/*.md`,\n                ),\n              ],\n              { dot: true, absolute: true },\n            );\n\n            let result = code.replace(\n              'ANALOG_ROUTE_FILES = {};',\n              `\n              ANALOG_ROUTE_FILES = {${routeFiles.map((module) => {\n                // CRITICAL: tinyglobby returns absolute paths, but we need relative paths for project files\n                // to match expected output format. Library files keep absolute paths.\n                const key = module.startsWith(root)\n                  ? module.replace(root, '')\n                  : module;\n                return `\"${key}\": () => import('${module}')`;\n              })}};\n            `,\n            );\n\n            result = result.replace(\n              'ANALOG_CONTENT_ROUTE_FILES = {};',\n              `\n            ANALOG_CONTENT_ROUTE_FILES = {${contentRouteFiles.map((module) => {\n              // Same path normalization as route files\n              const key = module.startsWith(root)\n                ? module.replace(root, '')\n                : module;\n              return `\"${key}\": () => import('${module}?analog-content-file=true').then(m => m.default)`;\n            })}};\n            `,\n            );\n\n            return {\n              code: result,\n              map: { mappings: '' },\n            };\n          }\n\n          return;\n        },\n      },\n    },\n    {\n      name: 'analog-glob-endpoints',\n      // enforce: 'post' ensures this transform runs AFTER the Angular compiler\n      // plugin, which replaces module content with its own compiled output.\n      // Without this, the Angular plugin would overwrite the endpoint replacements.\n      enforce: 'post',\n      /**\n       * Transforms code to replace ANALOG_PAGE_ENDPOINTS placeholder\n       * with actual dynamic imports of discovered server endpoint files.\n       *\n       * @param code The source code to transform\n       * @returns Transformed code with dynamic imports or undefined if no transformation needed\n       */\n      transform: {\n        filter: {\n          code: 'ANALOG_PAGE_ENDPOINTS',\n        },\n        handler(code) {\n          if (code.includes('ANALOG_PAGE_ENDPOINTS')) {\n            // Discover server endpoint files using tinyglobby\n            const endpointFiles: string[] = globSync(\n              [\n                `${root}/src/app/pages/**/*.server.ts`,\n                ...(options?.additionalPagesDirs || []).map(\n                  (glob) => `${workspaceRoot}${glob}/**/*.server.ts`,\n                ),\n              ],\n              { dot: true, absolute: true },\n            );\n\n            const result = code.replace(\n              'ANALOG_PAGE_ENDPOINTS = {};',\n              `\n              ANALOG_PAGE_ENDPOINTS = {${endpointFiles.map((module) => {\n                // Same path normalization for consistency\n                const key = module.startsWith(root)\n                  ? module.replace(root, '')\n                  : module;\n                return `\"${key}\": () => import('${module}')`;\n              })}};\n            `,\n            );\n\n            return {\n              code: result,\n              map: { mappings: '' },\n            };\n          }\n\n          return;\n        },\n      },\n    },\n  ];\n}\n"],"mappings":"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"}
+{"version":3,"file":"router-plugin.js","names":[],"sources":["../../../src/lib/router-plugin.ts"],"sourcesContent":["import { normalizePath, Plugin, UserConfig, ViteDevServer } from 'vite';\nimport { globSync } from 'tinyglobby';\nimport { readFileSync } from 'node:fs';\nimport { isAbsolute, relative, resolve } from 'node:path';\n\nimport { Options } from './options.js';\nimport {\n  analyzeAnalogRouteFile,\n  formatAnalogRouteIdiomDiagnostic,\n} from './route-idiom-diagnostics.js';\n\n/**\n * Router plugin that handles route file discovery and hot module replacement.\n *\n * This plugin provides three main functionalities:\n * 1. Route invalidation when files are added/deleted (HMR workaround)\n * 2. Dynamic route file discovery and import generation\n * 3. Content route file discovery for markdown and Analog content\n *\n * @param options Configuration options for the router plugin\n * @returns Array of Vite plugins for route handling\n *\n * IMPORTANT: This plugin uses tinyglobby for file discovery.\n * Key behavior with { dot: true, absolute: true }:\n * - Returns absolute paths for ALL discovered files\n * - Path normalization is required to match expected output format\n * - Files within project root must use relative paths in object keys\n * - Files outside project root keep absolute paths in object keys\n */\nexport function routerPlugin(options?: Options): Plugin[] {\n  const workspaceRoot = normalizePath(\n    options?.workspaceRoot ?? process.env['NX_WORKSPACE_ROOT'] ?? process.cwd(),\n  );\n  let config: UserConfig;\n  let root: string;\n  // Option dirs are workspace-relative, often written with a leading `/`.\n  // Normalize them once into absolute workspace paths so watcher events,\n  // glob patterns, and key generation all compare against the same shape.\n  const normalizeWatchedDir = (dir: string) => {\n    const normalizedDir = normalizePath(\n      dir.startsWith(`${workspaceRoot}/`) || dir === workspaceRoot\n        ? dir\n        : dir.startsWith('/')\n          ? `${workspaceRoot}${dir}`\n          : resolve(workspaceRoot, dir),\n    );\n    return normalizedDir.endsWith('/')\n      ? normalizedDir.slice(0, -1)\n      : normalizedDir;\n  };\n  // Computed eagerly — these depend only on `options` and `workspaceRoot`,\n  // both of which are fixed at construction time.\n  const additionalPagesDirs = (options?.additionalPagesDirs || []).map((dir) =>\n    normalizeWatchedDir(dir),\n  );\n  const additionalContentDirs = (options?.additionalContentDirs || []).map(\n    (dir) => normalizeWatchedDir(dir),\n  );\n  // Returns every directory that can contain route-like files. The root-\n  // relative entries are only available after the Vite `config` hook sets\n  // `root`. The short-form fallbacks (`/app/routes`, etc.) let watcher\n  // events match before `config` runs — they cover the common convention\n  // where paths start with these prefixes.\n  const getRouteLikeDirs = () => [\n    ...(root\n      ? [\n          normalizeWatchedDir(`${root}/app/routes`),\n          normalizeWatchedDir(`${root}/src/app/routes`),\n          normalizeWatchedDir(`${root}/src/app/pages`),\n          normalizeWatchedDir(`${root}/src/content`),\n        ]\n      : []),\n    '/app/routes',\n    '/src/app/routes',\n    '/src/app/pages',\n    '/src/content',\n    ...additionalPagesDirs,\n    ...additionalContentDirs,\n  ];\n  // These lists are used repeatedly by transform hooks during serve. Keeping\n  // them warm avoids a full glob on every route/content invalidation.\n  let routeFilesCache: string[] | undefined;\n  let pageRouteFilesCache: string[] | undefined;\n  let contentRouteFilesCache: string[] | undefined;\n  let endpointFilesCache: string[] | undefined;\n  const routeDiagnosticCache = new Map<string, string>();\n  const isRouteLikeFile = (path: string) => {\n    // Watcher paths from chokidar are already absolute — `normalizePath`\n    // (forward-slash only) is sufficient; `resolve()` would be a no-op.\n    const normalizedPath = normalizePath(path);\n\n    return getRouteLikeDirs().some(\n      (dir) => normalizedPath === dir || normalizedPath.startsWith(`${dir}/`),\n    );\n  };\n  const discoverRouteFiles = () => {\n    routeFilesCache ??= globSync(\n      [\n        `${root}/app/routes/**/*.ts`,\n        `${root}/src/app/routes/**/*.ts`,\n        `${root}/src/app/pages/**/*.page.ts`,\n        ...additionalPagesDirs.map((dir) => `${dir}/**/*.page.ts`),\n      ],\n      { dot: true, absolute: true },\n    );\n\n    return routeFilesCache;\n  };\n  const discoverContentRouteFiles = () => {\n    contentRouteFilesCache ??= globSync(\n      [\n        `${root}/src/app/routes/**/*.md`,\n        `${root}/src/app/pages/**/*.md`,\n        `${root}/src/content/**/*.md`,\n        ...additionalContentDirs.map((dir) => `${dir}/**/*.md`),\n      ],\n      { dot: true, absolute: true },\n    );\n\n    return contentRouteFilesCache;\n  };\n  const discoverEndpointFiles = () => {\n    endpointFilesCache ??= globSync(\n      [\n        `${root}/src/app/pages/**/*.server.ts`,\n        ...additionalPagesDirs.map((dir) => `${dir}/**/*.server.ts`),\n      ],\n      { dot: true, absolute: true },\n    );\n\n    return endpointFilesCache;\n  };\n  const discoverPageRouteFiles = () => {\n    pageRouteFilesCache ??= discoverRouteFiles().filter((file) =>\n      file.endsWith('.page.ts'),\n    );\n\n    return pageRouteFilesCache;\n  };\n  const invalidateDiscoveryCaches = () => {\n    routeFilesCache = undefined;\n    pageRouteFilesCache = undefined;\n    contentRouteFilesCache = undefined;\n    endpointFilesCache = undefined;\n  };\n  const reportRouteDiagnostics = (path: string) => {\n    if (!path.endsWith('.page.ts')) {\n      return;\n    }\n\n    try {\n      const code = readFileSync(path, 'utf-8');\n      const routeFiles = discoverPageRouteFiles();\n      const diagnostics = analyzeAnalogRouteFile({\n        filename: path,\n        code,\n        routeFiles,\n      });\n\n      const rendered = diagnostics.map((diagnostic) =>\n        formatAnalogRouteIdiomDiagnostic(diagnostic, path, workspaceRoot),\n      );\n      const fingerprint = rendered.join('\\n\\n');\n\n      if (!fingerprint) {\n        routeDiagnosticCache.delete(path);\n        return;\n      }\n\n      if (routeDiagnosticCache.get(path) === fingerprint) {\n        return;\n      }\n\n      routeDiagnosticCache.set(path, fingerprint);\n      rendered.forEach((message) => console.warn(message));\n    } catch {\n      routeDiagnosticCache.delete(path);\n    }\n  };\n  const getModuleKey = (module: string) => {\n    // Before config sets `root`, fall back to workspace-relative keys.\n    if (!root) {\n      return `/${normalizePath(relative(workspaceRoot, module))}`;\n    }\n\n    const relToRoot = normalizePath(relative(root, module));\n    // Use true path containment instead of a raw prefix check so siblings like\n    // `/apps/my-app-tools/...` are not mistaken for files inside `/apps/my-app`.\n    const isInRoot = !relToRoot.startsWith('..') && !isAbsolute(relToRoot);\n\n    if (isInRoot) {\n      return `/${relToRoot}`;\n    }\n\n    return `/${normalizePath(relative(workspaceRoot, module))}`;\n  };\n  const invalidateFileModules = (server: ViteDevServer, path: string) => {\n    const normalizedPath = normalizePath(path);\n    // A newly added page can be discovered before its final contents settle.\n    // Invalidate the page module itself so later edits don't keep serving the\n    // first incomplete transform from Vite's module graph.\n    const fileModules =\n      server.moduleGraph.getModulesByFile?.(normalizedPath) ??\n      server.moduleGraph.fileToModulesMap.get(normalizedPath);\n\n    fileModules?.forEach((mod) => {\n      server.moduleGraph.invalidateModule(mod);\n\n      mod.importers.forEach((imp) => {\n        server.moduleGraph.invalidateModule(imp);\n      });\n    });\n  };\n\n  return [\n    {\n      name: 'analogjs-router-invalidate-routes',\n      configureServer(server) {\n        /**\n         * Invalidates route modules when files are added or deleted.\n         * This is a workaround for Vite's HMR limitations with dynamic imports.\n         *\n         * @param path The file path that was added or deleted\n         */\n        function invalidateRoutes(\n          path: string,\n          event: 'add' | 'change' | 'unlink',\n        ) {\n          if (!isRouteLikeFile(path)) {\n            return;\n          }\n\n          // Add/remove changes the route graph shape, so the discovery caches\n          // must be rebuilt. Plain edits can keep using the current file set.\n          if (event !== 'change') {\n            invalidateDiscoveryCaches();\n          }\n\n          if (event === 'change') {\n            reportRouteDiagnostics(path);\n          } else if (event === 'unlink') {\n            routeDiagnosticCache.delete(path);\n            discoverPageRouteFiles().forEach((file) =>\n              reportRouteDiagnostics(file),\n            );\n          } else {\n            discoverPageRouteFiles().forEach((file) =>\n              reportRouteDiagnostics(file),\n            );\n          }\n\n          invalidateFileModules(server, path);\n\n          // For an in-place edit we only need module invalidation. Keeping the\n          // app alive here lets Angular/Vite attempt the narrower HMR path.\n          if (event === 'change') {\n            return;\n          }\n\n          server.moduleGraph.fileToModulesMap.forEach((mods) => {\n            mods.forEach((mod) => {\n              if (mod.id?.includes('analogjs') && mod.id?.includes('fesm')) {\n                server.moduleGraph.invalidateModule(mod);\n\n                mod.importers.forEach((imp) => {\n                  server.moduleGraph.invalidateModule(imp);\n                });\n              }\n            });\n          });\n\n          server.ws.send('analog:debug-full-reload', {\n            plugin: 'platform:router-plugin',\n            reason: 'route-graph-shape-changed',\n            event,\n            path,\n          });\n          server.ws.send({\n            type: 'full-reload',\n          });\n        }\n\n        server.watcher.on('add', (path) => invalidateRoutes(path, 'add'));\n        server.watcher.on('change', (path) => invalidateRoutes(path, 'change'));\n        server.watcher.on('unlink', (path) => invalidateRoutes(path, 'unlink'));\n\n        // Vite's watcher only covers the app root by default.\n        // additionalPagesDirs / additionalContentDirs live outside the\n        // root (e.g. libs/shared/feature in a monorepo), so file\n        // add/rename/delete events are never fired for them.  Explicitly\n        // add these directories to chokidar so route invalidation works.\n        for (const dir of [...additionalPagesDirs, ...additionalContentDirs]) {\n          server.watcher.add(dir);\n        }\n\n        discoverPageRouteFiles().forEach((file) =>\n          reportRouteDiagnostics(file),\n        );\n      },\n    },\n    {\n      name: 'analog-glob-routes',\n      // enforce: 'post' ensures this transform runs AFTER the Angular compiler\n      // plugin, which replaces module content with its own compiled output.\n      // Without this, the Angular plugin would overwrite the route replacements.\n      enforce: 'post',\n      config(_config) {\n        config = _config;\n        root = normalizePath(resolve(workspaceRoot, config.root || '.') || '.');\n      },\n      /**\n       * Transforms code to replace ANALOG_ROUTE_FILES and ANALOG_CONTENT_ROUTE_FILES\n       * placeholders with actual dynamic imports of discovered route and content files.\n       *\n       * @param code The source code to transform\n       * @returns Transformed code with dynamic imports or undefined if no transformation needed\n       */\n      // Vite 8 / Rolldown filtered transform: the `filter.code` substring\n      // pre-filter lets the bundler skip modules that don't contain the\n      // marker.  '_ROUTE_FILES' is a common substring of both\n      // 'ANALOG_ROUTE_FILES' and 'ANALOG_CONTENT_ROUTE_FILES'.\n      //\n      // IMPORTANT: Do NOT change this to 'ANALOG_ROUTE_FILES' — that is NOT\n      // a substring of 'ANALOG_CONTENT_ROUTE_FILES' (they diverge at\n      // position 7: 'ANALOG_C...' vs 'ANALOG_R...').  When tsconfig path\n      // aliases resolve @analogjs/router and @analogjs/router/content to\n      // separate source files, each variable lives in its own module and\n      // the filter must match both independently.\n      transform: {\n        filter: {\n          code: '_ROUTE_FILES',\n        },\n        handler(code) {\n          if (\n            code.includes('ANALOG_ROUTE_FILES') ||\n            code.includes('ANALOG_CONTENT_ROUTE_FILES')\n          ) {\n            // Discover route files using tinyglobby\n            // NOTE: { absolute: true } returns absolute paths for ALL files\n            const routeFiles = discoverRouteFiles();\n\n            // Discover content files using tinyglobby\n            const contentRouteFiles = discoverContentRouteFiles();\n\n            let result = code.replace(\n              'ANALOG_ROUTE_FILES = {};',\n              `\n              ANALOG_ROUTE_FILES = {${routeFiles.map((module) => {\n                // Keys are app-root-relative for in-app files,\n                // workspace-relative for library files (additionalPagesDirs).\n                // import() keeps absolute paths for Vite's module resolution.\n                const key = getModuleKey(module);\n                return `\"${key}\": () => import('${module}')`;\n              })}};\n            `,\n            );\n\n            result = result.replace(\n              'ANALOG_CONTENT_ROUTE_FILES = {};',\n              `\n            ANALOG_CONTENT_ROUTE_FILES = {${contentRouteFiles.map((module) => {\n              const key = getModuleKey(module);\n              return `\"${key}\": () => import('${module}?analog-content-file=true').then(m => m.default)`;\n            })}};\n            `,\n            );\n\n            result = result.replace(\n              'ANALOG_CONTENT_FILE_COUNT = 0',\n              `ANALOG_CONTENT_FILE_COUNT = ${contentRouteFiles.length}`,\n            );\n\n            return {\n              code: result,\n              map: { mappings: '' },\n            };\n          }\n\n          return;\n        },\n      },\n    },\n    {\n      name: 'analog-glob-endpoints',\n      // enforce: 'post' ensures this transform runs AFTER the Angular compiler\n      // plugin, which replaces module content with its own compiled output.\n      // Without this, the Angular plugin would overwrite the endpoint replacements.\n      enforce: 'post',\n      /**\n       * Transforms code to replace ANALOG_PAGE_ENDPOINTS placeholder\n       * with actual dynamic imports of discovered server endpoint files.\n       *\n       * @param code The source code to transform\n       * @returns Transformed code with dynamic imports or undefined if no transformation needed\n       */\n      transform: {\n        filter: {\n          code: 'ANALOG_PAGE_ENDPOINTS',\n        },\n        handler(code) {\n          if (code.includes('ANALOG_PAGE_ENDPOINTS')) {\n            // Discover server endpoint files using tinyglobby\n            const endpointFiles = discoverEndpointFiles();\n\n            const result = code.replace(\n              'ANALOG_PAGE_ENDPOINTS = {};',\n              `\n              ANALOG_PAGE_ENDPOINTS = {${endpointFiles.map((module) => {\n                const key = getModuleKey(module);\n                return `\"${key}\": () => import('${module}')`;\n              })}};\n            `,\n            );\n\n            return {\n              code: result,\n              map: { mappings: '' },\n            };\n          }\n\n          return;\n        },\n      },\n    },\n  ];\n}\n"],"mappings":"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"}

package/src/lib/server-fn-client-transform.d.ts

@@ -0,0 +1,26 @@
+/**
+* Client-build scrub + proxy generation for server functions.
+*
+* On the client build a `*.server.ts` module must not carry server handler
+* bodies (which `inject()` server services, read the request, hit the database).
+* But the client still imports the named `serverFn` exports to dispatch them.
+* This transform regenerates the module so each `export const NAME = serverFn(
+* config, handler)` becomes a call to the client-safe `createServerFnRef`
+* factory — keeping the `{ id, url, method }` metadata `injectServerFn` needs,
+* dropping the handler and every server-only import. Because the regenerated
+* module references nothing else, the server code tree-shakes away entirely.
+*
+* Returns the new module source, or `null` when the module defines no server
+* function (the caller falls back to the page-endpoint scrub for those).
+*/
+export interface ServerFnProxy {
+	name: string;
+	id: string;
+	method: "GET" | "POST";
+}
+export interface ScrubResult {
+	code: string;
+	proxies: ServerFnProxy[];
+	hadDefaultExport: boolean;
+}
+export declare function scrubServerFnModule(code: string, fileId?: string): ScrubResult | null;

package/src/lib/server-fn-client-transform.js

@@ -0,0 +1,97 @@
+import { deriveServerFnId } from "./server-fn-id.js";
+import { parseSync } from "oxc-parser";
+//#region packages/platform/src/lib/server-fn-client-transform.ts
+var SERVER_FN_SOURCE = "@analogjs/router/server";
+function scrubServerFnModule(code, fileId = "file.ts") {
+	if (!code.includes("serverFn")) return null;
+	const { program } = parseSync(fileId, code);
+	const body = program.body;
+	const serverFnLocalNames = collectServerFnLocalNames(body);
+	const hadDefaultExport = body.some((node) => node.type === "ExportDefaultDeclaration");
+	const proxies = [];
+	for (const node of body) {
+		if (node.type !== "ExportNamedDeclaration" || node.declaration?.type !== "VariableDeclaration") continue;
+		for (const declarator of node.declaration.declarations) {
+			if (declarator.id?.type !== "Identifier" || declarator.init?.type !== "CallExpression" || declarator.init.callee?.type !== "Identifier" || !serverFnLocalNames.has(declarator.init.callee.name)) continue;
+			proxies.push(toProxy(declarator.id.name, declarator.init.arguments ?? [], fileId));
+		}
+	}
+	const callCount = countServerFnCalls(program, serverFnLocalNames);
+	if (callCount > proxies.length) throw new Error(`[analog] ${fileId}: found ${callCount} serverFn call(s) but could only rewrite ${proxies.length} for the client build. Server functions must be declared as a directly exported const — \`export const name = serverFn(…)\` — so the handler can be stripped from the browser bundle.`);
+	if (proxies.length === 0) return null;
+	const lines = [
+		`import { createServerFnRef } from '@analogjs/router';`,
+		"",
+		...proxies.map((p) => `export const ${p.name} = createServerFnRef({ id: ${JSON.stringify(p.id)}, method: ${JSON.stringify(p.method)} });`)
+	];
+	if (hadDefaultExport) lines.push("", "export default undefined;");
+	return {
+		code: lines.join("\n") + "\n",
+		proxies,
+		hadDefaultExport
+	};
+}
+/** Local identifier(s) `serverFn` is imported under from `@analogjs/router/server`. */
+function collectServerFnLocalNames(body) {
+	const names = /* @__PURE__ */ new Set();
+	for (const node of body) {
+		if (node.type !== "ImportDeclaration" || node.source?.value !== SERVER_FN_SOURCE) continue;
+		for (const spec of node.specifiers ?? []) if (spec.type === "ImportSpecifier" && spec.imported?.name === "serverFn") names.add(spec.local.name);
+	}
+	if (names.size === 0) names.add("serverFn");
+	return names;
+}
+function toProxy(name, args, fileId) {
+	const method = methodForCall(name, args, fileId);
+	return {
+		name,
+		id: deriveServerFnId(fileId, name),
+		method
+	};
+}
+/**
+* Resolve the HTTP method from the call shape, matching the runtime overloads:
+* `serverFn(handler)` ⇒ GET, `serverFn(schema, handler)` ⇒ POST,
+* `serverFn(config, handler)` ⇒ config-driven.
+*/
+function methodForCall(name, args, fileId) {
+	const arg0 = args[0];
+	if (isFunctionNode(arg0)) return "GET";
+	if (arg0?.type === "ObjectExpression") {
+		let method;
+		let hasInput = false;
+		for (const prop of arg0.properties ?? []) {
+			if (prop.type !== "Property") continue;
+			const key = prop.key?.type === "Identifier" ? prop.key.name : prop.key?.value;
+			if (key === "method" && isStringLiteral(prop.value)) method = prop.value.value;
+			else if (key === "input") hasInput = true;
+		}
+		if (method === "GET" && hasInput) throw new Error(`[analog] serverFn "${name}" in ${fileId} declares method: 'GET' with an input schema; GET carries no body. Use POST or drop the input.`);
+		return method ?? (hasInput ? "POST" : "GET");
+	}
+	if (arg0 && args.length >= 2) return "POST";
+	throw new Error(`[analog] serverFn "${name}" in ${fileId} must be called as serverFn(handler), serverFn(schema, handler), or serverFn(config, handler).`);
+}
+function isFunctionNode(node) {
+	return node?.type === "ArrowFunctionExpression" || node?.type === "FunctionExpression";
+}
+function isStringLiteral(node) {
+	return node?.type === "Literal" && typeof node.value === "string";
+}
+/** Every `serverFn(...)` call anywhere in the module, not just exported ones. */
+function countServerFnCalls(node, names) {
+	if (!node || typeof node !== "object") return 0;
+	if (Array.isArray(node)) return node.reduce((total, child) => total + countServerFnCalls(child, names), 0);
+	const record = node;
+	let count = 0;
+	if (record.type === "CallExpression") {
+		const callee = record["callee"];
+		if (callee?.type === "Identifier" && callee.name && names.has(callee.name)) count += 1;
+	}
+	for (const key of Object.keys(record)) count += countServerFnCalls(record[key], names);
+	return count;
+}
+//#endregion
+export { scrubServerFnModule };
+
+//# sourceMappingURL=server-fn-client-transform.js.map

package/src/lib/server-fn-client-transform.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server-fn-client-transform.js","names":[],"sources":["../../../src/lib/server-fn-client-transform.ts"],"sourcesContent":["import { parseSync } from 'oxc-parser';\n// Light subpath (no vite/nitro barrel): the built scrub is loaded outside a\n// build too, so it must not pull the plugin graph in.\nimport { deriveServerFnId } from './server-fn-id.js';\n\n/**\n * Client-build scrub + proxy generation for server functions.\n *\n * On the client build a `*.server.ts` module must not carry server handler\n * bodies (which `inject()` server services, read the request, hit the database).\n * But the client still imports the named `serverFn` exports to dispatch them.\n * This transform regenerates the module so each `export const NAME = serverFn(\n * config, handler)` becomes a call to the client-safe `createServerFnRef`\n * factory — keeping the `{ id, url, method }` metadata `injectServerFn` needs,\n * dropping the handler and every server-only import. Because the regenerated\n * module references nothing else, the server code tree-shakes away entirely.\n *\n * Returns the new module source, or `null` when the module defines no server\n * function (the caller falls back to the page-endpoint scrub for those).\n */\nexport interface ServerFnProxy {\n  name: string;\n  id: string;\n  method: 'GET' | 'POST';\n}\n\nexport interface ScrubResult {\n  code: string;\n  proxies: ServerFnProxy[];\n  hadDefaultExport: boolean;\n}\n\nconst SERVER_FN_SOURCE = '@analogjs/router/server';\n\nexport function scrubServerFnModule(\n  code: string,\n  fileId = 'file.ts',\n): ScrubResult | null {\n  // Cheap bail-out before parsing: no `serverFn` token, nothing to do.\n  if (!code.includes('serverFn')) {\n    return null;\n  }\n\n  const { program } = parseSync(fileId, code);\n  const body = (program as { body: any[] }).body;\n\n  const serverFnLocalNames = collectServerFnLocalNames(body);\n  const hadDefaultExport = body.some(\n    (node) => node.type === 'ExportDefaultDeclaration',\n  );\n\n  const proxies: ServerFnProxy[] = [];\n  for (const node of body) {\n    if (\n      node.type !== 'ExportNamedDeclaration' ||\n      node.declaration?.type !== 'VariableDeclaration'\n    ) {\n      continue;\n    }\n    for (const declarator of node.declaration.declarations) {\n      if (\n        declarator.id?.type !== 'Identifier' ||\n        declarator.init?.type !== 'CallExpression' ||\n        declarator.init.callee?.type !== 'Identifier' ||\n        !serverFnLocalNames.has(declarator.init.callee.name)\n      ) {\n        continue;\n      }\n      proxies.push(\n        toProxy(declarator.id.name, declarator.init.arguments ?? [], fileId),\n      );\n    }\n  }\n\n  // Every `serverFn(...)` call in the module must have become a proxy. If one\n  // did not, the module uses a shape this transform cannot rewrite (e.g.\n  // `const fn = serverFn(...); export { fn };`) and returning `null` would leave\n  // it untouched — shipping the handler and its server imports to the browser.\n  // Fail the build instead: a scrub that silently opts out is a code leak.\n  const callCount = countServerFnCalls(program, serverFnLocalNames);\n  if (callCount > proxies.length) {\n    throw new Error(\n      `[analog] ${fileId}: found ${callCount} serverFn call(s) but could only rewrite ${proxies.length} for the client build. ` +\n        `Server functions must be declared as a directly exported const — \\`export const name = serverFn(…)\\` — so the handler can be stripped from the browser bundle.`,\n    );\n  }\n\n  if (proxies.length === 0) {\n    return null;\n  }\n\n  const lines = [\n    `import { createServerFnRef } from '@analogjs/router';`,\n    '',\n    ...proxies.map(\n      (p) =>\n        `export const ${p.name} = createServerFnRef({ id: ${JSON.stringify(\n          p.id,\n        )}, method: ${JSON.stringify(p.method)} });`,\n    ),\n  ];\n  // A file that is also a page endpoint keeps the load-shim the router expects.\n  if (hadDefaultExport) {\n    lines.push('', 'export default undefined;');\n  }\n\n  return { code: lines.join('\\n') + '\\n', proxies, hadDefaultExport };\n}\n\n/** Local identifier(s) `serverFn` is imported under from `@analogjs/router/server`. */\nfunction collectServerFnLocalNames(body: any[]): Set<string> {\n  const names = new Set<string>();\n  for (const node of body) {\n    if (\n      node.type !== 'ImportDeclaration' ||\n      node.source?.value !== SERVER_FN_SOURCE\n    ) {\n      continue;\n    }\n    for (const spec of node.specifiers ?? []) {\n      if (\n        spec.type === 'ImportSpecifier' &&\n        spec.imported?.name === 'serverFn'\n      ) {\n        names.add(spec.local.name);\n      }\n    }\n  }\n  // Fallback: if the module never imported it (unusual), still match the\n  // conventional name so a mis-resolved import doesn't leak server code.\n  if (names.size === 0) {\n    names.add('serverFn');\n  }\n  return names;\n}\n\nfunction toProxy(name: string, args: any[], fileId: string): ServerFnProxy {\n  const method = methodForCall(name, args, fileId);\n  // The id is derived, never read from source — same algorithm the server\n  // registration uses, so client proxy and server route always match.\n  return { name, id: deriveServerFnId(fileId, name), method };\n}\n\n/**\n * Resolve the HTTP method from the call shape, matching the runtime overloads:\n * `serverFn(handler)` ⇒ GET, `serverFn(schema, handler)` ⇒ POST,\n * `serverFn(config, handler)` ⇒ config-driven.\n */\nfunction methodForCall(\n  name: string,\n  args: any[],\n  fileId: string,\n): 'GET' | 'POST' {\n  const arg0 = args[0];\n\n  // serverFn(handler) — input-less GET.\n  if (isFunctionNode(arg0)) return 'GET';\n\n  // serverFn(config, handler) — read method/input off the object.\n  if (arg0?.type === 'ObjectExpression') {\n    let method: 'GET' | 'POST' | undefined;\n    let hasInput = false;\n    for (const prop of arg0.properties ?? []) {\n      if (prop.type !== 'Property') continue;\n      const key =\n        prop.key?.type === 'Identifier' ? prop.key.name : prop.key?.value;\n      if (key === 'method' && isStringLiteral(prop.value)) {\n        method = prop.value.value as 'GET' | 'POST';\n      } else if (key === 'input') {\n        hasInput = true;\n      }\n    }\n    if (method === 'GET' && hasInput) {\n      throw new Error(\n        `[analog] serverFn \"${name}\" in ${fileId} declares method: 'GET' with an input schema; GET carries no body. Use POST or drop the input.`,\n      );\n    }\n    return method ?? (hasInput ? 'POST' : 'GET');\n  }\n\n  // serverFn(schema, handler) — a schema ⇒ POST + input.\n  if (arg0 && args.length >= 2) return 'POST';\n\n  throw new Error(\n    `[analog] serverFn \"${name}\" in ${fileId} must be called as serverFn(handler), serverFn(schema, handler), or serverFn(config, handler).`,\n  );\n}\n\nfunction isFunctionNode(node: any): boolean {\n  return (\n    node?.type === 'ArrowFunctionExpression' ||\n    node?.type === 'FunctionExpression'\n  );\n}\n\nfunction isStringLiteral(\n  node: any,\n): node is { type: 'Literal'; value: string } {\n  return node?.type === 'Literal' && typeof node.value === 'string';\n}\n\n/** Every `serverFn(...)` call anywhere in the module, not just exported ones. */\nfunction countServerFnCalls(node: unknown, names: Set<string>): number {\n  if (!node || typeof node !== 'object') {\n    return 0;\n  }\n  if (Array.isArray(node)) {\n    return node.reduce(\n      (total, child) => total + countServerFnCalls(child, names),\n      0,\n    );\n  }\n\n  const record = node as Record<string, unknown> & { type?: string };\n  let count = 0;\n  if (record.type === 'CallExpression') {\n    const callee = record['callee'] as { type?: string; name?: string };\n    if (\n      callee?.type === 'Identifier' &&\n      callee.name &&\n      names.has(callee.name)\n    ) {\n      count += 1;\n    }\n  }\n  for (const key of Object.keys(record)) {\n    count += countServerFnCalls(record[key], names);\n  }\n  return count;\n}\n"],"mappings":"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"}

package/src/lib/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/server-fn-id.js

@@ -0,0 +1,37 @@
+import { relative } from "node:path";
+import { createHash } from "node:crypto";
+//#region packages/platform/src/lib/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=server-fn-id.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"server-fn-id.js","names":[],"sources":["../../../src/lib/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"}

package/src/lib/ssr/defer-streaming-plugin.d.ts

@@ -0,0 +1,65 @@
+import type { Plugin } from "vite";
+/**
+* Minimum Angular major whose compiled `@angular/core` FESM matches the
+* streaming patch anchors. Incremental hydration is a stable public API from
+* v20 (`withIncrementalHydration`, `@publicApi 20.0`), but v20's FESM inlines
+* the injection anchor's `DeferBlockStateEnd` profiler event to its numeric
+* ordinal, whereas v21+ keeps the symbolic `ProfilerEvent.DeferBlockStateEnd`
+* form the anchor matches on. Keying on the literal ordinal would be fragile
+* (enum values shift between versions), so v21 is the floor.
+*/
+export declare const MIN_STREAMING_ANGULAR_MAJOR = 21;
+/**
+* Whether the streaming SSR patch can be applied to the installed Angular.
+* A `null` major (version undetectable) returns `true`: don't block on a failed
+* detection — the plugin's anchor-drift detection catches a real mismatch at
+* build time and falls back to buffered rendering.
+*/
+export declare function streamingSupportedOnAngular(major: number | null): boolean;
+/**
+* Pure transform that injects the streaming-SSR per-block resolution hook into
+* `@angular/core`'s compiled output. It is the same class of transform as
+* `i18nDefRegistryPlugin` in ./ssr-build-plugin — a string patch of Angular's
+* bundle applied only to SSR builds. Exported separately so it can be unit
+* tested against a bundle string.
+*
+* Two edits, both keyed on single-occurrence anchors in the module that holds
+* the defer runtime:
+*   1. Inside `applyDeferBlockState`, fire `globalThis.__analogSsrDeferCapture`
+*      when a `@defer` block reaches `Complete` on the server, passing the
+*      block's live `lContainer` — this is the per-block resolution signal a
+*      streaming renderer consumes.
+*   2. Expose `collectNativeNodesInLContainer` via `globalThis.__analogSsrInternals`
+*      so the renderer can serialize a block's subtree.
+*
+* Returns `null` when the module is not the one carrying the defer runtime, so
+* it is a no-op on every other Angular module.
+*/
+export declare function injectDeferStreamingHook(code: string): string | null;
+/**
+* Classify an `@angular/core` module for the streaming patch. The patch anchors
+* on internal symbol names, so when Angular changes those the transform would
+* otherwise become a silent no-op and streaming would degrade to buffered with
+* no signal. This distinguishes "not the target module" (skip quietly) from
+* "this IS the `@defer` runtime module but the anchors drifted" (worth warning).
+*/
+export declare function inspectAngularCoreModule(code: string): {
+	kind: "not-target";
+} | {
+	kind: "patchable";
+} | {
+	kind: "drifted";
+	reason: string;
+};
+/**
+* Vite plugin that applies {@link injectDeferStreamingHook} to `@angular/core`
+* during SSR builds, so `@analogjs/router`'s `renderStream` can flush `@defer`
+* blocks as they resolve on the server — without hand-patching node_modules.
+*
+* Only active for SSR. Mirrors the enforce/filter/ssr-gate shape of
+* `i18nDefRegistryPlugin`. If the `@defer` runtime module is found but its
+* anchors have drifted (Angular changed internals), or if it is never
+* encountered at all, the plugin warns rather than silently producing a build
+* that falls back to buffered rendering.
+*/
+export declare function deferStreamingPlugin(): Plugin;

package/src/lib/ssr/inject-html-plugin.d.ts

@@ -1,2 +1,2 @@
-import { Plugin } from 'vite';
+import { Plugin } from "vite";
 export declare function injectHTMLPlugin(): Plugin[];