@sanity/sdk 2.4.0 → 2.6.0

package/dist/index.js

@@ -17,15 +17,14 @@ 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";
-const SOURCE_ID = "__sanity_internal_sourceId";
-function datasetSource(projectId, dataset) {
-  return { [SOURCE_ID]: { projectId, dataset } };
+function isDatasetSource(source) {
+  return "projectId" in source && "dataset" in source;
 }
-function mediaLibrarySource(id) {
-  return { [SOURCE_ID]: ["media-library", id] };
+function isMediaLibrarySource(source) {
+  return "mediaLibraryId" in source;
 }
-function canvasSource(id) {
-  return { [SOURCE_ID]: ["canvas", id] };
+function isCanvasSource(source) {
+  return "canvasId" in source;
 }
 function getPublishedId(id) {
   const draftsPrefix = "drafts.";
@@ -38,13 +37,152 @@ function getDraftId(id) {
 function insecureRandomId() {
   return Array.from({ length: 16 }, () => Math.floor(Math.random() * 16).toString(16)).join("");
 }
+const LOG_LEVEL_PRIORITY = {
+  error: 0,
+  warn: 1,
+  info: 2,
+  debug: 3,
+  trace: 4
+}, DEFAULT_CONFIG = {
+  level: "warn",
+  namespaces: [],
+  internal: !1,
+  timestamps: !0,
+  enableInProduction: !1,
+  handler: {
+    // eslint-disable-next-line no-console
+    error: console.error.bind(console),
+    // eslint-disable-next-line no-console
+    warn: console.warn.bind(console),
+    // eslint-disable-next-line no-console
+    info: console.info.bind(console),
+    // eslint-disable-next-line no-console
+    debug: console.debug.bind(console),
+    // eslint-disable-next-line no-console
+    trace: console.debug.bind(console)
+    // trace uses console.debug
+  }
+};
+function parseDebugEnvVar() {
+  if (typeof process > "u" || !process.env?.DEBUG)
+    return null;
+  const debug = process.env.DEBUG;
+  if (!debug.includes("sanity"))
+    return null;
+  const config = {}, levelMatch = debug.match(/sanity:(trace|debug|info|warn|error):/), hasLevelSpecifier = !!levelMatch;
+  if (levelMatch ? config.level = levelMatch[1] : config.level = "debug", debug === "sanity")
+    config.namespaces = ["*"];
+  else if (hasLevelSpecifier && debug.match(/sanity:(trace|debug|info|warn|error):\*/))
+    config.namespaces = ["*"];
+  else if (!hasLevelSpecifier && debug.includes("sanity:*"))
+    config.namespaces = ["*"];
+  else {
+    const namespaces = debug.split(",").filter((s) => s.includes("sanity:")).map((s) => {
+      const cleaned = s.replace(/^sanity:/, "");
+      return hasLevelSpecifier && cleaned.match(/^(trace|debug|info|warn|error):/) ? cleaned.split(":").slice(1).join(":") : cleaned.split(":")[0];
+    }).filter(Boolean).filter((ns) => ns !== "*");
+    namespaces.length > 0 && (config.namespaces = namespaces);
+  }
+  return debug.includes(":internal") && (config.internal = !0), config;
+}
+const envConfig = parseDebugEnvVar();
+let globalConfig = {
+  ...DEFAULT_CONFIG,
+  ...envConfig ?? {}
+};
+envConfig && (["info", "debug", "trace"].includes(globalConfig.level) || globalConfig.level === "warn") && console.info(
+  `[${(/* @__PURE__ */ new Date()).toISOString()}] [INFO] [sdk] Logging auto-configured from DEBUG environment variable`,
+  {
+    level: globalConfig.level,
+    namespaces: globalConfig.namespaces,
+    internal: globalConfig.internal,
+    source: "env:DEBUG",
+    value: typeof process < "u" ? process.env?.DEBUG : void 0
+  }
+);
+function configureLogging$1(config) {
+  globalConfig = {
+    ...globalConfig,
+    ...config,
+    handler: config.handler ?? globalConfig.handler
+  };
+}
+function isLoggingEnabled() {
+  return typeof process < "u" && process.env?.NODE_ENV === "production" ? globalConfig.enableInProduction : !0;
+}
+function isNamespaceEnabled(namespace) {
+  return isLoggingEnabled() ? globalConfig.namespaces.includes("*") ? !0 : globalConfig.namespaces.includes(namespace) : !1;
+}
+function isLevelEnabled(level) {
+  return isLoggingEnabled() ? LOG_LEVEL_PRIORITY[level] <= LOG_LEVEL_PRIORITY[globalConfig.level] : !1;
+}
+function formatMessage(namespace, level, message, context) {
+  const parts = [];
+  if (globalConfig.timestamps) {
+    const timestamp = (/* @__PURE__ */ new Date()).toISOString();
+    parts.push(`[${timestamp}]`);
+  }
+  parts.push(`[${level.toUpperCase()}]`), parts.push(`[${namespace}]`);
+  const instanceContext = context?.instanceContext;
+  return instanceContext && (instanceContext.projectId && parts.push(`[project:${instanceContext.projectId}]`), instanceContext.dataset && parts.push(`[dataset:${instanceContext.dataset}]`), instanceContext.instanceId && parts.push(`[instance:${instanceContext.instanceId.slice(0, 8)}]`)), parts.push(message), [parts.join(" "), context];
+}
+function sanitizeContext(context) {
+  if (!context || Object.keys(context).length === 0) return;
+  const sanitized = { ...context }, sensitiveKeys = ["token", "password", "secret", "apiKey", "authorization"];
+  for (const key of Object.keys(sanitized))
+    sensitiveKeys.some((sensitive) => key.toLowerCase().includes(sensitive)) && (sanitized[key] = "[REDACTED]");
+  return sanitized;
+}
+function createLogger(namespace, baseContext) {
+  const logAtLevel = (level, message, context) => {
+    if (!isNamespaceEnabled(namespace) || !isLevelEnabled(level) || context?.internal && !globalConfig.internal) return;
+    const mergedContext = { ...baseContext, ...context }, sanitized = sanitizeContext(mergedContext), [formatted, finalContext] = formatMessage(namespace, level, message, sanitized);
+    globalConfig.handler[level](formatted, finalContext);
+  };
+  return {
+    namespace,
+    error: (message, context) => logAtLevel("error", message, context),
+    warn: (message, context) => logAtLevel("warn", message, context),
+    info: (message, context) => logAtLevel("info", message, context),
+    debug: (message, context) => logAtLevel("debug", message, context),
+    trace: (message, context) => logAtLevel("trace", message, { ...context, internal: !0 }),
+    isLevelEnabled: (level) => isNamespaceEnabled(namespace) && isLevelEnabled(level),
+    child: (childContext) => createLogger(namespace, { ...baseContext, ...childContext }),
+    getInstanceContext: () => baseContext?.instanceContext
+  };
+}
 function createSanityInstance(config = {}) {
-  const instanceId = crypto.randomUUID(), disposeListeners = /* @__PURE__ */ new Map(), disposed = { current: !1 }, instance = {
+  const instanceId = crypto.randomUUID(), disposeListeners = /* @__PURE__ */ new Map(), disposed = { current: !1 }, instanceContext = {
+    instanceId,
+    projectId: config.projectId,
+    dataset: config.dataset
+  }, logger = createLogger("sdk", { instanceContext });
+  logger.info("Sanity instance created", {
+    hasProjectId: !!config.projectId,
+    hasDataset: !!config.dataset,
+    hasAuth: !!config.auth,
+    hasPerspective: !!config.perspective
+  }), logger.debug("Instance configuration", {
+    projectId: config.projectId,
+    dataset: config.dataset,
+    perspective: config.perspective,
+    studioMode: config.studioMode?.enabled,
+    hasAuthProviders: !!config.auth?.providers,
+    hasAuthToken: !!config.auth?.token
+  });
+  const instance = {
     instanceId,
     config,
     isDisposed: () => disposed.current,
     dispose: () => {
-      disposed.current || (disposed.current = !0, disposeListeners.forEach((listener) => listener()), disposeListeners.clear());
+      if (disposed.current) {
+        logger.trace("Dispose called on already disposed instance", { internal: !0 });
+        return;
+      }
+      logger.trace("Disposing instance", {
+        internal: !0,
+        listenerCount: disposeListeners.size
+      }), disposed.current = !0, disposeListeners.forEach((listener) => listener()), disposeListeners.clear(), logger.info("Instance disposed");
     },
     onDispose: (cb) => {
       const listenerId = insecureRandomId();
@@ -54,14 +192,26 @@ function createSanityInstance(config = {}) {
     },
     getParent: () => {
     },
-    createChild: (next) => Object.assign(
-      createSanityInstance({
-        ...config,
-        ...next,
-        ...config.auth === next.auth ? config.auth : config.auth && next.auth && { auth: { ...config.auth, ...next.auth } }
-      }),
-      { getParent: () => instance }
-    ),
+    createChild: (next) => {
+      logger.debug("Creating child instance", {
+        parentInstanceId: instanceId.slice(0, 8),
+        overridingProjectId: !!next.projectId,
+        overridingDataset: !!next.dataset,
+        overridingAuth: !!next.auth
+      });
+      const child = Object.assign(
+        createSanityInstance({
+          ...config,
+          ...next,
+          ...config.auth === next.auth ? config.auth : config.auth && next.auth && { auth: { ...config.auth, ...next.auth } }
+        }),
+        { getParent: () => instance }
+      );
+      return logger.trace("Child instance created", {
+        internal: !0,
+        childInstanceId: child.instanceId.slice(0, 8)
+      }), child;
+    },
     match: (targetConfig) => {
       if (Object.entries(pick(targetConfig, "auth", "projectId", "dataset")).every(
         ([key, value]) => config[key] === value
@@ -97,11 +247,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: () => {
@@ -114,32 +264,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, ...params), 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}`;
-}), bindActionBySource = createActionBinder(
-  ({ projectId, dataset }, { source }) => {
-    if (source) {
-      const id = source[SOURCE_ID];
-      if (!id) throw new Error("Invalid source (missing ID information)");
-      return Array.isArray(id) ? id.join(":") : `${id.projectId}.${id.dataset}`;
-    }
-    if (!projectId || !dataset)
-      throw new Error("This API requires a project ID and dataset configured.");
-    return `${projectId}.${dataset}`;
+  return { name: `${projectId}.${dataset}`, projectId, dataset };
+}), bindActionBySource = createActionBinder((instance, { source }) => {
+  if (source) {
+    let id;
+    if (isDatasetSource(source) ? id = `${source.projectId}.${source.dataset}` : isMediaLibrarySource(source) ? id = `media-library:${source.mediaLibraryId}` : isCanvasSource(source) && (id = `canvas:${source.canvasId}`), !id) throw new Error(`Received invalid source: ${JSON.stringify(source)}`);
+    return { name: id };
   }
-), bindActionGlobally = createActionBinder(() => "global");
+  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) {
@@ -188,7 +338,7 @@ function createStateSourceAction(options) {
   return stateSourceAction;
 }
 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 = 12 * 60 * 60 * 1e3, LOCK_NAME = "sanity-token-refresh-lock";
+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;
@@ -673,12 +823,12 @@ const authStore = {
         `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(), hasSource = !!options.source;
-    let sourceId = options.source?.[SOURCE_ID], resource;
-    Array.isArray(sourceId) && (resource = { type: sourceId[0], id: sourceId[1] }, sourceId = void 0);
+    const tokenFromState = state.get().token, { clients, authMethod } = state.get();
+    let resource;
+    options.source && (isDatasetSource(options.source) ? resource = { type: "dataset", id: `${options.source.projectId}.${options.source.dataset}` } : isMediaLibrarySource(options.source) ? resource = { type: "media-library", id: options.source.mediaLibraryId } : isCanvasSource(options.source) && (resource = { type: "canvas", id: options.source.canvasId }));
     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 || hasSource) && { useProjectHostname: !1 },
+      ...(options.scope === "global" || !projectId || resource) && { useProjectHostname: !1 },
       token: authMethod === "cookie" ? void 0 : tokenFromState ?? void 0,
       ...options,
       ...projectId && { projectId },
@@ -686,7 +836,7 @@ const authStore = {
       ...apiHost && { apiHost },
       ...resource && { "~experimental_resource": resource }
     };
-    hasSource && ((options.projectId || options.dataset) && console.warn(
+    resource && ((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);
@@ -1144,6 +1294,21 @@ function createProjectHandle(handle) {
 function createDatasetHandle(handle) {
   return handle;
 }
+function configureLogging(config) {
+  configureLogging$1(config);
+  const configLevel = config.level || "warn", shouldLog = ["info", "debug", "trace"].includes(configLevel) || configLevel === "warn";
+  shouldLog && config.handler?.info ? config.handler.info(`[${(/* @__PURE__ */ new Date()).toISOString()}] [INFO] [sdk] Logging configured`, {
+    level: configLevel,
+    namespaces: config.namespaces || [],
+    internal: config.internal || !1,
+    source: "programmatic"
+  }) : shouldLog && console.info(`[${(/* @__PURE__ */ new Date()).toISOString()}] [INFO] [sdk] Logging configured`, {
+    level: configLevel,
+    namespaces: config.namespaces || [],
+    internal: config.internal || !1,
+    source: "programmatic"
+  });
+}
 const API_VERSION$4 = "v2025-02-19", datasets = createFetcherStore({
   name: "Datasets",
   getKey: (instance, options) => {
@@ -1163,7 +1328,9 @@ 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 }
   };
 }
@@ -1171,7 +1338,7 @@ function deleteDocument(doc) {
   return {
     type: "document.delete",
     ...doc,
-    documentId: getPublishedId(doc.documentId)
+    documentId: doc.liveEdit ? doc.documentId : getPublishedId(doc.documentId)
   };
 }
 function convertSanityMutatePatch(sanityPatchMutation) {
@@ -1181,19 +1348,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] }
   };
 }
@@ -1201,21 +1369,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";
@@ -1225,13 +1393,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;
@@ -1744,11 +1912,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;
@@ -1765,7 +1933,7 @@ const documentsCache = new MultiKeyWeakMap(), actionsCache = /* @__PURE__ */ new
 ), memoizedActionsSelector = createSelector(
   [
     documentsSelector,
-    (_state, actions) => actions
+    (_state, { actions }) => actions
   ],
   (documents, actions) => {
     if (!documents) return;
@@ -1819,7 +1987,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}".`,
@@ -1866,7 +2034,39 @@ 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,
@@ -1908,7 +2108,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,
@@ -1931,7 +2152,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,
@@ -1951,7 +2179,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({
@@ -2004,7 +2275,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,
@@ -2047,7 +2325,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,
@@ -2369,13 +2654,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(
@@ -2396,8 +2681,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)])
@@ -2509,8 +2793,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;
@@ -2520,7 +2813,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) {
@@ -2540,6 +2833,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;
@@ -2550,12 +2845,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,
@@ -2661,51 +2956,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,
@@ -3073,8 +3342,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$,
@@ -3116,8 +3391,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)
@@ -3131,7 +3406,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);
@@ -3212,11 +3487,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) => (
@@ -3244,7 +3525,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;
@@ -3564,7 +3845,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),
@@ -3592,14 +3874,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 () => {
@@ -3609,8 +3895,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
     })
@@ -3727,7 +4013,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),
@@ -3770,12 +4057,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
@@ -3915,12 +4206,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('"');
@@ -3935,7 +4226,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) {
@@ -3996,7 +4287,7 @@ function getCorsErrorProjectId(error) {
   const projMatch = (error.message || "").match(/manage\/project\/([^/?#]+)/);
   return projMatch ? projMatch[1] : null;
 }
-var version = "2.4.0";
+var version = "2.6.0";
 const CORE_SDK_VERSION = getEnv("PKG_VERSION") || `${version}-development`;
 export {
   AuthStateType,
@@ -4007,7 +4298,7 @@ export {
   agentTransform,
   agentTranslate,
   applyDocumentActions,
-  canvasSource,
+  configureLogging,
   createDatasetHandle,
   createDocument,
   createDocumentHandle,
@@ -4015,7 +4306,6 @@ export {
   createGroqSearchFilter,
   createProjectHandle,
   createSanityInstance,
-  datasetSource,
   defineIntent,
   deleteDocument,
   destroyController,
@@ -4057,12 +4347,14 @@ export {
   getUsersKey,
   getUsersState,
   handleAuthCallback,
+  isCanvasSource,
+  isDatasetSource,
+  isMediaLibrarySource,
   isProjectUserNotFoundClientError,
   joinPaths,
   jsonMatch2 as jsonMatch,
   loadMoreUsers,
   logout,
-  mediaLibrarySource,
   observeOrganizationVerificationState,
   parseQueryKey,
   parseUsersKey,