@timber-js/app 0.2.0-alpha.145 → 0.2.0-alpha.147

package/dist/server/internal.js

@@ -3,7 +3,7 @@ import { a as warnRedirectInSuspense, c as warnSuspenseWrappingChildren, i as wa
 import { i as getMetadataRouteServePath, n as classifyMetadataRoute, r as getMetadataRouteAutoLink, t as METADATA_ROUTE_CONVENTIONS } from "../_chunks/metadata-routes-BjepjefT.js";
 import { n as classifyUrlSegment } from "../_chunks/segment-classify-CDDRVKs7.js";
 import { a as logProxyError, c as logRequestReceived, d as logSwrRefetchFailed, f as logWaitUntilRejected, h as swallow, i as logMiddlewareShortCircuit, l as logRouteError, m as setLogger, n as logCacheMiss, o as logRenderError, p as logWaitUntilUnsupported, r as logMiddlewareError, s as logRequestCompleted, t as getLogger, u as logSlowRequest } from "../_chunks/logger-Dt-jQaBO.js";
-import { C as setMatchedSegmentPath, E as getCookie, O as getSetCookieHeaders, S as runWithRequestContext, T as setSegmentParams, _ as getHeader, b as getSegmentParams, c as DenySignal, d as RenderError, g as applyRequestHeaderOverlay, l as RedirectSignal, n as executeAction, o as coerce, r as isRscActionRequest, t as buildNoJsResponse, w as setMutableCookieContext, x as markResponseFlushed, y as getSearchParams } from "../_chunks/actions-DzFMnUAR.js";
+import { C as setMatchedSegmentPath, E as getCookie, O as getSetCookieHeaders, S as runWithRequestContext, T as setSegmentParams, _ as getHeader, b as getSegmentParams, c as DenySignal, g as applyRequestHeaderOverlay, l as RedirectSignal, n as executeAction, o as coerce, r as isRscActionRequest, t as buildNoJsResponse, u as RenderError, w as setMutableCookieContext, x as markResponseFlushed, y as getSearchParams } from "../_chunks/actions-OIZ8siQu.js";
 import "../client/error-boundary.js";
 import { n as toBracketKey } from "../_chunks/resolve-schema-Dj8tQloi.js";
 import "../_chunks/segment-context-ZDnXDkbz.js";
@@ -1119,6 +1119,39 @@ function resolveMetadataUrls(metadata) {
 	return result;
 }
 //#endregion
+//#region src/client/error-reconstituter.tsx
+/**
+* Reconstitutes a SerializableError into a real Error instance before
+* passing to the user's error component.
+*
+* TSX error pages are 'use client' components that receive { error: Error, digest, reset }.
+* Error objects are not RSC-serializable (React Flight throws "Only plain objects
+* can be passed to Client Components"). This wrapper receives the error as a plain
+* SerializableError object, reconstitutes a real Error instance, and passes it
+* to the user's error component — ensuring error instanceof Error works correctly.
+*
+* See design/spike-TIM-565-unify-error-pages.md §"Edge Case B"
+* See design/10-error-handling.md §"RSC → SSR for Error Pages via SerializableError"
+*/
+/**
+* Reconstitute a SerializableError into a real Error instance and render
+* the user's error component with the proper props.
+*/
+function ErrorReconstituter({ error: serialized, digest, reset, component, status, dangerouslyPassData }) {
+	return createElement(component, {
+		error: Object.assign(new Error(serialized.message), {
+			name: serialized.name,
+			...serialized.stack != null ? { stack: serialized.stack } : {}
+		}),
+		digest,
+		reset,
+		...status != null ? {
+			status,
+			dangerouslyPassData
+		} : {}
+	});
+}
+//#endregion
 //#region src/server/safe-load.ts
 /**
 * Custom error class for module load failures.
@@ -1160,6 +1193,165 @@ async function loadModule(loader) {
 		throw new ModuleLoadError(loader.filePath, error);
 	}
 }
+/** Reverse index: status code → legacy file name. Built once at module load. */
+var STATUS_TO_LEGACY_FILE = Object.fromEntries(Object.entries({
+	"not-found": 404,
+	"forbidden": 403,
+	"unauthorized": 401
+}).map(([name, status]) => [status, name]));
+/**
+* Look up `{statusStr}` then `{categoryKey}` (e.g. "4xx" / "5xx") in a
+* status-file group on a single segment. Shared by all three fallback
+* chains — the only structural difference between component 4xx,
+* component 5xx, and JSON resolution is *which* group is searched and
+* how the per-segment loop is layered around it.
+*/
+function lookupInGroup(group, statusStr, categoryKey, segmentIndex, status) {
+	if (!group) return null;
+	const exact = group[statusStr];
+	if (exact) return {
+		file: exact,
+		status,
+		kind: "exact",
+		segmentIndex
+	};
+	const category = group[categoryKey];
+	if (category) return {
+		file: category,
+		status,
+		kind: "category",
+		segmentIndex
+	};
+	return null;
+}
+/**
+* Look up the legacy convention file (`not-found.tsx` / `forbidden.tsx` /
+* `unauthorized.tsx`) for `status` on a single segment. Returns null if
+* `status` has no legacy mapping or the file isn't present.
+*/
+function lookupLegacy(group, status, segmentIndex) {
+	if (!group) return null;
+	const name = STATUS_TO_LEGACY_FILE[status];
+	if (!name) return null;
+	const file = group[name];
+	return file ? {
+		file,
+		status,
+		kind: "legacy",
+		segmentIndex
+	} : null;
+}
+/**
+* Resolve the status-code file to render for a given HTTP status code.
+*
+* Walks the segment chain from leaf to root following the fallback chain
+* defined in design/10-error-handling.md. Returns null if no file is found
+* (caller should render the framework default).
+*
+* @param status - The HTTP status code (4xx or 5xx).
+* @param segments - The matched segment chain from root (index 0) to leaf (last).
+* @param format - The response format family ('component' or 'json'). Defaults to 'component'.
+*/
+function resolveStatusFile(status, segments, format = "component") {
+	if (status < 400 || status > 599) return null;
+	if (format === "json") return resolveJson(status, segments);
+	if (status <= 499) return resolve4xx(status, segments);
+	return resolve5xx(status, segments);
+}
+/**
+* 4xx component fallback chain — three separate full passes leaf→root.
+*
+* The passes must be separate (not interleaved per-segment) so that a
+* root-level `404.tsx` beats a leaf-level `error.tsx`. The 5xx chain
+* inverts this and is per-segment: a leaf's `error.tsx` beats a root's
+* `5xx.tsx`. This asymmetry is the only reason these two functions exist
+* separately.
+*
+*   Pass 1 — {status}.tsx → 4xx.tsx           (statusFiles)
+*   Pass 2 — not-found / forbidden / unauthorized (legacyStatusFiles)
+*   Pass 3 — error.tsx                         (error)
+*/
+function resolve4xx(status, segments) {
+	const statusStr = String(status);
+	for (let i = segments.length - 1; i >= 0; i--) {
+		const r = lookupInGroup(segments[i].statusFiles, statusStr, "4xx", i, status);
+		if (r) return r;
+	}
+	for (let i = segments.length - 1; i >= 0; i--) {
+		const r = lookupLegacy(segments[i].legacyStatusFiles, status, i);
+		if (r) return r;
+	}
+	for (let i = segments.length - 1; i >= 0; i--) {
+		const errorFile = segments[i].error;
+		if (errorFile) return {
+			file: errorFile,
+			status,
+			kind: "error",
+			segmentIndex: i
+		};
+	}
+	return null;
+}
+/**
+* 5xx component fallback chain — single pass, per-segment leaf→root.
+*
+* At each segment: {status}.tsx → 5xx.tsx → error.tsx. A leaf's
+* `error.tsx` therefore beats a root's `5xx.tsx`, which is the
+* intentional inverse of the 4xx chain.
+*/
+function resolve5xx(status, segments) {
+	const statusStr = String(status);
+	for (let i = segments.length - 1; i >= 0; i--) {
+		const segment = segments[i];
+		const r = lookupInGroup(segment.statusFiles, statusStr, "5xx", i, status);
+		if (r) return r;
+		if (segment.error) return {
+			file: segment.error,
+			status,
+			kind: "error",
+			segmentIndex: i
+		};
+	}
+	return null;
+}
+/**
+* JSON fallback chain (for both 4xx and 5xx) — single pass leaf→root.
+*
+* At each segment: {status}.json → {category}.json. No legacy compat,
+* no error.tsx — the JSON chain terminates at the category catch-all
+* and the caller falls back to a bare-JSON framework default.
+*/
+function resolveJson(status, segments) {
+	const statusStr = String(status);
+	const categoryKey = status >= 500 ? "5xx" : "4xx";
+	for (let i = segments.length - 1; i >= 0; i--) {
+		const r = lookupInGroup(segments[i].jsonStatusFiles, statusStr, categoryKey, i, status);
+		if (r) return r;
+	}
+	return null;
+}
+/**
+* Resolve the denial file for a parallel route slot.
+*
+* Slot denial is graceful degradation — no HTTP status on the wire.
+* Fallback chain: denied.tsx → default.tsx → null.
+*
+* @param slotNode - The segment node for the slot (segmentType === 'slot').
+*/
+function resolveSlotDenied(slotNode) {
+	const slotName = slotNode.segmentName.replace(/^@/, "");
+	if (slotNode.denied) return {
+		file: slotNode.denied,
+		slotName,
+		kind: "denied"
+	};
+	if (slotNode.default) return {
+		file: slotNode.default,
+		slotName,
+		kind: "default"
+	};
+	return null;
+}
 //#endregion
 //#region src/server/deny-boundary.ts
 /**
@@ -1197,28 +1389,45 @@ async function loadModule(loader) {
 * Returns a React element for the matching component, or null if no match.
 */
 function renderMatchingDenyPage(chain, status, data) {
-	const h = createElement;
 	for (const entry of chain) {
-		if (entry.status === status) return h(entry.component, {
-			status,
-			dangerouslyPassData: data
-		});
-		if (entry.status === 400 && status >= 400 && status <= 499) return h(entry.component, {
-			status,
-			dangerouslyPassData: data
-		});
-		if (entry.status === 500 && status >= 500 && status <= 599) return h(entry.component, {
-			status,
-			dangerouslyPassData: data
-		});
-		if (entry.status === null) return h(entry.component, {
-			status,
-			dangerouslyPassData: data
-		});
+		if (entry.status === status) return renderDenyEntry(entry, status, data);
+		if (entry.status === 400 && status >= 400 && status <= 499) return renderDenyEntry(entry, status, data);
+		if (entry.status === 500 && status >= 500 && status <= 599) return renderDenyEntry(entry, status, data);
+		if (entry.status === null) return renderDenyEntry(entry, status, data);
 	}
 	return null;
 }
 /**
+* Build the element for a matched deny chain entry with the props contract
+* the file's convention documents:
+*
+* - Status-code and legacy files: { status, dangerouslyPassData }
+* - error.tsx (TSX): { error, digest, reset } via ErrorReconstituter, plus
+*   { status, dangerouslyPassData } for dual-shape implementations. Without
+*   the Error prop, any error.tsx written per the docs (reading
+*   error.message) crashes — turning a clean deny(404) into a 500. TIM-1081.
+* - error.mdx: plain { status } — server component, static content.
+*/
+function renderDenyEntry(entry, status, data) {
+	const h = createElement;
+	if (entry.kind !== "error") return h(entry.component, {
+		status,
+		dangerouslyPassData: data
+	});
+	if (entry.isMdx) return h(entry.component, { status });
+	return h(ErrorReconstituter, {
+		error: {
+			message: `Access denied with status ${status}`,
+			name: "DenySignal"
+		},
+		digest: null,
+		reset: void 0,
+		component: entry.component,
+		status,
+		dangerouslyPassData: data
+	});
+}
+/**
 * Set the deny status in the request context ALS.
 * Called from AccessGate / PageDenyBoundary when a DenySignal is caught.
 * The pipeline reads this after render to set the HTTP status code.
@@ -2589,167 +2798,6 @@ async function wrapWithErrorBoundaries(segment, element, loadModule, createEleme
 	return element;
 }
 //#endregion
-//#region src/server/status-code-resolver.ts
-/** Reverse index: status code → legacy file name. Built once at module load. */
-var STATUS_TO_LEGACY_FILE = Object.fromEntries(Object.entries({
-	"not-found": 404,
-	"forbidden": 403,
-	"unauthorized": 401
-}).map(([name, status]) => [status, name]));
-/**
-* Look up `{statusStr}` then `{categoryKey}` (e.g. "4xx" / "5xx") in a
-* status-file group on a single segment. Shared by all three fallback
-* chains — the only structural difference between component 4xx,
-* component 5xx, and JSON resolution is *which* group is searched and
-* how the per-segment loop is layered around it.
-*/
-function lookupInGroup(group, statusStr, categoryKey, segmentIndex, status) {
-	if (!group) return null;
-	const exact = group[statusStr];
-	if (exact) return {
-		file: exact,
-		status,
-		kind: "exact",
-		segmentIndex
-	};
-	const category = group[categoryKey];
-	if (category) return {
-		file: category,
-		status,
-		kind: "category",
-		segmentIndex
-	};
-	return null;
-}
-/**
-* Look up the legacy convention file (`not-found.tsx` / `forbidden.tsx` /
-* `unauthorized.tsx`) for `status` on a single segment. Returns null if
-* `status` has no legacy mapping or the file isn't present.
-*/
-function lookupLegacy(group, status, segmentIndex) {
-	if (!group) return null;
-	const name = STATUS_TO_LEGACY_FILE[status];
-	if (!name) return null;
-	const file = group[name];
-	return file ? {
-		file,
-		status,
-		kind: "legacy",
-		segmentIndex
-	} : null;
-}
-/**
-* Resolve the status-code file to render for a given HTTP status code.
-*
-* Walks the segment chain from leaf to root following the fallback chain
-* defined in design/10-error-handling.md. Returns null if no file is found
-* (caller should render the framework default).
-*
-* @param status - The HTTP status code (4xx or 5xx).
-* @param segments - The matched segment chain from root (index 0) to leaf (last).
-* @param format - The response format family ('component' or 'json'). Defaults to 'component'.
-*/
-function resolveStatusFile(status, segments, format = "component") {
-	if (status < 400 || status > 599) return null;
-	if (format === "json") return resolveJson(status, segments);
-	if (status <= 499) return resolve4xx(status, segments);
-	return resolve5xx(status, segments);
-}
-/**
-* 4xx component fallback chain — three separate full passes leaf→root.
-*
-* The passes must be separate (not interleaved per-segment) so that a
-* root-level `404.tsx` beats a leaf-level `error.tsx`. The 5xx chain
-* inverts this and is per-segment: a leaf's `error.tsx` beats a root's
-* `5xx.tsx`. This asymmetry is the only reason these two functions exist
-* separately.
-*
-*   Pass 1 — {status}.tsx → 4xx.tsx           (statusFiles)
-*   Pass 2 — not-found / forbidden / unauthorized (legacyStatusFiles)
-*   Pass 3 — error.tsx                         (error)
-*/
-function resolve4xx(status, segments) {
-	const statusStr = String(status);
-	for (let i = segments.length - 1; i >= 0; i--) {
-		const r = lookupInGroup(segments[i].statusFiles, statusStr, "4xx", i, status);
-		if (r) return r;
-	}
-	for (let i = segments.length - 1; i >= 0; i--) {
-		const r = lookupLegacy(segments[i].legacyStatusFiles, status, i);
-		if (r) return r;
-	}
-	for (let i = segments.length - 1; i >= 0; i--) {
-		const errorFile = segments[i].error;
-		if (errorFile) return {
-			file: errorFile,
-			status,
-			kind: "error",
-			segmentIndex: i
-		};
-	}
-	return null;
-}
-/**
-* 5xx component fallback chain — single pass, per-segment leaf→root.
-*
-* At each segment: {status}.tsx → 5xx.tsx → error.tsx. A leaf's
-* `error.tsx` therefore beats a root's `5xx.tsx`, which is the
-* intentional inverse of the 4xx chain.
-*/
-function resolve5xx(status, segments) {
-	const statusStr = String(status);
-	for (let i = segments.length - 1; i >= 0; i--) {
-		const segment = segments[i];
-		const r = lookupInGroup(segment.statusFiles, statusStr, "5xx", i, status);
-		if (r) return r;
-		if (segment.error) return {
-			file: segment.error,
-			status,
-			kind: "error",
-			segmentIndex: i
-		};
-	}
-	return null;
-}
-/**
-* JSON fallback chain (for both 4xx and 5xx) — single pass leaf→root.
-*
-* At each segment: {status}.json → {category}.json. No legacy compat,
-* no error.tsx — the JSON chain terminates at the category catch-all
-* and the caller falls back to a bare-JSON framework default.
-*/
-function resolveJson(status, segments) {
-	const statusStr = String(status);
-	const categoryKey = status >= 500 ? "5xx" : "4xx";
-	for (let i = segments.length - 1; i >= 0; i--) {
-		const r = lookupInGroup(segments[i].jsonStatusFiles, statusStr, categoryKey, i, status);
-		if (r) return r;
-	}
-	return null;
-}
-/**
-* Resolve the denial file for a parallel route slot.
-*
-* Slot denial is graceful degradation — no HTTP status on the wire.
-* Fallback chain: denied.tsx → default.tsx → null.
-*
-* @param slotNode - The segment node for the slot (segmentType === 'slot').
-*/
-function resolveSlotDenied(slotNode) {
-	const slotName = slotNode.segmentName.replace(/^@/, "");
-	if (slotNode.denied) return {
-		file: slotNode.denied,
-		slotName,
-		kind: "denied"
-	};
-	if (slotNode.default) return {
-		file: slotNode.default,
-		slotName,
-		kind: "default"
-	};
-	return null;
-}
-//#endregion
 //#region src/server/flush.ts
 /**
 * Flush controller for timber.js rendering.