@sanity/sdk 2.3.1 → 2.5.0

package/dist/index.js

@@ -1,8 +1,8 @@
-import { createClient, CorsOriginError } from "@sanity/client";
 import { Observable, share, map, distinctUntilChanged, skip, filter, exhaustMap, from, timer, switchMap, takeWhile, firstValueFrom, fromEvent, EMPTY, defer, asapScheduler, combineLatest, of, concatMap, withLatestFrom, concat, throwError, first as first$1, Subject, takeUntil, 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, NEVER, Subscription, retry, debounceTime as debounceTime$1 } from "rxjs";
+import { createClient, CorsOriginError } from "@sanity/client";
+import { pick, omit, isEqual, isObject } from "lodash-es";
 import { devtools } from "zustand/middleware";
 import { createStore } from "zustand/vanilla";
-import { pick, omit, isEqual, isObject } from "lodash-es";
 import { first, switchMap as switchMap$1, groupBy, mergeMap, startWith, pairwise, filter as filter$1, map as map$1, delay, tap, catchError, scan, share as share$1, take, debounceTime } from "rxjs/operators";
 import { createController, createNode } from "@sanity/comlink";
 import { createSelector } from "reselect";
@@ -17,7 +17,16 @@ import { isKeySegment, isKeyedObject } from "@sanity/types";
 import { createDocumentLoaderFromClient } from "@sanity/mutate/_unstable_store";
 import { SDK_CHANNEL_NAME, SDK_NODE_NAME } from "@sanity/message-protocol";
 import { fromUrl } from "@sanity/bifur-client";
-var AuthStateType = /* @__PURE__ */ ((AuthStateType2) => (AuthStateType2.LOGGED_IN = "logged-in", AuthStateType2.LOGGING_IN = "logging-in", AuthStateType2.ERROR = "error", AuthStateType2.LOGGED_OUT = "logged-out", AuthStateType2))(AuthStateType || {});
+const SOURCE_ID = "__sanity_internal_sourceId";
+function datasetSource(projectId, dataset) {
+  return { [SOURCE_ID]: { projectId, dataset } };
+}
+function mediaLibrarySource(id) {
+  return { [SOURCE_ID]: ["media-library", id] };
+}
+function canvasSource(id) {
+  return { [SOURCE_ID]: ["canvas", id] };
+}
 function getPublishedId(id) {
   const draftsPrefix = "drafts.";
   return id.startsWith(draftsPrefix) ? id.slice(draftsPrefix.length) : id;
@@ -88,11 +97,11 @@ function createStoreState(initialState, devToolsOptions) {
     })
   };
 }
-function createStoreInstance(instance, { name, getInitialState: getInitialState2, initialize }) {
-  const state = createStoreState(getInitialState2(instance), {
+function createStoreInstance(instance, key, { name, getInitialState: getInitialState2, initialize }) {
+  const state = createStoreState(getInitialState2(instance, key), {
     enabled: !!getEnv("DEV"),
-    name: `${name}-${instance.config.projectId}.${instance.config.dataset}`
-  }), dispose = initialize?.({ state, instance }), disposed = { current: !1 };
+    name: `${name}-${key.name}`
+  }), dispose = initialize?.({ state, instance, key }), disposed = { current: !1 };
   return {
     state,
     dispose: () => {
@@ -105,21 +114,32 @@ function createActionBinder(keyFn) {
   const instanceRegistry = /* @__PURE__ */ new Map(), storeRegistry = /* @__PURE__ */ new Map();
   return function(storeDefinition, action) {
     return function(instance, ...params) {
-      const keySuffix = keyFn(instance.config), compositeKey = storeDefinition.name + (keySuffix ? `:${keySuffix}` : "");
+      const key = keyFn(instance, ...params), compositeKey = storeDefinition.name + (key.name ? `:${key.name}` : "");
       let instances = instanceRegistry.get(compositeKey);
       instances || (instances = /* @__PURE__ */ new Set(), instanceRegistry.set(compositeKey, instances)), instances.has(instance.instanceId) || (instances.add(instance.instanceId), instance.onDispose(() => {
         instances.delete(instance.instanceId), instances.size === 0 && (storeRegistry.get(compositeKey)?.dispose(), storeRegistry.delete(compositeKey), instanceRegistry.delete(compositeKey));
       }));
       let storeInstance = storeRegistry.get(compositeKey);
-      return storeInstance || (storeInstance = createStoreInstance(instance, storeDefinition), storeRegistry.set(compositeKey, storeInstance)), action({ instance, state: storeInstance.state }, ...params);
+      return storeInstance || (storeInstance = createStoreInstance(instance, key, storeDefinition), storeRegistry.set(compositeKey, storeInstance)), action({ instance, state: storeInstance.state, key }, ...params);
     };
   };
 }
-const bindActionByDataset = createActionBinder(({ projectId, dataset }) => {
+const bindActionByDataset = createActionBinder((instance, options) => {
+  const projectId = options?.projectId ?? instance.config.projectId, dataset = options?.dataset ?? instance.config.dataset;
   if (!projectId || !dataset)
     throw new Error("This API requires a project ID and dataset configured.");
-  return `${projectId}.${dataset}`;
-}), bindActionGlobally = createActionBinder(() => "global");
+  return { name: `${projectId}.${dataset}`, projectId, dataset };
+}), bindActionBySource = createActionBinder((instance, { source }) => {
+  if (source) {
+    const id = source[SOURCE_ID];
+    if (!id) throw new Error("Invalid source (missing ID information)");
+    return Array.isArray(id) ? { name: id.join(":") } : { name: `${id.projectId}.${id.dataset}` };
+  }
+  const { projectId, dataset } = instance.config;
+  if (!projectId || !dataset)
+    throw new Error("This API requires a project ID and dataset configured.");
+  return { name: `${projectId}.${dataset}` };
+}), bindActionGlobally = createActionBinder((..._rest) => ({ name: "global" }));
 function createStateSourceAction(options) {
   const selector = typeof options == "function" ? options : options.selector, subscribeHandler = options && "onSubscribe" in options ? options.onSubscribe : void 0, isEqual2 = options && "isEqual" in options ? options.isEqual ?? Object.is : Object.is, selectorContextCache = /* @__PURE__ */ new WeakMap();
   function stateSourceAction(context, ...params) {
@@ -167,7 +187,8 @@ function createStateSourceAction(options) {
   }
   return stateSourceAction;
 }
-const DEFAULT_BASE = "http://localhost", AUTH_CODE_PARAM = "sid", DEFAULT_API_VERSION$1 = "2021-06-07", REQUEST_TAG_PREFIX = "sanity.sdk.auth", REFRESH_INTERVAL = 12 * 60 * 60 * 1e3, LOCK_NAME = "sanity-token-refresh-lock";
+var AuthStateType = /* @__PURE__ */ ((AuthStateType2) => (AuthStateType2.LOGGED_IN = "logged-in", AuthStateType2.LOGGING_IN = "logging-in", AuthStateType2.ERROR = "error", AuthStateType2.LOGGED_OUT = "logged-out", AuthStateType2))(AuthStateType || {});
+const DEFAULT_BASE = "http://localhost", AUTH_CODE_PARAM = "sid", DEFAULT_API_VERSION$1 = "2021-06-07", REQUEST_TAG_PREFIX = "sanity.sdk.auth", REFRESH_INTERVAL = 720 * 60 * 1e3, LOCK_NAME = "sanity-token-refresh-lock";
 function getLastRefreshTime(storageArea, storageKey) {
   try {
     const data = storageArea?.getItem(`${storageKey}_last_refresh`), parsed = data ? parseInt(data, 10) : 0;
@@ -389,6 +410,21 @@ function getCleanedUrl(locationUrl) {
   }
   return loc.searchParams.delete("sid"), loc.searchParams.delete("url"), loc.toString();
 }
+function getClientErrorApiBody(error) {
+  const body = error.response?.body;
+  return body && typeof body == "object" ? body : void 0;
+}
+function getClientErrorApiType(error) {
+  const body = getClientErrorApiBody(error);
+  return body?.error?.type ?? body?.type;
+}
+function getClientErrorApiDescription(error) {
+  const body = getClientErrorApiBody(error);
+  return body?.error?.description ?? body?.description;
+}
+function isProjectUserNotFoundClientError(error) {
+  return getClientErrorApiType(error) === "projectUserNotFoundError";
+}
 async function checkForCookieAuth(projectId, clientFactory) {
   if (!projectId) return !1;
   try {
@@ -584,13 +620,7 @@ const authStore = {
   }) : currentAuthState.type !== AuthStateType.LOGGED_OUT && state.set("setToken", {
     authState: { type: AuthStateType.LOGGED_OUT, isDestroyingSession: !1 }
   });
-});
-function compareProjectOrganization(projectId, projectOrganizationId, currentDashboardOrgId) {
-  return projectOrganizationId !== currentDashboardOrgId ? {
-    error: `Project ${projectId} belongs to Organization ${projectOrganizationId ?? "unknown"}, but the Dashboard has Organization ${currentDashboardOrgId} selected`
-  } : { error: null };
-}
-const DEFAULT_API_VERSION = "2024-11-12", DEFAULT_REQUEST_TAG_PREFIX = "sanity.sdk", allowedKeys = Object.keys({
+}), DEFAULT_API_VERSION = "2024-11-12", DEFAULT_REQUEST_TAG_PREFIX = "sanity.sdk", allowedKeys = Object.keys({
   apiHost: null,
   useCdn: null,
   token: null,
@@ -605,7 +635,8 @@ const DEFAULT_API_VERSION = "2024-11-12", DEFAULT_REQUEST_TAG_PREFIX = "sanity.s
   apiVersion: null,
   requestTagPrefix: null,
   useProjectHostname: null,
-  "~experimental_resource": null
+  "~experimental_resource": null,
+  source: null
 }), DEFAULT_CLIENT_CONFIG = {
   apiVersion: DEFAULT_API_VERSION,
   useCdn: !1,
@@ -631,6 +662,10 @@ const DEFAULT_API_VERSION = "2024-11-12", DEFAULT_REQUEST_TAG_PREFIX = "sanity.s
 }), getClientConfigKey = (options) => JSON.stringify(pick(options, ...allowedKeys)), getClient = bindActionGlobally(
   clientStore,
   ({ state, instance }, options) => {
+    if (!options || typeof options != "object")
+      throw new Error(
+        'getClient() requires a configuration object with at least an "apiVersion" property. Example: getClient(instance, { apiVersion: "2024-11-12" })'
+      );
     const disallowedKeys = Object.keys(options).filter((key2) => !allowedKeys.includes(key2));
     if (disallowedKeys.length > 0) {
       const listFormatter = new Intl.ListFormat("en", { style: "long", type: "conjunction" });
@@ -638,16 +673,22 @@ const DEFAULT_API_VERSION = "2024-11-12", DEFAULT_REQUEST_TAG_PREFIX = "sanity.s
         `The client options provided contains unsupported properties: ${listFormatter.format(disallowedKeys)}. Allowed keys are: ${listFormatter.format(allowedKeys)}.`
       );
     }
-    const tokenFromState = state.get().token, { clients, authMethod } = state.get(), projectId = options.projectId ?? instance.config.projectId, dataset = options.dataset ?? instance.config.dataset, apiHost = options.apiHost ?? instance.config.auth?.apiHost, effectiveOptions = {
+    const tokenFromState = state.get().token, { clients, authMethod } = state.get(), hasSource = !!options.source;
+    let sourceId = options.source?.[SOURCE_ID], resource;
+    Array.isArray(sourceId) && (resource = { type: sourceId[0], id: sourceId[1] }, sourceId = void 0);
+    const projectId = options.projectId ?? instance.config.projectId, dataset = options.dataset ?? instance.config.dataset, apiHost = options.apiHost ?? instance.config.auth?.apiHost, effectiveOptions = {
       ...DEFAULT_CLIENT_CONFIG,
-      ...(options.scope === "global" || !projectId) && { useProjectHostname: !1 },
+      ...(options.scope === "global" || !projectId || hasSource) && { useProjectHostname: !1 },
       token: authMethod === "cookie" ? void 0 : tokenFromState ?? void 0,
       ...options,
       ...projectId && { projectId },
       ...dataset && { dataset },
-      ...apiHost && { apiHost }
+      ...apiHost && { apiHost },
+      ...resource && { "~experimental_resource": resource }
     };
-    effectiveOptions.token === null || typeof effectiveOptions.token > "u" ? (delete effectiveOptions.token, authMethod === "cookie" && (effectiveOptions.withCredentials = !0)) : delete effectiveOptions.withCredentials;
+    hasSource && ((options.projectId || options.dataset) && console.warn(
+      "Both source and explicit projectId/dataset are provided. The source will be used and projectId/dataset will be ignored."
+    ), delete effectiveOptions.projectId, delete effectiveOptions.dataset), effectiveOptions.token === null || typeof effectiveOptions.token > "u" ? (delete effectiveOptions.token, authMethod === "cookie" && (effectiveOptions.withCredentials = !0)) : delete effectiveOptions.withCredentials;
     const key = getClientConfigKey(effectiveOptions);
     if (clients[key]) return clients[key];
     const client = createClient(effectiveOptions);
@@ -656,7 +697,47 @@ const DEFAULT_API_VERSION = "2024-11-12", DEFAULT_REQUEST_TAG_PREFIX = "sanity.s
 ), getClientState = bindActionGlobally(
   clientStore,
   createStateSourceAction(({ instance }, options) => getClient(instance, options))
-);
+), API_VERSION$6 = "vX";
+function agentGenerate(instance, options) {
+  return getClientState(instance, {
+    apiVersion: API_VERSION$6,
+    projectId: instance.config.projectId,
+    dataset: instance.config.dataset
+  }).observable.pipe(switchMap((client) => client.observable.agent.action.generate(options)));
+}
+function agentTransform(instance, options) {
+  return getClientState(instance, {
+    apiVersion: API_VERSION$6,
+    projectId: instance.config.projectId,
+    dataset: instance.config.dataset
+  }).observable.pipe(switchMap((client) => client.observable.agent.action.transform(options)));
+}
+function agentTranslate(instance, options) {
+  return getClientState(instance, {
+    apiVersion: API_VERSION$6,
+    projectId: instance.config.projectId,
+    dataset: instance.config.dataset
+  }).observable.pipe(switchMap((client) => client.observable.agent.action.translate(options)));
+}
+function agentPrompt(instance, options) {
+  return getClientState(instance, {
+    apiVersion: API_VERSION$6,
+    projectId: instance.config.projectId,
+    dataset: instance.config.dataset
+  }).observable.pipe(switchMap((client) => from(client.agent.action.prompt(options))));
+}
+function agentPatch(instance, options) {
+  return getClientState(instance, {
+    apiVersion: API_VERSION$6,
+    projectId: instance.config.projectId,
+    dataset: instance.config.dataset
+  }).observable.pipe(switchMap((client) => from(client.agent.action.patch(options))));
+}
+function compareProjectOrganization(projectId, projectOrganizationId, currentDashboardOrgId) {
+  return projectOrganizationId !== currentDashboardOrgId ? {
+    error: `Project ${projectId} belongs to Organization ${projectOrganizationId ?? "unknown"}, but the Dashboard has Organization ${currentDashboardOrgId} selected`
+  } : { error: null };
+}
 function createFetcherStore({
   name,
   fetcher: getObservable,
@@ -1078,18 +1159,21 @@ const API_VERSION$4 = "v2025-02-19", datasets = createFetcherStore({
     useProjectHostname: !0
   }).observable.pipe(switchMap((client) => client.observable.datasets.list()))
 }), getDatasetsState = datasets.getState, resolveDatasets = datasets.resolveState, isSanityMutatePatch = (value) => !(typeof value != "object" || !value || !("type" in value) || typeof value.type != "string" || value.type !== "patch" || !("id" in value) || typeof value.id != "string" || !("patches" in value) || !Array.isArray(value.patches));
-function createDocument(doc) {
+function createDocument(doc, initialValue) {
   return {
     type: "document.create",
     ...doc,
-    ...doc.documentId && { documentId: getPublishedId(doc.documentId) }
+    ...doc.documentId && {
+      documentId: doc.liveEdit ? doc.documentId : getPublishedId(doc.documentId)
+    },
+    ...initialValue && { initialValue }
   };
 }
 function deleteDocument(doc) {
   return {
     type: "document.delete",
     ...doc,
-    documentId: getPublishedId(doc.documentId)
+    documentId: doc.liveEdit ? doc.documentId : getPublishedId(doc.documentId)
   };
 }
 function convertSanityMutatePatch(sanityPatchMutation) {
@@ -1099,19 +1183,20 @@ function convertSanityMutatePatch(sanityPatchMutation) {
   });
 }
 function editDocument(doc, patches) {
+  const documentId = doc.liveEdit ? doc.documentId : getPublishedId(doc.documentId);
   if (isSanityMutatePatch(patches)) {
     const converted = convertSanityMutatePatch(patches) ?? [];
     return {
       ...doc,
       type: "document.edit",
-      documentId: getPublishedId(doc.documentId),
+      documentId,
       patches: converted
     };
   }
   return {
     ...doc,
     type: "document.edit",
-    documentId: getPublishedId(doc.documentId),
+    documentId,
     ...patches && { patches: Array.isArray(patches) ? patches : [patches] }
   };
 }
@@ -1119,21 +1204,21 @@ function publishDocument(doc) {
   return {
     type: "document.publish",
     ...doc,
-    documentId: getPublishedId(doc.documentId)
+    documentId: doc.liveEdit ? doc.documentId : getPublishedId(doc.documentId)
   };
 }
 function unpublishDocument(doc) {
   return {
     type: "document.unpublish",
     ...doc,
-    documentId: getPublishedId(doc.documentId)
+    documentId: doc.liveEdit ? doc.documentId : getPublishedId(doc.documentId)
   };
 }
 function discardDocument(doc) {
   return {
     type: "document.discard",
     ...doc,
-    documentId: getPublishedId(doc.documentId)
+    documentId: doc.liveEdit ? doc.documentId : getPublishedId(doc.documentId)
   };
 }
 const DOCUMENT_STATE_CLEAR_DELAY = 1e3, INITIAL_OUTGOING_THROTTLE_TIME = 1e3, API_VERSION$3 = "v2025-05-06";
@@ -1143,13 +1228,13 @@ function generateArrayKey(length = 12) {
 }
 function memoize(fn) {
   const cache = /* @__PURE__ */ new WeakMap();
-  return (input) => {
+  return ((input) => {
     if (!input || typeof input != "object") return fn(input);
     const cached = cache.get(input);
     if (cached) return cached;
     const result = fn(input);
     return cache.set(input, result), result;
-  };
+  });
 }
 const ensureArrayKeysDeep = memoize((input) => {
   if (!input || typeof input != "object") return input;
@@ -1662,11 +1747,11 @@ function createGrantsLookup(datasetAcl) {
 const documentsCache = new MultiKeyWeakMap(), actionsCache = /* @__PURE__ */ new WeakMap(), nullReplacer = {}, documentsSelector = createSelector(
   [
     ({ state: { documentStates } }) => documentStates,
-    (_context, actions) => actions
+    (_context, { actions }) => actions
   ],
   (documentStates, actions) => {
     const documentIds = new Set(
-      (Array.isArray(actions) ? actions : [actions]).map((i) => i.documentId).filter((i) => typeof i == "string").flatMap((documentId) => [getPublishedId(documentId), getDraftId(documentId)])
+      actions.map((action) => typeof action.documentId != "string" ? [] : action.liveEdit ? [action.documentId] : [getPublishedId(action.documentId), getDraftId(action.documentId)]).flat()
     ), documents = {};
     for (const documentId of documentIds) {
       const local = documentStates[documentId]?.local;
@@ -1683,7 +1768,7 @@ const documentsCache = new MultiKeyWeakMap(), actionsCache = /* @__PURE__ */ new
 ), memoizedActionsSelector = createSelector(
   [
     documentsSelector,
-    (_state, actions) => actions
+    (_state, { actions }) => actions
   ],
   (documents, actions) => {
     if (!documents) return;
@@ -1737,7 +1822,7 @@ const _calculatePermissions = createSelector(
     }
     for (const action of actions)
       if (action.type === "document.edit" && !action.patches?.length) {
-        const docId = action.documentId, doc = documents[getDraftId(docId)] ?? documents[getPublishedId(docId)];
+        const docId = action.documentId, doc = action.liveEdit ? documents[docId] : documents[getDraftId(docId)] ?? documents[getPublishedId(docId)];
         doc ? checkGrant$1(grants.update, doc) || reasons.push({
           type: "access",
           message: `You are not allowed to edit the document with ID "${docId}".`,
@@ -1784,14 +1869,56 @@ function processActions({
   for (const action of actions)
     switch (action.type) {
       case "document.create": {
-        const documentId = getId(action.documentId), draftId = getDraftId(documentId), publishedId = getPublishedId(documentId);
+        const documentId = getId(action.documentId);
+        if (action.liveEdit) {
+          if (working[documentId])
+            throw new ActionError({
+              documentId,
+              transactionId,
+              message: "This document already exists."
+            });
+          const newDocBase2 = { _type: action.documentType, _id: documentId }, newDocWorking2 = { _type: action.documentType, _id: documentId }, mutations2 = [{ create: newDocWorking2 }];
+          if (base = processMutations({
+            documents: base,
+            transactionId,
+            mutations: [{ create: newDocBase2 }],
+            timestamp
+          }), working = processMutations({
+            documents: working,
+            transactionId,
+            mutations: mutations2,
+            timestamp
+          }), !checkGrant(grants.create, working[documentId]))
+            throw new PermissionActionError({
+              documentId,
+              transactionId,
+              message: `You do not have permission to create document "${documentId}".`
+            });
+          outgoingMutations.push(...mutations2), outgoingActions.push({
+            actionType: "sanity.action.document.create",
+            publishedId: documentId,
+            attributes: newDocWorking2
+          });
+          continue;
+        }
+        const draftId = getDraftId(documentId), publishedId = getPublishedId(documentId);
         if (working[draftId])
           throw new ActionError({
             documentId,
             transactionId,
             message: "A draft version of this document already exists. Please use or discard the existing draft before creating a new one."
           });
-        const newDocBase = { ...base[publishedId], _type: action.documentType, _id: draftId }, newDocWorking = { ...working[publishedId], _type: action.documentType, _id: draftId }, mutations = [{ create: newDocWorking }];
+        const newDocBase = {
+          ...base[publishedId],
+          _type: action.documentType,
+          _id: draftId,
+          ...action.initialValue
+        }, newDocWorking = {
+          ...working[publishedId],
+          _type: action.documentType,
+          _id: draftId,
+          ...action.initialValue
+        }, mutations = [{ create: newDocWorking }];
         if (base = processMutations({
           documents: base,
           transactionId,
@@ -1816,7 +1943,28 @@ function processActions({
         continue;
       }
       case "document.delete": {
-        const documentId = action.documentId, draftId = getDraftId(documentId), publishedId = getPublishedId(documentId);
+        const documentId = action.documentId;
+        if (action.liveEdit) {
+          if (!working[documentId])
+            throw new ActionError({
+              documentId,
+              transactionId,
+              message: "The document you are trying to delete does not exist."
+            });
+          if (!checkGrant(grants.update, working[documentId]))
+            throw new PermissionActionError({
+              documentId,
+              transactionId,
+              message: "You do not have permission to delete this document."
+            });
+          const mutations2 = [{ delete: { id: documentId } }];
+          base = processMutations({ documents: base, transactionId, mutations: mutations2, timestamp }), working = processMutations({ documents: working, transactionId, mutations: mutations2, timestamp }), outgoingMutations.push(...mutations2), outgoingActions.push({
+            actionType: "sanity.action.document.delete",
+            publishedId: documentId
+          });
+          continue;
+        }
+        const draftId = getDraftId(documentId), publishedId = getPublishedId(documentId);
         if (!working[publishedId])
           throw new ActionError({
             documentId,
@@ -1839,7 +1987,14 @@ function processActions({
         continue;
       }
       case "document.discard": {
-        const documentId = getId(action.documentId), draftId = getDraftId(documentId), mutations = [{ delete: { id: draftId } }];
+        const documentId = getId(action.documentId);
+        if (action.liveEdit)
+          throw new ActionError({
+            documentId,
+            transactionId,
+            message: `Cannot discard changes for liveEdit document "${documentId}". LiveEdit documents do not support drafts.`
+          });
+        const draftId = getDraftId(documentId), mutations = [{ delete: { id: draftId } }];
         if (!working[draftId])
           throw new ActionError({
             documentId,
@@ -1859,7 +2014,50 @@ function processActions({
         continue;
       }
       case "document.edit": {
-        const documentId = getId(action.documentId), draftId = getDraftId(documentId), publishedId = getPublishedId(documentId), userPatches = action.patches?.map((patch) => ({ patch: { id: draftId, ...patch } }));
+        const documentId = getId(action.documentId);
+        if (action.liveEdit) {
+          const userPatches2 = action.patches?.map((patch) => ({ patch: { id: documentId, ...patch } }));
+          if (!userPatches2?.length) continue;
+          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 } }));
+          working = processMutations({
+            documents: working,
+            transactionId,
+            mutations: workingMutations2,
+            timestamp
+          }), outgoingMutations.push(...workingMutations2), outgoingActions.push(
+            ...patches2.map(
+              (patch) => ({
+                actionType: "sanity.action.document.edit",
+                // Server requires draftId to have drafts. prefix for validation, even for liveEdit
+                draftId: getDraftId(documentId),
+                publishedId: documentId,
+                patch
+              })
+            )
+          );
+          continue;
+        }
+        const draftId = getDraftId(documentId), publishedId = getPublishedId(documentId), userPatches = action.patches?.map((patch) => ({ patch: { id: draftId, ...patch } }));
         if (!userPatches?.length) continue;
         if (!working[draftId] && !working[publishedId] || !base[draftId] && !base[publishedId])
           throw new ActionError({
@@ -1912,7 +2110,14 @@ function processActions({
         continue;
       }
       case "document.publish": {
-        const documentId = getId(action.documentId), draftId = getDraftId(documentId), publishedId = getPublishedId(documentId), workingDraft = working[draftId], baseDraft = base[draftId];
+        const documentId = getId(action.documentId);
+        if (action.liveEdit)
+          throw new ActionError({
+            documentId,
+            transactionId,
+            message: `Cannot publish liveEdit document "${documentId}". LiveEdit documents do not support drafts or publishing.`
+          });
+        const draftId = getDraftId(documentId), publishedId = getPublishedId(documentId), workingDraft = working[draftId], baseDraft = base[draftId];
         if (!workingDraft || !baseDraft)
           throw new ActionError({
             documentId,
@@ -1955,7 +2160,14 @@ function processActions({
         continue;
       }
       case "document.unpublish": {
-        const documentId = getId(action.documentId), draftId = getDraftId(documentId), publishedId = getPublishedId(documentId);
+        const documentId = getId(action.documentId);
+        if (action.liveEdit)
+          throw new ActionError({
+            documentId,
+            transactionId,
+            message: `Cannot unpublish liveEdit document "${documentId}". LiveEdit documents do not support drafts or publishing.`
+          });
+        const draftId = getDraftId(documentId), publishedId = getPublishedId(documentId);
         if (!working[publishedId] && !base[publishedId])
           throw new ActionError({
             documentId,
@@ -2277,13 +2489,13 @@ function removeSubscriptionIdFromDocument(prev, documentId, subscriptionId) {
     }
   } : { ...prev, documentStates: omit(prev.documentStates, documentId) } : prev;
 }
-function manageSubscriberIds({ state }, documentId) {
-  const documentIds = Array.from(
+function manageSubscriberIds({ state }, documentId, options) {
+  const expandDraftPublished = options?.expandDraftPublished ?? !0, documentIds = Array.from(
     new Set(
-      (Array.isArray(documentId) ? documentId : [documentId]).flatMap((id) => [
+      expandDraftPublished ? (Array.isArray(documentId) ? documentId : [documentId]).flatMap((id) => [
         getPublishedId$1(id),
         getDraftId(id)
-      ])
+      ]) : Array.isArray(documentId) ? documentId : [documentId]
     )
   ), subscriptionId = insecureRandomId();
   return state.set(
@@ -2304,8 +2516,7 @@ function manageSubscriberIds({ state }, documentId) {
     }, DOCUMENT_STATE_CLEAR_DELAY);
   };
 }
-function getDocumentIdsFromActions(action) {
-  const actions = Array.isArray(action) ? action : [action];
+function getDocumentIdsFromActions(actions) {
   return Array.from(
     new Set(
       actions.map((i) => i.documentId).filter((i) => typeof i == "string").flatMap((documentId) => [getPublishedId$1(documentId), getDraftId(documentId)])
@@ -2417,8 +2628,17 @@ const _getDocumentState = bindActionByDataset(
   documentStore,
   createStateSourceAction({
     selector: ({ state: { error, documentStates } }, options) => {
-      const { documentId, path } = options;
+      const { documentId, path, liveEdit } = options;
       if (error) throw error;
+      if (liveEdit) {
+        const document22 = documentStates[documentId]?.local;
+        if (document22 === void 0) return;
+        if (!path) return document22;
+        const result2 = jsonMatch(document22, path).next();
+        if (result2.done) return;
+        const { value: value2 } = result2.value;
+        return value2;
+      }
       const draftId = getDraftId(documentId), publishedId = getPublishedId$1(documentId), draft = documentStates[draftId]?.local, published = documentStates[publishedId]?.local;
       if (draft === void 0 || published === void 0) return;
       const document2 = draft ?? published;
@@ -2428,7 +2648,7 @@ const _getDocumentState = bindActionByDataset(
       const { value } = result.value;
       return value;
     },
-    onSubscribe: (context, options) => manageSubscriberIds(context, options.documentId)
+    onSubscribe: (context, options) => manageSubscriberIds(context, options.documentId, { expandDraftPublished: !options.liveEdit })
   })
 );
 function resolveDocument(...args) {
@@ -2448,6 +2668,8 @@ const _resolveDocument = bindActionByDataset(
     selector: ({ state: { error, documentStates: documents, outgoing, applied, queued } }, doc) => {
       const documentId = typeof doc == "string" ? doc : doc.documentId;
       if (error) throw error;
+      if (doc.liveEdit)
+        return documents[documentId] === void 0 ? void 0 : !queued.length && !applied.length && !outgoing;
       const draftId = getDraftId(documentId), publishedId = getPublishedId$1(documentId), draft = documents[draftId], published = documents[publishedId];
       if (!(draft === void 0 || published === void 0))
         return !queued.length && !applied.length && !outgoing;
@@ -2458,12 +2680,12 @@ const _resolveDocument = bindActionByDataset(
   documentStore,
   createStateSourceAction({
     selector: calculatePermissions,
-    onSubscribe: (context, actions) => manageSubscriberIds(context, getDocumentIdsFromActions(actions))
+    onSubscribe: (context, { actions }) => manageSubscriberIds(context, getDocumentIdsFromActions(actions))
   })
 ), resolvePermissions = bindActionByDataset(
   documentStore,
-  ({ instance }, actions) => firstValueFrom(
-    getPermissionsState(instance, actions).observable.pipe(filter((i) => i !== void 0))
+  ({ instance }, options) => firstValueFrom(
+    getPermissionsState(instance, options).observable.pipe(filter((i) => i !== void 0))
   )
 ), subscribeDocumentEvents = bindActionByDataset(
   documentStore,
@@ -2569,51 +2791,25 @@ const _resolveDocument = bindActionByDataset(
   ).subscribe({ error: (error) => state.set("setError", { error }) });
 }, subscribeToClientAndFetchDatasetAcl = ({
   instance,
-  state
-}) => {
-  const { projectId, dataset } = instance.config;
-  return getClientState(instance, { apiVersion: API_VERSION$3 }).observable.pipe(
-    switchMap(
-      (client) => client.observable.request({
-        uri: `/projects/${projectId}/datasets/${dataset}/acl`,
-        tag: "acl.get",
-        withCredentials: !0
-      })
-    ),
-    tap$1((datasetAcl) => state.set("setGrants", { grants: createGrantsLookup(datasetAcl) }))
-  ).subscribe({
-    error: (error) => state.set("setError", { error })
-  });
-};
+  state,
+  key: { projectId, dataset }
+}) => getClientState(instance, { apiVersion: API_VERSION$3 }).observable.pipe(
+  switchMap(
+    (client) => client.observable.request({
+      uri: `/projects/${projectId}/datasets/${dataset}/acl`,
+      tag: "acl.get",
+      withCredentials: !0
+    })
+  ),
+  tap$1((datasetAcl) => state.set("setGrants", { grants: createGrantsLookup(datasetAcl) }))
+).subscribe({
+  error: (error) => state.set("setError", { error })
+});
 function applyDocumentActions(...args) {
   return boundApplyDocumentActions(...args);
 }
 const boundApplyDocumentActions = bindActionByDataset(documentStore, _applyDocumentActions);
-async function _applyDocumentActions({ instance, state }, actionOrActions, { transactionId = crypto.randomUUID(), disableBatching } = {}) {
-  const actions = Array.isArray(actionOrActions) ? actionOrActions : [actionOrActions];
-  let projectId, dataset;
-  for (const action of actions)
-    if (action.projectId) {
-      if (projectId || (projectId = action.projectId), action.projectId !== projectId)
-        throw new Error(
-          `Mismatched project IDs found in actions. All actions must belong to the same project. Found "${action.projectId}" but expected "${projectId}".`
-        );
-      if (action.dataset && (dataset || (dataset = action.dataset), action.dataset !== dataset))
-        throw new Error(
-          `Mismatched datasets found in actions. All actions must belong to the same dataset. Found "${action.dataset}" but expected "${dataset}".`
-        );
-    }
-  if (projectId && projectId !== instance.config.projectId || dataset && dataset !== instance.config.dataset) {
-    const matchedInstance = instance.match({ projectId, dataset });
-    if (!matchedInstance)
-      throw new Error(
-        `Could not find a matching instance for projectId: "${projectId}" and dataset: "${dataset}"`
-      );
-    return boundApplyDocumentActions(matchedInstance, actionOrActions, {
-      disableBatching,
-      transactionId
-    });
-  }
+async function _applyDocumentActions({ state }, { actions, transactionId = crypto.randomUUID(), disableBatching }) {
   const { events } = state.get(), transaction = {
     transactionId,
     actions,
@@ -2981,8 +3177,14 @@ const handleIncomingMessage = (event) => {
   name: "presence",
   getInitialState,
   initialize: (context) => {
-    const { instance, state } = context, sessionId = crypto.randomUUID(), client = getClient(instance, {
-      apiVersion: "2022-06-30"
+    const {
+      instance,
+      state,
+      key: { projectId, dataset }
+    } = context, sessionId = crypto.randomUUID(), client = getClient(instance, {
+      apiVersion: "2022-06-30",
+      projectId,
+      dataset
     }), token$ = getTokenState(instance).observable.pipe(distinctUntilChanged()), [incomingEvents$, dispatch] = createBifurTransport({
       client,
       token$,
@@ -3024,8 +3226,8 @@ const handleIncomingMessage = (event) => {
 ), getPresence = bindActionByDataset(
   presenceStore,
   createStateSourceAction({
-    selector: (context) => selectPresence(context.state),
-    onSubscribe: (context) => {
+    selector: (context, _) => selectPresence(context.state),
+    onSubscribe: (context, _) => {
       const subscription = context.state.observable.pipe(
         map(
           (state) => Array.from(state.locations.values()).map((l) => l.userId).filter((id) => !!id)
@@ -3039,7 +3241,7 @@ const handleIncomingMessage = (event) => {
             (userId) => getUserState(context.instance, {
               userId,
               resourceType: "project",
-              projectId: context.instance.config.projectId
+              projectId: context.key.projectId
             }).pipe(filter((v) => !!v))
           );
           return combineLatest(userObservables);
@@ -3120,11 +3322,17 @@ const ARCHIVED_RELEASE_STATES = ["archived", "published"], releasesStore = {
 }, getActiveReleasesState = bindActionByDataset(
   releasesStore,
   createStateSourceAction({
-    selector: ({ state }) => state.activeReleases
+    selector: ({ state }, _) => state.activeReleases
   })
-), RELEASES_QUERY = "releases::all()", QUERY_PARAMS = {}, subscribeToReleases = ({ instance, state }) => getClientState(instance, {
+), RELEASES_QUERY = "releases::all()", QUERY_PARAMS = {}, subscribeToReleases = ({
+  instance,
+  state,
+  key: { projectId, dataset }
+}) => getClientState(instance, {
   apiVersion: "2025-04-10",
-  perspective: "raw"
+  perspective: "raw",
+  projectId,
+  dataset
 }).observable.pipe(
   switchMap(
     (client) => (
@@ -3152,7 +3360,7 @@ const ARCHIVED_RELEASE_STATES = ["archived", "published"], releasesStore = {
 function isReleasePerspective(perspective) {
   return typeof perspective == "object" && perspective !== null && "releaseName" in perspective;
 }
-const DEFAULT_PERSPECTIVE = "drafts", optionsCache = /* @__PURE__ */ new Map(), selectInstancePerspective = (context) => context.instance.config.perspective, selectActiveReleases = (context) => context.state.activeReleases, selectOptions = (_context, options) => options, memoizedOptionsSelector = createSelector(
+const DEFAULT_PERSPECTIVE = "drafts", optionsCache = /* @__PURE__ */ new Map(), selectInstancePerspective = (context, _) => context.instance.config.perspective, selectActiveReleases = (context) => context.state.activeReleases, selectOptions = (_context, options) => options, memoizedOptionsSelector = createSelector(
   [selectActiveReleases, selectOptions],
   (activeReleases, options) => {
     if (!options || !activeReleases) return options;
@@ -3252,6 +3460,7 @@ const queryStore = {
           projectId,
           dataset,
           tag,
+          source,
           perspective: perspectiveFromOptions,
           ...restOptions
         } = parseQueryKey(group$.key), perspective$ = getPerspectiveState(instance, {
@@ -3259,7 +3468,8 @@ const queryStore = {
         }).observable.pipe(filter(Boolean)), client$ = getClientState(instance, {
           apiVersion: QUERY_STORE_API_VERSION,
           projectId,
-          dataset
+          dataset,
+          source
         }).observable;
         return combineLatest([lastLiveEventId$, client$, perspective$]).pipe(
           switchMap(
@@ -3322,7 +3532,7 @@ const queryStore = {
 function getQueryState(...args) {
   return _getQueryState(...args);
 }
-const _getQueryState = bindActionByDataset(
+const _getQueryState = bindActionBySource(
   queryStore,
   createStateSourceAction({
     selector: ({ state, instance }, options) => {
@@ -3345,7 +3555,7 @@ const _getQueryState = bindActionByDataset(
 function resolveQuery(...args) {
   return _resolveQuery(...args);
 }
-const _resolveQuery = bindActionByDataset(
+const _resolveQuery = bindActionBySource(
   queryStore,
   ({ state, instance }, { signal, ...options }) => {
     const normalized = normalizeOptionsWithPerspective(instance, options), { getCurrent } = getQueryState(instance, normalized), key = getQueryKey(normalized), aborted$ = signal ? new Observable((observer) => {
@@ -3470,7 +3680,8 @@ function createPreviewQuery(documentIds) {
 }
 const BATCH_DEBOUNCE_TIME$1 = 50, isSetEqual$1 = (a, b) => a.size === b.size && Array.from(a).every((i) => b.has(i)), subscribeToStateAndFetchBatches$1 = ({
   state,
-  instance
+  instance,
+  key: { projectId, dataset }
 }) => state.observable.pipe(
   map(({ subscriptions }) => new Set(Object.keys(subscriptions))),
   distinctUntilChanged(isSetEqual$1),
@@ -3498,14 +3709,18 @@ const BATCH_DEBOUNCE_TIME$1 = 50, isSetEqual$1 = (a, b) => a.size === b.size &&
         query,
         params,
         tag: PREVIEW_TAG,
-        perspective: PREVIEW_PERSPECTIVE
+        perspective: PREVIEW_PERSPECTIVE,
+        projectId,
+        dataset
       }), subscription = defer(() => getCurrent() === void 0 ? from(
         resolveQuery(instance, {
           query,
           params,
           tag: PREVIEW_TAG,
           perspective: PREVIEW_PERSPECTIVE,
-          signal: controller.signal
+          signal: controller.signal,
+          projectId,
+          dataset
         })
       ).pipe(switchMap(() => observable)) : observable).pipe(filter((result) => result !== void 0)).subscribe(observer);
       return () => {
@@ -3515,8 +3730,8 @@ const BATCH_DEBOUNCE_TIME$1 = 50, isSetEqual$1 = (a, b) => a.size === b.size &&
   }),
   map(({ ids, data }) => ({
     values: processPreviewQuery({
-      projectId: instance.config.projectId,
-      dataset: instance.config.dataset,
+      projectId,
+      dataset,
       ids,
       results: data
     })
@@ -3633,7 +3848,8 @@ function processProjectionQuery({ ids, results }) {
 }
 const BATCH_DEBOUNCE_TIME = 50, isSetEqual = (a, b) => a.size === b.size && Array.from(a).every((i) => b.has(i)), subscribeToStateAndFetchBatches = ({
   state,
-  instance
+  instance,
+  key: { projectId, dataset }
 }) => {
   const documentProjections$ = state.observable.pipe(
     map((s) => s.documentProjections),
@@ -3676,12 +3892,16 @@ const BATCH_DEBOUNCE_TIME = 50, isSetEqual = (a, b) => a.size === b.size && Arra
         const { getCurrent, observable } = getQueryState(instance, {
           query,
           params,
+          projectId,
+          dataset,
           tag: PROJECTION_TAG,
           perspective: PROJECTION_PERSPECTIVE
         }), subscription = defer(() => getCurrent() === void 0 ? from(
           resolveQuery(instance, {
             query,
             params,
+            projectId,
+            dataset,
             tag: PROJECTION_TAG,
             perspective: PROJECTION_PERSPECTIVE,
             signal: controller.signal
@@ -3821,12 +4041,12 @@ const _resolveProjection = bindActionByDataset(
       });
     })
   )
-}), getProjectsState = projects.getState, resolveProjects = projects.resolveState, WILDCARD_TOKEN = "*", NEGATION_TOKEN = "-", TOKEN_REGEX = /(?:[^\s"]+|"[^"]*")+/g;
+}), getProjectsState = projects.getState, resolveProjects = projects.resolveState, TOKEN_REGEX = /(?:[^\s"]+|"[^"]*")+/g;
 function isNegationToken(token) {
-  return typeof token < "u" && token.trim().startsWith(NEGATION_TOKEN);
+  return typeof token < "u" && token.trim().startsWith("-");
 }
 function isPrefixToken(token) {
-  return typeof token < "u" && token.trim().endsWith(WILDCARD_TOKEN);
+  return typeof token < "u" && token.trim().endsWith("*");
 }
 function isExactMatchToken(token) {
   return !!token && token.length >= 2 && token.startsWith('"') && token.endsWith('"');
@@ -3841,7 +4061,7 @@ function createGroqSearchFilter(query) {
   return finalIncrementalToken !== void 0 && !isPrefixToken(finalIncrementalToken) && processedTokens.splice(
     finalIncrementalTokenIndex,
     1,
-    `${finalIncrementalToken}${WILDCARD_TOKEN}`
+    `${finalIncrementalToken}*`
   ), `[@] match text::query("${processedTokens.join(" ").replace(/"/g, '\\"')}")`;
 }
 function defineIntent(intent) {
@@ -3902,12 +4122,18 @@ function getCorsErrorProjectId(error) {
   const projMatch = (error.message || "").match(/manage\/project\/([^/?#]+)/);
   return projMatch ? projMatch[1] : null;
 }
-var version = "2.3.1";
+var version = "2.5.0";
 const CORE_SDK_VERSION = getEnv("PKG_VERSION") || `${version}-development`;
 export {
   AuthStateType,
   CORE_SDK_VERSION,
+  agentGenerate,
+  agentPatch,
+  agentPrompt,
+  agentTransform,
+  agentTranslate,
   applyDocumentActions,
+  canvasSource,
   createDatasetHandle,
   createDocument,
   createDocumentHandle,
@@ -3915,6 +4141,7 @@ export {
   createGroqSearchFilter,
   createProjectHandle,
   createSanityInstance,
+  datasetSource,
   defineIntent,
   deleteDocument,
   destroyController,
@@ -3923,6 +4150,9 @@ export {
   getActiveReleasesState,
   getAuthState,
   getClient,
+  getClientErrorApiBody,
+  getClientErrorApiDescription,
+  getClientErrorApiType,
   getClientState,
   getCorsErrorProjectId,
   getCurrentUserState,
@@ -3953,10 +4183,12 @@ export {
   getUsersKey,
   getUsersState,
   handleAuthCallback,
+  isProjectUserNotFoundClientError,
   joinPaths,
   jsonMatch2 as jsonMatch,
   loadMoreUsers,
   logout,
+  mediaLibrarySource,
   observeOrganizationVerificationState,
   parseQueryKey,
   parseUsersKey,