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

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"}

package/src/lib/utils/load-esm.d.ts

@@ -1,21 +1,21 @@
 /**
- * @license
- * Copyright Google LLC All Rights Reserved.
- *
- * Use of this source code is governed by an MIT-style license that can be
- * found in the LICENSE file at https://angular.dev/license
- */
-import { URL } from 'node:url';
+* @license
+* Copyright Google LLC All Rights Reserved.
+*
+* Use of this source code is governed by an MIT-style license that can be
+* found in the LICENSE file at https://angular.dev/license
+*/
+import { URL } from "node:url";
 /**
- * This uses a dynamic import to load a module which may be ESM.
- * CommonJS code can load ESM code via a dynamic import. Unfortunately, TypeScript
- * will currently, unconditionally downlevel dynamic import into a require call.
- * require calls cannot load ESM code and will result in a runtime error. To workaround
- * this, a Function constructor is used to prevent TypeScript from changing the dynamic import.
- * Once TypeScript provides support for keeping the dynamic import this workaround can
- * be dropped.
- *
- * @param modulePath The path of the module to load.
- * @returns A Promise that resolves to the dynamically imported module.
- */
+* This uses a dynamic import to load a module which may be ESM.
+* CommonJS code can load ESM code via a dynamic import. Unfortunately, TypeScript
+* will currently, unconditionally downlevel dynamic import into a require call.
+* require calls cannot load ESM code and will result in a runtime error. To workaround
+* this, a Function constructor is used to prevent TypeScript from changing the dynamic import.
+* Once TypeScript provides support for keeping the dynamic import this workaround can
+* be dropped.
+*
+* @param modulePath The path of the module to load.
+* @returns A Promise that resolves to the dynamically imported module.
+*/
 export declare function loadEsmModule<T>(modulePath: string | URL): Promise<T>;

package/src/lib/utils/node-web-bridge.d.ts

@@ -1,3 +1,3 @@
-import type { IncomingMessage, ServerResponse } from 'node:http';
+import type { IncomingMessage, ServerResponse } from "node:http";
 export declare function toWebRequest(req: IncomingMessage): Request;
 export declare function writeWebResponseToNode(res: ServerResponse, response: Response): Promise<void>;

package/src/lib/utils/node-web-bridge.js

@@ -3,7 +3,7 @@ import { pipeline } from "node:stream/promises";
 //#region packages/vite-plugin-nitro/src/lib/utils/node-web-bridge.ts
 function toWebHeaders(headers) {
 	return Object.entries(headers).reduce((acc, [key, value]) => {
-		if (value) acc.set(key, Array.isArray(value) ? value.join(", ") : value);
+		if (value && !key.startsWith(":")) acc.set(key, Array.isArray(value) ? value.join(", ") : value);
 		return acc;
 	}, new Headers());
 }
@@ -19,6 +19,17 @@ function toWebRequest(req) {
 		duplex: body ? "half" : void 0
 	});
 }
+function isClientDisconnectError(error, res) {
+	if (!(error instanceof Error)) return false;
+	const hasDisconnectCode = "code" in error && typeof error.code === "string" && [
+		"ERR_STREAM_PREMATURE_CLOSE",
+		"ERR_INVALID_STATE",
+		"ECONNRESET",
+		"EPIPE"
+	].includes(error.code);
+	const hasDisconnectMessage = /closed or destroyed stream/i.test(error.message);
+	return (res.destroyed || res.writableEnded) && (hasDisconnectCode || hasDisconnectMessage);
+}
 async function writeWebResponseToNode(res, response) {
 	res.statusCode = response.status;
 	res.statusMessage = response.statusText;
@@ -31,7 +42,12 @@ async function writeWebResponseToNode(res, response) {
 		res.end();
 		return;
 	}
-	await pipeline(Readable.fromWeb(response.body), res);
+	try {
+		await pipeline(Readable.fromWeb(response.body), res);
+	} catch (error) {
+		if (isClientDisconnectError(error, res)) return;
+		throw error;
+	}
 }
 //#endregion
 export { toWebRequest, writeWebResponseToNode };

package/src/lib/utils/node-web-bridge.js.map

@@ -1 +1 @@
-{"version":3,"file":"node-web-bridge.js","names":[],"sources":["../../../../../../packages/vite-plugin-nitro/src/lib/utils/node-web-bridge.ts"],"sourcesContent":["import type {\n  IncomingHttpHeaders,\n  IncomingMessage,\n  ServerResponse,\n} from 'node:http';\nimport { Readable } from 'node:stream';\nimport { pipeline } from 'node:stream/promises';\n\nfunction toWebHeaders(headers: IncomingHttpHeaders) {\n  return Object.entries(headers).reduce((acc, [key, value]) => {\n    if (value) {\n      acc.set(key, Array.isArray(value) ? value.join(', ') : value);\n    }\n\n    return acc;\n  }, new Headers());\n}\n\nexport function toWebRequest(req: IncomingMessage): Request {\n  const protocol = 'http';\n  const host = req.headers.host || 'localhost';\n  const url = new URL(req.url || '/', `${protocol}://${host}`);\n  const body =\n    req.method && !['GET', 'HEAD'].includes(req.method)\n      ? (Readable.toWeb(req) as ReadableStream<Uint8Array>)\n      : undefined;\n\n  return new Request(url, {\n    method: req.method,\n    headers: toWebHeaders(req.headers),\n    body,\n    // @ts-expect-error duplex is required for streaming request bodies in Node.js\n    duplex: body ? 'half' : undefined,\n  });\n}\n\nexport async function writeWebResponseToNode(\n  res: ServerResponse,\n  response: Response,\n): Promise<void> {\n  res.statusCode = response.status;\n  res.statusMessage = response.statusText;\n\n  const setCookies =\n    'getSetCookie' in response.headers &&\n    typeof response.headers.getSetCookie === 'function'\n      ? response.headers.getSetCookie()\n      : [];\n\n  if (setCookies.length > 0) {\n    res.setHeader('set-cookie', setCookies);\n  }\n\n  response.headers.forEach((value, key) => {\n    if (key !== 'set-cookie') {\n      res.setHeader(key, value);\n    }\n  });\n\n  if (!response.body) {\n    res.end();\n    return;\n  }\n\n  // The Web ReadableStream and Node.js stream/web ReadableStream types\n  // are structurally identical at runtime but TypeScript treats them as\n  // distinct nominal types. The double-cast bridges this gap safely.\n  await pipeline(\n    Readable.fromWeb(\n      response.body as unknown as import('node:stream/web').ReadableStream,\n    ),\n    res,\n  );\n}\n"],"mappings":";;;AAQA,SAAS,aAAa,SAA8B;AAClD,QAAO,OAAO,QAAQ,QAAQ,CAAC,QAAQ,KAAK,CAAC,KAAK,WAAW;AAC3D,MAAI,MACF,KAAI,IAAI,KAAK,MAAM,QAAQ,MAAM,GAAG,MAAM,KAAK,KAAK,GAAG,MAAM;AAG/D,SAAO;IACN,IAAI,SAAS,CAAC;;AAGnB,SAAgB,aAAa,KAA+B;CAC1D,MAAM,WAAW;CACjB,MAAM,OAAO,IAAI,QAAQ,QAAQ;CACjC,MAAM,MAAM,IAAI,IAAI,IAAI,OAAO,KAAK,GAAG,SAAS,KAAK,OAAO;CAC5D,MAAM,OACJ,IAAI,UAAU,CAAC,CAAC,OAAO,OAAO,CAAC,SAAS,IAAI,OAAO,GAC9C,SAAS,MAAM,IAAI,GACpB,KAAA;AAEN,QAAO,IAAI,QAAQ,KAAK;EACtB,QAAQ,IAAI;EACZ,SAAS,aAAa,IAAI,QAAQ;EAClC;EAEA,QAAQ,OAAO,SAAS,KAAA;EACzB,CAAC;;AAGJ,eAAsB,uBACpB,KACA,UACe;AACf,KAAI,aAAa,SAAS;AAC1B,KAAI,gBAAgB,SAAS;CAE7B,MAAM,aACJ,kBAAkB,SAAS,WAC3B,OAAO,SAAS,QAAQ,iBAAiB,aACrC,SAAS,QAAQ,cAAc,GAC/B,EAAE;AAER,KAAI,WAAW,SAAS,EACtB,KAAI,UAAU,cAAc,WAAW;AAGzC,UAAS,QAAQ,SAAS,OAAO,QAAQ;AACvC,MAAI,QAAQ,aACV,KAAI,UAAU,KAAK,MAAM;GAE3B;AAEF,KAAI,CAAC,SAAS,MAAM;AAClB,MAAI,KAAK;AACT;;AAMF,OAAM,SACJ,SAAS,QACP,SAAS,KACV,EACD,IACD"}
+{"version":3,"file":"node-web-bridge.js","names":[],"sources":["../../../../src/lib/utils/node-web-bridge.ts"],"sourcesContent":["import type {\n  IncomingHttpHeaders,\n  IncomingMessage,\n  ServerResponse,\n} from 'node:http';\nimport { Readable } from 'node:stream';\nimport { pipeline } from 'node:stream/promises';\n\nfunction toWebHeaders(headers: IncomingHttpHeaders) {\n  return Object.entries(headers).reduce((acc, [key, value]) => {\n    if (value && !key.startsWith(':')) {\n      acc.set(key, Array.isArray(value) ? value.join(', ') : value);\n    }\n\n    return acc;\n  }, new Headers());\n}\n\nexport function toWebRequest(req: IncomingMessage): Request {\n  const protocol = 'http';\n  const host = req.headers.host || 'localhost';\n  const url = new URL(req.url || '/', `${protocol}://${host}`);\n  const body =\n    req.method && !['GET', 'HEAD'].includes(req.method)\n      ? (Readable.toWeb(req) as ReadableStream<Uint8Array>)\n      : undefined;\n\n  return new Request(url, {\n    method: req.method,\n    headers: toWebHeaders(req.headers),\n    body,\n    // @ts-expect-error duplex is required for streaming request bodies in Node.js\n    duplex: body ? 'half' : undefined,\n  });\n}\n\nfunction isClientDisconnectError(error: unknown, res: ServerResponse): boolean {\n  if (!(error instanceof Error)) {\n    return false;\n  }\n\n  const hasDisconnectCode =\n    'code' in error &&\n    typeof error.code === 'string' &&\n    [\n      'ERR_STREAM_PREMATURE_CLOSE',\n      'ERR_INVALID_STATE',\n      'ECONNRESET',\n      'EPIPE',\n    ].includes(error.code);\n\n  const hasDisconnectMessage = /closed or destroyed stream/i.test(\n    error.message,\n  );\n\n  return (\n    (res.destroyed || res.writableEnded) &&\n    (hasDisconnectCode || hasDisconnectMessage)\n  );\n}\n\nexport async function writeWebResponseToNode(\n  res: ServerResponse,\n  response: Response,\n): Promise<void> {\n  res.statusCode = response.status;\n  res.statusMessage = response.statusText;\n\n  const setCookies =\n    'getSetCookie' in response.headers &&\n    typeof response.headers.getSetCookie === 'function'\n      ? response.headers.getSetCookie()\n      : [];\n\n  if (setCookies.length > 0) {\n    res.setHeader('set-cookie', setCookies);\n  }\n\n  response.headers.forEach((value, key) => {\n    if (key !== 'set-cookie') {\n      res.setHeader(key, value);\n    }\n  });\n\n  if (!response.body) {\n    res.end();\n    return;\n  }\n\n  // The Web ReadableStream and Node.js stream/web ReadableStream types\n  // are structurally identical at runtime but TypeScript treats them as\n  // distinct nominal types. The double-cast bridges this gap safely.\n  try {\n    await pipeline(\n      Readable.fromWeb(\n        response.body as unknown as import('node:stream/web').ReadableStream,\n      ),\n      res,\n    );\n  } catch (error) {\n    // Long-lived dev responses such as SSE can be interrupted by a browser\n    // refresh or HMR-triggered reconnect. Those closed-stream cases are\n    // expected and should not surface as noisy server errors.\n    if (isClientDisconnectError(error, res)) {\n      return;\n    }\n\n    throw error;\n  }\n}\n"],"mappings":";;;AAQA,SAAS,aAAa,SAA8B;AAClD,QAAO,OAAO,QAAQ,QAAQ,CAAC,QAAQ,KAAK,CAAC,KAAK,WAAW;AAC3D,MAAI,SAAS,CAAC,IAAI,WAAW,IAAI,CAC/B,KAAI,IAAI,KAAK,MAAM,QAAQ,MAAM,GAAG,MAAM,KAAK,KAAK,GAAG,MAAM;AAG/D,SAAO;IACN,IAAI,SAAS,CAAC;;AAGnB,SAAgB,aAAa,KAA+B;CAC1D,MAAM,WAAW;CACjB,MAAM,OAAO,IAAI,QAAQ,QAAQ;CACjC,MAAM,MAAM,IAAI,IAAI,IAAI,OAAO,KAAK,GAAG,SAAS,KAAK,OAAO;CAC5D,MAAM,OACJ,IAAI,UAAU,CAAC,CAAC,OAAO,OAAO,CAAC,SAAS,IAAI,OAAO,GAC9C,SAAS,MAAM,IAAI,GACpB,KAAA;AAEN,QAAO,IAAI,QAAQ,KAAK;EACtB,QAAQ,IAAI;EACZ,SAAS,aAAa,IAAI,QAAQ;EAClC;EAEA,QAAQ,OAAO,SAAS,KAAA;EACzB,CAAC;;AAGJ,SAAS,wBAAwB,OAAgB,KAA8B;AAC7E,KAAI,EAAE,iBAAiB,OACrB,QAAO;CAGT,MAAM,oBACJ,UAAU,SACV,OAAO,MAAM,SAAS,YACtB;EACE;EACA;EACA;EACA;EACD,CAAC,SAAS,MAAM,KAAK;CAExB,MAAM,uBAAuB,8BAA8B,KACzD,MAAM,QACP;AAED,SACG,IAAI,aAAa,IAAI,mBACrB,qBAAqB;;AAI1B,eAAsB,uBACpB,KACA,UACe;AACf,KAAI,aAAa,SAAS;AAC1B,KAAI,gBAAgB,SAAS;CAE7B,MAAM,aACJ,kBAAkB,SAAS,WAC3B,OAAO,SAAS,QAAQ,iBAAiB,aACrC,SAAS,QAAQ,cAAc,GAC/B,EAAE;AAER,KAAI,WAAW,SAAS,EACtB,KAAI,UAAU,cAAc,WAAW;AAGzC,UAAS,QAAQ,SAAS,OAAO,QAAQ;AACvC,MAAI,QAAQ,aACV,KAAI,UAAU,KAAK,MAAM;GAE3B;AAEF,KAAI,CAAC,SAAS,MAAM;AAClB,MAAI,KAAK;AACT;;AAMF,KAAI;AACF,QAAM,SACJ,SAAS,QACP,SAAS,KACV,EACD,IACD;UACM,OAAO;AAId,MAAI,wBAAwB,OAAO,IAAI,CACrC;AAGF,QAAM"}

package/src/lib/utils/register-dev-middleware.d.ts

@@ -1,14 +1,14 @@
-import { ViteDevServer } from 'vite';
+import { ViteDevServer } from "vite";
 /**
- * Registers development server middleware by discovering and loading middleware files.
- *
- * Each discovered h3 middleware module is loaded through Vite's SSR loader,
- * wrapped in a temporary H3 app, then bridged back into Vite's Connect stack.
- * If the middleware does not write a response, control falls through to the
- * next Vite middleware.
- *
- * @param root The project root directory path
- * @param sourceRoot The source directory path (e.g., 'src')
- * @param viteServer The Vite development server instance
- */
+* Registers development server middleware by discovering and loading middleware files.
+*
+* Each discovered h3 middleware module is loaded through Vite's SSR loader,
+* wrapped in a temporary H3 app, then bridged back into Vite's Connect stack.
+* If the middleware does not write a response, control falls through to the
+* next Vite middleware.
+*
+* @param root The project root directory path
+* @param sourceRoot The source directory path (e.g., 'src')
+* @param viteServer The Vite development server instance
+*/
 export declare function registerDevServerMiddleware(root: string, sourceRoot: string, viteServer: ViteDevServer): Promise<void>;

package/src/lib/utils/register-dev-middleware.js.map

@@ -1 +1 @@
-{"version":3,"file":"register-dev-middleware.js","names":[],"sources":["../../../../../../packages/vite-plugin-nitro/src/lib/utils/register-dev-middleware.ts"],"sourcesContent":["import { ViteDevServer } from 'vite';\nimport { EventHandler, H3 } from 'nitro/h3';\nimport { globSync } from 'tinyglobby';\n\nimport { toWebRequest, writeWebResponseToNode } from './node-web-bridge.js';\n\nconst PASSTHROUGH_HEADER = 'x-analog-passthrough';\n\n/**\n * Registers development server middleware by discovering and loading middleware files.\n *\n * Each discovered h3 middleware module is loaded through Vite's SSR loader,\n * wrapped in a temporary H3 app, then bridged back into Vite's Connect stack.\n * If the middleware does not write a response, control falls through to the\n * next Vite middleware.\n *\n * @param root The project root directory path\n * @param sourceRoot The source directory path (e.g., 'src')\n * @param viteServer The Vite development server instance\n */\nexport async function registerDevServerMiddleware(\n  root: string,\n  sourceRoot: string,\n  viteServer: ViteDevServer,\n): Promise<void> {\n  const middlewareFiles = globSync(\n    [`${root}/${sourceRoot}/server/middleware/**/*.ts`],\n    {\n      dot: true,\n      absolute: true,\n    },\n  );\n\n  middlewareFiles.forEach((file) => {\n    // Create the H3 app once per middleware file (not per request).\n    // The dynamic handler inside still loads the module fresh each request\n    // via ssrLoadModule, preserving HMR.\n    const app = new H3();\n    app.use(async (event) => {\n      const handler: EventHandler = await viteServer\n        .ssrLoadModule(file)\n        .then((m: unknown) => (m as { default: EventHandler }).default);\n      return handler(event);\n    });\n    // Sentinel catch-all: when the middleware returns undefined (does not\n    // handle the request), h3 does not emit its default 404 — instead we\n    // detect the passthrough header and let the Connect stack continue.\n    app.use(\n      () =>\n        new Response(null, {\n          status: 204,\n          headers: { [PASSTHROUGH_HEADER]: '1' },\n        }),\n    );\n\n    viteServer.middlewares.use(async (req, res, next) => {\n      const response = await app.fetch(toWebRequest(req));\n\n      if (response.headers.get(PASSTHROUGH_HEADER) === '1') {\n        next();\n        return;\n      }\n\n      await writeWebResponseToNode(res, response);\n    });\n  });\n}\n"],"mappings":";;;;AAMA,IAAM,qBAAqB;;;;;;;;;;;;;AAc3B,eAAsB,4BACpB,MACA,YACA,YACe;AACS,UACtB,CAAC,GAAG,KAAK,GAAG,WAAW,4BAA4B,EACnD;EACE,KAAK;EACL,UAAU;EACX,CACF,CAEe,SAAS,SAAS;EAIhC,MAAM,MAAM,IAAI,IAAI;AACpB,MAAI,IAAI,OAAO,UAAU;AAIvB,WAH8B,MAAM,WACjC,cAAc,KAAK,CACnB,MAAM,MAAgB,EAAgC,QAAQ,EAClD,MAAM;IACrB;AAIF,MAAI,UAEA,IAAI,SAAS,MAAM;GACjB,QAAQ;GACR,SAAS,GAAG,qBAAqB,KAAK;GACvC,CAAC,CACL;AAED,aAAW,YAAY,IAAI,OAAO,KAAK,KAAK,SAAS;GACnD,MAAM,WAAW,MAAM,IAAI,MAAM,aAAa,IAAI,CAAC;AAEnD,OAAI,SAAS,QAAQ,IAAI,mBAAmB,KAAK,KAAK;AACpD,UAAM;AACN;;AAGF,SAAM,uBAAuB,KAAK,SAAS;IAC3C;GACF"}
+{"version":3,"file":"register-dev-middleware.js","names":[],"sources":["../../../../src/lib/utils/register-dev-middleware.ts"],"sourcesContent":["import { ViteDevServer } from 'vite';\nimport { EventHandler, H3 } from 'nitro/h3';\nimport { globSync } from 'tinyglobby';\n\nimport { toWebRequest, writeWebResponseToNode } from './node-web-bridge.js';\n\nconst PASSTHROUGH_HEADER = 'x-analog-passthrough';\n\n/**\n * Registers development server middleware by discovering and loading middleware files.\n *\n * Each discovered h3 middleware module is loaded through Vite's SSR loader,\n * wrapped in a temporary H3 app, then bridged back into Vite's Connect stack.\n * If the middleware does not write a response, control falls through to the\n * next Vite middleware.\n *\n * @param root The project root directory path\n * @param sourceRoot The source directory path (e.g., 'src')\n * @param viteServer The Vite development server instance\n */\nexport async function registerDevServerMiddleware(\n  root: string,\n  sourceRoot: string,\n  viteServer: ViteDevServer,\n): Promise<void> {\n  const middlewareFiles = globSync(\n    [`${root}/${sourceRoot}/server/middleware/**/*.ts`],\n    {\n      dot: true,\n      absolute: true,\n    },\n  );\n\n  middlewareFiles.forEach((file) => {\n    // Create the H3 app once per middleware file (not per request).\n    // The dynamic handler inside still loads the module fresh each request\n    // via ssrLoadModule, preserving HMR.\n    const app = new H3();\n    app.use(async (event) => {\n      const handler: EventHandler = await viteServer\n        .ssrLoadModule(file)\n        .then((m: unknown) => (m as { default: EventHandler }).default);\n      return handler(event);\n    });\n    // Sentinel catch-all: when the middleware returns undefined (does not\n    // handle the request), h3 does not emit its default 404 — instead we\n    // detect the passthrough header and let the Connect stack continue.\n    app.use(\n      () =>\n        new Response(null, {\n          status: 204,\n          headers: { [PASSTHROUGH_HEADER]: '1' },\n        }),\n    );\n\n    viteServer.middlewares.use(async (req, res, next) => {\n      const response = await app.fetch(toWebRequest(req));\n\n      if (response.headers.get(PASSTHROUGH_HEADER) === '1') {\n        next();\n        return;\n      }\n\n      await writeWebResponseToNode(res, response);\n    });\n  });\n}\n"],"mappings":";;;;AAMA,IAAM,qBAAqB;;;;;;;;;;;;;AAc3B,eAAsB,4BACpB,MACA,YACA,YACe;AACS,UACtB,CAAC,GAAG,KAAK,GAAG,WAAW,4BAA4B,EACnD;EACE,KAAK;EACL,UAAU;EACX,CACF,CAEe,SAAS,SAAS;EAIhC,MAAM,MAAM,IAAI,IAAI;AACpB,MAAI,IAAI,OAAO,UAAU;AAIvB,WAH8B,MAAM,WACjC,cAAc,KAAK,CACnB,MAAM,MAAgB,EAAgC,QAAQ,EAClD,MAAM;IACrB;AAIF,MAAI,UAEA,IAAI,SAAS,MAAM;GACjB,QAAQ;GACR,SAAS,GAAG,qBAAqB,KAAK;GACvC,CAAC,CACL;AAED,aAAW,YAAY,IAAI,OAAO,KAAK,KAAK,SAAS;GACnD,MAAM,WAAW,MAAM,IAAI,MAAM,aAAa,IAAI,CAAC;AAEnD,OAAI,SAAS,QAAQ,IAAI,mBAAmB,KAAK,KAAK;AACpD,UAAM;AACN;;AAGF,SAAM,uBAAuB,KAAK,SAAS;IAC3C;GACF"}

package/src/lib/utils/register-i18n-watcher.d.ts

@@ -0,0 +1,15 @@
+import { ViteDevServer } from "vite";
+/**
+* Registers a file watcher that triggers a full page reload
+* when translation files are added or modified.
+*
+* Matches files in i18n directories with .json, .xlf, .xmb, or .arb extensions.
+*
+* @param viteServer The Vite development server instance
+*/
+export declare function registerI18nWatcher(viteServer: ViteDevServer): void;
+/**
+* Checks whether a file path looks like a translation file
+* based on its location in an i18n directory and its extension.
+*/
+export declare function isTranslationFile(path: string): boolean;

package/src/lib/utils/register-i18n-watcher.js

@@ -0,0 +1,27 @@
+//#region packages/vite-plugin-nitro/src/lib/utils/register-i18n-watcher.ts
+/**
+* Registers a file watcher that triggers a full page reload
+* when translation files are added or modified.
+*
+* Matches files in i18n directories with .json, .xlf, .xmb, or .arb extensions.
+*
+* @param viteServer The Vite development server instance
+*/
+function registerI18nWatcher(viteServer) {
+	const triggerReload = (path) => {
+		if (isTranslationFile(path)) viteServer.ws.send({ type: "full-reload" });
+	};
+	viteServer.watcher.on("change", triggerReload);
+	viteServer.watcher.on("add", triggerReload);
+}
+/**
+* Checks whether a file path looks like a translation file
+* based on its location in an i18n directory and its extension.
+*/
+function isTranslationFile(path) {
+	return /i18n.*\.(json|xlf|xmb|arb)$/.test(path);
+}
+//#endregion
+export { registerI18nWatcher };
+
+//# sourceMappingURL=register-i18n-watcher.js.map

package/src/lib/utils/register-i18n-watcher.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"register-i18n-watcher.js","names":[],"sources":["../../../../src/lib/utils/register-i18n-watcher.ts"],"sourcesContent":["import { ViteDevServer } from 'vite';\n\n/**\n * Registers a file watcher that triggers a full page reload\n * when translation files are added or modified.\n *\n * Matches files in i18n directories with .json, .xlf, .xmb, or .arb extensions.\n *\n * @param viteServer The Vite development server instance\n */\nexport function registerI18nWatcher(viteServer: ViteDevServer): void {\n  const triggerReload = (path: string) => {\n    if (isTranslationFile(path)) {\n      viteServer.ws.send({ type: 'full-reload' });\n    }\n  };\n\n  viteServer.watcher.on('change', triggerReload);\n  viteServer.watcher.on('add', triggerReload);\n}\n\n/**\n * Checks whether a file path looks like a translation file\n * based on its location in an i18n directory and its extension.\n */\nexport function isTranslationFile(path: string): boolean {\n  return /i18n.*\\.(json|xlf|xmb|arb)$/.test(path);\n}\n"],"mappings":";;;;;;;;;AAUA,SAAgB,oBAAoB,YAAiC;CACnE,MAAM,iBAAiB,SAAiB;AACtC,MAAI,kBAAkB,KAAK,CACzB,YAAW,GAAG,KAAK,EAAE,MAAM,eAAe,CAAC;;AAI/C,YAAW,QAAQ,GAAG,UAAU,cAAc;AAC9C,YAAW,QAAQ,GAAG,OAAO,cAAc;;;;;;AAO7C,SAAgB,kBAAkB,MAAuB;AACvD,QAAO,8BAA8B,KAAK,KAAK"}

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

@@ -1,53 +1,33 @@
 /**
- * Code snippet emitted into virtual modules to create a request-scoped
- * fetch using ofetch's `createFetch` + h3's `fetchWithEvent`.
- *
- * Shared between the SSR renderer and page-endpoint virtual modules so
- * the fetch-wiring logic stays in sync.
- *
- * The emitted variable is named `serverFetch` — callers should reference it
- * by that name.
- */
+* Code snippet emitted into virtual modules to create a request-scoped
+* fetch using ofetch's `createFetch` + h3's `fetchWithEvent`.
+*
+* Shared between the SSR renderer and page-endpoint virtual modules so
+* the fetch-wiring logic stays in sync.
+*
+* The emitted variable is named `serverFetch` — callers should reference it
+* by that name.
+*/
 export declare const SERVER_FETCH_FACTORY_SNIPPET = "\n  const serverFetch = createFetch({\n    fetch: (resource, init) => {\n      const url = resource instanceof Request ? resource.url : resource.toString();\n      return fetchWithEvent(event, url, init);\n    }\n  });";
 /**
- * SSR renderer virtual module content.
- *
- * This code runs inside Nitro's server runtime (Node.js context) where
- * event.node is always populated. In h3 v2, event.node is typed as optional,
- * so we use h3's first-class event properties (event.path, event.method) where
- * possible and apply optional chaining when accessing the Node.js context for
- * the Angular renderer which requires raw req/res objects.
- *
- * h3 v2 idiomatic APIs used:
- * - defineHandler (replaces defineEventHandler / eventHandler)
- * - event.path (replaces event.node.req.url)
- * - getResponseHeader compat shim (still available in h3 v2)
- */
-export declare function ssrRenderer(templatePath: string): string;
+* SSR renderer virtual module content.
+*
+* This code runs inside Nitro's server runtime (Node.js context) where
+* event.node is always populated. In h3 v2, event.node is typed as optional,
+* so we use h3's first-class event properties (event.path, event.method) where
+* possible and apply optional chaining when accessing the Node.js context for
+* the Angular renderer which requires raw req/res objects.
+*
+* h3 v2 idiomatic APIs used:
+* - defineHandler (replaces defineEventHandler / eventHandler)
+* - event.path (replaces event.node.req.url)
+* - getResponseHeader compat shim (still available in h3 v2)
+*/
+export declare function ssrRenderer(): string;
 /**
- * Client-only renderer virtual module content.
- *
- * Used when SSR is disabled — simply serves the static index.html template
- * for every route, letting the client-side Angular router handle navigation.
- */
-export declare function clientRenderer(templatePath: string): string;
-/**
- * API middleware virtual module content.
- *
- * Intercepts requests matching the configured API prefix and either:
- * - Uses event-bound internal forwarding for GET requests (except .xml routes)
- * - Uses request proxying for all other methods to forward the full request
- *
- * h3 v2 idiomatic APIs used:
- * - defineHandler (replaces defineEventHandler / eventHandler)
- * - event.path (replaces event.node.req.url)
- * - event.method (replaces event.node.req.method)
- * - proxyRequest is retained internally because it preserves Nitro route
- *   matching for event-bound server requests during SSR/prerender
- * - Object.fromEntries(event.req.headers.entries()) replaces direct event.node.req.headers access
- *
- * `fetchWithEvent` keeps the active event context while forwarding to a
- * rewritten path, which avoids falling through to the HTML renderer when
- * SSR code makes relative API requests.
- */
-export declare const apiMiddleware = "\nimport { defineHandler, fetchWithEvent, proxyRequest } from 'nitro/h3';\nimport { useRuntimeConfig } from 'nitro/runtime-config';\n\nexport default defineHandler(async (event) => {\n  const prefix = useRuntimeConfig().prefix;\n  const apiPrefix = `${prefix}/${useRuntimeConfig().apiPrefix}`;\n\n  if (event.path?.startsWith(apiPrefix)) {\n    const reqUrl = event.path?.replace(apiPrefix, '');\n\n    if (\n      event.method === 'GET' &&\n      // in the case of XML routes, we want to proxy the request so that nitro gets the correct headers\n      // and can render the XML correctly as a static asset\n      !event.path?.endsWith('.xml')\n    ) {\n      return fetchWithEvent(event, reqUrl, {\n        headers: Object.fromEntries(event.req.headers.entries()),\n      });\n    }\n\n    return proxyRequest(event, reqUrl);\n  }\n});";
+* Client-only renderer virtual module content.
+*
+* Used when SSR is disabled — simply serves the static index.html template
+* for every route, letting the client-side Angular router handle navigation.
+*/
+export declare function clientRenderer(): string;

package/src/lib/utils/renderers.js

@@ -30,15 +30,14 @@ var SERVER_FETCH_FACTORY_SNIPPET = `
 * - event.path (replaces event.node.req.url)
 * - getResponseHeader compat shim (still available in h3 v2)
 */
-function ssrRenderer(templatePath) {
+function ssrRenderer() {
 	return `
-import { readFileSync } from 'node:fs';
 import { createFetch } from 'ofetch';
 import { defineHandler, fetchWithEvent } from 'nitro/h3';
 // @ts-ignore
 import renderer from '#analog/ssr';
+import template from '#analog/index';
 
-const template = readFileSync(${JSON.stringify(templatePath)}, 'utf8');
 const normalizeHtmlRequestUrl = (url) =>
   url.replace(/\\/index\\.html(?=$|[?#])/, '/');
 
@@ -83,12 +82,10 @@ ${SERVER_FETCH_FACTORY_SNIPPET}
 * Used when SSR is disabled — simply serves the static index.html template
 * for every route, letting the client-side Angular router handle navigation.
 */
-function clientRenderer(templatePath) {
+function clientRenderer() {
 	return `
-import { readFileSync } from 'node:fs';
 import { defineHandler } from 'nitro/h3';
-
-const template = readFileSync(${JSON.stringify(templatePath)}, 'utf8');
+import template from '#analog/index';
 
 export default defineHandler(async (event) => {
   event.res.headers.set('content-type', 'text/html; charset=utf-8');
@@ -96,51 +93,7 @@ export default defineHandler(async (event) => {
 });
 `;
 }
-/**
-* API middleware virtual module content.
-*
-* Intercepts requests matching the configured API prefix and either:
-* - Uses event-bound internal forwarding for GET requests (except .xml routes)
-* - Uses request proxying for all other methods to forward the full request
-*
-* h3 v2 idiomatic APIs used:
-* - defineHandler (replaces defineEventHandler / eventHandler)
-* - event.path (replaces event.node.req.url)
-* - event.method (replaces event.node.req.method)
-* - proxyRequest is retained internally because it preserves Nitro route
-*   matching for event-bound server requests during SSR/prerender
-* - Object.fromEntries(event.req.headers.entries()) replaces direct event.node.req.headers access
-*
-* `fetchWithEvent` keeps the active event context while forwarding to a
-* rewritten path, which avoids falling through to the HTML renderer when
-* SSR code makes relative API requests.
-*/
-var apiMiddleware = `
-import { defineHandler, fetchWithEvent, proxyRequest } from 'nitro/h3';
-import { useRuntimeConfig } from 'nitro/runtime-config';
-
-export default defineHandler(async (event) => {
-  const prefix = useRuntimeConfig().prefix;
-  const apiPrefix = \`\${prefix}/\${useRuntimeConfig().apiPrefix}\`;
-
-  if (event.path?.startsWith(apiPrefix)) {
-    const reqUrl = event.path?.replace(apiPrefix, '');
-
-    if (
-      event.method === 'GET' &&
-      // in the case of XML routes, we want to proxy the request so that nitro gets the correct headers
-      // and can render the XML correctly as a static asset
-      !event.path?.endsWith('.xml')
-    ) {
-      return fetchWithEvent(event, reqUrl, {
-        headers: Object.fromEntries(event.req.headers.entries()),
-      });
-    }
-
-    return proxyRequest(event, reqUrl);
-  }
-});`;
 //#endregion
-export { SERVER_FETCH_FACTORY_SNIPPET, apiMiddleware, clientRenderer, ssrRenderer };
+export { SERVER_FETCH_FACTORY_SNIPPET, clientRenderer, ssrRenderer };
 
 //# sourceMappingURL=renderers.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"renderers.js","names":[],"sources":["../../../../../../packages/vite-plugin-nitro/src/lib/utils/renderers.ts"],"sourcesContent":["/**\n * Code snippet emitted into virtual modules to create a request-scoped\n * fetch using ofetch's `createFetch` + h3's `fetchWithEvent`.\n *\n * Shared between the SSR renderer and page-endpoint virtual modules so\n * the fetch-wiring logic stays in sync.\n *\n * The emitted variable is named `serverFetch` — callers should reference it\n * by that name.\n */\nexport const SERVER_FETCH_FACTORY_SNIPPET = `\n  const serverFetch = createFetch({\n    fetch: (resource, init) => {\n      const url = resource instanceof Request ? resource.url : resource.toString();\n      return fetchWithEvent(event, url, init);\n    }\n  });`;\n\n/**\n * SSR renderer virtual module content.\n *\n * This code runs inside Nitro's server runtime (Node.js context) where\n * event.node is always populated. In h3 v2, event.node is typed as optional,\n * so we use h3's first-class event properties (event.path, event.method) where\n * possible and apply optional chaining when accessing the Node.js context for\n * the Angular renderer which requires raw req/res objects.\n *\n * h3 v2 idiomatic APIs used:\n * - defineHandler (replaces defineEventHandler / eventHandler)\n * - event.path (replaces event.node.req.url)\n * - getResponseHeader compat shim (still available in h3 v2)\n */\nexport function ssrRenderer(templatePath: string) {\n  return `\nimport { readFileSync } from 'node:fs';\nimport { createFetch } from 'ofetch';\nimport { defineHandler, fetchWithEvent } from 'nitro/h3';\n// @ts-ignore\nimport renderer from '#analog/ssr';\n\nconst template = readFileSync(${JSON.stringify(templatePath)}, 'utf8');\nconst normalizeHtmlRequestUrl = (url) =>\n  url.replace(/\\\\/index\\\\.html(?=$|[?#])/, '/');\n\nexport default defineHandler(async (event) => {\n  event.res.headers.set('content-type', 'text/html; charset=utf-8');\n  const noSSR = event.res.headers.get('x-analog-no-ssr');\n  const requestPath = normalizeHtmlRequestUrl(event.path);\n\n  if (noSSR === 'true') {\n    return template;\n  }\n\n  // event.path is the canonical h3 v2 way to access the request URL.\n  // event.node?.req and event.node?.res are needed by the Angular SSR renderer\n  // which operates on raw Node.js request/response objects.\n  // During prerendering (Nitro v3 fetch-based pipeline), event.node is undefined.\n  // The Angular renderer requires a req object with at least { headers, url },\n  // so we provide a minimal stub to avoid runtime errors in prerender context.\n  const req = event.node?.req\n    ? {\n        ...event.node.req,\n        url: requestPath,\n        originalUrl: requestPath,\n      }\n    : {\n    headers: { host: 'localhost' },\n    url: requestPath,\n    originalUrl: requestPath,\n    connection: {},\n  };\n  const res = event.node?.res;\n${SERVER_FETCH_FACTORY_SNIPPET}\n\n  const html = await renderer(requestPath, template, { req, res, fetch: serverFetch });\n\n  return html;\n});`;\n}\n\n/**\n * Client-only renderer virtual module content.\n *\n * Used when SSR is disabled — simply serves the static index.html template\n * for every route, letting the client-side Angular router handle navigation.\n */\nexport function clientRenderer(templatePath: string) {\n  return `\nimport { readFileSync } from 'node:fs';\nimport { defineHandler } from 'nitro/h3';\n\nconst template = readFileSync(${JSON.stringify(templatePath)}, 'utf8');\n\nexport default defineHandler(async (event) => {\n  event.res.headers.set('content-type', 'text/html; charset=utf-8');\n  return template;\n});\n`;\n}\n\n/**\n * API middleware virtual module content.\n *\n * Intercepts requests matching the configured API prefix and either:\n * - Uses event-bound internal forwarding for GET requests (except .xml routes)\n * - Uses request proxying for all other methods to forward the full request\n *\n * h3 v2 idiomatic APIs used:\n * - defineHandler (replaces defineEventHandler / eventHandler)\n * - event.path (replaces event.node.req.url)\n * - event.method (replaces event.node.req.method)\n * - proxyRequest is retained internally because it preserves Nitro route\n *   matching for event-bound server requests during SSR/prerender\n * - Object.fromEntries(event.req.headers.entries()) replaces direct event.node.req.headers access\n *\n * `fetchWithEvent` keeps the active event context while forwarding to a\n * rewritten path, which avoids falling through to the HTML renderer when\n * SSR code makes relative API requests.\n */\nexport const apiMiddleware = `\nimport { defineHandler, fetchWithEvent, proxyRequest } from 'nitro/h3';\nimport { useRuntimeConfig } from 'nitro/runtime-config';\n\nexport default defineHandler(async (event) => {\n  const prefix = useRuntimeConfig().prefix;\n  const apiPrefix = \\`\\${prefix}/\\${useRuntimeConfig().apiPrefix}\\`;\n\n  if (event.path?.startsWith(apiPrefix)) {\n    const reqUrl = event.path?.replace(apiPrefix, '');\n\n    if (\n      event.method === 'GET' &&\n      // in the case of XML routes, we want to proxy the request so that nitro gets the correct headers\n      // and can render the XML correctly as a static asset\n      !event.path?.endsWith('.xml')\n    ) {\n      return fetchWithEvent(event, reqUrl, {\n        headers: Object.fromEntries(event.req.headers.entries()),\n      });\n    }\n\n    return proxyRequest(event, reqUrl);\n  }\n});`;\n"],"mappings":";;;;;;;;;;;AAUA,IAAa,+BAA+B;;;;;;;;;;;;;;;;;;;;;AAsB5C,SAAgB,YAAY,cAAsB;AAChD,QAAO;;;;;;;gCAOuB,KAAK,UAAU,aAAa,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAgC3D,6BAA6B;;;;;;;;;;;;;AAc/B,SAAgB,eAAe,cAAsB;AACnD,QAAO;;;;gCAIuB,KAAK,UAAU,aAAa,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;AA4B7D,IAAa,gBAAgB"}
+{"version":3,"file":"renderers.js","names":[],"sources":["../../../../src/lib/utils/renderers.ts"],"sourcesContent":["/**\n * Code snippet emitted into virtual modules to create a request-scoped\n * fetch using ofetch's `createFetch` + h3's `fetchWithEvent`.\n *\n * Shared between the SSR renderer and page-endpoint virtual modules so\n * the fetch-wiring logic stays in sync.\n *\n * The emitted variable is named `serverFetch` — callers should reference it\n * by that name.\n */\nexport const SERVER_FETCH_FACTORY_SNIPPET = `\n  const serverFetch = createFetch({\n    fetch: (resource, init) => {\n      const url = resource instanceof Request ? resource.url : resource.toString();\n      return fetchWithEvent(event, url, init);\n    }\n  });`;\n\n/**\n * SSR renderer virtual module content.\n *\n * This code runs inside Nitro's server runtime (Node.js context) where\n * event.node is always populated. In h3 v2, event.node is typed as optional,\n * so we use h3's first-class event properties (event.path, event.method) where\n * possible and apply optional chaining when accessing the Node.js context for\n * the Angular renderer which requires raw req/res objects.\n *\n * h3 v2 idiomatic APIs used:\n * - defineHandler (replaces defineEventHandler / eventHandler)\n * - event.path (replaces event.node.req.url)\n * - getResponseHeader compat shim (still available in h3 v2)\n */\nexport function ssrRenderer() {\n  return `\nimport { createFetch } from 'ofetch';\nimport { defineHandler, fetchWithEvent } from 'nitro/h3';\n// @ts-ignore\nimport renderer from '#analog/ssr';\nimport template from '#analog/index';\n\nconst normalizeHtmlRequestUrl = (url) =>\n  url.replace(/\\\\/index\\\\.html(?=$|[?#])/, '/');\n\nexport default defineHandler(async (event) => {\n  event.res.headers.set('content-type', 'text/html; charset=utf-8');\n  const noSSR = event.res.headers.get('x-analog-no-ssr');\n  const requestPath = normalizeHtmlRequestUrl(event.path);\n\n  if (noSSR === 'true') {\n    return template;\n  }\n\n  // event.path is the canonical h3 v2 way to access the request URL.\n  // event.node?.req and event.node?.res are needed by the Angular SSR renderer\n  // which operates on raw Node.js request/response objects.\n  // During prerendering (Nitro v3 fetch-based pipeline), event.node is undefined.\n  // The Angular renderer requires a req object with at least { headers, url },\n  // so we provide a minimal stub to avoid runtime errors in prerender context.\n  const req = event.node?.req\n    ? {\n        ...event.node.req,\n        url: requestPath,\n        originalUrl: requestPath,\n      }\n    : {\n    headers: { host: 'localhost' },\n    url: requestPath,\n    originalUrl: requestPath,\n    connection: {},\n  };\n  const res = event.node?.res;\n${SERVER_FETCH_FACTORY_SNIPPET}\n\n  const html = await renderer(requestPath, template, { req, res, fetch: serverFetch });\n\n  return html;\n});`;\n}\n\n/**\n * Client-only renderer virtual module content.\n *\n * Used when SSR is disabled — simply serves the static index.html template\n * for every route, letting the client-side Angular router handle navigation.\n */\nexport function clientRenderer() {\n  return `\nimport { defineHandler } from 'nitro/h3';\nimport template from '#analog/index';\n\nexport default defineHandler(async (event) => {\n  event.res.headers.set('content-type', 'text/html; charset=utf-8');\n  return template;\n});\n`;\n}\n"],"mappings":";;;;;;;;;;;AAUA,IAAa,+BAA+B;;;;;;;;;;;;;;;;;;;;;AAsB5C,SAAgB,cAAc;AAC5B,QAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAsCP,6BAA6B;;;;;;;;;;;;;AAc/B,SAAgB,iBAAiB;AAC/B,QAAO"}

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

@@ -1,2 +1,2 @@
 export declare function isRolldown(): boolean;
-export declare function getBundleOptionsKey(): 'rolldownOptions' | 'rollupOptions';
+export declare function getBundleOptionsKey(): "rolldownOptions" | "rollupOptions";

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

@@ -1 +1 @@
-{"version":3,"file":"rolldown.js","names":[],"sources":["../../../../../../packages/vite-plugin-nitro/src/lib/utils/rolldown.ts"],"sourcesContent":["import * as vite from 'vite';\n\nexport function isRolldown(): boolean {\n  return !!vite.rolldownVersion;\n}\n\nexport function getBundleOptionsKey(): 'rolldownOptions' | 'rollupOptions' {\n  return isRolldown() ? 'rolldownOptions' : 'rollupOptions';\n}\n"],"mappings":";;AAEA,SAAgB,aAAsB;AACpC,QAAO,CAAC,CAAC,KAAK;;AAGhB,SAAgB,sBAA2D;AACzE,QAAO,YAAY,GAAG,oBAAoB"}
+{"version":3,"file":"rolldown.js","names":[],"sources":["../../../../src/lib/utils/rolldown.ts"],"sourcesContent":["import * as vite from 'vite';\n\nexport function isRolldown(): boolean {\n  return !!vite.rolldownVersion;\n}\n\nexport function getBundleOptionsKey(): 'rolldownOptions' | 'rollupOptions' {\n  return isRolldown() ? 'rolldownOptions' : 'rollupOptions';\n}\n"],"mappings":";;AAEA,SAAgB,aAAsB;AACpC,QAAO,CAAC,CAAC,KAAK;;AAGhB,SAAgB,sBAA2D;AACzE,QAAO,YAAY,GAAG,oBAAoB"}

package/src/lib/utils/server-fn-endpoints.d.ts

@@ -0,0 +1,41 @@
+import type { NitroEventHandler } from "nitropack";
+import type { ServerFnHandlerModule } from "./get-server-fn-handlers";
+/**
+* Nitro virtual-module id for the generated server-function dispatch handler.
+* Referenced from `nitroConfig.handlers` and provided via `nitroConfig.virtual`.
+*/
+export declare const SERVER_FN_DISPATCH_VIRTUAL = "#ANALOG_SERVER_FN_DISPATCH";
+/** The single transport route all server functions dispatch through. */
+export declare const SERVER_FN_DISPATCH_ROUTE = "/_analog/fn/:id";
+/** URL prefix of that route, for matching requests before the id is known. */
+export declare const SERVER_FN_DISPATCH_PREFIX = "/_analog/fn/";
+/**
+* The Nitro handler registration for the server-function dispatch route.
+* Unlike page endpoints (one handler per file), every server function shares
+* this one `/_analog/fn/:id` route; the id selects the function at runtime.
+*
+* The route is fixed and NOT `/api`-prefixed: client proxies always call the
+* absolute `/_analog/fn/:id` URL, so an `/api` prefix (as page endpoints use)
+* would leave the handler unreachable in apps that have an API directory.
+*/
+export declare function getServerFnDispatchHandler(): NitroEventHandler;
+export type BuildServerFnDispatchModuleArgs = {
+	/** Discovered `*.server.ts` modules, imported for registration side-effects. */
+	modules: ServerFnHandlerModule[];
+	/**
+	* Absolute path to the app's server config module (`app.config.server.ts`),
+	* which exports the `ApplicationConfig` (as `config`) that `main.server.ts`
+	* renders with. Handlers bootstrap against it, so they see the same DI the
+	* app configured. When absent, handlers run with only `providedIn: 'root'`.
+	*/
+	appConfigModule?: string;
+};
+/**
+* Generates the source of the Nitro dispatch handler.
+*
+* The handler imports every discovered `*.server.ts` module so each
+* `serverFn(...)` registers itself, imports the app's server config, then on
+* each request looks up the function by id and runs it via `dispatchServerFn` —
+* the same call path the validation harnesses exercise.
+*/
+export declare function buildServerFnDispatchModule({ modules, appConfigModule }: BuildServerFnDispatchModuleArgs): string;

package/src/lib/utils/server-fn-endpoints.js

@@ -0,0 +1,57 @@
+import { normalizePath } from "vite";
+//#region packages/vite-plugin-nitro/src/lib/utils/server-fn-endpoints.ts
+/**
+* Nitro virtual-module id for the generated server-function dispatch handler.
+* Referenced from `nitroConfig.handlers` and provided via `nitroConfig.virtual`.
+*/
+var SERVER_FN_DISPATCH_VIRTUAL = "#ANALOG_SERVER_FN_DISPATCH";
+/** The single transport route all server functions dispatch through. */
+var SERVER_FN_DISPATCH_ROUTE = "/_analog/fn/:id";
+/**
+* The Nitro handler registration for the server-function dispatch route.
+* Unlike page endpoints (one handler per file), every server function shares
+* this one `/_analog/fn/:id` route; the id selects the function at runtime.
+*
+* The route is fixed and NOT `/api`-prefixed: client proxies always call the
+* absolute `/_analog/fn/:id` URL, so an `/api` prefix (as page endpoints use)
+* would leave the handler unreachable in apps that have an API directory.
+*/
+function getServerFnDispatchHandler() {
+	return {
+		route: SERVER_FN_DISPATCH_ROUTE,
+		handler: SERVER_FN_DISPATCH_VIRTUAL,
+		lazy: true
+	};
+}
+/**
+* Generates the source of the Nitro dispatch handler.
+*
+* The handler imports every discovered `*.server.ts` module so each
+* `serverFn(...)` registers itself, imports the app's server config, then on
+* each request looks up the function by id and runs it via `dispatchServerFn` —
+* the same call path the validation harnesses exercise.
+*/
+function buildServerFnDispatchModule({ modules, appConfigModule }) {
+	return `import '@angular/compiler';
+import 'zone.js/node';
+import '@angular/platform-server/init';
+import { createServerFnAppInjector, createServerFnEventHandler } from '@analogjs/router/server';
+
+// Discovered server-function modules (registration side-effects).
+${modules.map((m) => `import ${JSON.stringify(normalizePath(m.file))};`).join("\n")}
+
+${appConfigModule ? `import { config as serverFnAppConfig } from ${JSON.stringify(normalizePath(appConfigModule))};` : `const serverFnAppConfig = { providers: [] };`}
+
+// Bootstrapped once from the app's own server config, so a handler resolves the
+// same DI as an SSR render (\`providedIn: 'root'\` and listed providers alike).
+// No component is bootstrapped, so nothing renders and the router never
+// navigates. Only REQUEST/RESPONSE are rebuilt per call.
+export default createServerFnEventHandler(
+  createServerFnAppInjector(serverFnAppConfig),
+);
+`;
+}
+//#endregion
+export { SERVER_FN_DISPATCH_VIRTUAL, buildServerFnDispatchModule, getServerFnDispatchHandler };
+
+//# sourceMappingURL=server-fn-endpoints.js.map