@sanity-labs/client-fake-for-test 0.7.0 → 0.8.0

package/dist/index.cjs

@@ -73,57 +73,6 @@ function makeRequestImpl(getAccess, projectId, dataset) {
     );
   };
 }
-function createTestStore(initial) {
-  const docs = /* @__PURE__ */ new Map(), promote2 = (doc) => {
-    if (typeof doc._id != "string" || doc._id.length === 0)
-      throw fakeError(
-        `Cannot seed/store a document without a non-empty string \`_id\` (got ${JSON.stringify(doc._id)}). This fake never auto-generates ids \u2014 give every document an explicit _id. Document: ${JSON.stringify(doc)}`
-      );
-    if (typeof doc._type != "string" || doc._type.length === 0)
-      throw fakeError(
-        `Document "${doc._id}" is missing a non-empty string \`_type\` (got ${JSON.stringify(doc._type)}). Every Sanity document needs a _type.`
-      );
-    const now = (/* @__PURE__ */ new Date()).toISOString();
-    return {
-      ...doc,
-      _id: doc._id,
-      _type: doc._type,
-      _rev: doc._rev ?? cryptoRandomKey(),
-      _createdAt: doc._createdAt ?? now,
-      _updatedAt: doc._updatedAt ?? now
-    };
-  }, seed = (documents) => {
-    docs.clear();
-    for (const d of documents) {
-      const promoted = promote2(d);
-      docs.set(promoted._id, promoted);
-    }
-  };
-  return initial && seed(initial), {
-    seed,
-    add: (documents) => {
-      for (const d of documents) {
-        const promoted = promote2(d);
-        docs.set(promoted._id, promoted);
-      }
-    },
-    reset: () => docs.clear(),
-    all: () => [...docs.values()],
-    get: (id) => docs.get(id),
-    put: (doc) => {
-      docs.set(doc._id, doc);
-    },
-    remove: (id) => {
-      const doc = docs.get(id);
-      return doc && docs.delete(id), doc;
-    },
-    snapshot: () => [...docs.values()]
-  };
-}
-function cryptoRandomKey(length = 12) {
-  const bytes = new Uint8Array(length);
-  return globalThis.crypto.getRandomValues(bytes), [...bytes].map((b) => b.toString(16).padStart(2, "0")).join("").slice(0, length);
-}
 function describeType(value) {
   return value === null ? "null" : Array.isArray(value) ? "an array" : `a ${typeof value}`;
 }
@@ -326,13 +275,140 @@ function insertIntoArray(doc, position, anchor, items) {
   const idx = resolveSelector(arr, last.selector);
   position === "replace" ? arr.splice(idx, 1, ...items) : position === "before" ? arr.splice(idx, 0, ...items) : arr.splice(idx + 1, 0, ...items);
 }
-const RELEASE_DOC_PREFIX$1 = "_.releases.", VERSIONS_PREFIX$1 = "versions.", releaseDocId = (releaseId) => `${RELEASE_DOC_PREFIX$1}${releaseId}`, versionDocId = (releaseId, publishedId) => `${VERSIONS_PREFIX$1}${releaseId}.${publishedId}`;
+const DRAFTS_PREFIX = "drafts.", VERSIONS_PREFIX$1 = "versions.", RELEASE_DOC_PREFIX$1 = "_.releases.";
+function publishedIdOf(id) {
+  if (id.startsWith(DRAFTS_PREFIX)) return id.slice(DRAFTS_PREFIX.length);
+  if (id.startsWith(VERSIONS_PREFIX$1)) {
+    const rest = id.slice(VERSIONS_PREFIX$1.length), dot = rest.indexOf(".");
+    return dot === -1 ? rest : rest.slice(dot + 1);
+  }
+  return id;
+}
+function releaseNameOf(id) {
+  if (!id.startsWith(VERSIONS_PREFIX$1)) return;
+  const rest = id.slice(VERSIONS_PREFIX$1.length), dot = rest.indexOf(".");
+  if (dot !== -1)
+    return rest.slice(0, dot);
+}
+const isDraftId = (id) => id.startsWith(DRAFTS_PREFIX), isVersionId = (id) => id.startsWith(VERSIONS_PREFIX$1), isSystemId = (id) => id.startsWith("_."), isReleaseDocId = (id) => id.startsWith(RELEASE_DOC_PREFIX$1);
+function applyPerspective(docs, perspective) {
+  if (perspective === "raw") return [...docs];
+  if (perspective === "published")
+    return docs.filter((d) => !isDraftId(d._id) && !isVersionId(d._id) && !isSystemId(d._id));
+  if (perspective === "drafts")
+    return mergeStack(docs, [], { includeDrafts: !0, includeReleaseDocs: !1 });
+  const stack = [];
+  let includeDrafts = !1;
+  for (const entry of perspective)
+    entry === "drafts" ? includeDrafts = !0 : stack.push(entry);
+  return mergeStack(docs, stack, { includeDrafts, includeReleaseDocs: !0 });
+}
+function mergeStack(docs, releaseStack, options) {
+  const groups = /* @__PURE__ */ new Map(), systemReleases = [];
+  for (const doc of docs) {
+    if (isReleaseDocId(doc._id)) {
+      options.includeReleaseDocs && systemReleases.push(doc);
+      continue;
+    }
+    if (isSystemId(doc._id)) continue;
+    const pubId = publishedIdOf(doc._id);
+    let group = groups.get(pubId);
+    if (group === void 0 && (group = { versions: /* @__PURE__ */ new Map() }, groups.set(pubId, group)), isDraftId(doc._id))
+      group.draft = doc;
+    else if (isVersionId(doc._id)) {
+      const releaseName = releaseNameOf(doc._id);
+      releaseName !== void 0 && group.versions.set(releaseName, doc);
+    } else
+      group.published = doc;
+  }
+  const out = [];
+  for (const [pubId, group] of groups) {
+    let chosen;
+    for (const releaseName of releaseStack) {
+      const v = group.versions.get(releaseName);
+      if (v !== void 0) {
+        if (isUnpublishStub(v)) {
+          chosen = void 0;
+          break;
+        }
+        chosen = v;
+        break;
+      }
+    }
+    chosen === void 0 && options.includeDrafts && group.draft !== void 0 && (chosen = group.draft), chosen === void 0 && group.published !== void 0 && (releaseStack.some((name) => {
+      const v = group.versions.get(name);
+      return v !== void 0 && isUnpublishStub(v);
+    }) || (chosen = group.published)), chosen !== void 0 && out.push(projectToPublishedId(chosen, pubId));
+  }
+  return [...out, ...systemReleases];
+}
+function isUnpublishStub(doc) {
+  return doc._system?.delete === !0;
+}
+function projectToPublishedId(doc, pubId) {
+  return doc._id === pubId ? doc : { ...doc, _id: pubId, _originalId: doc._id };
+}
+function resolveDocument(docs, id, perspective) {
+  return perspective === "raw" ? docs.find((d) => d._id === id) : applyPerspective(docs, perspective).find((d) => d._id === id);
+}
+function createTestStore(initial) {
+  const docs = /* @__PURE__ */ new Map(), promote2 = (doc) => {
+    if (typeof doc._id != "string" || doc._id.length === 0)
+      throw fakeError(
+        `Cannot seed/store a document without a non-empty string \`_id\` (got ${JSON.stringify(doc._id)}). This fake never auto-generates ids \u2014 give every document an explicit _id. Document: ${JSON.stringify(doc)}`
+      );
+    if (typeof doc._type != "string" || doc._type.length === 0)
+      throw fakeError(
+        `Document "${doc._id}" is missing a non-empty string \`_type\` (got ${JSON.stringify(doc._type)}). Every Sanity document needs a _type.`
+      );
+    const now = (/* @__PURE__ */ new Date()).toISOString();
+    return {
+      ...doc,
+      _id: doc._id,
+      _type: doc._type,
+      _rev: doc._rev ?? cryptoRandomKey(),
+      _createdAt: doc._createdAt ?? now,
+      _updatedAt: doc._updatedAt ?? now
+    };
+  }, seed = (documents) => {
+    docs.clear();
+    for (const d of documents) {
+      const promoted = promote2(d);
+      docs.set(promoted._id, promoted);
+    }
+  };
+  return initial && seed(initial), {
+    seed,
+    add: (documents) => {
+      for (const d of documents) {
+        const promoted = promote2(d);
+        docs.set(promoted._id, promoted);
+      }
+    },
+    reset: () => docs.clear(),
+    all: () => [...docs.values()],
+    get: (id) => docs.get(id),
+    put: (doc) => {
+      docs.set(doc._id, doc);
+    },
+    remove: (id) => {
+      const doc = docs.get(id);
+      return doc && docs.delete(id), doc;
+    },
+    snapshot: () => [...docs.values()]
+  };
+}
+function cryptoRandomKey(length = 12) {
+  const bytes = new Uint8Array(length);
+  return globalThis.crypto.getRandomValues(bytes), [...bytes].map((b) => b.toString(16).padStart(2, "0")).join("").slice(0, length);
+}
+const RELEASE_DOC_PREFIX = "_.releases.", VERSIONS_PREFIX = "versions.", releaseDocId = (releaseId) => `${RELEASE_DOC_PREFIX}${releaseId}`, versionDocId = (releaseId, publishedId) => `${VERSIONS_PREFIX}${releaseId}.${publishedId}`;
 function parseVersionId(versionId) {
-  if (!versionId.startsWith(VERSIONS_PREFIX$1))
+  if (!versionId.startsWith(VERSIONS_PREFIX))
     throw fakeError(
       `"${versionId}" is not a version document id. Version ids look like "versions.<releaseId>.<publishedId>" (e.g. "versions.summer-drop.product-1").`
     );
-  const rest = versionId.slice(VERSIONS_PREFIX$1.length), dot = rest.indexOf(".");
+  const rest = versionId.slice(VERSIONS_PREFIX.length), dot = rest.indexOf(".");
   if (dot === -1)
     throw fakeError(
       `"${versionId}" is not a version document id. Version ids look like "versions.<releaseId>.<publishedId>" (e.g. "versions.summer-drop.product-1").`
@@ -378,7 +454,7 @@ function requireActive(release) {
       `Release "${release.name}" is "${release.state}", but only "active" releases accept version writes (create / replace / discard / unpublish). Unschedule or unarchive it back to "active" first, or target a different release.`
     );
 }
-function applyAction(store, action) {
+async function applyAction(store, action, hooks) {
   switch (action.actionType) {
     case "sanity.action.release.create": {
       if (maybeRelease(store, action.releaseId) !== void 0)
@@ -436,7 +512,7 @@ function applyAction(store, action) {
         throw fakeError(
           `Cannot publish release "${action.releaseId}": it is "${release.state}", and only "active" or "scheduled" releases can be published.`
         );
-      const prefix = `${VERSIONS_PREFIX$1}${action.releaseId}.`, sources = store.all().filter((d) => d._id.startsWith(prefix));
+      const prefix = `${VERSIONS_PREFIX}${action.releaseId}.`, sources = store.all().filter((d) => d._id.startsWith(prefix));
       for (const v of sources) {
         const pubId = v._id.slice(prefix.length);
         if (v._system?.delete === !0)
@@ -476,7 +552,7 @@ function applyAction(store, action) {
         throw fakeError(
           `Cannot delete release "${action.releaseId}": it is "${release.state}", and only "archived" or "published" releases can be deleted. Archive it first (sanity.action.release.archive) or publish it.`
         );
-      const prefix = `${VERSIONS_PREFIX$1}${action.releaseId}.`;
+      const prefix = `${VERSIONS_PREFIX}${action.releaseId}.`;
       for (const v of store.all())
         v._id.startsWith(prefix) && store.remove(v._id);
       return store.remove(release._id), { transactionId: cryptoRandomKey() };
@@ -520,9 +596,46 @@ function applyAction(store, action) {
       };
       return store.put(promote(doc)), { transactionId: cryptoRandomKey() };
     }
+    case "sanity.action.document.publish": {
+      requireDraftOf(action);
+      const draft = store.get(action.draftId);
+      if (draft === void 0)
+        throw fakeError(
+          `Cannot publish "${action.publishedId}": draft "${action.draftId}" not found. document.publish promotes an existing draft onto the published id \u2014 create the draft first (e.g. client.createOrReplace({ _id: "${action.draftId}", ... })).`
+        );
+      const published = store.get(action.publishedId);
+      requireRevisionMatch(action.draftId, draft._rev, action.ifDraftRevisionId), requireRevisionMatch(action.publishedId, published?._rev, action.ifPublishedRevisionId);
+      const promoted = promote({ ...draft, _id: action.publishedId });
+      return published !== void 0 && (promoted._createdAt = published._createdAt), await hooks?.gate?.(promoted, published === void 0 ? "create" : "update"), await hooks?.guard?.("publish", published ?? null, promoted), store.put(promoted), store.remove(action.draftId), { transactionId: cryptoRandomKey() };
+    }
+    case "sanity.action.document.unpublish": {
+      requireDraftOf(action);
+      const published = store.get(action.publishedId);
+      if (published === void 0)
+        throw fakeError(
+          `Cannot unpublish "${action.publishedId}": no published document with that _id exists. document.unpublish retracts a live published document into "${action.draftId}".`
+        );
+      if (await hooks?.gate?.(published, "update"), await hooks?.guard?.("unpublish", published, null), store.get(action.draftId) === void 0) {
+        const draft = promote({ ...published, _id: action.draftId });
+        draft._createdAt = published._createdAt, store.put(draft);
+      }
+      return store.remove(action.publishedId), { transactionId: cryptoRandomKey() };
+    }
   }
 }
-function applyActions(store, actions) {
+function requireDraftOf(action) {
+  if (!(publishedIdOf(action.draftId) === action.publishedId && action.draftId !== action.publishedId))
+    throw fakeError(
+      `${action.actionType}: draftId "${action.draftId}" is not the draft of publishedId "${action.publishedId}" \u2014 expected draftId "drafts.${action.publishedId}".`
+    );
+}
+function requireRevisionMatch(documentId, actualRev, expectedRev) {
+  if (!(expectedRev === void 0 || actualRev === expectedRev))
+    throw fakeError(
+      `Revision precondition failed for "${documentId}": expected _rev "${expectedRev}" but the document is at ${actualRev === void 0 ? "no revision (missing)" : `"${actualRev}"`}.`
+    );
+}
+async function applyActions(store, actions, hooks) {
   const list = Array.isArray(actions) ? actions : [actions], snapshot = /* @__PURE__ */ new Map(), remember = (id) => {
     snapshot.has(id) || snapshot.set(id, store.get(id));
   };
@@ -537,11 +650,11 @@ function applyActions(store, actions) {
         case "sanity.action.release.archive":
         case "sanity.action.release.unarchive":
         case "sanity.action.release.delete":
-          remember(`${RELEASE_DOC_PREFIX$1}${a.releaseId}`);
+          remember(`${RELEASE_DOC_PREFIX}${a.releaseId}`);
           break;
         case "sanity.action.release.publish": {
-          remember(`${RELEASE_DOC_PREFIX$1}${a.releaseId}`);
-          const prefix = `${VERSIONS_PREFIX$1}${a.releaseId}.`;
+          remember(`${RELEASE_DOC_PREFIX}${a.releaseId}`);
+          const prefix = `${VERSIONS_PREFIX}${a.releaseId}.`;
           for (const d of store.all())
             d._id.startsWith(prefix) && (remember(d._id), remember(d._id.slice(prefix.length)));
           break;
@@ -558,8 +671,12 @@ function applyActions(store, actions) {
         case "sanity.action.document.version.unpublish":
           remember(a.versionId);
           break;
+        case "sanity.action.document.publish":
+        case "sanity.action.document.unpublish":
+          remember(a.draftId), remember(a.publishedId);
+          break;
       }
-      last = applyAction(store, a);
+      last = await applyAction(store, a, hooks);
     }
     return last;
   } catch (err) {
@@ -568,82 +685,6 @@ function applyActions(store, actions) {
     throw err;
   }
 }
-const DRAFTS_PREFIX = "drafts.", VERSIONS_PREFIX = "versions.", RELEASE_DOC_PREFIX = "_.releases.";
-function publishedIdOf(id) {
-  if (id.startsWith(DRAFTS_PREFIX)) return id.slice(DRAFTS_PREFIX.length);
-  if (id.startsWith(VERSIONS_PREFIX)) {
-    const rest = id.slice(VERSIONS_PREFIX.length), dot = rest.indexOf(".");
-    return dot === -1 ? rest : rest.slice(dot + 1);
-  }
-  return id;
-}
-function releaseNameOf(id) {
-  if (!id.startsWith(VERSIONS_PREFIX)) return;
-  const rest = id.slice(VERSIONS_PREFIX.length), dot = rest.indexOf(".");
-  if (dot !== -1)
-    return rest.slice(0, dot);
-}
-const isDraftId = (id) => id.startsWith(DRAFTS_PREFIX), isVersionId = (id) => id.startsWith(VERSIONS_PREFIX), isSystemId = (id) => id.startsWith("_."), isReleaseDocId = (id) => id.startsWith(RELEASE_DOC_PREFIX);
-function applyPerspective(docs, perspective) {
-  if (perspective === "raw") return [...docs];
-  if (perspective === "published")
-    return docs.filter((d) => !isDraftId(d._id) && !isVersionId(d._id) && !isSystemId(d._id));
-  if (perspective === "drafts")
-    return mergeStack(docs, [], { includeDrafts: !0, includeReleaseDocs: !1 });
-  const stack = [];
-  let includeDrafts = !1;
-  for (const entry of perspective)
-    entry === "drafts" ? includeDrafts = !0 : stack.push(entry);
-  return mergeStack(docs, stack, { includeDrafts, includeReleaseDocs: !0 });
-}
-function mergeStack(docs, releaseStack, options) {
-  const groups = /* @__PURE__ */ new Map(), systemReleases = [];
-  for (const doc of docs) {
-    if (isReleaseDocId(doc._id)) {
-      options.includeReleaseDocs && systemReleases.push(doc);
-      continue;
-    }
-    if (isSystemId(doc._id)) continue;
-    const pubId = publishedIdOf(doc._id);
-    let group = groups.get(pubId);
-    if (group === void 0 && (group = { versions: /* @__PURE__ */ new Map() }, groups.set(pubId, group)), isDraftId(doc._id))
-      group.draft = doc;
-    else if (isVersionId(doc._id)) {
-      const releaseName = releaseNameOf(doc._id);
-      releaseName !== void 0 && group.versions.set(releaseName, doc);
-    } else
-      group.published = doc;
-  }
-  const out = [];
-  for (const [pubId, group] of groups) {
-    let chosen;
-    for (const releaseName of releaseStack) {
-      const v = group.versions.get(releaseName);
-      if (v !== void 0) {
-        if (isUnpublishStub(v)) {
-          chosen = void 0;
-          break;
-        }
-        chosen = v;
-        break;
-      }
-    }
-    chosen === void 0 && options.includeDrafts && group.draft !== void 0 && (chosen = group.draft), chosen === void 0 && group.published !== void 0 && (releaseStack.some((name) => {
-      const v = group.versions.get(name);
-      return v !== void 0 && isUnpublishStub(v);
-    }) || (chosen = group.published)), chosen !== void 0 && out.push(projectToPublishedId(chosen, pubId));
-  }
-  return [...out, ...systemReleases];
-}
-function isUnpublishStub(doc) {
-  return doc._system?.delete === !0;
-}
-function projectToPublishedId(doc, pubId) {
-  return doc._id === pubId ? doc : { ...doc, _id: pubId, _originalId: doc._id };
-}
-function resolveDocument(docs, id, perspective) {
-  return perspective === "raw" ? docs.find((d) => d._id === id) : applyPerspective(docs, perspective).find((d) => d._id === id);
-}
 function createTransaction(executor) {
   const mutations = [], handle = {
     create: (doc) => (mutations.push({ kind: "create", doc }), handle),
@@ -875,6 +916,15 @@ const RECORDED_METHODS = /* @__PURE__ */ new Set([
   "unpublishVersion",
   "request"
 ]), DEFAULT_PROJECT_ID = "test", DEFAULT_DATASET = "test";
+function serializeWrite(backend, run) {
+  const result = backend.writeChain.then(run);
+  return backend.writeChain = result.then(
+    () => {
+    },
+    () => {
+    }
+  ), result;
+}
 function requireIdentity(backend, token, site) {
   if (backend.identities.has(token)) return;
   const known = [...backend.identities.keys()];
@@ -899,7 +949,8 @@ function createTestClient(options = {}) {
     stubs: /* @__PURE__ */ new Map(),
     calls: [],
     concurrentEdits: /* @__PURE__ */ new Map(),
-    identities: new Map(Object.entries(options.identities ?? {}))
+    identities: new Map(Object.entries(options.identities ?? {})),
+    writeChain: Promise.resolve()
   }, registry = backend.registry;
   rejectAmbiguousIdentity("createTestClient()", options), options.token !== void 0 && requireIdentity(backend, options.token, "createTestClient()");
   const ensureStore = (projectId, dataset) => {
@@ -1128,7 +1179,7 @@ function makeHandle(backend, projectId, dataset, accessControl, perspective, mut
       txnOptions?.returnDocuments ?? !1,
       txnOptions?.returnFirst ?? !1
     );
-  }, accessVisibleDocs = async () => {
+  }, runAction = (actions) => serializeWrite(backend, async () => applyActions(store, actions, { gate, guard: guardGate })), accessVisibleDocs = async () => {
     const all = store.all();
     if (activeAccess() === void 0) return all;
     const out = [];
@@ -1172,7 +1223,7 @@ function makeHandle(backend, projectId, dataset, accessControl, perspective, mut
       const view = await visibleDocs(effective);
       return ids.map((id) => resolveDocument(view, id, effective) ?? null);
     },
-    create: async (doc, opts) => {
+    create: (doc, opts) => serializeWrite(backend, async () => {
       if (checkRevision(doc._id, opts?.ifRevisionId), store.get(doc._id) !== void 0)
         throw fakeError(
           `create() failed: a document with _id "${doc._id}" already exists in dataset "${projectId}:${dataset}". Use createOrReplace() to overwrite it, or createIfNotExists() to leave the existing one untouched.`
@@ -1186,8 +1237,8 @@ function makeHandle(backend, projectId, dataset, accessControl, perspective, mut
         transactionId,
         opts
       );
-    },
-    createOrReplace: async (doc, opts) => {
+    }),
+    createOrReplace: (doc, opts) => serializeWrite(backend, async () => {
       checkRevision(doc._id, opts?.ifRevisionId);
       const promoted = promote2(doc), existing = store.get(doc._id);
       await gate(existing ?? promoted, existing !== void 0 ? "update" : "create"), await guardGate(existing !== void 0 ? "update" : "create", existing ?? null, promoted);
@@ -1200,8 +1251,8 @@ function makeHandle(backend, projectId, dataset, accessControl, perspective, mut
         transactionId,
         opts
       );
-    },
-    createIfNotExists: async (doc, opts) => {
+    }),
+    createIfNotExists: (doc, opts) => serializeWrite(backend, async () => {
       checkRevision(doc._id, opts?.ifRevisionId);
       const existing = store.get(doc._id), transactionId = opts?.transactionId ?? cryptoRandomKey();
       if (existing !== void 0)
@@ -1218,8 +1269,8 @@ function makeHandle(backend, projectId, dataset, accessControl, perspective, mut
         transactionId,
         opts
       );
-    },
-    delete: async (id, opts) => {
+    }),
+    delete: (id, opts) => serializeWrite(backend, async () => {
       checkRevision(id, opts?.ifRevisionId);
       const existing = store.get(id);
       existing !== void 0 && await gate(existing, "update"), existing !== void 0 && await guardGate("delete", existing, null);
@@ -1232,23 +1283,35 @@ function makeHandle(backend, projectId, dataset, accessControl, perspective, mut
         opts.returnDocuments ?? !0,
         opts.returnFirst ?? !0
       );
-    },
+    }),
     patch: (documentId) => createPatch(documentId, {
-      apply: async (docId, ops, ifRev, options) => {
+      apply: (docId, ops, ifRev, options) => serializeWrite(backend, async () => {
         const doc = await applyPatch(docId, ops, ifRev);
         return record(
           cryptoRandomKey(),
-          [{ kind: "patch", documentId: docId, ops, ...ifRev !== void 0 ? { ifRev } : {} }],
+          [
+            {
+              kind: "patch",
+              documentId: docId,
+              ops,
+              ...ifRev !== void 0 ? { ifRev } : {}
+            }
+          ],
           options?.tag
         ), doc;
-      }
+      })
+    }),
+    transaction: () => createTransaction({
+      apply: (mutations, txnOptions) => serializeWrite(backend, () => applyTransaction(mutations, txnOptions))
     }),
-    transaction: () => createTransaction({ apply: applyTransaction }),
-    mutate: async (operations, options) => applyTransaction(toTxnMutations(operations), options),
-    action: async (action) => applyActions(store, action),
+    mutate: (operations, options) => serializeWrite(backend, () => applyTransaction(toTxnMutations(operations), options)),
+    // Synchronous writes still take the lock: an action landing while a
+    // guarded patch is parked in its gate would otherwise be clobbered
+    // when that patch resumes over its pre-action snapshot.
+    action: (action) => runAction(action),
     releases: {
       create: async ({ releaseId, metadata }) => {
-        const result = applyActions(store, {
+        const result = await runAction({
           actionType: "sanity.action.release.create",
           releaseId,
           ...metadata !== void 0 ? { metadata } : {}
@@ -1259,30 +1322,30 @@ function makeHandle(backend, projectId, dataset, accessControl, perspective, mut
           metadata: doc?.metadata ?? { releaseType: "undecided" }
         };
       },
-      edit: async ({ releaseId, patch }) => applyActions(store, { actionType: "sanity.action.release.edit", releaseId, patch }),
+      edit: ({ releaseId, patch }) => runAction({ actionType: "sanity.action.release.edit", releaseId, patch }),
       get: async ({ releaseId }) => store.get(`_.releases.${releaseId}`),
       fetchDocuments: async ({ releaseId }) => {
         const prefix = `versions.${releaseId}.`;
         return store.all().filter((d) => d._id.startsWith(prefix));
       },
-      schedule: async ({ releaseId, publishAt }) => applyActions(store, {
+      schedule: ({ releaseId, publishAt }) => runAction({
         actionType: "sanity.action.release.schedule",
         releaseId,
         publishAt
       }),
-      unschedule: async ({ releaseId }) => applyActions(store, { actionType: "sanity.action.release.unschedule", releaseId }),
-      publish: async ({ releaseId }) => applyActions(store, { actionType: "sanity.action.release.publish", releaseId }),
-      archive: async ({ releaseId }) => applyActions(store, { actionType: "sanity.action.release.archive", releaseId }),
-      unarchive: async ({ releaseId }) => applyActions(store, { actionType: "sanity.action.release.unarchive", releaseId }),
-      delete: async ({ releaseId }) => applyActions(store, { actionType: "sanity.action.release.delete", releaseId })
+      unschedule: ({ releaseId }) => runAction({ actionType: "sanity.action.release.unschedule", releaseId }),
+      publish: ({ releaseId }) => runAction({ actionType: "sanity.action.release.publish", releaseId }),
+      archive: ({ releaseId }) => runAction({ actionType: "sanity.action.release.archive", releaseId }),
+      unarchive: ({ releaseId }) => runAction({ actionType: "sanity.action.release.unarchive", releaseId }),
+      delete: ({ releaseId }) => runAction({ actionType: "sanity.action.release.delete", releaseId })
     },
-    createVersion: async ({ releaseId, publishedId, document }) => applyActions(store, {
+    createVersion: ({ releaseId, publishedId, document }) => runAction({
       actionType: "sanity.action.document.version.create",
       releaseId,
       publishedId,
       document
     }),
-    unpublishVersion: async ({ releaseId, publishedId }) => applyActions(store, {
+    unpublishVersion: ({ releaseId, publishedId }) => runAction({
       actionType: "sanity.action.document.version.unpublish",
       versionId: `versions.${releaseId}.${publishedId}`,
       publishedId