@sanity/sdk 3.0.0-rc.0 → 3.0.0-rc.1

package/src/document/processActions.test.ts

@@ -1,10 +1,10 @@
-import {type Reference, type SanityDocument} from '@sanity/types'
+import {type CreateMutation, type Reference, type SanityDocument} from '@sanity/types'
 import {parse} from 'groq-js'
 import {describe, expect, it} from 'vitest'
 
-import {type DocumentAction} from './actions'
-import {ActionError, processActions} from './processActions'
-import {type DocumentSet} from './processMutations'
+import {type Action, type DocumentAction} from './actions'
+import {ActionError, processActions} from './processActions/processActions'
+import {type DocumentSet, processMutations} from './processMutations'
 
 // Helper: Create a sample document that conforms to SanityDocument.
 const createDoc = (id: string, title: string, rev: string = 'initial'): SanityDocument => ({
@@ -50,7 +50,6 @@ describe('processActions', () => {
           documentId: 'doc1',
           type: 'document.create',
           documentType: 'article',
-          resource: {projectId: 'p', dataset: 'd'},
         },
       ]
       const result = processActions({
@@ -97,7 +96,6 @@ describe('processActions', () => {
           documentId: 'doc1',
           type: 'document.create',
           documentType: 'article',
-          resource: {projectId: 'p', dataset: 'd'},
         },
       ]
       expect(() =>
@@ -115,7 +113,6 @@ describe('processActions', () => {
           documentId: 'doc1',
           type: 'document.create',
           documentType: 'article',
-          resource: {projectId: 'p', dataset: 'd'},
         },
       ]
       const result = processActions({
@@ -144,7 +141,6 @@ describe('processActions', () => {
           documentId: 'doc1',
           type: 'document.create',
           documentType: 'article',
-          resource: {projectId: 'p', dataset: 'd'},
         },
       ]
       const grants = {...defaultGrants, create: alwaysDeny}
@@ -166,7 +162,6 @@ describe('processActions', () => {
             author: 'John Doe',
             count: 42,
           },
-          resource: {projectId: 'p', dataset: 'd'},
         },
       ]
       const result = processActions({
@@ -203,7 +198,6 @@ describe('processActions', () => {
             title: 'Overridden Title',
             newField: 'New Value',
           },
-          resource: {projectId: 'p', dataset: 'd'},
         },
       ]
       const result = processActions({
@@ -233,7 +227,6 @@ describe('processActions', () => {
           type: 'document.create',
           documentType: 'article',
           initialValue: {},
-          resource: {projectId: 'p', dataset: 'd'},
         },
       ]
       const result = processActions({
@@ -265,7 +258,6 @@ describe('processActions', () => {
           documentId: 'doc1',
           documentType: 'article',
           type: 'document.delete',
-          resource: {projectId: 'p', dataset: 'd'},
         },
       ]
       const result = processActions({
@@ -302,7 +294,6 @@ describe('processActions', () => {
           documentId: 'doc1',
           documentType: 'article',
           type: 'document.delete',
-          resource: {projectId: 'p', dataset: 'd'},
         },
       ]
       const result = processActions({
@@ -335,7 +326,6 @@ describe('processActions', () => {
           documentId: 'doc1',
           documentType: 'article',
           type: 'document.delete',
-          resource: {projectId: 'p', dataset: 'd'},
         },
       ]
       const grants = {...defaultGrants, update: alwaysDeny}
@@ -355,7 +345,6 @@ describe('processActions', () => {
           documentId: 'doc1',
           documentType: 'article',
           type: 'document.discard',
-          resource: {projectId: 'p', dataset: 'd'},
         },
       ]
       const result = processActions({
@@ -385,7 +374,6 @@ describe('processActions', () => {
           documentId: 'doc1',
           documentType: 'article',
           type: 'document.discard',
-          resource: {projectId: 'p', dataset: 'd'},
         },
       ]
       const grants = {...defaultGrants, update: alwaysDeny}
@@ -406,7 +394,6 @@ describe('processActions', () => {
           documentType: 'article',
           type: 'document.edit',
           patches: [{set: {title: 'Edited Title'}}],
-          resource: {projectId: 'p', dataset: 'd'},
         },
       ]
       const result = processActions({
@@ -439,7 +426,6 @@ describe('processActions', () => {
           documentType: 'article',
           type: 'document.edit',
           patches: [{set: {title: 'New Draft Title'}}],
-          resource: {projectId: 'p', dataset: 'd'},
         },
       ]
       const result = processActions({
@@ -457,6 +443,190 @@ describe('processActions', () => {
       expect(result.outgoingActions[0].actionType).toBe('sanity.action.document.edit')
     })
 
+    it('preserves inc/dec operations instead of collapsing them into sets', () => {
+      const draft = {...createDoc('drafts.doc1', 'Title', '1'), count: 5, score: 10}
+      const base: DocumentSet = {'drafts.doc1': draft}
+      const working: DocumentSet = {'drafts.doc1': draft}
+      const actions: DocumentAction[] = [
+        {
+          documentId: 'doc1',
+          documentType: 'article',
+          type: 'document.edit',
+          patches: [{inc: {count: 1}, dec: {score: 3}}],
+        },
+      ]
+      const result = processActions({
+        actions,
+        transactionId,
+        base,
+        working,
+        timestamp,
+        grants: defaultGrants,
+      })
+
+      // the local working copy reflects the applied increments
+      expect(result.working['drafts.doc1']).toMatchObject({count: 6, score: 7})
+      // the outgoing patch keeps the operational inc/dec instead of a set.
+      // the setIfMissing seeds the base value in case the field was removed
+      // concurrently: the server runs setIfMissing before inc/dec, and inc on
+      // a missing path would otherwise fail the whole transaction
+      const patches = result.outgoingActions.map((action) => 'patch' in action && action.patch)
+      expect(patches).toEqual([
+        {setIfMissing: {count: 5, score: 10}, inc: {count: 1}, dec: {score: 3}},
+      ])
+    })
+
+    it('accumulates multiple inc/dec records on the same path into one operation', () => {
+      const draft = {...createDoc('drafts.doc1', 'Title', '1'), count: 5}
+      const base: DocumentSet = {'drafts.doc1': draft}
+      const working: DocumentSet = {'drafts.doc1': draft}
+      const actions: DocumentAction[] = [
+        {
+          documentId: 'doc1',
+          documentType: 'article',
+          type: 'document.edit',
+          patches: [{inc: {count: 1}}, {inc: {count: 2}}, {dec: {count: 4}}],
+        },
+      ]
+      const result = processActions({
+        actions,
+        transactionId,
+        base,
+        working,
+        timestamp,
+        grants: defaultGrants,
+      })
+
+      // 5 + 1 + 2 - 4 = 4 locally
+      expect(result.working['drafts.doc1']).toMatchObject({count: 4})
+      // the three records collapse into one accumulated dec (net -1) with the
+      // base value seeded for the concurrent-removal degradation path
+      const patches = result.outgoingActions.map((action) => 'patch' in action && action.patch)
+      expect(patches).toEqual([{setIfMissing: {count: 5}, dec: {count: 1}}])
+    })
+
+    it('keeps the diffed set when an inc is combined with a set of the same field', () => {
+      const draft = {...createDoc('drafts.doc1', 'Title', '1'), count: 5}
+      const base: DocumentSet = {'drafts.doc1': draft}
+      const working: DocumentSet = {'drafts.doc1': draft}
+      const actions: DocumentAction[] = [
+        {
+          documentId: 'doc1',
+          documentType: 'article',
+          type: 'document.edit',
+          // set to 100 first, then inc: the final value (101) is not
+          // explainable by the inc alone, so it must remain a set
+          patches: [{set: {count: 100}}, {inc: {count: 1}}],
+        },
+      ]
+      const result = processActions({
+        actions,
+        transactionId,
+        base,
+        working,
+        timestamp,
+        grants: defaultGrants,
+      })
+
+      expect(result.working['drafts.doc1']).toMatchObject({count: 101})
+      const patches = result.outgoingActions.map((action) => 'patch' in action && action.patch)
+      expect(patches).toEqual([{set: {count: 101}}])
+    })
+
+    it('preserves inc operations targeting keyed array items', () => {
+      const draft = {
+        ...createDoc('drafts.doc1', 'Title', '1'),
+        items: [{_key: 'itemA', qty: 2}],
+      }
+      const base: DocumentSet = {'drafts.doc1': draft}
+      const working: DocumentSet = {'drafts.doc1': draft}
+      const actions: DocumentAction[] = [
+        {
+          documentId: 'doc1',
+          documentType: 'article',
+          type: 'document.edit',
+          patches: [{inc: {'items[_key=="itemA"].qty': 3}}],
+        },
+      ]
+      const result = processActions({
+        actions,
+        transactionId,
+        base,
+        working,
+        timestamp,
+        grants: defaultGrants,
+      })
+
+      expect(result.working['drafts.doc1']?.['items']).toEqual([{_key: 'itemA', qty: 5}])
+      const patches = result.outgoingActions.map((action) => 'patch' in action && action.patch)
+      expect(patches).toEqual([
+        {setIfMissing: {'items[_key=="itemA"].qty': 2}, inc: {'items[_key=="itemA"].qty': 3}},
+      ])
+    })
+
+    it('preserves inc operations through the liveEdit mutation path', () => {
+      const liveDoc = {...createLiveEditDoc('live-doc', 'Title', '1'), count: 5}
+      const base: DocumentSet = {'live-doc': liveDoc}
+      const working: DocumentSet = {'live-doc': liveDoc}
+      const actions: DocumentAction[] = [
+        {
+          documentId: 'live-doc',
+          documentType: 'liveArticle',
+          type: 'document.edit',
+          liveEdit: true,
+          patches: [{inc: {count: 2}}],
+        },
+      ]
+      const result = processActions({
+        actions,
+        transactionId,
+        base,
+        working,
+        timestamp,
+        grants: defaultGrants,
+      })
+
+      expect(result.working['live-doc']).toMatchObject({count: 7})
+      expect(result.outgoingMutations).toEqual([
+        {patch: {id: 'live-doc', setIfMissing: {count: 5}, inc: {count: 2}}},
+      ])
+    })
+
+    it('degrades to the diffed set result when the inc target was removed concurrently', () => {
+      const draft = {...createDoc('drafts.doc1', 'Title', '1'), count: 5}
+      const base: DocumentSet = {'drafts.doc1': draft}
+      const working: DocumentSet = {'drafts.doc1': draft}
+      const actions: DocumentAction[] = [
+        {
+          documentId: 'doc1',
+          documentType: 'article',
+          type: 'document.edit',
+          patches: [{inc: {count: 1}}],
+        },
+      ]
+      const result = processActions({
+        actions,
+        transactionId,
+        base,
+        working,
+        timestamp,
+        grants: defaultGrants,
+      })
+      const patch = result.outgoingActions.map((action) => 'patch' in action && action.patch)[0]
+
+      // simulate the server applying the emitted patch to a document where
+      // another client removed the counter in the meantime: setIfMissing
+      // seeds the base value, then inc applies, matching what the collapsed
+      // set would have written (instead of inc failing the transaction)
+      const {count: _count, ...draftWithoutCount} = draft
+      const serverResult = processMutations({
+        documents: {'drafts.doc1': draftWithoutCount as SanityDocument},
+        mutations: [{patch: {id: 'drafts.doc1', ...(patch as object)}}],
+        transactionId: 'txn-server',
+      })
+      expect(serverResult['drafts.doc1']).toMatchObject({count: 6})
+    })
+
     it('should edit a document when base and working diverge', () => {
       const publishedBase = createDoc('doc1', 'Original Boring Title')
       const publishedWorking = createDoc('doc1', 'Local Boring Title')
@@ -468,7 +638,6 @@ describe('processActions', () => {
           documentType: 'article',
           type: 'document.edit',
           patches: [{set: {title: 'Original Cool Title'}}],
-          resource: {projectId: 'p', dataset: 'd'},
         },
       ]
       const result = processActions({
@@ -498,7 +667,6 @@ describe('processActions', () => {
           documentType: 'article',
           type: 'document.edit',
           patches: [{set: {title: 'Should Fail'}}],
-          resource: {projectId: 'p', dataset: 'd'},
         },
       ]
       expect(() =>
@@ -516,7 +684,6 @@ describe('processActions', () => {
           documentType: 'article',
           type: 'document.edit',
           patches: [{set: {title: 'Edited Title'}}],
-          resource: {projectId: 'p', dataset: 'd'},
         },
       ]
       const grants = {...defaultGrants, create: alwaysDeny}
@@ -535,7 +702,6 @@ describe('processActions', () => {
           documentType: 'article',
           type: 'document.edit',
           patches: [{set: {title: 'New Title'}}],
-          resource: {projectId: 'p', dataset: 'd'},
         },
       ]
       const grants = {...defaultGrants, update: alwaysDeny}
@@ -545,6 +711,151 @@ describe('processActions', () => {
     })
   })
 
+  describe('document.edit with preserveOperations', () => {
+    const createKeyedDoc = (): SanityDocument => ({
+      _id: 'drafts.doc1',
+      _type: 'article',
+      _createdAt: '2025-01-01T00:00:00.000Z',
+      _updatedAt: '2025-01-01T00:00:00.000Z',
+      _rev: 'initial',
+      items: [
+        {_key: 'a', value: 'first'},
+        {_key: 'b', value: 'second'},
+      ],
+    })
+
+    it('forwards the given patches verbatim instead of re-diffing', () => {
+      const draft = createKeyedDoc()
+      const base: DocumentSet = {'drafts.doc1': draft}
+      const working: DocumentSet = {'drafts.doc1': draft}
+      const patches = [
+        {insert: {after: 'items[_key=="a"]', items: [{_key: 'c', value: 'in between'}]}},
+      ]
+      const actions: DocumentAction[] = [
+        {
+          documentId: 'doc1',
+          documentType: 'article',
+          type: 'document.edit',
+          patches,
+          preserveOperations: true,
+        },
+      ]
+      const result = processActions({
+        actions,
+        transactionId,
+        base,
+        working,
+        timestamp,
+        grants: defaultGrants,
+      })
+
+      // the outgoing action carries the caller's keyed patch untouched
+      expect(result.outgoingActions).toEqual([
+        {
+          actionType: 'sanity.action.document.edit',
+          draftId: 'drafts.doc1',
+          publishedId: 'doc1',
+          patch: patches[0],
+        },
+      ])
+
+      // and it still applies to the local working copy
+      expect(result.working['drafts.doc1']?.['items']).toEqual([
+        {_key: 'a', value: 'first'},
+        {_key: 'c', value: 'in between'},
+        {_key: 'b', value: 'second'},
+      ])
+    })
+
+    it('applies keyed unsets and sets to the local working copy', () => {
+      const draft = createKeyedDoc()
+      const base: DocumentSet = {'drafts.doc1': draft}
+      const working: DocumentSet = {'drafts.doc1': draft}
+      const actions: DocumentAction[] = [
+        {
+          documentId: 'doc1',
+          documentType: 'article',
+          type: 'document.edit',
+          patches: [
+            {unset: ['items[_key=="a"]']},
+            {set: {'items[_key=="b"].value': 'updated second'}},
+          ],
+          preserveOperations: true,
+        },
+      ]
+      const result = processActions({
+        actions,
+        transactionId,
+        base,
+        working,
+        timestamp,
+        grants: defaultGrants,
+      })
+
+      expect(result.working['drafts.doc1']?.['items']).toEqual([
+        {_key: 'b', value: 'updated second'},
+      ])
+      expect(result.outgoingActions.map((action) => 'patch' in action && action.patch)).toEqual([
+        {unset: ['items[_key=="a"]']},
+        {set: {'items[_key=="b"].value': 'updated second'}},
+      ])
+    })
+
+    it('surfaces patch application failures as ActionError', () => {
+      const draft = {...createKeyedDoc(), count: 5}
+      const base: DocumentSet = {'drafts.doc1': draft}
+      const working: DocumentSet = {'drafts.doc1': draft}
+      const actions: DocumentAction[] = [
+        {
+          documentId: 'doc1',
+          documentType: 'article',
+          type: 'document.edit',
+          // diff-match-patch on a non-string value cannot apply
+          patches: [{diffMatchPatch: {count: '@@ -1,3 +1,3 @@\n-foo\n+bar\n'}}],
+          preserveOperations: true,
+        },
+      ]
+      expect(() =>
+        processActions({actions, transactionId, base, working, timestamp, grants: defaultGrants}),
+      ).toThrow(ActionError)
+      expect(() =>
+        processActions({actions, transactionId, base, working, timestamp, grants: defaultGrants}),
+      ).toThrow(/Failed to apply patches to the base document/)
+    })
+
+    it('forwards patches verbatim through the liveEdit mutation path', () => {
+      const liveDoc = {...createKeyedDoc(), _id: 'live-doc'}
+      const base: DocumentSet = {'live-doc': liveDoc}
+      const working: DocumentSet = {'live-doc': liveDoc}
+      const patches = [{insert: {before: 'items[_key=="a"]', items: [{_key: 'z', value: 'start'}]}}]
+      const actions: DocumentAction[] = [
+        {
+          documentId: 'live-doc',
+          documentType: 'liveArticle',
+          type: 'document.edit',
+          liveEdit: true,
+          patches,
+          preserveOperations: true,
+        },
+      ]
+      const result = processActions({
+        actions,
+        transactionId,
+        base,
+        working,
+        timestamp,
+        grants: defaultGrants,
+      })
+
+      expect(result.outgoingMutations).toEqual([{patch: {id: 'live-doc', ...patches[0]}}])
+      expect(result.working['live-doc']?.['items']).toEqual([
+        {_key: 'z', value: 'start'},
+        {_key: 'a', value: 'first'},
+        {_key: 'b', value: 'second'},
+      ])
+    })
+  })
+
   describe('document.publish', () => {
     it('should publish a draft document', () => {
       const draft = createDoc('drafts.doc1', 'Draft Title', '1')
@@ -555,7 +866,6 @@ describe('processActions', () => {
           documentId: 'doc1',
           documentType: 'article',
           type: 'document.publish',
-          resource: {projectId: 'p', dataset: 'd'},
         },
       ]
       const result = processActions({
@@ -591,7 +901,6 @@ describe('processActions', () => {
           documentId: 'doc1',
           documentType: 'article',
           type: 'document.publish',
-          resource: {projectId: 'p', dataset: 'd'},
         },
       ]
       expect(() =>
@@ -610,7 +919,6 @@ describe('processActions', () => {
           documentId: 'doc1',
           documentType: 'article',
           type: 'document.publish',
-          resource: {projectId: 'p', dataset: 'd'},
         },
       ]
       expect(() =>
@@ -623,12 +931,7 @@ describe('processActions', () => {
       const base: DocumentSet = {'drafts.doc1': draft}
       const working: DocumentSet = {'drafts.doc1': draft}
       const actions: DocumentAction[] = [
-        {
-          documentId: 'doc1',
-          documentType: 'article',
-          type: 'document.publish',
-          resource: {projectId: 'p', dataset: 'd'},
-        },
+        {documentId: 'doc1', documentType: 'article', type: 'document.publish'},
       ]
       const grants = {...defaultGrants, update: alwaysDeny}
       expect(() =>
@@ -642,12 +945,7 @@ describe('processActions', () => {
       const base: DocumentSet = {'drafts.doc1': draft, 'doc1': published}
       const working: DocumentSet = {'drafts.doc1': draft, 'doc1': published}
       const actions: DocumentAction[] = [
-        {
-          documentId: 'doc1',
-          documentType: 'article',
-          type: 'document.publish',
-          resource: {projectId: 'p', dataset: 'd'},
-        },
+        {documentId: 'doc1', documentType: 'article', type: 'document.publish'},
       ]
       const grants = {
         ...defaultGrants,
@@ -666,12 +964,7 @@ describe('processActions', () => {
       const base: DocumentSet = {'drafts.doc1': draft}
       const working: DocumentSet = {'drafts.doc1': draft}
       const actions: DocumentAction[] = [
-        {
-          documentId: 'doc1',
-          documentType: 'article',
-          type: 'document.publish',
-          resource: {projectId: 'p', dataset: 'd'},
-        },
+        {documentId: 'doc1', documentType: 'article', type: 'document.publish'},
       ]
       const grants = {...defaultGrants, create: alwaysDeny}
       expect(() =>
@@ -707,7 +1000,6 @@ describe('processActions', () => {
           documentId: 'doc1',
           documentType: 'article',
           type: 'document.publish',
-          resource: {projectId: 'p', dataset: 'd'},
         },
       ]
       const result = processActions({
@@ -740,7 +1032,6 @@ describe('processActions', () => {
           documentId: 'doc1',
           documentType: 'article',
           type: 'document.unpublish',
-          resource: {projectId: 'p', dataset: 'd'},
         },
       ]
       const result = processActions({
@@ -775,7 +1066,6 @@ describe('processActions', () => {
           documentId: 'doc1',
           documentType: 'article',
           type: 'document.unpublish',
-          resource: {projectId: 'p', dataset: 'd'},
         },
       ]
       expect(() =>
@@ -794,7 +1084,6 @@ describe('processActions', () => {
           documentId: 'doc1',
           documentType: 'article',
           type: 'document.unpublish',
-          resource: {projectId: 'p', dataset: 'd'},
         },
       ]
       const result = processActions({
@@ -826,12 +1115,7 @@ describe('processActions', () => {
       const base: DocumentSet = {doc1: published}
       const working: DocumentSet = {doc1: published}
       const actions: DocumentAction[] = [
-        {
-          documentId: 'doc1',
-          documentType: 'article',
-          type: 'document.unpublish',
-          resource: {projectId: 'p', dataset: 'd'},
-        },
+        {documentId: 'doc1', documentType: 'article', type: 'document.unpublish'},
       ]
       const grants = {...defaultGrants, update: alwaysDeny}
       expect(() =>
@@ -844,12 +1128,7 @@ describe('processActions', () => {
       const base: DocumentSet = {doc1: published}
       const working: DocumentSet = {doc1: published}
       const actions: DocumentAction[] = [
-        {
-          documentId: 'doc1',
-          documentType: 'article',
-          type: 'document.unpublish',
-          resource: {projectId: 'p', dataset: 'd'},
-        },
+        {documentId: 'doc1', documentType: 'article', type: 'document.unpublish'},
       ]
       const grants = {...defaultGrants, create: alwaysDeny}
       expect(() =>
@@ -864,25 +1143,14 @@ describe('processActions', () => {
       const base: DocumentSet = {doc1: published}
       const working: DocumentSet = {doc1: published}
       const actions: DocumentAction[] = [
-        {
-          documentId: 'doc1',
-          documentType: 'article',
-          type: 'document.create',
-          resource: {projectId: 'p', dataset: 'd'},
-        },
+        {documentId: 'doc1', documentType: 'article', type: 'document.create'},
         {
           documentId: 'doc1',
           documentType: 'article',
           type: 'document.edit',
           patches: [{set: {title: 'Edited Title'}}],
-          resource: {projectId: 'p', dataset: 'd'},
-        },
-        {
-          documentId: 'doc1',
-          documentType: 'article',
-          type: 'document.publish',
-          resource: {projectId: 'p', dataset: 'd'},
         },
+        {documentId: 'doc1', documentType: 'article', type: 'document.publish'},
       ]
       const result = processActions({
         actions,
@@ -928,7 +1196,6 @@ describe('processActions', () => {
             type: 'document.create',
             documentType: 'liveArticle',
             liveEdit: true,
-            resource: {projectId: 'p', dataset: 'd'},
           },
         ]
 
@@ -947,38 +1214,63 @@ describe('processActions', () => {
         expect(doc?._type).toBe('liveArticle')
         expect(doc?._rev).toBe(transactionId)
 
-        // Should use document.create action, not version.create
-        expect(result.outgoingActions).toHaveLength(1)
-        const action = result.outgoingActions[0]
-        expect(action.actionType).toBe('sanity.action.document.create')
-        if ('attributes' in action && 'publishedId' in action) {
-          expect(action.publishedId).toBe('live1')
-          expect(action.attributes._id).toBe('live1')
-          expect(action.attributes._type).toBe('liveArticle')
-        } else {
-          throw new Error('Expected action to have attributes and publishedId')
-        }
+        // Should not use actions
+        expect(result.outgoingActions).toHaveLength(0)
+        expect(result.outgoingMutations).toHaveLength(1)
+        const mutation = result.outgoingMutations[0] as CreateMutation
+        expect(mutation.create._id).toBe('live1')
+        expect(mutation.create._type).toBe('liveArticle')
       })
 
-      it('should throw an error if liveEdit document already exists', () => {
-        const existingDoc = createLiveEditDoc('live1', 'Existing')
-        const base: DocumentSet = {live1: existingDoc}
-        const working: DocumentSet = {live1: existingDoc}
+      it('should apply initialValue when creating a liveEdit document', () => {
+        const base: DocumentSet = {}
+        const working: DocumentSet = {}
         const actions: DocumentAction[] = [
           {
             documentId: 'live1',
             type: 'document.create',
             documentType: 'liveArticle',
             liveEdit: true,
-            resource: {projectId: 'p', dataset: 'd'},
+            initialValue: {title: 'Initial Title', count: 42},
           },
         ]
 
-        expect(() =>
-          processActions({actions, transactionId, base, working, timestamp, grants: defaultGrants}),
-        ).toThrow('This document already exists')
-      })
-    })
+        const result = processActions({
+          actions,
+          transactionId,
+          base,
+          working,
+          timestamp,
+          grants: defaultGrants,
+        })
+
+        const doc = result.working['live1']
+        expect(doc?.['title']).toBe('Initial Title')
+        expect(doc?.['count']).toBe(42)
+
+        const mutation = result.outgoingMutations[0] as CreateMutation
+        expect(mutation.create['title']).toBe('Initial Title')
+        expect(mutation.create['count']).toBe(42)
+      })
+
+      it('should throw an error if liveEdit document already exists', () => {
+        const existingDoc = createLiveEditDoc('live1', 'Existing')
+        const base: DocumentSet = {live1: existingDoc}
+        const working: DocumentSet = {live1: existingDoc}
+        const actions: DocumentAction[] = [
+          {
+            documentId: 'live1',
+            type: 'document.create',
+            documentType: 'liveArticle',
+            liveEdit: true,
+          },
+        ]
+
+        expect(() =>
+          processActions({actions, transactionId, base, working, timestamp, grants: defaultGrants}),
+        ).toThrow('This document already exists')
+      })
+    })
 
     describe('document.edit', () => {
       it('should edit a liveEdit document directly', () => {
@@ -992,7 +1284,6 @@ describe('processActions', () => {
             documentType: 'liveArticle',
             liveEdit: true,
             patches: [{set: {title: 'Updated Title'}}],
-            resource: {projectId: 'p', dataset: 'd'},
           },
         ]
 
@@ -1010,12 +1301,15 @@ describe('processActions', () => {
         expect(editedDoc?.['title']).toBe('Updated Title')
         expect(editedDoc?._id).toBe('live1')
 
-        // Should use document.edit action with draftId prefixed (for server validation) but publishedId as the actual doc
-        expect(result.outgoingActions[0]).toMatchObject({
-          actionType: 'sanity.action.document.edit',
-          draftId: 'drafts.live1',
-          publishedId: 'live1',
+        expect(result.outgoingMutations[0]).toEqual({
+          patch: {
+            id: 'live1',
+            diffMatchPatch: {
+              title: '@@ -1,12 +1,11 @@\n-Original\n+Updated\n  Tit\n',
+            },
+          },
         })
+        expect(result.outgoingActions).toHaveLength(0)
       })
 
       it('should throw an error if liveEdit document does not exist', () => {
@@ -1028,7 +1322,6 @@ describe('processActions', () => {
             documentType: 'liveArticle',
             liveEdit: true,
             patches: [{set: {title: 'New Title'}}],
-            resource: {projectId: 'p', dataset: 'd'},
           },
         ]
 
@@ -1049,7 +1342,6 @@ describe('processActions', () => {
             type: 'document.delete',
             documentType: 'liveArticle',
             liveEdit: true,
-            resource: {projectId: 'p', dataset: 'd'},
           },
         ]
 
@@ -1064,12 +1356,9 @@ describe('processActions', () => {
 
         expect(result.working['live1']).toBeNull()
 
-        expect(result.outgoingActions).toEqual([
-          {
-            actionType: 'sanity.action.document.delete',
-            publishedId: 'live1',
-          },
-        ])
+        expect(result.outgoingActions).toHaveLength(0)
+        expect(result.outgoingMutations).toHaveLength(1)
+        expect(result.outgoingMutations[0]).toEqual({delete: {id: 'live1'}})
       })
 
       it('should throw an error if liveEdit document does not exist', () => {
@@ -1081,7 +1370,6 @@ describe('processActions', () => {
             type: 'document.delete',
             documentType: 'liveArticle',
             liveEdit: true,
-            resource: {projectId: 'p', dataset: 'd'},
           },
         ]
 
@@ -1102,16 +1390,12 @@ describe('processActions', () => {
             type: 'document.publish',
             documentType: 'liveArticle',
             liveEdit: true,
-            resource: {projectId: 'p', dataset: 'd'},
           },
         ]
 
         expect(() =>
           processActions({actions, transactionId, base, working, timestamp, grants: defaultGrants}),
-        ).toThrow('Cannot publish liveEdit document')
-        expect(() =>
-          processActions({actions, transactionId, base, working, timestamp, grants: defaultGrants}),
-        ).toThrow('LiveEdit documents do not support drafts or publishing')
+        ).toThrow(/Publishing is not supported for liveEdit or version/)
       })
     })
 
@@ -1126,16 +1410,12 @@ describe('processActions', () => {
             type: 'document.unpublish',
             documentType: 'liveArticle',
             liveEdit: true,
-            resource: {projectId: 'p', dataset: 'd'},
           },
         ]
 
         expect(() =>
           processActions({actions, transactionId, base, working, timestamp, grants: defaultGrants}),
-        ).toThrow('Cannot unpublish liveEdit document')
-        expect(() =>
-          processActions({actions, transactionId, base, working, timestamp, grants: defaultGrants}),
-        ).toThrow('LiveEdit documents do not support drafts or publishing')
+        ).toThrow(/Unpublishing is not supported for liveEdit or version/)
       })
     })
 
@@ -1150,17 +1430,745 @@ describe('processActions', () => {
             type: 'document.discard',
             documentType: 'liveArticle',
             liveEdit: true,
-            resource: {projectId: 'p', dataset: 'd'},
           },
         ]
 
         expect(() =>
           processActions({actions, transactionId, base, working, timestamp, grants: defaultGrants}),
-        ).toThrow('Cannot discard changes for liveEdit document')
+        ).toThrow('Cannot discard changes for liveEdit document "live1"')
+
         expect(() =>
           processActions({actions, transactionId, base, working, timestamp, grants: defaultGrants}),
         ).toThrow('LiveEdit documents do not support drafts')
       })
     })
   })
+
+  describe('release perspective (version) documents', () => {
+    const releaseName = 'test-release'
+    const perspective = {releaseName}
+    const versionId = `versions.${releaseName}.doc1`
+
+    describe('document.create', () => {
+      it('should create a version document for a release perspective', () => {
+        const base: DocumentSet = {}
+        const working: DocumentSet = {}
+        const actions: DocumentAction[] = [
+          {
+            documentId: versionId,
+            type: 'document.create',
+            documentType: 'article',
+            perspective,
+          },
+        ]
+        const result = processActions({
+          actions,
+          transactionId,
+          base,
+          working,
+          timestamp,
+          grants: defaultGrants,
+        })
+
+        const versionDoc = result.working[versionId]
+        expect(versionDoc).toBeDefined()
+        expect(versionDoc?._id).toBe(versionId)
+        expect(versionDoc?._type).toBe('article')
+        expect(versionDoc?._rev).toBe(transactionId)
+
+        expect(result.outgoingActions).toEqual([
+          {
+            actionType: 'sanity.action.document.version.create',
+            publishedId: 'doc1',
+            attributes: expect.objectContaining({_id: versionId, _type: 'article'}),
+          },
+        ])
+      })
+
+      it('should create a version document using the published document as a base', () => {
+        const published = createDoc('doc1', 'Published Title')
+        const base: DocumentSet = {doc1: published}
+        const working: DocumentSet = {doc1: published}
+        const actions: DocumentAction[] = [
+          {
+            documentId: versionId,
+            type: 'document.create',
+            documentType: 'article',
+            perspective,
+          },
+        ]
+        const result = processActions({
+          actions,
+          transactionId,
+          base,
+          working,
+          timestamp,
+          grants: defaultGrants,
+        })
+
+        const versionDoc = result.working[versionId]
+        expect(versionDoc).toBeDefined()
+        expect(versionDoc?._id).toBe(versionId)
+        expect(versionDoc?.['title']).toBe('Published Title')
+      })
+
+      it('should throw if a version document already exists', () => {
+        const existingVersion = createDoc(versionId, 'Existing Version')
+        const base: DocumentSet = {[versionId]: existingVersion}
+        const working: DocumentSet = {[versionId]: existingVersion}
+        const actions: DocumentAction[] = [
+          {
+            documentId: versionId,
+            type: 'document.create',
+            documentType: 'article',
+            perspective,
+          },
+        ]
+        expect(() =>
+          processActions({actions, transactionId, base, working, timestamp, grants: defaultGrants}),
+        ).toThrow(/release version.*already exists/i)
+      })
+
+      it('should create a version document with initial values', () => {
+        const base: DocumentSet = {}
+        const working: DocumentSet = {}
+        const actions: DocumentAction[] = [
+          {
+            documentId: versionId,
+            type: 'document.create',
+            documentType: 'article',
+            perspective,
+            initialValue: {title: 'Release Version Title', count: 7},
+          },
+        ]
+        const result = processActions({
+          actions,
+          transactionId,
+          base,
+          working,
+          timestamp,
+          grants: defaultGrants,
+        })
+
+        const versionDoc = result.working[versionId]
+        expect(versionDoc?.['title']).toBe('Release Version Title')
+        expect(versionDoc?.['count']).toBe(7)
+      })
+
+      it('should throw PermissionActionError if create permission is denied', () => {
+        const base: DocumentSet = {}
+        const working: DocumentSet = {}
+        const actions: DocumentAction[] = [
+          {
+            documentId: versionId,
+            type: 'document.create',
+            documentType: 'article',
+            perspective,
+          },
+        ]
+        const grants = {...defaultGrants, create: alwaysDeny}
+        expect(() =>
+          processActions({actions, transactionId, base, working, timestamp, grants}),
+        ).toThrow(/You do not have permission to create a release version/)
+      })
+    })
+
+    describe('document.edit', () => {
+      it('should edit a version document directly', () => {
+        const version = createDoc(versionId, 'Original Version Title')
+        const base: DocumentSet = {[versionId]: version}
+        const working: DocumentSet = {[versionId]: version}
+        const actions: DocumentAction[] = [
+          {
+            documentId: versionId,
+            type: 'document.edit',
+            documentType: 'article',
+            perspective,
+            patches: [{set: {title: 'Updated Version Title'}}],
+          },
+        ]
+        const result = processActions({
+          actions,
+          transactionId,
+          base,
+          working,
+          timestamp,
+          grants: defaultGrants,
+        })
+
+        const editedDoc = result.working[versionId]
+        expect(editedDoc?.['title']).toBe('Updated Version Title')
+        expect(editedDoc?._id).toBe(versionId)
+
+        // outgoing action should use versionId as draftId and the base publishedId
+        expect(result.outgoingActions[0]).toMatchObject({
+          actionType: 'sanity.action.document.edit',
+          draftId: versionId,
+          publishedId: 'doc1',
+        })
+      })
+
+      it('should throw if the version document does not exist', () => {
+        const base: DocumentSet = {}
+        const working: DocumentSet = {}
+        const actions: DocumentAction[] = [
+          {
+            documentId: versionId,
+            type: 'document.edit',
+            documentType: 'article',
+            perspective,
+            patches: [{set: {title: 'Should Fail'}}],
+          },
+        ]
+        expect(() =>
+          processActions({actions, transactionId, base, working, timestamp, grants: defaultGrants}),
+        ).toThrow(/does not exist in the release/)
+      })
+
+      it('should throw PermissionActionError if update permission is denied', () => {
+        const version = createDoc(versionId, 'Version Title')
+        const base: DocumentSet = {[versionId]: version}
+        const working: DocumentSet = {[versionId]: version}
+        const actions: DocumentAction[] = [
+          {
+            documentId: versionId,
+            type: 'document.edit',
+            documentType: 'article',
+            perspective,
+            patches: [{set: {title: 'No Permission'}}],
+          },
+        ]
+        const grants = {...defaultGrants, update: alwaysDeny}
+        expect(() =>
+          processActions({actions, transactionId, base, working, timestamp, grants}),
+        ).toThrow(/You do not have permission to edit document/)
+      })
+    })
+
+    describe('document.discard', () => {
+      it('should discard a version document', () => {
+        const version = createDoc(versionId, 'Version Title')
+        const base: DocumentSet = {[versionId]: version}
+        const working: DocumentSet = {[versionId]: version}
+        const actions: DocumentAction[] = [
+          {
+            documentId: versionId,
+            type: 'document.discard',
+            documentType: 'article',
+            perspective,
+          },
+        ]
+        const result = processActions({
+          actions,
+          transactionId,
+          base,
+          working,
+          timestamp,
+          grants: defaultGrants,
+        })
+
+        expect(result.working[versionId]).toBeNull()
+        expect(result.outgoingActions).toEqual([
+          {
+            actionType: 'sanity.action.document.version.discard',
+            versionId,
+          },
+        ])
+      })
+
+      it('should throw if there is no version document to discard', () => {
+        const base: DocumentSet = {}
+        const working: DocumentSet = {}
+        const actions: DocumentAction[] = [
+          {
+            documentId: versionId,
+            type: 'document.discard',
+            documentType: 'article',
+            perspective,
+          },
+        ]
+        expect(() =>
+          processActions({actions, transactionId, base, working, timestamp, grants: defaultGrants}),
+        ).toThrow(/no draft or version available to discard/)
+      })
+
+      it('should throw PermissionActionError if update permission is denied', () => {
+        const version = createDoc(versionId, 'Version Title')
+        const base: DocumentSet = {[versionId]: version}
+        const working: DocumentSet = {[versionId]: version}
+        const actions: DocumentAction[] = [
+          {
+            documentId: versionId,
+            type: 'document.discard',
+            documentType: 'article',
+            perspective,
+          },
+        ]
+        const grants = {...defaultGrants, update: alwaysDeny}
+        expect(() =>
+          processActions({actions, transactionId, base, working, timestamp, grants}),
+        ).toThrow(/You do not have permission to discard changes/)
+      })
+    })
+
+    describe('document.publish', () => {
+      it('should throw for release perspective documents', () => {
+        const version = createDoc(versionId, 'Version Title')
+        const base: DocumentSet = {[versionId]: version}
+        const working: DocumentSet = {[versionId]: version}
+        const actions: DocumentAction[] = [
+          {
+            documentId: versionId,
+            type: 'document.publish',
+            documentType: 'article',
+            perspective,
+          },
+        ]
+        expect(() =>
+          processActions({actions, transactionId, base, working, timestamp, grants: defaultGrants}),
+        ).toThrow(/Publishing is not supported for liveEdit or version/)
+      })
+    })
+
+    describe('document.delete', () => {
+      it('should throw for release perspective documents', () => {
+        const version = createDoc(versionId, 'Version Title')
+        const base: DocumentSet = {[versionId]: version}
+        const working: DocumentSet = {[versionId]: version}
+        const actions: DocumentAction[] = [
+          {
+            documentId: versionId,
+            type: 'document.delete',
+            documentType: 'article',
+            perspective,
+          },
+        ]
+        expect(() =>
+          processActions({actions, transactionId, base, working, timestamp, grants: defaultGrants}),
+        ).toThrow(/Cannot delete a version document/)
+      })
+    })
+  })
+
+  describe('release actions', () => {
+    const releaseName = 'my-release'
+    const releaseDocId = `_.releases.${releaseName}`
+
+    const createReleaseDoc = (overrides: Partial<SanityDocument> = {}): SanityDocument => ({
+      _id: releaseDocId,
+      _type: 'system.release',
+      _createdAt: '2025-01-01T00:00:00.000Z',
+      _updatedAt: '2025-01-01T00:00:00.000Z',
+      _rev: 'initial',
+      name: releaseName,
+      state: 'active',
+      metadata: {releaseType: 'undecided'},
+      ...overrides,
+    })
+
+    describe('release.create', () => {
+      it('inserts an optimistic release doc and emits a release.create action', () => {
+        const base: DocumentSet = {}
+        const working: DocumentSet = {}
+        const actions: Action[] = [
+          {
+            type: 'release.create',
+            releaseId: releaseName,
+            metadata: {title: 'My release', releaseType: 'asap'},
+          },
+        ]
+
+        const result = processActions({
+          actions,
+          transactionId,
+          base,
+          working,
+          timestamp,
+          grants: defaultGrants,
+        })
+
+        const doc = result.working[releaseDocId]
+        expect(doc).toBeDefined()
+        expect(doc?._type).toBe('system.release')
+        expect(doc?.['name']).toBe(releaseName)
+        expect(doc?.['state']).toBe('active')
+        expect(doc?.['metadata']).toEqual({title: 'My release', releaseType: 'asap'})
+
+        expect(result.outgoingActions).toEqual([
+          {
+            actionType: 'sanity.action.release.create',
+            releaseId: releaseName,
+            metadata: {title: 'My release', releaseType: 'asap'},
+          },
+        ])
+      })
+
+      it('throws if the release already exists in base or working', () => {
+        const existing = createReleaseDoc()
+        expect(() =>
+          processActions({
+            actions: [
+              {
+                type: 'release.create',
+                releaseId: releaseName,
+                metadata: {releaseType: 'undecided'},
+              },
+            ],
+            transactionId,
+            base: {[releaseDocId]: existing},
+            working: {[releaseDocId]: existing},
+            timestamp,
+            grants: defaultGrants,
+          }),
+        ).toThrow(/already exists/)
+      })
+
+      it('throws PermissionActionError when the create grant is denied', () => {
+        expect(() =>
+          processActions({
+            actions: [
+              {
+                type: 'release.create',
+                releaseId: releaseName,
+                metadata: {releaseType: 'undecided'},
+              },
+            ],
+            transactionId,
+            base: {},
+            working: {},
+            timestamp,
+            grants: {...defaultGrants, create: alwaysDeny},
+          }),
+        ).toThrow(/permission to create release/)
+      })
+    })
+
+    describe('release.edit', () => {
+      it('applies the patch optimistically and forwards the original patch to the outgoing action', () => {
+        const existing = createReleaseDoc({
+          metadata: {releaseType: 'undecided'},
+        } as Partial<SanityDocument>)
+        const patch = {set: {'metadata.title': 'Updated title'}}
+
+        const result = processActions({
+          actions: [{type: 'release.edit', releaseId: releaseName, patch}],
+          transactionId,
+          base: {[releaseDocId]: existing},
+          working: {[releaseDocId]: existing},
+          timestamp,
+          grants: defaultGrants,
+        })
+
+        const updated = result.working[releaseDocId] as SanityDocument & {
+          metadata: {title?: string; releaseType: string}
+        }
+        expect(updated.metadata.title).toBe('Updated title')
+        // releaseType wasn't unset
+        expect(updated.metadata.releaseType).toBe('undecided')
+
+        expect(result.outgoingActions).toEqual([
+          {
+            actionType: 'sanity.action.release.edit',
+            releaseId: releaseName,
+            patch,
+          },
+        ])
+      })
+
+      it('throws when editing a release that does not exist', () => {
+        expect(() =>
+          processActions({
+            actions: [
+              {
+                type: 'release.edit',
+                releaseId: releaseName,
+                patch: {set: {'metadata.title': 'x'}},
+              },
+            ],
+            transactionId,
+            base: {},
+            working: {},
+            timestamp,
+            grants: defaultGrants,
+          }),
+        ).toThrow(/does not exist/)
+      })
+
+      it('throws PermissionActionError when the working release fails the update grant', () => {
+        const existing = createReleaseDoc()
+        expect(() =>
+          processActions({
+            actions: [
+              {
+                type: 'release.edit',
+                releaseId: releaseName,
+                patch: {set: {'metadata.title': 'x'}},
+              },
+            ],
+            transactionId,
+            base: {[releaseDocId]: existing},
+            working: {[releaseDocId]: existing},
+            timestamp,
+            grants: {...defaultGrants, update: alwaysDeny},
+          }),
+        ).toThrow(/permission to edit release/)
+      })
+    })
+
+    describe('fire-and-forget actions', () => {
+      const existing = createReleaseDoc()
+      const cases: Array<{
+        name: string
+        action: Action
+        expectedOutgoing: Record<string, unknown>
+      }> = [
+        {
+          name: 'release.publish',
+          action: {type: 'release.publish', releaseId: releaseName},
+          expectedOutgoing: {actionType: 'sanity.action.release.publish', releaseId: releaseName},
+        },
+        {
+          name: 'release.schedule',
+          action: {
+            type: 'release.schedule',
+            releaseId: releaseName,
+            publishAt: '2026-01-01T00:00:00.000Z',
+          },
+          expectedOutgoing: {
+            actionType: 'sanity.action.release.schedule',
+            releaseId: releaseName,
+            publishAt: '2026-01-01T00:00:00.000Z',
+          },
+        },
+        {
+          name: 'release.unschedule',
+          action: {type: 'release.unschedule', releaseId: releaseName},
+          expectedOutgoing: {
+            actionType: 'sanity.action.release.unschedule',
+            releaseId: releaseName,
+          },
+        },
+        {
+          name: 'release.archive',
+          action: {type: 'release.archive', releaseId: releaseName},
+          expectedOutgoing: {actionType: 'sanity.action.release.archive', releaseId: releaseName},
+        },
+        {
+          name: 'release.unarchive',
+          action: {type: 'release.unarchive', releaseId: releaseName},
+          expectedOutgoing: {actionType: 'sanity.action.release.unarchive', releaseId: releaseName},
+        },
+      ]
+
+      it.each(cases)(
+        '$name does not mutate local state and emits the matching outgoing action',
+        ({action, expectedOutgoing}) => {
+          const base: DocumentSet = {[releaseDocId]: existing}
+          const working: DocumentSet = {[releaseDocId]: existing}
+
+          const result = processActions({
+            actions: [action],
+            transactionId,
+            base,
+            working,
+            timestamp,
+            grants: defaultGrants,
+          })
+
+          // working and base reference the same doc instance — no optimistic
+          // mutation was applied
+          expect(result.working[releaseDocId]).toBe(existing)
+          expect(result.outgoingActions).toEqual([expectedOutgoing])
+          expect(result.outgoingMutations).toEqual([])
+        },
+      )
+
+      it.each(cases)('$name throws if the release does not exist', ({action}) => {
+        expect(() =>
+          processActions({
+            actions: [action],
+            transactionId,
+            base: {},
+            working: {},
+            timestamp,
+            grants: defaultGrants,
+          }),
+        ).toThrow(ActionError)
+      })
+
+      it.each(cases)(
+        '$name throws PermissionActionError when update grant is denied',
+        ({action}) => {
+          const base: DocumentSet = {[releaseDocId]: existing}
+          const working: DocumentSet = {[releaseDocId]: existing}
+          expect(() =>
+            processActions({
+              actions: [action],
+              transactionId,
+              base,
+              working,
+              timestamp,
+              grants: {...defaultGrants, update: alwaysDeny},
+            }),
+          ).toThrow(/permission to/)
+        },
+      )
+    })
+
+    describe('release.schedule publishAt validation', () => {
+      const existing = createReleaseDoc()
+
+      it.each(['not-a-date', '', '2026-13-40T99:99:99Z'])(
+        'throws ActionError when publishAt is not a valid timestamp (%s)',
+        (publishAt) => {
+          expect(() =>
+            processActions({
+              actions: [{type: 'release.schedule', releaseId: releaseName, publishAt}],
+              transactionId,
+              base: {[releaseDocId]: existing},
+              working: {[releaseDocId]: existing},
+              timestamp,
+              grants: defaultGrants,
+            }),
+          ).toThrow(/must be a valid ISO 8601 timestamp/)
+        },
+      )
+    })
+
+    describe('release.delete', () => {
+      it.each(['archived', 'published'] as const)(
+        'optimistically removes the local release when state is %s',
+        (state) => {
+          const existing = createReleaseDoc({state} as Partial<SanityDocument>)
+          const result = processActions({
+            actions: [{type: 'release.delete', releaseId: releaseName}],
+            transactionId,
+            base: {[releaseDocId]: existing},
+            working: {[releaseDocId]: existing},
+            timestamp,
+            grants: defaultGrants,
+          })
+
+          // processMutations sets deleted entries to null
+          expect(result.working[releaseDocId]).toBeNull()
+          expect(result.outgoingMutations).toEqual([{delete: {id: releaseDocId}}])
+          expect(result.outgoingActions).toEqual([
+            {actionType: 'sanity.action.release.delete', releaseId: releaseName},
+          ])
+        },
+      )
+
+      it.each(['active', 'scheduled', 'archiving', 'publishing'] as const)(
+        'throws when state is %s (server only accepts archived/published)',
+        (state) => {
+          const existing = createReleaseDoc({state} as Partial<SanityDocument>)
+          expect(() =>
+            processActions({
+              actions: [{type: 'release.delete', releaseId: releaseName}],
+              transactionId,
+              base: {[releaseDocId]: existing},
+              working: {[releaseDocId]: existing},
+              timestamp,
+              grants: defaultGrants,
+            }),
+          ).toThrow(/Archive it first/)
+        },
+      )
+
+      it('throws if the release does not exist', () => {
+        expect(() =>
+          processActions({
+            actions: [{type: 'release.delete', releaseId: releaseName}],
+            transactionId,
+            base: {},
+            working: {},
+            timestamp,
+            grants: defaultGrants,
+          }),
+        ).toThrow(/does not exist/)
+      })
+
+      it('throws PermissionActionError when the update grant is denied', () => {
+        const existing = createReleaseDoc({state: 'archived'} as Partial<SanityDocument>)
+        expect(() =>
+          processActions({
+            actions: [{type: 'release.delete', releaseId: releaseName}],
+            transactionId,
+            base: {[releaseDocId]: existing},
+            working: {[releaseDocId]: existing},
+            timestamp,
+            grants: {...defaultGrants, update: alwaysDeny},
+          }),
+        ).toThrow(/permission to delete release/)
+      })
+    })
+
+    describe('mixed with liveEdit document actions', () => {
+      const liveEditDocId = 'live-edit-doc'
+      const liveEditDoc = {
+        _id: liveEditDocId,
+        _type: 'liveEditType',
+        _createdAt: '2025-01-01T00:00:00.000Z',
+        _updatedAt: '2025-01-01T00:00:00.000Z',
+        _rev: 'initial',
+      }
+      const liveEditAction = {
+        type: 'document.edit',
+        documentId: liveEditDocId,
+        documentType: 'liveEditType',
+        liveEdit: true,
+        patches: [{set: {title: 'x'}}],
+      } as const
+
+      it('throws ActionError when a transaction mixes a release action with a liveEdit document action', () => {
+        expect(() =>
+          processActions({
+            actions: [
+              {
+                type: 'release.create',
+                releaseId: releaseName,
+                metadata: {releaseType: 'undecided'},
+              },
+              liveEditAction as unknown as Action,
+            ],
+            transactionId,
+            base: {[liveEditDocId]: liveEditDoc},
+            working: {[liveEditDocId]: liveEditDoc},
+            timestamp,
+            grants: defaultGrants,
+          }),
+        ).toThrow(/Cannot combine liveEdit document actions with other actions/)
+      })
+
+      it('throws ActionError when a transaction mixes a non-liveEdit document action with a liveEdit document action', () => {
+        const otherDocId = 'other-doc'
+        const otherDoc = {
+          _id: otherDocId,
+          _type: 'someType',
+          _createdAt: '2025-01-01T00:00:00.000Z',
+          _updatedAt: '2025-01-01T00:00:00.000Z',
+          _rev: 'initial',
+        } as SanityDocument
+
+        expect(() =>
+          processActions({
+            actions: [
+              {
+                type: 'document.edit',
+                documentId: otherDocId,
+                documentType: 'someType',
+                patches: [{set: {title: 'y'}}],
+              },
+              liveEditAction as unknown as Action,
+            ],
+            transactionId,
+            base: {[liveEditDocId]: liveEditDoc, [otherDocId]: otherDoc},
+            working: {[liveEditDocId]: liveEditDoc, [otherDocId]: otherDoc},
+            timestamp,
+            grants: defaultGrants,
+          }),
+        ).toThrow(/Cannot combine liveEdit document actions with other actions/)
+      })
+    })
+  })
 })