@tyndall/runtime 0.0.1 → 0.0.3

package/README.md

@@ -10,6 +10,9 @@ Runtime HTTP serving package for static routes, SSR execution, and route payload
 - Stream SSR responses when server entries provide `renderToStream`
 - Resolve client/server chunk files using manifest asset metadata (`assets.assetsDir`)
 - Emit module or classic script tags based on manifest `assets.scriptType`
+- Run `init.server` and `getRouteData` hooks to populate route data payloads for SSR and navigation
+- Serve special routes (`_404`, `_error`) and custom document shells from `_document` when provided
+- Emit redirect navigation payloads when route data hooks request redirects
 - Emit build version markers and append `?v=` to script URLs when manifest versioning is configured
 
 ## Public API Highlights

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAKA,OAAO,EAQL,KAAK,sBAAsB,EAE3B,KAAK,QAAQ,EAMb,KAAK,sBAAsB,EAG3B,KAAK,gBAAgB,EACrB,KAAK,iBAAiB,EAGvB,MAAM,eAAe,CAAC;AAEvB,MAAM,WAAW,qBAAqB;IACpC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,cAAc,CAAC,EAAE,sBAAsB,CAAC;IACxC,eAAe,CAAC,EAAE,iBAAiB,CAAC;IACpC,SAAS,CAAC,EAAE,MAAM,GAAG,gBAAgB,CAAC;IACtC,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACpC,cAAc,CAAC,EAAE,sBAAsB,CAAC;IACxC,OAAO,CAAC,EAAE,KAAK,GAAG,KAAK,CAAC;CACzB;AAED,MAAM,WAAW,oBAAqB,SAAQ,qBAAqB;IACjE,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CAC5B;AA4fD,eAAO,MAAM,YAAY,GAAU,SAAS,MAAM,KAAG,OAAO,CAAC,QAAQ,CAyBpE,CAAC;AAgeF,eAAO,MAAM,YAAY,GACvB,UAAS,oBAAyB,KACjC,OAAO,CAAC,aAAa,CAkCvB,CAAC;AAEF,eAAO,MAAM,oBAAoB,GAAI,UAAS,qBAA0B,MAGpE,SAAS;IAAE,GAAG,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,SAAS,CAAC,CAAA;CAAE,EACnG,UAAU;IACR,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IAChD,GAAG,EAAE,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,UAAU,KAAK,IAAI,CAAC;IAC1C,KAAK,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,GAAG,UAAU,KAAK,IAAI,CAAC;IAC7C,EAAE,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,KAAK,IAAI,CAAC;IACrE,IAAI,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,KAAK,IAAI,CAAC;IACvE,cAAc,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,KAAK,IAAI,CAAC;IACjF,YAAY,CAAC,EAAE,MAAM,IAAI,CAAC;CAC3B,EACD,OAAO,CAAC,KAAK,CAAC,EAAE,OAAO,KAAK,IAAI,SAYnC,CAAC;AAEF,eAAO,MAAM,mBAAmB,GAAI,UAAS,qBAA0B,MAEvD,SAAS;IAAE,GAAG,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,YAAY,EAAE,CAAC,GAAG,EAAE,GAAG,EAAE,KAAK,EAAE,GAAG,KAAK,OAAO,CAAC,IAAI,CAAC,KAAK,IAAI,CAAA;CAAE,kBAa9G,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAKA,OAAO,EAcL,KAAK,sBAAsB,EAE3B,KAAK,QAAQ,EASb,KAAK,sBAAsB,EAG3B,KAAK,gBAAgB,EACrB,KAAK,iBAAiB,EAGvB,MAAM,eAAe,CAAC;AAEvB,MAAM,WAAW,qBAAqB;IACpC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,cAAc,CAAC,EAAE,sBAAsB,CAAC;IACxC,eAAe,CAAC,EAAE,iBAAiB,CAAC;IACpC,SAAS,CAAC,EAAE,MAAM,GAAG,gBAAgB,CAAC;IACtC,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACpC,cAAc,CAAC,EAAE,sBAAsB,CAAC;IACxC,OAAO,CAAC,EAAE,KAAK,GAAG,KAAK,CAAC;CACzB;AAED,MAAM,WAAW,oBAAqB,SAAQ,qBAAqB;IACjE,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CAC5B;AA20BD,eAAO,MAAM,YAAY,GAAU,SAAS,MAAM,KAAG,OAAO,CAAC,QAAQ,CAyBpE,CAAC;AA43BF,eAAO,MAAM,YAAY,GACvB,UAAS,oBAAyB,KACjC,OAAO,CAAC,aAAa,CAkCvB,CAAC;AAEF,eAAO,MAAM,oBAAoB,GAAI,UAAS,qBAA0B,MAGpE,SAAS;IAAE,GAAG,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,SAAS,CAAC,CAAA;CAAE,EACnG,UAAU;IACR,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IAChD,GAAG,EAAE,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,UAAU,KAAK,IAAI,CAAC;IAC1C,KAAK,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,GAAG,UAAU,KAAK,IAAI,CAAC;IAC7C,EAAE,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,KAAK,IAAI,CAAC;IACrE,IAAI,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,KAAK,IAAI,CAAC;IACvE,cAAc,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,KAAK,IAAI,CAAC;IACjF,YAAY,CAAC,EAAE,MAAM,IAAI,CAAC;CAC3B,EACD,OAAO,CAAC,KAAK,CAAC,EAAE,OAAO,KAAK,IAAI,SAYnC,CAAC;AAEF,eAAO,MAAM,mBAAmB,GAAI,UAAS,qBAA0B,MAEvD,SAAS;IAAE,GAAG,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,YAAY,EAAE,CAAC,GAAG,EAAE,GAAG,EAAE,KAAK,EAAE,GAAG,KAAK,OAAO,CAAC,IAAI,CAAC,KAAK,IAAI,CAAA;CAAE,kBAa9G,CAAC"}

package/dist/index.js

@@ -3,7 +3,7 @@ import { createRequire } from "node:module";
 import { readFile, stat } from "node:fs/promises";
 import { extname, join, resolve } from "node:path";
 import { pathToFileURL } from "node:url";
-import { handleDynamicPageApiRequest, HyperError, resolveRouteWithPolicyFallback, resolveUIAdapter, runGetServerProps, serializeProps, validateManifest, } from "@tyndall/core";
+import { handleDynamicPageApiRequest, HyperError, resolveRouteWithPolicyFallback, resolveUIAdapter, runGetRouteData, runGetServerProps, runInitServer, ROUTE_DATA_ERROR_KEY, ROUTE_DATA_INIT_KEY, ROUTE_DATA_SCRIPT_ID, SPECIAL_ROUTE_IDS, serializeProps, validateManifest, } from "@tyndall/core";
 const CONTENT_TYPES = {
     ".html": "text/html; charset=utf-8",
     ".js": "text/javascript; charset=utf-8",
@@ -119,6 +119,165 @@ const resolveRuntimePropsSerializer = (options) => {
     const adapter = resolveUIAdapter(options.uiAdapter, options.uiOptions ?? {}, options.adapterRegistry ?? {});
     return adapter.serializeProps ?? serializeProps;
 };
+const normalizeRedirect = (redirect) => {
+    if (!redirect) {
+        return null;
+    }
+    if (typeof redirect === "string") {
+        return { destination: redirect, status: 302 };
+    }
+    return {
+        destination: redirect.destination,
+        status: redirect.status ?? 302,
+        replace: redirect.replace,
+    };
+};
+const normalizeError = (error) => {
+    if (!error) {
+        return null;
+    }
+    if (typeof error === "string") {
+        return { message: error };
+    }
+    return {
+        status: error.status,
+        message: error.message,
+    };
+};
+const resolveRouteDataEntries = (serverModule, routeId) => {
+    if (serverModule && typeof serverModule === "object") {
+        const record = serverModule;
+        const entries = record.routeDataEntries;
+        if (Array.isArray(entries)) {
+            return entries
+                .map((entry) => {
+                if (!entry || typeof entry !== "object") {
+                    return null;
+                }
+                const item = entry;
+                if (typeof item.key !== "string" || typeof item.routeId !== "string") {
+                    return null;
+                }
+                return {
+                    key: item.key,
+                    routeId: item.routeId,
+                    hook: typeof item.hook === "function"
+                        ? item.hook
+                        : undefined,
+                };
+            })
+                .filter((entry) => Boolean(entry));
+        }
+        if (typeof record.getRouteData === "function") {
+            return [
+                {
+                    key: `page:${routeId}`,
+                    routeId,
+                    hook: record.getRouteData,
+                },
+            ];
+        }
+    }
+    return [];
+};
+const collectRouteDataFromServerModule = async (input) => {
+    const dataMap = {};
+    const headers = {};
+    let status;
+    let initData;
+    let parentData;
+    const initServer = input.serverModule && typeof input.serverModule.initServer === "function"
+        ? (input.serverModule.initServer)
+        : undefined;
+    if (initServer) {
+        const initResult = await runInitServer(initServer, {
+            routeId: input.routeId,
+            params: input.params,
+            request: input.request,
+            response: input.response,
+        });
+        if (initResult.data !== undefined) {
+            initData = initResult.data;
+            dataMap[ROUTE_DATA_INIT_KEY] = initResult.data;
+        }
+        if (initResult.headers) {
+            Object.assign(headers, initResult.headers);
+        }
+        if (initResult.status !== undefined) {
+            status = initResult.status;
+        }
+        if (initResult.redirect) {
+            return {
+                data: dataMap,
+                initData,
+                headers,
+                status,
+                redirect: normalizeRedirect(initResult.redirect) ?? undefined,
+            };
+        }
+        if (initResult.error) {
+            const normalizedError = normalizeError(initResult.error);
+            if (normalizedError) {
+                dataMap[ROUTE_DATA_ERROR_KEY] = normalizedError;
+            }
+            return {
+                data: dataMap,
+                initData,
+                headers,
+                status,
+                error: normalizedError ?? undefined,
+            };
+        }
+    }
+    const entries = resolveRouteDataEntries(input.serverModule, input.routeId);
+    for (const entry of entries) {
+        if (typeof entry.hook !== "function") {
+            continue;
+        }
+        const result = await runGetRouteData(entry.hook, {
+            routeId: entry.routeId,
+            params: input.params,
+            request: input.request,
+            response: input.response,
+            init: initData,
+            routeData: dataMap,
+            parentData,
+        });
+        if (result.data !== undefined) {
+            dataMap[entry.key] = result.data;
+            parentData = result.data;
+        }
+        if (result.headers) {
+            Object.assign(headers, result.headers);
+        }
+        if (result.status !== undefined) {
+            status = result.status;
+        }
+        if (result.redirect) {
+            return {
+                data: dataMap,
+                initData,
+                headers,
+                status,
+                redirect: normalizeRedirect(result.redirect) ?? undefined,
+            };
+        }
+        if (result.error) {
+            const normalizedError = normalizeError(result.error);
+            if (normalizedError) {
+                dataMap[ROUTE_DATA_ERROR_KEY] = normalizedError;
+            }
+            return {
+                data: dataMap,
+                initData,
+                headers,
+                status,
+                error: normalizedError ?? undefined,
+            };
+        }
+    }
+    return { data: dataMap, initData, headers, status };
+};
 const parseAttributeMap = (value) => {
     const attributes = {};
     const attributePattern = /([a-zA-Z0-9:_-]+)\s*=\s*["']([^"']*)["']/g;
@@ -167,6 +326,10 @@ const extractScriptPayload = (html) => {
     const match = html.match(/<script[^>]*id=["']__HYPER_PROPS__["'][^>]*>([\s\S]*?)<\/script>/i);
     return match?.[1] ?? "{}";
 };
+const extractRouteDataPayload = (html) => {
+    const match = html.match(new RegExp(`<script[^>]*id=[\"']${ROUTE_DATA_SCRIPT_ID}[\"'][^>]*>([\\s\\S]*?)<\\/script>`, "i"));
+    return match?.[1] ?? "{}";
+};
 const extractHeadFromHtml = (html) => {
     const head = {};
     const headMatch = html.match(/<head[^>]*>([\s\S]*?)<\/head>/i);
@@ -216,6 +379,7 @@ const extractNavigationPayloadFromHtml = (html, fallbackRouteId) => {
         routeId: attrs["data-hyper-route"] ?? fallbackRouteId,
         appHtml: app.appHtml,
         propsPayload: extractScriptPayload(html),
+        routeDataPayload: extractRouteDataPayload(html),
         head: extractHeadFromHtml(html),
         hydration: attrs["data-hyper-hydration"] === "islands" ? "islands" : "full",
     };
@@ -277,9 +441,34 @@ const renderScriptTags = (scripts, scriptType) => scripts
     ? `<script src=\"${src}\"></script>`
     : `<script type=\"module\" src=\"${src}\"></script>`)
     .join("");
-const renderSsrHtmlFragments = (routeId, head, propsPayload, scripts, hydration, scriptType, buildVersion) => {
+const renderStyleLinks = (styles) => styles.map((href) => `<link rel=\"stylesheet\" href=\"${href}\">`).join("");
+const renderSsrHtmlFragments = (routeId, head, propsPayload, routeDataPayload, scripts, styles, hydration, scriptType, buildVersion, renderDocumentFragments) => {
+    if (renderDocumentFragments) {
+        try {
+            const custom = renderDocumentFragments({
+                html: "",
+                head,
+                propsPayload,
+                routeDataPayload,
+                routeId,
+                hydration,
+                scripts,
+                legacyScripts: [],
+                styles,
+                scriptType,
+                buildVersion,
+            });
+            if (custom && typeof custom.prefix === "string" && typeof custom.suffix === "string") {
+                return custom;
+            }
+        }
+        catch {
+            // Fallback to default document fragments if custom renderer fails.
+        }
+    }
     const headHtml = renderHeadDescriptor(head);
     const scriptsHtml = renderScriptTags(scripts, scriptType);
+    const stylesHtml = renderStyleLinks(styles);
     const islandAttr = hydration === "islands" ? " data-hyper-island-root=\"router\"" : "";
     const buildVersionMeta = buildVersion
         ? `<meta name=\"hyper-build-version\" content=\"${escapeHtml(buildVersion)}\">`
@@ -293,6 +482,7 @@ const renderSsrHtmlFragments = (routeId, head, propsPayload, scripts, hydration,
         "<head>",
         headHtml,
         buildVersionMeta,
+        stylesHtml,
         "</head>",
         "<body>",
         `<div id=\"app\" data-hyper-route=\"${routeId}\" data-hyper-hydration=\"${hydration}\"${islandAttr}>`,
@@ -300,6 +490,7 @@ const renderSsrHtmlFragments = (routeId, head, propsPayload, scripts, hydration,
     const suffix = [
         "</div>",
         `<script id=\"__HYPER_PROPS__\" type=\"application/json\">${propsPayload}</script>`,
+        `<script id=\"${ROUTE_DATA_SCRIPT_ID}\" type=\"application/json\">${routeDataPayload}</script>`,
         `<script>window.__HYPER_ROUTE_ID__ = ${JSON.stringify(routeId)};</script>`,
         scriptsHtml,
         "</body>",
@@ -307,8 +498,31 @@ const renderSsrHtmlFragments = (routeId, head, propsPayload, scripts, hydration,
     ].join("");
     return { prefix, suffix };
 };
-const renderSsrHtml = (routeId, html, head, propsPayload, scripts, hydration, scriptType, buildVersion) => {
-    const { prefix, suffix } = renderSsrHtmlFragments(routeId, head, propsPayload, scripts, hydration, scriptType, buildVersion);
+const renderSsrHtml = (routeId, html, head, propsPayload, routeDataPayload, scripts, styles, hydration, scriptType, buildVersion, renderDocument) => {
+    if (renderDocument) {
+        try {
+            const custom = renderDocument({
+                html,
+                head,
+                propsPayload,
+                routeDataPayload,
+                routeId,
+                hydration,
+                scripts,
+                legacyScripts: [],
+                styles,
+                scriptType,
+                buildVersion,
+            });
+            if (typeof custom === "string") {
+                return custom;
+            }
+        }
+        catch {
+            // Fall back to default template if custom document rendering fails.
+        }
+    }
+    const { prefix, suffix } = renderSsrHtmlFragments(routeId, head, propsPayload, routeDataPayload, scripts, styles, hydration, scriptType, buildVersion);
     return `${prefix}${html}${suffix}`;
 };
 const resolveScriptUrl = (basePath, file) => {
@@ -345,6 +559,19 @@ const resolveChunkScripts = (manifest, entryKey, basePath, assetsDir, buildVersi
     walk(entryKey);
     return scripts;
 };
+const resolveEntryStyles = (entry, basePath, assetsDir, buildVersion) => {
+    const styles = entry.styles ?? [];
+    const urls = [];
+    for (const style of styles) {
+        if (typeof style !== "string" || style.length === 0) {
+            continue;
+        }
+        const normalized = style.replace(/^\/+/, "");
+        const filePath = normalized.includes("/") ? normalized : `${assetsDir}/${normalized}`;
+        urls.push(appendBuildVersion(resolveScriptUrl(basePath, filePath), buildVersion));
+    }
+    return urls;
+};
 const resolveScriptType = (manifest) => manifest.assets?.scriptType === "classic" ? "classic" : "module";
 const isExternalUrl = (value) => value.startsWith("http://") || value.startsWith("https://") || value.startsWith("//");
 const appendBuildVersion = (value, buildVersion) => {
@@ -394,6 +621,24 @@ const createRuntimeContext = async (options) => {
     const assetsDir = typeof manifest.assets?.assetsDir === "string" && manifest.assets.assetsDir.length > 0
         ? normalizeAssetsDir(manifest.assets.assetsDir)
         : "assets";
+    const serverAssetPaths = new Set();
+    const registerServerAsset = (entryKey) => {
+        if (!entryKey) {
+            return;
+        }
+        const chunk = manifest.chunks[entryKey];
+        if (!chunk || typeof chunk.file !== "string") {
+            return;
+        }
+        const normalized = chunk.file.replace(/^\/+/, "");
+        const filePath = normalized.includes("/") ? normalized : `${assetsDir}/${normalized}`;
+        serverAssetPaths.add(`/${filePath}`);
+    };
+    for (const entry of Object.values(manifest.routes)) {
+        registerServerAsset(entry.serverEntry);
+    }
+    registerServerAsset(manifest.special?.notFound?.serverEntry);
+    registerServerAsset(manifest.special?.error?.serverEntry);
     const serializeRouteProps = resolveRuntimePropsSerializer(options);
     const resolveServerEntryModule = async (entry) => {
         if (!entry.serverEntry) {
@@ -424,6 +669,30 @@ const createRuntimeContext = async (options) => {
         }
         const getServerProps = serverModule?.getServerProps ??
             serverModule?.getServerSideProps;
+        const routeDataResult = await collectRouteDataFromServerModule({
+            serverModule,
+            routeId,
+            params,
+            request,
+            response,
+        });
+        if (routeDataResult.redirect) {
+            return {
+                status: routeDataResult.redirect.status ?? 302,
+                headers: {
+                    ...routeDataResult.headers,
+                    location: routeDataResult.redirect.destination,
+                },
+                redirect: routeDataResult.redirect,
+            };
+        }
+        if (routeDataResult.error) {
+            return {
+                status: routeDataResult.error.status ?? routeDataResult.status ?? 500,
+                headers: routeDataResult.headers,
+                error: routeDataResult.error,
+            };
+        }
         // Important: resolve server props before render so SSR output matches data contracts.
         const serverProps = getServerProps
             ? await runGetServerProps(getServerProps, {
@@ -431,30 +700,47 @@ const createRuntimeContext = async (options) => {
                 params,
                 request,
                 response,
+                init: routeDataResult.initData,
+                routeData: routeDataResult.data,
             })
             : null;
         const props = serverProps?.props ?? {};
-        const renderResult = await renderToHtml({ routeId, params, props });
+        const renderResult = await renderToHtml({
+            routeId,
+            params,
+            props,
+            routeData: routeDataResult.data,
+        });
         const scripts = resolveChunkScripts(manifest, entry.clientEntry, basePath, assetsDir, manifest.version);
+        const styles = resolveEntryStyles(entry, basePath, assetsDir, manifest.version);
         const scriptType = resolveScriptType(manifest);
         const propsPayload = serializeRouteProps(props);
+        const routeDataPayload = serializeRouteProps(routeDataResult.data);
         const hydration = serverModule?.hydration === "full" || serverModule?.hydration === "islands"
             ? serverModule.hydration
             : "islands";
+        const renderDocument = serverModule && typeof serverModule.renderDocument === "function"
+            ? serverModule.renderDocument
+            : undefined;
         const payload = {
             kind: "hyper-route-payload",
             routeId,
             appHtml: renderResult.html,
             propsPayload,
+            routeDataPayload,
             head: renderResult.head ?? {},
             hydration,
         };
-        const finalHtml = renderSsrHtml(routeId, payload.appHtml, payload.head, payload.propsPayload, scripts, hydration, scriptType, manifest.version);
+        const finalHtml = renderSsrHtml(routeId, payload.appHtml, payload.head, payload.propsPayload, payload.routeDataPayload, scripts, styles, hydration, scriptType, manifest.version, renderDocument);
         return {
             payload,
             html: finalHtml,
-            status: renderResult.status ?? serverProps?.status ?? 200,
+            status: renderResult.status ??
+                serverProps?.status ??
+                routeDataResult.status ??
+                200,
             headers: {
+                ...routeDataResult.headers,
                 ...(serverProps?.headers ?? {}),
                 ...(renderResult.headers ?? {}),
             },
@@ -468,38 +754,143 @@ const createRuntimeContext = async (options) => {
         }
         const getServerProps = serverModule?.getServerProps ??
             serverModule?.getServerSideProps;
+        const routeDataResult = await collectRouteDataFromServerModule({
+            serverModule,
+            routeId,
+            params,
+            request,
+            response,
+        });
+        if (routeDataResult.redirect || routeDataResult.error) {
+            return null;
+        }
         const serverProps = getServerProps
             ? await runGetServerProps(getServerProps, {
                 routeId,
                 params,
                 request,
                 response,
+                init: routeDataResult.initData,
+                routeData: routeDataResult.data,
             })
             : null;
         const props = serverProps?.props ?? {};
-        const renderResult = await renderToStream({ routeId, params, props });
+        const renderResult = await renderToStream({
+            routeId,
+            params,
+            props,
+            routeData: routeDataResult.data,
+        });
         if (!renderResult || !renderResult.stream || typeof renderResult.stream.pipe !== "function") {
             return null;
         }
         const scripts = resolveChunkScripts(manifest, entry.clientEntry, basePath, assetsDir, manifest.version);
+        const styles = resolveEntryStyles(entry, basePath, assetsDir, manifest.version);
         const scriptType = resolveScriptType(manifest);
         const propsPayload = serializeRouteProps(props);
+        const routeDataPayload = serializeRouteProps(routeDataResult.data);
         const hydration = serverModule?.hydration === "full" || serverModule?.hydration === "islands"
             ? serverModule.hydration
             : "islands";
+        const renderDocumentFragments = serverModule &&
+            typeof serverModule.renderDocumentFragments === "function"
+            ? serverModule.renderDocumentFragments
+            : undefined;
         return {
             stream: renderResult.stream,
             head: renderResult.head ?? {},
             propsPayload,
+            routeDataPayload,
             scripts,
+            styles,
             hydration,
             scriptType,
-            status: renderResult.status ?? serverProps?.status ?? 200,
+            status: renderResult.status ??
+                serverProps?.status ??
+                routeDataResult.status ??
+                200,
             headers: {
+                ...routeDataResult.headers,
                 ...(serverProps?.headers ?? {}),
                 ...(renderResult.headers ?? {}),
             },
             abort: renderResult.abort,
+            renderDocumentFragments,
+        };
+    };
+    const renderSpecialPage = async (input) => {
+        const serverModule = await resolveServerEntryModule(input.entry);
+        const renderToHtml = serverModule?.renderToHtml;
+        if (typeof renderToHtml !== "function") {
+            throw new HyperError("MANIFEST_INVALID", "Server entry missing renderToHtml export.", {
+                entry: input.entry.serverEntry,
+            });
+        }
+        const routeDataResult = await collectRouteDataFromServerModule({
+            serverModule,
+            routeId: input.routeId,
+            params: undefined,
+            request: input.request,
+            response: input.response,
+        });
+        const mergedRouteData = {
+            ...routeDataResult.data,
+            ...(input.extraRouteData ?? {}),
+        };
+        const getServerProps = serverModule?.getServerProps ??
+            serverModule?.getServerSideProps;
+        const serverProps = getServerProps
+            ? await runGetServerProps(getServerProps, {
+                routeId: input.routeId,
+                request: input.request,
+                response: input.response,
+                init: routeDataResult.initData,
+                routeData: mergedRouteData,
+            })
+            : null;
+        const props = {
+            ...(serverProps?.props ?? {}),
+            ...(input.extraProps ?? {}),
+        };
+        const renderResult = await renderToHtml({
+            routeId: input.routeId,
+            props,
+            routeData: mergedRouteData,
+        });
+        const scripts = resolveChunkScripts(manifest, input.entry.clientEntry, basePath, assetsDir, manifest.version);
+        const styles = resolveEntryStyles(input.entry, basePath, assetsDir, manifest.version);
+        const scriptType = resolveScriptType(manifest);
+        const propsPayload = serializeRouteProps(props);
+        const routeDataPayload = serializeRouteProps(mergedRouteData);
+        const hydration = serverModule?.hydration === "full" || serverModule?.hydration === "islands"
+            ? serverModule.hydration
+            : "islands";
+        const renderDocument = serverModule && typeof serverModule.renderDocument === "function"
+            ? serverModule.renderDocument
+            : undefined;
+        const payload = {
+            kind: "hyper-route-payload",
+            routeId: input.routeId,
+            appHtml: renderResult.html,
+            propsPayload,
+            routeDataPayload,
+            head: renderResult.head ?? {},
+            hydration,
+        };
+        const finalHtml = renderSsrHtml(input.routeId, payload.appHtml, payload.head, payload.propsPayload, payload.routeDataPayload, scripts, styles, hydration, scriptType, manifest.version, renderDocument);
+        return {
+            payload,
+            html: finalHtml,
+            status: input.statusOverride ??
+                renderResult.status ??
+                serverProps?.status ??
+                routeDataResult.status ??
+                200,
+            headers: {
+                ...routeDataResult.headers,
+                ...(serverProps?.headers ?? {}),
+                ...(renderResult.headers ?? {}),
+            },
         };
     };
     return {
@@ -508,11 +899,14 @@ const createRuntimeContext = async (options) => {
         routeGraph,
         basePath,
         assetsDir,
+        serverAssetPaths,
+        special: manifest.special,
         fallbackPolicy: options.fallbackPolicy,
         appMode: options.appMode ?? "ssg",
         dynamicPageApi: options.dynamicPageApi,
         renderSsrRoute,
         renderSsrStream,
+        renderSpecialPage,
     };
 };
 const handleRuntimeRequest = async (context, request, response) => {
@@ -537,6 +931,12 @@ const handleRuntimeRequest = async (context, request, response) => {
     }
     const assetPath = resolveAssetPath(context.distDir, urlPath, context.assetsDir);
     if (assetPath) {
+        // Guard: server entry bundles must never be publicly downloadable.
+        if (context.serverAssetPaths.has(urlPath)) {
+            response.statusCode = 404;
+            response.end();
+            return;
+        }
         try {
             const assetStat = await stat(assetPath);
             if (assetStat.isFile()) {
@@ -630,7 +1030,7 @@ const handleRuntimeRequest = async (context, request, response) => {
                             response.setHeader(key, value);
                         }
                         response.setHeader("content-type", "text/html; charset=utf-8");
-                        const { prefix, suffix } = renderSsrHtmlFragments(match.route.id, streamResult.head, streamResult.propsPayload, streamResult.scripts, streamResult.hydration, streamResult.scriptType, context.manifest.version);
+                        const { prefix, suffix } = renderSsrHtmlFragments(match.route.id, streamResult.head, streamResult.propsPayload, streamResult.routeDataPayload, streamResult.scripts, streamResult.styles, streamResult.hydration, streamResult.scriptType, context.manifest.version, streamResult.renderDocumentFragments);
                         response.write(prefix);
                         response.flushHeaders?.();
                         const stream = streamResult.stream;
@@ -668,6 +1068,64 @@ const handleRuntimeRequest = async (context, request, response) => {
                     }
                 }
                 const ssrResult = await context.renderSsrRoute(entry, match.route.id, match.params, request, response);
+                if (ssrResult.redirect) {
+                    if (navigationRequest) {
+                        response.statusCode = 200;
+                        response.setHeader("content-type", "application/json; charset=utf-8");
+                        response.setHeader("x-hyper-navigation", NAVIGATION_MODE);
+                        response.end(JSON.stringify({
+                            kind: "hyper-route-redirect",
+                            destination: ssrResult.redirect.destination,
+                            status: ssrResult.redirect.status ?? 302,
+                            replace: ssrResult.redirect.replace ?? false,
+                        }));
+                        return;
+                    }
+                    response.statusCode = ssrResult.redirect.status ?? 302;
+                    response.setHeader("location", ssrResult.redirect.destination);
+                    response.end();
+                    return;
+                }
+                if (ssrResult.error) {
+                    const errorEntry = context.special?.error;
+                    if (errorEntry?.serverEntry) {
+                        const errorResult = await context.renderSpecialPage({
+                            entry: errorEntry,
+                            routeId: SPECIAL_ROUTE_IDS.error,
+                            request,
+                            response,
+                            statusOverride: ssrResult.error.status ?? ssrResult.status ?? 500,
+                            extraRouteData: {
+                                [ROUTE_DATA_ERROR_KEY]: ssrResult.error,
+                            },
+                            extraProps: {
+                                error: ssrResult.error,
+                                routeId: match.route.id,
+                            },
+                        });
+                        if (navigationRequest && errorResult.payload) {
+                            response.statusCode = errorResult.status;
+                            for (const [key, value] of Object.entries(errorResult.headers ?? {})) {
+                                response.setHeader(key, value);
+                            }
+                            response.setHeader("content-type", "application/json; charset=utf-8");
+                            response.setHeader("x-hyper-navigation", NAVIGATION_MODE);
+                            response.end(JSON.stringify(errorResult.payload));
+                            return;
+                        }
+                        response.statusCode = errorResult.status;
+                        for (const [key, value] of Object.entries(errorResult.headers ?? {})) {
+                            response.setHeader(key, value);
+                        }
+                        response.setHeader("content-type", "text/html; charset=utf-8");
+                        response.end(errorResult.html ?? "");
+                        return;
+                    }
+                    response.statusCode = ssrResult.error.status ?? ssrResult.status ?? 500;
+                    response.setHeader("content-type", "text/plain; charset=utf-8");
+                    response.end(ssrResult.error.message ?? "SSR route error");
+                    return;
+                }
                 if (navigationRequest) {
                     response.statusCode = ssrResult.status ?? 200;
                     for (const [key, value] of Object.entries(ssrResult.headers ?? {})) {
@@ -687,6 +1145,35 @@ const handleRuntimeRequest = async (context, request, response) => {
                 return;
             }
             catch {
+                const errorEntry = context.special?.error;
+                if (errorEntry?.serverEntry) {
+                    try {
+                        const errorResult = await context.renderSpecialPage({
+                            entry: errorEntry,
+                            routeId: SPECIAL_ROUTE_IDS.error,
+                            request,
+                            response,
+                            statusOverride: 500,
+                            extraRouteData: {
+                                [ROUTE_DATA_ERROR_KEY]: { status: 500, message: "SSR render failed" },
+                            },
+                            extraProps: {
+                                error: { status: 500, message: "SSR render failed" },
+                                routeId: match.route.id,
+                            },
+                        });
+                        response.statusCode = errorResult.status;
+                        for (const [key, value] of Object.entries(errorResult.headers ?? {})) {
+                            response.setHeader(key, value);
+                        }
+                        response.setHeader("content-type", "text/html; charset=utf-8");
+                        response.end(errorResult.html ?? "");
+                        return;
+                    }
+                    catch {
+                        // Fall through to plain error response.
+                    }
+                }
                 response.statusCode = 500;
                 response.setHeader("content-type", "text/plain; charset=utf-8");
                 response.end("SSR render failed");
@@ -735,6 +1222,67 @@ const handleRuntimeRequest = async (context, request, response) => {
         response.end(renderRuntimePlaceholder(match.route.id));
         return;
     }
+    const notFoundEntry = context.special?.notFound;
+    if (notFoundEntry?.serverEntry) {
+        try {
+            const notFoundResult = await context.renderSpecialPage({
+                entry: notFoundEntry,
+                routeId: SPECIAL_ROUTE_IDS.notFound,
+                request,
+                response,
+                statusOverride: 404,
+                extraProps: {
+                    routeId: urlPath,
+                },
+            });
+            if (navigationRequest && notFoundResult.payload) {
+                response.statusCode = 404;
+                for (const [key, value] of Object.entries(notFoundResult.headers ?? {})) {
+                    response.setHeader(key, value);
+                }
+                response.setHeader("content-type", "application/json; charset=utf-8");
+                response.setHeader("x-hyper-navigation", NAVIGATION_MODE);
+                response.end(JSON.stringify(notFoundResult.payload));
+                return;
+            }
+            response.statusCode = 404;
+            for (const [key, value] of Object.entries(notFoundResult.headers ?? {})) {
+                response.setHeader(key, value);
+            }
+            response.setHeader("content-type", "text/html; charset=utf-8");
+            response.end(notFoundResult.html ?? "");
+            return;
+        }
+        catch {
+            // Fall through to static or plain 404 response.
+        }
+    }
+    if (notFoundEntry?.html) {
+        const htmlPath = resolveManifestFile(context.distDir, notFoundEntry.html);
+        if (htmlPath) {
+            try {
+                const file = await readStaticFile(htmlPath);
+                if (navigationRequest) {
+                    const text = file.body.toString("utf-8");
+                    const payload = extractNavigationPayloadFromHtml(text, SPECIAL_ROUTE_IDS.notFound);
+                    if (payload) {
+                        response.statusCode = 404;
+                        response.setHeader("content-type", "application/json; charset=utf-8");
+                        response.setHeader("x-hyper-navigation", NAVIGATION_MODE);
+                        response.end(JSON.stringify(payload));
+                        return;
+                    }
+                }
+                response.statusCode = 404;
+                response.setHeader("content-type", file.contentType);
+                response.end(file.body);
+                return;
+            }
+            catch {
+                // Fall through to plain response.
+            }
+        }
+    }
     response.statusCode = 404;
     response.setHeader("content-type", "text/plain; charset=utf-8");
     response.end("Not Found");

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tyndall/runtime",
-  "version": "0.0.1",
+  "version": "0.0.3",
   "publishConfig": {
     "access": "public"
   },
@@ -10,7 +10,7 @@
   "exports": {
     ".": {
       "types": "./dist/index.d.ts",
-      "bun": "./src/index.ts",
+      "bun": "./dist/index.js",
       "default": "./dist/index.js"
     }
   },
@@ -21,7 +21,7 @@
     "build": "tsc -p tsconfig.json"
   },
   "dependencies": {
-    "@tyndall/core": "workspace:*",
-    "@tyndall/shared": "workspace:*"
+    "@tyndall/core": "^0.0.3",
+    "@tyndall/shared": "^0.0.3"
   }
 }