@plumix/core 0.1.0

package/dist/template-deps-core.js

@@ -0,0 +1,35 @@
+import { inArray } from "drizzle-orm";
+import { settings } from "./db/schema/settings.js";
+/**
+ * Seed the plugin registry with built-in template deps before plugin
+ * `setup()` runs. Mirrors `registerCoreLookupAdapters` — core's slot
+ * lands first so a plugin `ctx.registerTemplateDep("settings", ...)`
+ * trips the boot-time collision guard.
+ */
+export function registerCoreTemplateDeps(registry) {
+    registry.templateDeps.set("settings", {
+        kind: "settings",
+        registeredBy: null,
+        load: settingsLoader,
+    });
+}
+export async function settingsLoader(groups, ctx) {
+    if (groups.length === 0)
+        return {};
+    const rows = await ctx.db
+        .select({ group: settings.group, key: settings.key, value: settings.value })
+        .from(settings)
+        .where(inArray(settings.group, [...groups]));
+    // Build a `Record<group, Record<key, value>>` so each declared
+    // group maps to its full key/value bag. Groups that have no rows
+    // surface as undefined in the per-group record but the caller's
+    // `loadTemplateDeps` fills missing slugs with `null`.
+    const grouped = {};
+    for (const row of rows) {
+        const bag = grouped[row.group] ?? {};
+        bag[row.key] = row.value;
+        grouped[row.group] = bag;
+    }
+    return grouped;
+}
+//# sourceMappingURL=template-deps-core.js.map

package/dist/template-deps-core.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"template-deps-core.js","sourceRoot":"","sources":["../src/template-deps-core.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAItC,OAAO,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAC;AAWnD;;;;;GAKG;AACH,MAAM,UAAU,wBAAwB,CACtC,QAA+B;IAE/B,QAAQ,CAAC,YAAY,CAAC,GAAG,CAAC,UAAU,EAAE;QACpC,IAAI,EAAE,UAAU;QAChB,YAAY,EAAE,IAAI;QAClB,IAAI,EAAE,cAAc;KACrB,CAAC,CAAC;AACL,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,cAAc,CAClC,MAAyB,EACzB,GAAe;IAEf,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC;IACnC,MAAM,IAAI,GAAG,MAAM,GAAG,CAAC,EAAE;SACtB,MAAM,CAAC,EAAE,KAAK,EAAE,QAAQ,CAAC,KAAK,EAAE,GAAG,EAAE,QAAQ,CAAC,GAAG,EAAE,KAAK,EAAE,QAAQ,CAAC,KAAK,EAAE,CAAC;SAC3E,IAAI,CAAC,QAAQ,CAAC;SACd,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,KAAK,EAAE,CAAC,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC;IAC/C,+DAA+D;IAC/D,iEAAiE;IACjE,gEAAgE;IAChE,sDAAsD;IACtD,MAAM,OAAO,GAA4C,EAAE,CAAC;IAC5D,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;QACvB,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC;QACrC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,GAAG,CAAC,KAAK,CAAC;QACzB,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,GAAG,CAAC;IAC3B,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/dist/template-deps.d.ts

@@ -0,0 +1,41 @@
+import type { AppContext } from "./context/app.js";
+import type { TemplateDepDeclarations, TemplateDepRegistry } from "./template.js";
+/**
+ * Loader signature for a template dep. Receives the slugs declared by
+ * every template using this kind on the current request (deduped +
+ * batched) and the per-request `AppContext`. Returns a record keyed by
+ * slug. Slugs not present in the returned record render as `null` in
+ * the deps passed to the template's render function.
+ */
+export type TemplateDepLoader<TKind extends keyof TemplateDepRegistry> = (slugs: readonly TemplateDepRegistry[TKind]["slug"][], ctx: AppContext) => Promise<Record<string, TemplateDepRegistry[TKind]["result"] | null>>;
+type UntypedTemplateDepLoader = (slugs: readonly string[], ctx: AppContext) => Promise<Record<string, unknown>>;
+export interface RegisteredTemplateDep {
+    readonly kind: string;
+    readonly load: UntypedTemplateDepLoader;
+    /** Plugin id, or `null` for core-registered deps (e.g. `settings`). */
+    readonly registeredBy: string | null;
+}
+export declare const RESERVED_DEP_KIND_NAMES: ReadonlySet<string>;
+/**
+ * Combine theme + template dep declarations. The template's own
+ * declaration for a kind replaces the theme's; absent declarations
+ * inherit. Extending the inherited set is opt-in via the function
+ * form (`menus: (prev) => [...prev, "x"]`).
+ */
+export declare function mergeTemplateDepDeclarations(themeDeps: TemplateDepDeclarations | undefined, template: Readonly<Record<string, unknown>>): Readonly<Record<string, readonly string[]>>;
+/**
+ * Per-request dep loader. Reads the picked template's declared dep
+ * slugs, fires every registered loader in parallel via `Promise.all`,
+ * and assembles the results object passed into the render function.
+ *
+ * Loader failures don't break the render: the dep's result becomes
+ * `{}` (empty per-slug map), the failure is logged via
+ * `ctx.logger.error("template_dep_load_failed", { kind, slugs, err })`,
+ * and the response stays 200.
+ *
+ * Slugs not present in a loader's returned record render as `null` in
+ * the deps map — themes use optional chaining (`settings?.["site"]`).
+ */
+export declare function loadTemplateDeps(template: Readonly<Record<string, unknown>>, registry: ReadonlyMap<string, RegisteredTemplateDep>, ctx: AppContext): Promise<Record<string, Record<string, unknown>>>;
+export {};
+//# sourceMappingURL=template-deps.d.ts.map

package/dist/template-deps.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"template-deps.d.ts","sourceRoot":"","sources":["../src/template-deps.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AACnD,OAAO,KAAK,EACV,uBAAuB,EACvB,mBAAmB,EACpB,MAAM,eAAe,CAAC;AAEvB;;;;;;GAMG;AACH,MAAM,MAAM,iBAAiB,CAAC,KAAK,SAAS,MAAM,mBAAmB,IAAI,CACvE,KAAK,EAAE,SAAS,mBAAmB,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,EAAE,EACpD,GAAG,EAAE,UAAU,KACZ,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,mBAAmB,CAAC,KAAK,CAAC,CAAC,QAAQ,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC;AAQ1E,KAAK,wBAAwB,GAAG,CAC9B,KAAK,EAAE,SAAS,MAAM,EAAE,EACxB,GAAG,EAAE,UAAU,KACZ,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;AAEtC,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,wBAAwB,CAAC;IACxC,uEAAuE;IACvE,QAAQ,CAAC,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;CACtC;AAaD,eAAO,MAAM,uBAAuB,EAAE,WAAW,CAAC,MAAM,CAGtD,CAAC;AAEH;;;;;GAKG;AACH,wBAAgB,4BAA4B,CAC1C,SAAS,EAAE,uBAAuB,GAAG,SAAS,EAC9C,QAAQ,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,GAC1C,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC,CAAC,CAqB7C;AAED;;;;;;;;;;;;GAYG;AACH,wBAAsB,gBAAgB,CACpC,QAAQ,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,EAC3C,QAAQ,EAAE,WAAW,CAAC,MAAM,EAAE,qBAAqB,CAAC,EACpD,GAAG,EAAE,UAAU,GACd,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC,CAUlD"}

package/dist/template-deps.js

@@ -0,0 +1,90 @@
+// Framework-owned keys on a theme or template object — `mergeTemplate…`
+// must skip them so values like `render` (a function on every template)
+// and `css` (an array on every theme) don't accidentally read as
+// dep-kind declarations. `registerTemplateDep` rejects these as kinds
+// too, so the runtime is the single source of truth for the policy.
+const RESERVED_THEME_KEYS = new Set(["templates", "document", "tokens", "css"]);
+const RESERVED_TEMPLATE_KEYS = new Set([
+    "render",
+    "document",
+    "prefetchListingLoaders",
+]);
+export const RESERVED_DEP_KIND_NAMES = new Set([
+    ...RESERVED_THEME_KEYS,
+    ...RESERVED_TEMPLATE_KEYS,
+]);
+/**
+ * Combine theme + template dep declarations. The template's own
+ * declaration for a kind replaces the theme's; absent declarations
+ * inherit. Extending the inherited set is opt-in via the function
+ * form (`menus: (prev) => [...prev, "x"]`).
+ */
+export function mergeTemplateDepDeclarations(themeDeps, template) {
+    const result = {};
+    if (themeDeps) {
+        for (const [kind, value] of Object.entries(themeDeps)) {
+            if (RESERVED_THEME_KEYS.has(kind))
+                continue;
+            if (Array.isArray(value))
+                result[kind] = value;
+        }
+    }
+    for (const [kind, value] of Object.entries(template)) {
+        if (RESERVED_TEMPLATE_KEYS.has(kind))
+            continue;
+        if (Array.isArray(value)) {
+            result[kind] = value;
+        }
+        else if (typeof value === "function") {
+            const prev = result[kind] ?? [];
+            const next = value(prev);
+            if (Array.isArray(next))
+                result[kind] = next;
+        }
+    }
+    return result;
+}
+/**
+ * Per-request dep loader. Reads the picked template's declared dep
+ * slugs, fires every registered loader in parallel via `Promise.all`,
+ * and assembles the results object passed into the render function.
+ *
+ * Loader failures don't break the render: the dep's result becomes
+ * `{}` (empty per-slug map), the failure is logged via
+ * `ctx.logger.error("template_dep_load_failed", { kind, slugs, err })`,
+ * and the response stays 200.
+ *
+ * Slugs not present in a loader's returned record render as `null` in
+ * the deps map — themes use optional chaining (`settings?.["site"]`).
+ */
+export async function loadTemplateDeps(template, registry, ctx) {
+    const pending = [];
+    for (const [kind, loader] of registry) {
+        const declared = template[kind];
+        if (!Array.isArray(declared) || declared.length === 0)
+            continue;
+        const slugs = declared;
+        pending.push(loadOne(kind, slugs, loader, ctx));
+    }
+    if (pending.length === 0)
+        return {};
+    return Object.fromEntries(await Promise.all(pending));
+}
+async function loadOne(kind, slugs, loader, ctx) {
+    try {
+        const raw = await loader.load(slugs, ctx);
+        // Fill any slug the loader omitted with null — themes get a
+        // stable shape per declared slug.
+        const filled = Object.fromEntries(slugs.map((s) => [s, raw[s] ?? null]));
+        return [kind, filled];
+    }
+    catch (err) {
+        ctx.logger.error("template_dep_load_failed", {
+            kind,
+            slugs,
+            err: err instanceof Error ? err.message : String(err),
+        });
+        return [kind, {}];
+    }
+}
+//# sourceMappingURL=template-deps.js.map

package/dist/template-deps.js.map

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

package/dist/template.d.ts

@@ -0,0 +1,84 @@
+import type { ReactNode } from "react";
+import type { AppContext } from "./context/app.js";
+import type { DocumentManifest, TemplateData } from "./theme.js";
+declare const PLUMIX_TEMPLATE_BRAND: unique symbol;
+/**
+ * Augmentable registry of template-level dep slots. Plugins register
+ * loaders via `ctx.registerTemplateDep(kind, { load })` and themes
+ * declare what they need via `defineTemplate({ [kind]: slugs[], ... })`.
+ * The framework loads each declared dep in parallel per request and
+ * passes results into render.
+ *
+ * Each entry shape: `{ slug: string; result: ResultType }`. Augment via
+ * declaration merging — see `core` registering `settings` for the
+ * canonical example.
+ */
+export interface TemplateDepRegistry {
+}
+/**
+ * Per-kind declarations on a theme or template. An array replaces the
+ * inherited value (override); a function `(prev) => next` receives the
+ * theme's slugs and returns the composed set (extend / filter); an
+ * empty array disables the dep for that template; an omitted kind
+ * inherits unchanged.
+ */
+export type TemplateDepDeclarations = {
+    readonly [K in keyof TemplateDepRegistry]?: readonly TemplateDepRegistry[K]["slug"][] | ((prev: readonly TemplateDepRegistry[K]["slug"][]) => readonly TemplateDepRegistry[K]["slug"][]);
+};
+/**
+ * Per-kind results threaded into the render function. Keyed by slug,
+ * `null` when the loader didn't return a value for that slug (or
+ * threw — see `template_dep_load_failed` log).
+ */
+type TemplateDepResults = {
+    readonly [K in keyof TemplateDepRegistry]?: Readonly<Record<string, TemplateDepRegistry[K]["result"] | null>>;
+};
+export interface TemplateRenderArgs<TData extends TemplateData> extends TemplateDepResults {
+    readonly data: TData;
+    readonly ctx: AppContext;
+}
+export type TemplateRender<TData extends TemplateData> = (args: TemplateRenderArgs<TData>) => ReactNode;
+/**
+ * Literal manifest is merged at boot; function form is called per
+ * request with the same args `render` sees.
+ */
+type TemplateDocument<TData extends TemplateData> = DocumentManifest | ((args: TemplateRenderArgs<TData>) => DocumentManifest);
+/**
+ * Output of `defineTemplate`. The brand symbol is non-enumerable so
+ * it doesn't pollute `Object.keys` / JSON serialization but stays
+ * load-bearing for runtime identification via `isTemplate`.
+ *
+ * Dep declarations (`[K in keyof TemplateDepRegistry]?`) live directly
+ * on the template object so the framework's per-request dispatch can
+ * read them via `template[kind]` and fire the registered loaders.
+ */
+export interface Template<TData extends TemplateData = TemplateData> extends TemplateDepDeclarations {
+    readonly render: TemplateRender<TData>;
+    readonly document?: TemplateDocument<TData>;
+    /**
+     * Cost is `O(entries × loaders/entry)`. Assumes `node.id` is unique
+     * across all entries' block trees — editor content satisfies this;
+     * bulk imports must ensure unique ids or sibling loader data
+     * silently collides in the per-id result map.
+     */
+    readonly prefetchListingLoaders?: boolean;
+    readonly [PLUMIX_TEMPLATE_BRAND]: true;
+}
+interface DefineTemplateConfig<TData extends TemplateData> extends TemplateDepDeclarations {
+    readonly render: TemplateRender<TData>;
+    readonly document?: TemplateDocument<TData>;
+    readonly prefetchListingLoaders?: boolean;
+}
+export declare function defineTemplate<TData extends TemplateData = TemplateData>(config: DefineTemplateConfig<TData>): Template<TData>;
+export declare function isTemplate(value: unknown): value is Template<TemplateData>;
+/**
+ * Boot-time normalizer. Plain function templates (the existing
+ * `TemplateComponent` form) get wrapped into a branded `Template`;
+ * factory-built templates pass through verbatim. Hand-written
+ * `{ render: fn }` literals — close to but not from the factory —
+ * fail loud so a future deps / document-fragment field doesn't get
+ * silently ignored on a malformed registration.
+ */
+export declare function normalizeTemplate(value: unknown, slot: string): Template<TemplateData>;
+export {};
+//# sourceMappingURL=template.d.ts.map

package/dist/template.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"template.d.ts","sourceRoot":"","sources":["../src/template.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAiB,SAAS,EAAE,MAAM,OAAO,CAAC;AAGtD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AACnD,OAAO,KAAK,EAAE,gBAAgB,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAQjE,QAAA,MAAM,qBAAqB,EAAE,OAAO,MAAkC,CAAC;AAEvE;;;;;;;;;;GAUG;AAEH,MAAM,WAAW,mBAAmB;CAAG;AAEvC;;;;;;GAMG;AACH,MAAM,MAAM,uBAAuB,GAAG;IACpC,QAAQ,EAAE,CAAC,IAAI,MAAM,mBAAmB,CAAC,CAAC,EACtC,SAAS,mBAAmB,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,EAAE,GACzC,CAAC,CACC,IAAI,EAAE,SAAS,mBAAmB,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,EAAE,KAC5C,SAAS,mBAAmB,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC;CACpD,CAAC;AAEF;;;;GAIG;AACH,KAAK,kBAAkB,GAAG;IACxB,QAAQ,EAAE,CAAC,IAAI,MAAM,mBAAmB,CAAC,CAAC,EAAE,QAAQ,CAClD,MAAM,CAAC,MAAM,EAAE,mBAAmB,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,GAAG,IAAI,CAAC,CACxD;CACF,CAAC;AAEF,MAAM,WAAW,kBAAkB,CACjC,KAAK,SAAS,YAAY,CAC1B,SAAQ,kBAAkB;IAC1B,QAAQ,CAAC,IAAI,EAAE,KAAK,CAAC;IACrB,QAAQ,CAAC,GAAG,EAAE,UAAU,CAAC;CAC1B;AAED,MAAM,MAAM,cAAc,CAAC,KAAK,SAAS,YAAY,IAAI,CACvD,IAAI,EAAE,kBAAkB,CAAC,KAAK,CAAC,KAC5B,SAAS,CAAC;AAEf;;;GAGG;AACH,KAAK,gBAAgB,CAAC,KAAK,SAAS,YAAY,IAC9C,gBAAgB,GAAG,CAAC,CAAC,IAAI,EAAE,kBAAkB,CAAC,KAAK,CAAC,KAAK,gBAAgB,CAAC,CAAC;AAE7E;;;;;;;;GAQG;AACH,MAAM,WAAW,QAAQ,CACvB,KAAK,SAAS,YAAY,GAAG,YAAY,CACzC,SAAQ,uBAAuB;IAC/B,QAAQ,CAAC,MAAM,EAAE,cAAc,CAAC,KAAK,CAAC,CAAC;IACvC,QAAQ,CAAC,QAAQ,CAAC,EAAE,gBAAgB,CAAC,KAAK,CAAC,CAAC;IAC5C;;;;;OAKG;IACH,QAAQ,CAAC,sBAAsB,CAAC,EAAE,OAAO,CAAC;IAC1C,QAAQ,CAAC,CAAC,qBAAqB,CAAC,EAAE,IAAI,CAAC;CACxC;AAED,UAAU,oBAAoB,CAC5B,KAAK,SAAS,YAAY,CAC1B,SAAQ,uBAAuB;IAC/B,QAAQ,CAAC,MAAM,EAAE,cAAc,CAAC,KAAK,CAAC,CAAC;IACvC,QAAQ,CAAC,QAAQ,CAAC,EAAE,gBAAgB,CAAC,KAAK,CAAC,CAAC;IAC5C,QAAQ,CAAC,sBAAsB,CAAC,EAAE,OAAO,CAAC;CAC3C;AAED,wBAAgB,cAAc,CAAC,KAAK,SAAS,YAAY,GAAG,YAAY,EACtE,MAAM,EAAE,oBAAoB,CAAC,KAAK,CAAC,GAClC,QAAQ,CAAC,KAAK,CAAC,CAejB;AAED,wBAAgB,UAAU,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,QAAQ,CAAC,YAAY,CAAC,CAM1E;AAED;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,OAAO,EACd,IAAI,EAAE,MAAM,GACX,QAAQ,CAAC,YAAY,CAAC,CAgBxB"}

package/dist/template.js

@@ -0,0 +1,54 @@
+import { createElement } from "react";
+import { ThemeRegistrationError } from "./theme-errors.js";
+// Module-local brand — not `Symbol.for(...)`. The global registry
+// would let any caller forge a fake template via
+// `Symbol.for("plumix.template")`, defeating the whole point of the
+// brand. A module-local symbol is only obtainable through this
+// file's exports (`defineTemplate`, `isTemplate`).
+const PLUMIX_TEMPLATE_BRAND = Symbol("plumix.template");
+export function defineTemplate(config) {
+    // Copy every config key onto the template object. That preserves
+    // any declared dep kinds (`settings`, `menus`, ...) which live as
+    // top-level slug arrays — the framework's per-request dispatch
+    // reads `template[kind]` to know which loaders to fire. `render` +
+    // `document` come along the same way.
+    const template = { ...config };
+    // `enumerable: false` keeps the brand out of `Object.keys` / JSON;
+    // writable/configurable defaults are fine — the symbol itself is
+    // module-local so no caller can forge or rewrite it.
+    Object.defineProperty(template, PLUMIX_TEMPLATE_BRAND, {
+        value: true,
+        enumerable: false,
+    });
+    return template;
+}
+export function isTemplate(value) {
+    return (typeof value === "object" &&
+        value !== null &&
+        value[PLUMIX_TEMPLATE_BRAND] === true);
+}
+/**
+ * Boot-time normalizer. Plain function templates (the existing
+ * `TemplateComponent` form) get wrapped into a branded `Template`;
+ * factory-built templates pass through verbatim. Hand-written
+ * `{ render: fn }` literals — close to but not from the factory —
+ * fail loud so a future deps / document-fragment field doesn't get
+ * silently ignored on a malformed registration.
+ */
+export function normalizeTemplate(value, slot) {
+    if (isTemplate(value))
+        return value;
+    if (typeof value === "function") {
+        // Invoke the legacy template via `createElement` so it runs inside
+        // React's render pass — preserves hooks (useState, useId, etc.)
+        // and supports both function and class components. Calling the
+        // function directly would throw "Invalid hook call" the moment a
+        // theme author reaches for a hook.
+        const ComponentLike = value;
+        return defineTemplate({
+            render: ({ data }) => createElement(ComponentLike, { data }),
+        });
+    }
+    throw ThemeRegistrationError.invalidTemplate({ slot });
+}
+//# sourceMappingURL=template.js.map

package/dist/template.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"template.js","sourceRoot":"","sources":["../src/template.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,MAAM,OAAO,CAAC;AAItC,OAAO,EAAE,sBAAsB,EAAE,MAAM,mBAAmB,CAAC;AAE3D,kEAAkE;AAClE,iDAAiD;AACjD,oEAAoE;AACpE,+DAA+D;AAC/D,mDAAmD;AACnD,MAAM,qBAAqB,GAAkB,MAAM,CAAC,iBAAiB,CAAC,CAAC;AA4FvE,MAAM,UAAU,cAAc,CAC5B,MAAmC;IAEnC,iEAAiE;IACjE,kEAAkE;IAClE,+DAA+D;IAC/D,mEAAmE;IACnE,sCAAsC;IACtC,MAAM,QAAQ,GAAqC,EAAE,GAAG,MAAM,EAAE,CAAC;IACjE,mEAAmE;IACnE,iEAAiE;IACjE,qDAAqD;IACrD,MAAM,CAAC,cAAc,CAAC,QAAQ,EAAE,qBAAqB,EAAE;QACrD,KAAK,EAAE,IAAI;QACX,UAAU,EAAE,KAAK;KAClB,CAAC,CAAC;IACH,OAAO,QAAsC,CAAC;AAChD,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,KAAc;IACvC,OAAO,CACL,OAAO,KAAK,KAAK,QAAQ;QACzB,KAAK,KAAK,IAAI;QACb,KAAiC,CAAC,qBAAqB,CAAC,KAAK,IAAI,CACnE,CAAC;AACJ,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,iBAAiB,CAC/B,KAAc,EACd,IAAY;IAEZ,IAAI,UAAU,CAAC,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC;IACpC,IAAI,OAAO,KAAK,KAAK,UAAU,EAAE,CAAC;QAChC,mEAAmE;QACnE,gEAAgE;QAChE,+DAA+D;QAC/D,iEAAiE;QACjE,mCAAmC;QACnC,MAAM,aAAa,GAAG,KAEpB,CAAC;QACH,OAAO,cAAc,CAAC;YACpB,MAAM,EAAE,CAAC,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC,aAAa,CAAC,aAAa,EAAE,EAAE,IAAI,EAAE,CAAC;SAC7D,CAAC,CAAC;IACL,CAAC;IACD,MAAM,sBAAsB,CAAC,eAAe,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC;AACzD,CAAC"}

package/dist/terms/errors.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Domain error the terms read service throws. The `data` discriminant carries
+ * what each transport needs — oRPC maps it via {@link toRpcTermReadError}.
+ * Mirrors `src/entries/errors.ts`.
+ */
+export declare class TermReadError extends Error {
+    readonly data: {
+        readonly code: "taxonomy_not_found";
+        readonly taxonomy: string;
+    } | {
+        readonly code: "term_not_found";
+        readonly termId: number;
+    } | {
+        readonly code: "forbidden";
+        readonly capability: string;
+    };
+    private constructor();
+    static taxonomyNotFound(taxonomy: string): TermReadError;
+    static termNotFound(termId: number): TermReadError;
+    static forbidden(capability: string): TermReadError;
+}
+//# sourceMappingURL=errors.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/terms/errors.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,qBAAa,aAAc,SAAQ,KAAK;IAKtC,QAAQ,CAAC,IAAI,EACT;QAAE,QAAQ,CAAC,IAAI,EAAE,oBAAoB,CAAC;QAAC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,GAClE;QAAE,QAAQ,CAAC,IAAI,EAAE,gBAAgB,CAAC;QAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;KAAE,GAC5D;QAAE,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAC;QAAC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;KAAE,CAAC;IAEhE,OAAO;IAKP,MAAM,CAAC,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,aAAa;IAOxD,MAAM,CAAC,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,aAAa;IAOlD,MAAM,CAAC,SAAS,CAAC,UAAU,EAAE,MAAM,GAAG,aAAa;CAMpD"}

package/dist/terms/errors.js

@@ -0,0 +1,25 @@
+/**
+ * Domain error the terms read service throws. The `data` discriminant carries
+ * what each transport needs — oRPC maps it via {@link toRpcTermReadError}.
+ * Mirrors `src/entries/errors.ts`.
+ */
+export class TermReadError extends Error {
+    static {
+        TermReadError.prototype.name = "TermReadError";
+    }
+    data;
+    constructor(data, message) {
+        super(message);
+        this.data = data;
+    }
+    static taxonomyNotFound(taxonomy) {
+        return new TermReadError({ code: "taxonomy_not_found", taxonomy }, `unknown taxonomy: ${taxonomy}`);
+    }
+    static termNotFound(termId) {
+        return new TermReadError({ code: "term_not_found", termId }, `term ${termId} not found`);
+    }
+    static forbidden(capability) {
+        return new TermReadError({ code: "forbidden", capability }, `missing capability: ${capability}`);
+    }
+}
+//# sourceMappingURL=errors.js.map

package/dist/terms/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/terms/errors.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,OAAO,aAAc,SAAQ,KAAK;IACtC;QACE,aAAa,CAAC,SAAS,CAAC,IAAI,GAAG,eAAe,CAAC;IACjD,CAAC;IAEQ,IAAI,CAGmD;IAEhE,YAAoB,IAA2B,EAAE,OAAe;QAC9D,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;IACnB,CAAC;IAED,MAAM,CAAC,gBAAgB,CAAC,QAAgB;QACtC,OAAO,IAAI,aAAa,CACtB,EAAE,IAAI,EAAE,oBAAoB,EAAE,QAAQ,EAAE,EACxC,qBAAqB,QAAQ,EAAE,CAChC,CAAC;IACJ,CAAC;IAED,MAAM,CAAC,YAAY,CAAC,MAAc;QAChC,OAAO,IAAI,aAAa,CACtB,EAAE,IAAI,EAAE,gBAAgB,EAAE,MAAM,EAAE,EAClC,QAAQ,MAAM,YAAY,CAC3B,CAAC;IACJ,CAAC;IAED,MAAM,CAAC,SAAS,CAAC,UAAkB;QACjC,OAAO,IAAI,aAAa,CACtB,EAAE,IAAI,EAAE,WAAW,EAAE,UAAU,EAAE,EACjC,uBAAuB,UAAU,EAAE,CACpC,CAAC;IACJ,CAAC;CACF"}

package/dist/terms/read-service.d.ts

@@ -0,0 +1,20 @@
+import type { AppContext } from "../context/app.js";
+import type { Term } from "../db/schema/terms.js";
+import type { TermGetInput, TermListInput } from "../rpc/procedures/term/schemas.js";
+type TermRead = Omit<Term, "meta"> & {
+    readonly meta: Record<string, unknown>;
+};
+/**
+ * List terms in a taxonomy the caller may read. The taxonomy must be
+ * registered and the caller must hold its read capability; both checks live
+ * here so every transport reads through one policy. Throws {@link TermReadError}.
+ */
+export declare function listTerms(ctx: AppContext, input: TermListInput): Promise<readonly Term[]>;
+/**
+ * Read a single term by id, hydrated with decoded meta. A missing term and one
+ * in a taxonomy the caller can't read both collapse to `term_not_found` so
+ * existence stays hidden.
+ */
+export declare function getTerm(ctx: AppContext, input: TermGetInput): Promise<TermRead>;
+export {};
+//# sourceMappingURL=read-service.d.ts.map

package/dist/terms/read-service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"read-service.d.ts","sourceRoot":"","sources":["../../src/terms/read-service.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,uBAAuB,CAAC;AAClD,OAAO,KAAK,EACV,YAAY,EACZ,aAAa,EACd,MAAM,mCAAmC,CAAC;AAO3C,KAAK,QAAQ,GAAG,IAAI,CAAC,IAAI,EAAE,MAAM,CAAC,GAAG;IAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAAE,CAAC;AAEhF;;;;GAIG;AACH,wBAAsB,SAAS,CAC7B,GAAG,EAAE,UAAU,EACf,KAAK,EAAE,aAAa,GACnB,OAAO,CAAC,SAAS,IAAI,EAAE,CAAC,CAwB1B;AAED;;;;GAIG;AACH,wBAAsB,OAAO,CAC3B,GAAG,EAAE,UAAU,EACf,KAAK,EAAE,YAAY,GAClB,OAAO,CAAC,QAAQ,CAAC,CAWnB"}

package/dist/terms/read-service.js

@@ -0,0 +1,53 @@
+import { and, asc, eq, isNull, like } from "../db/index.js";
+import { terms } from "../db/schema/terms.js";
+import { taxonomyCapability } from "../rpc/procedures/term/helpers.js";
+import { decodeMetaBag } from "../rpc/procedures/term/meta.js";
+import { TermReadError } from "./errors.js";
+/**
+ * List terms in a taxonomy the caller may read. The taxonomy must be
+ * registered and the caller must hold its read capability; both checks live
+ * here so every transport reads through one policy. Throws {@link TermReadError}.
+ */
+export async function listTerms(ctx, input) {
+    if (!ctx.plugins.termTaxonomies.has(input.taxonomy)) {
+        throw TermReadError.taxonomyNotFound(input.taxonomy);
+    }
+    const readCap = taxonomyCapability(input.taxonomy, "read");
+    if (!ctx.auth.can(readCap))
+        throw TermReadError.forbidden(readCap);
+    const conditions = [eq(terms.taxonomy, input.taxonomy)];
+    if (input.parentId === null) {
+        conditions.push(isNull(terms.parentId));
+    }
+    else if (input.parentId !== undefined) {
+        conditions.push(eq(terms.parentId, input.parentId));
+    }
+    if (input.search && input.search.length > 0) {
+        conditions.push(like(terms.name, `%${input.search}%`));
+    }
+    return ctx.db
+        .select()
+        .from(terms)
+        .where(and(...conditions))
+        .orderBy(asc(terms.name), asc(terms.id))
+        .limit(input.limit)
+        .offset(input.offset);
+}
+/**
+ * Read a single term by id, hydrated with decoded meta. A missing term and one
+ * in a taxonomy the caller can't read both collapse to `term_not_found` so
+ * existence stays hidden.
+ */
+export async function getTerm(ctx, input) {
+    const row = await ctx.db.query.terms.findFirst({
+        where: eq(terms.id, input.id),
+    });
+    if (!row)
+        throw TermReadError.termNotFound(input.id);
+    if (!ctx.auth.can(taxonomyCapability(row.taxonomy, "read"))) {
+        throw TermReadError.termNotFound(input.id);
+    }
+    const meta = decodeMetaBag(ctx.plugins, row.taxonomy, row.meta);
+    return { ...row, meta };
+}
+//# sourceMappingURL=read-service.js.map

package/dist/terms/read-service.js.map

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

package/dist/test/default-theme.d.ts

@@ -0,0 +1,2 @@
+export declare const defaultTestTheme: import("../theme.js").ThemeDescriptor;
+//# sourceMappingURL=default-theme.d.ts.map

package/dist/test/default-theme.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"default-theme.d.ts","sourceRoot":"","sources":["../../src/test/default-theme.tsx"],"names":[],"mappings":"AAQA,eAAO,MAAM,gBAAgB,uCA4B3B,CAAC"}

package/dist/test/default-theme.js

@@ -0,0 +1,28 @@
+import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
+import { renderTiptapContent } from "../route/render/tiptap.js";
+import { defineTheme } from "../theme.js";
+// Test-only theme that mirrors the structure of the dropped inline-HTML
+// fallback so resolver tests keep their `body.toContain("<h1>{title}</h1>")`
+// assertions. Authored as a single `index` template that branches on the
+// data shape — real themes narrow via the per-key registry.
+export const defaultTestTheme = defineTheme({
+    templates: {
+        index({ data }) {
+            if ("entry" in data) {
+                return (_jsxs("article", { children: [_jsx("h1", { children: data.entry.title }), data.entry.content ? (_jsx("div", { dangerouslySetInnerHTML: {
+                                __html: renderTiptapContent(data.entry.content),
+                            } })) : null] }));
+            }
+            if ("entries" in data) {
+                return (_jsxs(_Fragment, { children: ["term" in data ? _jsx("h1", { children: data.term.name }) : null, _jsx(EntryList, { entries: data.entries })] }));
+            }
+            return null;
+        },
+    },
+});
+function EntryList({ entries }) {
+    if (entries.length === 0)
+        return _jsx("p", { children: "No entries yet." });
+    return (_jsx("ul", { children: entries.map((e) => (_jsx("li", { children: _jsx("a", { href: `/${e.type}/${e.slug}`, children: e.title }) }, e.id))) }));
+}
+//# sourceMappingURL=default-theme.js.map

package/dist/test/default-theme.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"default-theme.js","sourceRoot":"","sources":["../../src/test/default-theme.tsx"],"names":[],"mappings":";AACA,OAAO,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAC;AAChE,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE1C,wEAAwE;AACxE,6EAA6E;AAC7E,yEAAyE;AACzE,4DAA4D;AAC5D,MAAM,CAAC,MAAM,gBAAgB,GAAG,WAAW,CAAC;IAC1C,SAAS,EAAE;QACT,KAAK,CAAC,EAAE,IAAI,EAAE;YACZ,IAAI,OAAO,IAAI,IAAI,EAAE,CAAC;gBACpB,OAAO,CACL,8BACE,uBAAK,IAAI,CAAC,KAAK,CAAC,KAAK,GAAM,EAC1B,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,CACpB,cACE,uBAAuB,EAAE;gCACvB,MAAM,EAAE,mBAAmB,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC;6BAChD,GACD,CACH,CAAC,CAAC,CAAC,IAAI,IACA,CACX,CAAC;YACJ,CAAC;YACD,IAAI,SAAS,IAAI,IAAI,EAAE,CAAC;gBACtB,OAAO,CACL,8BACG,MAAM,IAAI,IAAI,CAAC,CAAC,CAAC,uBAAK,IAAI,CAAC,IAAI,CAAC,IAAI,GAAM,CAAC,CAAC,CAAC,IAAI,EAClD,KAAC,SAAS,IAAC,OAAO,EAAE,IAAI,CAAC,OAAO,GAAI,IACnC,CACJ,CAAC;YACJ,CAAC;YACD,OAAO,IAAI,CAAC;QACd,CAAC;KACF;CACF,CAAC,CAAC;AAEH,SAAS,SAAS,CAAC,EAAE,OAAO,EAAyC;IACnE,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,0CAAsB,CAAC;IACxD,OAAO,CACL,uBACG,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAClB,uBACE,YAAG,IAAI,EAAE,IAAI,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,IAAI,EAAE,YAAG,CAAC,CAAC,KAAK,GAAK,IADvC,CAAC,CAAC,EAAE,CAER,CACN,CAAC,GACC,CACN,CAAC;AACJ,CAAC"}

package/dist/test/defer.d.ts

@@ -0,0 +1,19 @@
+import type { DeferFn } from "../context/app.js";
+export interface DeferQueue {
+    /** Pass to `createAppContext({ defer })` so handlers route here. */
+    readonly defer: DeferFn;
+    /**
+     * Wait for every promise queued so far to settle (rejections are
+     * swallowed — the test asserts on observable side effects, not on
+     * the promise return values). Subsequent `defer` calls are queued
+     * onto the same array, so a follow-up `drainDeferred()` picks them
+     * up.
+     *
+     * `this: void` annotation lets callers destructure freely
+     * (`const { drainDeferred } = createDeferQueue()`) without the
+     * unbound-method lint rule complaining.
+     */
+    drainDeferred(this: void): Promise<void>;
+}
+export declare function createDeferQueue(): DeferQueue;
+//# sourceMappingURL=defer.d.ts.map

package/dist/test/defer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"defer.d.ts","sourceRoot":"","sources":["../../src/test/defer.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AAEjD,MAAM,WAAW,UAAU;IACzB,oEAAoE;IACpE,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;IACxB;;;;;;;;;;OAUG;IACH,aAAa,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC1C;AAED,wBAAgB,gBAAgB,IAAI,UAAU,CAc7C"}

package/dist/test/defer.js

@@ -0,0 +1,22 @@
+// Test harness for `AppContext.defer`. Production runtimes route
+// fire-and-forget work through their platform primitive (CF Workers'
+// `waitUntil`, Node's event loop). Tests need a deterministic queue
+// they can flush + await before asserting on side effects, so this
+// helper builds a `defer` implementation backed by an array plus a
+// `drainDeferred()` that waits for everything queued so far.
+export function createDeferQueue() {
+    const queued = [];
+    return {
+        defer: (promise) => {
+            queued.push(promise);
+        },
+        drainDeferred: async () => {
+            // Splice rather than re-assign so a re-entrant `defer` during
+            // the await captures into the SAME array — chained drains see
+            // the new entries.
+            const batch = queued.splice(0, queued.length);
+            await Promise.allSettled(batch);
+        },
+    };
+}
+//# sourceMappingURL=defer.js.map

package/dist/test/defer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"defer.js","sourceRoot":"","sources":["../../src/test/defer.ts"],"names":[],"mappings":"AAAA,iEAAiE;AACjE,qEAAqE;AACrE,oEAAoE;AACpE,mEAAmE;AACnE,mEAAmE;AACnE,6DAA6D;AAqB7D,MAAM,UAAU,gBAAgB;IAC9B,MAAM,MAAM,GAAuB,EAAE,CAAC;IACtC,OAAO;QACL,KAAK,EAAE,CAAC,OAAO,EAAE,EAAE;YACjB,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QACvB,CAAC;QACD,aAAa,EAAE,KAAK,IAAI,EAAE;YACxB,8DAA8D;YAC9D,8DAA8D;YAC9D,mBAAmB;YACnB,MAAM,KAAK,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC;YAC9C,MAAM,OAAO,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC;QAClC,CAAC;KACF,CAAC;AACJ,CAAC"}