@sanity/sdk 2.11.1 → 2.13.0

package/dist/index.js

@@ -1,6 +1,6 @@
-import { switchMap, from, firstValueFrom, EMPTY, asapScheduler, distinctUntilChanged, map as map$1, combineLatest, of, concatMap, withLatestFrom, filter as filter$1, concat, timer, throwError, first as first$1, Subject, takeUntil, share, partition, merge, shareReplay, tap as tap$1, catchError as catchError$1, startWith as startWith$1, pairwise as pairwise$1, groupBy as groupBy$1, mergeMap as mergeMap$1, throttle, race, skip, Observable, NEVER, fromEvent, Subscription, debounceTime, defer } from "rxjs";
-import { createLogger, pickProperties, insecureRandomId, getClientState, bindActionGlobally, createStateSourceAction, setCleanupTimeout, omitProperty, defineStore, authStore, AuthStateType, getCleanedUrl, getTokenFromLocation, createLoggedInAuthState, getAuthCode, REQUEST_TAG_PREFIX, DEFAULT_API_VERSION, getDefaultLocation, isDeepEqual, configureLogging as configureLogging$1, isReleasePerspective, bindActionByResource, isDatasetResource, isMediaLibraryResource, isCanvasResource, getUsersKey, addSubscription, parseUsersKey, getClient, PROJECT_API_VERSION, setUsersError, setUsersData, API_VERSION as API_VERSION$8, getDashboardOrganizationId as getDashboardOrganizationId$1, USERS_STATE_CLEAR_DELAY, removeSubscription, updateLastLoadMoreRequest, cancelRequest, initializeRequest, getTokenState, getQueryState, resolveQuery, bindActionByResourceAndPerspective, PREVIEW_PROJECTION, transformProjectionToPreview } from "./_chunks-es/createGroqSearchFilter.js";
-import { createGroqSearchFilter, getActiveReleasesState, getAuthState, getClientErrorApiBody, getClientErrorApiDescription, getClientErrorApiType, getCurrentUserState, getIsInDashboardState, getLoginUrlState, getPerspectiveState, getQueryKey, isCanvasSource, isDatasetSource, isMediaLibrarySource, isProjectUserNotFoundClientError, isStudioConfig, parseQueryKey, setAuthToken } from "./_chunks-es/createGroqSearchFilter.js";
+import { switchMap, from, firstValueFrom, EMPTY, asapScheduler, distinctUntilChanged, map as map$1, combineLatest, of, concatMap, withLatestFrom, filter as filter$1, concat, timer, throwError, first as first$1, Subject, takeUntil, share, partition, merge, shareReplay, tap as tap$1, catchError as catchError$1, startWith as startWith$1, pairwise as pairwise$1, groupBy as groupBy$1, mergeMap as mergeMap$1, retry, throttle, race, skip, Observable, NEVER, fromEvent, Subscription, debounceTime, defer } from "rxjs";
+import { createLogger, pickProperties, insecureRandomId, getClientState, bindActionGlobally, createStateSourceAction, setCleanupTimeout, omitProperty, defineStore, authStore, AuthStateType, getCleanedUrl, getTokenFromLocation, createLoggedInAuthState, getAuthCode, REQUEST_TAG_PREFIX, DEFAULT_API_VERSION, getDefaultLocation, isDeepEqual, configureLogging as configureLogging$1, isReleasePerspective, bindActionByResource, isDatasetResource, isMediaLibraryResource, isCanvasResource, getCurrentUserState, getUsersKey, addSubscription, parseUsersKey, getClient, PROJECT_API_VERSION, setUsersError, setUsersData, API_VERSION as API_VERSION$8, getDashboardOrganizationId as getDashboardOrganizationId$1, USERS_STATE_CLEAR_DELAY, removeSubscription, updateLastLoadMoreRequest, cancelRequest, initializeRequest, getTokenState, getQueryState, resolveQuery, bindActionByResourceAndPerspective, PREVIEW_PROJECTION, transformProjectionToPreview } from "./_chunks-es/createGroqSearchFilter.js";
+import { createGroqSearchFilter, getActiveReleasesState, getAllReleasesState, getAuthState, getClientErrorApiBody, getClientErrorApiDescription, getClientErrorApiType, getIsInDashboardState, getLoginUrlState, getPerspectiveState, getQueryKey, isCanvasSource, isDatasetSource, isMediaLibrarySource, isProjectUserNotFoundClientError, isStudioConfig, parseQueryKey, setAuthToken } from "./_chunks-es/createGroqSearchFilter.js";
 import { first, switchMap as switchMap$1, groupBy, mergeMap, startWith, pairwise, filter, map, delay, tap, catchError, scan, share as share$1 } from "rxjs/operators";
 import { createController, createNode } from "@sanity/comlink";
 import { createSelector } from "reselect";
@@ -519,7 +519,7 @@ const handleAuthCallback = bindActionGlobally(
       status: nodeEntry.status
     } : void 0),
     onSubscribe: ({ state, instance }, nodeInput) => {
-      const nodeName = nodeInput.name, subscriberId = Symbol("comlink-node-subscriber");
+      const nodeName = nodeInput.name, subscriberId = /* @__PURE__ */ Symbol("comlink-node-subscriber");
       getOrCreateNode(instance, nodeInput);
       let subs = state.get().subscriptions.get(nodeName);
       return subs || (subs = /* @__PURE__ */ new Set(), state.get().subscriptions.set(nodeName, subs)), subs.add(subscriberId), () => {
@@ -642,7 +642,47 @@ function discardDocument(doc) {
     documentId: effectiveDocumentId
   };
 }
-const DOCUMENT_STATE_CLEAR_DELAY = 1e3, INITIAL_OUTGOING_THROTTLE_TIME = 1e3, API_VERSION$4 = "v2025-05-06";
+function createRelease(handle, metadata = { releaseType: "undecided" }) {
+  return { type: "release.create", ...handle, metadata };
+}
+function editRelease(handle, patch) {
+  return { type: "release.edit", ...handle, patch };
+}
+function publishRelease(handle) {
+  return { type: "release.publish", ...handle };
+}
+function scheduleRelease(handle, publishAt) {
+  return { type: "release.schedule", ...handle, publishAt };
+}
+function unscheduleRelease(handle) {
+  return { type: "release.unschedule", ...handle };
+}
+function archiveRelease(handle) {
+  return { type: "release.archive", ...handle };
+}
+function unarchiveRelease(handle) {
+  return { type: "release.unarchive", ...handle };
+}
+function deleteRelease(handle) {
+  return { type: "release.delete", ...handle };
+}
+const DOCUMENT_STATE_CLEAR_DELAY = 1e3, INITIAL_OUTGOING_THROTTLE_TIME = 1e3, API_VERSION$4 = "v2025-05-06", OUT_OF_SYNC_RETRY_BASE_DELAY = 500, OUT_OF_SYNC_RETRY_MAX_DELAY = 1e4, RELEASE_DOCUMENTS_PATH = "_.releases";
+function getReleaseDocumentId(releaseId) {
+  return `${RELEASE_DOCUMENTS_PATH}.${releaseId}`;
+}
+const RELEASE_ACTION_TYPES = /* @__PURE__ */ new Set([
+  "release.create",
+  "release.edit",
+  "release.publish",
+  "release.schedule",
+  "release.unschedule",
+  "release.archive",
+  "release.unarchive",
+  "release.delete"
+]);
+function isReleaseAction(action) {
+  return RELEASE_ACTION_TYPES.has(action.type);
+}
 function generateArrayKey(length = 12) {
   const numBytes = Math.ceil(length / 2), bytes = crypto.getRandomValues(new Uint8Array(numBytes));
   return Array.from(bytes, (byte) => byte.toString(16).padStart(2, "0")).join("").slice(0, length);
@@ -1146,6 +1186,52 @@ class MultiKeyWeakMap {
     this.#setDeep(arrangedKeys, this.#rootMap, value);
   }
 }
+function checkGrant(grantExpr, document, identity) {
+  const value = evaluateSync(grantExpr, { params: { document }, identity });
+  return value.type === "boolean" && value.data;
+}
+class ActionError extends Error {
+  documentId;
+  transactionId;
+  constructor(options) {
+    super(options.message), Object.assign(this, options);
+  }
+}
+class PermissionActionError extends ActionError {
+}
+function applySingleDocPatch({
+  base: initialBase,
+  working: initialWorking,
+  documentId,
+  patches,
+  transactionId,
+  timestamp,
+  grants,
+  identity,
+  notFoundMessage = "Cannot edit document because it does not exist.",
+  permissionMessage = `You do not have permission to edit document "${documentId}".`
+}) {
+  let base = initialBase, working = initialWorking;
+  const userPatches = patches?.map((patch) => ({ patch: { id: documentId, ...patch } }));
+  if (!userPatches?.length)
+    return { base, working, diffedPatches: [], workingMutations: [] };
+  if (!working[documentId] || !base[documentId])
+    throw new ActionError({ documentId, transactionId, message: notFoundMessage });
+  const baseBefore = base[documentId];
+  base = processMutations({ documents: base, transactionId, mutations: userPatches, timestamp });
+  const baseAfter = base[documentId], diffedPatches = diffValue(baseBefore, baseAfter), workingBefore = working[documentId];
+  if (!checkGrant(grants.update, workingBefore, identity))
+    throw new PermissionActionError({ documentId, transactionId, message: permissionMessage });
+  const workingMutations = diffedPatches.map((patch) => ({
+    patch: { id: documentId, ...patch }
+  }));
+  return working = processMutations({
+    documents: working,
+    transactionId,
+    mutations: workingMutations,
+    timestamp
+  }), { base, working, diffedPatches, workingMutations };
+}
 function createGrantsLookup(datasetAcl) {
   const filtersByGrant = {
     create: /* @__PURE__ */ new Set(),
@@ -1156,7 +1242,7 @@ function createGrantsLookup(datasetAcl) {
   for (const entry of datasetAcl)
     for (const grant of entry.permissions) {
       const set2 = filtersByGrant[grant];
-      set2.add(entry.filter), filtersByGrant[grant] = set2;
+      set2 && (set2.add(entry.filter), filtersByGrant[grant] = set2);
     }
   return Object.fromEntries(
     Object.entries(filtersByGrant).map(([grant, filters]) => {
@@ -1206,22 +1292,18 @@ const documentsCache = new MultiKeyWeakMap(), actionsCache = /* @__PURE__ */ new
     const normalizedActions = Array.isArray(actions) ? actions : [actions], actionsKey = JSON.stringify(normalizedActions);
     return nestedCache.get(actionsKey) || (nestedCache.set(actionsKey, normalizedActions), normalizedActions);
   }
-);
-function checkGrant$1(grantExpr, document) {
-  const value = evaluateSync(grantExpr, { params: { document } });
-  return value.type === "boolean" && value.data;
-}
-const enNarrowConjunction = new Intl.ListFormat("en", { style: "narrow", type: "conjunction" });
+), enNarrowConjunction = new Intl.ListFormat("en", { style: "narrow", type: "conjunction" });
 function calculatePermissions(...args) {
   return _calculatePermissions(...args);
 }
 const _calculatePermissions = createSelector(
   [
     ({ state: { grants } }) => grants,
+    ({ state: { identity } }) => identity,
     documentsSelector,
     memoizedActionsSelector
   ],
-  (grants, documents, actions) => {
+  (grants, identity, documents, actions) => {
     if (!documents || !grants || !actions) return;
     const timestamp = (/* @__PURE__ */ new Date()).toISOString(), reasons = [];
     try {
@@ -1231,7 +1313,8 @@ const _calculatePermissions = createSelector(
         working: documents,
         base: documents,
         timestamp,
-        grants
+        grants,
+        identity
       });
     } catch (error) {
       if (error instanceof PermissionActionError)
@@ -1253,7 +1336,7 @@ const _calculatePermissions = createSelector(
       if (action.type === "document.edit" && !action.patches?.length) {
         const docId = action.documentId;
         let doc;
-        action.liveEdit ? doc = documents[docId] : isReleasePerspective(action.perspective) ? doc = documents[getVersionId(DocumentId(docId), action.perspective.releaseName)] : doc = documents[getDraftId(DocumentId(docId))] ?? documents[getPublishedId(DocumentId(docId))], doc ? checkGrant$1(grants.update, doc) || reasons.push({
+        action.liveEdit ? doc = documents[docId] : isReleasePerspective(action.perspective) ? doc = documents[getVersionId(DocumentId(docId), action.perspective.releaseName)] : doc = documents[getDraftId(DocumentId(docId))] ?? documents[getPublishedId(DocumentId(docId))], doc ? checkGrant(grants.update, doc, identity) || reasons.push({
           type: "access",
           message: `You are not allowed to edit the document with ID "${docId}".`,
           documentId: docId
@@ -1277,21 +1360,8 @@ const _calculatePermissions = createSelector(
     };
   }
 );
-function checkGrant(grantExpr, document) {
-  const value = evaluateSync(grantExpr, { params: { document } });
-  return value.type === "boolean" && value.data;
-}
-class ActionError extends Error {
-  documentId;
-  transactionId;
-  constructor(options) {
-    super(options.message), Object.assign(this, options);
-  }
-}
-class PermissionActionError extends ActionError {
-}
 function handleCreate(action, ctx) {
-  const { transactionId, timestamp, grants, outgoingActions, outgoingMutations } = ctx;
+  const { transactionId, timestamp, grants, identity, outgoingActions, outgoingMutations } = ctx;
   let { base, working } = ctx;
   const documentId = getId(action.documentId);
   if (action.liveEdit) {
@@ -1316,7 +1386,7 @@ function handleCreate(action, ctx) {
       transactionId,
       mutations: mutations2,
       timestamp
-    }), !checkGrant(grants.create, working[documentId]))
+    }), !checkGrant(grants.create, working[documentId], identity))
       throw new PermissionActionError({
         documentId,
         transactionId,
@@ -1354,13 +1424,13 @@ function handleCreate(action, ctx) {
     transactionId,
     mutations,
     timestamp
-  }), versionId && !checkGrant(grants.create, working[versionId]))
+  }), versionId && !checkGrant(grants.create, working[versionId], identity))
     throw new PermissionActionError({
       documentId,
       transactionId,
       message: `You do not have permission to create a release version for document "${documentId}".`
     });
-  if (!versionId && !checkGrant(grants.create, working[draftId]))
+  if (!versionId && !checkGrant(grants.create, working[draftId], identity))
     throw new PermissionActionError({
       documentId,
       transactionId,
@@ -1373,7 +1443,7 @@ function handleCreate(action, ctx) {
   }), { base, working };
 }
 function handleDelete(action, ctx) {
-  const { transactionId, timestamp, grants, outgoingActions, outgoingMutations } = ctx;
+  const { transactionId, timestamp, grants, identity, outgoingActions, outgoingMutations } = ctx;
   let { base, working } = ctx;
   const documentId = action.documentId;
   if (isReleasePerspective(action.perspective))
@@ -1389,7 +1459,7 @@ function handleDelete(action, ctx) {
         transactionId,
         message: "The document you are trying to delete does not exist."
       });
-    if (!checkGrant(grants.update, working[documentId]))
+    if (!checkGrant(grants.update, working[documentId], identity))
       throw new PermissionActionError({
         documentId,
         transactionId,
@@ -1405,7 +1475,7 @@ function handleDelete(action, ctx) {
       transactionId,
       message: working[draftId] ? "Cannot delete a document without a published version." : "The document you are trying to delete does not exist."
     });
-  const cantDeleteDraft = working[draftId] && !checkGrant(grants.update, working[draftId]), cantDeletePublished = working[publishedId] && !checkGrant(grants.update, working[publishedId]);
+  const cantDeleteDraft = working[draftId] && !checkGrant(grants.update, working[draftId], identity), cantDeletePublished = working[publishedId] && !checkGrant(grants.update, working[publishedId], identity);
   if (cantDeleteDraft || cantDeletePublished)
     throw new PermissionActionError({
       documentId,
@@ -1420,7 +1490,7 @@ function handleDelete(action, ctx) {
   }), { base, working };
 }
 function handleDiscard(action, ctx) {
-  const { transactionId, timestamp, grants, outgoingActions, outgoingMutations } = ctx;
+  const { transactionId, timestamp, grants, identity, outgoingActions, outgoingMutations } = ctx;
   let { base, working } = ctx;
   const documentId = getId(action.documentId);
   if (action.liveEdit)
@@ -1436,7 +1506,7 @@ function handleDiscard(action, ctx) {
       transactionId,
       message: `There is no draft or version available to discard for document "${documentId}".`
     });
-  if (!checkGrant(grants.update, working[versionId]))
+  if (!checkGrant(grants.update, working[versionId], identity))
     throw new PermissionActionError({
       documentId,
       transactionId,
@@ -1448,39 +1518,21 @@ function handleDiscard(action, ctx) {
   }), { base, working };
 }
 function handleEdit(action, ctx) {
-  const { transactionId, timestamp, grants, outgoingActions, outgoingMutations } = ctx;
+  const { transactionId, timestamp, grants, identity, outgoingActions, outgoingMutations } = ctx;
   let { base, working } = ctx;
   const documentId = getId(action.documentId);
   if (action.liveEdit) {
-    const userPatches2 = action.patches?.map((patch) => ({ patch: { id: documentId, ...patch } }));
-    if (!userPatches2?.length) return { base, working };
-    if (!working[documentId] || !base[documentId])
-      throw new ActionError({
-        documentId,
-        transactionId,
-        message: "Cannot edit document because it does not exist."
-      });
-    const baseBefore2 = base[documentId];
-    userPatches2 && (base = processMutations({
-      documents: base,
-      transactionId,
-      mutations: userPatches2,
-      timestamp
-    }));
-    const baseAfter2 = base[documentId], patches2 = diffValue(baseBefore2, baseAfter2), workingBefore2 = working[documentId];
-    if (!checkGrant(grants.update, workingBefore2))
-      throw new PermissionActionError({
-        documentId,
-        transactionId,
-        message: `You do not have permission to edit document "${documentId}".`
-      });
-    const workingMutations2 = patches2.map((patch) => ({ patch: { id: documentId, ...patch } }));
-    return working = processMutations({
-      documents: working,
+    const result = applySingleDocPatch({
+      base,
+      working,
+      documentId,
+      patches: action.patches,
       transactionId,
-      mutations: workingMutations2,
-      timestamp
-    }), outgoingMutations.push(...workingMutations2), { base, working };
+      timestamp,
+      grants,
+      identity
+    });
+    return outgoingMutations.push(...result.workingMutations), { base: result.base, working: result.working };
   }
   const versionId = isReleasePerspective(action.perspective) ? getVersionId(DocumentId(documentId), action.perspective.releaseName) : void 0, draftId = getDraftId(DocumentId(documentId)), publishedId = getPublishedId(DocumentId(documentId)), patchDocumentId = isReleasePerspective(action.perspective) ? versionId : draftId, userPatches = action.patches?.map((patch) => ({
     patch: { id: patchDocumentId, ...patch }
@@ -1511,7 +1563,7 @@ function handleEdit(action, ctx) {
   const baseAfter = base[patchDocumentId], patches = diffValue(baseBefore, baseAfter), workingMutations = [];
   if (!isReleasePerspective(action.perspective) && !working[draftId] && working[publishedId]) {
     const newDraftFromPublished = { ...working[publishedId], _id: draftId };
-    if (!checkGrant(grants.create, newDraftFromPublished))
+    if (!checkGrant(grants.create, newDraftFromPublished, identity))
       throw new PermissionActionError({
         documentId,
         transactionId,
@@ -1520,7 +1572,7 @@ function handleEdit(action, ctx) {
     workingMutations.push({ create: newDraftFromPublished });
   }
   const workingBefore = working[patchDocumentId] ?? working[publishedId];
-  if (!checkGrant(grants.update, workingBefore))
+  if (!checkGrant(grants.update, workingBefore, identity))
     throw new PermissionActionError({
       documentId,
       transactionId,
@@ -1541,7 +1593,7 @@ function handleEdit(action, ctx) {
   ), { base, working };
 }
 function handlePublish(action, ctx) {
-  const { transactionId, timestamp, grants, outgoingActions, outgoingMutations } = ctx;
+  const { transactionId, timestamp, grants, identity, outgoingActions, outgoingMutations } = ctx;
   let { base, working } = ctx;
   const documentId = getId(action.documentId);
   if (action.liveEdit || isReleasePerspective(action.perspective))
@@ -1564,19 +1616,19 @@ function handlePublish(action, ctx) {
       message: "Publish aborted: The document has changed elsewhere. Please try again."
     });
   const newPublishedFromDraft = { ...strengthenOnPublish(workingDraft), _id: publishedId }, mutations = [{ delete: { id: draftId } }, { createOrReplace: newPublishedFromDraft }];
-  if (working[draftId] && !checkGrant(grants.update, working[draftId]))
+  if (working[draftId] && !checkGrant(grants.update, working[draftId], identity))
     throw new PermissionActionError({
       documentId,
       transactionId,
       message: `Publish failed: You do not have permission to update the draft for "${documentId}".`
     });
-  if (working[publishedId] && !checkGrant(grants.update, newPublishedFromDraft))
+  if (working[publishedId] && !checkGrant(grants.update, newPublishedFromDraft, identity))
     throw new PermissionActionError({
       documentId,
       transactionId,
       message: `Publish failed: You do not have permission to update the published version of "${documentId}".`
     });
-  if (!working[publishedId] && !checkGrant(grants.create, newPublishedFromDraft))
+  if (!working[publishedId] && !checkGrant(grants.create, newPublishedFromDraft, identity))
     throw new PermissionActionError({
       documentId,
       transactionId,
@@ -1603,8 +1655,191 @@ function strengthenOnPublish(draft) {
   }
   return strengthen(draft);
 }
+function handleReleaseArchive(action, ctx) {
+  const { base, working, grants, outgoingActions, transactionId, identity } = ctx, releaseDocumentId = getReleaseDocumentId(action.releaseId), existing = working[releaseDocumentId] ?? base[releaseDocumentId];
+  if (!existing)
+    throw new ActionError({
+      documentId: releaseDocumentId,
+      transactionId,
+      message: `Cannot archive release "${action.releaseId}" because it does not exist.`
+    });
+  if (!checkGrant(grants.update, existing, identity))
+    throw new PermissionActionError({
+      documentId: releaseDocumentId,
+      transactionId,
+      message: `You do not have permission to archive release "${action.releaseId}".`
+    });
+  return outgoingActions.push({
+    actionType: "sanity.action.release.archive",
+    releaseId: action.releaseId
+  }), { base, working };
+}
+function handleReleaseUnarchive(action, ctx) {
+  const { base, working, grants, outgoingActions, transactionId, identity } = ctx, releaseDocumentId = getReleaseDocumentId(action.releaseId), existing = working[releaseDocumentId] ?? base[releaseDocumentId];
+  if (!existing)
+    throw new ActionError({
+      documentId: releaseDocumentId,
+      transactionId,
+      message: `Cannot unarchive release "${action.releaseId}" because it does not exist.`
+    });
+  if (!checkGrant(grants.update, existing, identity))
+    throw new PermissionActionError({
+      documentId: releaseDocumentId,
+      transactionId,
+      message: `You do not have permission to unarchive release "${action.releaseId}".`
+    });
+  return outgoingActions.push({
+    actionType: "sanity.action.release.unarchive",
+    releaseId: action.releaseId
+  }), { base, working };
+}
+function handleReleaseCreate(action, ctx) {
+  const { transactionId, timestamp, grants, outgoingActions, outgoingMutations, identity } = ctx;
+  let { base, working } = ctx;
+  const releaseDocumentId = getReleaseDocumentId(action.releaseId);
+  if (working[releaseDocumentId] || base[releaseDocumentId])
+    throw new ActionError({
+      documentId: releaseDocumentId,
+      transactionId,
+      message: `A release with id "${action.releaseId}" already exists.`
+    });
+  const mutations = [{ create: {
+    _id: releaseDocumentId,
+    _type: "system.release",
+    name: action.releaseId,
+    state: "active",
+    metadata: action.metadata
+  } }];
+  if (base = processMutations({ documents: base, transactionId, mutations, timestamp }), working = processMutations({ documents: working, transactionId, mutations, timestamp }), !checkGrant(grants.create, working[releaseDocumentId], identity))
+    throw new PermissionActionError({
+      documentId: releaseDocumentId,
+      transactionId,
+      message: `You do not have permission to create release "${action.releaseId}".`
+    });
+  return outgoingMutations.push(...mutations), outgoingActions.push({
+    actionType: "sanity.action.release.create",
+    releaseId: action.releaseId,
+    metadata: action.metadata
+  }), { base, working };
+}
+const DELETABLE_STATES = /* @__PURE__ */ new Set(["archived", "published"]);
+function handleReleaseDelete(action, ctx) {
+  const { transactionId, timestamp, grants, outgoingActions, outgoingMutations, identity } = ctx;
+  let { base, working } = ctx;
+  const releaseDocumentId = getReleaseDocumentId(action.releaseId), existing = working[releaseDocumentId] ?? base[releaseDocumentId];
+  if (!existing)
+    throw new ActionError({
+      documentId: releaseDocumentId,
+      transactionId,
+      message: `Cannot delete release "${action.releaseId}" because it does not exist.`
+    });
+  const state = existing.state;
+  if (state && typeof state == "string" && !DELETABLE_STATES.has(state))
+    throw new ActionError({
+      documentId: releaseDocumentId,
+      transactionId,
+      message: `Cannot delete release "${action.releaseId}" while it is "${state}". Archive it first.`
+    });
+  if (!checkGrant(grants.update, existing, identity))
+    throw new PermissionActionError({
+      documentId: releaseDocumentId,
+      transactionId,
+      message: `You do not have permission to delete release "${action.releaseId}".`
+    });
+  const mutations = [{ delete: { id: releaseDocumentId } }];
+  return base = processMutations({ documents: base, transactionId, mutations, timestamp }), working = processMutations({ documents: working, transactionId, mutations, timestamp }), outgoingMutations.push(...mutations), outgoingActions.push({
+    actionType: "sanity.action.release.delete",
+    releaseId: action.releaseId
+  }), { base, working };
+}
+function handleReleaseEdit(action, ctx) {
+  const { transactionId, timestamp, grants, outgoingActions, outgoingMutations, identity } = ctx, { base, working } = ctx, releaseDocumentId = getReleaseDocumentId(action.releaseId), result = applySingleDocPatch({
+    base,
+    working,
+    documentId: releaseDocumentId,
+    patches: [action.patch],
+    transactionId,
+    timestamp,
+    grants,
+    identity,
+    notFoundMessage: `Cannot edit release "${action.releaseId}" because it does not exist.`,
+    permissionMessage: `You do not have permission to edit release "${action.releaseId}".`
+  });
+  return outgoingMutations.push(...result.workingMutations), outgoingActions.push(
+    ...result.diffedPatches.map((patch) => ({
+      actionType: "sanity.action.release.edit",
+      releaseId: action.releaseId,
+      patch
+    }))
+  ), { base: result.base, working: result.working };
+}
+function handleReleasePublish(action, ctx) {
+  const { base, working, grants, outgoingActions, transactionId, identity } = ctx, releaseDocumentId = getReleaseDocumentId(action.releaseId), existing = working[releaseDocumentId] ?? base[releaseDocumentId];
+  if (!existing)
+    throw new ActionError({
+      documentId: releaseDocumentId,
+      transactionId,
+      message: `Cannot publish release "${action.releaseId}" because it does not exist.`
+    });
+  if (!checkGrant(grants.update, existing, identity))
+    throw new PermissionActionError({
+      documentId: releaseDocumentId,
+      transactionId,
+      message: `You do not have permission to publish release "${action.releaseId}".`
+    });
+  return outgoingActions.push({
+    actionType: "sanity.action.release.publish",
+    releaseId: action.releaseId
+  }), { base, working };
+}
+function handleReleaseSchedule(action, ctx) {
+  const { base, working, grants, outgoingActions, transactionId, identity } = ctx, releaseDocumentId = getReleaseDocumentId(action.releaseId);
+  if (Number.isNaN(Date.parse(action.publishAt)))
+    throw new ActionError({
+      documentId: releaseDocumentId,
+      transactionId,
+      message: `Cannot schedule release "${action.releaseId}": "publishAt" must be a valid ISO 8601 timestamp (received "${action.publishAt}").`
+    });
+  const existing = working[releaseDocumentId] ?? base[releaseDocumentId];
+  if (!existing)
+    throw new ActionError({
+      documentId: releaseDocumentId,
+      transactionId,
+      message: `Cannot schedule release "${action.releaseId}" because it does not exist.`
+    });
+  if (!checkGrant(grants.update, existing, identity))
+    throw new PermissionActionError({
+      documentId: releaseDocumentId,
+      transactionId,
+      message: `You do not have permission to schedule release "${action.releaseId}".`
+    });
+  return outgoingActions.push({
+    actionType: "sanity.action.release.schedule",
+    releaseId: action.releaseId,
+    publishAt: action.publishAt
+  }), { base, working };
+}
+function handleReleaseUnschedule(action, ctx) {
+  const { base, working, grants, outgoingActions, transactionId, identity } = ctx, releaseDocumentId = getReleaseDocumentId(action.releaseId), existing = working[releaseDocumentId] ?? base[releaseDocumentId];
+  if (!existing)
+    throw new ActionError({
+      documentId: releaseDocumentId,
+      transactionId,
+      message: `Cannot unschedule release "${action.releaseId}" because it does not exist.`
+    });
+  if (!checkGrant(grants.update, existing, identity))
+    throw new PermissionActionError({
+      documentId: releaseDocumentId,
+      transactionId,
+      message: `You do not have permission to unschedule release "${action.releaseId}".`
+    });
+  return outgoingActions.push({
+    actionType: "sanity.action.release.unschedule",
+    releaseId: action.releaseId
+  }), { base, working };
+}
 function handleUnpublish(action, ctx) {
-  const { transactionId, timestamp, grants, outgoingActions, outgoingMutations } = ctx;
+  const { transactionId, timestamp, grants, identity, outgoingActions, outgoingMutations } = ctx;
   let { base, working } = ctx;
   const documentId = getId(action.documentId);
   if (action.liveEdit || isReleasePerspective(action.perspective))
@@ -1624,13 +1859,13 @@ function handleUnpublish(action, ctx) {
     { delete: { id: publishedId } },
     { createIfNotExists: newDraftFromPublished }
   ];
-  if (!checkGrant(grants.update, sourceDoc))
+  if (!checkGrant(grants.update, sourceDoc, identity))
     throw new PermissionActionError({
       documentId,
       transactionId,
       message: `You do not have permission to unpublish the document "${documentId}".`
     });
-  if (!working[draftId] && !checkGrant(grants.create, newDraftFromPublished))
+  if (!working[draftId] && !checkGrant(grants.create, newDraftFromPublished, identity))
     throw new PermissionActionError({
       documentId,
       transactionId,
@@ -1656,10 +1891,17 @@ function processActions({
   working: initialWorking,
   base: initialBase,
   timestamp,
-  grants
+  grants,
+  identity
 }) {
   let base = { ...initialBase }, working = { ...initialWorking };
-  const outgoingActions = [], outgoingMutations = [];
+  const outgoingActions = [], outgoingMutations = [], liveEditAction = actions.find((action) => !isReleaseAction(action) && action.liveEdit), otherAction = actions.find((action) => isReleaseAction(action) || !action.liveEdit);
+  if (liveEditAction && otherAction)
+    throw new ActionError({
+      documentId: liveEditAction.documentId,
+      transactionId,
+      message: "Cannot combine liveEdit document actions with other actions in the same transaction. Submit them as separate transactions."
+    });
   for (const action of actions) {
     const result = dispatch(action, {
       base,
@@ -1667,6 +1909,7 @@ function processActions({
       transactionId,
       timestamp,
       grants,
+      identity,
       outgoingActions,
       outgoingMutations
     });
@@ -1697,6 +1940,22 @@ function dispatch(action, ctx) {
       return handlePublish(action, ctx);
     case "document.unpublish":
       return handleUnpublish(action, ctx);
+    case "release.create":
+      return handleReleaseCreate(action, ctx);
+    case "release.edit":
+      return handleReleaseEdit(action, ctx);
+    case "release.publish":
+      return handleReleasePublish(action, ctx);
+    case "release.schedule":
+      return handleReleaseSchedule(action, ctx);
+    case "release.unschedule":
+      return handleReleaseUnschedule(action, ctx);
+    case "release.archive":
+      return handleReleaseArchive(action, ctx);
+    case "release.unarchive":
+      return handleReleaseUnarchive(action, ctx);
+    case "release.delete":
+      return handleReleaseDelete(action, ctx);
     default:
       throw new Error(
         `Unknown action type: "${// @ts-expect-error invalid input
@@ -1735,7 +1994,8 @@ function applyFirstQueuedTransaction(prev) {
     working,
     base: working,
     timestamp,
-    grants: prev.grants
+    grants: prev.grants,
+    identity: prev.identity
   }), applied = {
     ...queued,
     ...result,
@@ -1779,29 +2039,31 @@ function batchAppliedTransactions([curr, ...rest]) {
   };
   if (!rest.length) return editAction;
   const next = batchAppliedTransactions(rest);
-  if (next)
-    return next.disableBatching || !!action.liveEdit != !!next.actions[0]?.liveEdit ? editAction : {
-      disableBatching: !1,
-      // Use the transactionId from the later (next) transaction.
-      transactionId: next.transactionId,
-      // Accumulate actions: current action first, then later ones.
-      actions: [action, ...next.actions],
-      // Merge outgoingActions in order.
-      outgoingActions: [...curr.outgoingActions, ...next.outgoingActions],
-      // Batched transaction IDs: preserve order by placing curr first.
-      batchedTransactionIds: [curr.transactionId, ...next.batchedTransactionIds],
-      // Merge outgoingMutations in order.
-      outgoingMutations: [...curr.outgoingMutations, ...next.outgoingMutations],
-      // Working state reflects the latest optimistic changes: later transactions override earlier.
-      working: { ...curr.working, ...next.working },
-      // Base state (base, previous, previousRevs) must reflect the original state.
-      // Use curr values (the earliest transaction) to override later ones.
-      previousRevs: { ...next.previousRevs, ...curr.previousRevs },
-      previous: { ...next.previous, ...curr.previous },
-      base: { ...next.base, ...curr.base },
-      // Use the earliest timestamp from curr.
-      timestamp: curr.timestamp ?? next.timestamp
-    };
+  if (!next) return;
+  if (next.disableBatching) return editAction;
+  const nextFirst = next.actions[0], nextLiveEdit = nextFirst && "liveEdit" in nextFirst ? nextFirst.liveEdit : !1;
+  return !!action.liveEdit != !!nextLiveEdit ? editAction : {
+    disableBatching: !1,
+    // Use the transactionId from the later (next) transaction.
+    transactionId: next.transactionId,
+    // Accumulate actions: current action first, then later ones.
+    actions: [action, ...next.actions],
+    // Merge outgoingActions in order.
+    outgoingActions: [...curr.outgoingActions, ...next.outgoingActions],
+    // Batched transaction IDs: preserve order by placing curr first.
+    batchedTransactionIds: [curr.transactionId, ...next.batchedTransactionIds],
+    // Merge outgoingMutations in order.
+    outgoingMutations: [...curr.outgoingMutations, ...next.outgoingMutations],
+    // Working state reflects the latest optimistic changes: later transactions override earlier.
+    working: { ...curr.working, ...next.working },
+    // Base state (base, previous, previousRevs) must reflect the original state.
+    // Use curr values (the earliest transaction) to override later ones.
+    previousRevs: { ...next.previousRevs, ...curr.previousRevs },
+    previous: { ...next.previous, ...curr.previous },
+    base: { ...next.base, ...curr.base },
+    // Use the earliest timestamp from curr.
+    timestamp: curr.timestamp ?? next.timestamp
+  };
 }
 function transitionAppliedTransactionsToOutgoing(prev) {
   if (prev.outgoing) return prev;
@@ -1855,7 +2117,7 @@ function revertOutgoingTransaction(prev) {
   const nextApplied = [];
   for (const t of prev.applied)
     try {
-      const next = processActions({ ...t, working, grants: prev.grants });
+      const next = processActions({ ...t, working, grants: prev.grants, identity: prev.identity });
       working = next.working, nextApplied.push({ ...t, ...next });
     } catch (error) {
       if (error instanceof ActionError) continue;
@@ -1902,7 +2164,7 @@ function applyRemoteDocument(prev, { document, documentId, previousRev, revision
   const nextApplied = [];
   for (const curr of prev.applied)
     try {
-      const next = processActions({ ...curr, working, grants: prev.grants });
+      const next = processActions({ ...curr, working, grants: prev.grants, identity: prev.identity });
       working = next.working, nextApplied.push({ ...curr, ...next });
     } catch (error) {
       if (error instanceof ActionError) {
@@ -1978,32 +2240,43 @@ function manageSubscriberIds({ state }, handles) {
 }
 function getDocumentIdsFromHandleLikes(handles) {
   return handles.flatMap((handle) => {
+    if ("type" in handle && isReleaseAction(handle))
+      return [getReleaseDocumentId(handle.releaseId)];
     const idsForDocument = [];
     return handle.documentId ? handle.liveEdit ? [handle.documentId] : (isReleasePerspective(handle.perspective) && idsForDocument.push(
       getVersionId(DocumentId(handle.documentId), handle.perspective.releaseName)
     ), idsForDocument.push(getPublishedId(DocumentId(handle.documentId))), idsForDocument.push(getDraftId(DocumentId(handle.documentId))), idsForDocument) : [];
   });
 }
+const actionMap = {
+  "document.create": "created",
+  "document.delete": "deleted",
+  "document.discard": "discarded",
+  "document.edit": "edited",
+  "document.publish": "published",
+  "document.unpublish": "unpublished",
+  "release.create": "created",
+  "release.edit": "edited",
+  "release.delete": "deleted"
+};
 function getDocumentEvents(outgoing) {
-  const documentIdsByAction = Object.entries(
-    outgoing.actions.reduce(
-      (acc, { type, documentId }) => {
-        const ids = acc[type] || /* @__PURE__ */ new Set();
-        return documentId && ids.add(documentId), acc[type] = ids, acc;
-      },
-      {}
-    )
-  ), actionMap = {
-    "document.create": "created",
-    "document.delete": "deleted",
-    "document.discard": "discarded",
-    "document.edit": "edited",
-    "document.publish": "published",
-    "document.unpublish": "unpublished"
-  };
-  return documentIdsByAction.flatMap(
-    ([actionType, documentIds]) => Array.from(documentIds).map(
-      (documentId) => ({ type: actionMap[actionType], documentId, outgoing })
+  const documentIdsByAction = outgoing.actions.reduce(
+    (acc, action) => {
+      if (!(action.type in actionMap)) return acc;
+      const documentId = isReleaseAction(action) ? getReleaseDocumentId(action.releaseId) : action.documentId;
+      if (!documentId) return acc;
+      const type = action.type, ids = acc[type] ?? /* @__PURE__ */ new Set();
+      return ids.add(documentId), acc[type] = ids, acc;
+    },
+    {}
+  );
+  return Object.entries(documentIdsByAction).flatMap(
+    ([actionType, documentIds]) => Array.from(documentIds ?? []).map(
+      (documentId) => ({
+        type: actionMap[actionType],
+        documentId,
+        outgoing
+      })
     )
   );
 }
@@ -2079,7 +2352,8 @@ const documentStore = defineStore({
       subscribeToQueuedAndApplyNextTransaction(context),
       subscribeToSubscriptionsAndListenToDocuments(context),
       subscribeToAppliedAndSubmitNextTransaction(context),
-      subscribeToClientAndFetchDatasetAcl(context)
+      subscribeToClientAndFetchDatasetAcl(context),
+      subscribeToCurrentUserAndSetIdentity(context)
     ];
     return () => {
       sharedListener.dispose(), subscriptions.forEach((subscription) => subscription.unsubscribe());
@@ -2227,7 +2501,7 @@ const _resolveDocument = bindActionByResource(
         result,
         outgoing
       }));
-      return outgoing.actions.some((action) => action.liveEdit) ? client.observable.mutate(outgoing.outgoingMutations, {
+      return outgoing.actions.some((action) => !isReleaseAction(action) && action.liveEdit) ? client.observable.mutate(outgoing.outgoingMutations, {
         transactionId: outgoing.transactionId,
         visibility: "async",
         returnDocuments: !1,
@@ -2272,8 +2546,15 @@ const _resolveDocument = bindActionByResource(
     mergeMap$1(
       (group) => group.pipe(
         switchMap((e) => e.add ? listen(context, e.id).pipe(
-          catchError$1((error) => {
-            throw error instanceof OutOfSyncError && listen(context, e.id), error;
+          retry({
+            delay: (error, retryCount) => {
+              if (!(error instanceof OutOfSyncError)) return throwError(() => error);
+              const backoff = Math.min(
+                OUT_OF_SYNC_RETRY_BASE_DELAY * 2 ** (retryCount - 1),
+                OUT_OF_SYNC_RETRY_MAX_DELAY
+              );
+              return timer(backoff);
+            }
           }),
           tap$1(
             (remote) => state.set(
@@ -2312,15 +2593,58 @@ const _resolveDocument = bindActionByResource(
   ).subscribe({
     error: (error) => state.set("setError", { error })
   });
-};
+}, subscribeToCurrentUserAndSetIdentity = ({
+  instance,
+  state
+}) => getCurrentUserState(instance).observable.subscribe({
+  next: (currentUser) => state.set("setIdentity", { identity: currentUser?.id }),
+  // A transient identity-fetch failure (network blip, expired token, or a
+  // normal logout/re-login transition) should not brick all document
+  // operations. Reset the identity to `undefined` and keep going — GROQ's
+  // `identity()` then evaluates to null, matching the unauthenticated state.
+  error: () => state.set("setIdentity", { identity: void 0 })
+}), MEDIA_LIBRARY_DRAFTED_TYPES = /* @__PURE__ */ new Set(["sanity.asset"]);
+function getEffectiveDocumentModel(resource, documentType) {
+  return resource ? isCanvasResource(resource) ? { liveEdit: !0, supportsReleases: !1 } : isMediaLibraryResource(resource) ? { liveEdit: !(documentType && MEDIA_LIBRARY_DRAFTED_TYPES.has(documentType)), supportsReleases: !1 } : { liveEdit: void 0, supportsReleases: !0 } : { liveEdit: void 0, supportsReleases: !0 };
+}
+function describeResource(resource) {
+  return resource && isCanvasResource(resource) ? "Canvas" : resource && isMediaLibraryResource(resource) ? "Media Library" : "this resource";
+}
+function normalizeActionsForResource(actions, resource) {
+  const stripped = [], normalized = actions.map((action) => {
+    if (action.type !== "document.edit") return action;
+    const { liveEdit: forcedLiveEdit, supportsReleases } = getEffectiveDocumentModel(
+      resource,
+      action.documentType
+    ), shouldRemovePerspective = isReleasePerspective(action.perspective) && !supportsReleases, shouldForceLiveEdit = forcedLiveEdit === !0 && !action.liveEdit;
+    if (!shouldRemovePerspective && !shouldForceLiveEdit) return action;
+    const corrected = { ...action };
+    return shouldForceLiveEdit && (corrected.liveEdit = !0), shouldRemovePerspective && (corrected.perspective = void 0), corrected.documentId = getEffectiveDocumentId({
+      ...corrected,
+      documentId: getPublishedId(DocumentId(corrected.documentId))
+    }), shouldRemovePerspective && stripped.push({ documentType: action.documentType, documentId: corrected.documentId }), corrected;
+  });
+  if (stripped.length > 0) {
+    const docs = stripped.map((e) => `${e.documentType} (${e.documentId})`).join(", ");
+    console.warn(
+      `[sanity-sdk] ${describeResource(resource)} does not support release perspectives \u2014 falling back to the standard editing path for: ${docs}`
+    );
+  }
+  return normalized;
+}
 function applyDocumentActions(...args) {
   return boundApplyDocumentActions(...args);
 }
 const boundApplyDocumentActions = bindActionByResource(documentStore, _applyDocumentActions);
-async function _applyDocumentActions({ state }, { actions, transactionId = crypto.randomUUID(), disableBatching }) {
-  const { events } = state.get(), transaction = {
+async function _applyDocumentActions({ state }, {
+  actions,
+  resource,
+  transactionId = crypto.randomUUID(),
+  disableBatching
+}) {
+  const { events } = state.get(), normalizedActions = normalizeActionsForResource(actions, resource), transaction = {
     transactionId,
-    actions,
+    actions: normalizedActions,
     ...disableBatching && { disableBatching }
   }, fatalError$ = state.observable.pipe(
     map$1((s) => s.error),
@@ -3270,6 +3594,7 @@ export {
   agentTransform,
   agentTranslate,
   applyDocumentActions,
+  archiveRelease,
   configureLogging,
   createDatasetHandle,
   createDocument,
@@ -3277,13 +3602,17 @@ export {
   createDocumentTypeHandle,
   createGroqSearchFilter,
   createProjectHandle,
+  createRelease,
   createSanityInstance,
   defineIntent,
   deleteDocument,
+  deleteRelease,
   destroyController,
   discardDocument,
   editDocument,
+  editRelease,
   getActiveReleasesState,
+  getAllReleasesState,
   getAuthState,
   getClient,
   getClientErrorApiBody,
@@ -3316,6 +3645,7 @@ export {
   getProjectsState,
   getQueryKey,
   getQueryState,
+  getReleaseDocumentId,
   getTokenState,
   getUserState,
   getUsersKey,
@@ -3338,6 +3668,7 @@ export {
   parseQueryKey,
   parseUsersKey,
   publishDocument,
+  publishRelease,
   releaseChannel,
   releaseNode,
   resolveDatasets,
@@ -3353,11 +3684,14 @@ export {
   resolveQuery,
   resolveUser,
   resolveUsers,
+  scheduleRelease,
   setAuthToken,
   slicePath2 as slicePath,
   stringifyPath2 as stringifyPath,
   subscribeDocumentEvents,
   transformProjectionToPreview,
-  unpublishDocument
+  unarchiveRelease,
+  unpublishDocument,
+  unscheduleRelease
 };
 //# sourceMappingURL=index.js.map