@zerotal/inertia 1.13.0 → 1.13.2

package/CHANGELOG.md

@@ -8,6 +8,21 @@ follows the Zerotal monorepo's unified versioning.
 
 ## [Unreleased]
 
+## [1.13.2] — 2026-08-31
+
+### Fixed
+
+- **`Inertia.stream()` honours `X-Inertia`.** It answered every request with
+  `text/html`, including the XHR a running Inertia client sends — so pointing a route at
+  it to get server rendering broke client-side navigation _to_ that route.
+
+  The shape of the failure is why it went unnoticed: the first load looks perfect, which
+  is what a person checks, and the second click does nothing. It fails for people already
+  in the app, silently, and only after the route works.
+
+  `render` and `stream` now share the branch that writes the page object, rather than one
+  of them having it — which is exactly how they came apart.
+
 ## [1.11.0] — 2026-08-31
 
 ### Added

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zerotal/inertia",
-  "version": "1.13.0",
+  "version": "1.13.2",
   "license": "MIT",
   "maturity": "stable",
   "private": false,
@@ -34,7 +34,7 @@
     "typecheck": "tsc --noEmit"
   },
   "dependencies": {
-    "@zerotal/core": "1.13.0"
+    "@zerotal/core": "1.13.2"
   },
   "peerDependencies": {
     "react": "^18 || ^19",

package/src/inertia.ts

@@ -1,4 +1,5 @@
 import { config, RequestContext } from "@zerotal/core";
+import type { HttpContext } from "@zerotal/core";
 import { assetVersion as coreAssetVersion } from "@zerotal/core/assets";
 import { statSync } from "node:fs";
 import { InertiaTemplateNotLoadedError, InvalidComponentError } from "./errors.ts";
@@ -267,6 +268,15 @@ async function _inertiaStream(component: string, props: Record<string, unknown>)
 
   const pageObject = await buildPageObject(component, props);
 
+  // A running Inertia client asks for a page object, not a document — server
+  // rendering is about the *first* arrival. Answering an `X-Inertia` XHR with HTML
+  // broke client-side navigation to any route that used this: the cold load looked
+  // right and the next click did nothing, silently, for someone already in the app.
+  if (ctx.request.headers.get("X-Inertia") === "true") {
+    _writeInertiaJson(ctx, pageObject);
+    return;
+  }
+
   const [prefix = "", suffix = ""] = _bustAssets(_htmlTemplate).split("<!-- @inertia -->");
 
   const { modPath, framework } = await resolvePageModule(_getPagesDir(), component);
@@ -405,6 +415,30 @@ export const inertia: PageRenderer = Object.assign(
   },
 );
 
+/**
+ * The XHR half of the Inertia protocol: a page object as JSON.
+ *
+ * Shared by {@link inertia} and {@link inertiaStream} rather than written twice,
+ * because having it in only one of them is precisely the bug this exists to close.
+ * `stream` used to answer every request with `text/html` — the first load looked
+ * perfect, which is what a person checks, and the *second* click did nothing,
+ * because the running client got a document where it expected a page object.
+ *
+ * `Vary: X-Inertia` is critical: without it a browser caches the JSON as the HTML
+ * for the same URL and shows a raw page object on Back or Refresh.
+ *
+ * @internal
+ */
+function _writeInertiaJson(ctx: HttpContext, pageObject: unknown): void {
+  ctx.response = new Response(JSON.stringify(pageObject), {
+    headers: {
+      "Content-Type": "application/json",
+      "X-Inertia": "true",
+      Vary: "X-Inertia",
+    },
+  });
+}
+
 async function _inertia(component: string, props: Record<string, unknown>): Promise<void> {
   const ctx = RequestContext.get();
   const isInertiaRequest = ctx.request.headers.get("X-Inertia") === "true";
@@ -412,16 +446,7 @@ async function _inertia(component: string, props: Record<string, unknown>): Prom
   const pageObject = await buildPageObject(component, props);
 
   if (isInertiaRequest) {
-    // Subsequent XHR navigation — JSON only
-    // Vary: X-Inertia is CRITICAL — prevents browser from caching
-    // JSON as HTML, which would show raw JSON on browser Back/Refresh
-    ctx.response = new Response(JSON.stringify(pageObject), {
-      headers: {
-        "Content-Type": "application/json",
-        "X-Inertia": "true",
-        Vary: "X-Inertia",
-      },
-    });
+    _writeInertiaJson(ctx, pageObject);
     return;
   }