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

package/dist/index.d.cts

@@ -1,4 +1,4 @@
-export declare type Action = ReleaseAction | VersionAction;
+export declare type Action = ReleaseAction | VersionAction | DocumentAction;
 
 /** Options for `action()`. Only `tag` is meaningful to the fake. */
 export declare interface ActionOptions {
@@ -202,6 +202,26 @@ export declare function defaultAclPath(
   dataset: string,
 ): string;
 
+/**
+ * Draft↔published document actions — `sanity.action.document.publish`
+ * promotes the draft onto the published id (and deletes the draft);
+ * `sanity.action.document.unpublish` retracts the published document into a
+ * draft (keeping an existing draft untouched) and deletes the published one.
+ */
+export declare type DocumentAction =
+  | {
+      actionType: "sanity.action.document.publish";
+      draftId: string;
+      publishedId: string;
+      ifDraftRevisionId?: string;
+      ifPublishedRevisionId?: string;
+    }
+  | {
+      actionType: "sanity.action.document.unpublish";
+      draftId: string;
+      publishedId: string;
+    };
+
 /**
  * Document body accepted by `version.create` / `createVersion`. The id
  * is derived from `releaseId + publishedId` so callers may omit `_id`
@@ -387,11 +407,13 @@ export declare interface MultipleMutationResult {
  * A pluggable write interceptor, configured via
  * `createTestClient({ mutationGuard })`. It runs on each write through the
  * document mutation API — `create` / `createOrReplace` / `createIfNotExists` /
- * `patch` / `delete` and the equivalent `transaction()` operations — before the
- * store changes; **throw to reject the write** (the throw propagates out of the
- * client call, exactly as a real lake rejection would). The release/version
- * action API (`client.action`, `client.releases.*`, `createVersion`) is **not**
- * intercepted.
+ * `patch` / `delete` and the equivalent `transaction()` operations — and on the
+ * document publish/unpublish actions (`sanity.action.document.publish` /
+ * `.unpublish` via `client.action`) — before the store changes; **throw to
+ * reject the write** (the throw propagates out of the client call, exactly as
+ * a real lake rejection would). The release/version action API
+ * (`client.releases.*`, `createVersion`, the `sanity.action.release.*` and
+ * `*.version.*` action types) is **not** intercepted.
  *
  * The client itself has no opinion about *what* a guard is — it only provides
  * the seam and the before/after/identity context. Callers (e.g. a workflow test
@@ -404,13 +426,21 @@ export declare type MutationGuard = (
 ) => void | Promise<void>;
 
 /** The kind of write a {@link MutationGuard} is asked to vet. */
-export declare type MutationGuardAction = "create" | "update" | "delete";
+export declare type MutationGuardAction =
+  | "create"
+  | "update"
+  | "delete"
+  | "publish"
+  | "unpublish";
 
 /**
  * The before/after image of a single document write, handed to a
  * {@link MutationGuard} before it is applied.
  *
- * - `before` is null on create; `after` is null on delete.
+ * - `before` is null on create and on a publish with no live published
+ *   document; `after` is null on delete and unpublish.
+ * - On publish/unpublish both images are of the *published* document —
+ *   `after` on publish is the draft's content promoted onto the published id.
  * - `identity` is the acting user — the id bound to the client's token
  *   (its `accessControl.currentUser`), or undefined when the client has no
  *   identity configured.
@@ -789,9 +819,11 @@ export declare interface TestClient {
     options?: TxnCommitOptions,
   ) => Promise<TxnCommitResult>;
   /**
-   * Dispatch one or more release / version actions against the store.
-   * Returns a synthetic `transactionId`. Multi-action arrays are applied
-   * atomically — any failure rolls back the batch.
+   * Dispatch one or more release / version / document actions against the
+   * store. Returns a synthetic `transactionId`. Multi-action arrays are
+   * applied atomically — any failure rolls back the batch. The document
+   * publish/unpublish actions run through the access gate and the
+   * `mutationGuard` seam; release/version actions apply unhooked.
    */
   action: (
     action: Action | Action[],

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-export declare type Action = ReleaseAction | VersionAction;
+export declare type Action = ReleaseAction | VersionAction | DocumentAction;
 
 /** Options for `action()`. Only `tag` is meaningful to the fake. */
 export declare interface ActionOptions {
@@ -202,6 +202,26 @@ export declare function defaultAclPath(
   dataset: string,
 ): string;
 
+/**
+ * Draft↔published document actions — `sanity.action.document.publish`
+ * promotes the draft onto the published id (and deletes the draft);
+ * `sanity.action.document.unpublish` retracts the published document into a
+ * draft (keeping an existing draft untouched) and deletes the published one.
+ */
+export declare type DocumentAction =
+  | {
+      actionType: "sanity.action.document.publish";
+      draftId: string;
+      publishedId: string;
+      ifDraftRevisionId?: string;
+      ifPublishedRevisionId?: string;
+    }
+  | {
+      actionType: "sanity.action.document.unpublish";
+      draftId: string;
+      publishedId: string;
+    };
+
 /**
  * Document body accepted by `version.create` / `createVersion`. The id
  * is derived from `releaseId + publishedId` so callers may omit `_id`
@@ -387,11 +407,13 @@ export declare interface MultipleMutationResult {
  * A pluggable write interceptor, configured via
  * `createTestClient({ mutationGuard })`. It runs on each write through the
  * document mutation API — `create` / `createOrReplace` / `createIfNotExists` /
- * `patch` / `delete` and the equivalent `transaction()` operations — before the
- * store changes; **throw to reject the write** (the throw propagates out of the
- * client call, exactly as a real lake rejection would). The release/version
- * action API (`client.action`, `client.releases.*`, `createVersion`) is **not**
- * intercepted.
+ * `patch` / `delete` and the equivalent `transaction()` operations — and on the
+ * document publish/unpublish actions (`sanity.action.document.publish` /
+ * `.unpublish` via `client.action`) — before the store changes; **throw to
+ * reject the write** (the throw propagates out of the client call, exactly as
+ * a real lake rejection would). The release/version action API
+ * (`client.releases.*`, `createVersion`, the `sanity.action.release.*` and
+ * `*.version.*` action types) is **not** intercepted.
  *
  * The client itself has no opinion about *what* a guard is — it only provides
  * the seam and the before/after/identity context. Callers (e.g. a workflow test
@@ -404,13 +426,21 @@ export declare type MutationGuard = (
 ) => void | Promise<void>;
 
 /** The kind of write a {@link MutationGuard} is asked to vet. */
-export declare type MutationGuardAction = "create" | "update" | "delete";
+export declare type MutationGuardAction =
+  | "create"
+  | "update"
+  | "delete"
+  | "publish"
+  | "unpublish";
 
 /**
  * The before/after image of a single document write, handed to a
  * {@link MutationGuard} before it is applied.
  *
- * - `before` is null on create; `after` is null on delete.
+ * - `before` is null on create and on a publish with no live published
+ *   document; `after` is null on delete and unpublish.
+ * - On publish/unpublish both images are of the *published* document —
+ *   `after` on publish is the draft's content promoted onto the published id.
  * - `identity` is the acting user — the id bound to the client's token
  *   (its `accessControl.currentUser`), or undefined when the client has no
  *   identity configured.
@@ -789,9 +819,11 @@ export declare interface TestClient {
     options?: TxnCommitOptions,
   ) => Promise<TxnCommitResult>;
   /**
-   * Dispatch one or more release / version actions against the store.
-   * Returns a synthetic `transactionId`. Multi-action arrays are applied
-   * atomically — any failure rolls back the batch.
+   * Dispatch one or more release / version / document actions against the
+   * store. Returns a synthetic `transactionId`. Multi-action arrays are
+   * applied atomically — any failure rolls back the batch. The document
+   * publish/unpublish actions run through the access gate and the
+   * `mutationGuard` seam; release/version actions apply unhooked.
    */
   action: (
     action: Action | Action[],

package/dist/index.js

@@ -71,57 +71,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}`;
 }
@@ -324,13 +273,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").`
@@ -376,7 +452,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)
@@ -434,7 +510,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)
@@ -474,7 +550,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() };
@@ -518,9 +594,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));
   };
@@ -535,11 +648,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;
@@ -556,8 +669,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) {
@@ -566,82 +683,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),
@@ -1136,7 +1177,7 @@ function makeHandle(backend, projectId, dataset, accessControl, perspective, mut
       txnOptions?.returnDocuments ?? !1,
       txnOptions?.returnFirst ?? !1
     );
-  }, runAction = (actions) => serializeWrite(backend, async () => applyActions(store, actions)), 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 = [];