@mesofact/runtime 0.8.29

package/dist/errors.js

@@ -0,0 +1,40 @@
+// Typed errors adapters throw. Render functions can catch and return
+// fallback HTML, or rethrow to let mesofact decide (stale-on-error / 503).
+// See `.yah/docs/architecture/mesofact.md` §"Adapter API surface".
+export class SourceError extends Error {
+    source;
+    retryable;
+    constructor(message, source, retryable, options) {
+        super(message, options);
+        this.name = new.target.name;
+        this.source = source;
+        this.retryable = retryable;
+    }
+}
+export class SourceUnavailableError extends SourceError {
+    constructor(source, options) {
+        super(`source unavailable: ${source}`, source, true, options);
+    }
+}
+export class SourceTimeoutError extends SourceError {
+    timeout_ms;
+    constructor(source, timeout_ms, options) {
+        super(`source timeout after ${timeout_ms}ms: ${source}`, source, true, options);
+        this.timeout_ms = timeout_ms;
+    }
+}
+export class SourceQueryError extends SourceError {
+    constructor(source, message, options) {
+        super(`source query error (${source}): ${message}`, source, false, options);
+    }
+}
+export class RowNotFoundError extends SourceError {
+    table;
+    id;
+    constructor(source, table, id) {
+        super(`row not found: ${source}.${table}[${id}]`, source, false);
+        this.table = table;
+        this.id = id;
+    }
+}
+//# sourceMappingURL=errors.js.map

package/dist/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA,qEAAqE;AACrE,2EAA2E;AAC3E,mEAAmE;AAEnE,MAAM,OAAO,WAAY,SAAQ,KAAK;IAC3B,MAAM,CAAS;IACf,SAAS,CAAU;IAE5B,YACE,OAAe,EACf,MAAc,EACd,SAAkB,EAClB,OAA6B;QAE7B,KAAK,CAAC,OAAO,EAAE,OAAmC,CAAC,CAAC;QACpD,IAAI,CAAC,IAAI,GAAG,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC;QAC5B,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC;IAC7B,CAAC;CACF;AAED,MAAM,OAAO,sBAAuB,SAAQ,WAAW;IACrD,YAAY,MAAc,EAAE,OAA6B;QACvD,KAAK,CAAC,uBAAuB,MAAM,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC;IAChE,CAAC;CACF;AAED,MAAM,OAAO,kBAAmB,SAAQ,WAAW;IACxC,UAAU,CAAS;IAE5B,YAAY,MAAc,EAAE,UAAkB,EAAE,OAA6B;QAC3E,KAAK,CAAC,wBAAwB,UAAU,OAAO,MAAM,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC;QAChF,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;IAC/B,CAAC;CACF;AAED,MAAM,OAAO,gBAAiB,SAAQ,WAAW;IAC/C,YAAY,MAAc,EAAE,OAAe,EAAE,OAA6B;QACxE,KAAK,CAAC,uBAAuB,MAAM,MAAM,OAAO,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,CAAC,CAAC;IAC9E,CAAC;CACF;AAED,MAAM,OAAO,gBAAiB,SAAQ,WAAW;IACtC,KAAK,CAAS;IACd,EAAE,CAAS;IAEpB,YAAY,MAAc,EAAE,KAAa,EAAE,EAAU;QACnD,KAAK,CAAC,kBAAkB,MAAM,IAAI,KAAK,IAAI,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,CAAC,CAAC;QACjE,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;QACnB,IAAI,CAAC,EAAE,GAAG,EAAE,CAAC;IACf,CAAC;CACF"}

package/dist/head.d.ts

@@ -0,0 +1,32 @@
+export type OpenGraph = {
+    title?: string;
+    description?: string;
+    type?: string;
+    url?: string;
+    image?: string;
+    siteName?: string;
+};
+export type TwitterCard = {
+    card?: string;
+    title?: string;
+    description?: string;
+    image?: string;
+    site?: string;
+    creator?: string;
+};
+export type HeadLink = {
+    rel: string;
+    href: string;
+};
+export type Head = {
+    title?: string;
+    description?: string;
+    canonical?: string;
+    og?: OpenGraph;
+    twitter?: TwitterCard;
+    noindex?: boolean;
+    links?: readonly HeadLink[];
+};
+export declare function renderHead(head: Head): string;
+export declare function weaveHead(html: string, head: Head): string;
+//# sourceMappingURL=head.d.ts.map

package/dist/head.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"head.d.ts","sourceRoot":"","sources":["../src/head.ts"],"names":[],"mappings":"AAeA,MAAM,MAAM,SAAS,GAAG;IACtB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IAGrB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF,MAAM,MAAM,WAAW,GAAG;IAExB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,CAAC;AAKF,MAAM,MAAM,QAAQ,GAAG;IACrB,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;CACd,CAAC;AAEF,MAAM,MAAM,IAAI,GAAG;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,EAAE,CAAC,EAAE,SAAS,CAAC;IACf,OAAO,CAAC,EAAE,WAAW,CAAC;IAItB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,KAAK,CAAC,EAAE,SAAS,QAAQ,EAAE,CAAC;CAC7B,CAAC;AAuBF,wBAAgB,UAAU,CAAC,IAAI,EAAE,IAAI,GAAG,MAAM,CAuC7C;AAKD,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,GAAG,MAAM,CAM1D"}

package/dist/head.js

@@ -0,0 +1,93 @@
+// Typed <head> contract (W270 §4). A render MAY return a `head` value on its
+// RenderResult; the prerenderer / SSG dispatch weaves it into the document
+// head at the same seam as the hydration tags. Consumers return structured
+// data — they never hand-assemble head markup or escape it themselves.
+//
+// Escaping lives HERE, one audited implementation, same posture as
+// `escapeJsonForScriptTag` (hydration.ts): all interpolated values are HTML-
+// escaped, attribute values additionally escape the quote that closes the
+// attribute. Meta keys (`og:title`, `twitter:card`, …) are framework-owned
+// literals and are never interpolated from consumer data.
+//
+// Also ported byte-for-byte into the deno_core SSG runtime shim at
+// `crates/mesofact-ssr/js/runtime_shim.js` — keep the two in lockstep so both
+// pipelines emit the same head bytes (same rule as the hydration helpers).
+// Escape a value destined for HTML text content (`<title>…`): the three
+// characters that can open a tag / entity. `&` first so we never double-encode
+// the escapes we introduce.
+function escapeHtmlText(value) {
+    return value.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;");
+}
+// Escape a value destined for a double-quoted attribute: text escaping plus
+// the closing quote.
+function escapeHtmlAttr(value) {
+    return escapeHtmlText(value).replace(/"/g, "&quot;");
+}
+// key is a framework-owned literal (og:title, twitter:card, …); only content
+// is consumer-supplied, so only content is escaped.
+function metaTag(attr, key, content) {
+    return `<meta ${attr}="${key}" content="${escapeHtmlAttr(content)}">`;
+}
+// Render a Head into the concatenated head-tag markup (no wrapping <head>).
+// Order is stable and deterministic so prerendered bytes are reproducible.
+export function renderHead(head) {
+    const tags = [];
+    if (head.title !== undefined)
+        tags.push(`<title>${escapeHtmlText(head.title)}</title>`);
+    if (head.description !== undefined)
+        tags.push(metaTag("name", "description", head.description));
+    if (head.canonical !== undefined) {
+        tags.push(`<link rel="canonical" href="${escapeHtmlAttr(head.canonical)}">`);
+    }
+    if (head.noindex)
+        tags.push(`<meta name="robots" content="noindex">`);
+    const og = head.og;
+    if (og) {
+        if (og.title !== undefined)
+            tags.push(metaTag("property", "og:title", og.title));
+        if (og.description !== undefined) {
+            tags.push(metaTag("property", "og:description", og.description));
+        }
+        if (og.type !== undefined)
+            tags.push(metaTag("property", "og:type", og.type));
+        if (og.url !== undefined)
+            tags.push(metaTag("property", "og:url", og.url));
+        if (og.image !== undefined)
+            tags.push(metaTag("property", "og:image", og.image));
+        if (og.siteName !== undefined)
+            tags.push(metaTag("property", "og:site_name", og.siteName));
+    }
+    const tw = head.twitter;
+    if (tw) {
+        if (tw.card !== undefined)
+            tags.push(metaTag("name", "twitter:card", tw.card));
+        if (tw.title !== undefined)
+            tags.push(metaTag("name", "twitter:title", tw.title));
+        if (tw.description !== undefined) {
+            tags.push(metaTag("name", "twitter:description", tw.description));
+        }
+        if (tw.image !== undefined)
+            tags.push(metaTag("name", "twitter:image", tw.image));
+        if (tw.site !== undefined)
+            tags.push(metaTag("name", "twitter:site", tw.site));
+        if (tw.creator !== undefined)
+            tags.push(metaTag("name", "twitter:creator", tw.creator));
+    }
+    for (const link of head.links ?? []) {
+        tags.push(`<link rel="${escapeHtmlAttr(link.rel)}" href="${escapeHtmlAttr(link.href)}">`);
+    }
+    return tags.join("");
+}
+// Weave a Head into a rendered document: inject the head markup immediately
+// before the last </head> (case-insensitive). A document without one gets the
+// markup prepended. A head that renders to nothing leaves the html untouched.
+export function weaveHead(html, head) {
+    const markup = renderHead(head);
+    if (markup === "")
+        return html;
+    const idx = html.toLowerCase().lastIndexOf("</head>");
+    if (idx === -1)
+        return markup + html;
+    return html.slice(0, idx) + markup + html.slice(idx);
+}
+//# sourceMappingURL=head.js.map

package/dist/head.js.map

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

package/dist/health.d.ts

@@ -0,0 +1,14 @@
+/** One named readiness condition. `check` should be fast and side-effect free —
+ *  probes run on the kubelet's schedule, per replica. */
+export type ReadyCheck = {
+    /** Operator-facing name in `?verbose` output. A noun (`db`, `cache`). */
+    name: string;
+    check: () => boolean | Promise<boolean>;
+};
+/** Build the Fetch handler for a `mode:"ssr"` `/readyz` route.
+ *
+ *  Every check runs, even after one fails: reporting only the first failure
+ *  hides a second broken subsystem behind the first. A check that throws counts
+ *  as failed — an exception is not an assertion of readiness. */
+export declare function defineReadyz(checks: readonly ReadyCheck[]): (req: Request) => Promise<Response>;
+//# sourceMappingURL=health.d.ts.map

package/dist/health.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"health.d.ts","sourceRoot":"","sources":["../src/health.ts"],"names":[],"mappings":"AAsCA;yDACyD;AACzD,MAAM,MAAM,UAAU,GAAG;IACvB,yEAAyE;IACzE,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;CACzC,CAAC;AAEF;;;;iEAIiE;AACjE,wBAAgB,YAAY,CAC1B,MAAM,EAAE,SAAS,UAAU,EAAE,GAC5B,CAAC,GAAG,EAAE,OAAO,KAAK,OAAO,CAAC,QAAQ,CAAC,CAkCrC"}

package/dist/health.js

@@ -0,0 +1,85 @@
+// `defineReadyz` — the TSX half of mesofact's `/readyz` probe.
+//
+// mesofact serves `/livez` and `/readyz` itself, in Rust
+// (`crates/mesofact/src/health.rs`), gated on the things only the engine can
+// know: is the SSR isolate up, is there a tree to serve, are we draining. An
+// app opts into contributing its own readiness by declaring the path as an
+// ordinary SSR route — there is no config key and no manifest field:
+//
+//   // mesofact.routes.ts
+//   { route: "/readyz", mode: "ssr", entrypoint: "src/readyz.ts", cache_policy: { ttl: 0 } }
+//
+// The Rust handler notices the app claimed the path, dispatches to it while
+// answering the probe, and folds the response status into its own listing as a
+// check named `app`. Anything outside 2xx takes the pod out of rotation.
+//
+// # The contract, and its one asymmetry
+//
+// An app verdict is **additive**: it can only make the process less ready. A
+// 200 from here cannot un-drain a terminating process or overrule a dead
+// isolate, because those are exactly the states in which app code is the
+// unreliable narrator. Design your checks accordingly — this is the place to
+// say "my database pool is exhausted", not "ignore the engine, I'm fine".
+//
+// # Vanilla, or this helper
+//
+// The route is a plain Fetch handler, so vanilla works and owes nothing to this
+// module:
+//
+//   export default async () =>
+//     (await db.ping()) ? new Response("ok") : new Response("db", { status: 503 });
+//
+// `defineReadyz` is the opt-in ergonomic layer: it runs named checks and emits
+// the *same* wire format the Rust side emits — the kube-apiserver `[+]name ok`
+// listing under `?verbose`. Matching formats is the point. An operator running
+// `curl localhost:3000/readyz?verbose` should not be able to tell which
+// language answered, and when the Rust side aggregates, the two listings nest
+// instead of clashing.
+/** Build the Fetch handler for a `mode:"ssr"` `/readyz` route.
+ *
+ *  Every check runs, even after one fails: reporting only the first failure
+ *  hides a second broken subsystem behind the first. A check that throws counts
+ *  as failed — an exception is not an assertion of readiness. */
+export function defineReadyz(checks) {
+    return async (req) => {
+        const results = await Promise.all(checks.map(async (c) => {
+            try {
+                return { name: c.name, pass: (await c.check()) === true };
+            }
+            catch {
+                return { name: c.name, pass: false };
+            }
+        }));
+        const ok = results.every((r) => r.pass);
+        const status = ok ? 200 : 503;
+        const headers = {
+            "content-type": "text/plain; charset=utf-8",
+            // A cached 200 outlives the condition it described, which is the exact
+            // failure the probe exists to catch.
+            "cache-control": "no-cache, no-store, must-revalidate",
+        };
+        if (!isVerbose(req)) {
+            return new Response(ok ? "ok\n" : "readyz check failed\n", {
+                status,
+                headers,
+            });
+        }
+        const listing = results
+            .map((r) => (r.pass ? `[+]${r.name} ok\n` : `[-]${r.name} failed\n`))
+            .join("");
+        const trailer = ok ? "readyz check passed\n" : "readyz check failed\n";
+        return new Response(listing + trailer, { status, headers });
+    };
+}
+/** `?verbose` / `?verbose=1`, matching the Rust `is_verbose`. A malformed URL
+ *  means the non-verbose body, never a crash — a probe that 500s because it
+ *  could not parse its own URL is worse than one that answers tersely. */
+function isVerbose(req) {
+    try {
+        return new URL(req.url).searchParams.has("verbose");
+    }
+    catch {
+        return false;
+    }
+}
+//# sourceMappingURL=health.js.map

package/dist/health.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"health.js","sourceRoot":"","sources":["../src/health.ts"],"names":[],"mappings":"AAAA,+DAA+D;AAC/D,EAAE;AACF,yDAAyD;AACzD,6EAA6E;AAC7E,6EAA6E;AAC7E,2EAA2E;AAC3E,qEAAqE;AACrE,EAAE;AACF,0BAA0B;AAC1B,6FAA6F;AAC7F,EAAE;AACF,4EAA4E;AAC5E,+EAA+E;AAC/E,yEAAyE;AACzE,EAAE;AACF,wCAAwC;AACxC,EAAE;AACF,6EAA6E;AAC7E,yEAAyE;AACzE,yEAAyE;AACzE,6EAA6E;AAC7E,0EAA0E;AAC1E,EAAE;AACF,4BAA4B;AAC5B,EAAE;AACF,gFAAgF;AAChF,UAAU;AACV,EAAE;AACF,+BAA+B;AAC/B,oFAAoF;AACpF,EAAE;AACF,+EAA+E;AAC/E,+EAA+E;AAC/E,+EAA+E;AAC/E,wEAAwE;AACxE,8EAA8E;AAC9E,uBAAuB;AAUvB;;;;iEAIiE;AACjE,MAAM,UAAU,YAAY,CAC1B,MAA6B;IAE7B,OAAO,KAAK,EAAE,GAAY,EAAqB,EAAE;QAC/C,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,GAAG,CAC/B,MAAM,CAAC,GAAG,CAAC,KAAK,EAAE,CAAC,EAAE,EAAE;YACrB,IAAI,CAAC;gBACH,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,CAAC,KAAK,IAAI,EAAE,CAAC;YAC5D,CAAC;YAAC,MAAM,CAAC;gBACP,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC;YACvC,CAAC;QACH,CAAC,CAAC,CACH,CAAC;QAEF,MAAM,EAAE,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;QACxC,MAAM,MAAM,GAAG,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC;QAC9B,MAAM,OAAO,GAAG;YACd,cAAc,EAAE,2BAA2B;YAC3C,uEAAuE;YACvE,qCAAqC;YACrC,eAAe,EAAE,qCAAqC;SACvD,CAAC;QAEF,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,EAAE,CAAC;YACpB,OAAO,IAAI,QAAQ,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,uBAAuB,EAAE;gBACzD,MAAM;gBACN,OAAO;aACR,CAAC,CAAC;QACL,CAAC;QAED,MAAM,OAAO,GAAG,OAAO;aACpB,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,IAAI,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,IAAI,WAAW,CAAC,CAAC;aACpE,IAAI,CAAC,EAAE,CAAC,CAAC;QACZ,MAAM,OAAO,GAAG,EAAE,CAAC,CAAC,CAAC,uBAAuB,CAAC,CAAC,CAAC,uBAAuB,CAAC;QACvE,OAAO,IAAI,QAAQ,CAAC,OAAO,GAAG,OAAO,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,CAAC;IAC9D,CAAC,CAAC;AACJ,CAAC;AAED;;0EAE0E;AAC1E,SAAS,SAAS,CAAC,GAAY;IAC7B,IAAI,CAAC;QACH,OAAO,IAAI,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,YAAY,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;IACtD,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC"}

package/dist/hooks.d.ts

@@ -0,0 +1,28 @@
+/** Every hook name the engine knows how to invoke.
+ *
+ *  `readyz` is the one hook that predates this declaration site, so it has two
+ *  ways in (see {@link HOOK_ROUTE_CLAIMS}) and its module's contract is a
+ *  Fetch handler rather than a plain Mode 2 function. Hooks added from here on
+ *  are `(input) => verdict`. */
+export declare const HOOK_NAMES: readonly ["readyz"];
+export type HookName = (typeof HOOK_NAMES)[number];
+/** The `hooks` block of `defineRoutes` — hook name → entrypoint path, relative
+ *  to the project root, bundled to `dist/server/hooks/<name>.js`. */
+export type HooksConfig = {
+    readonly [K in HookName]?: string;
+};
+/** Hooks that may *alternatively* be declared by claiming a route, which is
+ *  how `/readyz` shipped (R756-F5) before hooks existed.
+ *
+ *  Route-claiming still works and is still the shortest path for an app that
+ *  wants its readiness handler reachable as an ordinary Fetch handler. The
+ *  `hooks` declaration is the better one for everything else: the module is
+ *  not a route, so it never enters `ssr_prefixes`, is never forwarded to the
+ *  SSR origin by the edge Worker, and is never shadowed by the Rust probe
+ *  route it would otherwise collide with. Declaring both is rejected — two
+ *  opt-ins for one verdict is ambiguous, not additive. */
+export declare const HOOK_ROUTE_CLAIMS: {
+    readonly [K in HookName]?: string;
+};
+export declare function isHookName(name: string): name is HookName;
+//# sourceMappingURL=hooks.d.ts.map

package/dist/hooks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hooks.d.ts","sourceRoot":"","sources":["../src/hooks.ts"],"names":[],"mappings":"AAyCA;;;;;gCAKgC;AAChC,eAAO,MAAM,UAAU,qBAAsB,CAAC;AAE9C,MAAM,MAAM,QAAQ,GAAG,CAAC,OAAO,UAAU,CAAC,CAAC,MAAM,CAAC,CAAC;AAEnD;qEACqE;AACrE,MAAM,MAAM,WAAW,GAAG;IAAE,QAAQ,EAAE,CAAC,IAAI,QAAQ,CAAC,CAAC,EAAE,MAAM;CAAE,CAAC;AAEhE;;;;;;;;;0DAS0D;AAC1D,eAAO,MAAM,iBAAiB,EAAE;IAAE,QAAQ,EAAE,CAAC,IAAI,QAAQ,CAAC,CAAC,EAAE,MAAM;CAElE,CAAC;AAEF,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,IAAI,QAAQ,CAEzD"}

package/dist/hooks.js

@@ -0,0 +1,64 @@
+// Mode 2 hook declaration — W311 §2 "Open Decision 1", answered by R756-F6.
+//
+// # What a hook is
+//
+// mesofact's TSX override surface has two modes (W311 §2). Mode 1 is the
+// general API: `mode:"ssr"` route, `Request -> Response`, the app owns the
+// wire. Mode 2 is the endpoint callback: a small `input -> verdict`, and
+// **Rust** owns the HTTP. R756-F3 shipped Mode 2's wire verb
+// (`__mesofact_ssr.invoke(bundle, hookName, input)`) but hardcoded its single
+// hook name, because `/readyz` — Mode 2's only consumer — could reuse the
+// route-claim opt-in it already had. A hook that is *not* a path (`onRequest`,
+// `onError`, an auth gate) has no route to claim, so it needs a declaration
+// site. This is that site.
+//
+// # Why a top-level `hooks` key, and not a per-route `middleware` field
+//
+// W311 named two candidates and deliberately picked neither. The `hooks` key
+// wins on the doc's own terms:
+//
+//   - A per-route `middleware` field is a *chain*, and "a general TS
+//     middleware chain" is an explicit W311 non-goal — it has ordering
+//     semantics (what runs before what, who may short-circuit, how errors
+//     propagate) that Mode 2 does not have and does not want.
+//   - Mode 2's defining property is that Rust owns the HTTP. A hook is
+//     therefore engine-addressed — the engine decides when to call `readyz`,
+//     not a route table — so the declaration belongs beside `routes`, not
+//     inside one.
+//   - Hook names are a **closed set** for the same reason: only the engine
+//     invokes a hook, so a name the engine does not know is dead code and a
+//     silent typo. Adding one is three deliberate edits — a name here, an
+//     adapter in `crates/mesofact-ssr/js/ssr_harness.js`, and the Rust call
+//     site that decides when it runs — and each is a real contract statement.
+//
+// # Adding a hook
+//
+// Add the name to `HOOK_NAMES`, teach `ssr_harness.js` how to call it (the
+// default is plain Mode 2 — `(input) => verdict`, JSON both ways), and write
+// the Rust call site. `hooks` in the manifest carries name → bundled module;
+// `mesofact::ssr::spawn` registers each one on every isolate in the pool and
+// `SsrChild::invoke_hook(name, input)` calls it.
+/** Every hook name the engine knows how to invoke.
+ *
+ *  `readyz` is the one hook that predates this declaration site, so it has two
+ *  ways in (see {@link HOOK_ROUTE_CLAIMS}) and its module's contract is a
+ *  Fetch handler rather than a plain Mode 2 function. Hooks added from here on
+ *  are `(input) => verdict`. */
+export const HOOK_NAMES = ["readyz"];
+/** Hooks that may *alternatively* be declared by claiming a route, which is
+ *  how `/readyz` shipped (R756-F5) before hooks existed.
+ *
+ *  Route-claiming still works and is still the shortest path for an app that
+ *  wants its readiness handler reachable as an ordinary Fetch handler. The
+ *  `hooks` declaration is the better one for everything else: the module is
+ *  not a route, so it never enters `ssr_prefixes`, is never forwarded to the
+ *  SSR origin by the edge Worker, and is never shadowed by the Rust probe
+ *  route it would otherwise collide with. Declaring both is rejected — two
+ *  opt-ins for one verdict is ambiguous, not additive. */
+export const HOOK_ROUTE_CLAIMS = {
+    readyz: "/readyz",
+};
+export function isHookName(name) {
+    return HOOK_NAMES.includes(name);
+}
+//# sourceMappingURL=hooks.js.map

package/dist/hooks.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hooks.js","sourceRoot":"","sources":["../src/hooks.ts"],"names":[],"mappings":"AAAA,4EAA4E;AAC5E,EAAE;AACF,mBAAmB;AACnB,EAAE;AACF,yEAAyE;AACzE,2EAA2E;AAC3E,yEAAyE;AACzE,6DAA6D;AAC7D,8EAA8E;AAC9E,0EAA0E;AAC1E,+EAA+E;AAC/E,4EAA4E;AAC5E,2BAA2B;AAC3B,EAAE;AACF,wEAAwE;AACxE,EAAE;AACF,6EAA6E;AAC7E,+BAA+B;AAC/B,EAAE;AACF,qEAAqE;AACrE,uEAAuE;AACvE,0EAA0E;AAC1E,8DAA8D;AAC9D,uEAAuE;AACvE,6EAA6E;AAC7E,0EAA0E;AAC1E,kBAAkB;AAClB,2EAA2E;AAC3E,4EAA4E;AAC5E,0EAA0E;AAC1E,4EAA4E;AAC5E,8EAA8E;AAC9E,EAAE;AACF,kBAAkB;AAClB,EAAE;AACF,2EAA2E;AAC3E,6EAA6E;AAC7E,6EAA6E;AAC7E,6EAA6E;AAC7E,iDAAiD;AAEjD;;;;;gCAKgC;AAChC,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,QAAQ,CAAU,CAAC;AAQ9C;;;;;;;;;0DAS0D;AAC1D,MAAM,CAAC,MAAM,iBAAiB,GAA0C;IACtE,MAAM,EAAE,SAAS;CAClB,CAAC;AAEF,MAAM,UAAU,UAAU,CAAC,IAAY;IACrC,OAAQ,UAAgC,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;AAC1D,CAAC"}

package/dist/hydration.d.ts

@@ -0,0 +1,6 @@
+export declare const SPA_STATE_SCRIPT_ID: "__MESOFACT_STATE__";
+export declare const SSR_DATA_SCRIPT_ID: "__mesofact_data__";
+export declare function escapeJsonForScriptTag(value: unknown): string;
+export declare function hydrationDataTag(data: unknown): string;
+export declare function hydrationScriptTag(src: string): string;
+//# sourceMappingURL=hydration.d.ts.map

package/dist/hydration.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hydration.d.ts","sourceRoot":"","sources":["../src/hydration.ts"],"names":[],"mappings":"AAoBA,eAAO,MAAM,mBAAmB,EAAG,oBAA6B,CAAC;AAKjE,eAAO,MAAM,kBAAkB,EAAG,mBAA4B,CAAC;AAY/D,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAiB7D;AAKD,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,OAAO,GAAG,MAAM,CAEtD;AAOD,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAGtD"}

package/dist/hydration.js

@@ -0,0 +1,68 @@
+// Hydration handoff — helpers an SSR route's Fetch handler calls to inline
+// server-resolved data into the response body for the client to read on
+// mount. Disposable when RSC streaming lands; until then this is the
+// Universal cell's contract (W173 § "Hydration handoff").
+//
+// API surface is intentionally minimal — two pure functions. The handler
+// composes them into its own HTML response, which means the consumer keeps
+// full control over the document shell. The trade-off is that the consumer
+// has to know its own build_id + hashed client-script name (read from the
+// manifest at boot, or inject via env). Acceptable for the dogfood window;
+// revisit when more consumers exist.
+//
+// Also published standalone as the `@mesofact/runtime/hydration` subpath
+// export (R513-B11): this file must stay free of imports (or only import
+// other import-free, browser-safe modules) so a client bundle can read
+// `SPA_STATE_SCRIPT_ID` without dragging in the `@mesofact/runtime` barrel,
+// which re-exports server-only code (`track-ctx.ts` → `node:async_hooks`,
+// `config.ts` → `node:fs`) that rolldown can't tree-shake past.
+// Build-time SPA shell consumes this id; the prerender weaves it in.
+export const SPA_STATE_SCRIPT_ID = "__MESOFACT_STATE__";
+// Per-request SSR Universal handoff consumes this id; see W173 § "Hydration
+// handoff" — the name is fixed (not configurable) so the client snippet can
+// be copy-pasteable across consumers.
+export const SSR_DATA_SCRIPT_ID = "__mesofact_data__";
+// JSON-encode `value` and escape the characters that could close the parent
+// `<script>` tag early or be reinterpreted by the HTML parser:
+//
+//   `<`, `>`, `&`         — `</script>`, `<!--`, `<![CDATA[`, `&amp;` injection
+//   U+2028 / U+2029       — JS line separators valid in JSON but break inline
+//                           scripts when not escaped
+//
+// `JSON.parse` decodes the `\uXXXX` escapes transparently, so the client
+// reads back the original value via `JSON.parse(el.textContent)` with no
+// special handling. Non-negotiable per W173 § "XSS escape rule".
+export function escapeJsonForScriptTag(value) {
+    return JSON.stringify(value).replace(/[<>&\u2028\u2029]/g, (c) => {
+        switch (c) {
+            case "<":
+                return "\\u003c";
+            case ">":
+                return "\\u003e";
+            case "&":
+                return "\\u0026";
+            case "\u2028":
+                return "\\u2028";
+            case "\u2029":
+                return "\\u2029";
+            default:
+                return c;
+        }
+    });
+}
+// Serialize `data` into the data-handoff `<script>` tag an SSR route's
+// Fetch handler inlines into its response body. Read back on the client via
+// `JSON.parse(document.getElementById("__mesofact_data__").textContent)`.
+export function hydrationDataTag(data) {
+    return `<script id="${SSR_DATA_SCRIPT_ID}" type="application/json">${escapeJsonForScriptTag(data)}</script>`;
+}
+// Build the module-script tag that loads the route's hydrate bundle. `src`
+// is escaped against `"`, `<`, and `&` so a manifest-derived URL containing
+// a stray quote can't break the attribute or the tag boundary; belt-and-
+// braces — the manifest paths the build emits don't contain quotes, but
+// consumers may compose paths from request data.
+export function hydrationScriptTag(src) {
+    const safeSrc = src.replace(/&/g, "&amp;").replace(/"/g, "&quot;").replace(/</g, "&lt;");
+    return `<script type="module" src="${safeSrc}"></script>`;
+}
+//# sourceMappingURL=hydration.js.map

package/dist/hydration.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hydration.js","sourceRoot":"","sources":["../src/hydration.ts"],"names":[],"mappings":"AAAA,2EAA2E;AAC3E,wEAAwE;AACxE,qEAAqE;AACrE,0DAA0D;AAC1D,EAAE;AACF,yEAAyE;AACzE,2EAA2E;AAC3E,2EAA2E;AAC3E,0EAA0E;AAC1E,2EAA2E;AAC3E,qCAAqC;AACrC,EAAE;AACF,yEAAyE;AACzE,yEAAyE;AACzE,uEAAuE;AACvE,4EAA4E;AAC5E,0EAA0E;AAC1E,gEAAgE;AAEhE,qEAAqE;AACrE,MAAM,CAAC,MAAM,mBAAmB,GAAG,oBAA6B,CAAC;AAEjE,4EAA4E;AAC5E,4EAA4E;AAC5E,sCAAsC;AACtC,MAAM,CAAC,MAAM,kBAAkB,GAAG,mBAA4B,CAAC;AAE/D,4EAA4E;AAC5E,+DAA+D;AAC/D,EAAE;AACF,gFAAgF;AAChF,8EAA8E;AAC9E,qDAAqD;AACrD,EAAE;AACF,yEAAyE;AACzE,yEAAyE;AACzE,iEAAiE;AACjE,MAAM,UAAU,sBAAsB,CAAC,KAAc;IACnD,OAAO,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,OAAO,CAAC,oBAAoB,EAAE,CAAC,CAAC,EAAE,EAAE;QAC/D,QAAQ,CAAC,EAAE,CAAC;YACV,KAAK,GAAG;gBACN,OAAO,SAAS,CAAC;YACnB,KAAK,GAAG;gBACN,OAAO,SAAS,CAAC;YACnB,KAAK,GAAG;gBACN,OAAO,SAAS,CAAC;YACnB,KAAK,QAAQ;gBACX,OAAO,SAAS,CAAC;YACnB,KAAK,QAAQ;gBACX,OAAO,SAAS,CAAC;YACnB;gBACE,OAAO,CAAC,CAAC;QACb,CAAC;IACH,CAAC,CAAC,CAAC;AACL,CAAC;AAED,uEAAuE;AACvE,4EAA4E;AAC5E,0EAA0E;AAC1E,MAAM,UAAU,gBAAgB,CAAC,IAAa;IAC5C,OAAO,eAAe,kBAAkB,6BAA6B,sBAAsB,CAAC,IAAI,CAAC,WAAW,CAAC;AAC/G,CAAC;AAED,2EAA2E;AAC3E,4EAA4E;AAC5E,yEAAyE;AACzE,wEAAwE;AACxE,iDAAiD;AACjD,MAAM,UAAU,kBAAkB,CAAC,GAAW;IAC5C,MAAM,OAAO,GAAG,GAAG,CAAC,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IACzF,OAAO,8BAA8B,OAAO,aAAa,CAAC;AAC5D,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,26 @@
+export type { Region, User, Project, RenderRequest, CachePolicy, Hydration, RenderResult, RenderFn, } from "./contract.js";
+export type { ListOpts, R2Object, Source, BlobSource, KeyValueSource, } from "./source.js";
+export { BaseSource } from "./source.js";
+export { SourceError, SourceUnavailableError, SourceTimeoutError, SourceQueryError, RowNotFoundError, } from "./errors.js";
+export type { RouteMode, Placement, Requires, CachePolicyConfig, PrerenderConfig, RouteEntry, ErrorRoutes, RoutesConfig, RetryOn, RetryPolicy, QueuePolicy, ResiliencePolicy, } from "./routes.js";
+export { defineRoutes, DEFAULT_RESILIENCE_TIMEOUT_MS } from "./routes.js";
+export type { HookName, HooksConfig } from "./hooks.js";
+export { HOOK_NAMES, HOOK_ROUTE_CLAIMS, isHookName } from "./hooks.js";
+export type { ManifestVersion, ManifestCachePolicy, ManifestHydration, ManifestPrerender, ManifestRoute, ManifestStaticAsset, ManifestErrorRoutes, ManifestHook, ManifestHooks, Manifest, ResolvedPlacement, } from "./manifest.js";
+export { MANIFEST_VERSION } from "./manifest.js";
+export type { SourceScope, SourceCatalog, ValidationError, ValidationErrorKind, ValidationResult, } from "./validate.js";
+export { validate } from "./validate.js";
+export { runInTrackCtx, currentTrackCtx } from "./track-ctx.js";
+export type { TrackCtx } from "./track-ctx.js";
+export { SPA_STATE_SCRIPT_ID, SSR_DATA_SCRIPT_ID, escapeJsonForScriptTag, hydrationDataTag, hydrationScriptTag, } from "./hydration.js";
+export type { OpenGraph, TwitterCard, HeadLink, Head } from "./head.js";
+export { renderHead, weaveHead } from "./head.js";
+export { defineReadyz } from "./health.js";
+export type { ReadyCheck } from "./health.js";
+export { R2Adapter, r2, registerR2, clearR2Registry } from "./adapters/r2.js";
+export type { R2Config } from "./adapters/r2.js";
+export { SqliteAdapter, sqlite, registerSqlite, clearSqliteRegistry } from "./adapters/sqlite.js";
+export type { SqliteConfig, SqliteRunner } from "./adapters/sqlite.js";
+export { loadConfig, parseConfig, registerSourcesFromConfig, ConfigError, } from "./config.js";
+export type { BuildConfig, MesofactConfig, R2SourceConfig, SqliteSourceConfig, SourceConfig, } from "./config.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAGA,YAAY,EACV,MAAM,EACN,IAAI,EACJ,OAAO,EACP,aAAa,EACb,WAAW,EACX,SAAS,EACT,YAAY,EACZ,QAAQ,GACT,MAAM,eAAe,CAAC;AAEvB,YAAY,EACV,QAAQ,EACR,QAAQ,EACR,MAAM,EACN,UAAU,EACV,cAAc,GACf,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAEzC,OAAO,EACL,WAAW,EACX,sBAAsB,EACtB,kBAAkB,EAClB,gBAAgB,EAChB,gBAAgB,GACjB,MAAM,aAAa,CAAC;AAErB,YAAY,EACV,SAAS,EACT,SAAS,EACT,QAAQ,EACR,iBAAiB,EACjB,eAAe,EACf,UAAU,EACV,WAAW,EACX,YAAY,EACZ,OAAO,EACP,WAAW,EACX,WAAW,EACX,gBAAgB,GACjB,MAAM,aAAa,CAAC;AAErB,OAAO,EAAE,YAAY,EAAE,6BAA6B,EAAE,MAAM,aAAa,CAAC;AAE1E,YAAY,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AACxD,OAAO,EAAE,UAAU,EAAE,iBAAiB,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAEvE,YAAY,EACV,eAAe,EACf,mBAAmB,EACnB,iBAAiB,EACjB,iBAAiB,EACjB,aAAa,EACb,mBAAmB,EACnB,mBAAmB,EACnB,YAAY,EACZ,aAAa,EACb,QAAQ,EACR,iBAAiB,GAClB,MAAM,eAAe,CAAC;AAEvB,OAAO,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAEjD,YAAY,EACV,WAAW,EACX,aAAa,EACb,eAAe,EACf,mBAAmB,EACnB,gBAAgB,GACjB,MAAM,eAAe,CAAC;AAEvB,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAEzC,OAAO,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAChE,YAAY,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAE/C,OAAO,EACL,mBAAmB,EACnB,kBAAkB,EAClB,sBAAsB,EACtB,gBAAgB,EAChB,kBAAkB,GACnB,MAAM,gBAAgB,CAAC;AAExB,YAAY,EAAE,SAAS,EAAE,WAAW,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACxE,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAElD,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,YAAY,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAE9C,OAAO,EAAE,SAAS,EAAE,EAAE,EAAE,UAAU,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAC9E,YAAY,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAEjD,OAAO,EAAE,aAAa,EAAE,MAAM,EAAE,cAAc,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAClG,YAAY,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAEvE,OAAO,EACL,UAAU,EACV,WAAW,EACX,yBAAyB,EACzB,WAAW,GACZ,MAAM,aAAa,CAAC;AACrB,YAAY,EACV,WAAW,EACX,cAAc,EACd,cAAc,EACd,kBAAkB,EAClB,YAAY,GACb,MAAM,aAAa,CAAC"}

package/dist/index.js

@@ -0,0 +1,16 @@
+// @mesofact/runtime — render contract types and adapter API.
+// See `.yah/docs/architecture/mesofact.md`.
+export { BaseSource } from "./source.js";
+export { SourceError, SourceUnavailableError, SourceTimeoutError, SourceQueryError, RowNotFoundError, } from "./errors.js";
+export { defineRoutes, DEFAULT_RESILIENCE_TIMEOUT_MS } from "./routes.js";
+export { HOOK_NAMES, HOOK_ROUTE_CLAIMS, isHookName } from "./hooks.js";
+export { MANIFEST_VERSION } from "./manifest.js";
+export { validate } from "./validate.js";
+export { runInTrackCtx, currentTrackCtx } from "./track-ctx.js";
+export { SPA_STATE_SCRIPT_ID, SSR_DATA_SCRIPT_ID, escapeJsonForScriptTag, hydrationDataTag, hydrationScriptTag, } from "./hydration.js";
+export { renderHead, weaveHead } from "./head.js";
+export { defineReadyz } from "./health.js";
+export { R2Adapter, r2, registerR2, clearR2Registry } from "./adapters/r2.js";
+export { SqliteAdapter, sqlite, registerSqlite, clearSqliteRegistry } from "./adapters/sqlite.js";
+export { loadConfig, parseConfig, registerSourcesFromConfig, ConfigError, } from "./config.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,6DAA6D;AAC7D,4CAA4C;AAoB5C,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAEzC,OAAO,EACL,WAAW,EACX,sBAAsB,EACtB,kBAAkB,EAClB,gBAAgB,EAChB,gBAAgB,GACjB,MAAM,aAAa,CAAC;AAiBrB,OAAO,EAAE,YAAY,EAAE,6BAA6B,EAAE,MAAM,aAAa,CAAC;AAG1E,OAAO,EAAE,UAAU,EAAE,iBAAiB,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAgBvE,OAAO,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAUjD,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAEzC,OAAO,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAGhE,OAAO,EACL,mBAAmB,EACnB,kBAAkB,EAClB,sBAAsB,EACtB,gBAAgB,EAChB,kBAAkB,GACnB,MAAM,gBAAgB,CAAC;AAGxB,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAElD,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAG3C,OAAO,EAAE,SAAS,EAAE,EAAE,EAAE,UAAU,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAG9E,OAAO,EAAE,aAAa,EAAE,MAAM,EAAE,cAAc,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAGlG,OAAO,EACL,UAAU,EACV,WAAW,EACX,yBAAyB,EACzB,WAAW,GACZ,MAAM,aAAa,CAAC"}

package/dist/manifest.d.ts

@@ -0,0 +1,68 @@
+import type { HookName } from "./hooks.js";
+import type { Placement, ResiliencePolicy, RouteMode, Requires } from "./routes.js";
+export type ResolvedPlacement = Exclude<Placement, "auto">;
+export declare const MANIFEST_VERSION: "1";
+export type ManifestVersion = typeof MANIFEST_VERSION;
+export type ManifestCachePolicy = {
+    ttl: number;
+    swr?: number;
+    negative_ttl?: number;
+    vary?: readonly string[];
+};
+export type ManifestHydration = {
+    script: string;
+    code_split: readonly string[];
+};
+export type ManifestPrerender = {
+    params: ReadonlyArray<Record<string, string>>;
+} | {
+    from: string;
+    query: string;
+    param: string;
+} | {
+    from_data: string;
+    items_key: string;
+    param: string;
+} | {
+    deferred: true;
+};
+export type ManifestRoute = {
+    route: string;
+    mode: RouteMode;
+    render_entrypoint: string;
+    requires?: readonly Requires[];
+    source_reads?: readonly string[];
+    data_inputs?: readonly string[];
+    cache_policy: ManifestCachePolicy;
+    concurrency?: number;
+    hydration?: ManifestHydration;
+    prerender?: ManifestPrerender;
+    placement?: ResolvedPlacement;
+    resilience?: ResiliencePolicy;
+};
+export type ManifestStaticAsset = {
+    key: string;
+    content_hash: string;
+    content_type: string;
+    immutable: boolean;
+};
+export type ManifestErrorRoutes = {
+    "404"?: string;
+    "5xx"?: string;
+};
+export type ManifestHook = {
+    entrypoint: string;
+};
+export type ManifestHooks = {
+    readonly [K in HookName]?: ManifestHook;
+};
+export type Manifest = {
+    version: ManifestVersion;
+    build_id: string;
+    routes: readonly ManifestRoute[];
+    static_assets: readonly ManifestStaticAsset[];
+    error_routes?: ManifestErrorRoutes;
+    hooks?: ManifestHooks;
+    ssr_prefixes?: readonly string[];
+};
+//# sourceMappingURL=manifest.d.ts.map

package/dist/manifest.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"manifest.d.ts","sourceRoot":"","sources":["../src/manifest.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAC3C,OAAO,KAAK,EAAE,SAAS,EAAE,gBAAgB,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAKpF,MAAM,MAAM,iBAAiB,GAAG,OAAO,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC;AAE3D,eAAO,MAAM,gBAAgB,EAAG,GAAY,CAAC;AAE7C,MAAM,MAAM,eAAe,GAAG,OAAO,gBAAgB,CAAC;AAEtD,MAAM,MAAM,mBAAmB,GAAG;IAChC,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,IAAI,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CAC1B,CAAC;AAEF,MAAM,MAAM,iBAAiB,GAAG;IAC9B,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,SAAS,MAAM,EAAE,CAAC;CAC/B,CAAC;AAEF,MAAM,MAAM,iBAAiB,GACzB;IAAE,MAAM,EAAE,aAAa,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAA;CAAE,GACjD;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GAC9C;IAAE,SAAS,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GAKvD;IAAE,QAAQ,EAAE,IAAI,CAAA;CAAE,CAAC;AAEvB,MAAM,MAAM,aAAa,GAAG;IAC1B,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,SAAS,CAAC;IAChB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,EAAE,SAAS,QAAQ,EAAE,CAAC;IAC/B,YAAY,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAIjC,WAAW,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAChC,YAAY,EAAE,mBAAmB,CAAC;IAClC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,iBAAiB,CAAC;IAC9B,SAAS,CAAC,EAAE,iBAAiB,CAAC;IAE9B,SAAS,CAAC,EAAE,iBAAiB,CAAC;IAK9B,UAAU,CAAC,EAAE,gBAAgB,CAAC;CAC/B,CAAC;AAEF,MAAM,MAAM,mBAAmB,GAAG;IAChC,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,OAAO,CAAC;CACpB,CAAC;AAEF,MAAM,MAAM,mBAAmB,GAAG;IAChC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,CAAC;AAKF,MAAM,MAAM,YAAY,GAAG;IAGzB,UAAU,EAAE,MAAM,CAAC;CACpB,CAAC;AAEF,MAAM,MAAM,aAAa,GAAG;IAAE,QAAQ,EAAE,CAAC,IAAI,QAAQ,CAAC,CAAC,EAAE,YAAY;CAAE,CAAC;AAExE,MAAM,MAAM,QAAQ,GAAG;IACrB,OAAO,EAAE,eAAe,CAAC;IACzB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,SAAS,aAAa,EAAE,CAAC;IACjC,aAAa,EAAE,SAAS,mBAAmB,EAAE,CAAC;IAC9C,YAAY,CAAC,EAAE,mBAAmB,CAAC;IAInC,KAAK,CAAC,EAAE,aAAa,CAAC;IAKtB,YAAY,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CAClC,CAAC"}

package/dist/manifest.js

@@ -0,0 +1,9 @@
+// Manifest types — the single document the build emits and the proxy boots
+// from. Authored shape lives in `routes.ts` (RoutesConfig); the build enriches
+// it with `build_id`, `static_assets`, hydration, and resolved entrypoint
+// paths.
+//
+// Versioned independently of the mesofact binary; major bumps force restart.
+// See `.yah/docs/architecture/mesofact.md` §"Manifest schema".
+export const MANIFEST_VERSION = "1";
+//# sourceMappingURL=manifest.js.map

package/dist/manifest.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"manifest.js","sourceRoot":"","sources":["../src/manifest.ts"],"names":[],"mappings":"AAAA,2EAA2E;AAC3E,+EAA+E;AAC/E,0EAA0E;AAC1E,SAAS;AACT,EAAE;AACF,6EAA6E;AAC7E,+DAA+D;AAU/D,MAAM,CAAC,MAAM,gBAAgB,GAAG,GAAY,CAAC"}