@elytracms/core 0.0.6

package/dist/persistence/cms.js

@@ -0,0 +1,232 @@
+import { z } from 'zod';
+import { collectionDefSchema, createCollectionRegistry, documentKey, documentSchema, isCmsValid, } from '@elytracms/core/cms-core';
+import { PersistenceValidationError, RecordNotFoundError, cloneRecord, recordMetaSchema, createSequentialClock, } from './core';
+/** The persisted CMS schema for a project: its collection definitions (brief §7.4, §10). */
+export const cmsSchemaRecordSchema = recordMetaSchema.extend({
+    projectId: z.string().min(1),
+    collections: z.array(collectionDefSchema),
+});
+/**
+ * A persisted CMS document. The stored `document` is the continuous working
+ * **draft** (every edit updates it); `publishedVersion` pins which recorded
+ * version is currently live (the Sanity draft/published model, EC-224). Absent
+ * `publishedVersion` means the document has never been published / is unpublished.
+ * Localized variants ride along on the `CmsDocument` itself.
+ */
+export const cmsDocumentRecordSchema = recordMetaSchema.extend({
+    projectId: z.string().min(1),
+    document: documentSchema,
+    /** The recorded version currently published/live (EC-224); absent = unpublished. */
+    publishedVersion: z.number().int().positive().optional(),
+});
+/**
+ * An immutable snapshot of a document at one recorded version (EC-224). Append-only,
+ * mirroring {@link GraphRevisionRecord} but document-scoped: one row per version,
+ * keyed by (projectId, collection, docId, version). Created on publish (the promoted
+ * draft) and by an explicit pre-restore snapshot, never on a plain draft edit.
+ */
+export const documentVersionRecordSchema = z.object({
+    projectId: z.string().min(1),
+    collection: z.string().min(1),
+    docId: z.string().min(1),
+    /** 1-based, monotonically increasing per (projectId, collection, docId). */
+    version: z.number().int().positive(),
+    /** Full document snapshot at this version. */
+    snapshot: documentSchema,
+    createdAt: z.string().min(1),
+    /** Optional label, e.g. "published" or an author note. */
+    label: z.string().optional(),
+});
+export class InMemoryCmsRepository {
+    schemas = new Map();
+    /** projectId → (documentKey → record). */
+    documents = new Map();
+    /** projectId → (documentKey → versions in ascending version order). */
+    versions = new Map();
+    clock;
+    constructor(options = {}) {
+        this.clock = options.clock ?? createSequentialClock();
+        for (const schema of options.seedSchemas ?? []) {
+            const parsed = cmsSchemaRecordSchema.parse(schema);
+            this.schemas.set(parsed.projectId, parsed);
+        }
+        for (const doc of options.seedDocuments ?? []) {
+            const parsed = cmsDocumentRecordSchema.parse(doc);
+            this.docMap(parsed.projectId).set(documentKey(parsed.document), parsed);
+        }
+    }
+    docMap(projectId) {
+        const existing = this.documents.get(projectId);
+        if (existing)
+            return existing;
+        const created = new Map();
+        this.documents.set(projectId, created);
+        return created;
+    }
+    versionMap(projectId) {
+        const existing = this.versions.get(projectId);
+        if (existing)
+            return existing;
+        const created = new Map();
+        this.versions.set(projectId, created);
+        return created;
+    }
+    async saveSchema(projectId, collections) {
+        // Reuse the canonical structural validation (duplicate ids, bad select options).
+        const registry = createCollectionRegistry(collections);
+        if (!isCmsValid(registry.issues)) {
+            throw new PersistenceValidationError('CMS schema is invalid and cannot be persisted.', registry.issues
+                .filter((i) => i.severity === 'error')
+                .map((i) => ({ code: i.code, message: i.message, path: i.path, domain: 'cms' })));
+        }
+        const now = this.clock();
+        const previous = this.schemas.get(projectId);
+        const record = {
+            projectId,
+            collections: registry.list(),
+            createdAt: previous?.createdAt ?? now,
+            updatedAt: now,
+        };
+        this.schemas.set(projectId, record);
+        return cloneRecord(record);
+    }
+    async getSchema(projectId) {
+        const record = this.schemas.get(projectId);
+        if (!record)
+            throw new RecordNotFoundError('cms-schema', projectId);
+        return cloneRecord(record);
+    }
+    async findSchema(projectId) {
+        const record = this.schemas.get(projectId);
+        return record ? cloneRecord(record) : undefined;
+    }
+    async upsertDocument(projectId, document) {
+        // The persistence layer is a pure document store (EC-183, AD-11): CMS
+        // collection schemas are config-owned and collection-membership validation
+        // lives in `@elytracms/core/cms-core` `validateDocument` (run by the studio
+        // pre-dispatch), not the write path. We still parse the canonical document
+        // shape so malformed blobs never reach storage.
+        const parsedDoc = documentSchema.parse(document);
+        const map = this.docMap(projectId);
+        const key = documentKey(parsedDoc);
+        const now = this.clock();
+        const previous = map.get(key);
+        const record = {
+            projectId,
+            document: parsedDoc,
+            // A draft edit must NOT clear the live pin (EC-224, the Sanity model:
+            // editing the working draft never unpublishes). Convex patches the row
+            // (absent keys untouched); the in-memory store must preserve it the same
+            // way — only publish/unpublish move the pointer.
+            ...(previous?.publishedVersion !== undefined
+                ? { publishedVersion: previous.publishedVersion }
+                : {}),
+            createdAt: previous?.createdAt ?? now,
+            updatedAt: now,
+        };
+        map.set(key, record);
+        return cloneRecord(record);
+    }
+    async getDocument(projectId, ref) {
+        const record = this.documents.get(projectId)?.get(documentKey(ref));
+        if (!record)
+            throw new RecordNotFoundError('cms-document', `${projectId}/${documentKey(ref)}`);
+        return cloneRecord(record);
+    }
+    async findDocument(projectId, ref) {
+        const record = this.documents.get(projectId)?.get(documentKey(ref));
+        return record ? cloneRecord(record) : undefined;
+    }
+    async listDocuments(projectId, collection) {
+        const all = [...(this.documents.get(projectId)?.values() ?? [])];
+        const filtered = collection ? all.filter((r) => r.document.collection === collection) : all;
+        return filtered
+            .sort((a, b) => (documentKey(a.document) < documentKey(b.document) ? -1 : 1))
+            .map(cloneRecord);
+    }
+    async deleteDocument(projectId, ref) {
+        const map = this.documents.get(projectId);
+        const key = documentKey(ref);
+        if (!map?.has(key))
+            throw new RecordNotFoundError('cms-document', `${projectId}/${key}`);
+        map.delete(key);
+        // Cascade the version history (EC-224) — no orphaned snapshots survive a delete.
+        this.versions.get(projectId)?.delete(key);
+    }
+    async saveDocumentVersion(projectId, snapshot, options = {}) {
+        const parsed = documentSchema.parse(snapshot);
+        const key = documentKey(parsed);
+        const list = this.versionMap(projectId).get(key) ?? [];
+        const version = (list.at(-1)?.version ?? 0) + 1;
+        const record = {
+            projectId,
+            collection: parsed.collection,
+            docId: parsed.id,
+            version,
+            snapshot: parsed,
+            createdAt: this.clock(),
+            ...(options.label ? { label: options.label } : {}),
+        };
+        list.push(record);
+        this.versionMap(projectId).set(key, list);
+        return cloneRecord(record);
+    }
+    async listDocumentVersions(projectId, ref) {
+        const list = this.versions.get(projectId)?.get(documentKey(ref)) ?? [];
+        return [...list].reverse().map(cloneRecord);
+    }
+    async listAllDocumentVersions(projectId) {
+        const all = [];
+        for (const list of this.versions.get(projectId)?.values() ?? [])
+            all.push(...list);
+        return all
+            .sort((a, b) => {
+            const ka = documentKey({ collection: a.collection, id: a.docId });
+            const kb = documentKey({ collection: b.collection, id: b.docId });
+            if (ka !== kb)
+                return ka < kb ? -1 : 1;
+            return a.version - b.version;
+        })
+            .map(cloneRecord);
+    }
+    async getDocumentVersion(projectId, ref, version) {
+        const key = documentKey(ref);
+        const found = this.versions
+            .get(projectId)
+            ?.get(key)
+            ?.find((v) => v.version === version);
+        if (!found) {
+            throw new RecordNotFoundError('cms-document-version', `${projectId}/${key}#${version}`);
+        }
+        return cloneRecord(found);
+    }
+    async publishDocumentVersion(projectId, ref, version) {
+        const existing = await this.getDocument(projectId, ref);
+        // The pinned version must exist (throws RecordNotFoundError otherwise).
+        await this.getDocumentVersion(projectId, ref, version);
+        const updated = {
+            ...existing,
+            publishedVersion: version,
+            updatedAt: this.clock(),
+        };
+        this.docMap(projectId).set(documentKey(ref), updated);
+        return cloneRecord(updated);
+    }
+    async unpublishDocument(projectId, ref) {
+        const existing = await this.getDocument(projectId, ref);
+        if (existing.publishedVersion === undefined) {
+            throw new PersistenceValidationError('Document is not currently published.', [
+                {
+                    code: 'invalid-transition',
+                    message: 'Cannot unpublish: the document has no published version.',
+                    domain: 'cms',
+                },
+            ]);
+        }
+        const { publishedVersion: _cleared, ...rest } = existing;
+        const updated = { ...rest, updatedAt: this.clock() };
+        this.docMap(projectId).set(documentKey(ref), updated);
+        return cloneRecord(updated);
+    }
+}
+//# sourceMappingURL=cms.js.map

package/dist/persistence/cms.js.map

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

package/dist/persistence/contract-scenarios.d.ts

@@ -0,0 +1,73 @@
+import type { CollectionDef } from '@elytracms/core/cms-core';
+import type { PersistenceAdapter } from './adapter';
+/**
+ * EC-153 — the adapter-contract scenario suite, exported as plain reusable
+ * functions so **every** {@link PersistenceAdapter} implementation runs the
+ * *same* behavioural checks (EC-049 promoted from in-memory-only tests):
+ *
+ * - `packages/persistence` runs them against `InMemoryPersistenceAdapter`.
+ * - `apps/builder` runs them against `ConvexPersistenceAdapter` over the
+ *   fake-ctx Convex backend (deployment-free, real Convex function handlers).
+ *
+ * The module is deliberately test-framework-agnostic (no vitest import — it is
+ * exported from the package index, which browser code consumes): scenarios
+ * throw `ContractAssertionError` on divergence and the host suite turns each
+ * scenario into one `it(...)`.
+ */
+/** Everything a scenario may assume about the world it runs in. */
+export interface ContractContext {
+    adapter: PersistenceAdapter;
+    /**
+     * An existing project the session user administers. Scenarios write all
+     * project-scoped records here.
+     */
+    projectId: string;
+    /**
+     * A second project the session user administers, guaranteed to hold **no**
+     * graph/schema/content — backs the missing-record scenarios (Convex role
+     * guards require membership even to learn that nothing exists).
+     */
+    emptyProjectId: string;
+    /** The authenticated caller (Convex guards + caller-scoped queries use it). */
+    sessionUserId: string;
+    /**
+     * Seed the project's CMS collection schema for the scenario. Adapter-specific
+     * (EC-183, AD-11): the in-memory adapter persists it via `saveSchema`; the
+     * Convex adapter's schema is config-owned (injected at construction, no
+     * `cmsSchemas` table), so this is a no-op there. Scenarios that need a schema
+     * present call this instead of `adapter.cms.saveSchema` so both adapters work.
+     */
+    seedSchema(collections: readonly CollectionDef[]): Promise<void>;
+}
+/** Builds a *fresh* context per scenario — scenarios never share state. */
+export type ContractHarness = () => Promise<ContractContext>;
+export interface ContractScenario {
+    domain: 'graphs' | 'cms' | 'assets' | 'publishing' | 'members' | 'cli-tokens' | 'references' | 'round-trip';
+    name: string;
+    /**
+     * Asserts isolation between two projects (uses `emptyProjectId`). Not
+     * meaningful for single-tenant backends where one deployment IS one project
+     * (EC-179) — those harnesses filter these out; multi-project adapters
+     * (in-memory) run them all.
+     */
+    crossProject?: boolean;
+    run(ctx: ContractContext): Promise<void>;
+}
+export declare class ContractAssertionError extends Error {
+    constructor(message: string);
+}
+export declare function ensure(condition: unknown, message: string): asserts condition;
+export declare function ensureEqual(actual: unknown, expected: unknown, label: string): void;
+/** Awaits `work` and demands it rejects with an instance of `errorClass`. */
+export declare function ensureRejects(work: Promise<unknown>, errorClass: abstract new (...args: never[]) => Error, label: string): Promise<void>;
+/**
+ * The acceptance-criterion round-trip (EC-153): edit the graph → a new revision
+ * record → publish that revision → the deployment pins it — against whatever
+ * adapter the harness provides.
+ */
+export declare const graphEditPublishRoundTrip: ContractScenario;
+/**
+ * Every behavioural scenario both adapters must pass (EC-049 → EC-153).
+ * Hosts iterate this list and run each scenario against a fresh harness.
+ */
+export declare const PERSISTENCE_CONTRACT_SCENARIOS: readonly ContractScenario[];