@analogjs/vite-plugin-nitro 3.0.0-alpha.7 → 3.0.0-alpha.70

package/src/lib/utils/get-content-files.js.map

@@ -1 +1 @@
-{"version":3,"file":"get-content-files.js","sourceRoot":"","sources":["../../../../../../packages/vite-plugin-nitro/src/lib/utils/get-content-files.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpD,OAAO,EAAE,aAAa,EAAE,MAAM,MAAM,CAAC;AACrC,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAItC,MAAM,OAAO,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAE/C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqDG;AACH,MAAM,UAAU,sCAAsC,CACpD,aAAqB,EACrB,OAAe,EACf,IAAY;IAEZ,2CAA2C;IAC3C,8DAA8D;IAC9D,MAAM,EAAE,GAAG,OAAO,CAAC,cAAc,CAAC,CAAC;IAEnC,+DAA+D;IAC/D,MAAM,IAAI,GAAG,aAAa,CAAC,OAAO,CAAC,aAAa,EAAE,OAAO,CAAC,CAAC,CAAC;IAE5D,kEAAkE;IAClE,MAAM,WAAW,GAAG,aAAa,CAAC,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC;IAEpE,wDAAwD;IACxD,yDAAyD;IACzD,MAAM,YAAY,GAAa,QAAQ,CAAC,CAAC,GAAG,IAAI,IAAI,WAAW,IAAI,CAAC,EAAE;QACpE,GAAG,EAAE,IAAI;QACT,QAAQ,EAAE,IAAI;KACf,CAAC,CAAC;IAEH,4EAA4E;IAC5E,MAAM,iBAAiB,GAA2B,YAAY,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE;QACvE,uCAAuC;QACvC,MAAM,YAAY,GAAG,YAAY,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC;QAE7C,2CAA2C;QAC3C,MAAM,GAAG,GAAG,EAAE,CAAC,YAAY,CAAC,CAAC;QAE7B,MAAM,QAAQ,GAAG,aAAa,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;QAEpD,MAAM,KAAK,GAAG,QAAQ,CAAC,KAAK,CAAC,0BAA0B,CAAC,CAAC;QACzD,IAAI,IAAI,GAAG,EAAE,CAAC;QACd,IAAI,SAAS,GAAG,EAAE,CAAC;QACnB,IAAI,KAAK,EAAE,CAAC;YACV,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,8BAA8B;YAC/C,SAAS,GAAG,KAAK,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,iDAAiD;QAC/E,CAAC;QAED,uDAAuD;QACvD,OAAO;YACL,IAAI;YACJ,SAAS;YACT,IAAI,EAAE,WAAW;YACjB,UAAU,EAAE,GAAG,CAAC,UAAiD;YACjE,OAAO,EAAE,YAAY;SACtB,CAAC;IACJ,CAAC,CAAC,CAAC;IAEH,OAAO,iBAAiB,CAAC;AAC3B,CAAC"}
+{"version":3,"file":"get-content-files.js","names":[],"sources":["../../../../src/lib/utils/get-content-files.ts"],"sourcesContent":["import { readFileSync } from 'node:fs';\nimport { join, relative, resolve } from 'node:path';\nimport { normalizePath } from 'vite';\nimport { createRequire } from 'node:module';\nimport { globSync } from 'tinyglobby';\n\nimport { PrerenderContentFile } from '../options';\n\nconst require = createRequire(import.meta.url);\n\n/**\n * Discovers content files with front matter and extracts metadata for prerendering.\n *\n * This function:\n * 1. Discovers all content files matching the specified glob pattern\n * 2. Reads each file and parses front matter metadata\n * 3. Extracts file name, extension, and path information\n * 4. Returns structured data for prerendering content pages\n *\n * @param workspaceRoot The workspace root directory path\n * @param rootDir The project root directory relative to workspace\n * @param glob The glob pattern to match content files (e.g., 'content/blog')\n * @returns Array of PrerenderContentFile objects with metadata and front matter\n *\n * Example usage:\n * const contentFiles = getMatchingContentFilesWithFrontMatter(\n *   '/workspace',\n *   'apps/my-app',\n *   'content/blog'\n * );\n *\n * Sample discovered file paths:\n * - /workspace/apps/my-app/content/blog/first-post.md\n * - /workspace/apps/my-app/content/blog/2024/01/hello-world.md\n * - /workspace/apps/my-app/content/blog/tech/angular-v17.mdx\n * - /workspace/apps/my-app/content/blog/about/index.md\n *\n * Sample output structure:\n * {\n *   name: 'first-post',\n *   extension: 'md',\n *   path: 'content/blog',\n *   attributes: { title: 'My First Post', date: '2024-01-01', tags: ['intro'] }\n * }\n *\n * tinyglobby vs fast-glob comparison:\n * - Both support the same glob patterns for file discovery\n * - Both are efficient for finding content files\n * - tinyglobby is now used instead of fast-glob\n * - tinyglobby provides similar functionality with smaller bundle size\n * - tinyglobby's globSync returns absolute paths when absolute: true is set\n *\n * Front matter parsing:\n * - Uses front-matter library to parse YAML/TOML front matter\n * - Extracts metadata like title, date, tags, author, etc.\n * - Supports both YAML (---) and TOML (+++) delimiters\n * - Returns structured attributes for prerendering\n *\n * File path processing:\n * - Normalizes paths for cross-platform compatibility\n * - Extracts file name without extension\n * - Determines file extension for content type handling\n * - Maintains relative path structure for routing\n */\nexport function getMatchingContentFilesWithFrontMatter(\n  workspaceRoot: string,\n  rootDir: string,\n  glob: string,\n  recursive = false,\n): PrerenderContentFile[] {\n  // Dynamically require front-matter library\n  // eslint-disable-next-line @typescript-eslint/no-var-requires\n  const fm = require('front-matter');\n\n  // Normalize the project root path for consistent path handling\n  const root = normalizePath(resolve(workspaceRoot, rootDir));\n\n  // Resolve the content directory path relative to the project root\n  const resolvedDir = normalizePath(relative(root, join(root, glob)));\n\n  // Discover all content files in the specified directory.\n  // Default pattern matches only top-level files; recursive opt-in walks subdirectories.\n  const pattern = recursive\n    ? `${root}/${resolvedDir}/**/*`\n    : `${root}/${resolvedDir}/*`;\n  const contentFiles: string[] = globSync([pattern], {\n    dot: true,\n    absolute: true,\n    onlyFiles: true,\n  });\n\n  const dirPrefix = `${root}/${resolvedDir}`;\n\n  // Process each discovered content file to extract metadata and front matter\n  const mappedFilesWithFm: PrerenderContentFile[] = contentFiles.map((f) => {\n    // Read the file contents as UTF-8 text\n    const fileContents = readFileSync(f, 'utf8');\n\n    // Parse front matter from the file content\n    const raw = fm(fileContents);\n\n    const filepath = normalizePath(f).replace(root, '');\n\n    const match = filepath.match(/\\/([^/.]+)(\\.([^/.]+))?$/);\n    let name = '';\n    let extension = '';\n    if (match) {\n      name = match[1]; // File name without extension\n      extension = match[3] || ''; // File extension or empty string if no extension\n    }\n\n    // Path of the file's directory relative to the configured contentDir.\n    // For top-level files this is an empty string; for nested files it\n    // gives transforms enough context to disambiguate identically-named\n    // files (e.g. docs/a/post.md vs docs/b/post.md).\n    const relativeDir = normalizePath(relative(dirPrefix, f));\n    const lastSlash = relativeDir.lastIndexOf('/');\n    const relativePath =\n      lastSlash === -1 ? '' : relativeDir.slice(0, lastSlash);\n\n    // Return structured content file data for prerendering\n    return {\n      name,\n      extension,\n      path: resolvedDir,\n      attributes: raw.attributes as { attributes: Record<string, any> },\n      content: fileContents,\n      relativePath,\n    };\n  });\n\n  return mappedFilesWithFm;\n}\n"],"mappings":";;;;;;AAQA,IAAM,UAAU,cAAc,OAAO,KAAK,IAAI;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAwD9C,SAAgB,uCACd,eACA,SACA,MACA,YAAY,OACY;CAGxB,MAAM,KAAK,QAAQ,eAAe;CAGlC,MAAM,OAAO,cAAc,QAAQ,eAAe,QAAQ,CAAC;CAG3D,MAAM,cAAc,cAAc,SAAS,MAAM,KAAK,MAAM,KAAK,CAAC,CAAC;CAOnE,MAAM,eAAyB,SAAS,CAHxB,YACZ,GAAG,KAAK,GAAG,YAAY,SACvB,GAAG,KAAK,GAAG,YAAY,IACsB,EAAE;EACjD,KAAK;EACL,UAAU;EACV,WAAW;EACZ,CAAC;CAEF,MAAM,YAAY,GAAG,KAAK,GAAG;AAwC7B,QArCkD,aAAa,KAAK,MAAM;EAExE,MAAM,eAAe,aAAa,GAAG,OAAO;EAG5C,MAAM,MAAM,GAAG,aAAa;EAI5B,MAAM,QAFW,cAAc,EAAE,CAAC,QAAQ,MAAM,GAAG,CAE5B,MAAM,2BAA2B;EACxD,IAAI,OAAO;EACX,IAAI,YAAY;AAChB,MAAI,OAAO;AACT,UAAO,MAAM;AACb,eAAY,MAAM,MAAM;;EAO1B,MAAM,cAAc,cAAc,SAAS,WAAW,EAAE,CAAC;EACzD,MAAM,YAAY,YAAY,YAAY,IAAI;EAC9C,MAAM,eACJ,cAAc,KAAK,KAAK,YAAY,MAAM,GAAG,UAAU;AAGzD,SAAO;GACL;GACA;GACA,MAAM;GACN,YAAY,IAAI;GAChB,SAAS;GACT;GACD;GACD"}

package/src/lib/utils/get-page-handlers.d.ts

@@ -1,62 +1,59 @@
-import type { NitroEventHandler } from 'nitro/types';
+import type { NitroEventHandler } from "nitro/types";
 type GetHandlersArgs = {
-    workspaceRoot: string;
-    sourceRoot: string;
-    rootDir: string;
-    additionalPagesDirs?: string[];
-    hasAPIDir?: boolean;
+	workspaceRoot: string;
+	sourceRoot: string;
+	rootDir: string;
+	additionalPagesDirs?: string[];
 };
 /**
- * Discovers and generates Nitro event handlers for server-side page routes.
- *
- * This function:
- * 1. Discovers all .server.ts files in the app/pages directory and additional pages directories
- * 2. Converts file paths to route patterns using Angular-style route syntax
- * 3. Generates Nitro event handlers with proper route mapping and lazy loading
- * 4. Handles dynamic route parameters and catch-all routes
- *
- * @param workspaceRoot The workspace root directory path
- * @param sourceRoot The source directory path (e.g., 'src')
- * @param rootDir The project root directory relative to workspace
- * @param additionalPagesDirs Optional array of additional pages directories to scan
- * @param hasAPIDir Whether the project has an API directory (affects route prefixing)
- * @returns Array of NitroEventHandler objects with handler paths and route patterns
- *
- * Example usage:
- * const handlers = getPageHandlers({
- *   workspaceRoot: '/workspace',
- *   sourceRoot: 'src',
- *   rootDir: 'apps/my-app',
- *   additionalPagesDirs: ['/libs/shared/pages'],
- *   hasAPIDir: true
- * });
- *
- * Sample discovered file paths:
- * - /workspace/apps/my-app/src/app/pages/index.server.ts
- * - /workspace/apps/my-app/src/app/pages/users/[id].server.ts
- * - /workspace/apps/my-app/src/app/pages/products/[...slug].server.ts
- * - /workspace/apps/my-app/src/app/pages/(auth)/login.server.ts
- *
- * Route transformation examples:
- * - index.server.ts → /_analog/pages/index
- * - users/[id].server.ts → /_analog/pages/users/:id
- * - products/[...slug].server.ts → /_analog/pages/products/**:slug
- * - (auth)/login.server.ts → /_analog/pages/-auth-/login
- *
- * tinyglobby vs fast-glob comparison:
- * - Both support the same glob patterns for file discovery
- * - Both are efficient for finding server-side page files
- * - tinyglobby is now used instead of fast-glob
- * - tinyglobby provides similar functionality with smaller bundle size
- * - tinyglobby's globSync returns absolute paths when absolute: true is set
- *
- * Route transformation rules:
- * 1. Removes .server.ts extension
- * 2. Converts [param] to :param for dynamic routes
- * 3. Converts [...param] to **:param for catch-all routes
- * 4. Converts (group) to -group- for route groups
- * 5. Converts dots to forward slashes
- * 6. Prefixes with /_analog/pages and optionally /api
- */
-export declare function getPageHandlers({ workspaceRoot, sourceRoot, rootDir, additionalPagesDirs, hasAPIDir, }: GetHandlersArgs): NitroEventHandler[];
+* Discovers and generates Nitro event handlers for server-side page routes.
+*
+* This function:
+* 1. Discovers all .server.ts files in the app/pages directory and additional pages directories
+* 2. Converts file paths to route patterns using Angular-style route syntax
+* 3. Generates Nitro event handlers with proper route mapping and lazy loading
+* 4. Handles dynamic route parameters and catch-all routes
+*
+* @param workspaceRoot The workspace root directory path
+* @param sourceRoot The source directory path (e.g., 'src')
+* @param rootDir The project root directory relative to workspace
+* @param additionalPagesDirs Optional array of additional pages directories to scan
+* @returns Array of NitroEventHandler objects with handler paths and route patterns
+*
+* Example usage:
+* const handlers = getPageHandlers({
+*   workspaceRoot: '/workspace',
+*   sourceRoot: 'src',
+*   rootDir: 'apps/my-app',
+*   additionalPagesDirs: ['/libs/shared/pages'],
+* });
+*
+* Sample discovered file paths:
+* - /workspace/apps/my-app/src/app/pages/index.server.ts
+* - /workspace/apps/my-app/src/app/pages/users/[id].server.ts
+* - /workspace/apps/my-app/src/app/pages/products/[...slug].server.ts
+* - /workspace/apps/my-app/src/app/pages/(auth)/login.server.ts
+*
+* Route transformation examples:
+* - index.server.ts → /api/_analog/pages/index
+* - users/[id].server.ts → /api/_analog/pages/users/:id
+* - products/[...slug].server.ts → /api/_analog/pages/products/**:slug
+* - (auth)/login.server.ts → /api/_analog/pages/-auth-/login
+*
+* tinyglobby vs fast-glob comparison:
+* - Both support the same glob patterns for file discovery
+* - Both are efficient for finding server-side page files
+* - tinyglobby is now used instead of fast-glob
+* - tinyglobby provides similar functionality with smaller bundle size
+* - tinyglobby's globSync returns absolute paths when absolute: true is set
+*
+* Route transformation rules:
+* 1. Removes .server.ts extension
+* 2. Converts [param] to :param for dynamic routes
+* 3. Converts [...param] to **:param for catch-all routes
+* 4. Converts (group) to -group- for route groups
+* 5. Converts dots to forward slashes
+* 6. Prefixes with /api/_analog/pages
+*/
+export declare function getPageHandlers({ workspaceRoot, sourceRoot, rootDir, additionalPagesDirs }: GetHandlersArgs): NitroEventHandler[];
 export {};

package/src/lib/utils/get-page-handlers.js

@@ -1,87 +1,70 @@
-import { resolve } from 'node:path';
-import { globSync } from 'tinyglobby';
-import { normalizePath } from 'vite';
+import { normalizePath } from "vite";
+import { resolve } from "node:path";
+import { globSync } from "tinyglobby";
+//#region packages/vite-plugin-nitro/src/lib/utils/get-page-handlers.ts
 /**
- * Discovers and generates Nitro event handlers for server-side page routes.
- *
- * This function:
- * 1. Discovers all .server.ts files in the app/pages directory and additional pages directories
- * 2. Converts file paths to route patterns using Angular-style route syntax
- * 3. Generates Nitro event handlers with proper route mapping and lazy loading
- * 4. Handles dynamic route parameters and catch-all routes
- *
- * @param workspaceRoot The workspace root directory path
- * @param sourceRoot The source directory path (e.g., 'src')
- * @param rootDir The project root directory relative to workspace
- * @param additionalPagesDirs Optional array of additional pages directories to scan
- * @param hasAPIDir Whether the project has an API directory (affects route prefixing)
- * @returns Array of NitroEventHandler objects with handler paths and route patterns
- *
- * Example usage:
- * const handlers = getPageHandlers({
- *   workspaceRoot: '/workspace',
- *   sourceRoot: 'src',
- *   rootDir: 'apps/my-app',
- *   additionalPagesDirs: ['/libs/shared/pages'],
- *   hasAPIDir: true
- * });
- *
- * Sample discovered file paths:
- * - /workspace/apps/my-app/src/app/pages/index.server.ts
- * - /workspace/apps/my-app/src/app/pages/users/[id].server.ts
- * - /workspace/apps/my-app/src/app/pages/products/[...slug].server.ts
- * - /workspace/apps/my-app/src/app/pages/(auth)/login.server.ts
- *
- * Route transformation examples:
- * - index.server.ts → /_analog/pages/index
- * - users/[id].server.ts → /_analog/pages/users/:id
- * - products/[...slug].server.ts → /_analog/pages/products/**:slug
- * - (auth)/login.server.ts → /_analog/pages/-auth-/login
- *
- * tinyglobby vs fast-glob comparison:
- * - Both support the same glob patterns for file discovery
- * - Both are efficient for finding server-side page files
- * - tinyglobby is now used instead of fast-glob
- * - tinyglobby provides similar functionality with smaller bundle size
- * - tinyglobby's globSync returns absolute paths when absolute: true is set
- *
- * Route transformation rules:
- * 1. Removes .server.ts extension
- * 2. Converts [param] to :param for dynamic routes
- * 3. Converts [...param] to **:param for catch-all routes
- * 4. Converts (group) to -group- for route groups
- * 5. Converts dots to forward slashes
- * 6. Prefixes with /_analog/pages and optionally /api
- */
-export function getPageHandlers({ workspaceRoot, sourceRoot, rootDir, additionalPagesDirs, hasAPIDir, }) {
-    // Normalize the project root path for consistent path handling
-    const root = normalizePath(resolve(workspaceRoot, rootDir));
-    // Discover all .server.ts files in the app/pages directory and additional pages directories
-    // Pattern: looks for any .server.ts files in app/pages/**/*.server.ts and additional directories
-    const endpointFiles = globSync([
-        `${root}/${sourceRoot}/app/pages/**/*.server.ts`,
-        ...(additionalPagesDirs || []).map((dir) => `${workspaceRoot}${dir}/**/*.server.ts`),
-    ], { dot: true, absolute: true });
-    // Transform each discovered file into a Nitro event handler
-    const handlers = endpointFiles.map((endpointFile) => {
-        // Normalize the endpoint file path for consistent path handling
-        const normalized = normalizePath(endpointFile);
-        // Transform the normalized path into a route pattern
-        const route = normalized
-            .replace(/^(.*?)\/pages/, '/pages')
-            .replace(/\.server\.ts$/, '') // Remove .server.ts extension
-            .replace(/\[\.{3}(.+)\]/g, '**:$1') // Convert [...param] to **:param (catch-all routes)
-            .replace(/\[\.{3}(\w+)\]/g, '**:$1') // Alternative catch-all pattern
-            .replace(/\/\((.*?)\)$/, '/-$1-') // Convert (group) to -group- (route groups)
-            .replace(/\[(\w+)\]/g, ':$1') // Convert [param] to :param (dynamic routes)
-            .replace(/\./g, '/'); // Convert dots to forward slashes
-        // Return Nitro event handler with absolute handler path and transformed route
-        return {
-            handler: endpointFile,
-            route: `${hasAPIDir ? '/api' : ''}/_analog${route}`,
-            lazy: true,
-        };
-    });
-    return handlers;
+* Discovers and generates Nitro event handlers for server-side page routes.
+*
+* This function:
+* 1. Discovers all .server.ts files in the app/pages directory and additional pages directories
+* 2. Converts file paths to route patterns using Angular-style route syntax
+* 3. Generates Nitro event handlers with proper route mapping and lazy loading
+* 4. Handles dynamic route parameters and catch-all routes
+*
+* @param workspaceRoot The workspace root directory path
+* @param sourceRoot The source directory path (e.g., 'src')
+* @param rootDir The project root directory relative to workspace
+* @param additionalPagesDirs Optional array of additional pages directories to scan
+* @returns Array of NitroEventHandler objects with handler paths and route patterns
+*
+* Example usage:
+* const handlers = getPageHandlers({
+*   workspaceRoot: '/workspace',
+*   sourceRoot: 'src',
+*   rootDir: 'apps/my-app',
+*   additionalPagesDirs: ['/libs/shared/pages'],
+* });
+*
+* Sample discovered file paths:
+* - /workspace/apps/my-app/src/app/pages/index.server.ts
+* - /workspace/apps/my-app/src/app/pages/users/[id].server.ts
+* - /workspace/apps/my-app/src/app/pages/products/[...slug].server.ts
+* - /workspace/apps/my-app/src/app/pages/(auth)/login.server.ts
+*
+* Route transformation examples:
+* - index.server.ts → /api/_analog/pages/index
+* - users/[id].server.ts → /api/_analog/pages/users/:id
+* - products/[...slug].server.ts → /api/_analog/pages/products/**:slug
+* - (auth)/login.server.ts → /api/_analog/pages/-auth-/login
+*
+* tinyglobby vs fast-glob comparison:
+* - Both support the same glob patterns for file discovery
+* - Both are efficient for finding server-side page files
+* - tinyglobby is now used instead of fast-glob
+* - tinyglobby provides similar functionality with smaller bundle size
+* - tinyglobby's globSync returns absolute paths when absolute: true is set
+*
+* Route transformation rules:
+* 1. Removes .server.ts extension
+* 2. Converts [param] to :param for dynamic routes
+* 3. Converts [...param] to **:param for catch-all routes
+* 4. Converts (group) to -group- for route groups
+* 5. Converts dots to forward slashes
+* 6. Prefixes with /api/_analog/pages
+*/
+function getPageHandlers({ workspaceRoot, sourceRoot, rootDir, additionalPagesDirs }) {
+	return globSync([`${normalizePath(resolve(workspaceRoot, rootDir))}/${sourceRoot}/app/pages/**/*.server.ts`, ...(additionalPagesDirs || []).map((dir) => `${workspaceRoot}${dir}/**/*.server.ts`)], {
+		dot: true,
+		absolute: true
+	}).map((endpointFile) => {
+		return {
+			handler: endpointFile,
+			route: `/api/_analog${normalizePath(endpointFile).replace(/^(.*?)\/pages/, "/pages").replace(/\.server\.ts$/, "").replace(/\[\.{3}(.+)\]/g, "**:$1").replace(/\[\.{3}(\w+)\]/g, "**:$1").replace(/\/\((.*?)\)$/, "/-$1-").replace(/\[(\w+)\]/g, ":$1").replace(/\./g, "/")}`,
+			lazy: true
+		};
+	});
 }
+//#endregion
+export { getPageHandlers };
+
 //# sourceMappingURL=get-page-handlers.js.map

package/src/lib/utils/get-page-handlers.js.map

@@ -1 +1 @@
-{"version":3,"file":"get-page-handlers.js","sourceRoot":"","sources":["../../../../../../packages/vite-plugin-nitro/src/lib/utils/get-page-handlers.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAY,MAAM,WAAW,CAAC;AAC9C,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAGtC,OAAO,EAAE,aAAa,EAAE,MAAM,MAAM,CAAC;AAUrC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmDG;AACH,MAAM,UAAU,eAAe,CAAC,EAC9B,aAAa,EACb,UAAU,EACV,OAAO,EACP,mBAAmB,EACnB,SAAS,GACO;IAChB,+DAA+D;IAC/D,MAAM,IAAI,GAAG,aAAa,CAAC,OAAO,CAAC,aAAa,EAAE,OAAO,CAAC,CAAC,CAAC;IAE5D,4FAA4F;IAC5F,iGAAiG;IACjG,MAAM,aAAa,GAAa,QAAQ,CACtC;QACE,GAAG,IAAI,IAAI,UAAU,2BAA2B;QAChD,GAAG,CAAC,mBAAmB,IAAI,EAAE,CAAC,CAAC,GAAG,CAChC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,aAAa,GAAG,GAAG,iBAAiB,CACjD;KACF,EACD,EAAE,GAAG,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,CAC9B,CAAC;IAEF,4DAA4D;IAC5D,MAAM,QAAQ,GAAwB,aAAa,CAAC,GAAG,CAAC,CAAC,YAAY,EAAE,EAAE;QACvE,gEAAgE;QAChE,MAAM,UAAU,GAAG,aAAa,CAAC,YAAY,CAAC,CAAC;QAC/C,qDAAqD;QACrD,MAAM,KAAK,GAAG,UAAU;aACrB,OAAO,CAAC,eAAe,EAAE,QAAQ,CAAC;aAClC,OAAO,CAAC,eAAe,EAAE,EAAE,CAAC,CAAC,8BAA8B;aAC3D,OAAO,CAAC,gBAAgB,EAAE,OAAO,CAAC,CAAC,oDAAoD;aACvF,OAAO,CAAC,iBAAiB,EAAE,OAAO,CAAC,CAAC,gCAAgC;aACpE,OAAO,CAAC,cAAc,EAAE,OAAO,CAAC,CAAC,4CAA4C;aAC7E,OAAO,CAAC,YAAY,EAAE,KAAK,CAAC,CAAC,6CAA6C;aAC1E,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC,CAAC,kCAAkC;QAE1D,8EAA8E;QAC9E,OAAO;YACL,OAAO,EAAE,YAAY;YACrB,KAAK,EAAE,GAAG,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,WAAW,KAAK,EAAE;YACnD,IAAI,EAAE,IAAI;SACX,CAAC;IACJ,CAAC,CAAC,CAAC;IAEH,OAAO,QAAQ,CAAC;AAClB,CAAC"}
+{"version":3,"file":"get-page-handlers.js","names":[],"sources":["../../../../src/lib/utils/get-page-handlers.ts"],"sourcesContent":["import { resolve, relative } from 'node:path';\nimport { globSync } from 'tinyglobby';\n\nimport type { NitroEventHandler } from 'nitro/types';\nimport { normalizePath } from 'vite';\n\ntype GetHandlersArgs = {\n  workspaceRoot: string;\n  sourceRoot: string;\n  rootDir: string;\n  additionalPagesDirs?: string[];\n};\n\n/**\n * Discovers and generates Nitro event handlers for server-side page routes.\n *\n * This function:\n * 1. Discovers all .server.ts files in the app/pages directory and additional pages directories\n * 2. Converts file paths to route patterns using Angular-style route syntax\n * 3. Generates Nitro event handlers with proper route mapping and lazy loading\n * 4. Handles dynamic route parameters and catch-all routes\n *\n * @param workspaceRoot The workspace root directory path\n * @param sourceRoot The source directory path (e.g., 'src')\n * @param rootDir The project root directory relative to workspace\n * @param additionalPagesDirs Optional array of additional pages directories to scan\n * @returns Array of NitroEventHandler objects with handler paths and route patterns\n *\n * Example usage:\n * const handlers = getPageHandlers({\n *   workspaceRoot: '/workspace',\n *   sourceRoot: 'src',\n *   rootDir: 'apps/my-app',\n *   additionalPagesDirs: ['/libs/shared/pages'],\n * });\n *\n * Sample discovered file paths:\n * - /workspace/apps/my-app/src/app/pages/index.server.ts\n * - /workspace/apps/my-app/src/app/pages/users/[id].server.ts\n * - /workspace/apps/my-app/src/app/pages/products/[...slug].server.ts\n * - /workspace/apps/my-app/src/app/pages/(auth)/login.server.ts\n *\n * Route transformation examples:\n * - index.server.ts → /api/_analog/pages/index\n * - users/[id].server.ts → /api/_analog/pages/users/:id\n * - products/[...slug].server.ts → /api/_analog/pages/products/**:slug\n * - (auth)/login.server.ts → /api/_analog/pages/-auth-/login\n *\n * tinyglobby vs fast-glob comparison:\n * - Both support the same glob patterns for file discovery\n * - Both are efficient for finding server-side page files\n * - tinyglobby is now used instead of fast-glob\n * - tinyglobby provides similar functionality with smaller bundle size\n * - tinyglobby's globSync returns absolute paths when absolute: true is set\n *\n * Route transformation rules:\n * 1. Removes .server.ts extension\n * 2. Converts [param] to :param for dynamic routes\n * 3. Converts [...param] to **:param for catch-all routes\n * 4. Converts (group) to -group- for route groups\n * 5. Converts dots to forward slashes\n * 6. Prefixes with /api/_analog/pages\n */\nexport function getPageHandlers({\n  workspaceRoot,\n  sourceRoot,\n  rootDir,\n  additionalPagesDirs,\n}: GetHandlersArgs): NitroEventHandler[] {\n  // Normalize the project root path for consistent path handling\n  const root = normalizePath(resolve(workspaceRoot, rootDir));\n\n  // Discover all .server.ts files in the app/pages directory and additional pages directories\n  // Pattern: looks for any .server.ts files in app/pages/**/*.server.ts and additional directories\n  const endpointFiles: string[] = globSync(\n    [\n      `${root}/${sourceRoot}/app/pages/**/*.server.ts`,\n      ...(additionalPagesDirs || []).map(\n        (dir) => `${workspaceRoot}${dir}/**/*.server.ts`,\n      ),\n    ],\n    { dot: true, absolute: true },\n  );\n\n  // Transform each discovered file into a Nitro event handler\n  const handlers: NitroEventHandler[] = endpointFiles.map((endpointFile) => {\n    // Normalize the endpoint file path for consistent path handling\n    const normalized = normalizePath(endpointFile);\n    // Transform the normalized path into a route pattern\n    const route = normalized\n      .replace(/^(.*?)\\/pages/, '/pages')\n      .replace(/\\.server\\.ts$/, '') // Remove .server.ts extension\n      .replace(/\\[\\.{3}(.+)\\]/g, '**:$1') // Convert [...param] to **:param (catch-all routes)\n      .replace(/\\[\\.{3}(\\w+)\\]/g, '**:$1') // Alternative catch-all pattern\n      .replace(/\\/\\((.*?)\\)$/, '/-$1-') // Convert (group) to -group- (route groups)\n      .replace(/\\[(\\w+)\\]/g, ':$1') // Convert [param] to :param (dynamic routes)\n      .replace(/\\./g, '/'); // Convert dots to forward slashes\n\n    // Return Nitro event handler with absolute handler path and transformed route\n    return {\n      handler: endpointFile,\n      route: `/api/_analog${route}`,\n      lazy: true,\n    };\n  });\n\n  return handlers;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA+DA,SAAgB,gBAAgB,EAC9B,eACA,YACA,SACA,uBACuC;AAsCvC,QAhCgC,SAC9B,CACE,GANS,cAAc,QAAQ,eAAe,QAAQ,CAAC,CAM/C,GAAG,WAAW,4BACtB,IAAI,uBAAuB,EAAE,EAAE,KAC5B,QAAQ,GAAG,gBAAgB,IAAI,iBACjC,CACF,EACD;EAAE,KAAK;EAAM,UAAU;EAAM,CAC9B,CAGmD,KAAK,iBAAiB;AAcxE,SAAO;GACL,SAAS;GACT,OAAO,eAdU,cAAc,aAAa,CAG3C,QAAQ,iBAAiB,SAAS,CAClC,QAAQ,iBAAiB,GAAG,CAC5B,QAAQ,kBAAkB,QAAQ,CAClC,QAAQ,mBAAmB,QAAQ,CACnC,QAAQ,gBAAgB,QAAQ,CAChC,QAAQ,cAAc,MAAM,CAC5B,QAAQ,OAAO,IAAI;GAMpB,MAAM;GACP;GACD"}

package/src/lib/utils/get-server-fn-handlers.d.ts

@@ -0,0 +1,28 @@
+export type GetServerFnHandlersArgs = {
+	workspaceRoot: string;
+	sourceRoot: string;
+	rootDir: string;
+	additionalServerFnDirs?: string[];
+};
+export type ServerFnHandlerModule = {
+	/** Absolute, normalized path to a discovered `*.server.ts` module. */
+	file: string;
+};
+/**
+* Discovers the `*.server.ts` modules that may define server functions.
+*
+* Unlike page endpoints (one Nitro handler per file), server functions all
+* share a single `/_analog/fn/:id` dispatch route. The discovered modules are
+* imported for their registration side-effects — each `serverFn(...)` call
+* registers itself into the server-side registry at import time — after which
+* dispatch looks up the requested function by id.
+*
+* Scope is `<projectRoot>/<sourceRoot>/**\/*.server.ts` because the RFC allows a
+* server function to live in any `.server.ts` module, including existing page
+* server files. Files that define no server function simply register nothing.
+* Angular SSR config (`app.config.server.ts`) is excluded — it is not a route or
+* function module and must not be pulled into the dispatch bundle.
+*
+* @returns discovered modules, de-duplicated and sorted for deterministic output
+*/
+export declare function getServerFnHandlers({ workspaceRoot, sourceRoot, rootDir, additionalServerFnDirs }: GetServerFnHandlersArgs): ServerFnHandlerModule[];

package/src/lib/utils/get-server-fn-handlers.js

@@ -0,0 +1,45 @@
+import { normalizePath } from "vite";
+import { resolve } from "node:path";
+import { globSync } from "tinyglobby";
+//#region packages/vite-plugin-nitro/src/lib/utils/get-server-fn-handlers.ts
+/**
+* `*.server.ts` files that are matched by the glob but are never server-function
+* hosts, so importing them for registration side-effects would be wrong.
+*
+* The SSR entries (`main.server.ts`, `main-cf.server.ts`, …) sit at the top of
+* the source root and bootstrap the whole Angular application; importing one
+* would pull the entire app into the dispatch bundle. They are matched by
+* directory rather than by name so a page named `main.server.ts` still counts.
+*/
+var EXCLUDED_SERVER_FILES = [/\/app\.config\.server\.ts$/];
+/**
+* Discovers the `*.server.ts` modules that may define server functions.
+*
+* Unlike page endpoints (one Nitro handler per file), server functions all
+* share a single `/_analog/fn/:id` dispatch route. The discovered modules are
+* imported for their registration side-effects — each `serverFn(...)` call
+* registers itself into the server-side registry at import time — after which
+* dispatch looks up the requested function by id.
+*
+* Scope is `<projectRoot>/<sourceRoot>/**\/*.server.ts` because the RFC allows a
+* server function to live in any `.server.ts` module, including existing page
+* server files. Files that define no server function simply register nothing.
+* Angular SSR config (`app.config.server.ts`) is excluded — it is not a route or
+* function module and must not be pulled into the dispatch bundle.
+*
+* @returns discovered modules, de-duplicated and sorted for deterministic output
+*/
+function getServerFnHandlers({ workspaceRoot, sourceRoot, rootDir, additionalServerFnDirs }) {
+	const root = normalizePath(resolve(workspaceRoot, rootDir));
+	const files = globSync([`${root}/${sourceRoot}/**/*.server.ts`, ...(additionalServerFnDirs || []).map((dir) => `${workspaceRoot}${dir}/**/*.server.ts`)], {
+		dot: true,
+		absolute: true
+	}).map((file) => normalizePath(file));
+	const sourceRootDir = `${root}/${sourceRoot}/`;
+	const seen = /* @__PURE__ */ new Set();
+	return files.filter((file) => !EXCLUDED_SERVER_FILES.some((re) => re.test(file))).filter((file) => !file.startsWith(sourceRootDir) || file.slice(sourceRootDir.length).includes("/")).filter((file) => seen.has(file) ? false : (seen.add(file), true)).sort().map((file) => ({ file }));
+}
+//#endregion
+export { getServerFnHandlers };
+
+//# sourceMappingURL=get-server-fn-handlers.js.map

package/src/lib/utils/get-server-fn-handlers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-server-fn-handlers.js","names":[],"sources":["../../../../src/lib/utils/get-server-fn-handlers.ts"],"sourcesContent":["import { resolve } from 'node:path';\nimport { globSync } from 'tinyglobby';\n\nimport { normalizePath } from 'vite';\n\nexport type GetServerFnHandlersArgs = {\n  workspaceRoot: string;\n  sourceRoot: string;\n  rootDir: string;\n  additionalServerFnDirs?: string[];\n};\n\nexport type ServerFnHandlerModule = {\n  /** Absolute, normalized path to a discovered `*.server.ts` module. */\n  file: string;\n};\n\n/**\n * `*.server.ts` files that are matched by the glob but are never server-function\n * hosts, so importing them for registration side-effects would be wrong.\n *\n * The SSR entries (`main.server.ts`, `main-cf.server.ts`, …) sit at the top of\n * the source root and bootstrap the whole Angular application; importing one\n * would pull the entire app into the dispatch bundle. They are matched by\n * directory rather than by name so a page named `main.server.ts` still counts.\n */\nconst EXCLUDED_SERVER_FILES: RegExp[] = [/\\/app\\.config\\.server\\.ts$/];\n\n/**\n * Discovers the `*.server.ts` modules that may define server functions.\n *\n * Unlike page endpoints (one Nitro handler per file), server functions all\n * share a single `/_analog/fn/:id` dispatch route. The discovered modules are\n * imported for their registration side-effects — each `serverFn(...)` call\n * registers itself into the server-side registry at import time — after which\n * dispatch looks up the requested function by id.\n *\n * Scope is `<projectRoot>/<sourceRoot>/**\\/*.server.ts` because the RFC allows a\n * server function to live in any `.server.ts` module, including existing page\n * server files. Files that define no server function simply register nothing.\n * Angular SSR config (`app.config.server.ts`) is excluded — it is not a route or\n * function module and must not be pulled into the dispatch bundle.\n *\n * @returns discovered modules, de-duplicated and sorted for deterministic output\n */\nexport function getServerFnHandlers({\n  workspaceRoot,\n  sourceRoot,\n  rootDir,\n  additionalServerFnDirs,\n}: GetServerFnHandlersArgs): ServerFnHandlerModule[] {\n  const root = normalizePath(resolve(workspaceRoot, rootDir));\n\n  const files = globSync(\n    [\n      `${root}/${sourceRoot}/**/*.server.ts`,\n      ...(additionalServerFnDirs || []).map(\n        (dir) => `${workspaceRoot}${dir}/**/*.server.ts`,\n      ),\n    ],\n    { dot: true, absolute: true },\n  ).map((file) => normalizePath(file));\n\n  const sourceRootDir = `${root}/${sourceRoot}/`;\n  const seen = new Set<string>();\n  return files\n    .filter((file) => !EXCLUDED_SERVER_FILES.some((re) => re.test(file)))\n    .filter(\n      (file) =>\n        !file.startsWith(sourceRootDir) ||\n        file.slice(sourceRootDir.length).includes('/'),\n    )\n    .filter((file) => (seen.has(file) ? false : (seen.add(file), true)))\n    .sort()\n    .map((file) => ({ file }));\n}\n"],"mappings":";;;;;;;;;;;;;AA0BA,IAAM,wBAAkC,CAAC,6BAA6B;;;;;;;;;;;;;;;;;;AAmBtE,SAAgB,oBAAoB,EAClC,eACA,YACA,SACA,0BACmD;CACnD,MAAM,OAAO,cAAc,QAAQ,eAAe,QAAQ,CAAC;CAE3D,MAAM,QAAQ,SACZ,CACE,GAAG,KAAK,GAAG,WAAW,kBACtB,IAAI,0BAA0B,EAAE,EAAE,KAC/B,QAAQ,GAAG,gBAAgB,IAAI,iBACjC,CACF,EACD;EAAE,KAAK;EAAM,UAAU;EAAM,CAC9B,CAAC,KAAK,SAAS,cAAc,KAAK,CAAC;CAEpC,MAAM,gBAAgB,GAAG,KAAK,GAAG,WAAW;CAC5C,MAAM,uBAAO,IAAI,KAAa;AAC9B,QAAO,MACJ,QAAQ,SAAS,CAAC,sBAAsB,MAAM,OAAO,GAAG,KAAK,KAAK,CAAC,CAAC,CACpE,QACE,SACC,CAAC,KAAK,WAAW,cAAc,IAC/B,KAAK,MAAM,cAAc,OAAO,CAAC,SAAS,IAAI,CACjD,CACA,QAAQ,SAAU,KAAK,IAAI,KAAK,GAAG,SAAS,KAAK,IAAI,KAAK,EAAE,MAAO,CACnE,MAAM,CACN,KAAK,UAAU,EAAE,MAAM,EAAE"}

package/src/lib/utils/i18n-prerender.d.ts

@@ -0,0 +1,36 @@
+import { PrerenderRoute } from "nitropack";
+import { I18nPrerenderOptions } from "../options.js";
+/**
+* Expands a list of routes to include locale-prefixed variants.
+*
+* For each route and each locale, generates a prefixed route:
+*   '/' + locale + route
+*
+* The default locale's routes are included both with and without the prefix
+* so that `/about` and `/en/about` both render.
+*
+* @param routes - The original routes to expand
+* @param i18n - The i18n prerender configuration
+* @returns Expanded routes with locale prefixes
+*/
+export declare function expandRoutesWithLocales(routes: string[], i18n: I18nPrerenderOptions): string[];
+/**
+* Creates a post-rendering hook that injects the `lang` attribute
+* into the `<html>` tag of prerendered pages based on the route's
+* locale prefix.
+*
+* @param i18n - The i18n prerender configuration
+* @returns A post-rendering hook function
+*/
+export declare function createI18nPostRenderingHook(i18n: I18nPrerenderOptions): (route: PrerenderRoute) => Promise<void>;
+/**
+* Detects the locale from a prerendered route path by checking
+* the first path segment against the configured locales.
+*/
+export declare function detectLocaleFromRoute(route: string, i18n: I18nPrerenderOptions): string;
+/**
+* Sets the `lang` attribute on the `<html>` tag in an HTML string.
+* If a `lang` attribute already exists, it is replaced.
+* If no `lang` attribute exists, it is added.
+*/
+export declare function setHtmlLang(html: string, locale: string): string;

package/src/lib/utils/i18n-prerender.js

@@ -0,0 +1,23 @@
+//#region packages/vite-plugin-nitro/src/lib/utils/i18n-prerender.ts
+/**
+* Detects the locale from a prerendered route path by checking
+* the first path segment against the configured locales.
+*/
+function detectLocaleFromRoute(route, i18n) {
+	const firstSegment = route.split("/").filter(Boolean)[0];
+	if (firstSegment && i18n.locales.includes(firstSegment)) return firstSegment;
+	return i18n.defaultLocale;
+}
+/**
+* Sets the `lang` attribute on the `<html>` tag in an HTML string.
+* If a `lang` attribute already exists, it is replaced.
+* If no `lang` attribute exists, it is added.
+*/
+function setHtmlLang(html, locale) {
+	if (/<html[^>]*\slang\s*=\s*["'][^"']*["']/i.test(html)) return html.replace(/(<html[^>]*\s)lang\s*=\s*["'][^"']*["']/i, `$1lang="${locale}"`);
+	return html.replace(/<html/i, `<html lang="${locale}"`);
+}
+//#endregion
+export { detectLocaleFromRoute, setHtmlLang };
+
+//# sourceMappingURL=i18n-prerender.js.map

package/src/lib/utils/i18n-prerender.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"i18n-prerender.js","names":[],"sources":["../../../../src/lib/utils/i18n-prerender.ts"],"sourcesContent":["import { PrerenderRoute } from 'nitropack';\nimport { I18nPrerenderOptions } from '../options.js';\n\n/**\n * Expands a list of routes to include locale-prefixed variants.\n *\n * For each route and each locale, generates a prefixed route:\n *   '/' + locale + route\n *\n * The default locale's routes are included both with and without the prefix\n * so that `/about` and `/en/about` both render.\n *\n * @param routes - The original routes to expand\n * @param i18n - The i18n prerender configuration\n * @returns Expanded routes with locale prefixes\n */\nexport function expandRoutesWithLocales(\n  routes: string[],\n  i18n: I18nPrerenderOptions,\n): string[] {\n  const expanded: string[] = [];\n\n  for (const route of routes) {\n    // Skip API routes — they don't need locale prefixes\n    if (route.includes('/_analog/') || route.startsWith('/api/')) {\n      expanded.push(route);\n      continue;\n    }\n\n    for (const locale of i18n.locales) {\n      const prefix = `/${locale}`;\n      const localizedRoute = route === '/' ? prefix : `${prefix}${route}`;\n      expanded.push(localizedRoute);\n    }\n\n    // Keep the unprefixed route for the default locale\n    if (!expanded.includes(route)) {\n      expanded.push(route);\n    }\n  }\n\n  return expanded;\n}\n\n/**\n * Creates a post-rendering hook that injects the `lang` attribute\n * into the `<html>` tag of prerendered pages based on the route's\n * locale prefix.\n *\n * @param i18n - The i18n prerender configuration\n * @returns A post-rendering hook function\n */\nexport function createI18nPostRenderingHook(\n  i18n: I18nPrerenderOptions,\n): (route: PrerenderRoute) => Promise<void> {\n  return async (route: PrerenderRoute) => {\n    if (!route.contents || typeof route.contents !== 'string') {\n      return;\n    }\n\n    const locale = detectLocaleFromRoute(route.route, i18n);\n    if (!locale) {\n      return;\n    }\n\n    // Inject or replace the lang attribute on <html>\n    route.contents = setHtmlLang(route.contents, locale);\n  };\n}\n\n/**\n * Detects the locale from a prerendered route path by checking\n * the first path segment against the configured locales.\n */\nexport function detectLocaleFromRoute(\n  route: string,\n  i18n: I18nPrerenderOptions,\n): string {\n  const segments = route.split('/').filter(Boolean);\n  const firstSegment = segments[0];\n\n  if (firstSegment && i18n.locales.includes(firstSegment)) {\n    return firstSegment;\n  }\n\n  return i18n.defaultLocale;\n}\n\n/**\n * Sets the `lang` attribute on the `<html>` tag in an HTML string.\n * If a `lang` attribute already exists, it is replaced.\n * If no `lang` attribute exists, it is added.\n */\nexport function setHtmlLang(html: string, locale: string): string {\n  // Replace existing lang attribute\n  if (/<html[^>]*\\slang\\s*=\\s*[\"'][^\"']*[\"']/i.test(html)) {\n    return html.replace(\n      /(<html[^>]*\\s)lang\\s*=\\s*[\"'][^\"']*[\"']/i,\n      `$1lang=\"${locale}\"`,\n    );\n  }\n\n  // Add lang attribute to <html> tag\n  return html.replace(/<html/i, `<html lang=\"${locale}\"`);\n}\n"],"mappings":";;;;;AA0EA,SAAgB,sBACd,OACA,MACQ;CAER,MAAM,eADW,MAAM,MAAM,IAAI,CAAC,OAAO,QAAQ,CACnB;AAE9B,KAAI,gBAAgB,KAAK,QAAQ,SAAS,aAAa,CACrD,QAAO;AAGT,QAAO,KAAK;;;;;;;AAQd,SAAgB,YAAY,MAAc,QAAwB;AAEhE,KAAI,yCAAyC,KAAK,KAAK,CACrD,QAAO,KAAK,QACV,4CACA,WAAW,OAAO,GACnB;AAIH,QAAO,KAAK,QAAQ,UAAU,eAAe,OAAO,GAAG"}

package/src/lib/utils/inject-server-fn-ids.d.ts

@@ -0,0 +1,17 @@
+export interface InjectServerFnIdsResult {
+	code: string;
+	ids: {
+		name: string;
+		id: string;
+	}[];
+}
+/**
+* Server/SSR-build transform: injects the derived `id` into each
+* `export const NAME = serverFn(config, handler)` so the function registers
+* under the same opaque id the client proxy dispatches to. Unlike the client
+* scrub this keeps the handler and every other statement intact — it only edits
+* the config object — so the server module still runs the real implementation.
+*
+* Returns `null` when the module defines no server function.
+*/
+export declare function injectServerFnIds(code: string, fileId: string): InjectServerFnIdsResult | null;

package/src/lib/utils/inject-server-fn-ids.js

@@ -0,0 +1,94 @@
+import { deriveServerFnId } from "./derive-server-fn-id.js";
+import { parseSync } from "oxc-parser";
+import MagicString from "magic-string";
+//#region packages/vite-plugin-nitro/src/lib/utils/inject-server-fn-ids.ts
+var SERVER_FN_SOURCE = "@analogjs/router/server";
+/**
+* Server/SSR-build transform: injects the derived `id` into each
+* `export const NAME = serverFn(config, handler)` so the function registers
+* under the same opaque id the client proxy dispatches to. Unlike the client
+* scrub this keeps the handler and every other statement intact — it only edits
+* the config object — so the server module still runs the real implementation.
+*
+* Returns `null` when the module defines no server function.
+*/
+function injectServerFnIds(code, fileId) {
+	if (!code.includes("serverFn")) return null;
+	const { program } = parseSync(fileId, code);
+	const body = program.body;
+	const serverFnLocalNames = collectServerFnLocalNames(body);
+	const magic = new MagicString(code);
+	const ids = [];
+	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;
+			const name = declarator.id.name;
+			const id = deriveServerFnId(fileId, name);
+			ids.push({
+				name,
+				id
+			});
+			const args = declarator.init.arguments ?? [];
+			const arg0 = args[0];
+			const idProp = `id: ${JSON.stringify(id)}`;
+			if (arg0?.type === "ObjectExpression") {
+				assertMethodInputCompatible(arg0, name, fileId);
+				injectId(magic, arg0, id);
+			} else if (isFunctionNode(arg0)) magic.appendLeft(arg0.start, `{ ${idProp} }, `);
+			else if (arg0 && args.length >= 2) {
+				magic.appendLeft(arg0.start, `{ ${idProp}, input: `);
+				magic.appendRight(arg0.end, ` }`);
+			} else throw new Error(`[analog] serverFn "${name}" in ${fileId} must be called as serverFn(handler), serverFn(schema, handler), or serverFn(config, handler).`);
+		}
+	}
+	if (ids.length === 0) return null;
+	return {
+		code: magic.toString(),
+		ids
+	};
+}
+/**
+* Insert (or replace) `id: "<derived>"` in the config object. Authors do not
+* supply an id; a stray one is overwritten so the route is always the derived,
+* non-enumerable digest — never an author-controlled value.
+*/
+function injectId(magic, configArg, id) {
+	const existing = (configArg.properties ?? []).find((prop) => prop.type === "Property" && (prop.key?.type === "Identifier" ? prop.key.name : prop.key?.value) === "id");
+	if (existing) {
+		magic.overwrite(existing.value.start, existing.value.end, JSON.stringify(id));
+		return;
+	}
+	magic.appendRight(configArg.start + 1, ` id: ${JSON.stringify(id)},`);
+}
+/**
+* Reject `method: 'GET'` alongside an `input` schema at build time: GET carries
+* no body, so a GET function can never receive validated input.
+*/
+function assertMethodInputCompatible(configArg, name, fileId) {
+	let method;
+	let hasInput = false;
+	for (const prop of configArg.properties ?? []) {
+		if (prop.type !== "Property") continue;
+		const key = prop.key?.type === "Identifier" ? prop.key.name : prop.key?.value;
+		if (key === "method" && prop.value?.type === "Literal") 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 (the default when input is present) or drop the input.`);
+}
+function isFunctionNode(node) {
+	return node?.type === "ArrowFunctionExpression" || node?.type === "FunctionExpression";
+}
+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;
+}
+//#endregion
+export { injectServerFnIds };
+
+//# sourceMappingURL=inject-server-fn-ids.js.map

package/src/lib/utils/inject-server-fn-ids.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"inject-server-fn-ids.js","names":[],"sources":["../../../../src/lib/utils/inject-server-fn-ids.ts"],"sourcesContent":["import MagicString from 'magic-string';\nimport { parseSync } from 'oxc-parser';\n\nimport { deriveServerFnId } from './derive-server-fn-id.js';\n\nconst SERVER_FN_SOURCE = '@analogjs/router/server';\n\nexport interface InjectServerFnIdsResult {\n  code: string;\n  ids: { name: string; id: string }[];\n}\n\n/**\n * Server/SSR-build transform: injects the derived `id` into each\n * `export const NAME = serverFn(config, handler)` so the function registers\n * under the same opaque id the client proxy dispatches to. Unlike the client\n * scrub this keeps the handler and every other statement intact — it only edits\n * the config object — so the server module still runs the real implementation.\n *\n * Returns `null` when the module defines no server function.\n */\nexport function injectServerFnIds(\n  code: string,\n  fileId: string,\n): InjectServerFnIdsResult | null {\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  const serverFnLocalNames = collectServerFnLocalNames(body);\n\n  const magic = new MagicString(code);\n  const ids: { name: string; id: string }[] = [];\n\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\n      const name = declarator.id.name;\n      const id = deriveServerFnId(fileId, name);\n      ids.push({ name, id });\n\n      const args = declarator.init.arguments ?? [];\n      const arg0 = args[0];\n      const idProp = `id: ${JSON.stringify(id)}`;\n\n      if (arg0?.type === 'ObjectExpression') {\n        // serverFn({ … }, handler) — inject the id into the config object.\n        assertMethodInputCompatible(arg0, name, fileId);\n        injectId(magic, arg0, id);\n      } else if (isFunctionNode(arg0)) {\n        // serverFn(handler) — synthesize a config: `{ id }, handler`.\n        magic.appendLeft(arg0.start, `{ ${idProp} }, `);\n      } else if (arg0 && args.length >= 2) {\n        // serverFn(schema, handler) — wrap the schema into `{ id, input: <schema> }`.\n        magic.appendLeft(arg0.start, `{ ${idProp}, input: `);\n        magic.appendRight(arg0.end, ` }`);\n      } else {\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    }\n  }\n\n  if (ids.length === 0) {\n    return null;\n  }\n\n  return { code: magic.toString(), ids };\n}\n\n/**\n * Insert (or replace) `id: \"<derived>\"` in the config object. Authors do not\n * supply an id; a stray one is overwritten so the route is always the derived,\n * non-enumerable digest — never an author-controlled value.\n */\nfunction injectId(magic: MagicString, configArg: any, id: string): void {\n  const existing = (configArg.properties ?? []).find(\n    (prop: any) =>\n      prop.type === 'Property' &&\n      (prop.key?.type === 'Identifier' ? prop.key.name : prop.key?.value) ===\n        'id',\n  );\n\n  if (existing) {\n    magic.overwrite(\n      existing.value.start,\n      existing.value.end,\n      JSON.stringify(id),\n    );\n    return;\n  }\n\n  // Insert as the first property, right after the opening brace.\n  magic.appendRight(configArg.start + 1, ` id: ${JSON.stringify(id)},`);\n}\n\n/**\n * Reject `method: 'GET'` alongside an `input` schema at build time: GET carries\n * no body, so a GET function can never receive validated input.\n */\nfunction assertMethodInputCompatible(\n  configArg: any,\n  name: string,\n  fileId: string,\n): void {\n  let method: string | undefined;\n  let hasInput = false;\n  for (const prop of configArg.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' && prop.value?.type === 'Literal') {\n      method = prop.value.value;\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 (the default when input is present) or drop the input.`,\n    );\n  }\n}\n\nfunction isFunctionNode(node: any): boolean {\n  return (\n    node?.type === 'ArrowFunctionExpression' ||\n    node?.type === 'FunctionExpression'\n  );\n}\n\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  if (names.size === 0) {\n    names.add('serverFn');\n  }\n  return names;\n}\n"],"mappings":";;;;AAKA,IAAM,mBAAmB;;;;;;;;;;AAgBzB,SAAgB,kBACd,MACA,QACgC;AAChC,KAAI,CAAC,KAAK,SAAS,WAAW,CAC5B,QAAO;CAGT,MAAM,EAAE,YAAY,UAAU,QAAQ,KAAK;CAC3C,MAAM,OAAQ,QAA4B;CAC1C,MAAM,qBAAqB,0BAA0B,KAAK;CAE1D,MAAM,QAAQ,IAAI,YAAY,KAAK;CACnC,MAAM,MAAsC,EAAE;AAE9C,MAAK,MAAM,QAAQ,MAAM;AACvB,MACE,KAAK,SAAS,4BACd,KAAK,aAAa,SAAS,sBAE3B;AAEF,OAAK,MAAM,cAAc,KAAK,YAAY,cAAc;AACtD,OACE,WAAW,IAAI,SAAS,gBACxB,WAAW,MAAM,SAAS,oBAC1B,WAAW,KAAK,QAAQ,SAAS,gBACjC,CAAC,mBAAmB,IAAI,WAAW,KAAK,OAAO,KAAK,CAEpD;GAGF,MAAM,OAAO,WAAW,GAAG;GAC3B,MAAM,KAAK,iBAAiB,QAAQ,KAAK;AACzC,OAAI,KAAK;IAAE;IAAM;IAAI,CAAC;GAEtB,MAAM,OAAO,WAAW,KAAK,aAAa,EAAE;GAC5C,MAAM,OAAO,KAAK;GAClB,MAAM,SAAS,OAAO,KAAK,UAAU,GAAG;AAExC,OAAI,MAAM,SAAS,oBAAoB;AAErC,gCAA4B,MAAM,MAAM,OAAO;AAC/C,aAAS,OAAO,MAAM,GAAG;cAChB,eAAe,KAAK,CAE7B,OAAM,WAAW,KAAK,OAAO,KAAK,OAAO,MAAM;YACtC,QAAQ,KAAK,UAAU,GAAG;AAEnC,UAAM,WAAW,KAAK,OAAO,KAAK,OAAO,WAAW;AACpD,UAAM,YAAY,KAAK,KAAK,KAAK;SAEjC,OAAM,IAAI,MACR,sBAAsB,KAAK,OAAO,OAAO,gGAC1C;;;AAKP,KAAI,IAAI,WAAW,EACjB,QAAO;AAGT,QAAO;EAAE,MAAM,MAAM,UAAU;EAAE;EAAK;;;;;;;AAQxC,SAAS,SAAS,OAAoB,WAAgB,IAAkB;CACtE,MAAM,YAAY,UAAU,cAAc,EAAE,EAAE,MAC3C,SACC,KAAK,SAAS,eACb,KAAK,KAAK,SAAS,eAAe,KAAK,IAAI,OAAO,KAAK,KAAK,WAC3D,KACL;AAED,KAAI,UAAU;AACZ,QAAM,UACJ,SAAS,MAAM,OACf,SAAS,MAAM,KACf,KAAK,UAAU,GAAG,CACnB;AACD;;AAIF,OAAM,YAAY,UAAU,QAAQ,GAAG,QAAQ,KAAK,UAAU,GAAG,CAAC,GAAG;;;;;;AAOvE,SAAS,4BACP,WACA,MACA,QACM;CACN,IAAI;CACJ,IAAI,WAAW;AACf,MAAK,MAAM,QAAQ,UAAU,cAAc,EAAE,EAAE;AAC7C,MAAI,KAAK,SAAS,WAAY;EAC9B,MAAM,MACJ,KAAK,KAAK,SAAS,eAAe,KAAK,IAAI,OAAO,KAAK,KAAK;AAC9D,MAAI,QAAQ,YAAY,KAAK,OAAO,SAAS,UAC3C,UAAS,KAAK,MAAM;WACX,QAAQ,QACjB,YAAW;;AAGf,KAAI,WAAW,SAAS,SACtB,OAAM,IAAI,MACR,sBAAsB,KAAK,OAAO,OAAO,oIAC1C;;AAIL,SAAS,eAAe,MAAoB;AAC1C,QACE,MAAM,SAAS,6BACf,MAAM,SAAS;;AAInB,SAAS,0BAA0B,MAA0B;CAC3D,MAAM,wBAAQ,IAAI,KAAa;AAC/B,MAAK,MAAM,QAAQ,MAAM;AACvB,MACE,KAAK,SAAS,uBACd,KAAK,QAAQ,UAAU,iBAEvB;AAEF,OAAK,MAAM,QAAQ,KAAK,cAAc,EAAE,CACtC,KACE,KAAK,SAAS,qBACd,KAAK,UAAU,SAAS,WAExB,OAAM,IAAI,KAAK,MAAM,KAAK;;AAIhC,KAAI,MAAM,SAAS,EACjB,OAAM,IAAI,WAAW;AAEvB,QAAO"}