@elurjs/kit 2.4.4

package/dist/lib/shared-DU3iQgr7.js

@@ -0,0 +1,236 @@
+import { copyFile as e, mkdir as t, readdir as n, writeFile as r } from "node:fs/promises";
+import { dirname as i, join as a, relative as o } from "node:path";
+import { existsSync as s } from "node:fs";
+//#region src/adapters/shared.ts
+async function c(r, i) {
+	await t(i, { recursive: !0 });
+	let o = await n(r, { withFileTypes: !0 });
+	for (let t of o) {
+		let n = a(r, t.name), o = a(i, t.name);
+		t.isDirectory() ? await c(n, o) : await e(n, o);
+	}
+}
+function l(e, t, n) {
+	t.add(e.pagePath), e.dataPath && t.add(e.dataPath), e.loadingPath && t.add(e.loadingPath);
+	for (let n of e.layouts) {
+		t.add(n);
+		let e = n.replace(/layout\.ts$/, "layout.data.ts");
+		e !== n && s(e) && t.add(e);
+	}
+	if (e.actionPath) {
+		t.add(e.actionPath);
+		let r = n.get(e.path);
+		r || (r = /* @__PURE__ */ new Set(), n.set(e.path, r)), r.add(e.actionPath);
+	}
+}
+async function u(e, t, n) {
+	let r = /* @__PURE__ */ new Set(), i = /* @__PURE__ */ new Map();
+	for (let t of e.pages) l(t, r, i);
+	e.error404 && l(e.error404, r, i), e.error500 && l(e.error500, r, i);
+	for (let t of e.api) r.add(t.routePath);
+	let a = Array.from(r), o = new Map(a.map((e, t) => [e, t])), s = a.map((e, t) => {
+		let r = d(n, e);
+		return `import * as m_${t} from ${JSON.stringify(r)};`;
+	}).join("\n"), c = (e) => `{
+    path: ${JSON.stringify(e.path)},
+    pagePath: ${JSON.stringify(e.pagePath)},
+    dataPath: ${JSON.stringify(e.dataPath ?? null)},
+    actionPath: ${JSON.stringify(e.actionPath ?? null)},
+    loadingPath: ${JSON.stringify(e.loadingPath ?? null)},
+    layouts: ${JSON.stringify(e.layouts)},
+    params: ${JSON.stringify(e.params)},
+  }`, u = e.pages.map(c).join(",\n"), f = e.api.map((e) => {
+		let t = o.get(e.routePath);
+		return `  { path: ${JSON.stringify(e.path)}, routePath: m_${t} },`;
+	}).join("\n"), p = Array.from(i.entries()).map(([e, t]) => {
+		let n = Array.from(t).map((e) => {
+			let t = o.get(e);
+			return `      [${JSON.stringify(e)}, m_${t}],`;
+		}).join("\n");
+		return `  [${JSON.stringify(e)}, new Map([\n${n}\n    ])],`;
+	}).join("\n"), m = {};
+	for (let t of e.pages) {
+		if (!t.actionPath) continue;
+		let e = await import(t.actionPath), n = [];
+		for (let [t, r] of Object.entries(e)) t !== "default" && typeof r == "function" && n.push(t);
+		n.length > 0 && (m[t.path] = n);
+	}
+	return `// AUTO-GENERATED by @elurjs/kit. Do not edit.
+import { handleActionRequest, matchApiRoute, matchRoute, renderPage, renderErrorPage } from "@elurjs/kit";
+${s}
+
+const registry = new Map<string, unknown>([
+${a.map((e, t) => `  [${JSON.stringify(e)}, m_${t}],`).join("\n")}
+]);
+
+const pages = [
+${u},
+];
+
+const apiRoutes = [
+${f}
+];
+
+const actionModules = new Map<string, Map<string, unknown>>([
+${p}
+]);
+
+const actions = ${JSON.stringify(m)};
+
+const routes = {
+  pages,
+  api: apiRoutes,
+  error404: ${e.error404 ? c(e.error404) : "undefined"},
+  error500: ${e.error500 ? c(e.error500) : "undefined"},
+};
+
+const clientEntry = ${JSON.stringify(t.clientEntry)};
+const lang = ${JSON.stringify(t.lang)};
+
+function loadModule(path: string) {
+  const mod = registry.get(path);
+  if (mod) return mod;
+  throw new Error(\`Module not found in registry: \${path}\`);
+}
+
+async function resolveAction(name: string, page?: string) {
+  // Match concrete page paths (e.g. /movies/inception) to their route pattern
+  // (/movies/:slug) so actions on dynamic routes resolve by scope.
+  let pageKey: string | undefined;
+  if (page) {
+    pageKey = routes.pages.some((route) => route.path === page)
+      ? page
+      : (matchRoute(page, routes.pages)?.route.path ?? page);
+  }
+  const pageModules = pageKey ? actionModules.get(pageKey) : undefined;
+  const candidates = pageModules ? [...pageModules.values()] : [];
+  if (!pageModules) {
+    for (const mods of actionModules.values()) {
+      for (const mod of mods.values()) {
+        const action = (mod as Record<string, unknown>)[name];
+        if (typeof action === "function") return action;
+      }
+    }
+  }
+  for (const mod of candidates) {
+    const action = (mod as Record<string, unknown>)[name];
+    if (typeof action === "function") {
+      return action as (...args: unknown[]) => unknown;
+    }
+  }
+  return undefined;
+}
+
+export default async function handler(request: Request): Promise<Response> {
+  const url = new URL(request.url);
+
+  if (url.pathname === "/__elur-js/actions") {
+    return handleActionRequest(request, resolveAction);
+  }
+
+  // Render endpoint used by the SPA router and streaming boundaries.
+  if (url.pathname === "/__elur-js/render") {
+    const page = url.searchParams.get("page") ?? "/";
+    const search = url.searchParams.get("search") ?? "";
+    const wantsJson = (request.headers.get("Accept") ?? "").includes("application/json");
+    try {
+      const match = matchRoute(page, routes.pages);
+      if (!match) throw new Error(\`No route found for \${page}\`);
+      const { html } = await renderPage({
+        route: match.route,
+        params: match.params,
+        searchParams: new URLSearchParams(search),
+        config: { lang, clientEntry },
+        importer: loadModule,
+        actions,
+        request,
+      });
+      const bodyStart = html.indexOf('<div id="app">');
+      const bodyEnd = html.lastIndexOf("</div>");
+      const body = bodyStart >= 0 && bodyEnd > bodyStart
+        ? html.slice(bodyStart + 13, bodyEnd).trim()
+        : html;
+      const titleStart = html.indexOf("<title>");
+      const titleEnd = html.indexOf("</title>");
+      const title = titleStart >= 0 && titleEnd > titleStart
+        ? html.slice(titleStart + 7, titleEnd)
+        : "";
+      if (wantsJson) {
+        return new Response(JSON.stringify({ title, body }), {
+          status: 200,
+          headers: { "Content-Type": "application/json; charset=utf-8" },
+        });
+      }
+      return new Response(body, {
+        status: 200,
+        headers: { "Content-Type": "text/html; charset=utf-8" },
+      });
+    } catch (err) {
+      if ((err as { name?: string }).name === "RouteNotFoundError") {
+        return new Response("Not Found", {
+          status: 404,
+          headers: { "Content-Type": "text/plain" },
+        });
+      }
+      console.error("[elur-kit] render endpoint error:", err);
+      return new Response("Internal Server Error", {
+        status: 500,
+        headers: { "Content-Type": "text/plain" },
+      });
+    }
+  }
+
+  const apiMatch = matchApiRoute(url.pathname, apiRoutes);
+  if (apiMatch) {
+    const mod = apiMatch.route.routePath as Record<
+      string,
+      (request: Request, context?: { params: Record<string, string | string[]> }) => unknown
+    >;
+    const handler = mod[request.method ?? "GET"];
+    if (typeof handler !== "function") {
+      return new Response("Method not allowed: " + request.method, { status: 405, headers: { "Content-Type": "text/plain" } });
+    }
+    return (await handler(request, { params: apiMatch.params })) as Response;
+  }
+
+  const match = matchRoute(url.pathname, routes.pages);
+  if (!match) {
+    const errorResult = await renderErrorPage({ routes, status: 404, config: { lang, clientEntry }, actions, importer: loadModule });
+    if (errorResult) {
+      return new Response(errorResult.html, { status: errorResult.status, headers: { "Content-Type": "text/html; charset=utf-8" } });
+    }
+    return new Response("Not Found", { status: 404, headers: { "Content-Type": "text/plain" } });
+  }
+
+  try {
+    const { html } = await renderPage({
+      route: match.route,
+      params: match.params,
+      searchParams: new URLSearchParams(url.search),
+      config: { lang, clientEntry },
+      importer: loadModule,
+      actions,
+      request,
+    });
+    return new Response(html, { status: 200, headers: { "Content-Type": "text/html; charset=utf-8" } });
+  } catch (err) {
+    console.error("[elur-kit] SSR render error:", err);
+    const errorResult = await renderErrorPage({ routes, status: 500, error: err, config: { lang, clientEntry }, actions, importer: loadModule });
+    if (errorResult) {
+      return new Response(errorResult.html, { status: errorResult.status, headers: { "Content-Type": "text/html; charset=utf-8" } });
+    }
+    return new Response("Internal Server Error", { status: 500, headers: { "Content-Type": "text/plain; charset=utf-8" } });
+  }
+}
+`;
+}
+function d(e, t) {
+	return o(e, t).split("\\").join("/");
+}
+async function f(e, t, n) {
+	await r(e, await u(t, n, i(e)), "utf8");
+}
+//#endregion
+export { f as n, c as t };
+
+//# sourceMappingURL=shared-DU3iQgr7.js.map

package/dist/lib/shared-DU3iQgr7.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"shared-DU3iQgr7.js","names":[],"sources":["../../src/adapters/shared.ts"],"sourcesContent":["import { existsSync } from \"node:fs\";\nimport { mkdir, readdir, copyFile, writeFile } from \"node:fs/promises\";\nimport { dirname, join, relative } from \"node:path\";\nimport { scanRoutes } from \"../router/route-scanner.js\";\nimport type { AdapterOptions } from \"./index.js\";\nimport type { PageRoute } from \"../router/route-scanner.js\";\n\n/**\n * Shared helper: copy a directory recursively.\n */\nexport async function copyStatic(from: string, to: string): Promise<void> {\n  await mkdir(to, { recursive: true });\n  const entries = await readdir(from, { withFileTypes: true });\n  for (const entry of entries) {\n    const src = join(from, entry.name);\n    const dest = join(to, entry.name);\n    if (entry.isDirectory()) {\n      await copyStatic(src, dest);\n    } else {\n      await copyFile(src, dest);\n    }\n  }\n}\n\n/** Adds every module the SSR runtime may import for a page to the registry. */\nfunction collectPageModules(\n  page: PageRoute,\n  moduleSet: Set<string>,\n  actionPathsByPage: Map<string, Set<string>>,\n): void {\n  moduleSet.add(page.pagePath);\n  if (page.dataPath) moduleSet.add(page.dataPath);\n  if (page.loadingPath) moduleSet.add(page.loadingPath);\n  for (const layout of page.layouts) {\n    moduleSet.add(layout);\n    const layoutDataPath = layout.replace(/layout\\.ts$/, \"layout.data.ts\");\n    if (layoutDataPath !== layout && existsSync(layoutDataPath)) {\n      moduleSet.add(layoutDataPath);\n    }\n  }\n  if (page.actionPath) {\n    moduleSet.add(page.actionPath);\n    let set = actionPathsByPage.get(page.path);\n    if (!set) {\n      set = new Set<string>();\n      actionPathsByPage.set(page.path, set);\n    }\n    set.add(page.actionPath);\n  }\n}\n\n/**\n * Build a self-contained SSR entry file for a platform adapter.\n * The generated module exports a default `handler(request: Request): Response`\n * and embeds the full route table plus a registry of all page/layout/data/\n * action modules so the runtime never touches the file system.\n */\nexport async function buildSsrEntry(\n  routes: Awaited<ReturnType<typeof scanRoutes>>,\n  options: AdapterOptions,\n  entryDir: string,\n): Promise<string> {\n  // Collect all module paths that the SSR runtime may need to import.\n  const moduleSet = new Set<string>();\n  const actionPathsByPage = new Map<string, Set<string>>();\n  for (const page of routes.pages) {\n    collectPageModules(page, moduleSet, actionPathsByPage);\n  }\n  if (routes.error404) collectPageModules(routes.error404, moduleSet, actionPathsByPage);\n  if (routes.error500) collectPageModules(routes.error500, moduleSet, actionPathsByPage);\n  for (const api of routes.api) {\n    moduleSet.add(api.routePath);\n  }\n  const modules = Array.from(moduleSet);\n  const moduleIndex = new Map(modules.map((path, index) => [path, index]));\n\n  const imports = modules\n    .map((path, index) => {\n      const rel = relativeToPosix(entryDir, path);\n      return `import * as m_${index} from ${JSON.stringify(rel)};`;\n    })\n    .join(\"\\n\");\n\n  const renderPageRecord = (page: PageRoute): string => `{\n    path: ${JSON.stringify(page.path)},\n    pagePath: ${JSON.stringify(page.pagePath)},\n    dataPath: ${JSON.stringify(page.dataPath ?? null)},\n    actionPath: ${JSON.stringify(page.actionPath ?? null)},\n    loadingPath: ${JSON.stringify(page.loadingPath ?? null)},\n    layouts: ${JSON.stringify(page.layouts)},\n    params: ${JSON.stringify(page.params)},\n  }`;\n\n  const pages = routes.pages.map(renderPageRecord).join(\",\\n\");\n\n  const apiRoutes = routes.api\n    .map((api) => {\n      const index = moduleIndex.get(api.routePath);\n      return `  { path: ${JSON.stringify(api.path)}, routePath: m_${index} },`;\n    })\n    .join(\"\\n\");\n\n  const actionModules = Array.from(actionPathsByPage.entries())\n    .map(([pagePath, paths]) => {\n      const entries = Array.from(paths)\n        .map((path) => {\n          const index = moduleIndex.get(path);\n          return `      [${JSON.stringify(path)}, m_${index}],`;\n        })\n        .join(\"\\n\");\n      return `  [${JSON.stringify(pagePath)}, new Map([\\n${entries}\\n    ])],`;\n    })\n    .join(\"\\n\");\n\n  const actionsRegistry: Record<string, string[]> = {};\n  for (const page of routes.pages) {\n    if (!page.actionPath) continue;\n    const mod = (await import(page.actionPath)) as Record<string, unknown>;\n    const names: string[] = [];\n    for (const [name, value] of Object.entries(mod)) {\n      if (name === \"default\") continue;\n      if (typeof value === \"function\") {\n        names.push(name);\n      }\n    }\n    if (names.length > 0) {\n      actionsRegistry[page.path] = names;\n    }\n  }\n\n  return `// AUTO-GENERATED by @elurjs/kit. Do not edit.\nimport { handleActionRequest, matchApiRoute, matchRoute, renderPage, renderErrorPage } from \"@elurjs/kit\";\n${imports}\n\nconst registry = new Map<string, unknown>([\n${modules.map((path, index) => `  [${JSON.stringify(path)}, m_${index}],`).join(\"\\n\")}\n]);\n\nconst pages = [\n${pages},\n];\n\nconst apiRoutes = [\n${apiRoutes}\n];\n\nconst actionModules = new Map<string, Map<string, unknown>>([\n${actionModules}\n]);\n\nconst actions = ${JSON.stringify(actionsRegistry)};\n\nconst routes = {\n  pages,\n  api: apiRoutes,\n  error404: ${routes.error404 ? renderPageRecord(routes.error404) : \"undefined\"},\n  error500: ${routes.error500 ? renderPageRecord(routes.error500) : \"undefined\"},\n};\n\nconst clientEntry = ${JSON.stringify(options.clientEntry)};\nconst lang = ${JSON.stringify(options.lang)};\n\nfunction loadModule(path: string) {\n  const mod = registry.get(path);\n  if (mod) return mod;\n  throw new Error(\\`Module not found in registry: \\${path}\\`);\n}\n\nasync function resolveAction(name: string, page?: string) {\n  // Match concrete page paths (e.g. /movies/inception) to their route pattern\n  // (/movies/:slug) so actions on dynamic routes resolve by scope.\n  let pageKey: string | undefined;\n  if (page) {\n    pageKey = routes.pages.some((route) => route.path === page)\n      ? page\n      : (matchRoute(page, routes.pages)?.route.path ?? page);\n  }\n  const pageModules = pageKey ? actionModules.get(pageKey) : undefined;\n  const candidates = pageModules ? [...pageModules.values()] : [];\n  if (!pageModules) {\n    for (const mods of actionModules.values()) {\n      for (const mod of mods.values()) {\n        const action = (mod as Record<string, unknown>)[name];\n        if (typeof action === \"function\") return action;\n      }\n    }\n  }\n  for (const mod of candidates) {\n    const action = (mod as Record<string, unknown>)[name];\n    if (typeof action === \"function\") {\n      return action as (...args: unknown[]) => unknown;\n    }\n  }\n  return undefined;\n}\n\nexport default async function handler(request: Request): Promise<Response> {\n  const url = new URL(request.url);\n\n  if (url.pathname === \"/__elur-js/actions\") {\n    return handleActionRequest(request, resolveAction);\n  }\n\n  // Render endpoint used by the SPA router and streaming boundaries.\n  if (url.pathname === \"/__elur-js/render\") {\n    const page = url.searchParams.get(\"page\") ?? \"/\";\n    const search = url.searchParams.get(\"search\") ?? \"\";\n    const wantsJson = (request.headers.get(\"Accept\") ?? \"\").includes(\"application/json\");\n    try {\n      const match = matchRoute(page, routes.pages);\n      if (!match) throw new Error(\\`No route found for \\${page}\\`);\n      const { html } = await renderPage({\n        route: match.route,\n        params: match.params,\n        searchParams: new URLSearchParams(search),\n        config: { lang, clientEntry },\n        importer: loadModule,\n        actions,\n        request,\n      });\n      const bodyStart = html.indexOf('<div id=\"app\">');\n      const bodyEnd = html.lastIndexOf(\"</div>\");\n      const body = bodyStart >= 0 && bodyEnd > bodyStart\n        ? html.slice(bodyStart + 13, bodyEnd).trim()\n        : html;\n      const titleStart = html.indexOf(\"<title>\");\n      const titleEnd = html.indexOf(\"</title>\");\n      const title = titleStart >= 0 && titleEnd > titleStart\n        ? html.slice(titleStart + 7, titleEnd)\n        : \"\";\n      if (wantsJson) {\n        return new Response(JSON.stringify({ title, body }), {\n          status: 200,\n          headers: { \"Content-Type\": \"application/json; charset=utf-8\" },\n        });\n      }\n      return new Response(body, {\n        status: 200,\n        headers: { \"Content-Type\": \"text/html; charset=utf-8\" },\n      });\n    } catch (err) {\n      if ((err as { name?: string }).name === \"RouteNotFoundError\") {\n        return new Response(\"Not Found\", {\n          status: 404,\n          headers: { \"Content-Type\": \"text/plain\" },\n        });\n      }\n      console.error(\"[elur-kit] render endpoint error:\", err);\n      return new Response(\"Internal Server Error\", {\n        status: 500,\n        headers: { \"Content-Type\": \"text/plain\" },\n      });\n    }\n  }\n\n  const apiMatch = matchApiRoute(url.pathname, apiRoutes);\n  if (apiMatch) {\n    const mod = apiMatch.route.routePath as Record<\n      string,\n      (request: Request, context?: { params: Record<string, string | string[]> }) => unknown\n    >;\n    const handler = mod[request.method ?? \"GET\"];\n    if (typeof handler !== \"function\") {\n      return new Response(\"Method not allowed: \" + request.method, { status: 405, headers: { \"Content-Type\": \"text/plain\" } });\n    }\n    return (await handler(request, { params: apiMatch.params })) as Response;\n  }\n\n  const match = matchRoute(url.pathname, routes.pages);\n  if (!match) {\n    const errorResult = await renderErrorPage({ routes, status: 404, config: { lang, clientEntry }, actions, importer: loadModule });\n    if (errorResult) {\n      return new Response(errorResult.html, { status: errorResult.status, headers: { \"Content-Type\": \"text/html; charset=utf-8\" } });\n    }\n    return new Response(\"Not Found\", { status: 404, headers: { \"Content-Type\": \"text/plain\" } });\n  }\n\n  try {\n    const { html } = await renderPage({\n      route: match.route,\n      params: match.params,\n      searchParams: new URLSearchParams(url.search),\n      config: { lang, clientEntry },\n      importer: loadModule,\n      actions,\n      request,\n    });\n    return new Response(html, { status: 200, headers: { \"Content-Type\": \"text/html; charset=utf-8\" } });\n  } catch (err) {\n    console.error(\"[elur-kit] SSR render error:\", err);\n    const errorResult = await renderErrorPage({ routes, status: 500, error: err, config: { lang, clientEntry }, actions, importer: loadModule });\n    if (errorResult) {\n      return new Response(errorResult.html, { status: errorResult.status, headers: { \"Content-Type\": \"text/html; charset=utf-8\" } });\n    }\n    return new Response(\"Internal Server Error\", { status: 500, headers: { \"Content-Type\": \"text/plain; charset=utf-8\" } });\n  }\n}\n`;\n}\n\nfunction relativeToPosix(from: string, to: string): string {\n  return relative(from, to).split(\"\\\\\").join(\"/\");\n}\n\n/**\n * Write a generated SSR entry file for an adapter.\n */\nexport async function writeSsrEntry(\n  entryPath: string,\n  routes: Awaited<ReturnType<typeof scanRoutes>>,\n  options: AdapterOptions,\n): Promise<void> {\n  await writeFile(\n    entryPath,\n    await buildSsrEntry(routes, options, dirname(entryPath)),\n    \"utf8\",\n  );\n}\n"],"mappings":"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"}

package/dist/lib/ssr/match.d.cts

@@ -0,0 +1,25 @@
+import type { ApiRoute, PageRoute } from "../router/route-scanner.js";
+export interface MatchResult {
+    route: PageRoute;
+    params: Record<string, string | string[]>;
+    searchParams: URLSearchParams;
+}
+/**
+ * Match a request pathname against a list of page routes.
+ *
+ * Routes are sorted by specificity (static > dynamic > catch-all) before
+ * matching, so `/about` wins over `/:slug` even if the catch-all appears first.
+ *
+ * URL segments are safely decoded (plan §11.1, runtime-security §10).
+ */
+export declare function matchRoute(pathname: string, routes: PageRoute[]): MatchResult | undefined;
+export interface ApiMatchResult<T = ApiRoute> {
+    route: T;
+    params: Record<string, string | string[]>;
+}
+/**
+ * Match a request pathname against a list of API routes.
+ */
+export declare function matchApiRoute<T extends {
+    path: string;
+}>(pathname: string, routes: T[]): ApiMatchResult<T> | undefined;

package/dist/lib/ssr/match.d.ts

@@ -0,0 +1,25 @@
+import type { ApiRoute, PageRoute } from "../router/route-scanner.js";
+export interface MatchResult {
+    route: PageRoute;
+    params: Record<string, string | string[]>;
+    searchParams: URLSearchParams;
+}
+/**
+ * Match a request pathname against a list of page routes.
+ *
+ * Routes are sorted by specificity (static > dynamic > catch-all) before
+ * matching, so `/about` wins over `/:slug` even if the catch-all appears first.
+ *
+ * URL segments are safely decoded (plan §11.1, runtime-security §10).
+ */
+export declare function matchRoute(pathname: string, routes: PageRoute[]): MatchResult | undefined;
+export interface ApiMatchResult<T = ApiRoute> {
+    route: T;
+    params: Record<string, string | string[]>;
+}
+/**
+ * Match a request pathname against a list of API routes.
+ */
+export declare function matchApiRoute<T extends {
+    path: string;
+}>(pathname: string, routes: T[]): ApiMatchResult<T> | undefined;

package/dist/lib/ssr/render.d.cts

@@ -0,0 +1,62 @@
+import type { PageRoute, ScannedRoutes } from "../router/route-scanner.js";
+import type { BuildConfig } from "../build/build.js";
+import type { RouteParams } from "../types.js";
+import { type CachePolicy } from "../cache/policy.js";
+export interface RenderPageOptions {
+    route: PageRoute;
+    params?: RouteParams;
+    searchParams?: URLSearchParams;
+    config: Pick<BuildConfig, "lang" | "clientEntry" | "renderEndpoint">;
+    /** Custom module loader. Defaults to native dynamic import. */
+    importer?: (path: string) => Promise<unknown>;
+    /** Per-page action names exposed in the HTML shell. */
+    actions?: Record<string, string[]>;
+    /** Current request, used to hydrate data loaders that need cookies/headers. */
+    request?: Request;
+}
+export interface RenderPageResult {
+    html: string;
+    revalidate?: number;
+    /**
+     * `Set-Cookie` header value that clears the action error cookie, when the
+     * page consumed a relayed action failure. The SSR server should append it to
+     * the outgoing response so the cookie does not persist.
+     */
+    clearActionErrorCookie?: string;
+    /** `<head>` tags (title, meta, OG, twitter) for the SPA router to merge. */
+    head?: string;
+    /** Resolved page title (from metadata or fallback). */
+    resolvedTitle?: string;
+    /**
+     * When a loader or layout throws a `Response` (e.g. `throw new Response(...,
+     * { status: 404 })`), it is captured here as a first-class response instead
+     * of being treated as an internal error (A-22).
+     */
+    response?: Response;
+    /** HTTP status code for the rendered page (e.g. 404 for not-found pages). */
+    status?: number;
+    /** Cache policy declared by the route (§9.1). */
+    cachePolicy?: CachePolicy;
+}
+/**
+ * Collects `<html>` attributes and head scripts declared by data loaders
+ * (page and layouts) via top-level `htmlAttributes` / `headScripts` fields.
+ */
+export declare function collectShellExtras(pageData: unknown, layoutDataList: unknown[]): {
+    htmlAttributes: Record<string, string>;
+    headScripts: string[];
+    headLinks: string[];
+};
+export declare function renderPage(options: RenderPageOptions): Promise<RenderPageResult>;
+export interface RenderErrorPageOptions {
+    routes: ScannedRoutes;
+    status: 404 | 500;
+    error?: unknown;
+    config: Pick<BuildConfig, "lang" | "clientEntry" | "renderEndpoint">;
+    actions?: Record<string, string[]>;
+    importer?: (path: string) => Promise<unknown>;
+}
+export declare function renderErrorPage(options: RenderErrorPageOptions): Promise<{
+    html: string;
+    status: number;
+} | undefined>;

package/dist/lib/ssr/render.d.ts

@@ -0,0 +1,62 @@
+import type { PageRoute, ScannedRoutes } from "../router/route-scanner.js";
+import type { BuildConfig } from "../build/build.js";
+import type { RouteParams } from "../types.js";
+import { type CachePolicy } from "../cache/policy.js";
+export interface RenderPageOptions {
+    route: PageRoute;
+    params?: RouteParams;
+    searchParams?: URLSearchParams;
+    config: Pick<BuildConfig, "lang" | "clientEntry" | "renderEndpoint">;
+    /** Custom module loader. Defaults to native dynamic import. */
+    importer?: (path: string) => Promise<unknown>;
+    /** Per-page action names exposed in the HTML shell. */
+    actions?: Record<string, string[]>;
+    /** Current request, used to hydrate data loaders that need cookies/headers. */
+    request?: Request;
+}
+export interface RenderPageResult {
+    html: string;
+    revalidate?: number;
+    /**
+     * `Set-Cookie` header value that clears the action error cookie, when the
+     * page consumed a relayed action failure. The SSR server should append it to
+     * the outgoing response so the cookie does not persist.
+     */
+    clearActionErrorCookie?: string;
+    /** `<head>` tags (title, meta, OG, twitter) for the SPA router to merge. */
+    head?: string;
+    /** Resolved page title (from metadata or fallback). */
+    resolvedTitle?: string;
+    /**
+     * When a loader or layout throws a `Response` (e.g. `throw new Response(...,
+     * { status: 404 })`), it is captured here as a first-class response instead
+     * of being treated as an internal error (A-22).
+     */
+    response?: Response;
+    /** HTTP status code for the rendered page (e.g. 404 for not-found pages). */
+    status?: number;
+    /** Cache policy declared by the route (§9.1). */
+    cachePolicy?: CachePolicy;
+}
+/**
+ * Collects `<html>` attributes and head scripts declared by data loaders
+ * (page and layouts) via top-level `htmlAttributes` / `headScripts` fields.
+ */
+export declare function collectShellExtras(pageData: unknown, layoutDataList: unknown[]): {
+    htmlAttributes: Record<string, string>;
+    headScripts: string[];
+    headLinks: string[];
+};
+export declare function renderPage(options: RenderPageOptions): Promise<RenderPageResult>;
+export interface RenderErrorPageOptions {
+    routes: ScannedRoutes;
+    status: 404 | 500;
+    error?: unknown;
+    config: Pick<BuildConfig, "lang" | "clientEntry" | "renderEndpoint">;
+    actions?: Record<string, string[]>;
+    importer?: (path: string) => Promise<unknown>;
+}
+export declare function renderErrorPage(options: RenderErrorPageOptions): Promise<{
+    html: string;
+    status: number;
+} | undefined>;

package/dist/lib/ssr/server.d.cts

@@ -0,0 +1,41 @@
+import { type Server } from "node:http";
+import { scanRoutes } from "../router/route-scanner.js";
+import { type ActionSecurityOptions } from "../action/server.js";
+export interface SsrServerOptions {
+    /** Absolute path to the app directory (e.g. /project/src/app). */
+    appDir: string;
+    /** Absolute path to the project root. When provided, action paths in the
+     * serialized HTML shell are made relative to this root. */
+    root?: string;
+    /** Absolute path to the public directory for static files (optional). */
+    publicDir?: string;
+    /** Base path for the client entry module, e.g. "/_elur/entry-client.js". */
+    clientEntry?: string;
+    /** Default language for the HTML shell. */
+    lang?: string;
+    port?: number;
+    host?: string;
+    /** Absolute path to the ISR cache directory (optional). */
+    cacheDir?: string;
+    /** Default revalidate interval in seconds when a page does not export one. */
+    defaultRevalidate?: number;
+    /** If true, render pages with loading.ts boundaries using streaming. */
+    streaming?: boolean;
+    /** CSRF / origin policy applied to the server actions endpoint. */
+    actionSecurity?: ActionSecurityOptions;
+}
+export interface SsrServer {
+    server: Server;
+    listen(): Promise<void>;
+    close(): Promise<void>;
+}
+/**
+ * Create an SSR server that renders pages on demand and serves static files.
+ */
+export declare function createSsrServer(options: SsrServerOptions): Promise<SsrServer>;
+/**
+ * Maps a concrete page path (e.g. `/movies/inception`) to the route pattern
+ * key used by the action registry (e.g. `/movies/:slug`). Falls back to the
+ * path itself when it matches an exact registry key.
+ */
+export declare function resolveActionPageKey(page: string | undefined, routes: Awaited<ReturnType<typeof scanRoutes>>): string | undefined;

package/dist/lib/ssr/server.d.ts

@@ -0,0 +1,41 @@
+import { type Server } from "node:http";
+import { scanRoutes } from "../router/route-scanner.js";
+import { type ActionSecurityOptions } from "../action/server.js";
+export interface SsrServerOptions {
+    /** Absolute path to the app directory (e.g. /project/src/app). */
+    appDir: string;
+    /** Absolute path to the project root. When provided, action paths in the
+     * serialized HTML shell are made relative to this root. */
+    root?: string;
+    /** Absolute path to the public directory for static files (optional). */
+    publicDir?: string;
+    /** Base path for the client entry module, e.g. "/_elur/entry-client.js". */
+    clientEntry?: string;
+    /** Default language for the HTML shell. */
+    lang?: string;
+    port?: number;
+    host?: string;
+    /** Absolute path to the ISR cache directory (optional). */
+    cacheDir?: string;
+    /** Default revalidate interval in seconds when a page does not export one. */
+    defaultRevalidate?: number;
+    /** If true, render pages with loading.ts boundaries using streaming. */
+    streaming?: boolean;
+    /** CSRF / origin policy applied to the server actions endpoint. */
+    actionSecurity?: ActionSecurityOptions;
+}
+export interface SsrServer {
+    server: Server;
+    listen(): Promise<void>;
+    close(): Promise<void>;
+}
+/**
+ * Create an SSR server that renders pages on demand and serves static files.
+ */
+export declare function createSsrServer(options: SsrServerOptions): Promise<SsrServer>;
+/**
+ * Maps a concrete page path (e.g. `/movies/inception`) to the route pattern
+ * key used by the action registry (e.g. `/movies/:slug`). Falls back to the
+ * path itself when it matches an exact registry key.
+ */
+export declare function resolveActionPageKey(page: string | undefined, routes: Awaited<ReturnType<typeof scanRoutes>>): string | undefined;

package/dist/lib/ssr/stream.d.cts

@@ -0,0 +1,48 @@
+import type { PageRoute, ScannedRoutes } from "../router/route-scanner.js";
+import type { BuildConfig } from "../build/build.js";
+export interface StreamingPageOptions {
+    route: PageRoute;
+    params: Record<string, string | string[]>;
+    searchParams: URLSearchParams;
+    config: Pick<BuildConfig, "lang" | "clientEntry">;
+    importer?: (path: string) => Promise<unknown>;
+    actions?: Record<string, string[]>;
+    request?: Request;
+}
+/**
+ * Render a page shell that shows the loading boundary while the real content
+ * is fetched and injected by the client.
+ */
+export declare function renderStreamingPage(options: StreamingPageOptions): Promise<string>;
+export interface RenderPageBodyOptions {
+    routes: ScannedRoutes;
+    pathname: string;
+    searchParams: URLSearchParams;
+    config: Pick<BuildConfig, "lang" | "clientEntry">;
+    actions?: Record<string, string[]>;
+    importer?: (path: string) => Promise<unknown>;
+    request?: Request;
+}
+export interface RenderPageBodyResult {
+    /** Inner HTML body for the page (without the document shell). */
+    body: string;
+    /** Page title extracted from the rendered shell. */
+    title: string;
+    /** Full rendered document shell (used for ISR caching). */
+    fullHtml?: string;
+    /** `Set-Cookie` value that clears a consumed action error cookie. */
+    clearActionErrorCookie?: string;
+    /** `<head>` tags (title, meta, OG, twitter) for the SPA router to merge. */
+    head?: string;
+    /** First-class Response when a loader threw one (A-22). */
+    response?: Response;
+}
+/** Thrown by `renderPageBody` when the requested path has no matching route. */
+export declare class RouteNotFoundError extends Error {
+    constructor(pathname: string);
+}
+/**
+ * Render only the inner HTML body for a page. Used by the streaming endpoint
+ * to inject the real content into the shell.
+ */
+export declare function renderPageBody(options: RenderPageBodyOptions): Promise<RenderPageBodyResult>;

package/dist/lib/ssr/stream.d.ts

@@ -0,0 +1,48 @@
+import type { PageRoute, ScannedRoutes } from "../router/route-scanner.js";
+import type { BuildConfig } from "../build/build.js";
+export interface StreamingPageOptions {
+    route: PageRoute;
+    params: Record<string, string | string[]>;
+    searchParams: URLSearchParams;
+    config: Pick<BuildConfig, "lang" | "clientEntry">;
+    importer?: (path: string) => Promise<unknown>;
+    actions?: Record<string, string[]>;
+    request?: Request;
+}
+/**
+ * Render a page shell that shows the loading boundary while the real content
+ * is fetched and injected by the client.
+ */
+export declare function renderStreamingPage(options: StreamingPageOptions): Promise<string>;
+export interface RenderPageBodyOptions {
+    routes: ScannedRoutes;
+    pathname: string;
+    searchParams: URLSearchParams;
+    config: Pick<BuildConfig, "lang" | "clientEntry">;
+    actions?: Record<string, string[]>;
+    importer?: (path: string) => Promise<unknown>;
+    request?: Request;
+}
+export interface RenderPageBodyResult {
+    /** Inner HTML body for the page (without the document shell). */
+    body: string;
+    /** Page title extracted from the rendered shell. */
+    title: string;
+    /** Full rendered document shell (used for ISR caching). */
+    fullHtml?: string;
+    /** `Set-Cookie` value that clears a consumed action error cookie. */
+    clearActionErrorCookie?: string;
+    /** `<head>` tags (title, meta, OG, twitter) for the SPA router to merge. */
+    head?: string;
+    /** First-class Response when a loader threw one (A-22). */
+    response?: Response;
+}
+/** Thrown by `renderPageBody` when the requested path has no matching route. */
+export declare class RouteNotFoundError extends Error {
+    constructor(pathname: string);
+}
+/**
+ * Render only the inner HTML body for a page. Used by the streaming endpoint
+ * to inject the real content into the shell.
+ */
+export declare function renderPageBody(options: RenderPageBodyOptions): Promise<RenderPageBodyResult>;