@analogjs/platform 3.0.0-alpha.8 → 3.0.0-alpha.80

package/src/lib/router-plugin.js

@@ -1,192 +1,236 @@
-import { normalizePath } from 'vite';
-import { globSync } from 'tinyglobby';
-import { resolve } from 'node:path';
+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";
+//#region packages/platform/src/lib/router-plugin.ts
 /**
- * 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 function routerPlugin(options) {
-    const workspaceRoot = normalizePath(options?.workspaceRoot ?? process.cwd());
-    let config;
-    let root;
-    const isRouteLikeFile = (path) => path.includes(`routes`) ||
-        path.includes(`pages`) ||
-        path.includes('content');
-    const invalidateFileModules = (server, path) => {
-        const normalizedPath = normalizePath(path);
-        // A newly added page can be discovered before its final contents settle.
-        // Invalidate the page module itself so later edits don't keep serving the
-        // first incomplete transform from Vite's module graph.
-        const fileModules = server.moduleGraph.getModulesByFile?.(normalizedPath) ??
-            server.moduleGraph.fileToModulesMap.get(normalizedPath);
-        fileModules?.forEach((mod) => {
-            server.moduleGraph.invalidateModule(mod);
-            mod.importers.forEach((imp) => {
-                server.moduleGraph.invalidateModule(imp);
-            });
-        });
-    };
-    return [
-        {
-            name: 'analogjs-router-invalidate-routes',
-            configureServer(server) {
-                /**
-                 * Invalidates route modules when files are added or deleted.
-                 * This is a workaround for Vite's HMR limitations with dynamic imports.
-                 *
-                 * @param path The file path that was added or deleted
-                 */
-                function invalidateRoutes(path) {
-                    if (!isRouteLikeFile(path)) {
-                        return;
-                    }
-                    invalidateFileModules(server, path);
-                    server.moduleGraph.fileToModulesMap.forEach((mods) => {
-                        mods.forEach((mod) => {
-                            if (mod.id?.includes('analogjs') && mod.id?.includes('fesm')) {
-                                server.moduleGraph.invalidateModule(mod);
-                                mod.importers.forEach((imp) => {
-                                    server.moduleGraph.invalidateModule(imp);
-                                });
-                            }
-                        });
-                    });
-                    server.ws.send({
-                        type: 'full-reload',
-                    });
-                }
-                server.watcher.on('add', invalidateRoutes);
-                server.watcher.on('change', invalidateRoutes);
-                server.watcher.on('unlink', invalidateRoutes);
-            },
-        },
-        {
-            name: 'analog-glob-routes',
-            // enforce: 'post' ensures this transform runs AFTER the Angular compiler
-            // plugin, which replaces module content with its own compiled output.
-            // Without this, the Angular plugin would overwrite the route replacements.
-            enforce: 'post',
-            config(_config) {
-                config = _config;
-                root = normalizePath(resolve(workspaceRoot, config.root || '.') || '.');
-            },
-            /**
-             * Transforms code to replace ANALOG_ROUTE_FILES and ANALOG_CONTENT_ROUTE_FILES
-             * placeholders with actual dynamic imports of discovered route and content files.
-             *
-             * @param code The source code to transform
-             * @returns Transformed code with dynamic imports or undefined if no transformation needed
-             */
-            // Vite 8 / Rolldown filtered transform: the `filter.code` substring
-            // pre-filter lets the bundler skip modules that don't contain the
-            // marker.  'ANALOG_ROUTE_FILES' also matches 'ANALOG_CONTENT_ROUTE_FILES'
-            // (substring), so a single filter covers both placeholders.
-            transform: {
-                filter: {
-                    code: 'ANALOG_ROUTE_FILES',
-                },
-                handler(code) {
-                    if (code.includes('ANALOG_ROUTE_FILES') ||
-                        code.includes('ANALOG_CONTENT_ROUTE_FILES')) {
-                        // Discover route files using tinyglobby
-                        // NOTE: { absolute: true } returns absolute paths for ALL 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 });
-                        // Discover content files using tinyglobby
-                        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 });
-                        let result = code.replace('ANALOG_ROUTE_FILES = {};', `
+* 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
+*/
+function routerPlugin(options) {
+	const workspaceRoot = normalizePath(options?.workspaceRoot ?? process.env["NX_WORKSPACE_ROOT"] ?? process.cwd());
+	let config;
+	let root;
+	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) => {
+			server.moduleGraph.invalidateModule(mod);
+			mod.importers.forEach((imp) => {
+				server.moduleGraph.invalidateModule(imp);
+			});
+		});
+	};
+	return [
+		{
+			name: "analogjs-router-invalidate-routes",
+			configureServer(server) {
+				/**
+				* Invalidates route modules when files are added or deleted.
+				* This is a workaround for Vite's HMR limitations with dynamic imports.
+				*
+				* @param path The file path that was added or deleted
+				*/
+				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")) {
+								server.moduleGraph.invalidateModule(mod);
+								mod.importers.forEach((imp) => {
+									server.moduleGraph.invalidateModule(imp);
+								});
+							}
+						});
+					});
+					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", (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));
+			}
+		},
+		{
+			name: "analog-glob-routes",
+			enforce: "post",
+			config(_config) {
+				config = _config;
+				root = normalizePath(resolve(workspaceRoot, config.root || ".") || ".");
+			},
+			transform: {
+				filter: { code: "_ROUTE_FILES" },
+				handler(code) {
+					if (code.includes("ANALOG_ROUTE_FILES") || code.includes("ANALOG_CONTENT_ROUTE_FILES")) {
+						const routeFiles = discoverRouteFiles();
+						const contentRouteFiles = discoverContentRouteFiles();
+						let result = code.replace("ANALOG_ROUTE_FILES = {};", `
               ANALOG_ROUTE_FILES = {${routeFiles.map((module) => {
-                            // CRITICAL: tinyglobby returns absolute paths, but we need relative paths for project files
-                            // to match expected output format. Library files keep absolute paths.
-                            const key = module.startsWith(root)
-                                ? module.replace(root, '')
-                                : module;
-                            return `"${key}": () => import('${module}')`;
-                        })}};
+							return `"${getModuleKey(module)}": () => import('${module}')`;
+						})}};
             `);
-                        result = result.replace('ANALOG_CONTENT_ROUTE_FILES = {};', `
+						result = result.replace("ANALOG_CONTENT_ROUTE_FILES = {};", `
             ANALOG_CONTENT_ROUTE_FILES = {${contentRouteFiles.map((module) => {
-                            // Same path normalization as route files
-                            const key = module.startsWith(root)
-                                ? module.replace(root, '')
-                                : module;
-                            return `"${key}": () => import('${module}?analog-content-file=true').then(m => m.default)`;
-                        })}};
+							return `"${getModuleKey(module)}": () => import('${module}?analog-content-file=true').then(m => m.default)`;
+						})}};
             `);
-                        return {
-                            code: result,
-                            map: { mappings: '' },
-                        };
-                    }
-                    return;
-                },
-            },
-        },
-        {
-            name: 'analog-glob-endpoints',
-            // enforce: 'post' ensures this transform runs AFTER the Angular compiler
-            // plugin, which replaces module content with its own compiled output.
-            // Without this, the Angular plugin would overwrite the endpoint replacements.
-            enforce: 'post',
-            /**
-             * Transforms code to replace ANALOG_PAGE_ENDPOINTS placeholder
-             * with actual dynamic imports of discovered server endpoint files.
-             *
-             * @param code The source code to transform
-             * @returns Transformed code with dynamic imports or undefined if no transformation needed
-             */
-            transform: {
-                filter: {
-                    code: 'ANALOG_PAGE_ENDPOINTS',
-                },
-                handler(code) {
-                    if (code.includes('ANALOG_PAGE_ENDPOINTS')) {
-                        // Discover server endpoint files using tinyglobby
-                        const endpointFiles = globSync([
-                            `${root}/src/app/pages/**/*.server.ts`,
-                            ...(options?.additionalPagesDirs || []).map((glob) => `${workspaceRoot}${glob}/**/*.server.ts`),
-                        ], { dot: true, absolute: true });
-                        const result = code.replace('ANALOG_PAGE_ENDPOINTS = {};', `
+						result = result.replace("ANALOG_CONTENT_FILE_COUNT = 0", `ANALOG_CONTENT_FILE_COUNT = ${contentRouteFiles.length}`);
+						return {
+							code: result,
+							map: { mappings: "" }
+						};
+					}
+				}
+			}
+		},
+		{
+			name: "analog-glob-endpoints",
+			enforce: "post",
+			transform: {
+				filter: { code: "ANALOG_PAGE_ENDPOINTS" },
+				handler(code) {
+					if (code.includes("ANALOG_PAGE_ENDPOINTS")) {
+						const endpointFiles = discoverEndpointFiles();
+						return {
+							code: code.replace("ANALOG_PAGE_ENDPOINTS = {};", `
               ANALOG_PAGE_ENDPOINTS = {${endpointFiles.map((module) => {
-                            // Same path normalization for consistency
-                            const key = module.startsWith(root)
-                                ? module.replace(root, '')
-                                : module;
-                            return `"${key}": () => import('${module}')`;
-                        })}};
-            `);
-                        return {
-                            code: result,
-                            map: { mappings: '' },
-                        };
-                    }
-                    return;
-                },
-            },
-        },
-    ];
+								return `"${getModuleKey(module)}": () => import('${module}')`;
+							})}};
+            `),
+							map: { mappings: "" }
+						};
+					}
+				}
+			}
+		}
+	];
 }
-//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoicm91dGVyLXBsdWdpbi5qcyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uLy4uLy4uLy4uL3BhY2thZ2VzL3BsYXRmb3JtL3NyYy9saWIvcm91dGVyLXBsdWdpbi50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFBQSxPQUFPLEVBQUUsYUFBYSxFQUFxQyxNQUFNLE1BQU0sQ0FBQztBQUN4RSxPQUFPLEVBQUUsUUFBUSxFQUFFLE1BQU0sWUFBWSxDQUFDO0FBQ3RDLE9BQU8sRUFBRSxPQUFPLEVBQUUsTUFBTSxXQUFXLENBQUM7QUFJcEM7Ozs7Ozs7Ozs7Ozs7Ozs7O0dBaUJHO0FBQ0gsTUFBTSxVQUFVLFlBQVksQ0FBQyxPQUFpQjtJQUM1QyxNQUFNLGFBQWEsR0FBRyxhQUFhLENBQUMsT0FBTyxFQUFFLGFBQWEsSUFBSSxPQUFPLENBQUMsR0FBRyxFQUFFLENBQUMsQ0FBQztJQUM3RSxJQUFJLE1BQWtCLENBQUM7SUFDdkIsSUFBSSxJQUFZLENBQUM7SUFDakIsTUFBTSxlQUFlLEdBQUcsQ0FBQyxJQUFZLEVBQUUsRUFBRSxDQUN2QyxJQUFJLENBQUMsUUFBUSxDQUFDLFFBQVEsQ0FBQztRQUN2QixJQUFJLENBQUMsUUFBUSxDQUFDLE9BQU8sQ0FBQztRQUN0QixJQUFJLENBQUMsUUFBUSxDQUFDLFNBQVMsQ0FBQyxDQUFDO0lBQzNCLE1BQU0scUJBQXFCLEdBQUcsQ0FBQyxNQUFxQixFQUFFLElBQVksRUFBRSxFQUFFO1FBQ3BFLE1BQU0sY0FBYyxHQUFHLGFBQWEsQ0FBQyxJQUFJLENBQUMsQ0FBQztRQUMzQyx5RUFBeUU7UUFDekUsMEVBQTBFO1FBQzFFLHVEQUF1RDtRQUN2RCxNQUFNLFdBQVcsR0FDZixNQUFNLENBQUMsV0FBVyxDQUFDLGdCQUFnQixFQUFFLENBQUMsY0FBYyxDQUFDO1lBQ3JELE1BQU0sQ0FBQyxXQUFXLENBQUMsZ0JBQWdCLENBQUMsR0FBRyxDQUFDLGNBQWMsQ0FBQyxDQUFDO1FBRTFELFdBQVcsRUFBRSxPQUFP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
+//#endregion
+export { routerPlugin };
+
+//# sourceMappingURL=router-plugin.js.map

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

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