@jk2908/solas 0.3.2 → 0.3.3

package/CHANGELOG.md

@@ -1,5 +1,9 @@
 # Changelog
 
+## 0.3.3 - 2026-04-23
+
+- Fixed HTML missing-route rendering when Solas is installed from npm by serialising `HttpException` and `Error` values into transport-safe objects before they cross the RSC payload boundary, preserving the expected 404 flow instead of crashing during SSR.
+
 ## 0.3.2 - 2026-04-21
 
 - Fixed PPR flight transport and closed-connection handling by replacing `rsc-html-stream` with the local runtime transport.

package/dist/internal/env/flight.js

@@ -91,17 +91,20 @@ export function injectPayload(payload, opts = {}) {
             let html = decoder.decode(chunk, { stream: true });
             // hold the final closing tags back so payload scripts land inside the document,
             // not after it
-            if (html.endsWith(HTML_TRAIL)) {
+            if (html.endsWith(HTML_TRAIL))
                 html = html.slice(0, -HTML_TRAIL.length);
-            }
+            // write the buffered html before the payload scripts, so they are guaranteed to be
+            // parsed in the right place
             if (html)
                 controller.enqueue(encoder.encode(html));
         }
         // flush any decoder state left over from split utf-8/html chunks
         let remaining = decoder.decode();
-        if (remaining.endsWith(HTML_TRAIL)) {
+        // if the remaining buffered html ends with the closing tags, remove them so they
+        // can be re-appended after the payload
+        if (remaining.endsWith(HTML_TRAIL))
             remaining = remaining.slice(0, -HTML_TRAIL.length);
-        }
+        // if there is any html left after removing the closing tags, write it before the payload
         if (remaining)
             controller.enqueue(encoder.encode(remaining));
         buffered = [];
@@ -159,7 +162,7 @@ async function writePayload(payload, controller, nonce) {
         catch {
             // most rows are text, but keep binary chunks intact when a payload
             // row cannot be decoded as utf-8
-            const base64 = JSON.stringify(btoa(String.fromCodePoint(...chunk)));
+            const base64 = JSON.stringify(window.btoa(String.fromCodePoint(...chunk)));
             writePayloadScript(`Uint8Array.from(atob(${base64}), value => value.codePointAt(0))`, controller, nonce);
         }
     }

package/dist/internal/env/rsc.js

@@ -6,7 +6,7 @@ import { createHttpRouter } from '../http-router/create-http-router.js';
 import { HttpRouter } from '../http-router/router.js';
 import { normalisePathname } from '../http-router/utils.js';
 import { Metadata } from '../metadata.js';
-import { HttpException, isHttpException } from '../navigation/http-exception.js';
+import { HttpException, isHttpException, toHttpExceptionLike, } from '../navigation/http-exception.js';
 import { Prerender } from '../prerender.js';
 import { Tree } from '../render/tree.js';
 import { Resolver } from '../resolver.js';
@@ -32,8 +32,8 @@ async function createPayload(req, manifest, importMap, baseMetadata, returnValue
     // has been found, and we should server render a default
     // error screen
     if (!match) {
-        const error = req[Solas.Config.REQUEST_META_KEY].error ?? new HttpException(404, 'Not found');
-        const title = `${'status' in error ? `${error.status} -` : ''}${error.message}`;
+        const error = toHttpExceptionLike(req[Solas.Config.REQUEST_META_KEY].error ?? new HttpException(404, 'Not found'));
+        const title = `${error.status ? `${error.status} -` : ''}${error.message}`;
         const rscPayload = {
             root: (_jsxs("html", { lang: "en", children: [
                     _jsxs("head", { children: [
@@ -80,8 +80,9 @@ async function createPayload(req, manifest, importMap, baseMetadata, returnValue
     const metadata = collection
         .add(...(match.metadata?.({ params: match.params, error: match.error }) ?? []))
         .run();
+    const error = match.error ? toHttpExceptionLike(match.error) : undefined;
     const rscPayload = {
-        root: (_jsx(_Fragment, { children: _jsx(Tree, { depth: match.__depth, params: match.params, error: match.error, ui: match.ui }) })),
+        root: (_jsx(_Fragment, { children: _jsx(Tree, { depth: match.__depth, params: match.params, error: error, ui: match.ui }) })),
         returnValue,
         formState,
         metadata,
@@ -124,9 +125,9 @@ async function createPayload(req, manifest, importMap, baseMetadata, returnValue
                 ? `${err.status} - ${err.message}`
                 : `500 - ${err.message}`
             : '500 - Unknown server error';
-        const error = new Error(err instanceof Error ? err.message : 'Unknown server error', {
+        const error = toHttpExceptionLike(new Error(err instanceof Error ? err.message : 'Unknown server error', {
             cause: err,
-        });
+        }));
         return {
             // this branch renders the minimal error shell after the
             // main tree throws. We keep the same mode as the

package/dist/internal/navigation/http-exception.d.ts

@@ -7,6 +7,7 @@ export declare namespace HttpException {
     };
 }
 export declare const HTTP_EXCEPTION_NAME_MAP: Record<HttpException.StatusCode, string>;
+export type HttpExceptionLike = Pick<Error, 'name' | 'message' | 'stack'> & Partial<Pick<HttpException, 'digest' | 'payload' | 'status'>>;
 /**
  * An exception representing an HTTP error, with an optional payload
  * and cause
@@ -21,9 +22,13 @@ export declare class HttpException extends Error {
 export declare const HTTP_EXCEPTION_DIGEST_PREFIX = "HTTP_EXCEPTION";
 /**
  * Check if an error is an HTTPException
- * @description uses the digest property to work across server/client boundaries
  */
 export declare function isHttpException(err: unknown): err is HttpException;
+/**
+ * Convert an HttpException or any Error into a plain object that can be
+ * safely serialised
+ */
+export declare function toHttpExceptionLike(error: HttpException | Error): HttpExceptionLike;
 /**
  * Throw an HTTPException
  */

package/dist/internal/navigation/http-exception.js

@@ -25,7 +25,6 @@ export class HttpException extends Error {
 export const HTTP_EXCEPTION_DIGEST_PREFIX = 'HTTP_EXCEPTION';
 /**
  * Check if an error is an HTTPException
- * @description uses the digest property to work across server/client boundaries
  */
 export function isHttpException(err) {
     return (typeof err === 'object' &&
@@ -34,6 +33,24 @@ export function isHttpException(err) {
         typeof err.digest === 'string' &&
         err.digest.startsWith(HTTP_EXCEPTION_DIGEST_PREFIX));
 }
+/**
+ * Convert an HttpException or any Error into a plain object that can be
+ * safely serialised
+ */
+export function toHttpExceptionLike(error) {
+    return {
+        name: error.name,
+        message: error.message,
+        stack: error.stack,
+        ...('digest' in error && typeof error.digest === 'string'
+            ? { digest: error.digest }
+            : {}),
+        ...('payload' in error && error.payload !== undefined
+            ? { payload: error.payload }
+            : {}),
+        ...('status' in error ? { status: error.status } : {}),
+    };
+}
 /**
  * Throw an HTTPException
  */

package/dist/internal/render/tree.d.ts

@@ -1,4 +1,5 @@
 import type { Resolver } from '../resolver.js';
+import { type HttpExceptionLike } from '../navigation/http-exception.js';
 type Match = NonNullable<Resolver.EnhancedMatch>;
 /**
  * Render the resolved route tree for a matched page
@@ -41,7 +42,7 @@ type Match = NonNullable<Resolver.EnhancedMatch>;
 export declare function Tree({ depth, params, error, ui }: {
     depth: Match['__depth'];
     params: Match['params'];
-    error: Match['error'];
+    error?: HttpExceptionLike;
     ui: Match['ui'];
 }): import("react/jsx-runtime").JSX.Element;
 export {};

package/dist/internal/render/tree.js

@@ -1,7 +1,7 @@
 import { Fragment as _Fragment, jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
 import { Suspense } from 'react';
 import { HttpExceptionBoundary } from '../navigation/http-exception-boundary.js';
-import { HttpException, isHttpException } from '../navigation/http-exception.js';
+import { HttpException, isHttpException, } from '../navigation/http-exception.js';
 import DefaultErr from '../ui/defaults/error.js';
 const UNAUTHORISED_ERROR = new HttpException(401, 'Unauthorised');
 const FORBIDDEN_ERROR = new HttpException(403, 'Forbidden');

package/dist/internal/ui/defaults/error.d.ts

@@ -1,4 +1,4 @@
-import type { HttpException } from '../../navigation/http-exception.js';
+import type { HttpExceptionLike } from '../../navigation/http-exception.js';
 export default function Err({ error }: {
-    error: HttpException | Error;
+    error: HttpExceptionLike;
 }): import("react/jsx-runtime").JSX.Element;

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@jk2908/solas",
-	"version": "0.3.2",
+	"version": "0.3.3",
 	"description": "A React Server Components meta-framework powered by Vite",
 	"keywords": [
 		"framework",