@c9up/aurora 0.1.17 → 0.1.19

package/dist/AuroraManager.d.ts

@@ -22,6 +22,13 @@ export interface AuroraManagerConfig {
      * Override only if you want to serve a custom build.
      */
     auroraDistRoot?: string;
+    /**
+     * Filesystem path to `@c9up/comet`'s `dist/`. Defaults to the dist of the
+     * installed (optional-peer) `@c9up/comet` — resolved automatically so the
+     * RPC client's `import '@c9up/comet'` works in the no-bundler browser with
+     * zero app wiring. Left unserved when comet isn't installed (no RPC).
+     */
+    cometDistRoot?: string;
     /**
      * URL prefix the asset routes mount under. The aurora runtime is served
      * from `<assetsPrefix>/aurora/*` and the app's pages from
@@ -41,6 +48,10 @@ export declare class AuroraManager {
     readonly auroraAssetPath: string;
     /** Mount path for the app's pages — `<assetsPrefix>/pages`. */
     readonly pageAssetPath: string;
+    /** Mount path for the RPC client's `@c9up/comet` runtime — `<assetsPrefix>/comet`. */
+    readonly cometAssetPath: string;
+    /** Resolved `@c9up/comet` dist dir, or `null` when comet isn't installed. */
+    readonly cometDistRoot: string | null;
     constructor(config: AuroraManagerConfig);
     /**
      * SSR + hydrate + ship the document. The importmap default points
@@ -59,4 +70,10 @@ export declare class AuroraManager {
      * `GET /_assets/pages/*`.
      */
     pageAssetsHandler(): (ctx: AssetsHttpContext) => Promise<void>;
+    /**
+     * Handler for `@c9up/comet`'s runtime (the RPC client). Mount on
+     * `GET <cometAssetPath>/*`. Returns `null` when comet isn't installed —
+     * the provider then skips the route (no RPC, nothing to serve).
+     */
+    cometAssetsHandler(): ((ctx: AssetsHttpContext) => Promise<void>) | null;
 }

package/dist/AuroraManager.js

@@ -15,8 +15,21 @@ import { dirname, resolve as resolvePath } from "node:path";
 import { fileURLToPath } from "node:url";
 import { Pages } from "./Pages.js";
 import { renderPage, } from "./server/renderPage.js";
-import { serveAssets } from "./server/serveAssets.js";
+import { packageAssetDir, serveAssets, } from "./server/serveAssets.js";
 const DEFAULT_AURORA_DIST = resolvePath(dirname(fileURLToPath(import.meta.url)), "../dist");
+/**
+ * Resolve `@c9up/comet`'s dist dir, or `null` when it isn't installed. comet is
+ * aurora's OPTIONAL peer (only present when the app uses RPC), so a missing one
+ * is expected — aurora then simply doesn't serve it or add it to the importmap.
+ */
+function resolveCometDist() {
+    try {
+        return packageAssetDir("@c9up/comet");
+    }
+    catch {
+        return null;
+    }
+}
 /** Normalize an asset prefix: ensure a leading slash, drop trailing slashes. */
 function normalizePrefix(prefix) {
     const withLead = prefix.startsWith("/") ? prefix : `/${prefix}`;
@@ -31,10 +44,16 @@ export class AuroraManager {
     auroraAssetPath;
     /** Mount path for the app's pages — `<assetsPrefix>/pages`. */
     pageAssetPath;
+    /** Mount path for the RPC client's `@c9up/comet` runtime — `<assetsPrefix>/comet`. */
+    cometAssetPath;
+    /** Resolved `@c9up/comet` dist dir, or `null` when comet isn't installed. */
+    cometDistRoot;
     constructor(config) {
         this.assetsPrefix = normalizePrefix(config.assetsPrefix ?? "/_assets");
         this.auroraAssetPath = `${this.assetsPrefix}/aurora`;
         this.pageAssetPath = `${this.assetsPrefix}/pages`;
+        this.cometAssetPath = `${this.assetsPrefix}/comet`;
+        this.cometDistRoot = config.cometDistRoot ?? resolveCometDist();
         // Pages serve their compiled JS from the same prefix unless the app
         // pins an explicit urlPrefix.
         this.pages = new Pages({
@@ -54,6 +73,17 @@ export class AuroraManager {
             ...options,
             importmap: {
                 "@c9up/aurora": `${this.auroraAssetPath}/index.js`,
+                // The browser-facing subpath (RPC client) needs an explicit entry —
+                // importmaps don't read package `exports`, and an extensionless bare
+                // specifier won't hit a trailing-slash prefix map. Served from the
+                // same aurora dist; harmless when a page never imports it.
+                "@c9up/aurora/rpc": `${this.auroraAssetPath}/rpc.js`,
+                // Auto-map @c9up/comet when installed so the rpc client's bare
+                // `import '@c9up/comet'` resolves in the no-bundler browser — no
+                // app-side importmap wiring. Omitted when comet isn't present.
+                ...(this.cometDistRoot
+                    ? { "@c9up/comet": `${this.cometAssetPath}/index.js` }
+                    : {}),
                 ...options?.importmap,
             },
         });
@@ -72,4 +102,14 @@ export class AuroraManager {
     pageAssetsHandler() {
         return serveAssets({ root: this.pages.root });
     }
+    /**
+     * Handler for `@c9up/comet`'s runtime (the RPC client). Mount on
+     * `GET <cometAssetPath>/*`. Returns `null` when comet isn't installed —
+     * the provider then skips the route (no RPC, nothing to serve).
+     */
+    cometAssetsHandler() {
+        return this.cometDistRoot
+            ? serveAssets({ root: this.cometDistRoot })
+            : null;
+    }
 }

package/dist/AuroraProvider.js

@@ -67,6 +67,13 @@ export default class AuroraProvider {
         // `/_assets`) — set `config.aurora.assetsPrefix` to change the scheme.
         router.get(`${manager.auroraAssetPath}/*`, adaptHandler(manager.auroraAssetsHandler()));
         router.get(`${manager.pageAssetPath}/*`, adaptHandler(manager.pageAssetsHandler()));
+        // Serve @c9up/comet's runtime so the RPC client's bare `import
+        // '@c9up/comet'` resolves in the browser. Skipped when comet isn't
+        // installed (optional peer — the app doesn't use RPC).
+        const cometHandler = manager.cometAssetsHandler();
+        if (cometHandler) {
+            router.get(`${manager.cometAssetPath}/*`, adaptHandler(cometHandler));
+        }
     }
     async ready() { }
     async shutdown() { }

package/dist/server/serveAssets.d.ts

@@ -9,6 +9,17 @@
  * and writes to `ctx.response`. Any context that satisfies
  * `AssetsHttpContext` (Ream, AdonisJS, anything duck-typed) works.
  */
+/**
+ * Absolute dist directory of an installed package — for mounting its pre-built
+ * ESM as browser assets (`serveAssets({ root: packageAssetDir('@c9up/x') })`).
+ *
+ * Uses `import.meta.resolve`, which honours the package's `exports` `import`
+ * condition — so it works for `@c9up/*` import-only packages where
+ * `createRequire().resolve()` throws `ERR_PACKAGE_PATH_NOT_EXPORTED` (their
+ * `exports` carry no `require` condition, and `main` is ignored once `exports`
+ * exists). Throws if the package isn't installed/resolvable.
+ */
+export declare function packageAssetDir(specifier: string): string;
 export interface AssetsRequest {
     /**
      * Read the wildcard `*` segment of the matched route. Most routers

package/dist/server/serveAssets.js

@@ -10,7 +10,21 @@
  * `AssetsHttpContext` (Ream, AdonisJS, anything duck-typed) works.
  */
 import { readFile, realpath } from "node:fs/promises";
-import { extname, join, resolve as resolvePath, sep } from "node:path";
+import { dirname, extname, join, resolve as resolvePath, sep } from "node:path";
+import { fileURLToPath } from "node:url";
+/**
+ * Absolute dist directory of an installed package — for mounting its pre-built
+ * ESM as browser assets (`serveAssets({ root: packageAssetDir('@c9up/x') })`).
+ *
+ * Uses `import.meta.resolve`, which honours the package's `exports` `import`
+ * condition — so it works for `@c9up/*` import-only packages where
+ * `createRequire().resolve()` throws `ERR_PACKAGE_PATH_NOT_EXPORTED` (their
+ * `exports` carry no `require` condition, and `main` is ignored once `exports`
+ * exists). Throws if the package isn't installed/resolvable.
+ */
+export function packageAssetDir(specifier) {
+    return dirname(fileURLToPath(import.meta.resolve(specifier)));
+}
 const CONTENT_TYPES = {
     ".js": "text/javascript; charset=utf-8",
     ".mjs": "text/javascript; charset=utf-8",

package/dist/server.d.ts

@@ -1,4 +1,4 @@
 export { AuroraManager, type AuroraManagerConfig } from "./AuroraManager.js";
 export { type PageFactory, Pages, type PagesConfig } from "./Pages.js";
 export { type RenderHttpContext, type RenderPageOptions, type RenderResponse, renderPage, } from "./server/renderPage.js";
-export { type AssetsHttpContext, type AssetsRequest, type AssetsResponse, type ServeAssetsOptions, serveAssets, } from "./server/serveAssets.js";
+export { type AssetsHttpContext, type AssetsRequest, type AssetsResponse, packageAssetDir, type ServeAssetsOptions, serveAssets, } from "./server/serveAssets.js";

package/dist/server.js

@@ -7,4 +7,4 @@
 export { AuroraManager } from "./AuroraManager.js";
 export { Pages } from "./Pages.js";
 export { renderPage, } from "./server/renderPage.js";
-export { serveAssets, } from "./server/serveAssets.js";
+export { packageAssetDir, serveAssets, } from "./server/serveAssets.js";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@c9up/aurora",
-  "version": "0.1.17",
+  "version": "0.1.19",
   "description": "Aurora — reactive UI runtime for the Ream framework. Tagged-template DOM, signal-based state, isomorphic SSR + hydration, zero build step.",
   "license": "MIT",
   "type": "module",

package/src/AuroraManager.ts

@@ -20,7 +20,11 @@ import {
 	type RenderPageOptions,
 	renderPage,
 } from "./server/renderPage.js";
-import { type AssetsHttpContext, serveAssets } from "./server/serveAssets.js";
+import {
+	type AssetsHttpContext,
+	packageAssetDir,
+	serveAssets,
+} from "./server/serveAssets.js";
 
 export interface AuroraManagerConfig {
 	pages: PagesConfig;
@@ -30,6 +34,13 @@ export interface AuroraManagerConfig {
 	 * Override only if you want to serve a custom build.
 	 */
 	auroraDistRoot?: string;
+	/**
+	 * Filesystem path to `@c9up/comet`'s `dist/`. Defaults to the dist of the
+	 * installed (optional-peer) `@c9up/comet` — resolved automatically so the
+	 * RPC client's `import '@c9up/comet'` works in the no-bundler browser with
+	 * zero app wiring. Left unserved when comet isn't installed (no RPC).
+	 */
+	cometDistRoot?: string;
 	/**
 	 * URL prefix the asset routes mount under. The aurora runtime is served
 	 * from `<assetsPrefix>/aurora/*` and the app's pages from
@@ -46,6 +57,19 @@ const DEFAULT_AURORA_DIST = resolvePath(
 	"../dist",
 );
 
+/**
+ * Resolve `@c9up/comet`'s dist dir, or `null` when it isn't installed. comet is
+ * aurora's OPTIONAL peer (only present when the app uses RPC), so a missing one
+ * is expected — aurora then simply doesn't serve it or add it to the importmap.
+ */
+function resolveCometDist(): string | null {
+	try {
+		return packageAssetDir("@c9up/comet");
+	} catch {
+		return null;
+	}
+}
+
 /** Normalize an asset prefix: ensure a leading slash, drop trailing slashes. */
 function normalizePrefix(prefix: string): string {
 	const withLead = prefix.startsWith("/") ? prefix : `/${prefix}`;
@@ -61,11 +85,17 @@ export class AuroraManager {
 	readonly auroraAssetPath: string;
 	/** Mount path for the app's pages — `<assetsPrefix>/pages`. */
 	readonly pageAssetPath: string;
+	/** Mount path for the RPC client's `@c9up/comet` runtime — `<assetsPrefix>/comet`. */
+	readonly cometAssetPath: string;
+	/** Resolved `@c9up/comet` dist dir, or `null` when comet isn't installed. */
+	readonly cometDistRoot: string | null;
 
 	constructor(config: AuroraManagerConfig) {
 		this.assetsPrefix = normalizePrefix(config.assetsPrefix ?? "/_assets");
 		this.auroraAssetPath = `${this.assetsPrefix}/aurora`;
 		this.pageAssetPath = `${this.assetsPrefix}/pages`;
+		this.cometAssetPath = `${this.assetsPrefix}/comet`;
+		this.cometDistRoot = config.cometDistRoot ?? resolveCometDist();
 		// Pages serve their compiled JS from the same prefix unless the app
 		// pins an explicit urlPrefix.
 		this.pages = new Pages({
@@ -91,6 +121,17 @@ export class AuroraManager {
 			...options,
 			importmap: {
 				"@c9up/aurora": `${this.auroraAssetPath}/index.js`,
+				// The browser-facing subpath (RPC client) needs an explicit entry —
+				// importmaps don't read package `exports`, and an extensionless bare
+				// specifier won't hit a trailing-slash prefix map. Served from the
+				// same aurora dist; harmless when a page never imports it.
+				"@c9up/aurora/rpc": `${this.auroraAssetPath}/rpc.js`,
+				// Auto-map @c9up/comet when installed so the rpc client's bare
+				// `import '@c9up/comet'` resolves in the no-bundler browser — no
+				// app-side importmap wiring. Omitted when comet isn't present.
+				...(this.cometDistRoot
+					? { "@c9up/comet": `${this.cometAssetPath}/index.js` }
+					: {}),
 				...options?.importmap,
 			},
 		});
@@ -111,4 +152,15 @@ export class AuroraManager {
 	pageAssetsHandler(): (ctx: AssetsHttpContext) => Promise<void> {
 		return serveAssets({ root: this.pages.root });
 	}
+
+	/**
+	 * Handler for `@c9up/comet`'s runtime (the RPC client). Mount on
+	 * `GET <cometAssetPath>/*`. Returns `null` when comet isn't installed —
+	 * the provider then skips the route (no RPC, nothing to serve).
+	 */
+	cometAssetsHandler(): ((ctx: AssetsHttpContext) => Promise<void>) | null {
+		return this.cometDistRoot
+			? serveAssets({ root: this.cometDistRoot })
+			: null;
+	}
 }

package/src/AuroraProvider.ts

@@ -101,6 +101,13 @@ export default class AuroraProvider {
 			`${manager.pageAssetPath}/*`,
 			adaptHandler(manager.pageAssetsHandler()),
 		);
+		// Serve @c9up/comet's runtime so the RPC client's bare `import
+		// '@c9up/comet'` resolves in the browser. Skipped when comet isn't
+		// installed (optional peer — the app doesn't use RPC).
+		const cometHandler = manager.cometAssetsHandler();
+		if (cometHandler) {
+			router.get(`${manager.cometAssetPath}/*`, adaptHandler(cometHandler));
+		}
 	}
 
 	async ready(): Promise<void> {}

package/src/server/serveAssets.ts

@@ -11,7 +11,22 @@
  */
 
 import { readFile, realpath } from "node:fs/promises";
-import { extname, join, resolve as resolvePath, sep } from "node:path";
+import { dirname, extname, join, resolve as resolvePath, sep } from "node:path";
+import { fileURLToPath } from "node:url";
+
+/**
+ * Absolute dist directory of an installed package — for mounting its pre-built
+ * ESM as browser assets (`serveAssets({ root: packageAssetDir('@c9up/x') })`).
+ *
+ * Uses `import.meta.resolve`, which honours the package's `exports` `import`
+ * condition — so it works for `@c9up/*` import-only packages where
+ * `createRequire().resolve()` throws `ERR_PACKAGE_PATH_NOT_EXPORTED` (their
+ * `exports` carry no `require` condition, and `main` is ignored once `exports`
+ * exists). Throws if the package isn't installed/resolvable.
+ */
+export function packageAssetDir(specifier: string): string {
+	return dirname(fileURLToPath(import.meta.resolve(specifier)));
+}
 
 const CONTENT_TYPES: Record<string, string> = {
 	".js": "text/javascript; charset=utf-8",

package/src/server.ts

@@ -17,6 +17,7 @@ export {
 	type AssetsHttpContext,
 	type AssetsRequest,
 	type AssetsResponse,
+	packageAssetDir,
 	type ServeAssetsOptions,
 	serveAssets,
 } from "./server/serveAssets.js";