@elytracms/core 0.0.6

package/dist/persistence/references.d.ts

@@ -0,0 +1,257 @@
+import { z } from 'zod';
+/**
+ * Reference-index substrate (EC-155, vision AD-6 / pillar 3.6).
+ *
+ * On every write the operations layer extracts *outbound* references — relation
+ * fields, rich-text link marks and inline refs, page-graph bindings and
+ * component usage, asset usages — into this index, for draft and published
+ * variants separately. One index powers many features: "used by" panels, safe
+ * unpublish (the queryable answer to Sanity's hidden-draft-reference failure),
+ * component/asset where-used, and broken-link audits (UX lands in Milestone B).
+ *
+ * Records are **derived data**: they carry no timestamps and are deterministic
+ * functions of the indexed content, so backfill is idempotent and two runs over
+ * the same data are byte-for-byte identical.
+ */
+/** Which content variant an entry was extracted from (the Sanity failure-case axis). */
+export declare const referenceVariantSchema: z.ZodEnum<{
+    draft: "draft";
+    published: "published";
+}>;
+export type ReferenceVariant = z.infer<typeof referenceVariantSchema>;
+/**
+ * What kind of entity *holds* the reference. Documents are keyed by their
+ * `documentKey` (`collection:id`); pages/layouts by their graph ids.
+ */
+export declare const referenceSourceTypeSchema: z.ZodEnum<{
+    document: "document";
+    page: "page";
+    layout: "layout";
+}>;
+export type ReferenceSourceType = z.infer<typeof referenceSourceTypeSchema>;
+/** What kind of entity is *referenced*. Document targets use `collection:id` keys. */
+export declare const referenceTargetTypeSchema: z.ZodEnum<{
+    asset: "asset";
+    document: "document";
+    component: "component";
+}>;
+export type ReferenceTargetType = z.infer<typeof referenceTargetTypeSchema>;
+/**
+ * Which reference-bearing structure produced an entry. A *closed* enum so the
+ * extractor registry (see `reference-extraction.ts`) is exhaustive by
+ * construction — a new structure kind must be added here, registered, and
+ * covered by the checklist test before it can produce entries.
+ */
+export declare const referenceKindSchema: z.ZodEnum<{
+    "relation-field": "relation-field";
+    "asset-field": "asset-field";
+    "rich-text-link": "rich-text-link";
+    "rich-text-node": "rich-text-node";
+    "component-usage": "component-usage";
+    "prop-binding": "prop-binding";
+    "condition-binding": "condition-binding";
+}>;
+export type ReferenceKind = z.infer<typeof referenceKindSchema>;
+export declare const referenceSourceSchema: z.ZodObject<{
+    type: z.ZodEnum<{
+        document: "document";
+        page: "page";
+        layout: "layout";
+    }>;
+    id: z.ZodString;
+}, z.core.$strip>;
+export type ReferenceSource = z.infer<typeof referenceSourceSchema>;
+export declare const referenceTargetSchema: z.ZodObject<{
+    type: z.ZodEnum<{
+        asset: "asset";
+        document: "document";
+        component: "component";
+    }>;
+    id: z.ZodString;
+}, z.core.$strip>;
+export type ReferenceTarget = z.infer<typeof referenceTargetSchema>;
+/**
+ * One outbound reference found *inside* a source, before it is attributed to
+ * that source: the exact field/node path, the target, and which structure
+ * produced it. `path` is a `/`-joined token path into the stored value, e.g.
+ * `values/author`, `localized/en/body/doc/content/0/marks/0`,
+ * `root/slots/children/2/props/items/binding`.
+ */
+export declare const outboundReferenceSchema: z.ZodObject<{
+    path: z.ZodString;
+    target: z.ZodObject<{
+        type: z.ZodEnum<{
+            asset: "asset";
+            document: "document";
+            component: "component";
+        }>;
+        id: z.ZodString;
+    }, z.core.$strip>;
+    kind: z.ZodEnum<{
+        "relation-field": "relation-field";
+        "asset-field": "asset-field";
+        "rich-text-link": "rich-text-link";
+        "rich-text-node": "rich-text-node";
+        "component-usage": "component-usage";
+        "prop-binding": "prop-binding";
+        "condition-binding": "condition-binding";
+    }>;
+}, z.core.$strip>;
+export type OutboundReference = z.infer<typeof outboundReferenceSchema>;
+/** An outbound reference attributed to its holding source entity. */
+export declare const referenceEntrySchema: z.ZodObject<{
+    path: z.ZodString;
+    target: z.ZodObject<{
+        type: z.ZodEnum<{
+            asset: "asset";
+            document: "document";
+            component: "component";
+        }>;
+        id: z.ZodString;
+    }, z.core.$strip>;
+    kind: z.ZodEnum<{
+        "relation-field": "relation-field";
+        "asset-field": "asset-field";
+        "rich-text-link": "rich-text-link";
+        "rich-text-node": "rich-text-node";
+        "component-usage": "component-usage";
+        "prop-binding": "prop-binding";
+        "condition-binding": "condition-binding";
+    }>;
+    source: z.ZodObject<{
+        type: z.ZodEnum<{
+            document: "document";
+            page: "page";
+            layout: "layout";
+        }>;
+        id: z.ZodString;
+    }, z.core.$strip>;
+}, z.core.$strip>;
+export type ReferenceEntry = z.infer<typeof referenceEntrySchema>;
+/** The persisted index record: entry + project + variant. Derived, timestamp-free. */
+export declare const referenceEntryRecordSchema: z.ZodObject<{
+    path: z.ZodString;
+    target: z.ZodObject<{
+        type: z.ZodEnum<{
+            asset: "asset";
+            document: "document";
+            component: "component";
+        }>;
+        id: z.ZodString;
+    }, z.core.$strip>;
+    kind: z.ZodEnum<{
+        "relation-field": "relation-field";
+        "asset-field": "asset-field";
+        "rich-text-link": "rich-text-link";
+        "rich-text-node": "rich-text-node";
+        "component-usage": "component-usage";
+        "prop-binding": "prop-binding";
+        "condition-binding": "condition-binding";
+    }>;
+    source: z.ZodObject<{
+        type: z.ZodEnum<{
+            document: "document";
+            page: "page";
+            layout: "layout";
+        }>;
+        id: z.ZodString;
+    }, z.core.$strip>;
+    projectId: z.ZodString;
+    variant: z.ZodEnum<{
+        draft: "draft";
+        published: "published";
+    }>;
+}, z.core.$strip>;
+export type ReferenceEntryRecord = z.infer<typeof referenceEntryRecordSchema>;
+/**
+ * Total, deterministic order over index records:
+ * variant → source type → source id → path → target type → target id → kind.
+ * Every repository read returns records in this order.
+ */
+export declare function compareReferenceEntries(a: ReferenceEntryRecord, b: ReferenceEntryRecord): number;
+/** Stable per-project bucket key: one bucket per (variant, source). */
+export declare function referenceSourceKey(variant: ReferenceVariant, source: ReferenceSource): string;
+/** Identity of an entry within its source bucket (used for deduplication). */
+export declare function referenceEntryKey(entry: ReferenceEntry): string;
+/** Dedupe + deterministically sort records (extraction can legitimately repeat a target). */
+export declare function normalizeReferenceRecords(records: readonly ReferenceEntryRecord[]): ReferenceEntryRecord[];
+export interface ReferenceLookupOptions {
+    /** Restrict the lookup to one variant; omit for both (draft + published). */
+    variant?: ReferenceVariant;
+}
+/**
+ * Persisted "the index has been fully built" marker (EC-269). The index is
+ * derived data maintained replace-all-for-source on every write, so the
+ * (clear + rebuild) backfill is only needed to *seed* a never-built index. A
+ * completed backfill writes this marker; its presence lets the read path
+ * (opening the References panel) skip the backfill entirely — a single read,
+ * zero mutations — instead of rewriting the whole index every session. Carries
+ * the entry count purely as a diagnostic; presence is the only gate.
+ */
+export interface ReferenceIndexBuildMarker {
+    /** Number of entries the completing backfill produced (diagnostic only). */
+    entryCount: number;
+}
+/**
+ * Persists the reference index (EC-155). Writes are **replace-all-for-source**:
+ * saving an entity recomputes every outbound reference it holds and replaces the
+ * previous set atomically, so edits/deletes/unpublishes can never leave stale
+ * entries behind. Lookups work in both directions with field/node-path
+ * granularity and are variant-aware.
+ */
+export interface ReferenceIndexRepository {
+    /**
+     * Replace all entries held by `source` in `variant` with the given outbound
+     * references. An empty list removes the source's entries entirely.
+     */
+    replaceForSource(projectId: string, variant: ReferenceVariant, source: ReferenceSource, references: readonly OutboundReference[]): Promise<ReferenceEntryRecord[]>;
+    /**
+     * Replace all entries held by sources of the given types in `variant` (the
+     * graph recompute path: one revision yields entries across many pages/layouts,
+     * and pages removed from the graph must drop their entries too).
+     */
+    replaceForSourceTypes(projectId: string, variant: ReferenceVariant, sourceTypes: readonly ReferenceSourceType[], entries: readonly ReferenceEntry[]): Promise<ReferenceEntryRecord[]>;
+    /** Remove all entries held by `source` (in one variant, or both when omitted). */
+    removeForSource(projectId: string, source: ReferenceSource, variant?: ReferenceVariant): Promise<void>;
+    /** Outbound: what does `source` reference? */
+    outbound(projectId: string, source: ReferenceSource, options?: ReferenceLookupOptions): Promise<ReferenceEntryRecord[]>;
+    /** Inbound: what references `target`? (The "used by" / safe-unpublish direction.) */
+    inbound(projectId: string, target: ReferenceTarget, options?: ReferenceLookupOptions): Promise<ReferenceEntryRecord[]>;
+    /** Every entry of a project (optionally one variant), deterministically ordered. */
+    listEntries(projectId: string, variant?: ReferenceVariant): Promise<ReferenceEntryRecord[]>;
+    /**
+     * The persisted "index fully built" marker (EC-269), or `null` if the project's
+     * index has never been backfilled. A present marker means the read path can
+     * skip the backfill (maintained-on-write keeps it current thereafter).
+     */
+    getBuildMarker(projectId: string): Promise<ReferenceIndexBuildMarker | null>;
+    /** Persist the build marker after a completed backfill. */
+    setBuildMarker(projectId: string, marker: ReferenceIndexBuildMarker): Promise<void>;
+    /**
+     * Drop the whole index of a project AND its build marker (backfill starts from
+     * a clean slate; the marker is re-set only when the rebuild completes).
+     */
+    clearProject(projectId: string): Promise<void>;
+}
+export interface InMemoryReferenceIndexRepositoryOptions {
+    seed?: readonly ReferenceEntryRecord[];
+}
+export declare class InMemoryReferenceIndexRepository implements ReferenceIndexRepository {
+    /** projectId → (sourceKey → entries of that source+variant). */
+    private readonly byProject;
+    /** projectId → build marker (EC-269); absent until a backfill completes. */
+    private readonly markers;
+    constructor(options?: InMemoryReferenceIndexRepositoryOptions);
+    private projectMap;
+    private bucket;
+    replaceForSource(projectId: string, variant: ReferenceVariant, source: ReferenceSource, references: readonly OutboundReference[]): Promise<ReferenceEntryRecord[]>;
+    replaceForSourceTypes(projectId: string, variant: ReferenceVariant, sourceTypes: readonly ReferenceSourceType[], entries: readonly ReferenceEntry[]): Promise<ReferenceEntryRecord[]>;
+    removeForSource(projectId: string, source: ReferenceSource, variant?: ReferenceVariant): Promise<void>;
+    private collect;
+    outbound(projectId: string, source: ReferenceSource, options?: ReferenceLookupOptions): Promise<ReferenceEntryRecord[]>;
+    inbound(projectId: string, target: ReferenceTarget, options?: ReferenceLookupOptions): Promise<ReferenceEntryRecord[]>;
+    listEntries(projectId: string, variant?: ReferenceVariant): Promise<ReferenceEntryRecord[]>;
+    getBuildMarker(projectId: string): Promise<ReferenceIndexBuildMarker | null>;
+    setBuildMarker(projectId: string, marker: ReferenceIndexBuildMarker): Promise<void>;
+    clearProject(projectId: string): Promise<void>;
+}

package/dist/persistence/references.js.map

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

package/dist/persistence/seed.d.ts

@@ -0,0 +1,55 @@
+import { InMemoryPersistenceAdapter } from './adapter';
+import type { PersistenceAdapter } from './adapter';
+import type { ProjectRole } from './members';
+/** The sample project the seed attaches graph/registry/CMS/publishing to. */
+export declare const SEED_PROJECT_ID = "prj_aurora";
+/**
+ * Deterministic dev users (EC-150). The ids are canonical here so the seeded
+ * memberships and the builder's local auth adapter (which maps
+ * `admin@example.com` etc. + fixed dev passwords onto these ids) stay aligned.
+ * Live Convex deployments use Convex Auth `users` ids instead.
+ */
+export declare const DEV_USERS: {
+    readonly admin: {
+        readonly id: "user_admin";
+        readonly email: "admin@example.com";
+        readonly name: "Ada Admin";
+    };
+    readonly editor: {
+        readonly id: "user_editor";
+        readonly email: "editor@example.com";
+        readonly name: "Edi Editor";
+    };
+    readonly viewer: {
+        readonly id: "user_viewer";
+        readonly email: "viewer@example.com";
+        readonly name: "Vio Viewer";
+    };
+};
+/** Role each dev user gets on every sample project. */
+export declare const DEV_USER_ROLES: ReadonlyArray<{
+    userId: string;
+    role: ProjectRole;
+}>;
+/** A deterministic sample asset record seeded alongside the CMS content. */
+export declare const SEED_ASSET: {
+    readonly id: "asset_cover";
+    readonly filename: "cover.jpg";
+    readonly contentType: "image/jpeg";
+    readonly byteSize: 102400;
+    readonly width: 1200;
+    readonly height: 630;
+    readonly alt: "Cover image";
+};
+/**
+ * Populate an adapter with deterministic seed content (brief §10, EC-046):
+ * a graph revision, the CMS schema + documents, a sample asset, and a preview
+ * publish. Uses only the public repository API, so it works against any
+ * {@link PersistenceAdapter} implementation (in-memory or Convex).
+ */
+export declare function seedPersistence(adapter: PersistenceAdapter): Promise<void>;
+/**
+ * Build a fully-seeded in-memory adapter (brief §10, §11). The domains are
+ * seeded deterministically. Reproducible across runs.
+ */
+export declare function createSeededPersistenceAdapter(): Promise<InMemoryPersistenceAdapter>;

package/dist/persistence/seed.js

@@ -0,0 +1,102 @@
+import { validSampleGraph } from '@elytracms/core/project-graph';
+import { documentKey, sampleDocuments, sampleFilterableCollections, samplePublishedKeys, selfTypeDocument, } from '@elytracms/core/cms-core';
+import { createSequentialClock } from './core';
+import { InMemoryPersistenceAdapter } from './adapter';
+/** The sample project the seed attaches graph/registry/CMS/publishing to. */
+export const SEED_PROJECT_ID = 'prj_aurora';
+/**
+ * Deterministic dev users (EC-150). The ids are canonical here so the seeded
+ * memberships and the builder's local auth adapter (which maps
+ * `admin@example.com` etc. + fixed dev passwords onto these ids) stay aligned.
+ * Live Convex deployments use Convex Auth `users` ids instead.
+ */
+export const DEV_USERS = {
+    admin: { id: 'user_admin', email: 'admin@example.com', name: 'Ada Admin' },
+    editor: { id: 'user_editor', email: 'editor@example.com', name: 'Edi Editor' },
+    viewer: { id: 'user_viewer', email: 'viewer@example.com', name: 'Vio Viewer' },
+};
+/** Role each dev user gets on every sample project. */
+export const DEV_USER_ROLES = [
+    { userId: DEV_USERS.admin.id, role: 'admin' },
+    { userId: DEV_USERS.editor.id, role: 'editor' },
+    { userId: DEV_USERS.viewer.id, role: 'viewer' },
+];
+/** A deterministic sample asset record seeded alongside the CMS content. */
+export const SEED_ASSET = {
+    id: 'asset_cover',
+    filename: 'cover.jpg',
+    contentType: 'image/jpeg',
+    byteSize: 102400,
+    width: 1200,
+    height: 630,
+    alt: 'Cover image',
+};
+/**
+ * Populate an adapter with deterministic seed content (brief §10, EC-046):
+ * a graph revision, the CMS schema + documents, a sample asset, and a preview
+ * publish. Uses only the public repository API, so it works against any
+ * {@link PersistenceAdapter} implementation (in-memory or Convex).
+ */
+export async function seedPersistence(adapter) {
+    // Graph + revision — LAYOUTS-ONLY (EC-187, schemaVersion 2). The home page is
+    // no longer a graph page; it is a `page`-collection document seeded below
+    // (`samplePageHome` rides in `sampleDocuments`), rendered into `layout.main`.
+    const revision = await adapter.graphs.saveGraph(SEED_PROJECT_ID, validSampleGraph, {
+        label: 'Initial import',
+    });
+    // CMS schema + documents (localized variants ride along; publish-ness is the
+    // version pointer pinned below, EC-224).
+    // `sampleDocuments` includes the `page/home` document (EC-187) so a routed
+    // page resolves to its body composition. The canonical `filterable`
+    // declarations ride on the seeded schema (EC-169 fix-pack) so studio
+    // filter/sort pickers and the delivery engine share one declaration set
+    // without app-side overlays.
+    await adapter.cms.saveSchema(SEED_PROJECT_ID, sampleFilterableCollections);
+    // EC-224: the live row is the continuous DRAFT (the Sanity model). A doc in
+    // `samplePublishedKeys` is published via the version POINTER — record a version
+    // snapshot and pin it — not by a flat `state` flag (B-3c retires the field).
+    // Resolution serves published via the pin; the live row stays a draft.
+    const published = new Set(samplePublishedKeys);
+    const collectionsById = new Map(sampleFilterableCollections.map((c) => [c.id, c]));
+    for (const rawDocument of sampleDocuments) {
+        // EC-277: seed self-typed content, exactly as the operations write lens does in
+        // production (the seed's compositions hold no picked relation/asset props, so no
+        // manifest lookup is needed here). The persistence store stays schema-agnostic.
+        const collection = collectionsById.get(rawDocument.collection);
+        const document = collection ? selfTypeDocument(rawDocument, collection) : rawDocument;
+        await adapter.cms.upsertDocument(SEED_PROJECT_ID, document);
+        if (published.has(documentKey({ collection: document.collection, id: document.id }))) {
+            const version = await adapter.cms.saveDocumentVersion(SEED_PROJECT_ID, document, {
+                label: 'published',
+            });
+            await adapter.cms.publishDocumentVersion(SEED_PROJECT_ID, { collection: document.collection, id: document.id }, version.version);
+        }
+    }
+    // Asset metadata.
+    await adapter.assets.upsertAsset(SEED_PROJECT_ID, SEED_ASSET);
+    // Publish the initial revision (the deployment's one environment).
+    await adapter.publishing.publish(SEED_PROJECT_ID, {
+        revisionId: revision.id,
+        revision: revision.revision,
+    });
+    // Memberships (EC-150): every dev user gets their role on the seeded project,
+    // so each role's studio experience is reproducible from fixtures.
+    const projectIds = [SEED_PROJECT_ID];
+    for (const projectId of projectIds) {
+        for (const { userId, role } of DEV_USER_ROLES) {
+            await adapter.members.setMember(projectId, userId, role);
+        }
+    }
+}
+/**
+ * Build a fully-seeded in-memory adapter (brief §10, §11). The domains are
+ * seeded deterministically. Reproducible across runs.
+ */
+export async function createSeededPersistenceAdapter() {
+    const adapter = new InMemoryPersistenceAdapter({
+        clock: createSequentialClock('2026-06-07T00:00:00.000Z'),
+    });
+    await seedPersistence(adapter);
+    return adapter;
+}
+//# sourceMappingURL=seed.js.map

package/dist/persistence/seed.js.map

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

package/dist/persistence/self-maintaining-adapter.d.ts

@@ -0,0 +1,41 @@
+import type { PersistenceAdapter } from './adapter';
+import type { CmsRepository } from './cms';
+import type { GraphRepository } from './graph';
+import type { PublishingRepository } from './publishing';
+/**
+ * Self-maintaining reference index (EC-277, vision AD-6).
+ *
+ * The reference index is **maintained at the source, in the write path** — not by
+ * a client-side event subscriber. Every writer is caught by construction: a write
+ * recomputes the affected source's outbound references before it returns, so the
+ * index can never drift behind the content, regardless of which code path issued
+ * the write.
+ *
+ * {@link maintainReferenceIndex} wraps an in-process repository set (the in-memory
+ * provider) so each document/graph/publishing write reindexes in the same call.
+ * The Convex provider achieves the identical guarantee *server-side* — extraction
+ * runs inside the mutation handler (`convex/cms.ts`, `convex/graphs.ts`,
+ * `convex/publishing.ts`), so a raw `convex run` is caught too — and merely flags
+ * {@link PersistenceAdapter.maintainsReferenceIndex} so the studio bootstrap does
+ * not double-index via the `attachReferenceIndex` subscriber.
+ *
+ * Extraction is schema-free and manifest-free (self-describing content, AD-15), so
+ * maintenance needs nothing but the stored value — which is exactly what lets it
+ * live in the store rather than the client.
+ */
+/** The write-bearing repositories whose mutations trigger a reindex. */
+export interface MaintainableRepositories {
+    cms: CmsRepository;
+    graphs: GraphRepository;
+    publishing: PublishingRepository;
+}
+/**
+ * Wrap a repository set so each write keeps the reference index current in-process.
+ * `getAdapter` is read lazily on each write so the reindex routines (which need the
+ * full adapter for cross-repository reads) resolve against the live, fully-built
+ * adapter — letting the caller construct repositories and adapter in any order.
+ * Idempotent reindexing (replace-all-for-source) means a redundant subscriber would
+ * still converge, but the owning adapter should advertise
+ * {@link PersistenceAdapter.maintainsReferenceIndex} so the subscriber stands down.
+ */
+export declare function maintainReferenceIndex(repos: MaintainableRepositories, getAdapter: () => PersistenceAdapter): MaintainableRepositories;

package/dist/persistence/self-maintaining-adapter.js

@@ -0,0 +1,79 @@
+import { reindexDocumentReferences, reindexGraphDraftReferences, reindexGraphPublishedReferences, } from './reference-indexing';
+/**
+ * Forward every method of a repository to `inner` (preserving `this`), overriding
+ * only the named write methods. A `Proxy` keeps the non-overridden surface — reads
+ * and the repository's own internal state — bound to the real instance.
+ */
+function forwardRepository(inner, overrides) {
+    const overrideMap = overrides;
+    return new Proxy(inner, {
+        get(target, prop) {
+            if (Object.prototype.hasOwnProperty.call(overrideMap, prop))
+                return overrideMap[prop];
+            const value = Reflect.get(target, prop, target);
+            return typeof value === 'function'
+                ? value.bind(target)
+                : value;
+        },
+    });
+}
+/**
+ * Wrap a repository set so each write keeps the reference index current in-process.
+ * `getAdapter` is read lazily on each write so the reindex routines (which need the
+ * full adapter for cross-repository reads) resolve against the live, fully-built
+ * adapter — letting the caller construct repositories and adapter in any order.
+ * Idempotent reindexing (replace-all-for-source) means a redundant subscriber would
+ * still converge, but the owning adapter should advertise
+ * {@link PersistenceAdapter.maintainsReferenceIndex} so the subscriber stands down.
+ */
+export function maintainReferenceIndex(repos, getAdapter) {
+    return {
+        cms: forwardRepository(repos.cms, {
+            upsertDocument: async (projectId, document) => {
+                const record = await repos.cms.upsertDocument(projectId, document);
+                await reindexDocumentReferences(getAdapter(), projectId, {
+                    collection: document.collection,
+                    id: document.id,
+                });
+                return record;
+            },
+            deleteDocument: async (projectId, ref) => {
+                await repos.cms.deleteDocument(projectId, ref);
+                // The recompute of a now-missing document drops all of its entries.
+                await reindexDocumentReferences(getAdapter(), projectId, ref);
+            },
+            publishDocumentVersion: async (projectId, ref, version) => {
+                const record = await repos.cms.publishDocumentVersion(projectId, ref, version);
+                // The published variant now exists — recompute both variants of this doc.
+                await reindexDocumentReferences(getAdapter(), projectId, ref);
+                return record;
+            },
+            unpublishDocument: async (projectId, ref) => {
+                const record = await repos.cms.unpublishDocument(projectId, ref);
+                // The live pin is cleared — drop this doc's published entries.
+                await reindexDocumentReferences(getAdapter(), projectId, ref);
+                return record;
+            },
+        }),
+        graphs: forwardRepository(repos.graphs, {
+            saveGraph: async (projectId, graph, options) => {
+                const record = await repos.graphs.saveGraph(projectId, graph, options);
+                await reindexGraphDraftReferences(getAdapter(), projectId);
+                return record;
+            },
+        }),
+        publishing: forwardRepository(repos.publishing, {
+            publish: async (projectId, input) => {
+                const record = await repos.publishing.publish(projectId, input);
+                await reindexGraphPublishedReferences(getAdapter(), projectId);
+                return record;
+            },
+            unpublish: async (projectId) => {
+                const record = await repos.publishing.unpublish(projectId);
+                await reindexGraphPublishedReferences(getAdapter(), projectId);
+                return record;
+            },
+        }),
+    };
+}
+//# sourceMappingURL=self-maintaining-adapter.js.map

package/dist/persistence/self-maintaining-adapter.js.map

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

package/dist/plugins/asset-storage.d.ts

@@ -0,0 +1,76 @@
+/**
+ * Asset-storage adapters (EC-133). The CMS stores asset *metadata* (filename, size, content type)
+ * and points at bytes by an opaque storage key. A storage adapter owns where those bytes live —
+ * in-memory, a CDN base URL, S3, Convex file storage, etc. This interface is structurally
+ * compatible with `@elytracms/core/persistence`'s `BlobStorageAdapter`, so an adapter registered here can
+ * back the asset repository directly. Selection is pluggable and configurable.
+ */
+/** A pluggable asset-storage backend (EC-133). */
+export interface AssetStorageAdapter {
+    /** Backend kind, e.g. `memory`, `plugin.base-url`, `plugin.s3`. */
+    kind: string;
+    title: string;
+    description?: string;
+    /** Persist bytes under a key. */
+    put(key: string, data: Uint8Array, contentType?: string): Promise<void>;
+    /** Read bytes back (undefined when absent). */
+    get(key: string): Promise<Uint8Array | undefined>;
+    /** A resolvable locator (URL) for the stored blob. */
+    url(key: string): string;
+    has(key: string): Promise<boolean>;
+    delete(key: string): Promise<void>;
+}
+/** A structured registration issue for the storage registry. */
+export interface AssetStorageRegistryIssue {
+    code: 'duplicate';
+    message: string;
+    ref: string;
+}
+/** Registry of asset-storage adapters keyed by kind, with a selectable active backend. */
+export declare class AssetStorageRegistry {
+    private readonly byKind;
+    private activeKind;
+    readonly issues: AssetStorageRegistryIssue[];
+    constructor(adapters?: Iterable<AssetStorageAdapter>);
+    register(adapter: AssetStorageAdapter): void;
+    has(kind: string): boolean;
+    get(kind: string): AssetStorageAdapter | undefined;
+    list(): AssetStorageAdapter[];
+    /** Select the active backend (the one the asset repository writes through). */
+    use(kind: string): boolean;
+    /** The active adapter (first registered, unless changed via {@link use}). */
+    active(): AssetStorageAdapter | undefined;
+    get size(): number;
+}
+/**
+ * In-memory asset storage (the reference adapter for tests and local inspection). Bytes persist
+ * for the lifetime of the instance.
+ */
+export declare class MemoryAssetStorage implements AssetStorageAdapter {
+    readonly kind = "memory";
+    readonly title = "In-memory";
+    readonly description = "Keeps bytes in process memory. For local development and tests.";
+    private readonly blobs;
+    put(key: string, data: Uint8Array): Promise<void>;
+    get(key: string): Promise<Uint8Array | undefined>;
+    url(key: string): string;
+    has(key: string): Promise<boolean>;
+    delete(key: string): Promise<void>;
+}
+/**
+ * A read-through CDN/base-URL adapter (example, EC-133). Bytes are served from an external base
+ * URL; this adapter resolves locators but does not own writes (uploads happen out of band). It
+ * demonstrates that a "new storage backend" is just another implementation of the interface.
+ */
+export declare class BaseUrlAssetStorage implements AssetStorageAdapter {
+    readonly kind = "plugin.base-url";
+    readonly title = "CDN base URL";
+    readonly description = "Resolves asset URLs against a configured CDN/base URL. Read-through.";
+    private readonly base;
+    constructor(baseUrl: string);
+    put(): Promise<void>;
+    get(): Promise<Uint8Array | undefined>;
+    url(key: string): string;
+    has(): Promise<boolean>;
+    delete(): Promise<void>;
+}