@nifrajs/web 2.3.0 → 2.4.0

package/dist/dev-diagnostics.d.ts

@@ -0,0 +1,20 @@
+export interface DevDiagnostics {
+    /** True when a request path targets the structured last-error endpoint. */
+    isLastErrorPath(pathname: string): boolean;
+    /** The JSON body + headers for the last-error endpoint: the most recent failure, or a benign
+     * `NIFRA_NONE` shape when nothing has failed yet. `no-store` so a stale failure is never cached. */
+    lastError(): {
+        readonly body: string;
+        readonly headers: Readonly<Record<string, string>>;
+    };
+    /** Capture a thrown SSR failure: store it for the endpoint and return the overlay HTML. The overlay a
+     * person sees and the JSON an agent reads come from this one Diagnostic, so they can never disagree. */
+    capture(err: unknown, request: {
+        readonly method: string;
+        readonly url: string;
+    }): string;
+}
+/** One diagnostics surface per dev server. `root` is the resolved project root; it scopes the codeframe
+ * to the project (see buildDiagnostic). Both dev servers resolve a concrete root before calling this. */
+export declare function createDevDiagnostics(root: string): DevDiagnostics;
+//# sourceMappingURL=dev-diagnostics.d.ts.map

package/dist/dev-diagnostics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dev-diagnostics.d.ts","sourceRoot":"","sources":["../src/dev-diagnostics.ts"],"names":[],"mappings":"AAaA,MAAM,WAAW,cAAc;IAC7B,2EAA2E;IAC3E,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAA;IAC1C;wGACoG;IACpG,SAAS,IAAI;QAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,OAAO,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAA;KAAE,CAAA;IAC1F;4GACwG;IACxG,OAAO,CAAC,GAAG,EAAE,OAAO,EAAE,OAAO,EAAE;QAAE,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAA;KAAE,GAAG,MAAM,CAAA;CAC1F;AAED;yGACyG;AACzG,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG,cAAc,CAoBjE"}

package/dist/dev-diagnostics.js

@@ -0,0 +1,34 @@
+/**
+ * The dev server's diagnostics surface, shared by both dev-server adapters - Bun in `dev.ts`, Vite in
+ * `vite.ts`. It owns the one contract that must never drift between them: capture the most recent SSR
+ * failure, serve it as JSON at `LAST_ERROR_PATH` with the identity + no-store headers an agent relies on,
+ * and render that same failure as the developer overlay. Each adapter keeps only its bundler-specific
+ * transport (Bun.serve + HMR vs Vite middlewares + `ssrFixStacktrace`); the diagnostic behaviour lives
+ * here once, so a new header or a new capture rule is a single edit both servers pick up.
+ *
+ * Vite once shipped without the `/__nifra/last-error` endpoint at all - the drift this module prevents.
+ */
+import { renderDiagnosticOverlay } from "./dev-error.js";
+import { buildDiagnostic, LAST_ERROR_PATH } from "./diagnostic.js";
+/** One diagnostics surface per dev server. `root` is the resolved project root; it scopes the codeframe
+ * to the project (see buildDiagnostic). Both dev servers resolve a concrete root before calling this. */
+export function createDevDiagnostics(root) {
+    let last;
+    return {
+        isLastErrorPath: (pathname) => pathname === LAST_ERROR_PATH,
+        lastError: () => ({
+            body: JSON.stringify(last ?? { code: "NIFRA_NONE", message: "No error captured since the dev server started." }),
+            headers: {
+                "content-type": "application/json; charset=utf-8",
+                "cache-control": "no-store",
+                "x-content-type-options": "nosniff",
+                "x-nifra-diagnostic": "true",
+            },
+        }),
+        capture: (err, request) => {
+            last = buildDiagnostic(err, { root, request });
+            return renderDiagnosticOverlay(last);
+        },
+    };
+}
+//# sourceMappingURL=dev-diagnostics.js.map

package/dist/dev-diagnostics.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dev-diagnostics.js","sourceRoot":"","sources":["../src/dev-diagnostics.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,OAAO,EAAE,uBAAuB,EAAE,MAAM,gBAAgB,CAAA;AACxD,OAAO,EAAE,eAAe,EAAmB,eAAe,EAAE,MAAM,iBAAiB,CAAA;AAanF;yGACyG;AACzG,MAAM,UAAU,oBAAoB,CAAC,IAAY;IAC/C,IAAI,IAA4B,CAAA;IAChC,OAAO;QACL,eAAe,EAAE,CAAC,QAAQ,EAAE,EAAE,CAAC,QAAQ,KAAK,eAAe;QAC3D,SAAS,EAAE,GAAG,EAAE,CAAC,CAAC;YAChB,IAAI,EAAE,IAAI,CAAC,SAAS,CAClB,IAAI,IAAI,EAAE,IAAI,EAAE,YAAY,EAAE,OAAO,EAAE,iDAAiD,EAAE,CAC3F;YACD,OAAO,EAAE;gBACP,cAAc,EAAE,iCAAiC;gBACjD,eAAe,EAAE,UAAU;gBAC3B,wBAAwB,EAAE,SAAS;gBACnC,oBAAoB,EAAE,MAAM;aAC7B;SACF,CAAC;QACF,OAAO,EAAE,CAAC,GAAG,EAAE,OAAO,EAAE,EAAE;YACxB,IAAI,GAAG,eAAe,CAAC,GAAG,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,CAAA;YAC9C,OAAO,uBAAuB,CAAC,IAAI,CAAC,CAAA;QACtC,CAAC;KACF,CAAA;AACH,CAAC"}

package/dist/dev-error.d.ts

@@ -1,17 +1,14 @@
 /**
  * Dev-only error overlay. When a loader/action/render throws during `@nifrajs/web/vite` dev, this
- * renders a readable full-page overlay - the message, the source-mapped stack (Vite's
- * `ssrFixStacktrace` runs first), and the request line - instead of the bare `err.stack` text dump.
- * Dev-only by construction: it's called solely from the Vite middleware's catch, never in
- * production (production maps errors to the `_error` route boundary).
+ * renders a readable full-page overlay from a structured [Diagnostic] - the code, the message, a source
+ * codeframe around the offending line, the recognised cause/fix when nifra has one, and the stack -
+ * instead of a bare `err.stack` text dump. Dev-only by construction: it's called solely from the dev
+ * server's catch, never in production (production maps errors to the `_error` route boundary).
+ *
+ * The overlay and the agent surfaces (`/__nifra/last-error`, `nifra_explain`) render from the SAME
+ * `Diagnostic`, so a person and an agent see the identical failure, one as HTML and one as JSON.
  */
-/**
- * Render the dev error overlay HTML. `req` (method + url) is shown for context. The page is
- * self-contained (inline CSS), dark, and labels itself a dev overlay so it's never mistaken for a
- * production error page.
- */
-export declare function renderDevErrorOverlay(err: unknown, req: {
-    method: string;
-    url: string;
-}): string;
+import type { Diagnostic } from "./diagnostic.js";
+/** Render the overlay HTML from a prebuilt Diagnostic (the same object the agent surfaces serve). */
+export declare function renderDiagnosticOverlay(diagnostic: Diagnostic): string;
 //# sourceMappingURL=dev-error.d.ts.map

package/dist/dev-error.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"dev-error.d.ts","sourceRoot":"","sources":["../src/dev-error.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAkBH;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,OAAO,EAAE,GAAG,EAAE;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,GAAG,MAAM,CAgChG"}
+{"version":3,"file":"dev-error.d.ts","sourceRoot":"","sources":["../src/dev-error.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAA;AA+BjD,qGAAqG;AACrG,wBAAgB,uBAAuB,CAAC,UAAU,EAAE,UAAU,GAAG,MAAM,CAkDtE"}

package/dist/dev-error.js

@@ -1,35 +1,34 @@
-/**
- * Dev-only error overlay. When a loader/action/render throws during `@nifrajs/web/vite` dev, this
- * renders a readable full-page overlay - the message, the source-mapped stack (Vite's
- * `ssrFixStacktrace` runs first), and the request line - instead of the bare `err.stack` text dump.
- * Dev-only by construction: it's called solely from the Vite middleware's catch, never in
- * production (production maps errors to the `_error` route boundary).
- */
 const esc = (s) => s.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;").replace(/"/g, "&quot;");
-/** Split a stack into the message (first line) + the frame lines, for separate styling. */
-function parseStack(err) {
-    const stack = err.stack ?? `${err.name}: ${err.message}`;
-    const lines = stack.split("\n");
-    // The message can span multiple leading lines (some errors do); frames start at the first "    at ".
-    const firstFrame = lines.findIndex((l) => /^\s*at\s/.test(l));
-    if (firstFrame === -1)
-        return { message: stack, frames: [] };
-    return {
-        message: lines.slice(0, firstFrame).join("\n").trim(),
-        frames: lines.slice(firstFrame).map((l) => l.trim()),
-    };
+/** The source codeframe block: numbered lines with the offending one highlighted. */
+function codeframeHtml(diagnostic) {
+    const cf = diagnostic.codeframe;
+    if (cf === undefined)
+        return "";
+    const loc = `${esc(cf.file)}:${cf.line}${cf.column !== undefined ? `:${cf.column}` : ""}`;
+    const rows = cf.lines
+        .map((l) => `<div class="cf-row${l.caret ? " caret" : ""}"><span class="cf-ln">${l.number}</span><span class="cf-src">${esc(l.text) || " "}</span></div>`)
+        .join("");
+    return `<h1>Source</h1><div class="cf-loc">${loc}</div><div class="codeframe">${rows}</div>`;
 }
-/**
- * Render the dev error overlay HTML. `req` (method + url) is shown for context. The page is
- * self-contained (inline CSS), dark, and labels itself a dev overlay so it's never mistaken for a
- * production error page.
- */
-export function renderDevErrorOverlay(err, req) {
-    const error = err instanceof Error ? err : new Error(String(err));
-    const { message, frames } = parseStack(error);
-    const name = esc(error.name || "Error");
-    const framesHtml = frames.length > 0
-        ? `<ol class="frames">${frames.map((f) => `<li>${esc(f)}</li>`).join("")}</ol>`
+/** The recognised-failure callout: cause + fix + docs anchor, shown only when nifra classified the error. */
+function fixHtml(diagnostic) {
+    if (diagnostic.fix === undefined)
+        return "";
+    const anchor = diagnostic.docsAnchor !== undefined
+        ? `<div class="fix-docs">docs: <code>${esc(diagnostic.docsAnchor)}</code></div>`
+        : "";
+    const cause = diagnostic.cause !== undefined ? `<p class="fix-cause">${esc(diagnostic.cause)}</p>` : "";
+    return `<div class="fix"><div class="fix-tag">likely fix</div>${cause}<p class="fix-do">${esc(diagnostic.fix)}</p>${anchor}</div>`;
+}
+/** Render the overlay HTML from a prebuilt Diagnostic (the same object the agent surfaces serve). */
+export function renderDiagnosticOverlay(diagnostic) {
+    const name = esc(diagnostic.name || "Error");
+    const code = esc(diagnostic.code);
+    const reqLine = diagnostic.request !== undefined
+        ? `<span class="req">${esc(diagnostic.request.method)} ${esc(diagnostic.request.url)}</span>`
+        : "";
+    const framesHtml = diagnostic.frames.length > 0
+        ? `<ol class="frames">${diagnostic.frames.map((f) => `<li>${esc(f.raw)}</li>`).join("")}</ol>`
         : `<p class="no-frames">No stack frames.</p>`;
     return `<!doctype html><html lang="en"><head><meta charset="utf-8"><title>${name} - nifra dev</title>
 <style>
@@ -37,23 +36,38 @@ export function renderDevErrorOverlay(err, req) {
   body { margin: 0; background: #0b0d10; color: #e6e6e6; font: 14px/1.6 ui-monospace, SFMono-Regular, Menlo, monospace; }
   .bar { background: #2a0e0e; border-bottom: 1px solid #5a1d1d; padding: 10px 20px; font-weight: 700; color: #ff8a8a; display: flex; gap: 12px; align-items: baseline; }
   .bar .tag { font-size: 11px; font-weight: 600; color: #ffb4b4; background: #401616; padding: 2px 8px; border-radius: 99px; letter-spacing: .04em; text-transform: uppercase; }
+  .bar .code { font-size: 11px; font-weight: 600; color: #ffd9a0; background: #3a2a12; padding: 2px 8px; border-radius: 99px; letter-spacing: .04em; }
   .bar .req { margin-left: auto; color: #c98; font-weight: 500; font-size: 12px; }
   main { padding: 24px 28px; max-width: 1000px; }
-  h1 { font-size: 13px; color: #9aa; font-weight: 600; margin: 0 0 6px; text-transform: uppercase; letter-spacing: .05em; }
-  .message { font-size: 18px; color: #ff9b9b; white-space: pre-wrap; margin: 0 0 28px; font-weight: 600; }
+  h1 { font-size: 13px; color: #9aa; font-weight: 600; margin: 24px 0 6px; text-transform: uppercase; letter-spacing: .05em; }
+  h1:first-of-type { margin-top: 0; }
+  .message { font-size: 18px; color: #ff9b9b; white-space: pre-wrap; margin: 0 0 4px; font-weight: 600; }
+  .fix { background: #10241a; border: 1px solid #1f4d38; border-radius: 8px; padding: 12px 16px; margin: 20px 0; }
+  .fix-tag { font-size: 11px; font-weight: 700; color: #7fe0af; text-transform: uppercase; letter-spacing: .05em; margin-bottom: 6px; }
+  .fix-cause { margin: 0 0 8px; color: #b9c9c1; }
+  .fix-do { margin: 0; color: #d6f2e4; }
+  .fix-docs { margin-top: 8px; font-size: 12px; color: #6a8; }
+  .cf-loc { color: #c98; font-size: 12px; margin-bottom: 8px; }
+  .codeframe { background: #0f1319; border: 1px solid #222; border-radius: 8px; overflow: auto; }
+  .cf-row { display: flex; white-space: pre; }
+  .cf-row.caret { background: #2a1414; }
+  .cf-ln { color: #556; text-align: right; width: 48px; padding: 1px 12px 1px 0; user-select: none; flex: none; border-right: 1px solid #222; }
+  .cf-row.caret .cf-ln { color: #ff8a8a; }
+  .cf-src { padding: 1px 0 1px 12px; color: #cdd6e0; }
   .frames { list-style: none; margin: 0; padding: 0; border-left: 2px solid #333; }
   .frames li { padding: 3px 0 3px 16px; color: #9fb0c0; white-space: pre-wrap; word-break: break-all; }
   .frames li:first-child { color: #d6e2ee; }
   .no-frames { color: #778; }
   footer { margin-top: 28px; color: #667; font-size: 12px; }
 </style></head><body>
-<div class="bar"><span class="tag">nifra dev</span><span>${name}</span><span class="req">${esc(req.method)} ${esc(req.url)}</span></div>
+<div class="bar"><span class="tag">nifra dev</span><span class="code">${code}</span><span>${name}</span>${reqLine}</div>
 <main>
-  <h1>Unhandled error during SSR</h1>
-  <p class="message">${esc(message)}</p>
+  <p class="message">${esc(diagnostic.message)}</p>
+  ${fixHtml(diagnostic)}
+  ${codeframeHtml(diagnostic)}
   <h1>Stack</h1>
   ${framesHtml}
-  <footer>This overlay is shown only by the dev server. In production this error maps to your <code>_error</code> route boundary.</footer>
+  <footer>This overlay is shown only by the dev server. Its structured form is at <code>/__nifra/last-error</code> and via <code>nifra_explain</code>. In production this error maps to your <code>_error</code> route boundary.</footer>
 </main></body></html>`;
 }
 //# sourceMappingURL=dev-error.js.map

package/dist/dev-error.js.map

@@ -1 +1 @@
-{"version":3,"file":"dev-error.js","sourceRoot":"","sources":["../src/dev-error.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,MAAM,GAAG,GAAG,CAAC,CAAS,EAAU,EAAE,CAChC,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAA;AAE9F,2FAA2F;AAC3F,SAAS,UAAU,CAAC,GAAU;IAC5B,MAAM,KAAK,GAAG,GAAG,CAAC,KAAK,IAAI,GAAG,GAAG,CAAC,IAAI,KAAK,GAAG,CAAC,OAAO,EAAE,CAAA;IACxD,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,CAAA;IAC/B,qGAAqG;IACrG,MAAM,UAAU,GAAG,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAA;IAC7D,IAAI,UAAU,KAAK,CAAC,CAAC;QAAE,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE,EAAE,CAAA;IAC5D,OAAO;QACL,OAAO,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,UAAU,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE;QACrD,MAAM,EAAE,KAAK,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;KACrD,CAAA;AACH,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,qBAAqB,CAAC,GAAY,EAAE,GAAoC;IACtF,MAAM,KAAK,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAA;IACjE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,UAAU,CAAC,KAAK,CAAC,CAAA;IAC7C,MAAM,IAAI,GAAG,GAAG,CAAC,KAAK,CAAC,IAAI,IAAI,OAAO,CAAC,CAAA;IACvC,MAAM,UAAU,GACd,MAAM,CAAC,MAAM,GAAG,CAAC;QACf,CAAC,CAAC,sBAAsB,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,GAAG,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,OAAO;QAC/E,CAAC,CAAC,2CAA2C,CAAA;IACjD,OAAO,qEAAqE,IAAI;;;;;;;;;;;;;;;;2DAgBvB,IAAI,4BAA4B,GAAG,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC;;;uBAGnG,GAAG,CAAC,OAAO,CAAC;;IAE/B,UAAU;;sBAEQ,CAAA;AACtB,CAAC"}
+{"version":3,"file":"dev-error.js","sourceRoot":"","sources":["../src/dev-error.ts"],"names":[],"mappings":"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"}

package/dist/dev-port.d.ts

@@ -32,5 +32,5 @@ export interface ListenTarget {
  * Without an `error` listener attached, Node throws from deep inside `node:events`, the new process dies
  * in the background, and nothing connects that death to the stale page in front of you.
  */
-export declare function listenOrExplain(server: ListenTarget, port: number): Promise<void>;
+export declare function listenOrExplain(server: ListenTarget, port: number, hostname?: string): Promise<void>;
 //# sourceMappingURL=dev-port.d.ts.map

package/dist/dev-port.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"dev-port.d.ts","sourceRoot":"","sources":["../src/dev-port.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,2FAA2F;AAC3F,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAQrD;AAED,oFAAoF;AACpF,eAAO,MAAM,cAAc,GAAI,KAAK,OAAO,KAAG,OACa,CAAA;AAI3D,mGAAmG;AACnG,eAAO,MAAM,kBAAkB,GAAI,KAAK,OAAO,EAAE,MAAM,MAAM,KAAG,KACQ,CAAA;AAExE,qGAAqG;AACrG,MAAM,WAAW,YAAY;IAC3B,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,IAAI,GAAG,IAAI,CAAA;IAC1C,IAAI,CAAC,KAAK,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC,GAAG,EAAE,OAAO,KAAK,IAAI,GAAG,IAAI,CAAA;IACtD,cAAc,CAAC,KAAK,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC,GAAG,EAAE,OAAO,KAAK,IAAI,GAAG,IAAI,CAAA;CACjE;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,YAAY,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAWjF"}
+{"version":3,"file":"dev-port.d.ts","sourceRoot":"","sources":["../src/dev-port.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,2FAA2F;AAC3F,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAQrD;AAED,oFAAoF;AACpF,eAAO,MAAM,cAAc,GAAI,KAAK,OAAO,KAAG,OACa,CAAA;AAI3D,mGAAmG;AACnG,eAAO,MAAM,kBAAkB,GAAI,KAAK,OAAO,EAAE,MAAM,MAAM,KAAG,KACQ,CAAA;AAExE,qGAAqG;AACrG,MAAM,WAAW,YAAY;IAC3B,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,IAAI,GAAG,IAAI,CAAA;IAC1C,IAAI,CAAC,KAAK,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC,GAAG,EAAE,OAAO,KAAK,IAAI,GAAG,IAAI,CAAA;IACtD,cAAc,CAAC,KAAK,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC,GAAG,EAAE,OAAO,KAAK,IAAI,GAAG,IAAI,CAAA;CACjE;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAC7B,MAAM,EAAE,YAAY,EACpB,IAAI,EAAE,MAAM,EACZ,QAAQ,CAAC,EAAE,MAAM,GAChB,OAAO,CAAC,IAAI,CAAC,CAmBf"}

package/dist/dev-port.js

@@ -33,16 +33,22 @@ export const explainBindFailure = (err, port) => isAddressInUse(err) ? new Error
  * Without an `error` listener attached, Node throws from deep inside `node:events`, the new process dies
  * in the background, and nothing connects that death to the stale page in front of you.
  */
-export function listenOrExplain(server, port) {
+export function listenOrExplain(server, port, hostname) {
     return new Promise((resolve, reject) => {
         const onError = (err) => reject(explainBindFailure(err, port));
         server.once("error", onError);
-        server.listen(port, () => {
+        const onListening = () => {
             // Drop the guard once we're listening: leaving it attached would funnel a LATER server error into
             // an already-settled promise, silently swallowing it instead of surfacing it.
             server.removeListener("error", onError);
             resolve();
-        });
+        };
+        if (hostname === undefined)
+            server.listen(port, onListening);
+        else {
+            ;
+            server.listen(port, hostname, onListening);
+        }
     });
 }
 //# sourceMappingURL=dev-port.js.map

package/dist/dev-port.js.map

@@ -1 +1 @@
-{"version":3,"file":"dev-port.js","sourceRoot":"","sources":["../src/dev-port.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,2FAA2F;AAC3F,MAAM,UAAU,gBAAgB,CAAC,IAAY;IAC3C,OAAO,CACL,wCAAwC,IAAI,uBAAuB;QACnE,mGAAmG;QACnG,yFAAyF;QACzF,8BAA8B,IAAI,iBAAiB;QACnD,sCAAsC,IAAI,GAAG,CAAC,EAAE,CACjD,CAAA;AACH,CAAC;AAED,oFAAoF;AACpF,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,GAAY,EAAW,EAAE,CACrD,GAAiC,EAAE,IAAI,KAAK,YAAY,CAAA;AAE3D,MAAM,OAAO,GAAG,CAAC,GAAY,EAAS,EAAE,CAAC,CAAC,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAA;AAE9F,mGAAmG;AACnG,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,GAAY,EAAE,IAAY,EAAS,EAAE,CACtE,cAAc,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,gBAAgB,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,CAAA;AASxE;;;;;GAKG;AACH,MAAM,UAAU,eAAe,CAAC,MAAoB,EAAE,IAAY;IAChE,OAAO,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QAC3C,MAAM,OAAO,GAAG,CAAC,GAAY,EAAQ,EAAE,CAAC,MAAM,CAAC,kBAAkB,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC,CAAA;QAC7E,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,OAAO,CAAC,CAAA;QAC7B,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,GAAG,EAAE;YACvB,kGAAkG;YAClG,8EAA8E;YAC9E,MAAM,CAAC,cAAc,CAAC,OAAO,EAAE,OAAO,CAAC,CAAA;YACvC,OAAO,EAAE,CAAA;QACX,CAAC,CAAC,CAAA;IACJ,CAAC,CAAC,CAAA;AACJ,CAAC"}
+{"version":3,"file":"dev-port.js","sourceRoot":"","sources":["../src/dev-port.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,2FAA2F;AAC3F,MAAM,UAAU,gBAAgB,CAAC,IAAY;IAC3C,OAAO,CACL,wCAAwC,IAAI,uBAAuB;QACnE,mGAAmG;QACnG,yFAAyF;QACzF,8BAA8B,IAAI,iBAAiB;QACnD,sCAAsC,IAAI,GAAG,CAAC,EAAE,CACjD,CAAA;AACH,CAAC;AAED,oFAAoF;AACpF,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,GAAY,EAAW,EAAE,CACrD,GAAiC,EAAE,IAAI,KAAK,YAAY,CAAA;AAE3D,MAAM,OAAO,GAAG,CAAC,GAAY,EAAS,EAAE,CAAC,CAAC,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAA;AAE9F,mGAAmG;AACnG,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,GAAY,EAAE,IAAY,EAAS,EAAE,CACtE,cAAc,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,gBAAgB,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,CAAA;AASxE;;;;;GAKG;AACH,MAAM,UAAU,eAAe,CAC7B,MAAoB,EACpB,IAAY,EACZ,QAAiB;IAEjB,OAAO,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QAC3C,MAAM,OAAO,GAAG,CAAC,GAAY,EAAQ,EAAE,CAAC,MAAM,CAAC,kBAAkB,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC,CAAA;QAC7E,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,OAAO,CAAC,CAAA;QAC7B,MAAM,WAAW,GAAG,GAAS,EAAE;YAC7B,kGAAkG;YAClG,8EAA8E;YAC9E,MAAM,CAAC,cAAc,CAAC,OAAO,EAAE,OAAO,CAAC,CAAA;YACvC,OAAO,EAAE,CAAA;QACX,CAAC,CAAA;QACD,IAAI,QAAQ,KAAK,SAAS;YAAE,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,WAAW,CAAC,CAAA;aACvD,CAAC;YACJ,CAAC;YACC,MAGD,CAAC,MAAM,CAAC,IAAI,EAAE,QAAQ,EAAE,WAAW,CAAC,CAAA;QACvC,CAAC;IACH,CAAC,CAAC,CAAA;AACJ,CAAC"}

package/dist/dev.d.ts

@@ -1,4 +1,5 @@
 import { type BuildClientOptions } from "./build.js";
+export { LAST_ERROR_PATH } from "./diagnostic.js";
 /** Minimal app surface the dev server needs - `createWebApp(...)` satisfies it. */
 interface FetchApp {
     fetch(request: Request): Response | Promise<Response>;
@@ -78,5 +79,4 @@ export declare function styleTags(styles: readonly string[]): string;
 export declare function injectStyles(html: string, styles: readonly string[]): string;
 /** Start the Bun dev server: generate → bundle → serve → watch → hot-reload on change. */
 export declare function createDevServer(options: DevServerOptions): Promise<DevServer>;
-export {};
 //# sourceMappingURL=dev.d.ts.map

package/dist/dev.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"dev.d.ts","sourceRoot":"","sources":["../src/dev.ts"],"names":[],"mappings":"AAsDA,OAAO,EAAE,KAAK,kBAAkB,EAAe,MAAM,YAAY,CAAA;AAQjE,mFAAmF;AACnF,UAAU,QAAQ;IAChB,KAAK,CAAC,OAAO,EAAE,OAAO,GAAG,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAA;CACtD;AAED,MAAM,WAAW,gBAAiB,SAAQ,IAAI,CAAC,kBAAkB,EAAE,QAAQ,CAAC;IAC1E;;;;OAIG;IACH,QAAQ,CAAC,SAAS,EAAE,CAAC,WAAW,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,KAAK,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAA;IAC9F,qDAAqD;IACrD,QAAQ,CAAC,KAAK,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;IAClC,4DAA4D;IAC5D,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAA;IACtB;sFACkF;IAClF,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,KAAK,CAAA;IACnC;;;;;;;OAOG;IACH,QAAQ,CAAC,UAAU,CAAC,EAAE,OAAO,CAAA;CAC9B;AAED,MAAM,WAAW,SAAS;IACxB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB;;;;OAIG;IACH,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAA;IAC5B,IAAI,IAAI,IAAI,CAAA;CACb;AAaD;;;;;;;GAOG;AACH,eAAO,MAAM,iBAAiB,uBAAuB,CAAA;AAuCrD;;;;GAIG;AACH,wBAAgB,OAAO,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAMjD;AAED,UAAU,oBAAoB;IAC5B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;IAC1B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAA;IAC7B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;IAC1B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;CAC1B;AAED;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,oBAAoB,GAAG,IAAI,CAsBjE;AAED,wGAAwG;AACxG,wBAAgB,SAAS,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,GAAG,MAAM,CAQ3D;AAED;;;;;;GAMG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,MAAM,EAAE,GAAG,MAAM,CAM5E;AAED,0FAA0F;AAC1F,wBAAsB,eAAe,CAAC,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,SAAS,CAAC,CAwOnF"}
+{"version":3,"file":"dev.d.ts","sourceRoot":"","sources":["../src/dev.ts"],"names":[],"mappings":"AAsDA,OAAO,EAAE,KAAK,kBAAkB,EAAe,MAAM,YAAY,CAAA;AAQjE,OAAO,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAA;AAEjD,mFAAmF;AACnF,UAAU,QAAQ;IAChB,KAAK,CAAC,OAAO,EAAE,OAAO,GAAG,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAA;CACtD;AAED,MAAM,WAAW,gBAAiB,SAAQ,IAAI,CAAC,kBAAkB,EAAE,QAAQ,CAAC;IAC1E;;;;OAIG;IACH,QAAQ,CAAC,SAAS,EAAE,CAAC,WAAW,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,KAAK,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAA;IAC9F,qDAAqD;IACrD,QAAQ,CAAC,KAAK,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;IAClC,4DAA4D;IAC5D,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAA;IACtB;sFACkF;IAClF,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,KAAK,CAAA;IACnC;;;;;;;OAOG;IACH,QAAQ,CAAC,UAAU,CAAC,EAAE,OAAO,CAAA;CAC9B;AAED,MAAM,WAAW,SAAS;IACxB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB;;;;OAIG;IACH,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAA;IAC5B,IAAI,IAAI,IAAI,CAAA;CACb;AAaD;;;;;;;GAOG;AACH,eAAO,MAAM,iBAAiB,uBAAuB,CAAA;AAyCrD;;;;GAIG;AACH,wBAAgB,OAAO,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAMjD;AAED,UAAU,oBAAoB;IAC5B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;IAC1B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAA;IAC7B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;IAC1B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;CAC1B;AAED;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,oBAAoB,GAAG,IAAI,CAsBjE;AAED,wGAAwG;AACxG,wBAAgB,SAAS,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,GAAG,MAAM,CAQ3D;AAED;;;;;;GAMG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,MAAM,EAAE,GAAG,MAAM,CAM5E;AAED,0FAA0F;AAC1F,wBAAsB,eAAe,CAAC,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,SAAS,CAAC,CAoPnF"}

package/dist/dev.js

@@ -54,11 +54,12 @@ import { mkdirSync, readdirSync, readFileSync, rmSync, unwatchFile, watchFile, w
 import { dirname, relative, resolve } from "node:path";
 import { buildClient } from "./build.js";
 import { resolveDevEntry } from "./bun-dev-entry.js";
-import { renderDevErrorOverlay } from "./dev-error.js";
+import { createDevDiagnostics } from "./dev-diagnostics.js";
 import { explainBindFailure } from "./dev-port.js";
 import { discoverRoutes } from "./fs.js";
 import { DEFAULT_DEV_PORT, generateClientEntry } from "./index.js";
 import { servePublicDir } from "./public-dir.js";
+export { LAST_ERROR_PATH } from "./diagnostic.js";
 /**
  * Where the generated dev files live. A dot-directory inside the project, not a temp dir: Bun's bundler
  * resolves the entry's imports the way the runtime does, so it has to sit where the app's routes and
@@ -171,6 +172,10 @@ export async function createDevServer(options) {
     // The app root. `routesDir` is `<app>/routes` by convention, so its parent is the project - the one
     // place a generated entry can sit and still resolve the app's imports.
     const root = resolve(routesDir, "..");
+    // The most recent SSR failure as a structured Diagnostic, scoped to THIS server. Served at
+    // LAST_ERROR_PATH so an agent driving the dev server reads the exact failure (code, codeframe, fix) as
+    // JSON instead of scraping the overlay. Shared with the Vite adapter so the endpoint can't drift.
+    const devDiagnostics = createDevDiagnostics(root);
     const devDir = resolve(root, DEV_DIR);
     const entryPath = resolve(devDir, "entry.tsx");
     const htmlPath = resolve(devDir, "entry.html");
@@ -263,6 +268,7 @@ export async function createDevServer(options) {
     try {
         server = serve({
             port,
+            hostname: "127.0.0.1",
             development: { hmr: true },
             // The probe route is the ONLY path Bun owns; everything else falls through to nifra's SSR.
             routes: { [PROBE_PATH]: htmlModule.default },
@@ -278,6 +284,11 @@ export async function createDevServer(options) {
                     const entry = await currentEntry();
                     return new Response(null, { status: 307, headers: { location: entry.src } });
                 }
+                if (devDiagnostics.isLastErrorPath(url.pathname)) {
+                    // The structured form of the overlay, for an agent driving the dev server (shared surface).
+                    const { body, headers } = devDiagnostics.lastError();
+                    return new Response(body, { headers });
+                }
                 // Static probe before routing; a miss returns undefined and falls through, so no route is
                 // shadowed and a page render never pays a filesystem stat (extension-less paths skip it).
                 const staticFile = await servePublic(req);
@@ -300,10 +311,15 @@ export async function createDevServer(options) {
                     });
                 }
                 catch (err) {
-                    return new Response(renderDevErrorOverlay(err, {
+                    // One Diagnostic drives both surfaces: the overlay returned here and the JSON at LAST_ERROR_PATH.
+                    const html = devDiagnostics.capture(err, {
                         method: req.method,
                         url: `${url.pathname}${url.search}`,
-                    }), { status: 500, headers: { "content-type": "text/html; charset=utf-8" } });
+                    });
+                    return new Response(html, {
+                        status: 500,
+                        headers: { "content-type": "text/html; charset=utf-8" },
+                    });
                 }
             },
         });

package/dist/dev.js.map

@@ -1 +1 @@
-{"version":3,"file":"dev.js","sourceRoot":"","sources":["../src/dev.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"dev.js","sourceRoot":"","sources":["../src/dev.ts"],"names":[],"mappings":"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"}

package/dist/diagnostic.d.ts

@@ -0,0 +1,93 @@
+/** Shared endpoint name used by both dev pipelines and the agent-facing MCP tools. */
+export declare const LAST_ERROR_PATH = "/__nifra/last-error";
+/** One parsed stack frame. `file`/`line`/`column` are present only when the frame could be located. */
+export interface DiagnosticFrame {
+    readonly raw: string;
+    readonly file?: string;
+    readonly line?: number;
+    readonly column?: number;
+}
+/** A source window around the offending line. `caret` marks the exact line the top frame points at. */
+export interface Codeframe {
+    readonly file: string;
+    readonly line: number;
+    readonly column?: number | undefined;
+    readonly lines: ReadonlyArray<{
+        readonly number: number;
+        readonly text: string;
+        readonly caret: boolean;
+    }>;
+}
+/** The structured failure. Serialisable as-is to JSON for the agent surfaces. */
+export interface Diagnostic {
+    /** Stable, greppable identifier, e.g. `NIFRA_SERVER_ONLY_IN_CLIENT`. `NIFRA_UNHANDLED` when unrecognised. */
+    readonly code: string;
+    readonly name: string;
+    readonly message: string;
+    readonly request?: {
+        readonly method: string;
+        readonly url: string;
+    } | undefined;
+    readonly frames: readonly DiagnosticFrame[];
+    readonly codeframe?: Codeframe | undefined;
+    /** Plain-language "why this happened", when the failure is recognised. */
+    readonly cause?: string | undefined;
+    /** Plain-language "do this", when the failure is recognised. */
+    readonly fix?: string | undefined;
+    /** Docs section anchor for the code, e.g. `errors#server-only-in-client`. */
+    readonly docsAnchor?: string | undefined;
+}
+/** Reads a source file's text, or returns undefined if it cannot (missing, binary, permission). */
+export type SourceReader = (file: string) => string | undefined;
+/**
+ * Parse a V8/Node stack into structured frames. Handles the `at fn (path:line:col)`, bare
+ * `at path:line:col`, and `at async fn (...)` shapes; a frame that doesn't match keeps its raw text
+ * with no location (so nothing is silently dropped).
+ */
+export declare function parseFrames(stack: string): DiagnosticFrame[];
+/** The first frame that points at the user's own source - what the codeframe should show. */
+export declare function topUserFrame(frames: readonly DiagnosticFrame[], root: string | undefined): DiagnosticFrame | undefined;
+/**
+ * Build a source codeframe: `radius` lines either side of `line`, each tagged with its 1-based number
+ * and whether it is the offending line. Returns undefined if the source can't be read or the line is
+ * out of range - a diagnostic without a codeframe is still useful, so this never throws.
+ */
+export declare function buildCodeframe(file: string, line: number, column: number | undefined, read?: SourceReader, radius?: number): Codeframe | undefined;
+/** A recognised failure shape: a stable code plus the plain-language cause/fix/anchor to attach. */
+interface CatalogEntry {
+    readonly code: string;
+    readonly match: (name: string, message: string) => boolean;
+    readonly cause: string;
+    readonly fix: string;
+    readonly docsAnchor: string;
+}
+/**
+ * The recognised-failure catalog. Seeded with the highest-signal nifra failures; extend it as new
+ * classes of error earn a stable code. Order matters only in that the first match wins.
+ */
+export declare const DIAGNOSTIC_CATALOG: readonly CatalogEntry[];
+/** Classify an error name+message against the catalog; falls back to the generic unhandled code. */
+export declare function classify(name: string, message: string): {
+    code: string;
+    cause?: string;
+    fix?: string;
+    docsAnchor?: string;
+};
+export interface BuildDiagnosticOptions {
+    readonly request?: {
+        readonly method: string;
+        readonly url: string;
+    };
+    /** Project root; frames outside it are treated as non-user. Defaults to `process.cwd()`. */
+    readonly root?: string;
+    /** Injectable source reader (tests pass a fake; production reads the filesystem). */
+    readonly read?: SourceReader;
+}
+/**
+ * Resolve any thrown value into a `Diagnostic`: parse the (already source-mapped) stack, locate the top
+ * user frame, attach a codeframe, and classify the failure for a cause/fix. The caller is responsible
+ * for running Vite's `ssrFixStacktrace` first so the frames point at real source.
+ */
+export declare function buildDiagnostic(err: unknown, options?: BuildDiagnosticOptions): Diagnostic;
+export {};
+//# sourceMappingURL=diagnostic.d.ts.map

package/dist/diagnostic.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"diagnostic.d.ts","sourceRoot":"","sources":["../src/diagnostic.ts"],"names":[],"mappings":"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"}