@vertz/ui-server 0.2.31 → 0.2.33

package/dist/shared/{chunk-es0406qq.js → chunk-xdb8qn68.js}

@@ -5,10 +5,12 @@ import {
   resolveRouteModulepreload,
   resolveSession,
   safeSerialize,
+  ssrRenderAot,
   ssrRenderProgressive,
   ssrRenderSinglePass,
-  ssrStreamNavQueries
-} from "./chunk-34fexgex.js";
+  ssrStreamNavQueries,
+  toPrefetchSession
+} from "./chunk-hx7drzm3.js";
 
 // src/node-handler.ts
 function createNodeHandler(options) {
@@ -21,7 +23,8 @@ function createNodeHandler(options) {
     cacheControl,
     sessionResolver,
     manifest,
-    progressiveHTML
+    progressiveHTML,
+    aotManifest
   } = options;
   const { template, linkHeader, modulepreloadTags, splitResult } = precomputeHandlerState(options);
   const useProgressive = progressiveHTML && splitResult && !(manifest?.routeEntries && Object.keys(manifest.routeEntries).length > 0);
@@ -50,11 +53,20 @@ function createNodeHandler(options) {
           await handleProgressiveRequest(req, res, module, splitResult, url, ssrTimeout, nonce, fallbackMetrics, linkHeader, modulepreloadTags, routeChunkManifest, cacheControl, sessionScript, ssrAuth, manifest);
           return;
         }
-        const result = await ssrRenderSinglePass(module, url, {
+        const prefetchSession = ssrAuth ? toPrefetchSession(ssrAuth) : undefined;
+        const result = aotManifest ? await ssrRenderAot(module, url, {
+          aotManifest,
+          manifest,
           ssrTimeout,
           fallbackMetrics,
           ssrAuth,
-          manifest
+          prefetchSession
+        }) : await ssrRenderSinglePass(module, url, {
+          ssrTimeout,
+          fallbackMetrics,
+          ssrAuth,
+          manifest,
+          prefetchSession
         });
         if (result.redirect) {
           res.writeHead(302, { Location: result.redirect.to });

package/dist/ssr/index.d.ts

@@ -1,4 +1,54 @@
-import { CompiledRoute as CompiledRoute2, FontFallbackMetrics as FontFallbackMetrics2 } from "@vertz/ui";
+/**
+* SSR prefetch access rule evaluator.
+*
+* Evaluates serialized entity access rules against the current session
+* to determine whether a query should be prefetched during SSR.
+*
+* The serialized rules come from the prefetch manifest (generated at build time).
+* The session comes from the JWT decoded at request time.
+*/
+/**
+* Serialized access rule — the JSON-friendly format stored in the manifest.
+* Mirrors SerializedRule from @vertz/server/auth/rules but defined here
+* to avoid importing the server package into the SSR pipeline.
+*/
+type SerializedAccessRule = {
+	type: "public";
+} | {
+	type: "authenticated";
+} | {
+	type: "role";
+	roles: string[];
+} | {
+	type: "entitlement";
+	value: string;
+} | {
+	type: "where";
+	conditions: Record<string, unknown>;
+} | {
+	type: "all";
+	rules: SerializedAccessRule[];
+} | {
+	type: "any";
+	rules: SerializedAccessRule[];
+} | {
+	type: "fva";
+	maxAge: number;
+} | {
+	type: "deny";
+};
+/**
+* Minimal session shape needed for prefetch access evaluation.
+* Extracted from the JWT at SSR request time.
+*/
+type PrefetchSession = {
+	status: "authenticated";
+	roles?: string[];
+	entitlements?: Record<string, boolean>;
+	tenantId?: string;
+} | {
+	status: "unauthenticated";
+};
 import { CompiledRoute, FontFallbackMetrics, Theme } from "@vertz/ui";
 import { SSRAuth as SSRAuth_jq1nwm } from "@vertz/ui/internals";
 interface SSRModule {
@@ -67,6 +117,60 @@ declare function ssrRenderToString(module: SSRModule, url: string, options?: {
 declare function ssrDiscoverQueries(module: SSRModule, url: string, options?: {
 	ssrTimeout?: number;
 }): Promise<SSRDiscoverResult>;
+import { ExtractedQuery } from "@vertz/ui-compiler";
+/** Serialized entity access rules from the prefetch manifest. */
+type EntityAccessMap = Record<string, Partial<Record<string, SerializedAccessRule>>>;
+interface SSRPrefetchManifest {
+	/** Route patterns present in the manifest. */
+	routePatterns: string[];
+	/** Entity access rules keyed by entity name → operation → serialized rule. */
+	entityAccess?: EntityAccessMap;
+	/** Route entries with query binding metadata for zero-discovery prefetch. */
+	routeEntries?: Record<string, {
+		queries: ExtractedQuery[];
+	}>;
+}
+/** Context passed to AOT render functions for accessing data and runtime holes. */
+interface SSRAotContext {
+	/** Pre-generated closures for runtime-rendered components. */
+	holes: Record<string, () => string>;
+	/** Access query data by cache key. */
+	getData(key: string): unknown;
+	/** Auth session for conditional rendering. */
+	session: PrefetchSession | undefined;
+	/** Route params for the current request. */
+	params: Record<string, string>;
+}
+/** An AOT render function: takes props/data and context, returns HTML string. */
+type AotRenderFn = (data: Record<string, unknown>, ctx: SSRAotContext) => string;
+/** Per-route AOT entry in the manifest. */
+interface AotRouteEntry {
+	/** The pre-compiled render function. */
+	render: AotRenderFn;
+	/** Component names that need runtime fallback (holes). */
+	holes: string[];
+	/** Query cache keys this route reads via ctx.getData(). */
+	queryKeys?: string[];
+}
+/**
+* AOT manifest — maps route patterns to pre-compiled render functions.
+*
+* Generated at build time by the AOT compiler pipeline.
+*/
+interface AotManifest {
+	/** Route pattern → AOT entry. */
+	routes: Record<string, AotRouteEntry>;
+}
+/**
+* Load AOT manifest and routes module from a server build directory.
+*
+* Returns `null` if either `aot-manifest.json` or `aot-routes.js` is missing,
+* or if no routes can be wired to render functions.
+*
+* @param serverDir - Path to `dist/server/` directory
+*/
+declare function loadAotManifest(serverDir: string): Promise<AotManifest | null>;
+import { CompiledRoute as CompiledRoute2, FontFallbackMetrics as FontFallbackMetrics4 } from "@vertz/ui";
 interface PrerenderResult {
 	/** The route path that was pre-rendered. */
 	path: string;
@@ -79,7 +183,7 @@ interface PrerenderOptions {
 	/** CSP nonce for inline scripts. */
 	nonce?: string;
 	/** Pre-computed font fallback metrics for zero-CLS font loading. */
-	fallbackMetrics?: Record<string, FontFallbackMetrics2>;
+	fallbackMetrics?: Record<string, FontFallbackMetrics4>;
 }
 /**
 * Discover all route patterns from an SSR module.
@@ -128,59 +232,7 @@ declare function stripScriptsFromStaticHTML(html: string): string;
 * - Routes without `prerender` or `generateParams` are not collected
 */
 declare function collectPrerenderPaths(routes: CompiledRoute2[], prefix?: string): Promise<string[]>;
-import { FontFallbackMetrics as FontFallbackMetrics4 } from "@vertz/ui";
-import { ExtractedQuery } from "@vertz/ui-compiler";
-/**
-* SSR prefetch access rule evaluator.
-*
-* Evaluates serialized entity access rules against the current session
-* to determine whether a query should be prefetched during SSR.
-*
-* The serialized rules come from the prefetch manifest (generated at build time).
-* The session comes from the JWT decoded at request time.
-*/
-/**
-* Serialized access rule — the JSON-friendly format stored in the manifest.
-* Mirrors SerializedRule from @vertz/server/auth/rules but defined here
-* to avoid importing the server package into the SSR pipeline.
-*/
-type SerializedAccessRule = {
-	type: "public";
-} | {
-	type: "authenticated";
-} | {
-	type: "role";
-	roles: string[];
-} | {
-	type: "entitlement";
-	value: string;
-} | {
-	type: "where";
-	conditions: Record<string, unknown>;
-} | {
-	type: "all";
-	rules: SerializedAccessRule[];
-} | {
-	type: "any";
-	rules: SerializedAccessRule[];
-} | {
-	type: "fva";
-	maxAge: number;
-} | {
-	type: "deny";
-};
-/** Serialized entity access rules from the prefetch manifest. */
-type EntityAccessMap = Record<string, Partial<Record<string, SerializedAccessRule>>>;
-interface SSRPrefetchManifest {
-	/** Route patterns present in the manifest. */
-	routePatterns: string[];
-	/** Entity access rules keyed by entity name → operation → serialized rule. */
-	entityAccess?: EntityAccessMap;
-	/** Route entries with query binding metadata for zero-discovery prefetch. */
-	routeEntries?: Record<string, {
-		queries: ExtractedQuery[];
-	}>;
-}
+import { FontFallbackMetrics as FontFallbackMetrics5 } from "@vertz/ui";
 import { AccessSet } from "@vertz/ui/auth";
 interface SessionData {
 	user: {
@@ -234,7 +286,7 @@ interface SSRHandlerOptions {
 	*/
 	nonce?: string;
 	/** Pre-computed font fallback metrics (computed at server startup). */
-	fallbackMetrics?: Record<string, FontFallbackMetrics4>;
+	fallbackMetrics?: Record<string, FontFallbackMetrics5>;
 	/** Paths to inject as `<link rel="modulepreload">` in `<head>`. */
 	modulepreload?: string[];
 	/**
@@ -273,6 +325,16 @@ interface SSRHandlerOptions {
 	* which always use buffered rendering.
 	*/
 	progressiveHTML?: boolean;
+	/**
+	* AOT manifest with pre-compiled render functions.
+	*
+	* When provided, routes matching AOT entries are rendered via string-builder
+	* functions (no DOM shim), bypassing the reactive runtime for 4-6x speedup.
+	* Routes not in the manifest fall back to `ssrRenderSinglePass()`.
+	*
+	* Load via `loadAotManifest(serverDir)` at startup.
+	*/
+	aotManifest?: AotManifest;
 }
 declare function createSSRHandler(options: SSRHandlerOptions): (request: Request) => Promise<Response>;
 interface InjectIntoTemplateOptions {
@@ -295,4 +357,4 @@ interface InjectIntoTemplateOptions {
 * injects CSS before </head>, and ssrData before </body>.
 */
 declare function injectIntoTemplate(options: InjectIntoTemplateOptions): string;
-export { stripScriptsFromStaticHTML, ssrRenderToString, ssrDiscoverQueries, prerenderRoutes, injectIntoTemplate, filterPrerenderableRoutes, discoverRoutes, createSSRHandler, collectPrerenderPaths, SSRRenderResult, SSRModule, SSRHandlerOptions, SSRDiscoverResult, PrerenderResult, PrerenderOptions };
+export { stripScriptsFromStaticHTML, ssrRenderToString, ssrDiscoverQueries, prerenderRoutes, loadAotManifest, injectIntoTemplate, filterPrerenderableRoutes, discoverRoutes, createSSRHandler, collectPrerenderPaths, SSRRenderResult, SSRModule, SSRHandlerOptions, SSRDiscoverResult, PrerenderResult, PrerenderOptions, AotManifest };

package/dist/ssr/index.js

@@ -1,13 +1,13 @@
 import {
-  createSSRHandler
-} from "../shared/chunk-wb5fv233.js";
+  createSSRHandler,
+  loadAotManifest
+} from "../shared/chunk-2kx402c1.js";
 import {
   injectIntoTemplate,
   ssrDiscoverQueries,
   ssrRenderToString
-} from "../shared/chunk-34fexgex.js";
+} from "../shared/chunk-hx7drzm3.js";
 import"../shared/chunk-ybftdw1r.js";
-
 // src/prerender.ts
 async function discoverRoutes(module) {
   const result = await ssrRenderToString(module, "/");
@@ -115,6 +115,7 @@ export {
   ssrRenderToString,
   ssrDiscoverQueries,
   prerenderRoutes,
+  loadAotManifest,
   injectIntoTemplate,
   filterPrerenderableRoutes,
   discoverRoutes,

package/package.json

@@ -1,14 +1,17 @@
 {
   "name": "@vertz/ui-server",
-  "version": "0.2.31",
-  "type": "module",
-  "license": "MIT",
+  "version": "0.2.33",
   "description": "Vertz UI server-side rendering runtime",
+  "license": "MIT",
   "repository": {
     "type": "git",
     "url": "https://github.com/vertz-dev/vertz.git",
     "directory": "packages/ui-server"
   },
+  "files": [
+    "dist"
+  ],
+  "type": "module",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
   "exports": {
@@ -49,40 +52,39 @@
       "types": "./dist/node-handler.d.ts"
     }
   },
-  "files": [
-    "dist"
-  ],
+  "publishConfig": {
+    "access": "public",
+    "provenance": true
+  },
   "scripts": {
     "build": "bunup",
-    "test": "bun test",
+    "test": "bun test src/",
     "test:integration": "bun test src/__tests__/bun-dev-server.integration.local.ts",
+    "test:e2e": "bunx playwright test",
     "typecheck": "tsc --noEmit"
   },
   "dependencies": {
     "@ampproject/remapping": "^2.3.0",
     "@capsizecss/unpack": "^4.0.0",
     "@jridgewell/trace-mapping": "^0.3.31",
-    "@vertz/core": "^0.2.30",
-    "@vertz/ui": "^0.2.30",
-    "@vertz/ui-compiler": "^0.2.30",
+    "@vertz/core": "^0.2.31",
+    "@vertz/ui": "^0.2.31",
+    "@vertz/ui-compiler": "^0.2.31",
     "magic-string": "^0.30.0",
     "sharp": "^0.34.5",
     "ts-morph": "^27.0.2"
   },
   "devDependencies": {
-    "@vertz/codegen": "^0.2.30",
+    "@happy-dom/global-registrator": "^20.8.3",
+    "@playwright/test": "^1.58.2",
+    "@vertz/codegen": "^0.2.31",
     "@vertz/ui-auth": "^0.2.19",
     "bun-types": "^1.3.10",
     "bunup": "^0.16.31",
-    "@happy-dom/global-registrator": "^20.8.3",
     "happy-dom": "^20.8.3",
     "typescript": "^5.7.0"
   },
   "engines": {
     "node": ">=22"
-  },
-  "publishConfig": {
-    "access": "public",
-    "provenance": true
   }
 }