@sanity/sdk-react 2.7.0 → 2.9.0

package/dist/index.js

@@ -1,12 +1,13 @@
 import { jsx, jsxs, Fragment } from "react/jsx-runtime";
 import { c } from "react-compiler-runtime";
 import { ClientError, CorsOriginError } from "@sanity/client";
-import { getAuthState, getNodeState, getIsInDashboardState, isStudioConfig, setAuthToken, AuthStateType, getLoginUrlState, observeOrganizationVerificationState, handleAuthCallback, logout, isProjectUserNotFoundClientError, getClientErrorApiDescription, getClientErrorApiBody, getCorsErrorProjectId, createSanityInstance, agentGenerate, agentTransform, agentTranslate, agentPrompt, agentPatch, getTokenState, getCurrentUserState, getDashboardOrganizationId, getClientState, getOrCreateController, getOrCreateChannel, releaseChannel, isDatasetSource, isMediaLibrarySource, isCanvasSource, getFavoritesState, resolveFavoritesState, resolveDatasets, getDatasetsState, applyDocumentActions, resolveDocument, getDocumentState, subscribeDocumentEvents, getPermissionsState, getDocumentSyncStatus, editDocument, getQueryKey, parseQueryKey, getQueryState, resolveQuery, createGroqSearchFilter, getPresence, getPreviewState, resolvePreview, getProjectionState, resolveProjection, resolveProject, getProjectState, resolveProjects, getProjectsState, getActiveReleasesState, getPerspectiveState, getUsersKey, parseUsersKey, getUsersState, resolveUsers, loadMoreUsers } from "@sanity/sdk";
+import { getAuthState, getNodeState, getIsInDashboardState, isStudioConfig, setAuthToken, AuthStateType, getLoginUrlState, observeOrganizationVerificationState, handleAuthCallback, logout, isProjectUserNotFoundClientError, getClientErrorApiDescription, getClientErrorApiBody, getCorsErrorProjectId, createSanityInstance, agentGenerate, agentTransform, agentTranslate, agentPrompt, agentPatch, getTokenState, getCurrentUserState, getDashboardOrganizationId, getClientState, getOrCreateController, getOrCreateChannel, releaseChannel, isDatasetSource, isMediaLibrarySource, isCanvasSource, getFavoritesState, resolveFavoritesState, resolveDatasets, getDatasetsState, applyDocumentActions, resolveDocument, getDocumentState, subscribeDocumentEvents, getPermissionsState, getDocumentSyncStatus, editDocument, getQueryKey, parseQueryKey, getQueryState, resolveQuery, createGroqSearchFilter, getPresence, getProjectionState, resolveProjection, transformProjectionToPreview, PREVIEW_PROJECTION, resolveProject, getProjectState, resolveProjects, getProjectsState, getActiveReleasesState, getPerspectiveState, getUsersKey, parseUsersKey, getUsersState, resolveUsers, loadMoreUsers } from "@sanity/sdk";
 export * from "@sanity/sdk";
-import { createContext, useContext, useSyncExternalStore, useRef, useEffect, useState, Suspense, StrictMode, useCallback, useMemo, useInsertionEffect, useTransition } from "react";
+import { createContext, useContext, useSyncExternalStore, useRef, useEffect, useState, useMemo, Suspense, StrictMode, useCallback, useInsertionEffect, useTransition } from "react";
 import { ErrorBoundary } from "react-error-boundary";
 import { SDK_CHANNEL_NAME, SDK_NODE_NAME } from "@sanity/message-protocol";
 import { firstValueFrom, filter, identity, Observable, startWith, distinctUntilChanged, switchMap, EMPTY } from "rxjs";
+import { initTelemetry, trackHookMounted } from "@sanity/sdk/_internal";
 import { createRoot } from "react-dom/client";
 import { pick } from "lodash-es";
 const SanityInstanceContext = createContext(null), useSanityInstance = (config) => {
@@ -298,25 +299,40 @@ function _temp$6(replacementLocation) {
 }
 const useLogOut = createCallbackHook(logout);
 function LoginError(t0) {
-  const $ = c(18), {
+  const $ = c(23), {
     error,
     resetErrorBoundary
   } = t0;
   if (!(error instanceof AuthError || error instanceof ConfigurationError || error instanceof ClientError))
     throw error;
-  const logout2 = useLogOut(), authState = useAuthState(), [authErrorMessage, setAuthErrorMessage] = useState("Please try again or contact support if the problem persists."), [showRetryCta, setShowRetryCta] = useState(!0);
-  let t1;
-  $[0] !== logout2 || $[1] !== resetErrorBoundary ? (t1 = async () => {
-    await logout2(), resetErrorBoundary();
-  }, $[0] = logout2, $[1] = resetErrorBoundary, $[2] = t1) : t1 = $[2];
-  const handleRetry = t1;
+  const logout2 = useLogOut(), authState = useAuthState(), {
+    config: t1
+  } = useSanityInstance(), {
+    projectId
+  } = t1, [authErrorMessage, setAuthErrorMessage] = useState("Please try again or contact support if the problem persists."), [showRetryCta, setShowRetryCta] = useState(!0);
   let t2;
-  $[3] !== authState.type || $[4] !== error || $[5] !== handleRetry ? (t2 = () => {
+  $[0] === Symbol.for("react.memo_cache_sentinel") ? (t2 = {
+    name: SDK_NODE_NAME,
+    connectTo: SDK_CHANNEL_NAME
+  }, $[0] = t2) : t2 = $[0];
+  const {
+    fetch
+  } = useWindowConnection(t2);
+  let t3;
+  $[1] !== logout2 || $[2] !== resetErrorBoundary ? (t3 = async () => {
+    await logout2(), resetErrorBoundary();
+  }, $[1] = logout2, $[2] = resetErrorBoundary, $[3] = t3) : t3 = $[3];
+  const handleRetry = t3;
+  let t4;
+  $[4] !== authState.type || $[5] !== error || $[6] !== fetch || $[7] !== handleRetry || $[8] !== projectId ? (t4 = () => {
     if (error instanceof ClientError) {
       if (error.statusCode === 401)
         if (isProjectUserNotFoundClientError(error)) {
           const description = getClientErrorApiDescription(error);
-          description && setAuthErrorMessage(description), setShowRetryCta(!1);
+          description && setAuthErrorMessage(description), setShowRetryCta(!1), fetch("dashboard/v1/auth/access/request", {
+            resourceType: "project",
+            resourceId: projectId
+          });
         } else
           setShowRetryCta(!0), handleRetry();
       else if (error.statusCode === 404) {
@@ -325,17 +341,17 @@ function LoginError(t0) {
       }
     }
     authState.type !== AuthStateType.ERROR && error instanceof ConfigurationError && (setAuthErrorMessage(error.message), setShowRetryCta(!0));
-  }, $[3] = authState.type, $[4] = error, $[5] = handleRetry, $[6] = t2) : t2 = $[6];
-  let t3;
-  $[7] !== authState || $[8] !== error || $[9] !== handleRetry ? (t3 = [authState, handleRetry, error], $[7] = authState, $[8] = error, $[9] = handleRetry, $[10] = t3) : t3 = $[10], useEffect(t2, t3);
-  const t4 = error instanceof AuthError ? "Authentication Error" : "Configuration Error";
+  }, $[4] = authState.type, $[5] = error, $[6] = fetch, $[7] = handleRetry, $[8] = projectId, $[9] = t4) : t4 = $[9];
   let t5;
-  $[11] !== handleRetry || $[12] !== showRetryCta ? (t5 = showRetryCta ? {
+  $[10] !== authState || $[11] !== error || $[12] !== fetch || $[13] !== handleRetry || $[14] !== projectId ? (t5 = [authState, handleRetry, error, fetch, projectId], $[10] = authState, $[11] = error, $[12] = fetch, $[13] = handleRetry, $[14] = projectId, $[15] = t5) : t5 = $[15], useEffect(t4, t5);
+  const t6 = error instanceof AuthError ? "Authentication Error" : "Configuration Error";
+  let t7;
+  $[16] !== handleRetry || $[17] !== showRetryCta ? (t7 = showRetryCta ? {
     text: "Retry",
     onClick: handleRetry
-  } : void 0, $[11] = handleRetry, $[12] = showRetryCta, $[13] = t5) : t5 = $[13];
-  let t6;
-  return $[14] !== authErrorMessage || $[15] !== t4 || $[16] !== t5 ? (t6 = /* @__PURE__ */ jsx(Error$1, { heading: t4, description: authErrorMessage, cta: t5 }), $[14] = authErrorMessage, $[15] = t4, $[16] = t5, $[17] = t6) : t6 = $[17], t6;
+  } : void 0, $[16] = handleRetry, $[17] = showRetryCta, $[18] = t7) : t7 = $[18];
+  let t8;
+  return $[19] !== authErrorMessage || $[20] !== t6 || $[21] !== t7 ? (t8 = /* @__PURE__ */ jsx(Error$1, { heading: t6, description: authErrorMessage, cta: t7 }), $[19] = authErrorMessage, $[20] = t6, $[21] = t7, $[22] = t8) : t8 = $[22], t8;
 }
 if (isInIframe() && !document.querySelector("[data-sanity-core]")) {
   const parsedUrl = new URL(window.location.href), mode = new URLSearchParams(parsedUrl.hash.slice(1)).get("mode"), script = document.createElement("script");
@@ -398,32 +414,24 @@ function AuthSwitch(t0) {
 const SDKStudioContext = createContext(null);
 SDKStudioContext.displayName = "SDKStudioContext";
 const DEFAULT_FALLBACK = /* @__PURE__ */ jsx(Fragment, { children: "Warning: No fallback provided. Please supply a fallback prop to ensure proper Suspense handling." });
-function ResourceProvider(t0) {
-  const $ = c(16);
-  let children, config, fallback;
-  $[0] !== t0 ? ({
-    children,
-    fallback,
-    ...config
-  } = t0, $[0] = t0, $[1] = children, $[2] = config, $[3] = fallback) : (children = $[1], config = $[2], fallback = $[3]);
-  const parent = useContext(SanityInstanceContext);
-  let t1, t2;
-  $[4] !== config || $[5] !== parent ? (t2 = parent ? parent.createChild(config) : createSanityInstance(config), $[4] = config, $[5] = parent, $[6] = t2) : t2 = $[6], t1 = t2;
-  const instance = t1, disposal = useRef(null);
-  let t3, t4;
-  $[7] !== instance ? (t3 = () => (disposal.current !== null && instance === disposal.current.instance && (clearTimeout(disposal.current.timeoutId), disposal.current = null), () => {
+function ResourceProvider({
+  children,
+  fallback,
+  ...config
+}) {
+  const parent = useContext(SanityInstanceContext), instance = useMemo(() => parent ? parent.createChild(config) : createSanityInstance(config), [config, parent]), projectId = config.projectId ?? "";
+  useMemo(() => {
+    projectId && !parent && initTelemetry(instance, projectId);
+  }, [instance, projectId, parent]);
+  const disposal = useRef(null);
+  return useEffect(() => (disposal.current !== null && instance === disposal.current.instance && (clearTimeout(disposal.current.timeoutId), disposal.current = null), () => {
     disposal.current = {
       instance,
       timeoutId: setTimeout(() => {
         instance.isDisposed() || instance.dispose();
       }, 0)
     };
-  }), t4 = [instance], $[7] = instance, $[8] = t3, $[9] = t4) : (t3 = $[8], t4 = $[9]), useEffect(t3, t4);
-  const t5 = fallback ?? DEFAULT_FALLBACK;
-  let t6;
-  $[10] !== children || $[11] !== t5 ? (t6 = /* @__PURE__ */ jsx(Suspense, { fallback: t5, children }), $[10] = children, $[11] = t5, $[12] = t6) : t6 = $[12];
-  let t7;
-  return $[13] !== instance || $[14] !== t6 ? (t7 = /* @__PURE__ */ jsx(SanityInstanceContext.Provider, { value: instance, children: t6 }), $[13] = instance, $[14] = t6, $[15] = t7) : t7 = $[15], t7;
+  }), [instance]), /* @__PURE__ */ jsx(SanityInstanceContext.Provider, { value: instance, children: /* @__PURE__ */ jsx(Suspense, { fallback: fallback ?? DEFAULT_FALLBACK, children }) });
 }
 const SourcesContext = createContext({});
 function SDKProvider(t0) {
@@ -463,6 +471,7 @@ function deriveConfigFromWorkspace(workspace) {
     projectId: workspace.projectId,
     dataset: workspace.dataset,
     studio: {
+      authenticated: workspace.authenticated,
       auth: workspace.auth.token ? {
         token: workspace.auth.token
       } : void 0
@@ -649,24 +658,27 @@ function useDashboardNavigate(navigateFn) {
     }
   }, $[0] = navigateFn, $[1] = t0) : t0 = $[1], useWindowConnection(t0);
 }
-function useNormalizedSourceOptions(options) {
-  const $ = c(6);
-  let rest, sourceName;
-  if ($[0] !== options ? ({
+function normalizeSourceOptions(options, sources) {
+  const {
     sourceName,
     ...rest
-  } = options, $[0] = options, $[1] = rest, $[2] = sourceName) : (rest = $[1], sourceName = $[2]), sourceName && Object.hasOwn(options, "source"))
+  } = options;
+  if (!sourceName && !options.source)
+    return options;
+  if (sourceName && Object.hasOwn(options, "source"))
     throw new Error(`Source name ${JSON.stringify(sourceName)} and source ${JSON.stringify(options.source)} cannot be used together.`);
-  const sources = useContext(SourcesContext);
   let resolvedSource;
   if (options.source && (resolvedSource = options.source), sourceName && !Object.hasOwn(sources, sourceName))
     throw new Error(`There's no source named ${JSON.stringify(sourceName)} in context. Please use <SourceProvider>.`);
-  sourceName && sources[sourceName] && (resolvedSource = sources[sourceName]);
-  let t0;
-  return $[3] !== resolvedSource || $[4] !== rest ? (t0 = {
+  return sourceName && sources[sourceName] && (resolvedSource = sources[sourceName]), {
     ...rest,
     source: resolvedSource
-  }, $[3] = resolvedSource, $[4] = rest, $[5] = t0) : t0 = $[5], t0;
+  };
+}
+function useNormalizedSourceOptions(options) {
+  const $ = c(3), sources = useContext(SourcesContext);
+  let t0;
+  return $[0] !== options || $[1] !== sources ? (t0 = normalizeSourceOptions(options, sources), $[0] = options, $[1] = sources, $[2] = t0) : t0 = $[2], t0;
 }
 function useResourceIdFromDocumentHandle(documentHandle) {
   const $ = c(3), options = useNormalizedSourceOptions(documentHandle), {
@@ -936,6 +948,50 @@ function useRecordDocumentHistoryEvent(t0) {
     recordEvent
   }, $[8] = recordEvent, $[9] = t3) : t3 = $[9], t3;
 }
+function resolveAppTitle(resource) {
+  return resource.manifest?.title ?? resource.activeDeployment?.manifest?.title ?? resource.title;
+}
+function useWindowTitle(viewTitle) {
+  const $ = c(8), [appTitle, setAppTitle] = useState(null);
+  let t0;
+  $[0] === Symbol.for("react.memo_cache_sentinel") ? (t0 = {
+    name: SDK_NODE_NAME,
+    connectTo: SDK_CHANNEL_NAME
+  }, $[0] = t0) : t0 = $[0];
+  const {
+    fetch
+  } = useWindowConnection(t0);
+  let t1, t2;
+  $[1] !== fetch ? (t1 = () => {
+    if (!fetch)
+      return;
+    const controller = new AbortController();
+    return (async function(signal) {
+      try {
+        const data = await fetch("dashboard/v1/context", void 0, {
+          signal
+        }), title = resolveAppTitle(data.context.resource);
+        title && setAppTitle(title);
+      } catch (t32) {
+        const err = t32;
+        if (err instanceof Error && err.name === "AbortError")
+          return;
+        console.error("Failed to fetch app title from dashboard context:", err);
+      }
+    })(controller.signal), () => {
+      controller.abort();
+    };
+  }, t2 = [fetch], $[1] = fetch, $[2] = t1, $[3] = t2) : (t1 = $[2], t2 = $[3]), useEffect(t1, t2);
+  let t3, t4;
+  $[4] !== appTitle || $[5] !== viewTitle ? (t3 = () => {
+    if (!appTitle)
+      return;
+    const previous = document.title;
+    return document.title = viewTitle ? `${viewTitle} | ${appTitle}` : appTitle, () => {
+      document.title = previous;
+    };
+  }, t4 = [viewTitle, appTitle], $[4] = appTitle, $[5] = viewTitle, $[6] = t3, $[7] = t4) : (t3 = $[6], t4 = $[7]), useEffect(t3, t4);
+}
 const useDatasets = createStateSourceHook({
   getState: getDatasetsState,
   shouldSuspend: (instance, projectHandle) => (
@@ -945,18 +1001,27 @@ const useDatasets = createStateSourceHook({
   suspender: resolveDatasets,
   getConfig: identity
 }), useApplyDocumentActions = () => {
-  const $ = c(2), instance = useSanityInstance();
+  const $ = c(3), instance = useSanityInstance(), sources = useContext(SourcesContext);
   let t0;
-  return $[0] !== instance ? (t0 = (actionOrActions, options) => {
-    const actions = Array.isArray(actionOrActions) ? actionOrActions : [actionOrActions];
-    let projectId, dataset;
-    for (const action of actions)
+  return $[0] !== instance || $[1] !== sources ? (t0 = (actionOrActions, options) => {
+    const actions = Array.isArray(actionOrActions) ? actionOrActions : [actionOrActions], normalizedOptions = options ? normalizeSourceOptions(options, sources) : void 0;
+    let projectId, dataset, source;
+    for (const action of actions) {
       if (action.projectId) {
+        if (source)
+          throw new Error(`Mismatches between projectId/dataset options and source in actions. Found projectId "${action.projectId}" and dataset "${action.dataset}" but expected source "${source}".`);
         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 (action.source) {
+        if (source || (source = action.source), action.source !== source)
+          throw new Error(`Mismatched sources found in actions. All actions must belong to the same source. Found "${action.source}" but expected "${source}".`);
+        if (projectId || dataset)
+          throw new Error(`Mismatches between projectId/dataset options and source in actions. Found "${action.source}" but expected project "${projectId}" and dataset "${dataset}".`);
+      }
+    }
     if (projectId || dataset) {
       const actualInstance = instance.match({
         projectId,
@@ -970,15 +1035,25 @@ const useDatasets = createStateSourceHook({
   Please ensure there is a ResourceProvider component with a matching configuration in the component hierarchy.`);
       return applyDocumentActions(actualInstance, {
         actions,
-        ...options
+        source,
+        ...normalizedOptions
       });
     }
     return applyDocumentActions(instance, {
       actions,
-      ...options
+      source,
+      ...normalizedOptions
     });
-  }, $[0] = instance, $[1] = t0) : t0 = $[1], t0;
-}, useDocumentValue = createStateSourceHook({
+  }, $[0] = instance, $[1] = sources, $[2] = t0) : t0 = $[2], t0;
+};
+function useTrackHookUsage(hookName) {
+  const instance = useSanityInstance(), tracked = useRef(!1);
+  tracked.current || (tracked.current = !0, trackHookMounted(instance, hookName));
+}
+function trackHookUsage(instance, hookName) {
+  trackHookMounted(instance, hookName);
+}
+const useDocumentValue = createStateSourceHook({
   // Pass options directly to getDocumentState
   getState: (instance, options) => getDocumentState(instance, options),
   // Pass options directly to getDocumentState for checking current value
@@ -996,14 +1071,20 @@ const useDatasets = createStateSourceHook({
     };
   }
   return useHook;
-}, useDocument = wrapHookWithData(useDocumentValue);
+}, useDocument = wrapHookWithData((options) => {
+  useTrackHookUsage("useDocument");
+  const normalizedOptions = useNormalizedSourceOptions(options);
+  return useDocumentValue(normalizedOptions);
+});
 function useDocumentEvent(options) {
-  const $ = c(9);
+  const $ = c(10);
+  useTrackHookUsage("useDocumentEvent");
+  const normalizedOptions = useNormalizedSourceOptions(options);
   let datasetHandle, onEvent;
-  $[0] !== options ? ({
+  $[0] !== normalizedOptions ? ({
     onEvent,
     ...datasetHandle
-  } = options, $[0] = options, $[1] = datasetHandle, $[2] = onEvent) : (datasetHandle = $[1], onEvent = $[2]);
+  } = normalizedOptions, $[0] = normalizedOptions, $[1] = datasetHandle, $[2] = onEvent) : (datasetHandle = $[1], onEvent = $[2]);
   const ref = useRef(onEvent);
   let t0;
   $[3] !== onEvent ? (t0 = () => {
@@ -1013,41 +1094,53 @@ function useDocumentEvent(options) {
   $[5] === Symbol.for("react.memo_cache_sentinel") ? (t1 = (documentEvent) => ref.current(documentEvent), $[5] = t1) : t1 = $[5];
   const stableHandler = t1, instance = useSanityInstance(datasetHandle);
   let t2, t3;
-  $[6] !== instance ? (t2 = () => subscribeDocumentEvents(instance, stableHandler), t3 = [instance, stableHandler], $[6] = instance, $[7] = t2, $[8] = t3) : (t2 = $[7], t3 = $[8]), useEffect(t2, t3);
+  $[6] !== datasetHandle.source || $[7] !== instance ? (t2 = () => subscribeDocumentEvents(instance, {
+    eventHandler: stableHandler,
+    source: datasetHandle.source
+  }), t3 = [instance, datasetHandle.source, stableHandler], $[6] = datasetHandle.source, $[7] = instance, $[8] = t2, $[9] = t3) : (t2 = $[8], t3 = $[9]), useEffect(t2, t3);
 }
 function useDocumentPermissions(actionOrActions) {
-  const $ = c(13);
+  const $ = c(15);
   let t0, t1;
   $[0] !== actionOrActions ? (t1 = Array.isArray(actionOrActions) ? actionOrActions : [actionOrActions], $[0] = actionOrActions, $[1] = t1) : t1 = $[1], t0 = t1;
   const actions = t0;
-  let projectId, dataset;
-  if ($[2] !== actions || $[3] !== dataset || $[4] !== projectId) {
-    for (const action of actions)
+  let projectId, dataset, source;
+  if ($[2] !== actions || $[3] !== dataset || $[4] !== projectId || $[5] !== source) {
+    for (const action of actions) {
       if (action.projectId) {
+        if (source)
+          throw new Error(`Mismatches between projectId/dataset options and source in actions. Found projectId "${action.projectId}" and dataset "${action.dataset}" but expected source "${source}".`);
         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}".`);
       }
-    $[2] = actions, $[3] = dataset, $[4] = projectId, $[5] = projectId, $[6] = dataset;
+      if (action.source) {
+        if (source || (source = action.source), action.source !== source)
+          throw new Error(`Mismatched sources found in actions. All actions must belong to the same source. Found "${action.source}" but expected "${source}".`);
+        if (projectId || dataset)
+          throw new Error(`Mismatches between projectId/dataset options and source in actions. Found "${action.source}" but expected project "${projectId}" and dataset "${dataset}".`);
+      }
+    }
+    $[2] = actions, $[3] = dataset, $[4] = projectId, $[5] = source, $[6] = projectId, $[7] = dataset, $[8] = source;
   } else
-    projectId = $[5], dataset = $[6];
+    projectId = $[6], dataset = $[7], source = $[8];
   let t2;
-  $[7] !== dataset || $[8] !== projectId ? (t2 = {
+  $[9] !== dataset || $[10] !== projectId ? (t2 = {
     projectId,
     dataset
-  }, $[7] = dataset, $[8] = projectId, $[9] = t2) : t2 = $[9];
+  }, $[9] = dataset, $[10] = projectId, $[11] = t2) : t2 = $[11];
   const instance = useSanityInstance(t2);
-  if (getPermissionsState(instance, {
+  if (trackHookUsage(instance, "useDocumentPermissions"), getPermissionsState(instance, {
     actions
   }).getCurrent() === void 0)
     throw firstValueFrom(getPermissionsState(instance, {
       actions
     }).observable.pipe(filter(_temp$2)));
   let t3, t4;
-  $[10] !== actions || $[11] !== instance ? (t4 = getPermissionsState(instance, {
+  $[12] !== actions || $[13] !== instance ? (t4 = getPermissionsState(instance, {
     actions
-  }), $[10] = actions, $[11] = instance, $[12] = t4) : t4 = $[12], t3 = t4;
+  }), $[12] = actions, $[13] = instance, $[14] = t4) : t4 = $[14], t3 = t4;
   const {
     subscribe,
     getCurrent
@@ -1057,12 +1150,15 @@ function useDocumentPermissions(actionOrActions) {
 function _temp$2(result) {
   return result !== void 0;
 }
-const useDocumentSyncStatus = createStateSourceHook({
+const useDocumentSyncStatusValue = createStateSourceHook({
   getState: getDocumentSyncStatus,
   shouldSuspend: (instance, doc) => getDocumentSyncStatus(instance, doc).getCurrent() === void 0,
   suspender: (instance, doc) => resolveDocument(instance, doc),
   getConfig: identity
-}), ignoredKeys = ["_id", "_type", "_createdAt", "_updatedAt", "_rev"];
+}), useDocumentSyncStatus = (options) => {
+  const normalizedOptions = useNormalizedSourceOptions(options);
+  return useDocumentSyncStatusValue(normalizedOptions);
+}, ignoredKeys = ["_id", "_type", "_createdAt", "_updatedAt", "_rev"];
 function useEditDocument(t0) {
   const $ = c(8);
   let doc, path;
@@ -1070,25 +1166,27 @@ function useEditDocument(t0) {
     path,
     ...doc
   } = t0, $[0] = t0, $[1] = doc, $[2] = path) : (doc = $[1], path = $[2]);
-  const instance = useSanityInstance(doc), apply = useApplyDocumentActions();
-  if (getDocumentState(instance, doc).getCurrent() === void 0)
-    throw resolveDocument(instance, doc);
+  const instance = useSanityInstance(doc);
+  trackHookUsage(instance, "useEditDocument");
+  const normalizedDoc = useNormalizedSourceOptions(doc), apply = useApplyDocumentActions();
+  if (getDocumentState(instance, normalizedDoc).getCurrent() === void 0)
+    throw resolveDocument(instance, normalizedDoc);
   let t1;
-  return $[3] !== apply || $[4] !== doc || $[5] !== instance || $[6] !== path ? (t1 = (updater) => {
+  return $[3] !== apply || $[4] !== instance || $[5] !== normalizedDoc || $[6] !== path ? (t1 = (updater) => {
     const currentPath = path;
     if (currentPath) {
       const currentValue = getDocumentState(instance, {
-        ...doc,
+        ...normalizedDoc,
         path
       }).getCurrent(), nextValue = typeof updater == "function" ? updater(currentValue) : updater;
-      return apply(editDocument(doc, {
+      return apply(editDocument(normalizedDoc, {
         set: {
           [currentPath]: nextValue
         }
       }));
     }
     const current = getDocumentState(instance, {
-      ...doc,
+      ...normalizedDoc,
       path
     }).getCurrent(), nextValue_0 = typeof updater == "function" ? updater(current) : updater;
     if (typeof nextValue_0 != "object" || !nextValue_0)
@@ -1096,21 +1194,23 @@ function useEditDocument(t0) {
     const editActions = Object.keys({
       ...current,
       ...nextValue_0
-    }).filter(_temp$1).filter((key_0) => current?.[key_0] !== nextValue_0[key_0]).map((key_1) => key_1 in nextValue_0 ? editDocument(doc, {
+    }).filter(_temp$1).filter((key_0) => current?.[key_0] !== nextValue_0[key_0]).map((key_1) => key_1 in nextValue_0 ? editDocument(normalizedDoc, {
       set: {
         [key_1]: nextValue_0[key_1]
       }
-    }) : editDocument(doc, {
+    }) : editDocument(normalizedDoc, {
       unset: [key_1]
     }));
     return apply(editActions);
-  }, $[3] = apply, $[4] = doc, $[5] = instance, $[6] = path, $[7] = t1) : t1 = $[7], t1;
+  }, $[3] = apply, $[4] = instance, $[5] = normalizedDoc, $[6] = path, $[7] = t1) : t1 = $[7], t1;
 }
 function _temp$1(key) {
   return !ignoredKeys.includes(key);
 }
 function useQuery(options) {
-  const instance = useSanityInstance(options), normalized = useNormalizedSourceOptions(options), [isPending, startTransition] = useTransition(), queryKey = getQueryKey(normalized), [deferredQueryKey, setDeferredQueryKey] = useState(queryKey), ref = useRef(new AbortController());
+  const instance = useSanityInstance(options);
+  trackHookUsage(instance, "useQuery");
+  const normalized = useNormalizedSourceOptions(options), [isPending, startTransition] = useTransition(), queryKey = getQueryKey(normalized), [deferredQueryKey, setDeferredQueryKey] = useState(queryKey), ref = useRef(new AbortController());
   useEffect(() => {
     queryKey !== deferredQueryKey && startTransition(() => {
       ref && !ref.current.signal.aborted && (ref.current.abort(), ref.current = new AbortController()), setDeferredQueryKey(queryKey);
@@ -1146,6 +1246,7 @@ function useDocuments({
   documentType,
   ...options
 }) {
+  useTrackHookUsage("useDocuments");
   const instance = useSanityInstance(options), [limit, setLimit] = useState(batchSize), documentTypes = useMemo(() => (Array.isArray(documentType) ? documentType : [documentType]).filter((i) => typeof i == "string"), [documentType]), key = JSON.stringify({
     filter: filter2,
     search,
@@ -1208,7 +1309,9 @@ function usePaginatedDocuments(t0) {
   const filter2 = t1 === void 0 ? "" : t1, pageSize = t2 === void 0 ? 25 : t2;
   let t4;
   $[8] !== t3 ? (t4 = t3 === void 0 ? {} : t3, $[8] = t3, $[9] = t4) : t4 = $[9];
-  const params = t4, instance = useSanityInstance(options), [pageIndex, setPageIndex] = useState(0);
+  const params = t4;
+  useTrackHookUsage("usePaginatedDocuments");
+  const instance = useSanityInstance(options), [pageIndex, setPageIndex] = useState(0);
   let t5;
   $[10] !== filter2 || $[11] !== orderings || $[12] !== pageSize || $[13] !== params || $[14] !== search ? (t5 = JSON.stringify({
     filter: filter2,
@@ -1318,6 +1421,7 @@ function _temp(i) {
 }
 function usePresence() {
   const $ = c(11), sanityInstance = useSanityInstance();
+  trackHookUsage(sanityInstance, "usePresence");
   let t0, t1;
   $[0] !== sanityInstance ? (t1 = getPresence(sanityInstance), $[0] = sanityInstance, $[1] = t1) : t1 = $[1], t0 = t1;
   const source = t0;
@@ -1334,52 +1438,14 @@ function usePresence() {
     locations: t5
   }, $[9] = t5, $[10] = t6) : t6 = $[10], t6;
 }
-function useDocumentPreview(t0) {
-  const $ = c(13);
-  let docHandle, ref;
-  $[0] !== t0 ? ({
-    ref,
-    ...docHandle
-  } = t0, $[0] = t0, $[1] = docHandle, $[2] = ref) : (docHandle = $[1], ref = $[2]);
-  const instance = useSanityInstance(docHandle);
-  let t1;
-  $[3] !== docHandle || $[4] !== instance ? (t1 = getPreviewState(instance, docHandle), $[3] = docHandle, $[4] = instance, $[5] = t1) : t1 = $[5];
-  const stateSource = t1;
-  let t2;
-  $[6] !== ref || $[7] !== stateSource ? (t2 = (onStoreChanged) => {
-    const subscription = new Observable((observer) => {
-      if (typeof IntersectionObserver > "u" || typeof HTMLElement > "u") {
-        observer.next(!0);
-        return;
-      }
-      const intersectionObserver = new IntersectionObserver((t32) => {
-        const [entry] = t32;
-        return observer.next(entry.isIntersecting);
-      }, {
-        rootMargin: "0px",
-        threshold: 0
-      });
-      return ref?.current && ref.current instanceof HTMLElement ? intersectionObserver.observe(ref.current) : observer.next(!0), () => intersectionObserver.disconnect();
-    }).pipe(startWith(!1), distinctUntilChanged(), switchMap((isVisible) => isVisible ? new Observable((obs) => stateSource.subscribe(() => obs.next())) : EMPTY)).subscribe({
-      next: onStoreChanged
-    });
-    return () => subscription.unsubscribe();
-  }, $[6] = ref, $[7] = stateSource, $[8] = t2) : t2 = $[8];
-  const subscribe = t2;
-  let t3;
-  return $[9] !== docHandle || $[10] !== instance || $[11] !== stateSource ? (t3 = () => {
-    const currentState = stateSource.getCurrent();
-    if (currentState.data === null)
-      throw resolvePreview(instance, docHandle);
-    return currentState;
-  }, $[9] = docHandle, $[10] = instance, $[11] = stateSource, $[12] = t3) : t3 = $[12], useSyncExternalStore(subscribe, t3);
-}
 function useDocumentProjection({
   ref,
   projection,
   ...docHandle
 }) {
-  const instance = useSanityInstance(docHandle), normalizedProjection = useMemo(() => projection.trim(), [projection]), normalizedDocHandle = useNormalizedSourceOptions(docHandle), stateSource = useMemo(() => getProjectionState(instance, {
+  const instance = useSanityInstance(docHandle);
+  trackHookUsage(instance, "useDocumentProjection");
+  const normalizedProjection = useMemo(() => projection.trim(), [projection]), normalizedDocHandle = useNormalizedSourceOptions(docHandle), stateSource = useMemo(() => getProjectionState(instance, {
     ...normalizedDocHandle,
     projection: normalizedProjection
   }), [instance, normalizedDocHandle, normalizedProjection]);
@@ -1406,6 +1472,32 @@ function useDocumentProjection({
   }, [stateSource, ref]);
   return useSyncExternalStore(subscribe, stateSource.getCurrent);
 }
+function useDocumentPreview(t0) {
+  const $ = c(13);
+  let docHandle, ref;
+  $[0] !== t0 ? ({
+    ref,
+    ...docHandle
+  } = t0, $[0] = t0, $[1] = docHandle, $[2] = ref) : (docHandle = $[1], ref = $[2]);
+  const instance = useSanityInstance(docHandle);
+  trackHookUsage(instance, "useDocumentPreview");
+  const normalizedDocHandle = useNormalizedSourceOptions(docHandle);
+  let t1;
+  $[3] !== normalizedDocHandle || $[4] !== ref ? (t1 = {
+    ...normalizedDocHandle,
+    projection: PREVIEW_PROJECTION,
+    ref
+  }, $[3] = normalizedDocHandle, $[4] = ref, $[5] = t1) : t1 = $[5];
+  const projectionResult = useDocumentProjection(t1);
+  let t2, t3;
+  $[6] !== instance || $[7] !== normalizedDocHandle.source || $[8] !== projectionResult.data ? (t3 = transformProjectionToPreview(instance, projectionResult.data, normalizedDocHandle.source), $[6] = instance, $[7] = normalizedDocHandle.source, $[8] = projectionResult.data, $[9] = t3) : t3 = $[9], t2 = t3;
+  const previewValue = t2;
+  let t4;
+  return $[10] !== previewValue || $[11] !== projectionResult.isPending ? (t4 = {
+    data: previewValue,
+    isPending: projectionResult.isPending
+  }, $[10] = previewValue, $[11] = projectionResult.isPending, $[12] = t4) : t4 = $[12], t4;
+}
 const useProject = createStateSourceHook({
   // remove `undefined` since we're suspending when that is the case
   getState: getProjectState,
@@ -1416,17 +1508,31 @@ const useProject = createStateSourceHook({
   getState: getProjectsState,
   shouldSuspend: (instance, options) => getProjectsState(instance, options).getCurrent() === void 0,
   suspender: resolveProjects
-}), useActiveReleases = createStateSourceHook({
+}), useActiveReleasesValue = createStateSourceHook({
   getState: getActiveReleasesState,
-  shouldSuspend: (instance) => getActiveReleasesState(instance).getCurrent() === void 0,
-  suspender: (instance) => firstValueFrom(getActiveReleasesState(instance).observable.pipe(filter(Boolean)))
-}), usePerspective = createStateSourceHook({
+  shouldSuspend: (instance, options) => getActiveReleasesState(instance, options ?? {}).getCurrent() === void 0,
+  suspender: (instance, options) => firstValueFrom(getActiveReleasesState(instance, options ?? {}).observable.pipe(filter(Boolean)))
+}), useActiveReleases = (options) => {
+  const $ = c(2);
+  let t0;
+  $[0] !== options ? (t0 = options ?? {}, $[0] = options, $[1] = t0) : t0 = $[1];
+  const normalizedOptions = useNormalizedSourceOptions(t0);
+  return useActiveReleasesValue(normalizedOptions);
+}, usePerspectiveValue = createStateSourceHook({
   getState: getPerspectiveState,
   shouldSuspend: (instance, options) => getPerspectiveState(instance, options).getCurrent() === void 0,
-  suspender: (instance, _options) => firstValueFrom(getActiveReleasesState(instance).observable.pipe(filter(Boolean)))
-});
+  suspender: (instance, _options) => firstValueFrom(getPerspectiveState(instance, _options ?? {}).observable.pipe(filter(Boolean)))
+}), usePerspective = (options) => {
+  const $ = c(2);
+  let t0;
+  $[0] !== options ? (t0 = options ?? {}, $[0] = options, $[1] = t0) : t0 = $[1];
+  const normalizedOptions = useNormalizedSourceOptions(t0);
+  return usePerspectiveValue(normalizedOptions);
+};
 function useUser(options) {
-  const instance = useSanityInstance(options), [isPending, startTransition] = useTransition(), key = getUsersKey(instance, options), [deferredKey, setDeferredKey] = useState(key), deferred = useMemo(() => parseUsersKey(deferredKey), [deferredKey]), [ref, setRef] = useState(new AbortController());
+  const instance = useSanityInstance(options);
+  trackHookUsage(instance, "useUser");
+  const [isPending, startTransition] = useTransition(), key = getUsersKey(instance, options), [deferredKey, setDeferredKey] = useState(key), deferred = useMemo(() => parseUsersKey(deferredKey), [deferredKey]), [ref, setRef] = useState(new AbortController());
   useEffect(() => {
     key !== deferredKey && startTransition(() => {
       ref.signal.aborted || (ref.abort(), setRef(new AbortController())), setDeferredKey(key);
@@ -1447,7 +1553,9 @@ function useUser(options) {
   };
 }
 function useUsers(options) {
-  const instance = useSanityInstance(options), [isPending, startTransition] = useTransition(), key = getUsersKey(instance, options), [deferredKey, setDeferredKey] = useState(key), deferred = useMemo(() => parseUsersKey(deferredKey), [deferredKey]), [ref, setRef] = useState(new AbortController());
+  const instance = useSanityInstance(options);
+  trackHookUsage(instance, "useUsers");
+  const [isPending, startTransition] = useTransition(), key = getUsersKey(instance, options), [deferredKey, setDeferredKey] = useState(key), deferred = useMemo(() => parseUsersKey(deferredKey), [deferredKey]), [ref, setRef] = useState(new AbortController());
   useEffect(() => {
     key !== deferredKey && startTransition(() => {
       ref.signal.aborted || (ref.abort(), setRef(new AbortController())), setDeferredKey(key);
@@ -1475,7 +1583,7 @@ function useUsers(options) {
     loadMore
   };
 }
-var version = "2.7.0";
+var version = "2.9.0";
 function getEnv(key) {
   if (typeof import.meta < "u" && import.meta.env)
     return import.meta.env[key];
@@ -1536,6 +1644,7 @@ export {
   useUser,
   useUsers,
   useVerifyOrgProjects,
-  useWindowConnection
+  useWindowConnection,
+  useWindowTitle
 };
 //# sourceMappingURL=index.js.map