@plumix/core 0.1.0

package/dist/base-path.js

@@ -0,0 +1,57 @@
+/**
+ * Base-path algebra for serving a plumix site under a subdirectory
+ * (`example.com/custom-directory/*`). Three pure helpers mirror the model
+ * the major frameworks settled on: normalize once at config load, strip once
+ * on the inbound request before routing, prepend on every outbound URL.
+ *
+ * The empty string is the root deployment (today's behavior) and every helper
+ * treats it as a no-op, so an unconfigured site is byte-for-byte unchanged.
+ */
+/**
+ * Canonicalize an operator-supplied base path: `""` for a root deployment,
+ * otherwise a leading-slash, no-trailing-slash, single-slash-separated prefix.
+ * Lenient by design (`docs`, `/docs/`, `/a//b` all normalize) so a small
+ * config typo doesn't 404 the whole site.
+ */
+export function normalizeBasePath(input) {
+    if (input === undefined)
+        return "";
+    const segments = input.split("/").filter((part) => part.trim().length > 0);
+    if (segments.length === 0)
+        return "";
+    return "/" + segments.map((part) => part.trim()).join("/");
+}
+/**
+ * Remove the base prefix from an inbound pathname so the rest of the router
+ * matches against root-relative paths unchanged. Returns the remainder (always
+ * leading-slash; the bare base maps to `/`) or `null` when the request isn't
+ * under the base, which the caller turns into a 404.
+ *
+ * A root base (`""`) is a pure pass-through — the path is returned verbatim so
+ * an unconfigured deployment behaves exactly as before. When a base IS set,
+ * duplicate leading slashes are collapsed first so `//docs/admin` can't dodge
+ * the prefix gate (matching the hardening the SSR frameworks apply).
+ */
+export function stripBasePath(pathname, basePath) {
+    if (basePath === "")
+        return pathname;
+    const collapsed = pathname.replace(/^\/+/, "/");
+    if (collapsed === basePath)
+        return "/";
+    if (collapsed.startsWith(`${basePath}/`)) {
+        return collapsed.slice(basePath.length);
+    }
+    return null;
+}
+/**
+ * Prepend the base to a root-relative path for an outbound URL (canonical tag,
+ * sitemap `<loc>`, feed link, permalink, cookie `Path`). Inverse of
+ * {@link stripBasePath}: the site root (`/`) maps back to the bare base, and a
+ * root base (`""`) returns the path untouched.
+ */
+export function withBasePath(path, basePath) {
+    if (basePath === "")
+        return path;
+    return path === "/" ? basePath : `${basePath}${path}`;
+}
+//# sourceMappingURL=base-path.js.map

package/dist/base-path.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"base-path.js","sourceRoot":"","sources":["../src/base-path.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH;;;;;GAKG;AACH,MAAM,UAAU,iBAAiB,CAAC,KAAyB;IACzD,IAAI,KAAK,KAAK,SAAS;QAAE,OAAO,EAAE,CAAC;IACnC,MAAM,QAAQ,GAAG,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IAC3E,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC;IACrC,OAAO,GAAG,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAC7D,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,UAAU,aAAa,CAC3B,QAAgB,EAChB,QAAgB;IAEhB,IAAI,QAAQ,KAAK,EAAE;QAAE,OAAO,QAAQ,CAAC;IACrC,MAAM,SAAS,GAAG,QAAQ,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAChD,IAAI,SAAS,KAAK,QAAQ;QAAE,OAAO,GAAG,CAAC;IACvC,IAAI,SAAS,CAAC,UAAU,CAAC,GAAG,QAAQ,GAAG,CAAC,EAAE,CAAC;QACzC,OAAO,SAAS,CAAC,KAAK,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;IAC1C,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,YAAY,CAAC,IAAY,EAAE,QAAgB;IACzD,IAAI,QAAQ,KAAK,EAAE;QAAE,OAAO,IAAI,CAAC;IACjC,OAAO,IAAI,KAAK,GAAG,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,GAAG,QAAQ,GAAG,IAAI,EAAE,CAAC;AACxD,CAAC"}

package/dist/cache/decision.d.ts

@@ -0,0 +1,34 @@
+import type { RouteIntent } from "../route/intent.js";
+interface CacheableRequest {
+    readonly method: string;
+    /**
+     * True when the request may see content the anonymous public can't — so its
+     * render must never be read from or written to the shared cache.
+     */
+    readonly isPrivileged: boolean;
+    readonly intentKind: RouteIntent["kind"];
+}
+/**
+ * Whether a request carries elevated visibility: an authenticated session or
+ * bearer credential, or a `?preview=<token>` draft grant. Any of these can
+ * make the render differ from the shared anonymous document — a logged-in
+ * editor's view, or a draft visible only to a preview-link holder — so such
+ * requests must bypass the cache entirely. The preview case is the load-bearing
+ * one: a draft render is anonymous (no cookie) yet must never be cached, or it
+ * would outlive the token's authorization window in the edge cache.
+ */
+export declare function requestIsPrivileged(request: Request): boolean;
+/**
+ * Whether the edge cache may participate in this request at all — the gate for
+ * both reading a stored response and storing a fresh one.
+ */
+export declare function requestIsCacheable(req: CacheableRequest): boolean;
+/**
+ * Whether a rendered response may be written to the edge cache. Only a `200`
+ * is a complete public document worth storing; redirects and errors are never
+ * cached. Restricted to `GET` because the Workers Cache API persists GET
+ * responses only — a HEAD render is served live.
+ */
+export declare function responseIsStorable(method: string, status: number): boolean;
+export {};
+//# sourceMappingURL=decision.d.ts.map

package/dist/cache/decision.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"decision.d.ts","sourceRoot":"","sources":["../../src/cache/decision.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAatD,UAAU,gBAAgB;IACxB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB;;;OAGG;IACH,QAAQ,CAAC,YAAY,EAAE,OAAO,CAAC;IAC/B,QAAQ,CAAC,UAAU,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;CAC1C;AAED;;;;;;;;GAQG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAI7D;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,gBAAgB,GAAG,OAAO,CAIjE;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAE1E"}

package/dist/cache/decision.js

@@ -0,0 +1,47 @@
+import { readSessionCookie } from "../auth/cookies.js";
+// Public route intents whose anonymous render is a shared, cacheable document.
+// `search` is deliberately excluded — its unbounded query space would pollute
+// the cache with one entry per distinct query string.
+const CACHEABLE_INTENTS = new Set([
+    "single",
+    "archive",
+    "taxonomy",
+    "front-page",
+]);
+/**
+ * Whether a request carries elevated visibility: an authenticated session or
+ * bearer credential, or a `?preview=<token>` draft grant. Any of these can
+ * make the render differ from the shared anonymous document — a logged-in
+ * editor's view, or a draft visible only to a preview-link holder — so such
+ * requests must bypass the cache entirely. The preview case is the load-bearing
+ * one: a draft render is anonymous (no cookie) yet must never be cached, or it
+ * would outlive the token's authorization window in the edge cache.
+ */
+export function requestIsPrivileged(request) {
+    if (readSessionCookie(request) !== null)
+        return true;
+    if (request.headers.has("authorization"))
+        return true;
+    return new URL(request.url).searchParams.has("preview");
+}
+/**
+ * Whether the edge cache may participate in this request at all — the gate for
+ * both reading a stored response and storing a fresh one.
+ */
+export function requestIsCacheable(req) {
+    if (req.method !== "GET" && req.method !== "HEAD")
+        return false;
+    if (req.isPrivileged)
+        return false;
+    return CACHEABLE_INTENTS.has(req.intentKind);
+}
+/**
+ * Whether a rendered response may be written to the edge cache. Only a `200`
+ * is a complete public document worth storing; redirects and errors are never
+ * cached. Restricted to `GET` because the Workers Cache API persists GET
+ * responses only — a HEAD render is served live.
+ */
+export function responseIsStorable(method, status) {
+    return method === "GET" && status === 200;
+}
+//# sourceMappingURL=decision.js.map

package/dist/cache/decision.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"decision.js","sourceRoot":"","sources":["../../src/cache/decision.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAEvD,+EAA+E;AAC/E,8EAA8E;AAC9E,sDAAsD;AACtD,MAAM,iBAAiB,GAAqC,IAAI,GAAG,CAAC;IAClE,QAAQ;IACR,SAAS;IACT,UAAU;IACV,YAAY;CACb,CAAC,CAAC;AAYH;;;;;;;;GAQG;AACH,MAAM,UAAU,mBAAmB,CAAC,OAAgB;IAClD,IAAI,iBAAiB,CAAC,OAAO,CAAC,KAAK,IAAI;QAAE,OAAO,IAAI,CAAC;IACrD,IAAI,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,eAAe,CAAC;QAAE,OAAO,IAAI,CAAC;IACtD,OAAO,IAAI,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,YAAY,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;AAC1D,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,kBAAkB,CAAC,GAAqB;IACtD,IAAI,GAAG,CAAC,MAAM,KAAK,KAAK,IAAI,GAAG,CAAC,MAAM,KAAK,MAAM;QAAE,OAAO,KAAK,CAAC;IAChE,IAAI,GAAG,CAAC,YAAY;QAAE,OAAO,KAAK,CAAC;IACnC,OAAO,iBAAiB,CAAC,GAAG,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;AAC/C,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,kBAAkB,CAAC,MAAc,EAAE,MAAc;IAC/D,OAAO,MAAM,KAAK,KAAK,IAAI,MAAM,KAAK,GAAG,CAAC;AAC5C,CAAC"}

package/dist/cache/purge.d.ts

@@ -0,0 +1,17 @@
+import type { AppContext } from "../context/app.js";
+import type { HookRegistry } from "../hooks/registry.js";
+export declare function enqueuePurgeTags(ctx: AppContext, tags: readonly string[]): void;
+/**
+ * Runs through `ctx.defer` so the purge never blocks the response, and
+ * `defer`'s own rejection handler logs a failed purge — a publish never fails
+ * because Cloudflare's purge API hiccupped; TTL/SWR is the backstop.
+ */
+export declare function flushPurgeTags(ctx: AppContext): void;
+/**
+ * Register core's edge-cache purge subscribers. Called at app boot when a
+ * cache slot is configured; each entry mutation enqueues `t:<type>` + `e:<id>`,
+ * each term mutation enqueues `t:<type>` for the taxonomy's entry types, for
+ * the post-request flush.
+ */
+export declare function registerCorePurgeInvalidator(hooks: HookRegistry): void;
+//# sourceMappingURL=purge.d.ts.map

package/dist/cache/purge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"purge.d.ts","sourceRoot":"","sources":["../../src/cache/purge.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAWzD,wBAAgB,gBAAgB,CAC9B,GAAG,EAAE,UAAU,EACf,IAAI,EAAE,SAAS,MAAM,EAAE,GACtB,IAAI,CAQN;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,UAAU,GAAG,IAAI,CAOpD;AAwBD;;;;;GAKG;AACH,wBAAgB,4BAA4B,CAAC,KAAK,EAAE,YAAY,GAAG,IAAI,CAoBtE"}

package/dist/cache/purge.js

@@ -0,0 +1,82 @@
+import { tryGetContext } from "../context/stores.js";
+import { entryPurgeTags, termPurgeTags } from "./tags.js";
+// Per-request purge accumulator. Entry hooks fire one at a time during a
+// request (a bulk publish fires N), each adding tags here; the dispatcher
+// flushes once after the request so the whole mutation costs a single
+// purge call. Keyed off the request `AppContext`, which is GC'd with the
+// request — no manual cleanup needed beyond the flush's own delete.
+const pending = new WeakMap();
+export function enqueuePurgeTags(ctx, tags) {
+    if (ctx.cache === undefined || tags.length === 0)
+        return;
+    let set = pending.get(ctx);
+    if (set === undefined) {
+        set = new Set();
+        pending.set(ctx, set);
+    }
+    for (const tag of tags)
+        set.add(tag);
+}
+/**
+ * Runs through `ctx.defer` so the purge never blocks the response, and
+ * `defer`'s own rejection handler logs a failed purge — a publish never fails
+ * because Cloudflare's purge API hiccupped; TTL/SWR is the backstop.
+ */
+export function flushPurgeTags(ctx) {
+    const set = pending.get(ctx);
+    if (set === undefined)
+        return;
+    pending.delete(ctx);
+    const cache = ctx.cache;
+    if (cache === undefined || set.size === 0)
+        return;
+    ctx.defer(cache.purgeTags([...set]));
+}
+// Entry lifecycle actions that change what the public sees — published,
+// edited, meta-changed, or removed from view (trash/delete) / restored. Every
+// payload's leading arg carries `{ id, type }`, so one handler serves them all.
+const ENTRY_ACTIONS = [
+    "entry:published",
+    "entry:updated",
+    "entry:meta_changed",
+    "entry:trashed",
+    "entry:restored",
+    "entry:deleted",
+];
+// Term lifecycle actions whose payload's leading arg carries `{ taxonomy }`.
+// A term archive is stored under the `t:<type>` tags of its taxonomy's entry
+// types, so creating, renaming, meta-changing, or deleting a term busts those.
+const TERM_ACTIONS = [
+    "term:created",
+    "term:updated",
+    "term:meta_changed",
+    "term:deleted",
+];
+/**
+ * Register core's edge-cache purge subscribers. Called at app boot when a
+ * cache slot is configured; each entry mutation enqueues `t:<type>` + `e:<id>`,
+ * each term mutation enqueues `t:<type>` for the taxonomy's entry types, for
+ * the post-request flush.
+ */
+export function registerCorePurgeInvalidator(hooks) {
+    const onEntry = (entry) => {
+        const ctx = tryGetContext();
+        if (ctx === null)
+            return;
+        enqueuePurgeTags(ctx, entryPurgeTags(entry.type, entry.id));
+    };
+    for (const action of ENTRY_ACTIONS) {
+        hooks.addAction(action, onEntry);
+    }
+    const onTerm = (term) => {
+        const ctx = tryGetContext();
+        if (ctx === null)
+            return;
+        const entryTypes = ctx.plugins.termTaxonomies.get(term.taxonomy)?.entryTypes ?? [];
+        enqueuePurgeTags(ctx, termPurgeTags(entryTypes));
+    };
+    for (const action of TERM_ACTIONS) {
+        hooks.addAction(action, onTerm);
+    }
+}
+//# sourceMappingURL=purge.js.map

package/dist/cache/purge.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"purge.js","sourceRoot":"","sources":["../../src/cache/purge.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAE1D,yEAAyE;AACzE,0EAA0E;AAC1E,sEAAsE;AACtE,yEAAyE;AACzE,oEAAoE;AACpE,MAAM,OAAO,GAAG,IAAI,OAAO,EAA2B,CAAC;AAEvD,MAAM,UAAU,gBAAgB,CAC9B,GAAe,EACf,IAAuB;IAEvB,IAAI,GAAG,CAAC,KAAK,KAAK,SAAS,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO;IACzD,IAAI,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IAC3B,IAAI,GAAG,KAAK,SAAS,EAAE,CAAC;QACtB,GAAG,GAAG,IAAI,GAAG,EAAE,CAAC;QAChB,OAAO,CAAC,GAAG,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;IACxB,CAAC;IACD,KAAK,MAAM,GAAG,IAAI,IAAI;QAAE,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;AACvC,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,cAAc,CAAC,GAAe;IAC5C,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IAC7B,IAAI,GAAG,KAAK,SAAS;QAAE,OAAO;IAC9B,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;IACpB,MAAM,KAAK,GAAG,GAAG,CAAC,KAAK,CAAC;IACxB,IAAI,KAAK,KAAK,SAAS,IAAI,GAAG,CAAC,IAAI,KAAK,CAAC;QAAE,OAAO;IAClD,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC;AACvC,CAAC;AAED,wEAAwE;AACxE,8EAA8E;AAC9E,gFAAgF;AAChF,MAAM,aAAa,GAAG;IACpB,iBAAiB;IACjB,eAAe;IACf,oBAAoB;IACpB,eAAe;IACf,gBAAgB;IAChB,eAAe;CACP,CAAC;AAEX,6EAA6E;AAC7E,6EAA6E;AAC7E,+EAA+E;AAC/E,MAAM,YAAY,GAAG;IACnB,cAAc;IACd,cAAc;IACd,mBAAmB;IACnB,cAAc;CACN,CAAC;AAEX;;;;;GAKG;AACH,MAAM,UAAU,4BAA4B,CAAC,KAAmB;IAC9D,MAAM,OAAO,GAAG,CAAC,KAAqD,EAAE,EAAE;QACxE,MAAM,GAAG,GAAG,aAAa,EAAE,CAAC;QAC5B,IAAI,GAAG,KAAK,IAAI;YAAE,OAAO;QACzB,gBAAgB,CAAC,GAAG,EAAE,cAAc,CAAC,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC;IAC9D,CAAC,CAAC;IACF,KAAK,MAAM,MAAM,IAAI,aAAa,EAAE,CAAC;QACnC,KAAK,CAAC,SAAS,CAAC,MAAe,EAAE,OAAO,CAAC,CAAC;IAC5C,CAAC;IAED,MAAM,MAAM,GAAG,CAAC,IAAmC,EAAE,EAAE;QACrD,MAAM,GAAG,GAAG,aAAa,EAAE,CAAC;QAC5B,IAAI,GAAG,KAAK,IAAI;YAAE,OAAO;QACzB,MAAM,UAAU,GACd,GAAG,CAAC,OAAO,CAAC,cAAc,CAAC,GAAG,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,UAAU,IAAI,EAAE,CAAC;QAClE,gBAAgB,CAAC,GAAG,EAAE,aAAa,CAAC,UAAU,CAAC,CAAC,CAAC;IACnD,CAAC,CAAC;IACF,KAAK,MAAM,MAAM,IAAI,YAAY,EAAE,CAAC;QAClC,KAAK,CAAC,SAAS,CAAC,MAAe,EAAE,MAAe,CAAC,CAAC;IACpD,CAAC;AACH,CAAC"}

package/dist/cache/read-through.d.ts

@@ -0,0 +1,30 @@
+import type { DeferFn } from "../context/app.js";
+import type { RouteIntent } from "../route/intent.js";
+import type { ConnectedCache } from "../runtime/slots.js";
+interface ReadThroughArgs {
+    readonly request: Request;
+    /**
+     * Resolved public route intent, or `null` when the URL matches no public
+     * route (a 404) — in which case the cache is never consulted.
+     */
+    readonly intentKind: RouteIntent["kind"] | null;
+    readonly cache: ConnectedCache;
+    readonly defer: DeferFn;
+    /** Renders the page live. Called once on a miss, never on a hit. */
+    readonly render: () => Promise<Response>;
+    /**
+     * The cache tags the stored response should carry. Evaluated after `render`
+     * so it can read the route's resolved entity (e.g. the entry id).
+     */
+    readonly tags: () => readonly string[];
+}
+/**
+ * Serve a public page through the edge cache: return a stored response on a
+ * hit, otherwise render live and store the result when it's cacheable. The
+ * store runs through `defer` so it never blocks the response. Requests that
+ * aren't cacheable (privileged, non-GET/HEAD, search, no route) render live
+ * and touch the cache not at all.
+ */
+export declare function readThrough(args: ReadThroughArgs): Promise<Response>;
+export {};
+//# sourceMappingURL=read-through.d.ts.map

package/dist/cache/read-through.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"read-through.d.ts","sourceRoot":"","sources":["../../src/cache/read-through.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACtD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAO1D,UAAU,eAAe;IACvB,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B;;;OAGG;IACH,QAAQ,CAAC,UAAU,EAAE,WAAW,CAAC,MAAM,CAAC,GAAG,IAAI,CAAC;IAChD,QAAQ,CAAC,KAAK,EAAE,cAAc,CAAC;IAC/B,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;IACxB,oEAAoE;IACpE,QAAQ,CAAC,MAAM,EAAE,MAAM,OAAO,CAAC,QAAQ,CAAC,CAAC;IACzC;;;OAGG;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM,SAAS,MAAM,EAAE,CAAC;CACxC;AAED;;;;;;GAMG;AACH,wBAAsB,WAAW,CAAC,IAAI,EAAE,eAAe,GAAG,OAAO,CAAC,QAAQ,CAAC,CAsB1E"}

package/dist/cache/read-through.js

@@ -0,0 +1,28 @@
+import { requestIsCacheable, requestIsPrivileged, responseIsStorable, } from "./decision.js";
+/**
+ * Serve a public page through the edge cache: return a stored response on a
+ * hit, otherwise render live and store the result when it's cacheable. The
+ * store runs through `defer` so it never blocks the response. Requests that
+ * aren't cacheable (privileged, non-GET/HEAD, search, no route) render live
+ * and touch the cache not at all.
+ */
+export async function readThrough(args) {
+    const { request, intentKind, cache, defer, render, tags } = args;
+    if (intentKind === null ||
+        !requestIsCacheable({
+            method: request.method,
+            isPrivileged: requestIsPrivileged(request),
+            intentKind,
+        })) {
+        return render();
+    }
+    const hit = await cache.match(request);
+    if (hit)
+        return hit;
+    const fresh = await render();
+    if (responseIsStorable(request.method, fresh.status)) {
+        defer(cache.put(request, fresh.clone(), tags()));
+    }
+    return fresh;
+}
+//# sourceMappingURL=read-through.js.map

package/dist/cache/read-through.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"read-through.js","sourceRoot":"","sources":["../../src/cache/read-through.ts"],"names":[],"mappings":"AAGA,OAAO,EACL,kBAAkB,EAClB,mBAAmB,EACnB,kBAAkB,GACnB,MAAM,eAAe,CAAC;AAoBvB;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,IAAqB;IACrD,MAAM,EAAE,OAAO,EAAE,UAAU,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,IAAI,CAAC;IAEjE,IACE,UAAU,KAAK,IAAI;QACnB,CAAC,kBAAkB,CAAC;YAClB,MAAM,EAAE,OAAO,CAAC,MAAM;YACtB,YAAY,EAAE,mBAAmB,CAAC,OAAO,CAAC;YAC1C,UAAU;SACX,CAAC,EACF,CAAC;QACD,OAAO,MAAM,EAAE,CAAC;IAClB,CAAC;IAED,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IACvC,IAAI,GAAG;QAAE,OAAO,GAAG,CAAC;IAEpB,MAAM,KAAK,GAAG,MAAM,MAAM,EAAE,CAAC;IAC7B,IAAI,kBAAkB,CAAC,OAAO,CAAC,MAAM,EAAE,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC;QACrD,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,OAAO,EAAE,KAAK,CAAC,KAAK,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;IACnD,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC"}

package/dist/cache/tags.d.ts

@@ -0,0 +1,30 @@
+import type { ResolvedEntity } from "../route/current.js";
+import type { RouteIntent } from "../route/intent.js";
+export declare function typeTag(entryType: string): string;
+export declare function entryTag(entryId: number): string;
+interface PageTagSources {
+    readonly intent: RouteIntent;
+    readonly resolvedEntity: ResolvedEntity | null;
+    /** Entry types the front page lists (public, non-hierarchical). */
+    readonly frontPageEntryTypes: () => readonly string[];
+    /** Entry types attached to the named taxonomy. */
+    readonly taxonomyEntryTypes: (taxonomy: string) => readonly string[];
+}
+/**
+ * The cache tags a rendered public page is stored under. Every page that lists
+ * or embeds type-`X` content — its archives, the front page, term archives,
+ * and an entry permalink (which can render sibling content like related posts)
+ * — carries `t:X`, so any publish of that type busts it. A permalink also
+ * carries its own `e:<id>` so an edit to just that entry busts it precisely.
+ */
+export declare function pageTags(sources: PageTagSources): string[];
+/** Tags to purge when an entry of `entryType` (id `entryId`) changes. */
+export declare function entryPurgeTags(entryType: string, entryId: number): string[];
+/**
+ * Tags to purge when a term changes. A term archive carries the `t:<type>`
+ * tags of the entry types its taxonomy lists, so purging those busts the
+ * archive and the listings that show the term's name.
+ */
+export declare function termPurgeTags(taxonomyEntryTypes: readonly string[]): string[];
+export {};
+//# sourceMappingURL=tags.d.ts.map

package/dist/cache/tags.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tags.d.ts","sourceRoot":"","sources":["../../src/cache/tags.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAC1D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAKtD,wBAAgB,OAAO,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAEjD;AAED,wBAAgB,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAEhD;AAED,UAAU,cAAc;IACtB,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC;IAC7B,QAAQ,CAAC,cAAc,EAAE,cAAc,GAAG,IAAI,CAAC;IAC/C,mEAAmE;IACnE,QAAQ,CAAC,mBAAmB,EAAE,MAAM,SAAS,MAAM,EAAE,CAAC;IACtD,kDAAkD;IAClD,QAAQ,CAAC,kBAAkB,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,SAAS,MAAM,EAAE,CAAC;CACtE;AAED;;;;;;GAMG;AACH,wBAAgB,QAAQ,CAAC,OAAO,EAAE,cAAc,GAAG,MAAM,EAAE,CAgB1D;AAED,yEAAyE;AACzE,wBAAgB,cAAc,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,EAAE,CAE3E;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,kBAAkB,EAAE,SAAS,MAAM,EAAE,GAAG,MAAM,EAAE,CAE7E"}

package/dist/cache/tags.js

@@ -0,0 +1,46 @@
+// Coarse cache-tag vocabulary (PRD #1080). Archive-class pages carry the type
+// tag `t:<type>`; entry permalinks carry the entry tag `e:<id>`. Publishing an
+// entry purges both, busting its permalink and every archive of that type.
+export function typeTag(entryType) {
+    return `t:${entryType}`;
+}
+export function entryTag(entryId) {
+    return `e:${String(entryId)}`;
+}
+/**
+ * The cache tags a rendered public page is stored under. Every page that lists
+ * or embeds type-`X` content — its archives, the front page, term archives,
+ * and an entry permalink (which can render sibling content like related posts)
+ * — carries `t:X`, so any publish of that type busts it. A permalink also
+ * carries its own `e:<id>` so an edit to just that entry busts it precisely.
+ */
+export function pageTags(sources) {
+    const { intent, resolvedEntity } = sources;
+    switch (intent.kind) {
+        case "single":
+            return resolvedEntity?.kind === "entry"
+                ? [typeTag(intent.entryType), entryTag(resolvedEntity.id)]
+                : [];
+        case "archive":
+            return [typeTag(intent.entryType)];
+        case "front-page":
+            return sources.frontPageEntryTypes().map(typeTag);
+        case "taxonomy":
+            return sources.taxonomyEntryTypes(intent.taxonomy).map(typeTag);
+        case "search":
+            return [];
+    }
+}
+/** Tags to purge when an entry of `entryType` (id `entryId`) changes. */
+export function entryPurgeTags(entryType, entryId) {
+    return [typeTag(entryType), entryTag(entryId)];
+}
+/**
+ * Tags to purge when a term changes. A term archive carries the `t:<type>`
+ * tags of the entry types its taxonomy lists, so purging those busts the
+ * archive and the listings that show the term's name.
+ */
+export function termPurgeTags(taxonomyEntryTypes) {
+    return taxonomyEntryTypes.map(typeTag);
+}
+//# sourceMappingURL=tags.js.map

package/dist/cache/tags.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tags.js","sourceRoot":"","sources":["../../src/cache/tags.ts"],"names":[],"mappings":"AAGA,8EAA8E;AAC9E,+EAA+E;AAC/E,2EAA2E;AAC3E,MAAM,UAAU,OAAO,CAAC,SAAiB;IACvC,OAAO,KAAK,SAAS,EAAE,CAAC;AAC1B,CAAC;AAED,MAAM,UAAU,QAAQ,CAAC,OAAe;IACtC,OAAO,KAAK,MAAM,CAAC,OAAO,CAAC,EAAE,CAAC;AAChC,CAAC;AAWD;;;;;;GAMG;AACH,MAAM,UAAU,QAAQ,CAAC,OAAuB;IAC9C,MAAM,EAAE,MAAM,EAAE,cAAc,EAAE,GAAG,OAAO,CAAC;IAC3C,QAAQ,MAAM,CAAC,IAAI,EAAE,CAAC;QACpB,KAAK,QAAQ;YACX,OAAO,cAAc,EAAE,IAAI,KAAK,OAAO;gBACrC,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,SAAS,CAAC,EAAE,QAAQ,CAAC,cAAc,CAAC,EAAE,CAAC,CAAC;gBAC1D,CAAC,CAAC,EAAE,CAAC;QACT,KAAK,SAAS;YACZ,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC;QACrC,KAAK,YAAY;YACf,OAAO,OAAO,CAAC,mBAAmB,EAAE,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QACpD,KAAK,UAAU;YACb,OAAO,OAAO,CAAC,kBAAkB,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QAClE,KAAK,QAAQ;YACX,OAAO,EAAE,CAAC;IACd,CAAC;AACH,CAAC;AAED,yEAAyE;AACzE,MAAM,UAAU,cAAc,CAAC,SAAiB,EAAE,OAAe;IAC/D,OAAO,CAAC,OAAO,CAAC,SAAS,CAAC,EAAE,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC;AACjD,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,aAAa,CAAC,kBAAqC;IACjE,OAAO,kBAAkB,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;AACzC,CAAC"}

package/dist/cli/errors.d.ts

@@ -0,0 +1,75 @@
+type CliErrorCode = "spawn_failed" | "spawn_nonzero_exit" | "unknown_command" | "unknown_subcommand" | "runtime_commands_not_found" | "runtime_commands_load_failed" | "migrate_generate_no_drizzle_kit" | "migrate_apply_missing_db" | "migrate_apply_no_d1" | "migrate_apply_ambiguous_db" | "config_not_found_explicit" | "config_not_found_default" | "config_load_failed" | "config_invalid" | "i18n_check_drift" | "i18n_verify_drift" | "i18n_init_no_package_json" | "i18n_init_invalid_package_json" | "tooling_command_no_app";
+export declare class CliError extends Error {
+    readonly code: CliErrorCode;
+    readonly hint: string | undefined;
+    private constructor();
+    static spawnFailed(ctx: {
+        command: string;
+        cause: unknown;
+    }): CliError;
+    static spawnNonzeroExit(ctx: {
+        command: string;
+        exitCode: number | null;
+        signal: NodeJS.Signals | null;
+    }): CliError;
+    static unknownCommand(ctx: {
+        command: string;
+    }): CliError;
+    static unknownSubcommand(ctx: {
+        command: string;
+        subcommand: string | undefined;
+        supported: readonly string[];
+    }): CliError;
+    static runtimeCommandsNotFound(ctx: {
+        commandsModule: string;
+        cwd: string;
+        cause: unknown;
+    }): CliError;
+    static runtimeCommandsLoadFailed(ctx: {
+        commandsModule: string;
+        cause: unknown;
+    }): CliError;
+    static migrateGenerateNoDrizzleKit(): CliError;
+    static migrateApplyMissingDb(): CliError;
+    static migrateApplyNoD1(ctx: {
+        filename: string;
+    }): CliError;
+    static migrateApplyAmbiguousDb(ctx: {
+        filename: string;
+        names: readonly string[];
+    }): CliError;
+    static configNotFoundExplicit(ctx: {
+        explicit: string;
+        absolute: string;
+    }): CliError;
+    static configNotFoundDefault(ctx: {
+        cwd: string;
+    }): CliError;
+    static configLoadFailed(ctx: {
+        configPath: string;
+        cause: unknown;
+    }): CliError;
+    static configInvalid(ctx: {
+        configPath: string;
+    }): CliError;
+    static toolingCommandNoApp(ctx: {
+        command: string;
+    }): CliError;
+    static i18nCheckDrift(ctx: {
+        ids: readonly string[];
+    }): CliError;
+    static i18nVerifyDrift(ctx: {
+        missingInCatalog: readonly string[];
+        orphanedInCatalog: readonly string[];
+    }): CliError;
+    static i18nInitNoPackageJson(ctx: {
+        cwd: string;
+    }): CliError;
+    static i18nInitInvalidPackageJson(ctx: {
+        cwd: string;
+        cause: unknown;
+    }): CliError;
+}
+export declare function isCliError(error: unknown): error is CliError;
+export {};
+//# sourceMappingURL=errors.d.ts.map

package/dist/cli/errors.d.ts.map

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

package/dist/cli/errors.js

@@ -0,0 +1,85 @@
+export class CliError extends Error {
+    static {
+        CliError.prototype.name = "CliError";
+    }
+    code;
+    hint;
+    constructor(code, message, hint, cause) {
+        super(message, cause !== undefined ? { cause } : undefined);
+        this.code = code;
+        this.hint = hint;
+    }
+    static spawnFailed(ctx) {
+        return new CliError("spawn_failed", `Failed to start ${ctx.command}`, `Is ${ctx.command} installed and on PATH?`, ctx.cause);
+    }
+    static spawnNonzeroExit(ctx) {
+        const detail = ctx.signal
+            ? `signal ${ctx.signal}`
+            : `code ${ctx.exitCode ?? "unknown"}`;
+        return new CliError("spawn_nonzero_exit", `${ctx.command} exited with ${detail}`, undefined, undefined);
+    }
+    static unknownCommand(ctx) {
+        return new CliError("unknown_command", `Unknown command: ${ctx.command}`, "Run `plumix help` to see available commands.", undefined);
+    }
+    static unknownSubcommand(ctx) {
+        const supported = ctx.supported
+            .map((n) => `\`plumix ${ctx.command} ${n}\``)
+            .join(", ");
+        return new CliError("unknown_subcommand", `Unknown subcommand: ${ctx.command} ${String(ctx.subcommand)}`, `Supported: ${supported}.`, undefined);
+    }
+    static runtimeCommandsNotFound(ctx) {
+        return new CliError("runtime_commands_not_found", `Runtime commands module not found: "${ctx.commandsModule}"`, `Install the runtime adapter package in ${ctx.cwd}.`, ctx.cause);
+    }
+    static runtimeCommandsLoadFailed(ctx) {
+        return new CliError("runtime_commands_load_failed", `Failed to load runtime commands from "${ctx.commandsModule}"`, "Check the runtime adapter's commands module for import errors.", ctx.cause);
+    }
+    static migrateGenerateNoDrizzleKit() {
+        return new CliError("migrate_generate_no_drizzle_kit", "drizzle-kit could not be resolved", "drizzle-kit ships with plumix; rerun `pnpm install` to restore node_modules, or pin a specific version as a devDependency to override.", undefined);
+    }
+    static migrateApplyMissingDb() {
+        return new CliError("migrate_apply_missing_db", "Missing D1 database name", "Pass the database name: `plumix migrate apply <database-name>`. Or add a wrangler.jsonc / wrangler.toml with a `d1_databases` entry so Plumix can auto-discover it.", undefined);
+    }
+    static migrateApplyNoD1(ctx) {
+        return new CliError("migrate_apply_no_d1", `No d1_databases entries with a database_name in ${ctx.filename}`, "Add a `d1_databases` entry with a `database_name`, or pass the name explicitly: `plumix migrate apply <database-name>`.", undefined);
+    }
+    static migrateApplyAmbiguousDb(ctx) {
+        return new CliError("migrate_apply_ambiguous_db", `Multiple D1 databases found in ${ctx.filename}: ${ctx.names.join(", ")}`, "Pass the name explicitly: `plumix migrate apply <database-name>`.", undefined);
+    }
+    static configNotFoundExplicit(ctx) {
+        return new CliError("config_not_found_explicit", `Config file not found: ${ctx.explicit}`, `Checked ${ctx.absolute}`, undefined);
+    }
+    static configNotFoundDefault(ctx) {
+        return new CliError("config_not_found_default", "No plumix.config.{ts,js,mjs} found", `Create plumix.config.ts in ${ctx.cwd} or pass --config <path>.`, undefined);
+    }
+    static configLoadFailed(ctx) {
+        return new CliError("config_load_failed", `Failed to load ${ctx.configPath}`, "Check the file for syntax errors and ensure every import resolves.", ctx.cause);
+    }
+    static configInvalid(ctx) {
+        return new CliError("config_invalid", `Invalid config shape in ${ctx.configPath}`, "Default export must be the return value of plumix({ ... }) or defineConfig({ ... }).", undefined);
+    }
+    static toolingCommandNoApp(ctx) {
+        return new CliError("tooling_command_no_app", `plumix ${ctx.command}: ctx.app is not available — tooling commands run without a config`, "If this command needs the runtime app, dispatch it through the normal config-loading path.", undefined);
+    }
+    static i18nCheckDrift(ctx) {
+        return new CliError("i18n_check_drift", `Translation catalogs out of sync — ${ctx.ids.length} msgid(s) drifted (+ added, - removed):\n  ${ctx.ids.join("\n  ")}`, "Run `plumix i18n extract` locally and commit the updated `.po` file(s).", undefined);
+    }
+    static i18nVerifyDrift(ctx) {
+        const lines = [];
+        for (const id of ctx.missingInCatalog)
+            lines.push(`+ ${id}`);
+        for (const id of ctx.orphanedInCatalog)
+            lines.push(`- ${id}`);
+        const total = ctx.missingInCatalog.length + ctx.orphanedInCatalog.length;
+        return new CliError("i18n_verify_drift", `Source ↔ catalog drift — ${total} msgid(s) (+ missing from catalog, - orphaned in catalog):\n  ${lines.join("\n  ")}`, "Add missing entries to `locales/en.po` (translators won't see them otherwise) and drop orphaned ones (dead translation work).", undefined);
+    }
+    static i18nInitNoPackageJson(ctx) {
+        return new CliError("i18n_init_no_package_json", `No package.json at ${ctx.cwd}`, "Run `plumix i18n init` from a package root, or scaffold one first with `pnpm init`.", undefined);
+    }
+    static i18nInitInvalidPackageJson(ctx) {
+        return new CliError("i18n_init_invalid_package_json", `Cannot parse package.json at ${ctx.cwd}`, "Fix the JSON syntax before re-running `plumix i18n init` — refusing to overwrite a malformed file.", ctx.cause);
+    }
+}
+export function isCliError(error) {
+    return error instanceof CliError;
+}
+//# sourceMappingURL=errors.js.map

package/dist/cli/errors.js.map

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

package/dist/cli/index.d.ts

@@ -0,0 +1,7 @@
+export { CliError, isCliError } from "./errors.js";
+export { CORE_SCHEMA_MODULE, generateSchemaSource } from "./schema-codegen.js";
+export type { SchemaSource } from "./schema-codegen.js";
+export { spawnInherit } from "./spawn.js";
+export { generateWorkerSource } from "./worker-codegen.js";
+export type { WorkerSourceOptions } from "./worker-codegen.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/cli/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/cli/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACnD,OAAO,EAAE,kBAAkB,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAC/E,YAAY,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC1C,OAAO,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAC3D,YAAY,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/cli/index.js

@@ -0,0 +1,5 @@
+export { CliError, isCliError } from "./errors.js";
+export { CORE_SCHEMA_MODULE, generateSchemaSource } from "./schema-codegen.js";
+export { spawnInherit } from "./spawn.js";
+export { generateWorkerSource } from "./worker-codegen.js";
+//# sourceMappingURL=index.js.map

package/dist/cli/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/cli/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACnD,OAAO,EAAE,kBAAkB,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAE/E,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC1C,OAAO,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/cli/schema-codegen.d.ts

@@ -0,0 +1,8 @@
+import type { PlumixConfig } from "../config.js";
+export declare const CORE_SCHEMA_MODULE = "plumix/schema";
+export interface SchemaSource {
+    readonly source: string;
+    readonly modules: readonly string[];
+}
+export declare function generateSchemaSource(config: PlumixConfig): SchemaSource;
+//# sourceMappingURL=schema-codegen.d.ts.map

package/dist/cli/schema-codegen.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema-codegen.d.ts","sourceRoot":"","sources":["../../src/cli/schema-codegen.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAEjD,eAAO,MAAM,kBAAkB,kBAAkB,CAAC;AAElD,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,CAAC;CACrC;AAED,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,YAAY,GAAG,YAAY,CAmBvE"}