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

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

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

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

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

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

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

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

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

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

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

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

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

package/src/lib/ssr/inject-html-plugin.js

@@ -1,28 +1,28 @@
-import { VERSION } from '@angular/compiler-cli';
-import { readFile } from 'node:fs/promises';
-import { createRequire } from 'node:module';
-const require = createRequire(import.meta.url);
+import { createRequire } from "node:module";
+import { VERSION } from "@angular/compiler-cli";
+import { readFile } from "node:fs/promises";
+//#region packages/platform/src/lib/ssr/inject-html-plugin.ts
+var require = createRequire(import.meta.url);
 function eventReplayPlugin() {
-    return {
-        name: 'analogjs-event-replay-plugin',
-        async transformIndexHtml() {
-            const eventReplayScript = await readFile(require.resolve('@angular/core/event-dispatch-contract.min.js'), 'utf-8');
-            return [
-                {
-                    tag: 'script',
-                    attrs: {
-                        type: 'text/javascript',
-                        id: 'ng-event-dispatch-contract',
-                    },
-                    children: eventReplayScript,
-                    injectTo: 'body',
-                },
-            ];
-        },
-    };
+	return {
+		name: "analogjs-event-replay-plugin",
+		async transformIndexHtml() {
+			return [{
+				tag: "script",
+				attrs: {
+					type: "text/javascript",
+					id: "ng-event-dispatch-contract"
+				},
+				children: await readFile(require.resolve("@angular/core/event-dispatch-contract.min.js"), "utf-8"),
+				injectTo: "body"
+			}];
+		}
+	};
 }
-export function injectHTMLPlugin() {
-    const hasEventReplay = Number(VERSION.major) >= 18;
-    return hasEventReplay ? [eventReplayPlugin()] : [];
+function injectHTMLPlugin() {
+	return Number(VERSION.major) >= 18 ? [eventReplayPlugin()] : [];
 }
-//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW5qZWN0LWh0bWwtcGx1Z2luLmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vLi4vLi4vLi4vLi4vcGFja2FnZXMvcGxhdGZvcm0vc3JjL2xpYi9zc3IvaW5qZWN0LWh0bWwtcGx1Z2luLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQUFBLE9BQU8sRUFBRSxPQUFPLEVBQUUsTUFBTSx1QkFBdUIsQ0FBQztBQUVoRCxPQUFPLEVBQUUsUUFBUSxFQUFFLE1BQU0sa0JBQWtCLENBQUM7QUFDNUMsT0FBTyxFQUFFLGFBQWEsRUFBRSxNQUFNLGFBQWEsQ0FBQztBQUU1QyxNQUFNLE9BQU8sR0FBRyxhQUFhLENBQUMsTUFBTSxDQUFDLElBQUksQ0FBQyxHQUFHLENBQUMsQ0FBQztBQUUvQyxTQUFTLGlCQUFpQjtJQUN4QixPQUFPO1FBQ0wsSUFBSSxFQUFFLDhCQUE4QjtRQUNwQyxLQUFLLENBQUMsa0JBQWtCO1lBQ3RCLE1BQU0saUJBQWlCLEdBQUcsTUFBTSxRQUFRLENBQ3RDLE9BQU8sQ0FBQyxPQUFPLENBQUMsOENBQThDLENBQUMsRUFDL0QsT0FBTyxDQUNSLENBQUM7WUFFRixPQUFPO2dCQUNMO29CQUNFLEdBQUcsRUFBRSxRQUFRO29CQUNiLEtBQUssRUFBRTt3QkFDTCxJQUFJLEVBQUUsaUJBQWlCO3dCQUN2QixFQUFFLEVBQUUsNEJBQTRCO3FCQUNqQztvQkFDRCxRQUFRLEVBQUUsaUJBQWlCO29CQUMzQixRQUFRLEVBQUUsTUFBTTtpQkFDakI7YUFDRixDQUFDO1FBQ0osQ0FBQztLQUNGLENBQUM7QUFDSixDQUFDO0FBRUQsTUFBTSxVQUFVLGdCQUFnQjtJQUM5QixNQUFNLGNBQWMsR0FBRyxNQUFNLENBQUMsT0FBTyxDQUFDLEtBQUssQ0FBQyxJQUFJLEVBQUUsQ0FBQztJQUVuRCxPQUFPLGNBQWMsQ0FBQyxDQUFDLENBQUMsQ0FBQyxpQkFBaUIsRUFBRSxDQUFDLENBQUMsQ0FBQyxDQUFDLEVBQUUsQ0FBQztBQUNyRCxDQUFDIn0=
+//#endregion
+export { injectHTMLPlugin };
+
+//# sourceMappingURL=inject-html-plugin.js.map

package/src/lib/ssr/inject-html-plugin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"inject-html-plugin.js","names":[],"sources":["../../../../src/lib/ssr/inject-html-plugin.ts"],"sourcesContent":["import { VERSION } from '@angular/compiler-cli';\nimport { Plugin } from 'vite';\nimport { readFile } from 'node:fs/promises';\nimport { createRequire } from 'node:module';\n\nconst require = createRequire(import.meta.url);\n\nfunction eventReplayPlugin(): Plugin {\n  return {\n    name: 'analogjs-event-replay-plugin',\n    async transformIndexHtml() {\n      const eventReplayScript = await readFile(\n        require.resolve('@angular/core/event-dispatch-contract.min.js'),\n        'utf-8',\n      );\n\n      return [\n        {\n          tag: 'script',\n          attrs: {\n            type: 'text/javascript',\n            id: 'ng-event-dispatch-contract',\n          },\n          children: eventReplayScript,\n          injectTo: 'body',\n        },\n      ];\n    },\n  };\n}\n\nexport function injectHTMLPlugin(): Plugin[] {\n  const hasEventReplay = Number(VERSION.major) >= 18;\n\n  return hasEventReplay ? [eventReplayPlugin()] : [];\n}\n"],"mappings":";;;;AAKA,IAAM,UAAU,cAAc,OAAO,KAAK,IAAI;AAE9C,SAAS,oBAA4B;AACnC,QAAO;EACL,MAAM;EACN,MAAM,qBAAqB;AAMzB,UAAO,CACL;IACE,KAAK;IACL,OAAO;KACL,MAAM;KACN,IAAI;KACL;IACD,UAZsB,MAAM,SAC9B,QAAQ,QAAQ,+CAA+C,EAC/D,QACD;IAUG,UAAU;IACX,CACF;;EAEJ;;AAGH,SAAgB,mBAA6B;AAG3C,QAFuB,OAAO,QAAQ,MAAM,IAAI,KAExB,CAAC,mBAAmB,CAAC,GAAG,EAAE"}

package/src/lib/ssr/ssr-build-plugin.d.ts

@@ -1,18 +1,26 @@
-import * as vite from 'vite';
+import * as vite from "vite";
 /**
- * SSR build patches for Angular platform-server, Zone.js, and Domino.
- *
- * Returns an array of Vite plugins because under Vite 8+ (Rolldown) we
- * append Rolldown's built-in `replacePlugin` for an AST-safe
- * `global → globalThis` rewrite that avoids false positives inside string
- * literals and comments.
- *
- * **Why each patch exists:**
- * - zone-node: removes a `const global = globalThis` alias that shadows the
- *   real global in strict mode.
- * - platform-server: rewrites `xhr2.XMLHttpRequest` for CJS/ESM compat and
- *   replaces bare `global` references with `globalThis`.
- * - xhr2: strips Node-specific `os`/`process` references for SSR bundling.
- * - domino/sloppy.js: replaces `with()` statements that are illegal in ESM.
- */
+* SSR build patches for Angular platform-server, Zone.js, and Domino.
+*
+* **Why each patch exists:**
+* - zone-node: removes a `const global = globalThis` alias that shadows the
+*   real global in strict mode.
+* - platform-server: rewrites `xhr2.XMLHttpRequest` for CJS/ESM compat and
+*   replaces bare `global` references with `globalThis`.
+* - xhr2: strips Node-specific `os`/`process` references for SSR bundling.
+* - domino/sloppy.js: replaces `with()` statements that are illegal in ESM.
+*/
 export declare function ssrBuildPlugin(): vite.Plugin[];
+/**
+* Vite plugin that patches `@angular/core`'s `getComponentId()` to
+* mirror every compiled component definition to a global Set, bypassing
+* the `ngServerMode` guard that normally prevents registration on the
+* server. The set lives at `globalThis.__ngComponentDefs` and is read by
+* `@analogjs/router`'s SSR render function to null cached `tView`
+* objects between requests so that `$localize` tagged templates in
+* `consts()` re-evaluate with the freshly loaded translations.
+*
+* Only active when the platform's `i18n` option is configured.
+* Only transforms `@angular/core` modules in SSR builds.
+*/
+export declare function i18nDefRegistryPlugin(): Plugin;

package/src/lib/ssr/ssr-build-plugin.js

@@ -1,90 +1,39 @@
-import { createRequire } from 'node:module';
-import * as vite from 'vite';
+import * as vite from "vite";
+//#region packages/platform/src/lib/ssr/ssr-build-plugin.ts
 /**
- * SSR build patches for Angular platform-server, Zone.js, and Domino.
- *
- * Returns an array of Vite plugins because under Vite 8+ (Rolldown) we
- * append Rolldown's built-in `replacePlugin` for an AST-safe
- * `global → globalThis` rewrite that avoids false positives inside string
- * literals and comments.
- *
- * **Why each patch exists:**
- * - zone-node: removes a `const global = globalThis` alias that shadows the
- *   real global in strict mode.
- * - platform-server: rewrites `xhr2.XMLHttpRequest` for CJS/ESM compat and
- *   replaces bare `global` references with `globalThis`.
- * - xhr2: strips Node-specific `os`/`process` references for SSR bundling.
- * - domino/sloppy.js: replaces `with()` statements that are illegal in ESM.
- */
-export function ssrBuildPlugin() {
-    const plugins = [
-        {
-            name: 'analogjs-ssr-build-plugin',
-            apply: 'build',
-            config() {
-                return {
-                    ssr: {
-                        noExternal: ['xhr2'],
-                    },
-                };
-            },
-            transform: {
-                filter: {
-                    id: /zone-node|platform-server|xhr2\.js|domino\/lib\/sloppy\.js/,
-                },
-                handler(code, id) {
-                    if (id.includes('zone-node') &&
-                        code.includes('const global = globalThis;')) {
-                        return {
-                            code: code.replace('const global = globalThis;', ''),
-                        };
-                    }
-                    if (id.includes('platform-server')) {
-                        let result = code.replace('new xhr2.XMLHttpRequest', 'new (xhr2.default.XMLHttpRequest || xhr2.default)');
-                        // Under Vite 8+ the appended `replacePlugin` handles
-                        // global → globalThis via AST-aware replacement (scoped to
-                        // platform-server by `withFilter`).  For Vite ≤7 we fall back
-                        // to text-based replaceAll — imprecise but sufficient for the
-                        // known occurrences in @angular/platform-server bundles.
-                        if (!vite.rolldownVersion) {
-                            result = result
-                                .replaceAll('global.', 'globalThis.')
-                                .replaceAll('global,', 'globalThis,')
-                                .replaceAll(' global[', ' globalThis[');
-                        }
-                        return { code: result };
-                    }
-                    if (id.includes(vite.normalizePath('xhr2.js'))) {
-                        return {
-                            code: code
-                                .replace('os.type()', `''`)
-                                .replace('os.arch()', `''`)
-                                .replace('process.versions.node', `'node'`)
-                                .replace('process.versions.v8', `'v8'`),
-                        };
-                    }
-                    if (id.includes(vite.normalizePath('domino/lib/sloppy.js'))) {
-                        return {
-                            code: code.replace(/with\(/gi, 'if('),
-                        };
-                    }
-                    return;
-                },
-            },
-        },
-    ];
-    // Under Vite 8+ (Rolldown), append Rolldown's built-in `replacePlugin`
-    // for AST-aware `global → globalThis` rewriting scoped to platform-server.
-    //
-    // `createRequire` is used instead of dynamic `import()` because this code
-    // runs synchronously during plugin construction (not inside an async hook).
-    // Rolldown is guaranteed to be installed when `vite.rolldownVersion` is truthy.
-    if (vite.rolldownVersion) {
-        const require = createRequire(import.meta.url);
-        const { replacePlugin } = require('rolldown/plugins');
-        const { withFilter } = require('rolldown/filter');
-        plugins.push(withFilter(replacePlugin({ global: 'globalThis' }, { preventAssignment: true, objectGuards: true }), { transform: { id: /platform-server/ } }));
-    }
-    return plugins;
+* SSR build patches for Angular platform-server, Zone.js, and Domino.
+*
+* **Why each patch exists:**
+* - zone-node: removes a `const global = globalThis` alias that shadows the
+*   real global in strict mode.
+* - platform-server: rewrites `xhr2.XMLHttpRequest` for CJS/ESM compat and
+*   replaces bare `global` references with `globalThis`.
+* - xhr2: strips Node-specific `os`/`process` references for SSR bundling.
+* - domino/sloppy.js: replaces `with()` statements that are illegal in ESM.
+*/
+function ssrBuildPlugin() {
+	return [{
+		name: "analogjs-ssr-build-plugin",
+		apply: "build",
+		config() {
+			return { ssr: { noExternal: ["xhr2"] } };
+		},
+		transform: {
+			filter: { id: /zone-node|platform-server|xhr2\.js|domino\/lib\/sloppy\.js/ },
+			handler(code, id) {
+				if (id.includes("zone-node") && code.includes("const global = globalThis;")) return { code: code.replace("const global = globalThis;", "") };
+				if (id.includes("platform-server")) {
+					let result = code.replace("new xhr2.XMLHttpRequest", "new (xhr2.default.XMLHttpRequest || xhr2.default)");
+					result = result.replaceAll("global.", "globalThis.").replaceAll("global,", "globalThis,").replaceAll(" global[", " globalThis[");
+					return { code: result };
+				}
+				if (id.includes(vite.normalizePath("xhr2.js"))) return { code: code.replace("os.type()", `''`).replace("os.arch()", `''`).replace("process.versions.node", `'node'`).replace("process.versions.v8", `'v8'`) };
+				if (id.includes(vite.normalizePath("domino/lib/sloppy.js"))) return { code: code.replace(/with\(/gi, "if(") };
+			}
+		}
+	}];
 }
-//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoic3NyLWJ1aWxkLXBsdWdpbi5qcyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uLy4uLy4uLy4uLy4uL3BhY2thZ2VzL3BsYXRmb3JtL3NyYy9saWIvc3NyL3Nzci1idWlsZC1wbHVnaW4udHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBQUEsT0FBTyxFQUFFLGFBQWEsRUFBRSxNQUFNLGFBQWEsQ0FBQztBQUM1QyxPQUFPLEtBQUssSUFBSSxNQUFNLE1BQU0sQ0FBQztBQUU3Qjs7Ozs7Ozs7Ozs7Ozs7O0dBZUc7QUFDSCxNQUFNLFVBQVUsY0FBYztJQUM1QixNQUFNLE9BQU8sR0FBa0I7UUFDN0I7WUFDRSxJQUFJLEVBQUUsMkJBQTJCO1lBQ2pDLEtBQUssRUFBRSxPQUFPO1lBQ2QsTUFBTTtnQkFDSixPQUFPO29CQUNMLEdBQUcsRUFBRTt3QkFDSCxVQUFVLEVBQUUsQ0FBQyxNQUFNLENBQUM7cUJBQ3JCO2lCQUNGLENBQUM7WUFDSixDQUFDO1lBQ0QsU0FBUyxFQUFFO2dCQUNULE1BQU0sRUFBRTtvQkFDTixFQUFFLEVBQUUsNERBQTREO2lCQUNqRTtnQkFDRCxPQUFPLENBQUMsSUFBSSxFQUFFLEVBQUU7b0JBQ2QsSUFDRSxFQUFFLENBQUMsUUFBUSxDQUFDLFdBQVcsQ0FBQzt3QkFDeEIsSUFBSSxDQUFDLFFBQVEsQ0FBQyw0QkFBNEIsQ0FBQyxFQUMzQyxDQUFDO3dCQUNELE9BQU87NEJBQ0wsSUFBSSxFQUFFLElBQUksQ0FBQyxPQUFPLENBQUMsNEJBQTRCLEVBQUUsRUFBRSxDQUFDO3lCQUNyRCxDQUFDO29CQUNKLENBQUM7b0JBRUQsSUFBSSxFQUFFLENBQUMsUUFBUSxDQUFDLGlCQUFpQixDQUFDLEVBQUUsQ0FBQzt3QkFDbkMsSUFBSSxNQUFNLEdBQUcsSUFBSSxDQUFDLE9BQU8sQ0FDdkIseUJBQXlCLEVBQ3pCLG1EQUFtRCxDQUNwRCxDQUFDO3dCQUVGLHFEQUFxRDt3QkFDckQsMkRBQTJEO3dCQUMzRCw4REFBOEQ7d0JBQzlELDhEQUE4RDt3QkFDOUQseURBQXlEO3dCQUN6RCxJQUFJLENBQUMsSUFBSSxDQUFDLGVBQWUsRUFBRSxDQUFDOzRCQUMxQixNQUFNLEdBQUcsTUFBTTtpQ0FDWixVQUFVLENBQUMsU0FBUyxFQUFFLGFBQWEsQ0FBQztpQ0FDcEMsVUFBVSxDQUFDLFNBQVMsRUFBRSxhQUFhLENBQUM7aUNBQ3BDLFVBQVUsQ0FBQyxVQUFVLEVBQUUsY0FBYyxDQUFDLENBQUM7d0JBQzVDLENBQUM7d0JBRUQsT0FBTyxFQUFFLElBQUksRUFBRSxNQUFNLEVBQUUsQ0FBQztvQkFDMUIsQ0FBQztvQkFFRCxJQUFJLEVBQUUsQ0FBQyxRQUFRLENBQUMsSUFBSSxDQUFDLGFBQWEsQ0FBQyxTQUFTLENBQUMsQ0FBQyxFQUFFLENBQUM7d0JBQy9DLE9BQU87NEJBQ0wsSUFBSSxFQUFFLElBQUk7aUNBQ1AsT0FBTyxDQUFDLFdBQVcsRUFBRSxJQUFJLENBQUM7aUNBQzFCLE9BQU8sQ0FBQyxXQUFXLEVBQUUsSUFBSSxDQUFDO2lDQUMxQixPQUFPLENBQUMsdUJBQXVCLEVBQUUsUUFBUSxDQUFDO2lDQUMxQyxPQUFPLENBQUMscUJBQXFCLEVBQUUsTUFBTSxDQUFDO3lCQUMxQyxDQUFDO29CQUNKLENBQUM7b0JBRUQsSUFBSSxFQUFFLENBQUMsUUFBUSxDQUFDLElBQUksQ0FBQyxhQUFhLENBQUMsc0JBQXNCLENBQUMsQ0FBQyxFQUFFLENBQUM7d0JBQzVELE9BQU87NEJBQ0wsSUFBSSxFQUFFLElBQUksQ0FBQyxPQUFPLENBQUMsVUFBVSxFQUFFLEtBQUssQ0FBQzt5QkFDdEMsQ0FBQztvQkFDSixDQUFDO29CQUVELE9BQU87Z0JBQ1QsQ0FBQzthQUNGO1NBQ0Y7S0FDRixDQUFDO0lBRUYsdUVBQXVFO0lBQ3ZFLDJFQUEyRTtJQUMzRSxFQUFFO0lBQ0YsMEVBQTBFO0lBQzFFLDRFQUE0RTtJQUM1RSxnRkFBZ0Y7SUFDaEYsSUFBSSxJQUFJLENBQUMsZUFBZSxFQUFFLENBQUM7UUFDekIsTUFBTSxPQUFPLEdBQUcsYUFBYSxDQUFDLE1BQU0sQ0FBQyxJQUFJLENBQUMsR0FBRyxDQUFDLENBQUM7UUFDL0MsTUFBTSxFQUFFLGFBQWEsRUFBRSxHQUNyQixPQUFPLENBQUMsa0JBQWtCLENBQXNDLENBQUM7UUFDbkUsTUFBTSxFQUFFLFVBQVUsRUFBRSxHQUNsQixPQUFPLENBQUMsaUJBQWlCLENBQXFDLENBQUM7UUFFakUsT0FBTyxDQUFDLElBQUksQ0FDVixVQUFVLENBQ1IsYUFBYSxDQUNYLEVBQUUsTUFBTSxFQUFFLFlBQVksRUFBRSxFQUN4QixFQUFFLGlCQUFpQixFQUFFLElBQUksRUFBRSxZQUFZLEVBQUUsSUFBSSxFQUFFLENBQ2hELEVBQ0QsRUFBRSxTQUFTLEVBQUUsRUFBRSxFQUFFLEVBQUUsaUJBQWlCLEVBQUUsRUFBRSxDQUNmLENBQzVCLENBQUM7SUFDSixDQUFDO0lBRUQsT0FBTyxPQUFPLENBQUM7QUFDakIsQ0FBQyJ9
+//#endregion
+export { ssrBuildPlugin };
+
+//# sourceMappingURL=ssr-build-plugin.js.map

package/src/lib/ssr/ssr-build-plugin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ssr-build-plugin.js","names":[],"sources":["../../../../src/lib/ssr/ssr-build-plugin.ts"],"sourcesContent":["import * as vite from 'vite';\n\n/**\n * SSR build patches for Angular platform-server, Zone.js, and Domino.\n *\n * **Why each patch exists:**\n * - zone-node: removes a `const global = globalThis` alias that shadows the\n *   real global in strict mode.\n * - platform-server: rewrites `xhr2.XMLHttpRequest` for CJS/ESM compat and\n *   replaces bare `global` references with `globalThis`.\n * - xhr2: strips Node-specific `os`/`process` references for SSR bundling.\n * - domino/sloppy.js: replaces `with()` statements that are illegal in ESM.\n */\nexport function ssrBuildPlugin(): vite.Plugin[] {\n  const plugins: vite.Plugin[] = [\n    {\n      name: 'analogjs-ssr-build-plugin',\n      apply: 'build',\n      config() {\n        return {\n          ssr: {\n            noExternal: ['xhr2'],\n          },\n        };\n      },\n      transform: {\n        filter: {\n          id: /zone-node|platform-server|xhr2\\.js|domino\\/lib\\/sloppy\\.js/,\n        },\n        handler(code, id) {\n          if (\n            id.includes('zone-node') &&\n            code.includes('const global = globalThis;')\n          ) {\n            return {\n              code: code.replace('const global = globalThis;', ''),\n            };\n          }\n\n          if (id.includes('platform-server')) {\n            let result = code.replace(\n              'new xhr2.XMLHttpRequest',\n              'new (xhr2.default.XMLHttpRequest || xhr2.default)',\n            );\n\n            // Narrowly scoped text replacement of the bare `global`\n            // identifier. Matching `global.`, `global,` and ` global[`\n            // targets the known occurrences in the @angular/platform-server\n            // bundle while leaving strings, comments and asset paths that\n            // merely contain the word `global` untouched (see #2426).\n            result = result\n              .replaceAll('global.', 'globalThis.')\n              .replaceAll('global,', 'globalThis,')\n              .replaceAll(' global[', ' globalThis[');\n\n            return { code: result };\n          }\n\n          if (id.includes(vite.normalizePath('xhr2.js'))) {\n            return {\n              code: code\n                .replace('os.type()', `''`)\n                .replace('os.arch()', `''`)\n                .replace('process.versions.node', `'node'`)\n                .replace('process.versions.v8', `'v8'`),\n            };\n          }\n\n          if (id.includes(vite.normalizePath('domino/lib/sloppy.js'))) {\n            return {\n              code: code.replace(/with\\(/gi, 'if('),\n            };\n          }\n\n          return;\n        },\n      },\n    },\n  ];\n\n  return plugins;\n}\n\n/**\n * Vite plugin that patches `@angular/core`'s `getComponentId()` to\n * mirror every compiled component definition to a global Set, bypassing\n * the `ngServerMode` guard that normally prevents registration on the\n * server. The set lives at `globalThis.__ngComponentDefs` and is read by\n * `@analogjs/router`'s SSR render function to null cached `tView`\n * objects between requests so that `$localize` tagged templates in\n * `consts()` re-evaluate with the freshly loaded translations.\n *\n * Only active when the platform's `i18n` option is configured.\n * Only transforms `@angular/core` modules in SSR builds.\n */\nexport function i18nDefRegistryPlugin(): Plugin {\n  const DETECT_MARKER = 'GENERATED_COMP_IDS.set(compId, componentDef.type);';\n  const RETURN_STMT = 'return compId;\\n}';\n\n  return {\n    name: 'analogjs-i18n-def-registry',\n    enforce: 'post',\n\n    transform: {\n      filter: {\n        id: /\\/@angular\\/core\\//,\n      },\n      handler(code, id, options) {\n        if (!options?.ssr) return;\n        if (!code.includes(DETECT_MARKER)) return;\n\n        return {\n          code: code.replace(\n            RETURN_STMT,\n            '(globalThis.__ngComponentDefs ??= new Set()).add(componentDef);\\n' +\n              RETURN_STMT,\n          ),\n        };\n      },\n    },\n  };\n}\n"],"mappings":";;;;;;;;;;;;;AAaA,SAAgB,iBAAgC;AAmE9C,QAlE+B,CAC7B;EACE,MAAM;EACN,OAAO;EACP,SAAS;AACP,UAAO,EACL,KAAK,EACH,YAAY,CAAC,OAAO,EACrB,EACF;;EAEH,WAAW;GACT,QAAQ,EACN,IAAI,8DACL;GACD,QAAQ,MAAM,IAAI;AAChB,QACE,GAAG,SAAS,YAAY,IACxB,KAAK,SAAS,6BAA6B,CAE3C,QAAO,EACL,MAAM,KAAK,QAAQ,8BAA8B,GAAG,EACrD;AAGH,QAAI,GAAG,SAAS,kBAAkB,EAAE;KAClC,IAAI,SAAS,KAAK,QAChB,2BACA,oDACD;AAOD,cAAS,OACN,WAAW,WAAW,cAAc,CACpC,WAAW,WAAW,cAAc,CACpC,WAAW,YAAY,eAAe;AAEzC,YAAO,EAAE,MAAM,QAAQ;;AAGzB,QAAI,GAAG,SAAS,KAAK,cAAc,UAAU,CAAC,CAC5C,QAAO,EACL,MAAM,KACH,QAAQ,aAAa,KAAK,CAC1B,QAAQ,aAAa,KAAK,CAC1B,QAAQ,yBAAyB,SAAS,CAC1C,QAAQ,uBAAuB,OAAO,EAC1C;AAGH,QAAI,GAAG,SAAS,KAAK,cAAc,uBAAuB,CAAC,CACzD,QAAO,EACL,MAAM,KAAK,QAAQ,YAAY,MAAM,EACtC;;GAKN;EACF,CACF"}

package/src/lib/typed-routes-plugin.d.ts

@@ -0,0 +1,50 @@
+import { type Plugin } from "vite";
+export interface TypedRoutesPluginOptions {
+	/**
+	* Output path for the single generated route module,
+	* relative to the app root.
+	*
+	* @default 'src/routeTree.gen.ts'
+	*/
+	outFile?: string;
+	/**
+	* Workspace root used to resolve additional route/content directories.
+	*
+	* @default process.env['NX_WORKSPACE_ROOT'] ?? process.cwd()
+	*/
+	workspaceRoot?: string;
+	/**
+	* Additional page directories to scan for `.page.ts` files.
+	*/
+	additionalPagesDirs?: string[];
+	/**
+	* Additional content directories to scan for `.md` files.
+	*/
+	additionalContentDirs?: string[];
+	/**
+	* Include generated `routeJsonLdManifest` exports in the generated route file.
+	*
+	* @default true
+	*/
+	jsonLdManifest?: boolean;
+	/**
+	* When true, compare generated output against the existing file and
+	* throw an error if they differ instead of writing. Useful for CI to
+	* detect stale checked-in route files.
+	*
+	* @default false
+	*/
+	verify?: boolean;
+	/**
+	* When true, production builds fail after regenerating a stale checked-in
+	* route file. This preserves self-healing writes in development while making
+	* build-time freshness issues visible by default.
+	*
+	* @default true
+	*/
+	verifyOnBuild?: boolean;
+}
+/**
+* Vite plugin that generates a single typed route module for Analog file routes.
+*/
+export declare function typedRoutes(options?: TypedRoutesPluginOptions): Plugin;