@stratal/inertia 0.0.23 → 0.0.25

package/README.md

@@ -16,7 +16,7 @@ Inertia.js v3 server adapter for [Stratal](https://github.com/strataljs/stratal)
 ## Features
 
 - **InertiaModule** — Drop-in Stratal module with `forRoot()` / `forRootAsync()` configuration
-- **Server-Side Rendering** — SSR support with configurable per-route disabling
+- **Streaming SSR** — React 19 `renderToReadableStream` streaming via `createInertiaSsrApp`, with configurable per-route disabling
 - **Shared Data** — Global shared props with static values or request-scoped resolvers
 - **@InertiaRoute Decorator** — Convention-based Inertia page routes with auto-applied response schema
 - **Partial Reloads** — Optional, deferred, and merge props for efficient data loading
@@ -82,6 +82,38 @@ export class NotesController {
 }
 ```
 
+### Streaming SSR
+
+Enable SSR by pointing the module at a bundle that exports a streaming `render`:
+
+```typescript
+InertiaModule.forRoot({
+  rootView: 'app',
+  ssr: { bundle: () => import('./inertia/ssr') },
+})
+```
+
+`src/inertia/ssr.tsx` (scaffolded by `quarry inertia:install`) uses
+`createInertiaSsrApp`, which wires Inertia's `App`, head collection, and React 19's
+`renderToReadableStream` — the shell flushes early and the body streams progressively:
+
+```tsx
+import { createInertiaSsrApp } from '@stratal/inertia/ssr'
+
+export const { render } = createInertiaSsrApp({
+  resolve: async (name) => {
+    const pages = import.meta.glob('./pages/**/*.tsx')
+    const page = await pages[`./pages/${name}.tsx`]?.()
+    if (!page) throw new Error(`Page not found: ${name}`)
+    return page
+  },
+})
+```
+
+There is no client-side fallback — an SSR failure surfaces as an error rather than
+silently degrading. Skip SSR per route with `ctx.withoutSsr()` or globally with
+`ssr.disabled: ['admin/*']`.
+
 ## Documentation
 
 Full guides and examples are available at **[stratal.dev](https://stratal.dev)**.

package/dist/index.d.mts

@@ -1,13 +1,13 @@
 /// <reference path="../global.d.ts" />
-import { C as SeoMetaTag, E as SeoTwitter, S as SeoLinkTag, T as SeoTagDescriptor, _ as ResolvedInertiaPageProps, a as InertiaMergeProp, b as ViteManifestEntry, c as InertiaOptionalProp, d as InertiaPageRegistry, f as InertiaRenderOptions, g as InertiaTranslationKeys, h as InertiaSsrResult, i as InertiaI18nConfig, l as InertiaPage, m as InertiaSsrBundle, n as InertiaDeferredProp, o as InertiaMergeStrategy, p as InertiaSharedProps, r as InertiaFullPageProps, s as InertiaOnceProp, t as InertiaAlwaysProp, u as InertiaPageComponent, v as SharedDataResolver, w as SeoOpenGraph, x as SeoData, y as ViteManifest } from "./types--_iJ04lT.mjs";
+import { a as SeoTagDescriptor, i as SeoOpenGraph, n as SeoLinkTag, o as SeoTwitter, r as SeoMetaTag, t as SeoData } from "./types-DzE1pdZs.mjs";
+import { _ as ResolvedInertiaPageProps, a as InertiaMergeProp, b as ViteManifestEntry, c as InertiaOptionalProp, d as InertiaPageRegistry, f as InertiaRenderOptions, g as InertiaTranslationKeys, h as InertiaSsrResult, i as InertiaI18nConfig, l as InertiaPage, m as InertiaSsrBundle, n as InertiaDeferredProp, o as InertiaMergeStrategy, p as InertiaSharedProps, r as InertiaFullPageProps, s as InertiaOnceProp, t as InertiaAlwaysProp, u as InertiaPageComponent, v as SharedDataResolver, y as ViteManifest } from "./types-BhgXhWx6.mjs";
 import { ExceptionHandler } from "stratal/errors";
 import { AsyncModuleOptions, DynamicModule, OnException, OnInitialize } from "stratal/module";
 import { Middleware, Next, RouteConfig, RouteConfigurable, Router, RouterContext } from "stratal/router";
 import { Container } from "stratal/di";
 import { MessageKeyPrefix } from "stratal/i18n";
-import { LoggerService } from "stratal/logger";
 import { z } from "stratal/validation";
-import { InertiaAppSSRResponse, Page } from "@inertiajs/core";
+import { Page } from "@inertiajs/core";
 import { CookieOptions } from "hono/utils/cookie";
 
 //#region src/flash/flash-store.d.ts
@@ -18,12 +18,9 @@ interface FlashStore {
 }
 //#endregion
 //#region src/inertia.options.d.ts
-interface SsrBundleModule {
-  render(page: Page): Promise<InertiaAppSSRResponse>;
-}
 interface InertiaSsrOptions {
-  bundle: () => Promise<SsrBundleModule | {
-    default: SsrBundleModule;
+  bundle: () => Promise<InertiaSsrBundle | {
+    default: InertiaSsrBundle;
   }>;
   /**
    * Route patterns where SSR is disabled (e.g., `"admin/*"`).
@@ -353,11 +350,17 @@ declare class SeoService {
 //#region src/services/ssr-renderer.service.d.ts
 declare class SsrRendererService {
   private readonly options;
-  private readonly logger;
   private bundle;
   private loadPromise;
-  constructor(options: InertiaModuleOptions, logger: LoggerService);
-  render(page: Page): Promise<InertiaAppSSRResponse>;
+  constructor(options: InertiaModuleOptions);
+  /**
+   * Render a page to a streaming SSR result.
+   *
+   * The SSR bundle is imported once per worker (memoized). Bundle-load and render
+   * errors propagate — there is no silent client-side fallback. Callers must only
+   * invoke this when `options.ssr` is configured.
+   */
+  render(page: Page): Promise<InertiaSsrResult>;
   private ensureBundle;
   private loadBundle;
 }
@@ -367,18 +370,37 @@ declare class ManifestService {
   private readonly manifest;
   private readonly entryClientPath;
   private readonly isDev;
+  private headTags;
+  private scriptTags;
   constructor(options: InertiaModuleOptions);
   getHeadTags(): string;
   getScriptTags(): string;
+  private buildHeadTags;
+  private buildScriptTags;
 }
 //#endregion
 //#region src/services/template.service.d.ts
 declare class TemplateService {
-  private readonly options;
   private readonly manifest;
+  private readonly pre;
+  private readonly post;
   constructor(options: InertiaModuleOptions, manifest: ManifestService);
-  render(page: Page, ssrHead: string[], ssrBody: string): string;
-  private buildClientOnlyBody;
+  /**
+   * Compose the streamed HTML response: the document shell (head + opening
+   * `#app` wrapper) is flushed first, the React stream is piped verbatim, then
+   * the wrapper is closed and the trailing scripts are appended.
+   *
+   * Reproduces Inertia's `buildSSRBody` markup: a `<script data-page>` JSON tag
+   * (parsed before hydration) followed by `<div data-server-rendered id="app">`.
+   */
+  renderStream(page: Page, head: string[], reactStream: ReadableStream<Uint8Array>): ReadableStream<Uint8Array>;
+  /**
+   * Buffered, client-only document used when SSR is disabled for the request.
+   * Emits an empty `#app` div for the client bundle to hydrate.
+   */
+  renderClientOnly(page: Page, head: string[]): string;
+  private fillPlaceholders;
+  private serialize;
 }
 //#endregion
 //#region src/services/inertia.service.d.ts

package/dist/index.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.mts","names":[],"sources":["../src/flash/flash-store.ts","../src/inertia.options.ts","../src/inertia.module.ts","../src/inertia.tokens.ts","../src/seo/build-seo-tags.ts","../src/flash/cookie-flash-store.ts","../src/augment/router-context.ts","../src/services/hreflang.service.ts","../src/services/seo.service.ts","../src/services/ssr-renderer.service.ts","../src/services/manifest.service.ts","../src/services/template.service.ts","../src/services/inertia.service.ts","../src/decorators/inertia.decorators.ts","../src/middleware/handle-precognitive-requests.middleware.ts","../src/middleware/inertia.middleware.ts","../src/augment/router-variables.ts"],"mappings":"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"}
+{"version":3,"file":"index.d.mts","names":[],"sources":["../src/flash/flash-store.ts","../src/inertia.options.ts","../src/inertia.module.ts","../src/inertia.tokens.ts","../src/seo/build-seo-tags.ts","../src/flash/cookie-flash-store.ts","../src/augment/router-context.ts","../src/services/hreflang.service.ts","../src/services/seo.service.ts","../src/services/ssr-renderer.service.ts","../src/services/manifest.service.ts","../src/services/template.service.ts","../src/services/inertia.service.ts","../src/decorators/inertia.decorators.ts","../src/middleware/handle-precognitive-requests.middleware.ts","../src/middleware/inertia.middleware.ts","../src/augment/router-variables.ts"],"mappings":"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"}

package/dist/index.mjs

@@ -5,7 +5,6 @@ import { Module } from "stratal/module";
 import { Delete, Get, Patch, Post, Put, ROUTER_TOKENS, Route, RouterContext, SchemaValidationError, applyTrailingSlash } from "stratal/router";
 import { CONTAINER_TOKEN, DI_TOKENS, Request, Singleton, Transient, inject } from "stratal/di";
 import { I18N_TOKENS } from "stratal/i18n";
-import { LOGGER_TOKENS } from "stratal/logger";
 import { deleteCookie, getSignedCookie, setSignedCookie } from "hono/cookie";
 import { z } from "stratal/validation";
 //#region src/augment/router-context.ts
@@ -238,6 +237,7 @@ let InertiaService = class InertiaService {
 	async render(ctx, component, props = {}, renderOptions = {}) {
 		const reqUrl = new URL(ctx.c.req.url);
 		const url = reqUrl.search ? `${reqUrl.pathname}${reqUrl.search}` : reqUrl.pathname;
+		const pathname = reqUrl.pathname;
 		const isInertia = ctx.c.get("inertia");
 		const { shared: resolvedShared, sharedKeys } = await this.resolveSharedData(ctx);
 		const resolvedSeo = await this.seoService.resolve(ctx);
@@ -287,13 +287,17 @@ let InertiaService = class InertiaService {
 				"Vary": "X-Inertia"
 			}
 		});
-		const ssrResult = ctx.c.get("withoutSsr") || this.isSsrDisabled(url) ? {
-			head: [],
-			body: ""
-		} : await this.ssr.render(page);
 		const seoTags = this.seoService.tagsFor(resolvedSeo);
-		const html = this.template.render(page, [...ssrResult.head, ...seoTags], ssrResult.body);
-		return new Response(html, {
+		if (ctx.c.get("withoutSsr") || this.isSsrDisabled(pathname) || !this.options.ssr) {
+			const html = this.template.renderClientOnly(page, seoTags);
+			return new Response(html, {
+				status,
+				headers: { "Content-Type": "text/html; charset=utf-8" }
+			});
+		}
+		const { head, stream } = await this.ssr.render(page);
+		const body = this.template.renderStream(page, [...head, ...seoTags], stream);
+		return new Response(body, {
 			status,
 			headers: { "Content-Type": "text/html; charset=utf-8" }
 		});
@@ -483,12 +487,20 @@ let ManifestService = class ManifestService {
 	manifest;
 	entryClientPath;
 	isDev = Boolean(import.meta.env.DEV);
+	headTags = null;
+	scriptTags = null;
 	constructor(options) {
 		this.manifest = globalThis.__STRATAL_INERTIA_MANIFEST__ ?? null;
 		this.entryClientPath = (options.entryClientPath ?? DEFAULT_ENTRY_CLIENT_PATH).replace(/^\/+/, "");
 		if (!this.isDev && !this.manifest) throw new Error("@stratal/inertia: production build is missing the Vite client manifest. This is wired by stratalInertia() in vite.config.ts — confirm it is in your plugin list and that the client environment built successfully before the worker environment.");
 	}
 	getHeadTags() {
+		return this.headTags ??= this.buildHeadTags();
+	}
+	getScriptTags() {
+		return this.scriptTags ??= this.buildScriptTags();
+	}
+	buildHeadTags() {
 		if (this.isDev) return "<link rel=\"stylesheet\" href=\"/__inertia/ssr-css\" data-ssr-css />";
 		const tags = [];
 		const seen = /* @__PURE__ */ new Set();
@@ -499,7 +511,7 @@ let ManifestService = class ManifestService {
 		}
 		return tags.join("\n");
 	}
-	getScriptTags() {
+	buildScriptTags() {
 		if (this.isDev) return [
 			"<script type=\"module\" src=\"/@vite/client\"><\/script>",
 			`<script type="module">
@@ -516,7 +528,7 @@ hot.on("vite:afterUpdate", () => {
 		return tags.join("\n");
 	}
 };
-ManifestService = __decorate([Transient(), __decorateParam(0, inject(INERTIA_TOKENS.Options))], ManifestService);
+ManifestService = __decorate([Singleton(), __decorateParam(0, inject(INERTIA_TOKENS.Options))], ManifestService);
 //#endregion
 //#region src/services/seo.service.ts
 let SeoService = class SeoService {
@@ -585,23 +597,21 @@ function mergeSeo(a, b) {
 //#region src/services/ssr-renderer.service.ts
 let SsrRendererService = class SsrRendererService {
 	options;
-	logger;
 	bundle = null;
 	loadPromise = null;
-	constructor(options, logger) {
+	constructor(options) {
 		this.options = options;
-		this.logger = logger;
 	}
+	/**
+	* Render a page to a streaming SSR result.
+	*
+	* The SSR bundle is imported once per worker (memoized). Bundle-load and render
+	* errors propagate — there is no silent client-side fallback. Callers must only
+	* invoke this when `options.ssr` is configured.
+	*/
 	async render(page) {
-		if (!this.options.ssr) return {
-			head: [],
-			body: ""
-		};
+		if (!this.options.ssr) throw new ApplicationError("[stratal:inertia] SSR bundle is not configured.");
 		await this.ensureBundle();
-		if (!this.bundle) return {
-			head: [],
-			body: ""
-		};
 		return this.bundle.render(page);
 	}
 	async ensureBundle() {
@@ -609,52 +619,84 @@ let SsrRendererService = class SsrRendererService {
 		this.loadPromise ??= this.loadBundle();
 		try {
 			await this.loadPromise;
-		} catch {}
-	}
-	async loadBundle() {
-		if (!this.options.ssr) return;
-		try {
-			const mod = await this.options.ssr.bundle();
-			const resolved = "default" in mod ? mod.default : mod;
-			this.bundle = resolved;
 		} catch (error) {
-			this.logger.warn("[stratal:inertia] Failed to load SSR bundle. Falling back to client-side rendering.", { error });
 			this.loadPromise = null;
+			throw error;
 		}
 	}
+	async loadBundle() {
+		const mod = await this.options.ssr.bundle();
+		this.bundle = "default" in mod ? mod.default : mod;
+	}
 };
-SsrRendererService = __decorate([
-	Singleton(),
-	__decorateParam(0, inject(INERTIA_TOKENS.Options)),
-	__decorateParam(1, inject(LOGGER_TOKENS.LoggerService))
-], SsrRendererService);
+SsrRendererService = __decorate([Singleton(), __decorateParam(0, inject(INERTIA_TOKENS.Options))], SsrRendererService);
 //#endregion
 //#region src/services/template.service.ts
+const APP_ID = "app";
 let TemplateService = class TemplateService {
-	options;
 	manifest;
+	pre;
+	post;
 	constructor(options, manifest) {
-		this.options = options;
 		this.manifest = manifest;
+		const match = /@inertia\b/.exec(options.rootView);
+		if (!match) throw new ApplicationError("[stratal:inertia] rootView template is missing the @inertia placeholder.");
+		this.pre = options.rootView.slice(0, match.index);
+		this.post = options.rootView.slice(match.index + 8);
+	}
+	/**
+	* Compose the streamed HTML response: the document shell (head + opening
+	* `#app` wrapper) is flushed first, the React stream is piped verbatim, then
+	* the wrapper is closed and the trailing scripts are appended.
+	*
+	* Reproduces Inertia's `buildSSRBody` markup: a `<script data-page>` JSON tag
+	* (parsed before hydration) followed by `<div data-server-rendered id="app">`.
+	*/
+	renderStream(page, head, reactStream) {
+		const encoder = new TextEncoder();
+		const shellPre = this.fillPlaceholders(this.pre, head) + `<script data-page="${APP_ID}" type="application/json">${this.serialize(page)}<\/script><div data-server-rendered="true" id="${APP_ID}">`;
+		const shellPost = `</div>${this.fillPlaceholders(this.post, head)}`;
+		let reader;
+		return new ReadableStream({
+			async start(controller) {
+				controller.enqueue(encoder.encode(shellPre));
+				reader = reactStream.getReader();
+				try {
+					for (;;) {
+						const { done, value } = await reader.read();
+						if (done) break;
+						controller.enqueue(value);
+					}
+					controller.enqueue(encoder.encode(shellPost));
+					controller.close();
+				} catch (error) {
+					controller.error(error);
+				} finally {
+					reader.releaseLock();
+					reader = void 0;
+				}
+			},
+			cancel(reason) {
+				return reader?.cancel(reason) ?? reactStream.cancel(reason);
+			}
+		});
+	}
+	/**
+	* Buffered, client-only document used when SSR is disabled for the request.
+	* Emits an empty `#app` div for the client bundle to hydrate.
+	*/
+	renderClientOnly(page, head) {
+		return this.fillPlaceholders(this.pre, head) + `<script data-page="${APP_ID}" type="application/json">${this.serialize(page)}<\/script><div id="${APP_ID}"></div>` + this.fillPlaceholders(this.post, head);
 	}
-	render(page, ssrHead, ssrBody) {
-		const appHtml = ssrBody || this.buildClientOnlyBody(page);
-		const headTags = ssrHead.length > 0 ? ssrHead.join("\n") : "";
-		const viteHead = this.manifest.getHeadTags();
-		const viteScripts = this.manifest.getScriptTags();
-		let html = this.options.rootView;
-		html = html.replace("@inertiaHead", () => headTags);
-		html = html.replace("@inertia", () => appHtml);
-		html = html.replace("@viteHead", () => viteHead);
-		html = html.replace("@viteScripts", () => viteScripts);
-		return html;
-	}
-	buildClientOnlyBody(page) {
-		return `<script data-page="app" type="application/json">${JSON.stringify(page).replace(/\//g, "\\/")}<\/script><div id="app"></div>`;
+	fillPlaceholders(segment, head) {
+		return segment.replace("@inertiaHead", () => head.join("\n")).replace("@viteHead", () => this.manifest.getHeadTags()).replace("@viteScripts", () => this.manifest.getScriptTags());
+	}
+	serialize(page) {
+		return JSON.stringify(page).replace(/\//g, "\\/");
 	}
 };
 TemplateService = __decorate([
-	Transient(),
+	Singleton(),
 	__decorateParam(0, inject(INERTIA_TOKENS.Options)),
 	__decorateParam(1, inject(INERTIA_TOKENS.ManifestService))
 ], TemplateService);