@elytracms/core 0.0.6

package/dist/persistence/contract-scenarios.js

@@ -0,0 +1,496 @@
+import { serializeProjectGraph, validSampleGraph } from '@elytracms/core/project-graph';
+import { sampleCollections, sampleDocuments } from '@elytracms/core/cms-core';
+import { PersistenceValidationError, RecordNotFoundError } from './core';
+import { compareReferenceEntries } from './references';
+// --- Assertions (framework-agnostic) -----------------------------------------
+export class ContractAssertionError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = 'ContractAssertionError';
+    }
+}
+function show(value) {
+    if (value === undefined)
+        return 'undefined';
+    try {
+        return JSON.stringify(value);
+    }
+    catch {
+        return String(value);
+    }
+}
+export function ensure(condition, message) {
+    if (!condition)
+        throw new ContractAssertionError(message);
+}
+function deepEqual(a, b) {
+    if (Object.is(a, b))
+        return true;
+    if (Array.isArray(a) && Array.isArray(b)) {
+        return a.length === b.length && a.every((item, i) => deepEqual(item, b[i]));
+    }
+    if (typeof a === 'object' && typeof b === 'object' && a !== null && b !== null) {
+        const keysA = Object.keys(a).filter((k) => a[k] !== undefined);
+        const keysB = Object.keys(b).filter((k) => b[k] !== undefined);
+        if (keysA.length !== keysB.length)
+            return false;
+        return keysA.every((key) => deepEqual(a[key], b[key]));
+    }
+    return false;
+}
+export function ensureEqual(actual, expected, label) {
+    if (!deepEqual(actual, expected)) {
+        throw new ContractAssertionError(`${label}: expected ${show(expected)}, got ${show(actual)}`);
+    }
+}
+/** Awaits `work` and demands it rejects with an instance of `errorClass`. */
+export async function ensureRejects(work, errorClass, label) {
+    try {
+        await work;
+    }
+    catch (error) {
+        if (error instanceof errorClass)
+            return;
+        const detail = error instanceof Error ? `${error.name}: ${error.message}` : show(error);
+        throw new ContractAssertionError(`${label}: expected rejection with ${errorClass.name}, got ${detail}`);
+    }
+    throw new ContractAssertionError(`${label}: expected rejection with ${errorClass.name}`);
+}
+/** Awaits `work` and demands it rejects (with anything). */
+async function ensureRejectsAny(work, label) {
+    try {
+        await work;
+    }
+    catch {
+        return;
+    }
+    throw new ContractAssertionError(`${label}: expected a rejection`);
+}
+// --- Scenarios ----------------------------------------------------------------
+const graphScenarios = [
+    {
+        domain: 'graphs',
+        name: 'appends revisions and reloads the latest graph losslessly',
+        async run({ adapter, projectId }) {
+            const r1 = await adapter.graphs.saveGraph(projectId, validSampleGraph, {
+                label: 'Initial import',
+            });
+            ensureEqual(r1.revision, 1, 'first revision number');
+            const r2 = await adapter.graphs.saveGraph(projectId, validSampleGraph);
+            ensureEqual(r2.revision, 2, 'second revision number');
+            const latest = await adapter.graphs.getLatest(projectId);
+            ensureEqual(latest.revision.revision, 2, 'getLatest() revision');
+            ensureEqual(serializeProjectGraph(latest.graph), serializeProjectGraph(validSampleGraph), 'lossless serialize → parse round-trip');
+            const prior = await adapter.graphs.getRevision(projectId, 1);
+            ensureEqual(prior.revision.label, 'Initial import', 'prior revision label');
+            ensureEqual((await adapter.graphs.listRevisions(projectId)).map((r) => r.revision), [2, 1], 'listRevisions() newest first');
+        },
+    },
+    {
+        domain: 'graphs',
+        name: 'reports missing graphs/revisions as not-found (never crashes)',
+        crossProject: true,
+        async run({ adapter, projectId, emptyProjectId }) {
+            await ensureRejects(adapter.graphs.getLatest(emptyProjectId), RecordNotFoundError, 'getLatest() on a project without a graph');
+            await adapter.graphs.saveGraph(projectId, validSampleGraph);
+            await ensureRejects(adapter.graphs.getRevision(projectId, 99), RecordNotFoundError, 'getRevision() for an unknown revision');
+            ensureEqual(await adapter.graphs.hasGraph(projectId), true, 'hasGraph() with a graph');
+            ensureEqual(await adapter.graphs.hasGraph(emptyProjectId), false, 'hasGraph() without');
+        },
+    },
+    {
+        domain: 'graphs',
+        name: 'rejects a malformed graph with a validation error',
+        async run({ adapter, projectId }) {
+            await ensureRejects(adapter.graphs.saveGraph(projectId, {}), PersistenceValidationError, 'saveGraph() with a malformed graph');
+        },
+    },
+];
+const cmsScenarios = [
+    {
+        domain: 'cms',
+        name: 'saves a valid schema, rejects duplicates, preserves createdAt on re-save',
+        crossProject: true,
+        async run({ adapter, projectId, emptyProjectId }) {
+            const record = await adapter.cms.saveSchema(projectId, sampleCollections);
+            ensureEqual(record.collections.length, sampleCollections.length, 'saved collection count');
+            await ensureRejects(adapter.cms.saveSchema(projectId, [...sampleCollections, sampleCollections[0]]), PersistenceValidationError, 'saveSchema() with a duplicated collection');
+            const resaved = await adapter.cms.saveSchema(projectId, sampleCollections);
+            ensureEqual(resaved.createdAt, record.createdAt, 'saveSchema() preserves createdAt');
+            await ensureRejects(adapter.cms.getSchema(emptyProjectId), RecordNotFoundError, 'getSchema() without a schema');
+            ensureEqual(await adapter.cms.findSchema(emptyProjectId), undefined, 'findSchema() without a schema');
+        },
+    },
+    {
+        domain: 'cms',
+        name: 'round-trips documents with localized variants and the publish pointer',
+        async run({ adapter, projectId, seedSchema }) {
+            await seedSchema(sampleCollections);
+            for (const doc of sampleDocuments)
+                await adapter.cms.upsertDocument(projectId, doc);
+            const localized = sampleDocuments.find((d) => d.localized);
+            const ref = { collection: localized.collection, id: localized.id };
+            const reloaded = await adapter.cms.getDocument(projectId, ref);
+            ensureEqual(reloaded.document.localized, localized.localized, 'localized variants intact');
+            // EC-224: publish-ness is the version pointer — record a snapshot, pin it.
+            const version = await adapter.cms.saveDocumentVersion(projectId, reloaded.document, {
+                label: 'published',
+            });
+            const published = await adapter.cms.publishDocumentVersion(projectId, ref, version.version);
+            ensureEqual(published.publishedVersion, version.version, 'publishDocumentVersion() pins live');
+            ensureEqual((await adapter.cms.getDocument(projectId, ref)).publishedVersion, version.version, 'pin persisted');
+            ensureEqual(published.createdAt, reloaded.createdAt, 'pinning preserves createdAt');
+        },
+    },
+    {
+        domain: 'cms',
+        name: 'stores documents data-only; lists deterministically; deletes with not-found',
+        async run({ adapter, projectId, seedSchema }) {
+            await seedSchema(sampleCollections);
+            // EC-183 (AD-11): the persistence layer is a pure document store — it does
+            // NOT reject an undeclared collection (collection-membership validation
+            // moved to `@elytracms/core/cms-core` `validateDocument`, run by the studio
+            // pre-dispatch and by the operations layer for declared collections). A
+            // document in any collection round-trips; shape is still enforced.
+            const stored = await adapter.cms.upsertDocument(projectId, {
+                collection: 'ghosts',
+                id: 'g1',
+                values: {},
+            });
+            ensureEqual(stored.document.collection, 'ghosts', 'stores an undeclared collection');
+            await adapter.cms.deleteDocument(projectId, { collection: 'ghosts', id: 'g1' });
+            for (const doc of sampleDocuments)
+                await adapter.cms.upsertDocument(projectId, doc);
+            const posts = await adapter.cms.listDocuments(projectId, 'post');
+            ensure(posts.length > 0, 'listDocuments(post) is non-empty');
+            ensure(posts.every((r) => r.document.collection === 'post'), 'listDocuments(post) filters by collection');
+            const all = await adapter.cms.listDocuments(projectId);
+            const keys = all.map((r) => `${r.document.collection}:${r.document.id}`);
+            ensureEqual(keys, [...keys].sort(), 'listDocuments() ordered by document key');
+            const first = sampleDocuments[0];
+            const ref = { collection: first.collection, id: first.id };
+            await adapter.cms.deleteDocument(projectId, ref);
+            await ensureRejects(adapter.cms.getDocument(projectId, ref), RecordNotFoundError, 'getDocument() after delete');
+            await ensureRejects(adapter.cms.deleteDocument(projectId, ref), RecordNotFoundError, 'deleteDocument() when already gone');
+        },
+    },
+    {
+        domain: 'cms',
+        name: 'records monotonic versions, pins/unpins the live one, cascades on delete (EC-224)',
+        async run({ adapter, projectId, seedSchema }) {
+            await seedSchema(sampleCollections);
+            const doc = sampleDocuments[0];
+            const ref = { collection: doc.collection, id: doc.id };
+            await adapter.cms.upsertDocument(projectId, doc);
+            // No versions, nothing pinned, before the first snapshot.
+            ensureEqual((await adapter.cms.listDocumentVersions(projectId, ref)).length, 0, 'no versions initially');
+            await ensureRejects(adapter.cms.getDocumentVersion(projectId, ref, 1), RecordNotFoundError, 'getDocumentVersion() before any snapshot');
+            // Append two versions — monotonic numbering, newest-first listing.
+            const v1 = await adapter.cms.saveDocumentVersion(projectId, doc, { label: 'published' });
+            ensureEqual(v1.version, 1, 'first recorded version is 1');
+            const v2 = await adapter.cms.saveDocumentVersion(projectId, doc);
+            ensureEqual(v2.version, 2, 'second recorded version is 2');
+            ensureEqual((await adapter.cms.listDocumentVersions(projectId, ref)).map((r) => r.version), [2, 1], 'listDocumentVersions() newest first');
+            ensureEqual((await adapter.cms.getDocumentVersion(projectId, ref, 1)).label, 'published', 'version label round-trips');
+            // Pin v1 live; pinning an unknown version is not-found.
+            const pinned = await adapter.cms.publishDocumentVersion(projectId, ref, 1);
+            ensureEqual(pinned.publishedVersion, 1, 'publishDocumentVersion() pins the live version');
+            ensureEqual((await adapter.cms.getDocument(projectId, ref)).publishedVersion, 1, 'published pin persists on the document');
+            // A draft edit must NOT clear the live pin (the Sanity model: editing the
+            // working draft never unpublishes). Cross-adapter parity: Convex patches
+            // the row, in-memory preserves `publishedVersion` the same way.
+            await adapter.cms.upsertDocument(projectId, doc);
+            ensureEqual((await adapter.cms.getDocument(projectId, ref)).publishedVersion, 1, 'a draft edit (upsert) preserves the published pin');
+            await ensureRejects(adapter.cms.publishDocumentVersion(projectId, ref, 99), RecordNotFoundError, 'publishDocumentVersion() with an unknown version');
+            // Unpin; unpublishing a second time is an invalid transition.
+            const unpinned = await adapter.cms.unpublishDocument(projectId, ref);
+            ensureEqual(unpinned.publishedVersion, undefined, 'unpublishDocument() clears the pin');
+            await ensureRejects(adapter.cms.unpublishDocument(projectId, ref), PersistenceValidationError, 'unpublishDocument() when nothing is published');
+            // Delete cascades the version history; a fresh document renumbers from 1.
+            await adapter.cms.publishDocumentVersion(projectId, ref, 2);
+            await adapter.cms.deleteDocument(projectId, ref);
+            await adapter.cms.upsertDocument(projectId, doc);
+            ensureEqual((await adapter.cms.listDocumentVersions(projectId, ref)).length, 0, 'deleteDocument() cascades the version history');
+            ensureEqual((await adapter.cms.getDocument(projectId, ref)).publishedVersion, undefined, 'a re-created document is unpublished');
+            const reborn = await adapter.cms.saveDocumentVersion(projectId, doc);
+            ensureEqual(reborn.version, 1, 'version numbering restarts after a cascade delete');
+            // listAllDocumentVersions aggregates across documents (delivery feeders).
+            const other = { collection: doc.collection, id: 'ec224-other', values: {} };
+            await adapter.cms.upsertDocument(projectId, other);
+            await adapter.cms.saveDocumentVersion(projectId, other);
+            const allVersions = await adapter.cms.listAllDocumentVersions(projectId);
+            const docKeys = new Set(allVersions.map((r) => `${r.collection}:${r.docId}`));
+            ensure(docKeys.has(`${doc.collection}:${doc.id}`) &&
+                docKeys.has(`${other.collection}:${other.id}`), 'listAllDocumentVersions() spans documents');
+        },
+    },
+];
+const assetScenarios = [
+    {
+        domain: 'assets',
+        name: 'upserts, resolves, lists, and removes asset metadata',
+        async run({ adapter, projectId }) {
+            const a = await adapter.assets.upsertAsset(projectId, {
+                filename: 'cover.jpg',
+                contentType: 'image/jpeg',
+                byteSize: 1024,
+                width: 1200,
+                height: 630,
+                alt: 'Cover image',
+                title: 'Launch cover',
+            });
+            ensureEqual(a.storageKey, `${projectId}/${a.id}`, 'default storageKey derivation');
+            ensureEqual(a.title, 'Launch cover', 'title round-trips (EC-152 metadata)');
+            ensureEqual(a.width, 1200, 'width round-trips');
+            const b = await adapter.assets.upsertAsset(projectId, {
+                id: 'asset_logo',
+                filename: 'logo.svg',
+                contentType: 'image/svg+xml',
+                byteSize: 256,
+            });
+            ensureEqual(b.id, 'asset_logo', 'explicit asset id honored');
+            const resolved = await adapter.assets.resolveMany(projectId, [a.id, 'missing']);
+            ensureEqual(resolved.get(a.id)?.filename, 'cover.jpg', 'resolveMany() hit');
+            ensureEqual(resolved.has('missing'), false, 'resolveMany() miss');
+            const listed = await adapter.assets.listAssets(projectId);
+            ensureEqual(listed.map((r) => r.id), [a.id, b.id].sort(), 'listAssets() ordered by id');
+            await adapter.assets.removeAsset(projectId, a.id);
+            await ensureRejects(adapter.assets.getAsset(projectId, a.id), RecordNotFoundError, 'getAsset() after remove');
+            await ensureRejects(adapter.assets.removeAsset(projectId, a.id), RecordNotFoundError, 'removeAsset() when already gone');
+            ensureEqual(await adapter.assets.findAsset(projectId, a.id), undefined, 'findAsset() miss');
+        },
+    },
+];
+const publishingScenarios = [
+    {
+        domain: 'publishing',
+        name: 'publishes, reverts to draft, preserves createdAt',
+        async run({ adapter, projectId }) {
+            const published = await adapter.publishing.publish(projectId, {
+                revisionId: 'rev_1',
+                revision: 1,
+            });
+            ensureEqual(published.status, 'published', 'publish() status');
+            ensureEqual(published.publishedRevision, 1, 'publish() pinned revision');
+            const republished = await adapter.publishing.publish(projectId, {
+                revisionId: 'rev_2',
+                revision: 2,
+            });
+            ensureEqual(republished.publishedRevision, 2, 'republish() repins');
+            ensureEqual(republished.createdAt, published.createdAt, 'republish() preserves createdAt');
+            const reverted = await adapter.publishing.unpublish(projectId);
+            ensureEqual(reverted.status, 'draft', 'unpublish() status');
+            ensureEqual(reverted.publishedRevisionId, undefined, 'unpublish() clears the pin');
+            ensureEqual(reverted.createdAt, published.createdAt, 'unpublish() preserves createdAt');
+        },
+    },
+    {
+        domain: 'publishing',
+        name: 'validates transitions and inputs',
+        async run({ adapter, projectId }) {
+            await ensureRejects(adapter.publishing.unpublish(projectId), PersistenceValidationError, 'unpublish() of a never-published deployment');
+            await ensureRejects(adapter.publishing.publish(projectId, { revisionId: '', revision: 1 }), PersistenceValidationError, 'publish() without a revision id');
+            await ensureRejects(adapter.publishing.publish(projectId, { revisionId: 'rev_1', revision: 0 }), PersistenceValidationError, 'publish() with a non-positive revision');
+        },
+    },
+    {
+        domain: 'publishing',
+        name: 'reports the unpublished state as not-found before the first publish',
+        async run({ adapter, projectId }) {
+            await ensureRejects(adapter.publishing.getState(projectId), RecordNotFoundError, 'getState() before the first publish');
+            ensureEqual(await adapter.publishing.findState(projectId), undefined, 'findState() before the first publish');
+        },
+    },
+];
+const memberScenarios = [
+    {
+        domain: 'members',
+        name: 'sets, updates, lists, and removes memberships',
+        async run({ adapter, projectId, sessionUserId }) {
+            const blue = await adapter.members.setMember(projectId, 'user_blue', 'editor');
+            ensureEqual(blue.role, 'editor', 'setMember() role');
+            await adapter.members.setMember(projectId, 'user_zed', 'viewer');
+            const promoted = await adapter.members.setMember(projectId, 'user_blue', 'admin');
+            ensureEqual(promoted.role, 'admin', 'setMember() updates an existing role');
+            ensureEqual(promoted.createdAt, blue.createdAt, 'role update preserves createdAt');
+            ensureEqual((await adapter.members.findMember(projectId, 'user_zed'))?.role, 'viewer', 'findMember()');
+            const expectedUsers = [sessionUserId, 'user_blue', 'user_zed'].sort();
+            ensureEqual((await adapter.members.listMembers(projectId)).map((m) => m.userId), expectedUsers, 'listMembers() ordered by userId');
+            await adapter.members.removeMember(projectId, 'user_zed');
+            ensureEqual(await adapter.members.findMember(projectId, 'user_zed'), undefined, 'findMember() after remove');
+            await ensureRejects(adapter.members.removeMember(projectId, 'user_zed'), RecordNotFoundError, 'removeMember() when already gone');
+        },
+    },
+    {
+        domain: 'members',
+        name: 'lists the session user’s memberships across projects, ordered by project',
+        crossProject: true,
+        async run({ adapter, projectId, emptyProjectId, sessionUserId }) {
+            const memberships = await adapter.members.listMembershipsForUser(sessionUserId);
+            const projectIds = memberships.map((m) => m.projectId);
+            ensureEqual(projectIds, [...projectIds].sort(), 'memberships ordered by projectId');
+            ensure(projectIds.includes(projectId), 'membership on the primary project');
+            ensure(projectIds.includes(emptyProjectId), 'membership on the empty project');
+            ensure(memberships.every((m) => m.userId === sessionUserId), 'memberships belong to the session user');
+        },
+    },
+];
+const cliTokenScenarios = [
+    {
+        domain: 'cli-tokens',
+        name: 'creates, lists, revokes (idempotently), and verifies by hash',
+        async run({ adapter }) {
+            const t1 = await adapter.cliTokens.createToken({
+                label: 'CI push token',
+                tokenHash: 'hash_a',
+            });
+            await adapter.cliTokens.createToken({ label: 'Local sync', tokenHash: 'hash_b' });
+            const listed = await adapter.cliTokens.listTokens();
+            ensureEqual(listed.length, 2, 'listTokens() count');
+            ensureEqual(listed.map((t) => t.id), listed.map((t) => t.id).sort(), 'listTokens() ordered by token id');
+            ensureEqual((await adapter.cliTokens.findByHash('hash_a'))?.id, t1.id, 'findByHash() resolves the token');
+            ensureEqual(await adapter.cliTokens.findByHash('nope'), undefined, 'findByHash() miss');
+            const revoked = await adapter.cliTokens.revokeToken(t1.id);
+            ensure(typeof revoked.revokedAt === 'string', 'revokeToken() stamps revokedAt');
+            const again = await adapter.cliTokens.revokeToken(t1.id);
+            ensureEqual(again.revokedAt, revoked.revokedAt, 'revokeToken() is idempotent');
+            ensureEqual((await adapter.cliTokens.findByHash('hash_a'))?.revokedAt, revoked.revokedAt, 'revoked tokens stay findable (auditable)');
+            await ensureRejects(adapter.cliTokens.revokeToken('tok_missing'), RecordNotFoundError, 'revokeToken() unknown id');
+        },
+    },
+];
+const DOC_SOURCE = { type: 'document', id: 'post:hello' };
+const referenceScenarios = [
+    {
+        domain: 'references',
+        name: 'replaces per source and answers outbound/inbound lookups deterministically',
+        async run({ adapter, projectId }) {
+            const entries = await adapter.references.replaceForSource(projectId, 'draft', DOC_SOURCE, [
+                {
+                    path: 'values/cover',
+                    target: { type: 'asset', id: 'asset_cover' },
+                    kind: 'asset-field',
+                },
+                {
+                    path: 'values/author',
+                    target: { type: 'document', id: 'author:ada' },
+                    kind: 'relation-field',
+                },
+            ]);
+            ensureEqual(entries.length, 2, 'replaceForSource() returns the stored entries');
+            ensureEqual(entries, [...entries].sort(compareReferenceEntries), 'entries are canonically ordered');
+            const outbound = await adapter.references.outbound(projectId, DOC_SOURCE, {
+                variant: 'draft',
+            });
+            ensureEqual(outbound.length, 2, 'outbound() finds both entries');
+            const inbound = await adapter.references.inbound(projectId, {
+                type: 'asset',
+                id: 'asset_cover',
+            });
+            ensureEqual(inbound.length, 1, 'inbound() finds the asset usage');
+            ensureEqual(inbound[0].source, DOC_SOURCE, 'inbound() attributes the source');
+            // Replace-all-for-source: the previous entries vanish.
+            await adapter.references.replaceForSource(projectId, 'draft', DOC_SOURCE, [
+                {
+                    path: 'values/author',
+                    target: { type: 'document', id: 'author:ada' },
+                    kind: 'relation-field',
+                },
+            ]);
+            ensureEqual((await adapter.references.outbound(projectId, DOC_SOURCE)).length, 1, 'replaceForSource() replaces rather than appends');
+        },
+    },
+    {
+        domain: 'references',
+        name: 'replaces by source type, removes per source, and clears projects',
+        async run({ adapter, projectId }) {
+            await adapter.references.replaceForSource(projectId, 'draft', DOC_SOURCE, [
+                {
+                    path: 'values/author',
+                    target: { type: 'document', id: 'author:ada' },
+                    kind: 'relation-field',
+                },
+            ]);
+            const pageEntries = await adapter.references.replaceForSourceTypes(projectId, 'draft', ['page'], [
+                {
+                    source: { type: 'page', id: 'page.home' },
+                    path: 'root/props/cover',
+                    target: { type: 'asset', id: 'asset_cover' },
+                    kind: 'prop-binding',
+                },
+            ]);
+            ensureEqual(pageEntries.length, 1, 'replaceForSourceTypes() returns the scoped entries');
+            ensureEqual((await adapter.references.listEntries(projectId, 'draft')).length, 2, 'document entries survive a page-scoped replace');
+            await adapter.references.removeForSource(projectId, DOC_SOURCE, 'draft');
+            ensureEqual((await adapter.references.outbound(projectId, DOC_SOURCE)).length, 0, 'removeForSource() clears the source');
+            // EC-269 build marker: absent until set, round-trips, cleared by clearProject.
+            ensureEqual(await adapter.references.getBuildMarker(projectId), null, 'build marker is absent until a backfill sets it');
+            await adapter.references.setBuildMarker(projectId, { entryCount: 7 });
+            ensureEqual((await adapter.references.getBuildMarker(projectId))?.entryCount, 7, 'setBuildMarker() round-trips the marker');
+            await adapter.references.clearProject(projectId);
+            ensureEqual((await adapter.references.listEntries(projectId)).length, 0, 'clearProject() empties the index');
+            ensureEqual(await adapter.references.getBuildMarker(projectId), null, 'clearProject() also clears the build marker');
+        },
+    },
+];
+/**
+ * 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 const graphEditPublishRoundTrip = {
+    domain: 'round-trip',
+    name: 'graph edit → revision record → publish round-trips',
+    async run({ adapter, projectId }) {
+        const r1 = await adapter.graphs.saveGraph(projectId, validSampleGraph, {
+            label: 'Initial import',
+        });
+        // Edit: rename the project graph (a real content change, deterministic).
+        const edited = structuredClone(validSampleGraph);
+        edited.metadata = { ...edited.metadata, name: 'Sample Project (edited)' };
+        const r2 = await adapter.graphs.saveGraph(projectId, edited, { message: 'Rename project' });
+        ensureEqual(r2.revision, r1.revision + 1, 'the edit appends a new revision');
+        const state = await adapter.publishing.publish(projectId, {
+            revisionId: r2.id,
+            revision: r2.revision,
+        });
+        ensureEqual(state.status, 'published', 'publish() succeeds');
+        ensureEqual(state.publishedRevisionId, r2.id, 'the edited revision is pinned');
+        const live = await adapter.graphs.getRevision(projectId, r2.revision);
+        ensureEqual(live.graph.metadata?.name, 'Sample Project (edited)', 'published graph content');
+        const original = await adapter.graphs.getRevision(projectId, r1.revision);
+        ensureEqual(original.graph.metadata?.name, 'Sample Project', 'history stays intact');
+        const reverted = await adapter.publishing.unpublish(projectId);
+        ensureEqual(reverted.status, 'draft', 'unpublish() reverts to draft');
+    },
+};
+const stateScenarios = [
+    {
+        domain: 'round-trip',
+        name: 'rejects pinning a version that was never recorded',
+        async run({ adapter, projectId, seedSchema }) {
+            await seedSchema(sampleCollections);
+            const doc = sampleDocuments[0];
+            await adapter.cms.upsertDocument(projectId, doc);
+            // EC-224: a pin must reference an EXISTING recorded version — pinning an
+            // unknown version is a not-found, never a silent no-op.
+            await ensureRejectsAny(adapter.cms.publishDocumentVersion(projectId, { collection: doc.collection, id: doc.id }, 999), 'publishDocumentVersion() with an unrecorded version');
+        },
+    },
+];
+/**
+ * Every behavioural scenario both adapters must pass (EC-049 → EC-153).
+ * Hosts iterate this list and run each scenario against a fresh harness.
+ */
+export const PERSISTENCE_CONTRACT_SCENARIOS = [
+    ...graphScenarios,
+    ...cmsScenarios,
+    ...assetScenarios,
+    ...publishingScenarios,
+    ...memberScenarios,
+    ...cliTokenScenarios,
+    ...referenceScenarios,
+    graphEditPublishRoundTrip,
+    ...stateScenarios,
+];
+//# sourceMappingURL=contract-scenarios.js.map

package/dist/persistence/contract-scenarios.js.map

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

package/dist/persistence/core.d.ts

@@ -0,0 +1,96 @@
+import { z } from 'zod';
+export { createSequentialClock, createSequentialIdFactory, } from '@elytracms/core/studio-core';
+export type { Clock, IdFactory } from '@elytracms/core/studio-core';
+/**
+ * Timestamps every persisted record carries (brief §10). Kept as ISO strings so
+ * fixtures and seeds stay byte-for-byte deterministic across runs.
+ */
+export declare const recordMetaSchema: z.ZodObject<{
+    createdAt: z.ZodString;
+    updatedAt: z.ZodString;
+}, z.core.$strip>;
+export type RecordMeta = z.infer<typeof recordMetaSchema>;
+/**
+ * Defensive deep clone for records handed back from in-memory repositories, so
+ * callers can never mutate the persisted store by mutating a returned value.
+ * Mirrors the no-aliasing invariant documented in `@elytracms/core/studio-core`'s
+ * `InMemoryProjectRepository`. Records are plain JSON-shaped data.
+ */
+export declare function cloneRecord<T>(value: T): T;
+/**
+ * Which backend a persistence adapter is talking to, and whether it's reachable.
+ * Lets the Studio surface degraded/offline states without leaking provider types.
+ */
+export declare const backendKindSchema: z.ZodEnum<{
+    convex: "convex";
+    "in-memory": "in-memory";
+}>;
+export type BackendKind = z.infer<typeof backendKindSchema>;
+export interface BackendStatus {
+    backend: BackendKind;
+    available: boolean;
+    detail?: string;
+}
+/**
+ * A generic structured issue carried by a {@link PersistenceValidationError}.
+ * Domain issues (graph/cms/binding) are mapped onto this shape so a single error
+ * type can carry any validation failure (brief §4.11).
+ */
+export declare const persistenceIssueSchema: z.ZodObject<{
+    code: z.ZodString;
+    message: z.ZodString;
+    path: z.ZodOptional<z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>>;
+    domain: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type PersistenceIssue = z.infer<typeof persistenceIssueSchema>;
+export declare const persistenceErrorCodeSchema: z.ZodEnum<{
+    unknown: "unknown";
+    validation: "validation";
+    "not-found": "not-found";
+    conflict: "conflict";
+    "backend-unavailable": "backend-unavailable";
+}>;
+export type PersistenceErrorCode = z.infer<typeof persistenceErrorCodeSchema>;
+export declare abstract class PersistenceError extends Error {
+    abstract readonly code: PersistenceErrorCode;
+    constructor(message: string, options?: {
+        cause?: unknown;
+    });
+}
+/** No record of `kind` exists for the given key. */
+export declare class RecordNotFoundError extends PersistenceError {
+    readonly kind: string;
+    readonly key: string;
+    readonly code: "not-found";
+    constructor(kind: string, key: string);
+}
+/** A record would collide with an existing one (unique key/identity). */
+export declare class RecordConflictError extends PersistenceError {
+    readonly kind: string;
+    readonly key: string;
+    readonly code: "conflict";
+    constructor(kind: string, key: string, message?: string);
+}
+/** A write failed structured validation; carries the issues. */
+export declare class PersistenceValidationError extends PersistenceError {
+    readonly issues: readonly PersistenceIssue[];
+    readonly code: "validation";
+    constructor(message: string, issues: readonly PersistenceIssue[]);
+}
+/** The backing store is unreachable or returned a transport-level failure. */
+export declare class BackendUnavailableError extends PersistenceError {
+    readonly code: "backend-unavailable";
+    constructor(message?: string, options?: {
+        cause?: unknown;
+    });
+}
+/** Any failure that does not map onto a more specific category. */
+export declare class UnknownPersistenceError extends PersistenceError {
+    readonly code: "unknown";
+    constructor(message?: string, options?: {
+        cause?: unknown;
+    });
+}
+export declare function isPersistenceError(value: unknown): value is PersistenceError;
+/** Normalize any thrown value onto the persistence error taxonomy. */
+export declare function asPersistenceError(value: unknown): PersistenceError;