@jini-ai/cms 0.1.0

package/dist/navigation/tool-registrations.js

@@ -0,0 +1,126 @@
+import { buildDomainRegistrations, indexCatalogById, requireInputRecord, requireNumber, requireString, requireToolPermission, withSchemaOnRejection, } from "../core/tools/registration-kit.js";
+import { menusAgentToolCatalog } from "./agent-tools.js";
+import { assignLocation, createMenu, MenuNotFoundError, MenuValidationError, updateMenuTree } from "./menu-service.js";
+const CATALOG_BY_ID = indexCatalogById(menusAgentToolCatalog);
+/**
+ * This wiring layer's OWN risk classification, authored from what each handler below actually
+ * calls. See `DerivedRiskByToolId` in the kit for why it is independent of the catalog's own
+ * `sideEffects` declaration.
+ */
+export const menusDerivedRisk = new Map([
+    // -> menuRepo.list: reads only.
+    ["menus_list_menus", "none"],
+    // -> menuRepo.findById: reads only.
+    ["menus_get_menu", "none"],
+    // -> createMenu (menu-service.ts): repo.save + outbox.enqueue.
+    ["menus_create_menu", "mutates-durable-state"],
+    // -> updateMenuTree (menu-service.ts): repo.save + outbox.enqueue.
+    ["menus_update_menu_tree", "mutates-durable-state"],
+    // -> assignLocation (menu-service.ts): repo.save (maybe twice, on displacement) + bindingRepo.upsert
+    //    + outbox.enqueue. Never a delete: deleteMenu is deliberately not exposed (see
+    //    navigation/agent-tools.ts's file header).
+    ["menus_assign_location", "mutates-durable-state"],
+]);
+/** The only Menus rejection worth decorating with the published schema — a shape problem a different input would fix. */
+function isMenusShapeRejection(error) {
+    return error instanceof MenuValidationError;
+}
+/**
+ * Projects a `NavMenuEntry` into an explicit model-facing shape rather than returning the domain
+ * record verbatim — the same discipline Forms' `toFormDefinitionView` applies. `items` is
+ * deep-cloned via a JSON round-trip (the tree is JSON-serializable by construction, `types.ts`'s
+ * `NavMenuDoc` doc comment) rather than shallow-copied, since a tool caller pushing onto a nested
+ * `children` array must not be able to mutate domain state through the returned view the way a
+ * single top-level spread could not protect against.
+ */
+function toMenuToolView(menu) {
+    return {
+        id: menu.id,
+        slug: menu.slug,
+        title: menu.title,
+        status: menu.status,
+        items: JSON.parse(JSON.stringify(menu.doc.items)),
+        locations: [...menu.locations],
+        version: menu.version,
+    };
+}
+function menusDeps(routeDeps) {
+    return { repo: routeDeps.menuRepo, clock: routeDeps.clock, idGen: routeDeps.idGen, outbox: routeDeps.outbox };
+}
+export function buildMenusRegistrations(routeDeps) {
+    const handlers = {
+        menus_list_menus: async (ctx) => {
+            await requireToolPermission(routeDeps, { principalId: ctx.principal.id, permission: "admin.menus.read", entityType: "menu" });
+            const menus = await routeDeps.menuRepo.list({ workspaceId: routeDeps.workspaceId });
+            return { menus: menus.map(toMenuToolView) };
+        },
+        menus_get_menu: async (ctx) => {
+            const menuId = requireString(requireInputRecord(ctx.input), "menuId");
+            await requireToolPermission(routeDeps, { principalId: ctx.principal.id, permission: "admin.menus.read", entityType: "menu", entityId: menuId });
+            const menu = await routeDeps.menuRepo.findById({ workspaceId: routeDeps.workspaceId, id: menuId });
+            if (!menu)
+                throw new MenuNotFoundError(`menu '${menuId}' was not found`);
+            return { menu: toMenuToolView(menu) };
+        },
+        menus_create_menu: async (ctx) => {
+            const input = requireInputRecord(ctx.input);
+            await requireToolPermission(routeDeps, { principalId: ctx.principal.id, permission: "admin.menus.create", entityType: "menu" });
+            return withSchemaOnRejection({ toolId: "menus_create_menu", catalog: CATALOG_BY_ID, isShapeRejection: isMenusShapeRejection }, async () => {
+                const { menu } = await createMenu({
+                    deps: menusDeps(routeDeps),
+                    input: {
+                        workspaceId: routeDeps.workspaceId,
+                        title: requireString(input, "title"),
+                        slug: requireString(input, "slug"),
+                        items: Array.isArray(input.items) ? input.items : undefined,
+                    },
+                });
+                return { menu: toMenuToolView(menu) };
+            });
+        },
+        menus_update_menu_tree: async (ctx) => {
+            const input = requireInputRecord(ctx.input);
+            const menuId = requireString(input, "menuId");
+            await requireToolPermission(routeDeps, { principalId: ctx.principal.id, permission: "admin.menus.update", entityType: "menu", entityId: menuId });
+            if (!Array.isArray(input.items))
+                throw new Error("'items' (array) is required");
+            return withSchemaOnRejection({ toolId: "menus_update_menu_tree", catalog: CATALOG_BY_ID, isShapeRejection: isMenusShapeRejection }, async () => {
+                const { menu } = await updateMenuTree({
+                    deps: menusDeps(routeDeps),
+                    input: {
+                        workspaceId: routeDeps.workspaceId,
+                        id: menuId,
+                        expectedVersion: requireNumber(input, "expectedVersion"),
+                        title: typeof input.title === "string" ? input.title : undefined,
+                        slug: typeof input.slug === "string" ? input.slug : undefined,
+                        items: input.items,
+                    },
+                });
+                return { menu: toMenuToolView(menu) };
+            });
+        },
+        menus_assign_location: async (ctx) => {
+            const input = requireInputRecord(ctx.input);
+            const menuId = requireString(input, "menuId");
+            await requireToolPermission(routeDeps, { principalId: ctx.principal.id, permission: "admin.menus.assign", entityType: "menu", entityId: menuId });
+            const { menu, binding, displacedMenu } = await assignLocation({
+                deps: { ...menusDeps(routeDeps), bindingRepo: routeDeps.navLocationBindingRepo },
+                input: { workspaceId: routeDeps.workspaceId, menuId, locationKey: requireString(input, "locationKey") },
+            });
+            return {
+                menu: toMenuToolView(menu),
+                binding: { locationKey: binding.locationKey, menuId: binding.menuId },
+                displacedMenu: displacedMenu ? toMenuToolView(displacedMenu) : null,
+            };
+        },
+    };
+    // No `unwiredToolIds`: Menus wires its ENTIRE catalog, same tripwire discipline as Forms.
+    return buildDomainRegistrations({
+        domain: "menus",
+        catalogModule: "navigation/agent-tools.ts",
+        catalog: CATALOG_BY_ID,
+        handlers,
+        derivedRisk: menusDerivedRisk,
+    });
+}
+//# sourceMappingURL=tool-registrations.js.map

package/dist/navigation/tool-registrations.js.map

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

package/dist/navigation/types.d.ts

@@ -0,0 +1,207 @@
+/**
+ * @file Core type definitions for the `navigation` library.
+ *
+ * Purpose:
+ * Menus/nav are **navigation trees as editable content**. A menu is a generic
+ * content entry (type `menu`); its ordered, nested item tree lives in the
+ * entry's validated `bodyJson` as a `navigation`-namespaced block vocabulary.
+ * Link targets that point at other content (entries, taxonomy terms) are `ref`
+ * values so the write-chokepoint extracts them into the rebuildable
+ * `entry_refs` index (where-used + safe-delete), exactly as the media library reuses it
+ * for media. External URLs and named routes carry no ref.
+ *
+ * How it relates to the project:
+ * - `core/ports.ts` supplies the shared primitives (`UUID`, `JsonObject`, …).
+ * - `navigation/ports.ts` declares the one rule-of-two port this library adds
+ *   (`NavLocationBindingRepoPort`) plus the typed-call resolver contract.
+ * - The theme renderer consumes `ResolvedNav` (data only — no theme code
+ *   resolves refs; the render-IR boundary).
+ *
+ * Architectural role:
+ * INTERFACES + TYPES ONLY (no feature logic). This is the design-frozen shape
+ * this library introduces; the entries repo, revisions, `entry_refs`, and the command
+ * gateway are reused unchanged from the generic entries model.
+ */
+import type { ISODateTime, JsonObject, UUID } from "../core/ports.js";
+/**
+ * `menu` ships as a **seeded content-type registry row**, like
+ * `post`/`page`/`media`. Core may special-case it in admin UI/rendering, never
+ * in storage. The extension-field owner namespace for menu-level fields
+ * (`fields.ext.navigation.*`) is `navigation`.
+ */
+export declare const NAV_MENU_CONTENT_TYPE: "menu";
+export declare const NAV_FIELD_NAMESPACE: "navigation";
+/** Discriminator marking an entry's `bodyJson` as a navigation tree document. */
+export declare const NAV_DOC_TYPE: "menu";
+/**
+ * The v1 link-target kinds. `entryRef`/`termRef` are integrity-tracked (their
+ * ids are extracted to `entry_refs`); `url`/`route` are validated-only.
+ */
+export type NavTargetKind = "entryRef" | "termRef" | "url" | "route";
+/**
+ * Reserved-but-rejected target kinds — the named deferred seams.
+ * Recognized by the validator and **rejected with a clear "coming later" error**
+ * until their resolver stage ships, so the discriminant never has to widen in a
+ * breaking way. `dynamicQuery` needs a total/bounded expression
+ * language; `content` needs a mega-menu block-embed resolver.
+ */
+export type ReservedNavTargetKind = "dynamicQuery" | "content";
+/** A link to another content entry (page/post/media/…). Integrity-tracked. */
+export interface NavEntryTarget {
+    readonly kind: "entryRef";
+    /** Target entry id. Extracted to `entry_refs` at the write chokepoint. */
+    readonly entryId: UUID;
+}
+/** A link to a taxonomy term (category/tag archive). Integrity-tracked. */
+export interface NavTermTarget {
+    readonly kind: "termRef";
+    /** Target term id. Extracted to `entry_refs` (target kind = term). */
+    readonly termId: UUID;
+    /** Taxonomy the term belongs to, for archive-route resolution. */
+    readonly taxonomy: string;
+}
+/** An absolute or site-relative external URL. Validated, not ref-tracked. */
+export interface NavUrlTarget {
+    readonly kind: "url";
+    /** Sanitized/validated at write time (scheme allowlist, no `javascript:`). */
+    readonly href: string;
+}
+/** A named core route (e.g. `home`, `search`), resolved by the routing lib. */
+export interface NavRouteTarget {
+    readonly kind: "route";
+    readonly route: string;
+    /** Optional static params passed to the route resolver. */
+    readonly params?: JsonObject | undefined;
+}
+/** v1 discriminated union of link targets. */
+export type NavTarget = NavEntryTarget | NavTermTarget | NavUrlTarget | NavRouteTarget;
+/**
+ * Presentational attributes carried on an item, kept separate from identity and
+ * target so the render model can pass them through without interpreting them.
+ */
+export interface NavItemAttrs {
+    readonly openInNewTab?: boolean | undefined;
+    /** `rel` tokens (e.g. `nofollow`), validated against an allowlist. */
+    readonly rel?: string | undefined;
+    /** Theme-facing CSS class hint. */
+    readonly cssClass?: string | undefined;
+    /** Optional description/subtitle (mega-menu-adjacent, cosmetic in v1). */
+    readonly description?: string | undefined;
+    /** Icon token resolved by the theme's icon set, if any. */
+    readonly icon?: string | undefined;
+}
+/**
+ * One node in the menu tree. **Ordering = array order** among siblings;
+ * **nesting = `children`**. `id` is a **stable ULID minted on item creation and
+ * preserved across edits/moves** (never regenerated on reorder) — the stable
+ * identity `entry_refs` locators and per-item caches depend on (a discipline
+ * discipline applied within the doc). The chokepoint validator enforces id
+ * stability and bounded depth/breadth.
+ */
+export interface NavItemNode {
+    readonly id: UUID;
+    /** Editable display label. Falls back to the target's title when absent. */
+    readonly label?: string | undefined;
+    readonly target: NavTarget;
+    readonly attrs?: NavItemAttrs | undefined;
+    /** Child items (one level of nesting per depth). */
+    readonly children?: readonly NavItemNode[] | undefined;
+}
+/**
+ * The full navigation document stored in a menu entry's `bodyJson`. Shaped so it
+ * satisfies `JsonObject` structurally (all fields are JSON-serializable), which
+ * keeps it inside the storage contract and the serializable
+ * ABI.
+ */
+export interface NavMenuDoc {
+    readonly type: typeof NAV_DOC_TYPE;
+    /** Doc-schema version, so the validator can migrate shapes later. */
+    readonly version: number;
+    readonly items: readonly NavItemNode[];
+}
+export type MenuStatus = "draft" | "published" | "trash";
+/**
+ * A typed read model over a `type='menu'` entries row (universal
+ * columns) plus the parsed `bodyJson` tree and the `navigation`-namespaced
+ * fields. This is a **projection**, not a new table — menus are entries.
+ */
+export interface NavMenuEntry {
+    readonly id: UUID;
+    readonly workspaceId: UUID;
+    /** Stable machine handle, e.g. `primary-nav` (the entry `slug`). */
+    readonly slug: string;
+    /** Human menu name (the entry `title`). */
+    readonly title: string;
+    readonly status: MenuStatus;
+    /** The parsed navigation tree (entry `bodyJson`). */
+    readonly doc: NavMenuDoc;
+    /**
+     * Theme-location keys this menu is assigned to fill
+     * (`fields.ext.navigation.locations`). Source of truth for assignment;
+     * the binding index (below) is the derived, uniqueness-enforcing projection.
+     */
+    readonly locations: readonly string[];
+    readonly updatedAt: ISODateTime;
+    readonly version: number;
+}
+/** A theme-registered location key (e.g. `primary`, `footer`, `social`). */
+export type NavLocationKey = string;
+/**
+ * A row of the derived `nav_location_bindings` index.
+ * **Derived + rebuildable** from `NavMenuEntry.locations` at the write
+ * chokepoint (same species as `entry_refs`), NOT a source of truth
+ * and NOT revision-generating. Its purpose is a single indexed location→menu
+ * lookup at render time and a **`UNIQUE (workspace_id, location_key)`**
+ * constraint that enforces *exactly one menu per location* — an invariant a
+ * per-entry JSON field cannot express.
+ */
+export interface NavLocationBindingRow {
+    readonly workspaceId: UUID;
+    readonly locationKey: NavLocationKey;
+    /** The menu entry currently bound to this location. */
+    readonly menuId: UUID;
+    /** When the binding was last (re)assigned; for audit/debug only. */
+    readonly boundAt: ISODateTime;
+}
+/**
+ * A theme/plugin-registered navigation location (registered via
+ * `navigation.locations.register`). Registration is data; a menu may be bound to
+ * an **unregistered** key so assignments survive a theme switch (fixes WP's
+ * "lose your menus on theme change" sin).
+ */
+export interface NavLocationDescriptor {
+    readonly key: NavLocationKey;
+    /** Admin-facing label. */
+    readonly label: string;
+    /** Which theme/plugin registered it (attribution + orphan detection). */
+    readonly registeredBy: string;
+    readonly description?: string | undefined;
+}
+/**
+ * A single item after resolution: target → concrete `href` + display `label` +
+ * `isActive`/`isCurrent` computed against the current route. Refs are resolved
+ * by core (routing/entries/taxonomy), never by theme code. Items whose target
+ * has been trashed/deleted are resolved to `available: false` so the theme can
+ * omit them rather than emit a dead link.
+ */
+export interface ResolvedNavItem {
+    readonly id: UUID;
+    readonly label: string;
+    /** Fully-resolved href, or `null` when the target is unavailable. */
+    readonly href: string | null;
+    readonly available: boolean;
+    /** True when this item's href matches the current route. */
+    readonly isCurrent: boolean;
+    /** True when this or a descendant is current (for open/expanded state). */
+    readonly isActive: boolean;
+    readonly attrs?: NavItemAttrs | undefined;
+    readonly children: readonly ResolvedNavItem[];
+}
+/** A fully-resolved menu ready for a theme to render at a location. */
+export interface ResolvedNav {
+    readonly menuId: UUID;
+    readonly locationKey: NavLocationKey;
+    readonly title: string;
+    readonly items: readonly ResolvedNavItem[];
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/navigation/types.d.ts.map

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

package/dist/navigation/types.js

@@ -0,0 +1,14 @@
+// ---------------------------------------------------------------------------
+// Content-type identity
+// ---------------------------------------------------------------------------
+/**
+ * `menu` ships as a **seeded content-type registry row**, like
+ * `post`/`page`/`media`. Core may special-case it in admin UI/rendering, never
+ * in storage. The extension-field owner namespace for menu-level fields
+ * (`fields.ext.navigation.*`) is `navigation`.
+ */
+export const NAV_MENU_CONTENT_TYPE = "menu";
+export const NAV_FIELD_NAMESPACE = "navigation";
+/** Discriminator marking an entry's `bodyJson` as a navigation tree document. */
+export const NAV_DOC_TYPE = "menu";
+//# sourceMappingURL=types.js.map

package/dist/navigation/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/navigation/types.ts"],"names":[],"mappings":"AA0BA,8EAA8E;AAC9E,wBAAwB;AACxB,8EAA8E;AAE9E;;;;;GAKG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAG,MAAe,CAAC;AACrD,MAAM,CAAC,MAAM,mBAAmB,GAAG,YAAqB,CAAC;AAEzD,iFAAiF;AACjF,MAAM,CAAC,MAAM,YAAY,GAAG,MAAe,CAAC"}

package/dist/presentation/index.d.ts

@@ -0,0 +1,15 @@
+/**
+ * @file Public surface (barrel) for the `presentation` library.
+ *
+ * Presentation owns one thing: which theme a workspace is currently presenting under. It is a
+ * distinct domain from `settings` (the generic definitions/values/revision-ledger model) even
+ * though a host's settings migration reads from it — the dependency runs settings -> presentation
+ * and never the other way, which is what lets the two ship as separate subpaths.
+ */
+export { ALLOWED_THEME_IDS, getPresentationSettings, setActiveTheme, PresentationSettingsNotFoundError, PresentationSettingsValidationError, type GetPresentationSettingsRequired, type PresentationOptional, type PresentationSettingsRecord, type PresentationSettingsRepoPort, type SetActiveThemeDeps, type SetActiveThemeRequired, type ThemeId, } from "./presentation.js";
+export { InMemoryPresentationSettingsRepo } from "./repo.memory.js";
+/**
+ * There is no SQLite adapter export here, deliberately — same reasoning as `workspace/index.ts`:
+ * a concrete adapter names a host's schema, so hosts compose their own against the port above.
+ */
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/presentation/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,EACL,iBAAiB,EACjB,uBAAuB,EACvB,cAAc,EACd,iCAAiC,EACjC,mCAAmC,EACnC,KAAK,+BAA+B,EACpC,KAAK,oBAAoB,EACzB,KAAK,0BAA0B,EAC/B,KAAK,4BAA4B,EACjC,KAAK,kBAAkB,EACvB,KAAK,sBAAsB,EAC3B,KAAK,OAAO,GACb,MAAM,mBAAmB,CAAC;AAE3B,OAAO,EAAE,gCAAgC,EAAE,MAAM,kBAAkB,CAAC;AAEpE;;;GAGG"}

package/dist/presentation/index.js

@@ -0,0 +1,15 @@
+/**
+ * @file Public surface (barrel) for the `presentation` library.
+ *
+ * Presentation owns one thing: which theme a workspace is currently presenting under. It is a
+ * distinct domain from `settings` (the generic definitions/values/revision-ledger model) even
+ * though a host's settings migration reads from it — the dependency runs settings -> presentation
+ * and never the other way, which is what lets the two ship as separate subpaths.
+ */
+export { ALLOWED_THEME_IDS, getPresentationSettings, setActiveTheme, PresentationSettingsNotFoundError, PresentationSettingsValidationError, } from "./presentation.js";
+export { InMemoryPresentationSettingsRepo } from "./repo.memory.js";
+/**
+ * There is no SQLite adapter export here, deliberately — same reasoning as `workspace/index.ts`:
+ * a concrete adapter names a host's schema, so hosts compose their own against the port above.
+ */
+//# sourceMappingURL=index.js.map

package/dist/presentation/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/presentation/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,EACL,iBAAiB,EACjB,uBAAuB,EACvB,cAAc,EACd,iCAAiC,EACjC,mCAAmC,GAQpC,MAAM,mBAAmB,CAAC;AAE3B,OAAO,EAAE,gCAAgC,EAAE,MAAM,kBAAkB,CAAC;AAEpE;;;GAGG"}

package/dist/presentation/presentation.d.ts

@@ -0,0 +1,72 @@
+import type { ClockPort, UUID } from "../core/ports.js";
+/**
+ * @file Presentation settings — the active-theme identity of a workspace.
+ *
+ * Deliberately theme-engine agnostic: this module validates an `activeThemeId` against a set of
+ * ids the caller supplies, and stores it. It does not discover, load, or render themes — a host
+ * owns theme discovery and passes the resulting ids in via `availableThemeIds`. That is what keeps
+ * this domain free of any template-engine or filesystem dependency.
+ */
+/**
+ * Legacy hardcoded theme ids. Retained as the fallback allowlist when no
+ * discovered theme set is injected (keeps pure unit tests hermetic). A host's
+ * own theme discovery and presentation routes replace this with the ids of
+ * discovered `valid` themes, passed in via `availableThemeIds`.
+ */
+export declare const ALLOWED_THEME_IDS: readonly ["paper", "atlas", "glassmorphic"];
+export type ThemeId = (typeof ALLOWED_THEME_IDS)[number];
+export interface PresentationSettingsRecord {
+    workspaceId: UUID;
+    /** Id of the active theme. Validated against discovered themes at write time. */
+    activeThemeId: string;
+    updatedAt: string;
+}
+export interface PresentationSettingsRepoPort {
+    findByWorkspaceId(workspaceId: UUID): Promise<PresentationSettingsRecord | null>;
+    save(record: PresentationSettingsRecord): Promise<void>;
+    /**
+     * Every row across every workspace, for the one-time
+     * `migrateLegacyPresentationSettings` brownfield migration (small row
+     * count: one row per workspace). Added additively; does not change
+     * `findByWorkspaceId`/`save`'s existing contract.
+     */
+    listAll(): Promise<PresentationSettingsRecord[]>;
+}
+export interface GetPresentationSettingsRequired {
+    deps: {
+        repo: PresentationSettingsRepoPort;
+        /** Discovered valid theme ids; falls back to ALLOWED_THEME_IDS when absent. */
+        availableThemeIds?: readonly string[] | undefined;
+    };
+    input: {
+        workspaceId: UUID;
+    };
+}
+export interface SetActiveThemeDeps {
+    clock: ClockPort;
+    repo: PresentationSettingsRepoPort;
+    /** Discovered valid theme ids; falls back to ALLOWED_THEME_IDS when absent. */
+    availableThemeIds?: readonly string[] | undefined;
+}
+export interface SetActiveThemeRequired {
+    deps: SetActiveThemeDeps;
+    input: {
+        workspaceId: UUID;
+        activeThemeId: string;
+    };
+}
+export interface PresentationOptional {
+}
+export declare class PresentationSettingsNotFoundError extends Error {
+}
+export declare class PresentationSettingsValidationError extends Error {
+}
+export declare function getPresentationSettings(required: GetPresentationSettingsRequired, _optional?: PresentationOptional): Promise<{
+    settings: PresentationSettingsRecord;
+    availableThemeIds: string[];
+}>;
+export declare function setActiveTheme(required: SetActiveThemeRequired, _optional?: PresentationOptional): Promise<{
+    settings: PresentationSettingsRecord;
+    availableThemeIds: string[];
+}>;
+//# sourceMappingURL=presentation.d.ts.map

package/dist/presentation/presentation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"presentation.d.ts","sourceRoot":"","sources":["../../src/presentation/presentation.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AAExD;;;;;;;GAOG;AAEH;;;;;GAKG;AACH,eAAO,MAAM,iBAAiB,6CAA8C,CAAC;AAC7E,MAAM,MAAM,OAAO,GAAG,CAAC,OAAO,iBAAiB,CAAC,CAAC,MAAM,CAAC,CAAC;AAEzD,MAAM,WAAW,0BAA0B;IACzC,WAAW,EAAE,IAAI,CAAC;IAClB,iFAAiF;IACjF,aAAa,EAAE,MAAM,CAAC;IACtB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,4BAA4B;IAC3C,iBAAiB,CAAC,WAAW,EAAE,IAAI,GAAG,OAAO,CAAC,0BAA0B,GAAG,IAAI,CAAC,CAAC;IACjF,IAAI,CAAC,MAAM,EAAE,0BAA0B,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACxD;;;;;OAKG;IACH,OAAO,IAAI,OAAO,CAAC,0BAA0B,EAAE,CAAC,CAAC;CAClD;AAED,MAAM,WAAW,+BAA+B;IAC9C,IAAI,EAAE;QACJ,IAAI,EAAE,4BAA4B,CAAC;QACnC,+EAA+E;QAC/E,iBAAiB,CAAC,EAAE,SAAS,MAAM,EAAE,GAAG,SAAS,CAAC;KACnD,CAAC;IACF,KAAK,EAAE;QAAE,WAAW,EAAE,IAAI,CAAA;KAAE,CAAC;CAC9B;AAED,MAAM,WAAW,kBAAkB;IACjC,KAAK,EAAE,SAAS,CAAC;IACjB,IAAI,EAAE,4BAA4B,CAAC;IACnC,+EAA+E;IAC/E,iBAAiB,CAAC,EAAE,SAAS,MAAM,EAAE,GAAG,SAAS,CAAC;CACnD;AAED,MAAM,WAAW,sBAAsB;IACrC,IAAI,EAAE,kBAAkB,CAAC;IACzB,KAAK,EAAE;QACL,WAAW,EAAE,IAAI,CAAC;QAClB,aAAa,EAAE,MAAM,CAAC;KACvB,CAAC;CACH;AAED,MAAM,WAAW,oBAAoB;CAAG;AAExC,qBAAa,iCAAkC,SAAQ,KAAK;CAAG;AAC/D,qBAAa,mCAAoC,SAAQ,KAAK;CAAG;AAEjE,wBAAsB,uBAAuB,CAC3C,QAAQ,EAAE,+BAA+B,EACzC,SAAS,GAAE,oBAAyB,GACnC,OAAO,CAAC;IAAE,QAAQ,EAAE,0BAA0B,CAAC;IAAC,iBAAiB,EAAE,MAAM,EAAE,CAAA;CAAE,CAAC,CAYhF;AAED,wBAAsB,cAAc,CAClC,QAAQ,EAAE,sBAAsB,EAChC,SAAS,GAAE,oBAAyB,GACnC,OAAO,CAAC;IAAE,QAAQ,EAAE,0BAA0B,CAAC;IAAC,iBAAiB,EAAE,MAAM,EAAE,CAAA;CAAE,CAAC,CA4BhF"}

package/dist/presentation/presentation.js

@@ -0,0 +1,51 @@
+/**
+ * @file Presentation settings — the active-theme identity of a workspace.
+ *
+ * Deliberately theme-engine agnostic: this module validates an `activeThemeId` against a set of
+ * ids the caller supplies, and stores it. It does not discover, load, or render themes — a host
+ * owns theme discovery and passes the resulting ids in via `availableThemeIds`. That is what keeps
+ * this domain free of any template-engine or filesystem dependency.
+ */
+/**
+ * Legacy hardcoded theme ids. Retained as the fallback allowlist when no
+ * discovered theme set is injected (keeps pure unit tests hermetic). A host's
+ * own theme discovery and presentation routes replace this with the ids of
+ * discovered `valid` themes, passed in via `availableThemeIds`.
+ */
+export const ALLOWED_THEME_IDS = ["paper", "atlas", "glassmorphic"];
+export class PresentationSettingsNotFoundError extends Error {
+}
+export class PresentationSettingsValidationError extends Error {
+}
+export async function getPresentationSettings(required, _optional = {}) {
+    const settings = await required.deps.repo.findByWorkspaceId(required.input.workspaceId);
+    if (!settings) {
+        throw new PresentationSettingsNotFoundError(`presentation settings for workspace '${required.input.workspaceId}' were not found`);
+    }
+    return {
+        settings,
+        availableThemeIds: [...(required.deps.availableThemeIds ?? ALLOWED_THEME_IDS)],
+    };
+}
+export async function setActiveTheme(required, _optional = {}) {
+    const { deps, input } = required;
+    const allowed = deps.availableThemeIds ?? ALLOWED_THEME_IDS;
+    if (!allowed.includes(input.activeThemeId)) {
+        throw new PresentationSettingsValidationError(`theme '${input.activeThemeId}' is not supported`);
+    }
+    const existing = await deps.repo.findByWorkspaceId(input.workspaceId);
+    if (!existing) {
+        throw new PresentationSettingsNotFoundError(`presentation settings for workspace '${input.workspaceId}' were not found`);
+    }
+    const settings = {
+        ...existing,
+        activeThemeId: input.activeThemeId,
+        updatedAt: deps.clock.nowIso(),
+    };
+    await deps.repo.save(settings);
+    return {
+        settings,
+        availableThemeIds: [...allowed],
+    };
+}
+//# sourceMappingURL=presentation.js.map

package/dist/presentation/presentation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"presentation.js","sourceRoot":"","sources":["../../src/presentation/presentation.ts"],"names":[],"mappings":"AAEA;;;;;;;GAOG;AAEH;;;;;GAKG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,OAAO,EAAE,OAAO,EAAE,cAAc,CAAU,CAAC;AAgD7E,MAAM,OAAO,iCAAkC,SAAQ,KAAK;CAAG;AAC/D,MAAM,OAAO,mCAAoC,SAAQ,KAAK;CAAG;AAEjE,MAAM,CAAC,KAAK,UAAU,uBAAuB,CAC3C,QAAyC,EACzC,YAAkC,EAAE;IAEpC,MAAM,QAAQ,GAAG,MAAM,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,iBAAiB,CAAC,QAAQ,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC;IACxF,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,MAAM,IAAI,iCAAiC,CACzC,wCAAwC,QAAQ,CAAC,KAAK,CAAC,WAAW,kBAAkB,CACrF,CAAC;IACJ,CAAC;IAED,OAAO;QACL,QAAQ;QACR,iBAAiB,EAAE,CAAC,GAAG,CAAC,QAAQ,CAAC,IAAI,CAAC,iBAAiB,IAAI,iBAAiB,CAAC,CAAC;KAC/E,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,cAAc,CAClC,QAAgC,EAChC,YAAkC,EAAE;IAEpC,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,QAAQ,CAAC;IACjC,MAAM,OAAO,GAAG,IAAI,CAAC,iBAAiB,IAAI,iBAAiB,CAAC;IAC5D,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAC,aAAa,CAAC,EAAE,CAAC;QAC3C,MAAM,IAAI,mCAAmC,CAC3C,UAAU,KAAK,CAAC,aAAa,oBAAoB,CAClD,CAAC;IACJ,CAAC;IAED,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,iBAAiB,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC;IACtE,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,MAAM,IAAI,iCAAiC,CACzC,wCAAwC,KAAK,CAAC,WAAW,kBAAkB,CAC5E,CAAC;IACJ,CAAC;IAED,MAAM,QAAQ,GAA+B;QAC3C,GAAG,QAAQ;QACX,aAAa,EAAE,KAAK,CAAC,aAAa;QAClC,SAAS,EAAE,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE;KAC/B,CAAC;IAEF,MAAM,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IAE/B,OAAO;QACL,QAAQ;QACR,iBAAiB,EAAE,CAAC,GAAG,OAAO,CAAC;KAChC,CAAC;AACJ,CAAC"}

package/dist/presentation/repo.memory.d.ts

@@ -0,0 +1,9 @@
+import type { PresentationSettingsRecord, PresentationSettingsRepoPort } from "./presentation.js";
+export declare class InMemoryPresentationSettingsRepo implements PresentationSettingsRepoPort {
+    private rows;
+    constructor(initialRows?: PresentationSettingsRecord[]);
+    findByWorkspaceId(workspaceId: string): Promise<PresentationSettingsRecord | null>;
+    save(record: PresentationSettingsRecord): Promise<void>;
+    listAll(): Promise<PresentationSettingsRecord[]>;
+}
+//# sourceMappingURL=repo.memory.d.ts.map

package/dist/presentation/repo.memory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"repo.memory.d.ts","sourceRoot":"","sources":["../../src/presentation/repo.memory.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,0BAA0B,EAAE,4BAA4B,EAAE,MAAM,mBAAmB,CAAC;AAElG,qBAAa,gCAAiC,YAAW,4BAA4B;IACnF,OAAO,CAAC,IAAI,CAA+B;gBAE/B,WAAW,GAAE,0BAA0B,EAAO;IAIpD,iBAAiB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,0BAA0B,GAAG,IAAI,CAAC;IAIlF,IAAI,CAAC,MAAM,EAAE,0BAA0B,GAAG,OAAO,CAAC,IAAI,CAAC;IAUvD,OAAO,IAAI,OAAO,CAAC,0BAA0B,EAAE,CAAC;CAGvD"}

package/dist/presentation/repo.memory.js

@@ -0,0 +1,21 @@
+export class InMemoryPresentationSettingsRepo {
+    rows;
+    constructor(initialRows = []) {
+        this.rows = [...initialRows];
+    }
+    async findByWorkspaceId(workspaceId) {
+        return this.rows.find((row) => row.workspaceId === workspaceId) ?? null;
+    }
+    async save(record) {
+        const index = this.rows.findIndex((row) => row.workspaceId === record.workspaceId);
+        if (index === -1) {
+            this.rows.push(record);
+            return;
+        }
+        this.rows[index] = record;
+    }
+    async listAll() {
+        return [...this.rows];
+    }
+}
+//# sourceMappingURL=repo.memory.js.map

package/dist/presentation/repo.memory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"repo.memory.js","sourceRoot":"","sources":["../../src/presentation/repo.memory.ts"],"names":[],"mappings":"AAEA,MAAM,OAAO,gCAAgC;IACnC,IAAI,CAA+B;IAE3C,YAAY,cAA4C,EAAE;QACxD,IAAI,CAAC,IAAI,GAAG,CAAC,GAAG,WAAW,CAAC,CAAC;IAC/B,CAAC;IAED,KAAK,CAAC,iBAAiB,CAAC,WAAmB;QACzC,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,WAAW,KAAK,WAAW,CAAC,IAAI,IAAI,CAAC;IAC1E,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,MAAkC;QAC3C,MAAM,KAAK,GAAG,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,WAAW,KAAK,MAAM,CAAC,WAAW,CAAC,CAAC;QACnF,IAAI,KAAK,KAAK,CAAC,CAAC,EAAE,CAAC;YACjB,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;YACvB,OAAO;QACT,CAAC;QAED,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,MAAM,CAAC;IAC5B,CAAC;IAED,KAAK,CAAC,OAAO;QACX,OAAO,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC;IACxB,CAAC;CACF"}

package/dist/server/index.d.ts

@@ -0,0 +1,28 @@
+/**
+ * @file `@jini-ai/cms/server` — the Node-bound half of the CMS capability.
+ *
+ * PLACEHOLDER. Nothing has been ported yet.
+ *
+ * ## What belongs here
+ *
+ * Concrete implementations of the ports declared in `../core`: SQLite/Postgres repositories,
+ * filesystem blob stores, image transformers — anything that imports `node:*` or a native
+ * dependency. This layer depends on `../core`; the reverse is a boundary violation.
+ *
+ * ## What does NOT belong here
+ *
+ * HTTP routing and request/response handling. The source repo's `src/server/**` is an Express
+ * composition root and is explicitly out of scope for this port — Jini already has
+ * `@jini-ai/http-kit` and `@jini-ai/server` for transport. Porting those routes here would
+ * reproduce exactly the coupling this package's layer split exists to prevent (see
+ * `../core/index.ts`'s header for the measurements).
+ *
+ * The name of this subpath is `/server` for consistency with `@jini-ai/admin`'s Node layer, which
+ * uses the same convention. It means "the Node-bound layer", not "the HTTP server".
+ */
+/**
+ * Layer marker — same rationale as `CMS_CORE_LAYER`, and delete it on the same terms: once a real
+ * adapter is exported from here, this has no purpose.
+ */
+export declare const CMS_SERVER_LAYER: "server";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/server/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH;;;GAGG;AACH,eAAO,MAAM,gBAAgB,EAAG,QAAiB,CAAC"}