@elytracms/core 0.0.6

package/dist/operations/documents.js

@@ -0,0 +1,344 @@
+import { z } from 'zod';
+import { createCollectionRegistry, documentKey, documentRefSchema, documentSchema, selfTypeDocument, validateDocument, } from '@elytracms/core/cms-core';
+import { extractReferences } from '@elytracms/core/persistence';
+import { OperationFailure, bindOperation, defineCommand, defineQuery, strictReferenceConflictError, validationError, } from './core';
+import { projectIdSchema } from '@elytracms/core/studio-core';
+/**
+ * CMS document operations (EC-139). Covers the studio's document mutations —
+ * create/save (upsert), delete, and draft/published transitions — plus the
+ * import flow, which is upserts in a batch. Document version history (EC-224)
+ * adds `snapshot` / `listVersions` / `restore` over the append-only version
+ * store; publish/unpublish move to the version pointer in a later step.
+ */
+/**
+ * Enforce the collection's field rules at PUBLISH (EC-168; moved off upsert in
+ * EC-225): publishing — not every draft write — is the validation gate, so the
+ * continuous draft may be saved while incomplete/invalid (the Sanity model) but
+ * a *published* version must satisfy required/min/max/pattern/options
+ * constraints. Rejection is a standard validation `OperationError` with per-field
+ * issues; the studio surfaces the same issues live. Scope (deliberate):
+ *
+ * - No saved schema → nothing to validate against; the write proceeds (matches
+ *   the persistence adapters, which only shape-check in that case).
+ * - Collection not declared in config → nothing to validate against; the write
+ *   proceeds (EC-183, AD-11). CMS collection schemas are config-owned and the
+ *   backend is a data store; studio **system** collections (routes/views/
+ *   sources) are not declared in config, and content documents are validated by
+ *   the studio against the session registry pre-dispatch. The operation enforces
+ *   field rules only for collections the config declares.
+ * - Only `error`-severity issues block. Without the studio's session context
+ *   there is no document store or locale config here, so relation/asset target
+ *   existence and per-locale completeness (warnings) stay UI/studio-validation
+ *   concerns — the operation rejects hard field-rule violations only.
+ * - **Composition validity is studio-enforced** (EC-225): this layer has no
+ *   component registry, so `blocks`/`richText` composition rules (the field
+ *   `allow` leash) are NOT checked here — only scalar field rules. Every publish
+ *   path runs the composition-aware studio `validate()` first (detail editor +
+ *   bulk publish), which is the invariant that keeps invalid compositions
+ *   unpublished.
+ */
+/**
+ * Self-type a document's fields through the schema-as-lens before it is persisted
+ * (EC-277). Document-level only — relation/asset/object — because the operations
+ * layer has no component registry (EC-225); a composition's static props are
+ * self-typed by the studio pre-dispatch (which holds the registry). Drift-tolerant:
+ * no saved schema or an undeclared collection returns the document unchanged.
+ */
+async function selfTypeForPersist(context, projectId, document) {
+    const schema = await context.adapter.cms.findSchema(projectId);
+    const collection = schema?.collections.find((c) => c.id === document.collection);
+    return collection ? selfTypeDocument(document, collection) : document;
+}
+async function assertFieldRules(context, projectId, document) {
+    const schema = await context.adapter.cms.findSchema(projectId);
+    if (!schema)
+        return;
+    const registry = createCollectionRegistry(schema.collections);
+    // Undeclared collection (system/stray) → no config field-rules to enforce here.
+    if (!registry.has(document.collection))
+        return;
+    const violations = validateDocument(registry, document).filter((issue) => issue.severity === 'error');
+    if (violations.length === 0)
+        return;
+    throw new OperationFailure(validationError(`Document “${document.collection}:${document.id}” violates its collection schema.`, violations.map((issue) => ({
+        code: issue.code,
+        message: issue.message,
+        path: [...issue.path],
+        domain: 'cms',
+    }))));
+}
+/** The owning field name of a reference-index path (`values/...`/`localized/...`). */
+function fieldNameOfReferencePath(path) {
+    const tokens = path.split('/');
+    if (tokens[0] === 'values')
+        return tokens[1];
+    if (tokens[0] === 'localized')
+        return tokens[2];
+    return undefined;
+}
+/** The strict relation field names per collection that target `targetCollection`. */
+function strictFieldsByCollection(collections, targetCollection) {
+    const byCollection = new Map();
+    for (const collection of collections) {
+        for (const field of collection.fields) {
+            if (field.type !== 'relation' || field.strict !== true)
+                continue;
+            if (field.target !== targetCollection)
+                continue;
+            let names = byCollection.get(collection.id);
+            if (!names) {
+                names = new Set();
+                byCollection.set(collection.id, names);
+            }
+            names.add(field.name);
+        }
+    }
+    return byCollection;
+}
+/**
+ * Enumerate the documents whose strict relation fields reference `ref`.
+ * Computed directly from the live documents (not the EC-155 index, which is
+ * maintained asynchronously) so enforcement can never act on a stale view.
+ * For `unpublish`, only *published* referrers block — a draft-only reference
+ * never serves the published site, so unpublishing stays allowed.
+ */
+async function collectStrictReferrers(context, projectId, ref, mode) {
+    const schema = await context.adapter.cms.findSchema(projectId);
+    if (!schema)
+        return [];
+    const strictFields = strictFieldsByCollection(schema.collections, ref.collection);
+    if (strictFields.size === 0)
+        return [];
+    const targetKey = documentKey(ref);
+    const referrers = [];
+    for (const record of await context.adapter.cms.listDocuments(projectId)) {
+        const doc = record.document;
+        if (doc.collection === ref.collection && doc.id === ref.id)
+            continue;
+        const fields = strictFields.get(doc.collection);
+        if (!fields)
+            continue;
+        // EC-224: "published" is the version pointer (`publishedVersion`). Unpublish
+        // is blocked only by referrers that actually serve the published site; the
+        // reported state reflects that effective publish status.
+        const referrerPublished = record.publishedVersion !== undefined;
+        if (mode === 'unpublish' && !referrerPublished)
+            continue;
+        // EC-277: the stored document self-describes, so extraction is schema-free.
+        for (const outbound of extractReferences(doc)) {
+            if (outbound.kind !== 'relation-field')
+                continue;
+            if (outbound.target.type !== 'document' || outbound.target.id !== targetKey)
+                continue;
+            const field = fieldNameOfReferencePath(outbound.path);
+            if (field === undefined || !fields.has(field))
+                continue;
+            referrers.push({
+                collection: doc.collection,
+                id: doc.id,
+                field,
+                path: outbound.path,
+                state: referrerPublished ? 'published' : 'draft',
+            });
+        }
+    }
+    return referrers;
+}
+/** Throw a structured conflict (never a raw error) when strict referrers block. */
+async function assertNoStrictReferrers(context, projectId, ref, mode) {
+    const referrers = await collectStrictReferrers(context, projectId, ref, mode);
+    if (referrers.length === 0)
+        return;
+    const targetKey = documentKey(ref);
+    const named = referrers
+        .slice(0, 3)
+        .map((r) => `“${r.collection}:${r.id}” (field “${r.field}”)`)
+        .join(', ');
+    const suffix = referrers.length > 3 ? `, and ${referrers.length - 3} more` : '';
+    throw new OperationFailure(strictReferenceConflictError(targetKey, `Cannot ${mode} “${targetKey}”: ${referrers.length} ${referrers.length === 1 ? 'document references' : 'documents reference'} it through strict relation fields — ${named}${suffix}. Remove these references first.`, referrers));
+}
+export const upsertDocumentInputSchema = z.object({
+    projectId: projectIdSchema,
+    document: documentSchema,
+});
+export const documentRefInputSchema = z.object({
+    projectId: projectIdSchema,
+    ref: documentRefSchema,
+});
+export const listDocumentsInputSchema = z.object({
+    projectId: projectIdSchema,
+    collection: z.string().min(1).optional(),
+});
+export const snapshotDocumentInputSchema = z.object({
+    projectId: projectIdSchema,
+    ref: documentRefSchema,
+    label: z.string().min(1).optional(),
+});
+export const restoreDocumentInputSchema = z.object({
+    projectId: projectIdSchema,
+    ref: documentRefSchema,
+    /** The recorded version to restore as the new working draft. */
+    version: z.number().int().positive(),
+});
+export const pinVersionInputSchema = z.object({
+    projectId: projectIdSchema,
+    ref: documentRefSchema,
+    /** The already-recorded version to pin live. */
+    version: z.number().int().positive(),
+});
+export const documentOperationDefinitions = {
+    upsert: defineCommand({
+        name: 'documents.upsert',
+        domain: 'documents',
+        description: 'Insert or update a CMS document (keyed by collection + id).',
+        input: upsertDocumentInputSchema,
+        execute: async (context, input) => {
+            // EC-277: self-type document fields through the schema-as-lens before persist —
+            // the spine every writer crosses, so relation/asset/object values self-describe
+            // at rest (composition static props need the registry, self-typed in the studio
+            // pre-dispatch). Drift-tolerant: no schema / undeclared collection → pass through.
+            const document = await selfTypeForPersist(context, input.projectId, input.document);
+            // EC-225: the draft store accepts in-progress (possibly invalid) drafts —
+            // field-rule validation is enforced at PUBLISH, not on every write, so
+            // autosave never rejects a half-finished edit. The input schema still
+            // shape-checks the document; the studio surfaces field issues live.
+            return context.adapter.cms.upsertDocument(input.projectId, document);
+        },
+    }),
+    delete: defineCommand({
+        name: 'documents.delete',
+        domain: 'documents',
+        description: 'Delete a CMS document (blocked while strict relation fields reference it).',
+        input: documentRefInputSchema,
+        execute: async (context, input) => {
+            await assertNoStrictReferrers(context, input.projectId, input.ref, 'delete');
+            await context.adapter.cms.deleteDocument(input.projectId, input.ref);
+            return { ref: input.ref };
+        },
+    }),
+    get: defineQuery({
+        name: 'documents.get',
+        domain: 'documents',
+        description: 'Load a CMS document by collection + id.',
+        input: documentRefInputSchema,
+        execute: (context, input) => context.adapter.cms.getDocument(input.projectId, input.ref),
+    }),
+    list: defineQuery({
+        name: 'documents.list',
+        domain: 'documents',
+        description: 'List CMS documents, optionally filtered to one collection.',
+        input: listDocumentsInputSchema,
+        execute: (context, input) => context.adapter.cms.listDocuments(input.projectId, input.collection),
+    }),
+    // --- Version history (EC-224) ----------------------------------------------
+    snapshot: defineCommand({
+        name: 'documents.snapshot',
+        domain: 'documents',
+        description: 'Record the current draft as a new version without publishing.',
+        input: snapshotDocumentInputSchema,
+        execute: async (context, input) => {
+            const current = await context.adapter.cms.getDocument(input.projectId, input.ref);
+            return context.adapter.cms.saveDocumentVersion(input.projectId, current.document, input.label ? { label: input.label } : {});
+        },
+    }),
+    listVersions: defineQuery({
+        name: 'documents.listVersions',
+        domain: 'documents',
+        description: 'List a document’s recorded versions, newest first.',
+        input: documentRefInputSchema,
+        execute: (context, input) => context.adapter.cms.listDocumentVersions(input.projectId, input.ref),
+    }),
+    restore: defineCommand({
+        name: 'documents.restore',
+        domain: 'documents',
+        description: 'Restore a recorded version as the new working draft (snapshots the current draft first so the rollback is itself undoable).',
+        input: restoreDocumentInputSchema,
+        execute: async (context, input) => {
+            // Fail fast if the target version is unknown (RecordNotFoundError → not-found).
+            const target = await context.adapter.cms.getDocumentVersion(input.projectId, input.ref, input.version);
+            // Snapshot the current draft first so the restore is itself undoable (EC-224).
+            const current = await context.adapter.cms.getDocument(input.projectId, input.ref);
+            await context.adapter.cms.saveDocumentVersion(input.projectId, current.document, {
+                label: 'pre-restore',
+            });
+            // Load the recorded snapshot as the new working draft (the live row is
+            // always the draft now — EC-224 — so no flag to set).
+            return context.adapter.cms.upsertDocument(input.projectId, target.snapshot);
+        },
+    }),
+    // --- Publish lifecycle over the version pointer (EC-224) --------------------
+    // The Sanity model: publish snapshots the current draft as a new version and
+    // pins it live; unpublish clears the pin (draft + history untouched). These
+    // replace `documents.setState` as the studio's publish path.
+    publish: defineCommand({
+        name: 'documents.publish',
+        domain: 'documents',
+        description: 'Publish a document: snapshot the current draft as a new version and pin it live.',
+        input: documentRefInputSchema,
+        execute: async (context, input) => {
+            const current = await context.adapter.cms.getDocument(input.projectId, input.ref);
+            // EC-225: publish is the validation gate — a published version must satisfy
+            // the collection's field rules even though the draft may be saved invalid.
+            await assertFieldRules(context, input.projectId, current.document);
+            // Record the current draft verbatim as the published version and pin it.
+            // The published perspective serves this recorded snapshot through the
+            // version pointer (`DocumentHistory.published`) — independent of any flat
+            // `state` flag — so the A1a `state:'published'` stamp is gone (EC-224 B-1):
+            // every published reader (the host wrap, the in-Convex kit, the Next
+            // adapter) now resolves a pinned row identically, by the pointer.
+            const version = await context.adapter.cms.saveDocumentVersion(input.projectId, current.document, { label: 'published' });
+            return context.adapter.cms.publishDocumentVersion(input.projectId, input.ref, version.version);
+        },
+    }),
+    unpublish: defineCommand({
+        name: 'documents.unpublish',
+        domain: 'documents',
+        description: 'Unpublish a document: clear the live version pin (blocked while strict relation fields published-reference it).',
+        input: documentRefInputSchema,
+        execute: async (context, input) => {
+            const existing = await context.adapter.cms.findDocument(input.projectId, input.ref);
+            if (existing === undefined) {
+                // No record — let the persister raise the canonical not-found.
+                return context.adapter.cms.unpublishDocument(input.projectId, input.ref);
+            }
+            // EC-224: published-ness is the version pointer, full stop. A document is
+            // published iff its pin is set.
+            if (existing.publishedVersion === undefined) {
+                // Already unpublished (no pin): an idempotent no-op.
+                return existing;
+            }
+            // Unpublish (EC-173): blocked only while *published* documents hold strict
+            // references to this one. Clearing the pin is the whole operation — the
+            // live row is already the working draft (no flag to reset).
+            await assertNoStrictReferrers(context, input.projectId, input.ref, 'unpublish');
+            return context.adapter.cms.unpublishDocument(input.projectId, input.ref);
+        },
+    }),
+    pinVersion: defineCommand({
+        name: 'documents.pinVersion',
+        domain: 'documents',
+        description: 'Pin an EXISTING recorded version live without re-snapshotting (EC-224). The exact pointer inverse of unpublish/republish — the primitive changeset revert uses to restore a prior pin without a flat `state` flag.',
+        input: pinVersionInputSchema,
+        execute: async (context, input) => {
+            // Publishing (here, re-pinning) is never blocked — only unpublish is
+            // (EC-173). `publishDocumentVersion` validates the version exists
+            // (RecordNotFoundError → not-found), so a stale pin target fails cleanly.
+            return context.adapter.cms.publishDocumentVersion(input.projectId, input.ref, input.version);
+        },
+    }),
+};
+export function createDocumentOperations(runtime) {
+    return {
+        upsert: bindOperation(runtime, documentOperationDefinitions.upsert),
+        delete: bindOperation(runtime, documentOperationDefinitions.delete),
+        get: bindOperation(runtime, documentOperationDefinitions.get),
+        list: bindOperation(runtime, documentOperationDefinitions.list),
+        snapshot: bindOperation(runtime, documentOperationDefinitions.snapshot),
+        listVersions: bindOperation(runtime, documentOperationDefinitions.listVersions),
+        restore: bindOperation(runtime, documentOperationDefinitions.restore),
+        publish: bindOperation(runtime, documentOperationDefinitions.publish),
+        unpublish: bindOperation(runtime, documentOperationDefinitions.unpublish),
+        pinVersion: bindOperation(runtime, documentOperationDefinitions.pinVersion),
+    };
+}
+//# sourceMappingURL=documents.js.map

package/dist/operations/documents.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"documents.js","sourceRoot":"","sources":["../../src/operations/documents.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AACvB,OAAO,EACL,wBAAwB,EACxB,WAAW,EACX,iBAAiB,EACjB,cAAc,EACd,gBAAgB,EAChB,gBAAgB,GACjB,MAAM,0BAA0B,CAAA;AAEjC,OAAO,EAAE,iBAAiB,EAAE,MAAM,6BAA6B,CAAA;AAC/D,OAAO,EACL,gBAAgB,EAChB,aAAa,EACb,aAAa,EACb,WAAW,EACX,4BAA4B,EAC5B,eAAe,GAChB,MAAM,QAAQ,CAAA;AACf,OAAO,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAA;AAG7D;;;;;;GAMG;AAEH;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH;;;;;;GAMG;AACH,KAAK,UAAU,kBAAkB,CAC/B,OAAyB,EACzB,SAAiB,EACjB,QAAqB;IAErB,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,UAAU,CAAC,SAAS,CAAC,CAAA;IAC9D,MAAM,UAAU,GAAG,MAAM,EAAE,WAAW,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,QAAQ,CAAC,UAAU,CAAC,CAAA;IAChF,OAAO,UAAU,CAAC,CAAC,CAAC,gBAAgB,CAAC,QAAQ,EAAE,UAAU,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAA;AACvE,CAAC;AAED,KAAK,UAAU,gBAAgB,CAC7B,OAAyB,EACzB,SAAiB,EACjB,QAAqB;IAErB,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,UAAU,CAAC,SAAS,CAAC,CAAA;IAC9D,IAAI,CAAC,MAAM;QAAE,OAAM;IACnB,MAAM,QAAQ,GAAG,wBAAwB,CAAC,MAAM,CAAC,WAAW,CAAC,CAAA;IAC7D,gFAAgF;IAChF,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,QAAQ,CAAC,UAAU,CAAC;QAAE,OAAM;IAC9C,MAAM,UAAU,GAAG,gBAAgB,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC,MAAM,CAC5D,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,QAAQ,KAAK,OAAO,CACtC,CAAA;IACD,IAAI,UAAU,CAAC,MAAM,KAAK,CAAC;QAAE,OAAM;IACnC,MAAM,IAAI,gBAAgB,CACxB,eAAe,CACb,aAAa,QAAQ,CAAC,UAAU,IAAI,QAAQ,CAAC,EAAE,mCAAmC,EAClF,UAAU,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;QACzB,IAAI,EAAE,KAAK,CAAC,IAAI;QAChB,OAAO,EAAE,KAAK,CAAC,OAAO;QACtB,IAAI,EAAE,CAAC,GAAG,KAAK,CAAC,IAAI,CAAC;QACrB,MAAM,EAAE,KAAK;KACd,CAAC,CAAC,CACJ,CACF,CAAA;AACH,CAAC;AAeD,sFAAsF;AACtF,SAAS,wBAAwB,CAAC,IAAY;IAC5C,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAA;IAC9B,IAAI,MAAM,CAAC,CAAC,CAAC,KAAK,QAAQ;QAAE,OAAO,MAAM,CAAC,CAAC,CAAC,CAAA;IAC5C,IAAI,MAAM,CAAC,CAAC,CAAC,KAAK,WAAW;QAAE,OAAO,MAAM,CAAC,CAAC,CAAC,CAAA;IAC/C,OAAO,SAAS,CAAA;AAClB,CAAC;AAED,qFAAqF;AACrF,SAAS,wBAAwB,CAC/B,WAAqC,EACrC,gBAAwB;IAExB,MAAM,YAAY,GAAG,IAAI,GAAG,EAAuB,CAAA;IACnD,KAAK,MAAM,UAAU,IAAI,WAAW,EAAE,CAAC;QACrC,KAAK,MAAM,KAAK,IAAI,UAAU,CAAC,MAAM,EAAE,CAAC;YACtC,IAAI,KAAK,CAAC,IAAI,KAAK,UAAU,IAAI,KAAK,CAAC,MAAM,KAAK,IAAI;gBAAE,SAAQ;YAChE,IAAI,KAAK,CAAC,MAAM,KAAK,gBAAgB;gBAAE,SAAQ;YAC/C,IAAI,KAAK,GAAG,YAAY,CAAC,GAAG,CAAC,UAAU,CAAC,EAAE,CAAC,CAAA;YAC3C,IAAI,CAAC,KAAK,EAAE,CAAC;gBACX,KAAK,GAAG,IAAI,GAAG,EAAE,CAAA;gBACjB,YAAY,CAAC,GAAG,CAAC,UAAU,CAAC,EAAE,EAAE,KAAK,CAAC,CAAA;YACxC,CAAC;YACD,KAAK,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,CAAA;QACvB,CAAC;IACH,CAAC;IACD,OAAO,YAAY,CAAA;AACrB,CAAC;AAED;;;;;;GAMG;AACH,KAAK,UAAU,sBAAsB,CACnC,OAAyB,EACzB,SAAiB,EACjB,GAAgB,EAChB,IAAmB;IAEnB,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,UAAU,CAAC,SAAS,CAAC,CAAA;IAC9D,IAAI,CAAC,MAAM;QAAE,OAAO,EAAE,CAAA;IACtB,MAAM,YAAY,GAAG,wBAAwB,CAAC,MAAM,CAAC,WAAW,EAAE,GAAG,CAAC,UAAU,CAAC,CAAA;IACjF,IAAI,YAAY,CAAC,IAAI,KAAK,CAAC;QAAE,OAAO,EAAE,CAAA;IAEtC,MAAM,SAAS,GAAG,WAAW,CAAC,GAAG,CAAC,CAAA;IAClC,MAAM,SAAS,GAAuB,EAAE,CAAA;IACxC,KAAK,MAAM,MAAM,IAAI,MAAM,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,aAAa,CAAC,SAAS,CAAC,EAAE,CAAC;QACxE,MAAM,GAAG,GAAG,MAAM,CAAC,QAAQ,CAAA;QAC3B,IAAI,GAAG,CAAC,UAAU,KAAK,GAAG,CAAC,UAAU,IAAI,GAAG,CAAC,EAAE,KAAK,GAAG,CAAC,EAAE;YAAE,SAAQ;QACpE,MAAM,MAAM,GAAG,YAAY,CAAC,GAAG,CAAC,GAAG,CAAC,UAAU,CAAC,CAAA;QAC/C,IAAI,CAAC,MAAM;YAAE,SAAQ;QACrB,6EAA6E;QAC7E,2EAA2E;QAC3E,yDAAyD;QACzD,MAAM,iBAAiB,GAAG,MAAM,CAAC,gBAAgB,KAAK,SAAS,CAAA;QAC/D,IAAI,IAAI,KAAK,WAAW,IAAI,CAAC,iBAAiB;YAAE,SAAQ;QACxD,4EAA4E;QAC5E,KAAK,MAAM,QAAQ,IAAI,iBAAiB,CAAC,GAAG,CAAC,EAAE,CAAC;YAC9C,IAAI,QAAQ,CAAC,IAAI,KAAK,gBAAgB;gBAAE,SAAQ;YAChD,IAAI,QAAQ,CAAC,MAAM,CAAC,IAAI,KAAK,UAAU,IAAI,QAAQ,CAAC,MAAM,CAAC,EAAE,KAAK,SAAS;gBAAE,SAAQ;YACrF,MAAM,KAAK,GAAG,wBAAwB,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAA;YACrD,IAAI,KAAK,KAAK,SAAS,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC;gBAAE,SAAQ;YACvD,SAAS,CAAC,IAAI,CAAC;gBACb,UAAU,EAAE,GAAG,CAAC,UAAU;gBAC1B,EAAE,EAAE,GAAG,CAAC,EAAE;gBACV,KAAK;gBACL,IAAI,EAAE,QAAQ,CAAC,IAAI;gBACnB,KAAK,EAAE,iBAAiB,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,OAAO;aACjD,CAAC,CAAA;QACJ,CAAC;IACH,CAAC;IACD,OAAO,SAAS,CAAA;AAClB,CAAC;AAED,mFAAmF;AACnF,KAAK,UAAU,uBAAuB,CACpC,OAAyB,EACzB,SAAiB,EACjB,GAAgB,EAChB,IAAmB;IAEnB,MAAM,SAAS,GAAG,MAAM,sBAAsB,CAAC,OAAO,EAAE,SAAS,EAAE,GAAG,EAAE,IAAI,CAAC,CAAA;IAC7E,IAAI,SAAS,CAAC,MAAM,KAAK,CAAC;QAAE,OAAM;IAClC,MAAM,SAAS,GAAG,WAAW,CAAC,GAAG,CAAC,CAAA;IAClC,MAAM,KAAK,GAAG,SAAS;SACpB,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC;SACX,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,CAAC,UAAU,IAAI,CAAC,CAAC,EAAE,aAAa,CAAC,CAAC,KAAK,IAAI,CAAC;SAC5D,IAAI,CAAC,IAAI,CAAC,CAAA;IACb,MAAM,MAAM,GAAG,SAAS,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,SAAS,CAAC,MAAM,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAA;IAC/E,MAAM,IAAI,gBAAgB,CACxB,4BAA4B,CAC1B,SAAS,EACT,UAAU,IAAI,KAAK,SAAS,MAAM,SAAS,CAAC,MAAM,IAChD,SAAS,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,qBAAqB,CAAC,CAAC,CAAC,qBACnD,wCAAwC,KAAK,GAAG,MAAM,kCAAkC,EACxF,SAAS,CACV,CACF,CAAA;AACH,CAAC;AAED,MAAM,CAAC,MAAM,yBAAyB,GAAG,CAAC,CAAC,MAAM,CAAC;IAChD,SAAS,EAAE,eAAe;IAC1B,QAAQ,EAAE,cAAc;CACzB,CAAC,CAAA;AAEF,MAAM,CAAC,MAAM,sBAAsB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC7C,SAAS,EAAE,eAAe;IAC1B,GAAG,EAAE,iBAAiB;CACvB,CAAC,CAAA;AAEF,MAAM,CAAC,MAAM,wBAAwB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC/C,SAAS,EAAE,eAAe;IAC1B,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE;CACzC,CAAC,CAAA;AAEF,MAAM,CAAC,MAAM,2BAA2B,GAAG,CAAC,CAAC,MAAM,CAAC;IAClD,SAAS,EAAE,eAAe;IAC1B,GAAG,EAAE,iBAAiB;IACtB,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE;CACpC,CAAC,CAAA;AAEF,MAAM,CAAC,MAAM,0BAA0B,GAAG,CAAC,CAAC,MAAM,CAAC;IACjD,SAAS,EAAE,eAAe;IAC1B,GAAG,EAAE,iBAAiB;IACtB,gEAAgE;IAChE,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE;CACrC,CAAC,CAAA;AAEF,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC5C,SAAS,EAAE,eAAe;IAC1B,GAAG,EAAE,iBAAiB;IACtB,gDAAgD;IAChD,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE;CACrC,CAAC,CAAA;AAEF,MAAM,CAAC,MAAM,4BAA4B,GAAG;IAC1C,MAAM,EAAE,aAAa,CAAC;QACpB,IAAI,EAAE,kBAAkB;QACxB,MAAM,EAAE,WAAW;QACnB,WAAW,EAAE,6DAA6D;QAC1E,KAAK,EAAE,yBAAyB;QAChC,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,EAAE;YAChC,gFAAgF;YAChF,gFAAgF;YAChF,gFAAgF;YAChF,mFAAmF;YACnF,MAAM,QAAQ,GAAG,MAAM,kBAAkB,CAAC,OAAO,EAAE,KAAK,CAAC,SAAS,EAAE,KAAK,CAAC,QAAQ,CAAC,CAAA;YACnF,0EAA0E;YAC1E,uEAAuE;YACvE,sEAAsE;YACtE,oEAAoE;YACpE,OAAO,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC,KAAK,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAA;QACtE,CAAC;KACF,CAAC;IACF,MAAM,EAAE,aAAa,CAAC;QACpB,IAAI,EAAE,kBAAkB;QACxB,MAAM,EAAE,WAAW;QACnB,WAAW,EAAE,4EAA4E;QACzF,KAAK,EAAE,sBAAsB;QAC7B,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,EAAE;YAChC,MAAM,uBAAuB,CAAC,OAAO,EAAE,KAAK,CAAC,SAAS,EAAE,KAAK,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAA;YAC5E,MAAM,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC,KAAK,CAAC,SAAS,EAAE,KAAK,CAAC,GAAG,CAAC,CAAA;YACpE,OAAO,EAAE,GAAG,EAAE,KAAK,CAAC,GAAG,EAAE,CAAA;QAC3B,CAAC;KACF,CAAC;IACF,GAAG,EAAE,WAAW,CAAC;QACf,IAAI,EAAE,eAAe;QACrB,MAAM,EAAE,WAAW;QACnB,WAAW,EAAE,yCAAyC;QACtD,KAAK,EAAE,sBAAsB;QAC7B,OAAO,EAAE,CAAC,OAAO,EAAE,KAAK,EAAE,EAAE,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,WAAW,CAAC,KAAK,CAAC,SAAS,EAAE,KAAK,CAAC,GAAG,CAAC;KACzF,CAAC;IACF,IAAI,EAAE,WAAW,CAAC;QAChB,IAAI,EAAE,gBAAgB;QACtB,MAAM,EAAE,WAAW;QACnB,WAAW,EAAE,4DAA4D;QACzE,KAAK,EAAE,wBAAwB;QAC/B,OAAO,EAAE,CAAC,OAAO,EAAE,KAAK,EAAE,EAAE,CAC1B,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,aAAa,CAAC,KAAK,CAAC,SAAS,EAAE,KAAK,CAAC,UAAU,CAAC;KACvE,CAAC;IACF,8EAA8E;IAC9E,QAAQ,EAAE,aAAa,CAAC;QACtB,IAAI,EAAE,oBAAoB;QAC1B,MAAM,EAAE,WAAW;QACnB,WAAW,EAAE,+DAA+D;QAC5E,KAAK,EAAE,2BAA2B;QAClC,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,EAAE;YAChC,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,WAAW,CAAC,KAAK,CAAC,SAAS,EAAE,KAAK,CAAC,GAAG,CAAC,CAAA;YACjF,OAAO,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,mBAAmB,CAC5C,KAAK,CAAC,SAAS,EACf,OAAO,CAAC,QAAQ,EAChB,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAC1C,CAAA;QACH,CAAC;KACF,CAAC;IACF,YAAY,EAAE,WAAW,CAAC;QACxB,IAAI,EAAE,wBAAwB;QAC9B,MAAM,EAAE,WAAW;QACnB,WAAW,EAAE,oDAAoD;QACjE,KAAK,EAAE,sBAAsB;QAC7B,OAAO,EAAE,CAAC,OAAO,EAAE,KAAK,EAAE,EAAE,CAC1B,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,oBAAoB,CAAC,KAAK,CAAC,SAAS,EAAE,KAAK,CAAC,GAAG,CAAC;KACvE,CAAC;IACF,OAAO,EAAE,aAAa,CAAC;QACrB,IAAI,EAAE,mBAAmB;QACzB,MAAM,EAAE,WAAW;QACnB,WAAW,EACT,6HAA6H;QAC/H,KAAK,EAAE,0BAA0B;QACjC,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,EAAE;YAChC,gFAAgF;YAChF,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,kBAAkB,CACzD,KAAK,CAAC,SAAS,EACf,KAAK,CAAC,GAAG,EACT,KAAK,CAAC,OAAO,CACd,CAAA;YACD,+EAA+E;YAC/E,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,WAAW,CAAC,KAAK,CAAC,SAAS,EAAE,KAAK,CAAC,GAAG,CAAC,CAAA;YACjF,MAAM,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,mBAAmB,CAAC,KAAK,CAAC,SAAS,EAAE,OAAO,CAAC,QAAQ,EAAE;gBAC/E,KAAK,EAAE,aAAa;aACrB,CAAC,CAAA;YACF,uEAAuE;YACvE,sDAAsD;YACtD,OAAO,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC,KAAK,CAAC,SAAS,EAAE,MAAM,CAAC,QAAQ,CAAC,CAAA;QAC7E,CAAC;KACF,CAAC;IACF,+EAA+E;IAC/E,6EAA6E;IAC7E,4EAA4E;IAC5E,6DAA6D;IAC7D,OAAO,EAAE,aAAa,CAAC;QACrB,IAAI,EAAE,mBAAmB;QACzB,MAAM,EAAE,WAAW;QACnB,WAAW,EAAE,kFAAkF;QAC/F,KAAK,EAAE,sBAAsB;QAC7B,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,EAAE;YAChC,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,WAAW,CAAC,KAAK,CAAC,SAAS,EAAE,KAAK,CAAC,GAAG,CAAC,CAAA;YACjF,4EAA4E;YAC5E,2EAA2E;YAC3E,MAAM,gBAAgB,CAAC,OAAO,EAAE,KAAK,CAAC,SAAS,EAAE,OAAO,CAAC,QAAQ,CAAC,CAAA;YAClE,yEAAyE;YACzE,sEAAsE;YACtE,0EAA0E;YAC1E,4EAA4E;YAC5E,qEAAqE;YACrE,kEAAkE;YAClE,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,mBAAmB,CAC3D,KAAK,CAAC,SAAS,EACf,OAAO,CAAC,QAAQ,EAChB,EAAE,KAAK,EAAE,WAAW,EAAE,CACvB,CAAA;YACD,OAAO,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,sBAAsB,CAAC,KAAK,CAAC,SAAS,EAAE,KAAK,CAAC,GAAG,EAAE,OAAO,CAAC,OAAO,CAAC,CAAA;QAChG,CAAC;KACF,CAAC;IACF,SAAS,EAAE,aAAa,CAAC;QACvB,IAAI,EAAE,qBAAqB;QAC3B,MAAM,EAAE,WAAW;QACnB,WAAW,EACT,iHAAiH;QACnH,KAAK,EAAE,sBAAsB;QAC7B,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,EAAE;YAChC,MAAM,QAAQ,GAAG,MAAM,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,YAAY,CAAC,KAAK,CAAC,SAAS,EAAE,KAAK,CAAC,GAAG,CAAC,CAAA;YACnF,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;gBAC3B,+DAA+D;gBAC/D,OAAO,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,iBAAiB,CAAC,KAAK,CAAC,SAAS,EAAE,KAAK,CAAC,GAAG,CAAC,CAAA;YAC1E,CAAC;YACD,0EAA0E;YAC1E,gCAAgC;YAChC,IAAI,QAAQ,CAAC,gBAAgB,KAAK,SAAS,EAAE,CAAC;gBAC5C,qDAAqD;gBACrD,OAAO,QAAQ,CAAA;YACjB,CAAC;YACD,2EAA2E;YAC3E,wEAAwE;YACxE,4DAA4D;YAC5D,MAAM,uBAAuB,CAAC,OAAO,EAAE,KAAK,CAAC,SAAS,EAAE,KAAK,CAAC,GAAG,EAAE,WAAW,CAAC,CAAA;YAC/E,OAAO,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,iBAAiB,CAAC,KAAK,CAAC,SAAS,EAAE,KAAK,CAAC,GAAG,CAAC,CAAA;QAC1E,CAAC;KACF,CAAC;IACF,UAAU,EAAE,aAAa,CAAC;QACxB,IAAI,EAAE,sBAAsB;QAC5B,MAAM,EAAE,WAAW;QACnB,WAAW,EACT,oNAAoN;QACtN,KAAK,EAAE,qBAAqB;QAC5B,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,EAAE;YAChC,qEAAqE;YACrE,kEAAkE;YAClE,0EAA0E;YAC1E,OAAO,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,sBAAsB,CAAC,KAAK,CAAC,SAAS,EAAE,KAAK,CAAC,GAAG,EAAE,KAAK,CAAC,OAAO,CAAC,CAAA;QAC9F,CAAC;KACF,CAAC;CACM,CAAA;AAEV,MAAM,UAAU,wBAAwB,CAAC,OAA0B;IACjE,OAAO;QACL,MAAM,EAAE,aAAa,CAAC,OAAO,EAAE,4BAA4B,CAAC,MAAM,CAAC;QACnE,MAAM,EAAE,aAAa,CAAC,OAAO,EAAE,4BAA4B,CAAC,MAAM,CAAC;QACnE,GAAG,EAAE,aAAa,CAAC,OAAO,EAAE,4BAA4B,CAAC,GAAG,CAAC;QAC7D,IAAI,EAAE,aAAa,CAAC,OAAO,EAAE,4BAA4B,CAAC,IAAI,CAAC;QAC/D,QAAQ,EAAE,aAAa,CAAC,OAAO,EAAE,4BAA4B,CAAC,QAAQ,CAAC;QACvE,YAAY,EAAE,aAAa,CAAC,OAAO,EAAE,4BAA4B,CAAC,YAAY,CAAC;QAC/E,OAAO,EAAE,aAAa,CAAC,OAAO,EAAE,4BAA4B,CAAC,OAAO,CAAC;QACrE,OAAO,EAAE,aAAa,CAAC,OAAO,EAAE,4BAA4B,CAAC,OAAO,CAAC;QACrE,SAAS,EAAE,aAAa,CAAC,OAAO,EAAE,4BAA4B,CAAC,SAAS,CAAC;QACzE,UAAU,EAAE,aAAa,CAAC,OAAO,EAAE,4BAA4B,CAAC,UAAU,CAAC;KAC5E,CAAA;AACH,CAAC"}

package/dist/operations/graph.d.ts

@@ -0,0 +1,138 @@
+import { z } from 'zod';
+import type { OperationsRuntime } from './core';
+/**
+ * Graph operations (EC-139, reshaped by EC-187). The project graph is now
+ * LAYOUTS-ONLY: pages moved into the `page` collection (their `body` is a
+ * composition field value persisted as document data through the CMS document
+ * commands). So the node-level page-graph commands (insert/remove/duplicate/
+ * move/reorder/prop/condition) are RETIRED — layout edits go through the coarse
+ * `graph.save` path (layouts change rarely), and page-body edits go through the
+ * CMS document save (the composition field editor lifts its value into the
+ * document draft).
+ *
+ * `graph.save` persists a whole working graph as a new revision, running the
+ * pure container normalizer first so the persisted timeline never contains
+ * empty or single-child layout containers (EC-161).
+ */
+export declare const saveGraphInputSchema: z.ZodObject<{
+    projectId: z.ZodString;
+    graph: z.ZodObject<{
+        id: z.ZodString;
+        schemaVersion: z.ZodNumber;
+        metadata: z.ZodOptional<z.ZodObject<{
+            name: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>;
+        settingsRef: z.ZodOptional<z.ZodString>;
+        layouts: z.ZodDefault<z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            name: z.ZodString;
+            root: z.ZodType<import("@elytracms/core/project-graph").ComponentNode, unknown, z.core.$ZodTypeInternals<import("@elytracms/core/project-graph").ComponentNode, unknown>>;
+        }, z.core.$strip>>>;
+    }, z.core.$strip>;
+    label: z.ZodOptional<z.ZodString>;
+    message: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export declare const getGraphInputSchema: z.ZodObject<{
+    projectId: z.ZodString;
+}, z.core.$strip>;
+export declare const getRevisionInputSchema: z.ZodObject<{
+    projectId: z.ZodString;
+    revision: z.ZodNumber;
+}, z.core.$strip>;
+export declare const graphOperationDefinitions: {
+    readonly save: import("./core").OperationDefinition<z.ZodObject<{
+        projectId: z.ZodString;
+        graph: z.ZodObject<{
+            id: z.ZodString;
+            schemaVersion: z.ZodNumber;
+            metadata: z.ZodOptional<z.ZodObject<{
+                name: z.ZodOptional<z.ZodString>;
+            }, z.core.$strip>>;
+            settingsRef: z.ZodOptional<z.ZodString>;
+            layouts: z.ZodDefault<z.ZodArray<z.ZodObject<{
+                id: z.ZodString;
+                name: z.ZodString;
+                root: z.ZodType<import("@elytracms/core/project-graph").ComponentNode, unknown, z.core.$ZodTypeInternals<import("@elytracms/core/project-graph").ComponentNode, unknown>>;
+            }, z.core.$strip>>>;
+        }, z.core.$strip>;
+        label: z.ZodOptional<z.ZodString>;
+        message: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>, {
+        id: string;
+        projectId: string;
+        revision: number;
+        serializedGraph: string;
+        schemaVersion: number;
+        createdAt: string;
+        label?: string | undefined;
+        message?: string | undefined;
+    }>;
+    readonly getLatest: import("./core").OperationDefinition<z.ZodObject<{
+        projectId: z.ZodString;
+    }, z.core.$strip>, import("../persistence").LoadedGraph>;
+    readonly getRevision: import("./core").OperationDefinition<z.ZodObject<{
+        projectId: z.ZodString;
+        revision: z.ZodNumber;
+    }, z.core.$strip>, import("../persistence").LoadedGraph>;
+    readonly listRevisions: import("./core").OperationDefinition<z.ZodObject<{
+        projectId: z.ZodString;
+    }, z.core.$strip>, {
+        id: string;
+        projectId: string;
+        revision: number;
+        serializedGraph: string;
+        schemaVersion: number;
+        createdAt: string;
+        label?: string | undefined;
+        message?: string | undefined;
+    }[]>;
+};
+export declare function createGraphOperations(runtime: OperationsRuntime): {
+    save: (input: {
+        projectId: string;
+        graph: {
+            id: string;
+            schemaVersion: number;
+            metadata?: {
+                name?: string | undefined;
+            } | undefined;
+            settingsRef?: string | undefined;
+            layouts?: {
+                id: string;
+                name: string;
+                root: unknown;
+            }[] | undefined;
+        };
+        label?: string | undefined;
+        message?: string | undefined;
+    }) => Promise<import("./core").OperationResult<{
+        id: string;
+        projectId: string;
+        revision: number;
+        serializedGraph: string;
+        schemaVersion: number;
+        createdAt: string;
+        label?: string | undefined;
+        message?: string | undefined;
+    }>>;
+    getLatest: (input: {
+        projectId: string;
+    }) => Promise<import("./core").OperationResult<import("../persistence").LoadedGraph>>;
+    getRevision: (input: {
+        projectId: string;
+        revision: number;
+    }) => Promise<import("./core").OperationResult<import("../persistence").LoadedGraph>>;
+    listRevisions: (input: {
+        projectId: string;
+    }) => Promise<import("./core").OperationResult<{
+        id: string;
+        projectId: string;
+        revision: number;
+        serializedGraph: string;
+        schemaVersion: number;
+        createdAt: string;
+        label?: string | undefined;
+        message?: string | undefined;
+    }[]>>;
+};
+export type GraphOperations = ReturnType<typeof createGraphOperations>;

package/dist/operations/graph.js

@@ -0,0 +1,78 @@
+import { z } from 'zod';
+import { normalizeProjectGraph, projectGraphSchema } from '@elytracms/core/project-graph';
+import { projectIdSchema } from '@elytracms/core/studio-core';
+import { bindOperation, defineCommand, defineQuery } from './core';
+/**
+ * Graph operations (EC-139, reshaped by EC-187). The project graph is now
+ * LAYOUTS-ONLY: pages moved into the `page` collection (their `body` is a
+ * composition field value persisted as document data through the CMS document
+ * commands). So the node-level page-graph commands (insert/remove/duplicate/
+ * move/reorder/prop/condition) are RETIRED — layout edits go through the coarse
+ * `graph.save` path (layouts change rarely), and page-body edits go through the
+ * CMS document save (the composition field editor lifts its value into the
+ * document draft).
+ *
+ * `graph.save` persists a whole working graph as a new revision, running the
+ * pure container normalizer first so the persisted timeline never contains
+ * empty or single-child layout containers (EC-161).
+ */
+export const saveGraphInputSchema = z.object({
+    projectId: projectIdSchema,
+    graph: projectGraphSchema,
+    label: z.string().min(1).optional(),
+    message: z.string().min(1).optional(),
+});
+export const getGraphInputSchema = z.object({
+    projectId: projectIdSchema,
+});
+export const getRevisionInputSchema = z.object({
+    projectId: projectIdSchema,
+    revision: z.number().int().positive(),
+});
+// --- definitions ----------------------------------------------------------------
+export const graphOperationDefinitions = {
+    save: defineCommand({
+        name: 'graph.save',
+        domain: 'graph',
+        description: 'Persist a full project graph (layouts-only) as a new revision.',
+        input: saveGraphInputSchema,
+        summarize: (input) => `{"projectId":"${input.projectId}","graphId":"${input.graph.id}","layouts":${input.graph.layouts.length}}`,
+        execute: (context, input) => 
+        // Full saves normalize too — the persisted timeline never contains
+        // empty or single-child layout containers (EC-161).
+        context.adapter.graphs.saveGraph(input.projectId, normalizeProjectGraph(input.graph), {
+            ...(input.label !== undefined ? { label: input.label } : {}),
+            ...(input.message !== undefined ? { message: input.message } : {}),
+        }),
+    }),
+    getLatest: defineQuery({
+        name: 'graph.getLatest',
+        domain: 'graph',
+        description: 'Load the latest graph revision (parsed graph + revision record).',
+        input: getGraphInputSchema,
+        execute: (context, input) => context.adapter.graphs.getLatest(input.projectId),
+    }),
+    getRevision: defineQuery({
+        name: 'graph.getRevision',
+        domain: 'graph',
+        description: 'Load a specific graph revision.',
+        input: getRevisionInputSchema,
+        execute: (context, input) => context.adapter.graphs.getRevision(input.projectId, input.revision),
+    }),
+    listRevisions: defineQuery({
+        name: 'graph.listRevisions',
+        domain: 'graph',
+        description: 'List all graph revisions for a project, newest first.',
+        input: getGraphInputSchema,
+        execute: (context, input) => context.adapter.graphs.listRevisions(input.projectId),
+    }),
+};
+export function createGraphOperations(runtime) {
+    return {
+        save: bindOperation(runtime, graphOperationDefinitions.save),
+        getLatest: bindOperation(runtime, graphOperationDefinitions.getLatest),
+        getRevision: bindOperation(runtime, graphOperationDefinitions.getRevision),
+        listRevisions: bindOperation(runtime, graphOperationDefinitions.listRevisions),
+    };
+}
+//# sourceMappingURL=graph.js.map

package/dist/operations/graph.js.map

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

package/dist/operations/index.d.ts

@@ -0,0 +1,19 @@
+/**
+ * `@elytracms/core/operations` — the typed command/query spine of the app (EC-139,
+ * vision AD-7). Every domain mutation flows through one pipeline:
+ * validate (Zod) → authorize (hook) → mutate via `PersistenceAdapter` → emit
+ * lifecycle event. Pure TypeScript: no React, no TanStack, no Convex.
+ */
+export declare const PACKAGE = "@elytracms/core/operations";
+export * from './core';
+export * from './schema';
+export * from './documents';
+export * from './graph';
+export * from './assets';
+export * from './publishing';
+export * from './references';
+export * from './members';
+export * from './tokens';
+export * from './authorization';
+export * from './client';
+export * from './changesets';

package/dist/operations/index.js

@@ -0,0 +1,20 @@
+/**
+ * `@elytracms/core/operations` — the typed command/query spine of the app (EC-139,
+ * vision AD-7). Every domain mutation flows through one pipeline:
+ * validate (Zod) → authorize (hook) → mutate via `PersistenceAdapter` → emit
+ * lifecycle event. Pure TypeScript: no React, no TanStack, no Convex.
+ */
+export const PACKAGE = '@elytracms/core/operations';
+export * from './core';
+export * from './schema';
+export * from './documents';
+export * from './graph';
+export * from './assets';
+export * from './publishing';
+export * from './references';
+export * from './members';
+export * from './tokens';
+export * from './authorization';
+export * from './client';
+export * from './changesets';
+//# sourceMappingURL=index.js.map

package/dist/operations/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/operations/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,MAAM,CAAC,MAAM,OAAO,GAAG,4BAA4B,CAAA;AAEnD,cAAc,QAAQ,CAAA;AACtB,cAAc,UAAU,CAAA;AACxB,cAAc,aAAa,CAAA;AAC3B,cAAc,SAAS,CAAA;AACvB,cAAc,UAAU,CAAA;AACxB,cAAc,cAAc,CAAA;AAC5B,cAAc,cAAc,CAAA;AAC5B,cAAc,WAAW,CAAA;AACzB,cAAc,UAAU,CAAA;AACxB,cAAc,iBAAiB,CAAA;AAC/B,cAAc,UAAU,CAAA;AACxB,cAAc,cAAc,CAAA"}