@nifrajs/web 2.2.0 → 2.4.0

package/dist/dev.d.ts

@@ -1,11 +1,12 @@
 import { type BuildClientOptions } from "./build.js";
-/** Minimal app surface the dev server needs — `createWebApp(...)` satisfies it. */
+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>;
 }
 export interface DevServerOptions extends Omit<BuildClientOptions, "minify"> {
     /**
-     * Build the nifra app for the current client entry. `importQuery` changes on every reload — pass it to
+     * Build the nifra app for the current client entry. `importQuery` changes on every reload - pass it to
      * `discoverRoutes(routesDir, { importQuery })` so SSR re-imports edited route modules instead of Bun's
      * cached copies.
      */
@@ -30,7 +31,7 @@ export interface DevServerOptions extends Omit<BuildClientOptions, "minify"> {
 export interface DevServer {
     readonly port: number;
     /**
-     * The URL pages point their client entry at — always {@link CLIENT_ENTRY_PATH}, never Bun's hashed
+     * The URL pages point their client entry at - always {@link CLIENT_ENTRY_PATH}, never Bun's hashed
      * chunk. Deliberately not the underlying chunk URL: that one moves on every rebuild, and anything
      * holding onto it is holding onto a URL that will stop working.
      */
@@ -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

@@ -7,7 +7,7 @@ var __rewriteRelativeImportExtension = (this && this.__rewriteRelativeImportExte
     return path;
 };
 /**
- * `@nifrajs/web/dev` — the **Bun pipeline's** dev server: one toolchain, no Vite in the process.
+ * `@nifrajs/web/dev` - the **Bun pipeline's** dev server: one toolchain, no Vite in the process.
  *
  * nifra ships two dev pipelines and the rule between them is that a pipeline owns a whole phase. The
  * Vite server (`@nifrajs/web/vite`) is the default - mature framework plugins, and it resolves SSR as
@@ -15,12 +15,12 @@ var __rewriteRelativeImportExtension = (this && this.__rewriteRelativeImportExte
  * and hot-reloads the client while Bun's runtime resolves SSR. Only one toolchain is present, so the two
  * cannot disagree.
  *
- * What you get: React Fast Refresh WITH state preserved — Bun's dev server applies it natively, no plugin
+ * What you get: React Fast Refresh WITH state preserved - Bun's dev server applies it natively, no plugin
  * (verified: editing a component-only module swaps its markup while a `useState` counter keeps its value,
  * no reload). The usual boundary rule still applies, and it is the same rule Vite has: a module whose
  * exports are all components is a refresh boundary, so a ROUTE file that also exports `loader`/`meta` is
  * not, and saving it does a clean full reload. Plus no Vite dependency and ONE bundler across dev and
- * production, which is the real prize — the dev/prod seam disappears.
+ * production, which is the real prize - the dev/prod seam disappears.
  *
  * What you give up: `*.module.css`. Bun's DEV-server bundler has no CSS-Modules transform (its production
  * `Bun.build` does), so the import compiles to a dangling reference. Plain CSS and Tailwind are fine. The
@@ -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
@@ -94,7 +95,7 @@ function writeIfChanged(path, content) {
             return;
     }
     catch {
-        // missing or unreadable — fall through and write
+        // missing or unreadable - fall through and write
     }
     writeFileSync(path, content);
 }
@@ -125,13 +126,13 @@ export function writeDevFiles(options) {
         // A bare relative path reads as a PACKAGE specifier to a bundler; `./` is what makes it a file.
         return rel.startsWith(".") ? rel : `./${rel}`;
     };
-    // No `import.meta.hot.accept` here, deliberately. When an edit lands OUTSIDE a Fast Refresh boundary —
-    // a route file, which also exports `loader`/`meta` — Bun walks up to this generated entry, finds no
+    // No `import.meta.hot.accept` here, deliberately. When an edit lands OUTSIDE a Fast Refresh boundary -
+    // a route file, which also exports `loader`/`meta` - Bun walks up to this generated entry, finds no
     // `accept`, logs "hot update was not accepted" and does a full reload. That reload is correct: the route
     // module's non-component exports changed, so patching it into the live tree would be wrong. Accepting
     // here is worse than the warning: Bun re-evaluates the module BEFORE the accept callback runs, so the
     // entry re-executes against a container React already mounted ("createRoot() on a container that has
-    // already been passed to createRoot()") and only then does the callback get to reload — trading an
+    // already been passed to createRoot()") and only then does the callback get to reload - trading an
     // accurate warning for a real error. Editing a component-only module never reaches this path: Bun
     // applies React Fast Refresh there and state is preserved.
     writeIfChanged(entryPath, generateClientEntry(manifest, { clientModule, resolve: toSpecifier }));
@@ -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");
@@ -186,9 +191,9 @@ export async function createDevServer(options) {
     // Bun resolves and bundles the HTML, and everything it references, at import time.
     const htmlModule = (await import(__rewriteRelativeImportExtension(htmlPath)));
     let server;
-    // The last resolved entry, with the time it was resolved. Deliberately short-lived — see `currentEntry`.
+    // The last resolved entry, with the time it was resolved. Deliberately short-lived - see `currentEntry`.
     let cache;
-    // The app, tagged with the entry hash it was built against — see `appFor`.
+    // The app, tagged with the entry hash it was built against - see `appFor`.
     let built;
     let building;
     let version = 0;
@@ -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":"AAgBA,sFAAsF;AACtF,eAAO,MAAM,eAAe,wBAAwB,CAAA;AAEpD,uGAAuG;AACvG,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAA;IACpB,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CACzB;AAED,uGAAuG;AACvG,MAAM,WAAW,SAAS;IACxB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IACpC,QAAQ,CAAC,KAAK,EAAE,aAAa,CAAC;QAC5B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;QACvB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;QACrB,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAA;KACxB,CAAC,CAAA;CACH;AAED,iFAAiF;AACjF,MAAM,WAAW,UAAU;IACzB,6GAA6G;IAC7G,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;IACxB,QAAQ,CAAC,OAAO,CAAC,EAAE;QAAE,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAA;KAAE,GAAG,SAAS,CAAA;IAChF,QAAQ,CAAC,MAAM,EAAE,SAAS,eAAe,EAAE,CAAA;IAC3C,QAAQ,CAAC,SAAS,CAAC,EAAE,SAAS,GAAG,SAAS,CAAA;IAC1C,0EAA0E;IAC1E,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IACnC,gEAAgE;IAChE,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IACjC,6EAA6E;IAC7E,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;CACzC;AAED,mGAAmG;AACnG,MAAM,MAAM,YAAY,GAAG,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,GAAG,SAAS,CAAA;AA4B/D;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,eAAe,EAAE,CAmB5D;AA+BD,6FAA6F;AAC7F,wBAAgB,YAAY,CAC1B,MAAM,EAAE,SAAS,eAAe,EAAE,EAClC,IAAI,EAAE,MAAM,GAAG,SAAS,GACvB,eAAe,GAAG,SAAS,CAE7B;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAC5B,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,MAAM,GAAG,SAAS,EAC1B,IAAI,GAAE,YAA4B,EAClC,MAAM,SAAI,GACT,SAAS,GAAG,SAAS,CAYvB;AAED,oGAAoG;AACpG,UAAU,YAAY;IACpB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,KAAK,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,KAAK,OAAO,CAAA;IAC1D,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAA;IACpB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;CAC5B;AAED;;;GAGG;AACH,eAAO,MAAM,kBAAkB,EAAE,SAAS,YAAY,EAyBrD,CAAA;AAED,oGAAoG;AACpG,wBAAgB,QAAQ,CACtB,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,GACd;IACD,IAAI,EAAE,MAAM,CAAA;IACZ,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,UAAU,CAAC,EAAE,MAAM,CAAA;CACpB,CAIA;AAcD,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,OAAO,CAAC,EAAE;QAAE,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAA;KAAE,CAAA;IACpE,4FAA4F;IAC5F,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAA;IACtB,qFAAqF;IACrF,QAAQ,CAAC,IAAI,CAAC,EAAE,YAAY,CAAA;CAC7B;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,OAAO,EAAE,OAAO,GAAE,sBAA2B,GAAG,UAAU,CAsB9F"}

package/dist/diagnostic.js

@@ -0,0 +1,205 @@
+/**
+ * The structured diagnostic that every nifra failure resolves to - the single source both the human
+ * dev overlay ([dev-error.ts]) and the agent-facing surfaces (`/__nifra/last-error`, `nifra_explain`)
+ * render from. A stack trace is a wall of text; a `Diagnostic` is queryable: a stable `code`, the top
+ * USER frame (file/line/column), a source codeframe around it, and - when the failure is one nifra
+ * recognises - a plain-language `cause` + `fix` + docs anchor.
+ *
+ * This is the "AI-native" half of error reporting: the same object a person reads in the overlay is the
+ * JSON an agent reads to apply the fix, so neither has to scrape the other's format.
+ *
+ * Pure + DOM-free by construction (it only parses strings and reads source text through an injected
+ * reader), so it lives in the root typecheck program and is unit-testable without a dev server or disk.
+ */
+import { readFileSync, realpathSync } from "node:fs";
+import { isAbsolute, relative, resolve } from "node:path";
+/** Shared endpoint name used by both dev pipelines and the agent-facing MCP tools. */
+export const LAST_ERROR_PATH = "/__nifra/last-error";
+const defaultReader = (file) => {
+    try {
+        return readFileSync(file, "utf8");
+    }
+    catch {
+        return undefined;
+    }
+};
+// Turns a raw frame path into an absolute filesystem path, or undefined if it isn't one. Handles the
+// `file://` URL form Vite/Node emit and strips the `?v=hash` / `#` suffixes a bundler appends.
+function cleanFramePath(path) {
+    let p = path.trim();
+    if (p.startsWith("file://")) {
+        try {
+            p = decodeURIComponent(new URL(p).pathname);
+        }
+        catch {
+            return undefined;
+        }
+    }
+    // Strip the `?v=hash` / `#` suffix without a `.*` regex (ReDoS-safe): cut at the first `?` or `#`.
+    const cut = p.search(/[?#]/);
+    if (cut !== -1)
+        p = p.slice(0, cut);
+    const isAbsolute = p.startsWith("/") || /^[A-Za-z]:[\\/]/.test(p);
+    return isAbsolute ? p : 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 function parseFrames(stack) {
+    const frames = [];
+    for (const line of stack.split("\n")) {
+        const raw = line.trim();
+        if (!/^at\s/.test(raw))
+            continue;
+        // Prefer the parenthesised location; fall back to a trailing `path:line:col`.
+        const paren = raw.match(/\(([^()]+):(\d+):(\d+)\)\s*$/);
+        const bare = raw.match(/^at\s+(?:async\s+)?(\S.*):(\d+):(\d+)\s*$/);
+        const m = paren ?? bare;
+        if (!m) {
+            frames.push({ raw });
+            continue;
+        }
+        const file = cleanFramePath(m[1]);
+        frames.push(file === undefined ? { raw } : { raw, file, line: Number(m[2]), column: Number(m[3]) });
+    }
+    return frames;
+}
+/** Frames inside dependencies or the runtime are noise for a first look; the user's own code is the signal. */
+function isUserFrame(file, root) {
+    if (file.includes("/node_modules/") || file.includes("\\node_modules\\"))
+        return false;
+    if (file.startsWith("node:"))
+        return false;
+    if (root !== undefined) {
+        // A string prefix is not a path boundary (`/app-evil` starts with `/app`) and leaves `..` and
+        // symlink escapes unresolved. Resolve lexically first, then realpath existing paths so a codeframe
+        // can never read a source file outside the project root merely because a stack frame was crafted.
+        const rootPath = canonicalPath(root);
+        const framePath = canonicalPath(file);
+        const rel = relative(rootPath, framePath);
+        if (rel === ".." || rel.startsWith(`..${sepForPath(rel)}`) || isAbsolute(rel))
+            return false;
+    }
+    return true;
+}
+function sepForPath(path) {
+    return path.includes("\\") ? "\\" : "/";
+}
+function canonicalPath(path) {
+    const lexical = resolve(path);
+    try {
+        return realpathSync.native(lexical);
+    }
+    catch {
+        return lexical;
+    }
+}
+/** The first frame that points at the user's own source - what the codeframe should show. */
+export function topUserFrame(frames, root) {
+    return frames.find((f) => f.file !== undefined && isUserFrame(f.file, root));
+}
+/**
+ * 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 function buildCodeframe(file, line, column, read = defaultReader, radius = 3) {
+    const source = read(file);
+    if (source === undefined)
+        return undefined;
+    const all = source.split("\n");
+    if (line < 1 || line > all.length)
+        return undefined;
+    const start = Math.max(1, line - radius);
+    const end = Math.min(all.length, line + radius);
+    const lines = [];
+    for (let n = start; n <= end; n++) {
+        lines.push({ number: n, text: all[n - 1] ?? "", caret: n === line });
+    }
+    return { file, line, column, lines };
+}
+/**
+ * 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 const DIAGNOSTIC_CATALOG = [
+    {
+        code: "NIFRA_SERVER_ONLY_IN_CLIENT",
+        match: (_n, m) => m.includes("server-only module(s) in the client bundle"),
+        cause: "A module marked server-only was reachable from a client entry, so it would ship to the browser.",
+        fix: "Follow the import chain in the message and move the server-only use behind a loader/action or a `*.server.ts` boundary, so it never enters a client component.",
+        docsAnchor: "errors#server-only-in-client",
+    },
+    {
+        code: "NIFRA_NODE_BUILTIN_IN_CLIENT",
+        match: (_n, m) => m.includes("Node built-in(s) in the client bundle"),
+        cause: "A `node:` built-in was reached from a client entry; it has no browser implementation.",
+        fix: "Move the code using the built-in to the server (loader/action or `*.server.ts`); the message lists the import chain that pulled it in.",
+        docsAnchor: "errors#node-builtin-in-client",
+    },
+    {
+        code: "NIFRA_SCHEMA_PARSE",
+        match: (n, m) => n === "SchemaError" ||
+            /failed to (parse|validate)|invalid_type|expected .* received/i.test(m),
+        cause: "Data crossing a boundary did not match its declared schema.",
+        fix: "Check the value against the schema at the failing boundary (loader input, search params, or request body); parse-don't-cast means the shape must match exactly.",
+        docsAnchor: "errors#schema-parse",
+    },
+];
+/** Classify an error name+message against the catalog; falls back to the generic unhandled code. */
+export function classify(name, message) {
+    const hit = DIAGNOSTIC_CATALOG.find((e) => e.match(name, message));
+    if (hit === undefined)
+        return { code: "NIFRA_UNHANDLED" };
+    return { code: hit.code, cause: hit.cause, fix: hit.fix, docsAnchor: hit.docsAnchor };
+}
+/** Split an Error's `stack` into its leading message block and its frame lines. */
+function messageAndStack(err) {
+    const stack = err.stack ?? `${err.name}: ${err.message}`;
+    const lines = stack.split("\n");
+    const firstFrame = lines.findIndex((l) => /^\s*at\s/.test(l));
+    if (firstFrame === -1)
+        return { message: err.message || stack.trim(), stack: "" };
+    return {
+        message: lines.slice(0, firstFrame).join("\n").trim(),
+        stack: lines.slice(firstFrame).join("\n"),
+    };
+}
+/**
+ * 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 function buildDiagnostic(err, options = {}) {
+    const error = err instanceof Error ? err : new Error(String(err));
+    const root = options.root ?? safeCwd();
+    const { message } = messageAndStack(error);
+    const frames = parseFrames(error.stack ?? "");
+    const top = topUserFrame(frames, root);
+    const codeframe = top?.file !== undefined && top.line !== undefined
+        ? buildCodeframe(canonicalPath(top.file), top.line, top.column, options.read)
+        : undefined;
+    const { code, cause, fix, docsAnchor } = classify(error.name || "Error", message);
+    return {
+        code,
+        name: error.name || "Error",
+        message,
+        request: options.request,
+        frames,
+        codeframe,
+        cause,
+        fix,
+        docsAnchor,
+    };
+}
+function safeCwd() {
+    try {
+        return process.cwd();
+    }
+    catch {
+        return undefined;
+    }
+}
+//# sourceMappingURL=diagnostic.js.map

package/dist/diagnostic.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"diagnostic.js","sourceRoot":"","sources":["../src/diagnostic.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,SAAS,CAAA;AACpD,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AAEzD,sFAAsF;AACtF,MAAM,CAAC,MAAM,eAAe,GAAG,qBAAqB,CAAA;AA0CpD,MAAM,aAAa,GAAiB,CAAC,IAAI,EAAE,EAAE;IAC3C,IAAI,CAAC;QACH,OAAO,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,CAAA;IACnC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,SAAS,CAAA;IAClB,CAAC;AACH,CAAC,CAAA;AAED,qGAAqG;AACrG,+FAA+F;AAC/F,SAAS,cAAc,CAAC,IAAY;IAClC,IAAI,CAAC,GAAG,IAAI,CAAC,IAAI,EAAE,CAAA;IACnB,IAAI,CAAC,CAAC,UAAU,CAAC,SAAS,CAAC,EAAE,CAAC;QAC5B,IAAI,CAAC;YACH,CAAC,GAAG,kBAAkB,CAAC,IAAI,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAA;QAC7C,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,SAAS,CAAA;QAClB,CAAC;IACH,CAAC;IACD,mGAAmG;IACnG,MAAM,GAAG,GAAG,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,CAAA;IAC5B,IAAI,GAAG,KAAK,CAAC,CAAC;QAAE,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,CAAA;IACnC,MAAM,UAAU,GAAG,CAAC,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,iBAAiB,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;IACjE,OAAO,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAA;AACnC,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,WAAW,CAAC,KAAa;IACvC,MAAM,MAAM,GAAsB,EAAE,CAAA;IACpC,KAAK,MAAM,IAAI,IAAI,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;QACrC,MAAM,GAAG,GAAG,IAAI,CAAC,IAAI,EAAE,CAAA;QACvB,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC;YAAE,SAAQ;QAChC,8EAA8E;QAC9E,MAAM,KAAK,GAAG,GAAG,CAAC,KAAK,CAAC,8BAA8B,CAAC,CAAA;QACvD,MAAM,IAAI,GAAG,GAAG,CAAC,KAAK,CAAC,2CAA2C,CAAC,CAAA;QACnE,MAAM,CAAC,GAAG,KAAK,IAAI,IAAI,CAAA;QACvB,IAAI,CAAC,CAAC,EAAE,CAAC;YACP,MAAM,CAAC,IAAI,CAAC,EAAE,GAAG,EAAE,CAAC,CAAA;YACpB,SAAQ;QACV,CAAC;QACD,MAAM,IAAI,GAAG,cAAc,CAAC,CAAC,CAAC,CAAC,CAAW,CAAC,CAAA;QAC3C,MAAM,CAAC,IAAI,CACT,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CACvF,CAAA;IACH,CAAC;IACD,OAAO,MAAM,CAAA;AACf,CAAC;AAED,+GAA+G;AAC/G,SAAS,WAAW,CAAC,IAAY,EAAE,IAAwB;IACzD,IAAI,IAAI,CAAC,QAAQ,CAAC,gBAAgB,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,kBAAkB,CAAC;QAAE,OAAO,KAAK,CAAA;IACtF,IAAI,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC;QAAE,OAAO,KAAK,CAAA;IAC1C,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;QACvB,8FAA8F;QAC9F,mGAAmG;QACnG,kGAAkG;QAClG,MAAM,QAAQ,GAAG,aAAa,CAAC,IAAI,CAAC,CAAA;QACpC,MAAM,SAAS,GAAG,aAAa,CAAC,IAAI,CAAC,CAAA;QACrC,MAAM,GAAG,GAAG,QAAQ,CAAC,QAAQ,EAAE,SAAS,CAAC,CAAA;QACzC,IAAI,GAAG,KAAK,IAAI,IAAI,GAAG,CAAC,UAAU,CAAC,KAAK,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,UAAU,CAAC,GAAG,CAAC;YAAE,OAAO,KAAK,CAAA;IAC7F,CAAC;IACD,OAAO,IAAI,CAAA;AACb,CAAC;AAED,SAAS,UAAU,CAAC,IAAY;IAC9B,OAAO,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,CAAA;AACzC,CAAC;AAED,SAAS,aAAa,CAAC,IAAY;IACjC,MAAM,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IAC7B,IAAI,CAAC;QACH,OAAO,YAAY,CAAC,MAAM,CAAC,OAAO,CAAC,CAAA;IACrC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,OAAO,CAAA;IAChB,CAAC;AACH,CAAC;AAED,6FAA6F;AAC7F,MAAM,UAAU,YAAY,CAC1B,MAAkC,EAClC,IAAwB;IAExB,OAAO,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,SAAS,IAAI,WAAW,CAAC,CAAC,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC,CAAA;AAC9E,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,cAAc,CAC5B,IAAY,EACZ,IAAY,EACZ,MAA0B,EAC1B,OAAqB,aAAa,EAClC,MAAM,GAAG,CAAC;IAEV,MAAM,MAAM,GAAG,IAAI,CAAC,IAAI,CAAC,CAAA;IACzB,IAAI,MAAM,KAAK,SAAS;QAAE,OAAO,SAAS,CAAA;IAC1C,MAAM,GAAG,GAAG,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAA;IAC9B,IAAI,IAAI,GAAG,CAAC,IAAI,IAAI,GAAG,GAAG,CAAC,MAAM;QAAE,OAAO,SAAS,CAAA;IACnD,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,GAAG,MAAM,CAAC,CAAA;IACxC,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,MAAM,EAAE,IAAI,GAAG,MAAM,CAAC,CAAA;IAC/C,MAAM,KAAK,GAA4D,EAAE,CAAA;IACzE,KAAK,IAAI,CAAC,GAAG,KAAK,EAAE,CAAC,IAAI,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC;QAClC,KAAK,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,IAAI,EAAE,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,KAAK,EAAE,CAAC,KAAK,IAAI,EAAE,CAAC,CAAA;IACtE,CAAC;IACD,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,CAAA;AACtC,CAAC;AAWD;;;GAGG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAA4B;IACzD;QACE,IAAI,EAAE,6BAA6B;QACnC,KAAK,EAAE,CAAC,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,4CAA4C,CAAC;QAC1E,KAAK,EACH,iGAAiG;QACnG,GAAG,EAAE,gKAAgK;QACrK,UAAU,EAAE,8BAA8B;KAC3C;IACD;QACE,IAAI,EAAE,8BAA8B;QACpC,KAAK,EAAE,CAAC,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,uCAAuC,CAAC;QACrE,KAAK,EAAE,uFAAuF;QAC9F,GAAG,EAAE,wIAAwI;QAC7I,UAAU,EAAE,+BAA+B;KAC5C;IACD;QACE,IAAI,EAAE,oBAAoB;QAC1B,KAAK,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CACd,CAAC,KAAK,aAAa;YACnB,+DAA+D,CAAC,IAAI,CAAC,CAAC,CAAC;QACzE,KAAK,EAAE,6DAA6D;QACpE,GAAG,EAAE,iKAAiK;QACtK,UAAU,EAAE,qBAAqB;KAClC;CACF,CAAA;AAED,oGAAoG;AACpG,MAAM,UAAU,QAAQ,CACtB,IAAY,EACZ,OAAe;IAOf,MAAM,GAAG,GAAG,kBAAkB,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC,CAAA;IAClE,IAAI,GAAG,KAAK,SAAS;QAAE,OAAO,EAAE,IAAI,EAAE,iBAAiB,EAAE,CAAA;IACzD,OAAO,EAAE,IAAI,EAAE,GAAG,CAAC,IAAI,EAAE,KAAK,EAAE,GAAG,CAAC,KAAK,EAAE,GAAG,EAAE,GAAG,CAAC,GAAG,EAAE,UAAU,EAAE,GAAG,CAAC,UAAU,EAAE,CAAA;AACvF,CAAC;AAED,mFAAmF;AACnF,SAAS,eAAe,CAAC,GAAU;IACjC,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,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,GAAG,CAAC,OAAO,IAAI,KAAK,CAAC,IAAI,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,CAAA;IACjF,OAAO;QACL,OAAO,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,UAAU,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE;QACrD,KAAK,EAAE,KAAK,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC;KAC1C,CAAA;AACH,CAAC;AAUD;;;;GAIG;AACH,MAAM,UAAU,eAAe,CAAC,GAAY,EAAE,UAAkC,EAAE;IAChF,MAAM,KAAK,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAA;IACjE,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,IAAI,OAAO,EAAE,CAAA;IACtC,MAAM,EAAE,OAAO,EAAE,GAAG,eAAe,CAAC,KAAK,CAAC,CAAA;IAC1C,MAAM,MAAM,GAAG,WAAW,CAAC,KAAK,CAAC,KAAK,IAAI,EAAE,CAAC,CAAA;IAC7C,MAAM,GAAG,GAAG,YAAY,CAAC,MAAM,EAAE,IAAI,CAAC,CAAA;IACtC,MAAM,SAAS,GACb,GAAG,EAAE,IAAI,KAAK,SAAS,IAAI,GAAG,CAAC,IAAI,KAAK,SAAS;QAC/C,CAAC,CAAC,cAAc,CAAC,aAAa,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,GAAG,CAAC,IAAI,EAAE,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,IAAI,CAAC;QAC7E,CAAC,CAAC,SAAS,CAAA;IACf,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,EAAE,UAAU,EAAE,GAAG,QAAQ,CAAC,KAAK,CAAC,IAAI,IAAI,OAAO,EAAE,OAAO,CAAC,CAAA;IACjF,OAAO;QACL,IAAI;QACJ,IAAI,EAAE,KAAK,CAAC,IAAI,IAAI,OAAO;QAC3B,OAAO;QACP,OAAO,EAAE,OAAO,CAAC,OAAO;QACxB,MAAM;QACN,SAAS;QACT,KAAK;QACL,GAAG;QACH,UAAU;KACX,CAAA;AACH,CAAC;AAED,SAAS,OAAO;IACd,IAAI,CAAC;QACH,OAAO,OAAO,CAAC,GAAG,EAAE,CAAA;IACtB,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,SAAS,CAAA;IAClB,CAAC;AACH,CAAC"}

package/dist/draft.d.ts

@@ -1,8 +1,8 @@
 /**
- * Draft / preview mode — let an editor see unpublished content by flipping a signed cookie that
+ * Draft / preview mode - let an editor see unpublished content by flipping a signed cookie that
  * loaders read (`ctx.draft`) and ISR bypasses (fresh render, never cached). The cookie is **HMAC-signed**
- * (so a visitor can't forge it) and **HttpOnly** (JS can't read it). You gate `enableDraft` yourself —
- * behind an editor login or a `?token=` check — exactly like Next's `draftMode().enable()`.
+ * (so a visitor can't forge it) and **HttpOnly** (JS can't read it). You gate `enableDraft` yourself -
+ * behind an editor login or a `?token=` check - exactly like Next's `draftMode().enable()`.
  *
  *   // a route you've protected (e.g. checked ?token= against a secret):
  *   app.get("/api/draft", async (c) => {
@@ -17,7 +17,7 @@
 import { type CookieOptions } from "@nifrajs/core/server";
 /** The cookie name nifra uses for draft/preview mode. */
 export declare const DRAFT_COOKIE = "__nifra_draft";
-/** The response-cookie surface `enableDraft`/`disableDraft` need — nifra's `c.set`. Structural, so any
+/** The response-cookie surface `enableDraft`/`disableDraft` need - nifra's `c.set`. Structural, so any
  * nifra handler context satisfies it without importing the full `Context`. */
 export interface DraftCookieControls {
     cookie(name: string, value: string, options?: CookieOptions): void;
@@ -27,17 +27,17 @@ export interface DraftCookieControls {
     }): void;
 }
 export interface EnableDraftOptions {
-    /** Cookie lifetime in **seconds** (default `3600` = 1h). Keep it short — draft is an editor session. */
+    /** Cookie lifetime in **seconds** (default `3600` = 1h). Keep it short - draft is an editor session. */
     readonly maxAgeSeconds?: number;
     /** Cookie `Path` (default `"/"`). */
     readonly path?: string;
-    /** Override the `Secure` attribute (defaults to `true` — secure-by-default). Pass `false` only for
+    /** Override the `Secure` attribute (defaults to `true` - secure-by-default). Pass `false` only for
      * local `http://` dev, where a `Secure` cookie isn't stored. */
     readonly secure?: boolean;
 }
 /**
  * Turn draft mode **on** for this client by setting a signed, HttpOnly `__nifra_draft` cookie. Call it
- * from a route you've already authorized. `secret` signs the cookie — pass the SAME secret to
+ * from a route you've already authorized. `secret` signs the cookie - pass the SAME secret to
  * `createWebApp({ draftSecret })` and `withISR({ draftSecret })` so the framework can verify it.
  */
 export declare function enableDraft(c: {
@@ -59,7 +59,7 @@ export declare function isDraftEnabled(request: Request, secret: string): Promis
 export interface PreviewEndpointOptions {
     /** Shared secret the preview link must carry. Compared in **constant time**. */
     readonly secret: string;
-    /** Secret that **signs** the draft cookie — the same one passed to `createWebApp({ draftSecret })`
+    /** Secret that **signs** the draft cookie - the same one passed to `createWebApp({ draftSecret })`
      * and `withISR({ draftSecret })`. Keep it distinct from {@link secret}: that one travels in URLs
      * (logs, `Referer`, browser history), this one never leaves the server. */
     readonly draftSecret: string;
@@ -74,17 +74,17 @@ export interface PreviewEndpointOptions {
     readonly cookie?: EnableDraftOptions;
 }
 /**
- * A **preview / draft-mode entry point** — a `fetch` handler that checks a preview token, turns draft
+ * A **preview / draft-mode entry point** - a `fetch` handler that checks a preview token, turns draft
  * mode on, and redirects the editor to the page they wanted. `GET` with `?token=<secret>&to=/some/path`;
  * mount it on a nifra route, e.g. `app.get("/api/preview", (c) => handler(c.req))`.
  *
- * This is the link-borne sibling of `revalidateEndpoint`. It exists because the alternative — telling
- * you to gate the route yourself — means hand-rolling two checks that are easy to get subtly wrong and
+ * This is the link-borne sibling of `revalidateEndpoint`. It exists because the alternative - telling
+ * you to gate the route yourself - means hand-rolling two checks that are easy to get subtly wrong and
  * that fail silently when you do: the token compare must not exit early on the first wrong character,
  * and the `?to=` destination must not be allowed to point off-site. Both are handled here.
  *
  * A CMS "Preview" button is a plain link, so the token has to ride the query string. That has a cost
- * no endpoint can remove — the secret lands in server logs, the `Referer` header, and browser history.
+ * no endpoint can remove - the secret lands in server logs, the `Referer` header, and browser history.
  * Use a preview token minted for that purpose, rotate it, and never reuse a token that grants anything
  * beyond draft mode.
  *