@c9up/aurora 0.1.39 → 0.1.40

package/src/liveRegistry.ts

@@ -11,6 +11,8 @@
  * and node-free (only `mountLiveSession` + `crypto.randomUUID`, both isomorphic).
  */
 
+import { AuroraError } from "./errors.js";
+
 import {
 	type LiveComponentDefinition,
 	type LiveSession,
@@ -75,7 +77,8 @@ export function createLiveRegistry(): LiveRegistry {
 		mount(name, ownerId) {
 			const factory = defs.get(name);
 			if (!factory) {
-				throw new Error(
+				throw new AuroraError(
+					"E_AURORA_UNKNOWN_LIVE_COMPONENT",
 					`[aurora:live] unknown live component "${name}" — register it with registry.define("${name}", …) before mounting.`,
 				);
 			}

package/src/relay.ts

@@ -18,6 +18,7 @@
  * `EventSource` being undefined.
  */
 
+import { AuroraError } from "./errors.js";
 import { xsrfHeaderFor } from "./xsrf.js";
 
 /**
@@ -334,7 +335,10 @@ async function postHandshake(url: string, channel: string): Promise<void> {
 		credentials: "include",
 	});
 	if (!res.ok) {
-		throw new Error(`HTTP ${res.status}`);
+		throw new AuroraError(
+			"E_AURORA_RELAY_REQUEST_FAILED",
+			`[aurora:relay] HTTP ${res.status}`,
+		);
 	}
 }
 

package/src/server/renderPage.ts

@@ -25,6 +25,7 @@
 
 import { AsyncLocalStorage } from "node:async_hooks";
 import { setCookieStoreReader } from "../browser.js";
+import { AuroraError } from "../errors.js";
 import type { Pages } from "../Pages.js";
 import { renderToString } from "../ssr.js";
 import { setRouteManifestReader } from "../url.js";
@@ -331,7 +332,10 @@ function isPlainRecord(value: unknown): value is Record<string, unknown> {
 
 function normalizeRootTag(tag: string): string {
 	if (/^[a-z][a-z0-9-]*$/i.test(tag)) return tag.toLowerCase();
-	throw new Error(`[aurora] illegal root tag: ${JSON.stringify(tag)}`);
+	throw new AuroraError(
+		"E_AURORA_ILLEGAL_ROOT_TAG",
+		`[aurora] illegal root tag: ${JSON.stringify(tag)}`,
+	);
 }
 
 function rootAttrs(id: string, className: string | undefined): string {

package/src/server.ts

@@ -12,11 +12,18 @@
 import "./augmentations.js";
 
 export { AuroraManager, type AuroraManagerConfig } from "./AuroraManager.js";
+export { AuroraError, type AuroraErrorCode } from "./errors.js";
 export {
 	type AuroraRequestRenderer,
 	auroraContext,
 } from "./middleware.js";
-export { type PageFactory, Pages, type PagesConfig } from "./Pages.js";
+export {
+	type PageFactory,
+	Pages,
+	type PagesConfig,
+	/** @internal classification seam, asserted by the tests */
+	pageImportError,
+} from "./Pages.js";
 export {
 	type RenderHttpContext,
 	type RenderPageOptions,

package/src/services/main.ts

@@ -11,6 +11,7 @@
  */
 
 import type { AuroraManager } from "../AuroraManager.js";
+import { AuroraError } from "../errors.js";
 
 let instance: AuroraManager | undefined;
 
@@ -48,7 +49,8 @@ const aurora: AuroraManager = new Proxy({} as AuroraManager, {
 			return undefined;
 		}
 		if (!instance) {
-			throw new Error(
+			throw new AuroraError(
+				"E_AURORA_NOT_BOOTED",
 				"[aurora] AuroraManager singleton accessed before AuroraProvider.boot() ran " +
 					"or `setAurora(myManager)` was called. Wire one of them first.",
 			);

package/src/url.ts

@@ -17,6 +17,8 @@
  * side. Node-free — part of aurora's client runtime.
  */
 
+import { AuroraError } from "./errors.js";
+
 let manifest: Record<string, string> = {};
 
 type RouteManifestReader = () => Record<string, string> | undefined;
@@ -65,7 +67,8 @@ export function urlFor(
 	const pattern = routes[name];
 	if (pattern === undefined) {
 		const known = Object.keys(routes);
-		throw new Error(
+		throw new AuroraError(
+			"E_AURORA_UNKNOWN_ROUTE",
 			`[aurora] urlFor: unknown route '${name}'. ${
 				known.length > 0
 					? `Known: ${known.join(", ")}`
@@ -91,7 +94,8 @@ export function urlFor(
 
 	const missing = url.match(/:[A-Za-z_][\w]*/g);
 	if (missing && missing.length > 0) {
-		throw new Error(
+		throw new AuroraError(
+			"E_AURORA_MISSING_ROUTE_PARAMS",
 			`[aurora] urlFor: route '${name}' is missing params ${missing.join(", ")}`,
 		);
 	}