@sanity/sdk-react 3.0.0-rc.2 → 3.1.0

package/dist/index.js

@@ -1,108 +1,19 @@
+import { a as useWindowConnection, c as useSanityInstance, i as isDashboardEnvironment, l as SanityInstanceContext, n as useOrganizationId, o as useAuthState, r as DashboardTokenRefreshProvider, s as createStateSourceHook, t as useStudioWorkspacesByProjectIdDataset } from "./useStudioWorkspacesByProjectIdDataset-DxUlukmF.js";
 import { c } from "react-compiler-runtime";
 import { ClientError, CorsOriginError } from "@sanity/client";
-import { AuthStateType, application, applications, applyDocumentActions, checkPermissions, createComment, createDocument, createSanityInstance, deleteApplication, editDocument, getActiveReleasesState, getAllReleasesState, getAuthState, getClientState, getCommentThreadsState, getCommentsState, getCorsErrorProjectId, getCurrentUserState, getDashboardOrganizationId, getDatasetsState, getDocumentPresence, getDocumentState, getDocumentSyncStatus, getFavoritesState, getIsInDashboardState, getLoginUrlState, getPermissionsState, getPerspectiveState, getPresence, getProjectionState, getQueryState, getTokenState, getUsersState, handleAuthCallback, installation, installations, isDatasetResource, isImportError, isMediaLibraryResource, loadMoreUsers, logout, observeOrganizationVerificationState, organization, organizations, project, projects, removeComment, replyToComment, reportPresence, resolveCommentThreads, resolveComments, resolveDatasets, resolveDocument, resolveFavoritesState, resolveProjection, resolveQuery, resolveUsers, setAuthToken, setCommentStatus, subscribeDocumentEvents, updateApplication, updateComment } from "@sanity/sdk";
-import { PREVIEW_PROJECTION, createGroqSearchFilter, getClientErrorApiBody, getClientErrorApiDescription, getCommentsOptionsKey, getQueryKey, getUsersKey, initTelemetry, isDeepEqual, isProjectUserNotFoundClientError, isStudioConfig, parseCommentsOptionsKey, parseQueryKey, parseUsersKey, pickProperties, trackHookMounted, transformProjectionToPreview } from "@sanity/sdk/_internal";
+import { AuthStateType, application, applications, applyDocumentActions, checkPermissions, createComment, createDocument, createSanityInstance, datasets, deleteApplication, editDocument, favorites, getActiveReleasesState, getAllReleasesState, getClientState, getCommentThreadsState, getCommentsState, getCorsErrorProjectId, getCurrentUserState, getDocumentPresence, getDocumentState, getDocumentSyncStatus, getIsInDashboardState, getLoginUrlState, getPermissionsState, getPerspectiveState, getPresence, getProjectionState, getQueryState, getTokenState, getUsersState, handleAuthCallback, installation, installations, isDatasetResource, isImportError, isMediaLibraryResource, loadMoreUsers, logout, observeOrganizationVerificationState, organization, organizations, project, projects, removeComment, replyToComment, reportPresence, resolveCommentThreads, resolveComments, resolveDocument, resolveProjection, resolveQuery, resolveUsers, setAuthToken, setCommentStatus, setFavorite, subscribeDocumentEvents, updateApplication, updateComment } from "@sanity/sdk";
+import { PREVIEW_PROJECTION, createGroqSearchFilter, getClientErrorApiBody, getClientErrorApiDescription, getCommentsOptionsKey, getQueryKey, getUsersKey, initTelemetry, isDeepEqual, isProjectUserNotFoundClientError, isStudioConfig, parseCommentsOptionsKey, parseQueryKey, parseUsersKey, pickProperties, randomUuid, trackHookMounted, transformProjectionToPreview } from "@sanity/sdk/_internal";
 import { StrictMode, Suspense, createContext, use, useCallback, useContext, useEffect, useInsertionEffect, useMemo, useRef, useState, useSyncExternalStore, useTransition } from "react";
 import { ErrorBoundary, getErrorMessage } from "react-error-boundary";
 import { SDK_CHANNEL_NAME, SDK_NODE_NAME } from "@sanity/message-protocol";
-import { getNodeState, getOrCreateChannel, getOrCreateController, releaseChannel } from "@sanity/sdk/comlink";
-import { EMPTY, Observable, distinctUntilChanged, filter, firstValueFrom, from, identity, of, startWith, switchMap } from "rxjs";
+import { getOrCreateChannel, getOrCreateController, releaseChannel } from "@sanity/sdk/comlink";
+import { EMPTY, Observable, distinctUntilChanged, filter, firstValueFrom, identity, startWith, switchMap } from "rxjs";
 import { Fragment, jsx, jsxs } from "react/jsx-runtime";
-import { catchError, switchMap as switchMap$1 } from "rxjs/operators";
 import { createRoot } from "react-dom/client";
 import { agentGenerate, agentPatch, agentPrompt, agentTransform, agentTranslate } from "@sanity/sdk/agent";
 import "groq";
 import "@sanity/types";
 export * from "@sanity/sdk";
-const SanityInstanceContext = createContext(null), useSanityInstance = () => {
-	let instance = useContext(SanityInstanceContext);
-	if (!instance) throw Error("SanityInstance context not found. Please ensure that your component is wrapped in a ResourceProvider or a SanityApp component.");
-	return instance;
-};
-function createStateSourceHook(options) {
-	let getState = typeof options == "function" ? options : options.getState, suspense = "shouldSuspend" in options && "suspender" in options ? options : void 0;
-	function useHook(...t0) {
-		let $ = c(3), params = t0, instance = useSanityInstance();
-		if (suspense?.suspender && suspense?.shouldSuspend?.(instance, ...params)) throw suspense.suspender(instance, ...params);
-		let t1;
-		$[0] !== instance || $[1] !== params ? (t1 = getState(instance, ...params), $[0] = instance, $[1] = params, $[2] = t1) : t1 = $[2];
-		let state = t1;
-		return useSyncExternalStore(state.subscribe, state.getCurrent);
-	}
-	return useHook;
-}
-/**
-* @internal
-* A React hook that subscribes to authentication state changes.
-*
-* This hook provides access to the current authentication state type from the Sanity auth store.
-* It automatically re-renders when the authentication state changes.
-*
-* @remarks
-* The hook uses `useSyncExternalStore` to safely subscribe to auth state changes
-* and ensure consistency between server and client rendering.
-*
-* @returns The current authentication state type
-*
-* @example
-* ```tsx
-* function AuthStatus() {
-*   const authState = useAuthState()
-*   return <div>Current auth state: {authState}</div>
-* }
-* ```
-*/
-const useAuthState = createStateSourceHook(getAuthState), useNodeState = createStateSourceHook({
-	getState: getNodeState,
-	shouldSuspend: (instance, nodeInput) => getNodeState(instance, nodeInput).getCurrent() === void 0,
-	suspender: (instance, nodeInput) => firstValueFrom(getNodeState(instance, nodeInput).observable.pipe(filter(Boolean)))
-});
-/**
-* @internal
-* Hook to wrap a Comlink node in a React hook.
-* Our store functionality takes care of the lifecycle of the node,
-* as well as sharing a single node between invocations if they share the same name.
-*
-* Generally not to be used directly, but to be used as a dependency of
-* Comlink-powered hooks like `useManageFavorite`.
-*/
-function useWindowConnection(t0) {
-	let $ = c(19), { name, connectTo, onMessage } = t0, t1;
-	$[0] !== connectTo || $[1] !== name ? (t1 = {
-		name,
-		connectTo
-	}, $[0] = connectTo, $[1] = name, $[2] = t1) : t1 = $[2];
-	let { node } = useNodeState(t1), t2;
-	$[3] === Symbol.for("react.memo_cache_sentinel") ? (t2 = [], $[3] = t2) : t2 = $[3];
-	let messageUnsubscribers = useRef(t2), instance = useSanityInstance(), t3;
-	$[4] !== node || $[5] !== onMessage ? (t3 = () => (onMessage && Object.entries(onMessage).forEach((t4) => {
-		let [type, handler] = t4, messageUnsubscribe = node.on(type, handler);
-		messageUnsubscribe && messageUnsubscribers.current.push(messageUnsubscribe);
-	}), () => {
-		messageUnsubscribers.current.forEach(_temp$9), messageUnsubscribers.current = [];
-	}), $[4] = node, $[5] = onMessage, $[6] = t3) : t3 = $[6];
-	let t4;
-	$[7] !== instance || $[8] !== name || $[9] !== node || $[10] !== onMessage ? (t4 = [
-		instance,
-		name,
-		onMessage,
-		node
-	], $[7] = instance, $[8] = name, $[9] = node, $[10] = onMessage, $[11] = t4) : t4 = $[11], useEffect(t3, t4);
-	let t5;
-	$[12] === node ? t5 = $[13] : (t5 = (type_0, data) => {
-		node.post(type_0, data);
-	}, $[12] = node, $[13] = t5);
-	let sendMessage = t5, t6;
-	$[14] === node ? t6 = $[15] : (t6 = (type_1, data_0, fetchOptions) => node.fetch(type_1, data_0, fetchOptions ?? {}), $[14] = node, $[15] = t6);
-	let fetch = t6, t7;
-	return $[16] !== fetch || $[17] !== sendMessage ? (t7 = {
-		sendMessage,
-		fetch
-	}, $[16] = fetch, $[17] = sendMessage, $[18] = t7) : t7 = $[18], t7;
-}
-function _temp$9(unsubscribe) {
-	return unsubscribe();
-}
 /**
 * Component that handles token refresh in dashboard mode
 */
@@ -162,87 +73,6 @@ const ComlinkTokenRefreshProvider = (t0) => {
 		return $[0] === children ? t1 = $[1] : (t1 = /* @__PURE__ */ jsx(DashboardTokenRefresh, { children }), $[0] = children, $[1] = t1), t1;
 	}
 	return children;
-}, OS_BUS_KEY = Symbol.for("sanity.os.bus");
-/**
-* Whether this app is running as a federated remote inside the workbench.
-*
-* Federation shares the host's realm, so the installed bus is visible on
-* `globalThis`. This is `false` in a standalone app, where we must never import
-* `@sanity/workbench` (it would install a bus and add bundle weight for no
-* reason). Note: this is a different embedding model to the Core UI iframe,
-* which is detected separately via the dashboard context — that signal is not
-* set on the federation path.
-*
-* @internal
-*/
-function isWorkbenchEnvironment() {
-	return typeof globalThis == "object" && OS_BUS_KEY in globalThis;
-}
-/**
-* Observes the session token issued by the workbench "OS", tracking the OS auth
-* state over time.
-*
-* Returns `undefined` when the app is not embedded in the workbench, so the
-* caller uses its normal auth flow. Inside the workbench, subscribes to the
-* `auth.token` state topic, emitting the current token — or `null` when the OS
-* is signed out — and re-emitting as the OS auth state changes, so sign-in/out
-* propagates instead of being captured once. Any bus error is treated as "no
-* token" (`null`). The token is used in-memory only and never persisted.
-*
-* @internal
-*/
-function observeWorkbenchToken() {
-	if (isWorkbenchEnvironment()) return from(import("@sanity/workbench")).pipe(switchMap$1(({ os }) => os.subscribe("auth.token")), catchError(() => of(null)));
-}
-/**
-* Asks the workbench "OS" to reissue the session token, e.g. after its current
-* one was rejected with a 401. Fire-and-forget: the reissued token arrives via
-* the `auth.token` subscription in {@link observeWorkbenchToken}. No-op outside
-* the workbench.
-*
-* @internal
-*/
-function refreshWorkbenchToken() {
-	isWorkbenchEnvironment() && import("@sanity/workbench").then(({ os }) => os.emit("auth.token.refresh", void 0), () => {});
-}
-/**
-* Keeps the SDK auth token in sync with the workbench "OS".
-*
-* When running as a federated remote inside the workbench the OS owns the
-* session, so we subscribe to its `auth.token` stream and mirror each value into
-* the auth store — a token logs us in, `null` logs us out, and later OS
-* sign-in/out propagates automatically. When a request is rejected with a 401
-* (the token expired), we ask the OS to reissue rather than tearing the session
-* down; the new token arrives back through the same subscription.
-*/
-function WorkbenchTokenRefresh(t0) {
-	let $ = c(8), { children } = t0, instance = useSanityInstance(), authState = useAuthState(), processed401ErrorRef = useRef(null), t1, t2;
-	$[0] === instance ? (t1 = $[1], t2 = $[2]) : (t1 = () => {
-		let token$ = observeWorkbenchToken();
-		if (!token$) return;
-		let subscription = token$.subscribe((token) => setAuthToken(instance, token));
-		return () => subscription.unsubscribe();
-	}, t2 = [instance], $[0] = instance, $[1] = t1, $[2] = t2), useEffect(t1, t2);
-	let t3;
-	$[3] !== authState.error || $[4] !== authState.type ? (t3 = () => {
-		let has401Error = authState.type === AuthStateType.ERROR && authState.error?.statusCode === 401;
-		has401Error && processed401ErrorRef.current !== authState.error ? (processed401ErrorRef.current = authState.error, refreshWorkbenchToken()) : has401Error || (processed401ErrorRef.current = null);
-	}, $[3] = authState.error, $[4] = authState.type, $[5] = t3) : t3 = $[5];
-	let t4;
-	return $[6] === authState ? t4 = $[7] : (t4 = [authState], $[6] = authState, $[7] = t4), useEffect(t3, t4), children;
-}
-/**
-* Provides workbench OS token refresh. No-op outside the workbench, where the
-* app uses its normal auth flow.
-* @public
-*/
-const WorkbenchTokenRefreshProvider = (t0) => {
-	let $ = c(2), { children } = t0;
-	if (isWorkbenchEnvironment()) {
-		let t1;
-		return $[0] === children ? t1 = $[1] : (t1 = /* @__PURE__ */ jsx(WorkbenchTokenRefresh, { children }), $[0] = children, $[1] = t1), t1;
-	}
-	return children;
 };
 /**
 * @internal
@@ -699,7 +529,7 @@ function AuthBoundary(t0) {
 	let t4;
 	$[7] === props ? t4 = $[8] : (t4 = /* @__PURE__ */ jsx(AuthSwitch, { ...props }), $[7] = props, $[8] = t4);
 	let t5;
-	return $[9] !== FallbackComponent || $[10] !== t3 || $[11] !== t4 ? (t5 = /* @__PURE__ */ jsx(ComlinkTokenRefreshProvider, { children: /* @__PURE__ */ jsx(WorkbenchTokenRefreshProvider, { children: /* @__PURE__ */ jsx(ErrorBoundary, {
+	return $[9] !== FallbackComponent || $[10] !== t3 || $[11] !== t4 ? (t5 = /* @__PURE__ */ jsx(ComlinkTokenRefreshProvider, { children: /* @__PURE__ */ jsx(DashboardTokenRefreshProvider, { children: /* @__PURE__ */ jsx(ErrorBoundary, {
 		FallbackComponent,
 		resetKeys: t3,
 		children: t4
@@ -712,7 +542,7 @@ function AuthSwitch(t0) {
 	$[6] === instance.config ? t3 = $[7] : (t3 = isStudioConfig(instance.config), $[6] = instance.config, $[7] = t3);
 	let isStudio = t3, orgError = useVerifyOrgProjects(!verifyOrganization || isStudio || authState.type !== AuthStateType.LOGGED_IN, projectIds), isLoggedOut = authState.type === AuthStateType.LOGGED_OUT && !authState.isDestroyingSession, loginUrl = useLoginUrl(), t4, t5;
 	if ($[8] !== isLoggedOut || $[9] !== isStudio || $[10] !== loginUrl ? (t4 = () => {
-		isLoggedOut && !isInIframe() && !isStudio && !isWorkbenchEnvironment() && (window.location.href = loginUrl);
+		isLoggedOut && !isInIframe() && !isStudio && !isDashboardEnvironment() && (window.location.href = loginUrl);
 	}, t5 = [
 		isLoggedOut,
 		loginUrl,
@@ -771,31 +601,6 @@ SDKStudioContext.displayName = "SDKStudioContext";
 */
 const DEFAULT_RESOURCE_NAME = "default";
 /**
-* @public
-*
-* A React hook that retrieves the dashboard organization ID that is currently selected in the Sanity Dashboard.
-*
-* @example
-* ```tsx
-* function DashboardComponent() {
-*   const orgId = useDashboardOrganizationId()
-*
-*   if (!orgId) return null
-*
-*   return <div>Organization ID: {String(orgId)}</div>
-* }
-* ```
-*
-* @category Dashboard
-* @returns The dashboard organization ID (string | undefined)
-*/
-function useDashboardOrganizationId() {
-	let $ = c(2), instance = useSanityInstance(), t0;
-	$[0] === instance ? t0 = $[1] : (t0 = getDashboardOrganizationId(instance), $[0] = instance, $[1] = t0);
-	let { subscribe, getCurrent } = t0;
-	return useSyncExternalStore(subscribe, getCurrent);
-}
-/**
 * Gets the id of the first resource from a settled request result. The request
 * is already scoped to a single organization, so the first item is the one we want.
 */
@@ -813,11 +618,11 @@ async function resolveOrgResources(instance, organizationId) {
 		apiVersion: "v2026-07-09",
 		scope: "global"
 	}).observable), [mediaLibrariesResult, canvasesResult] = await Promise.allSettled([client.request({
-		uri: "/media-libraries",
+		url: "/media-libraries",
 		query: { organizationId },
 		tag: "org-resources.media-libraries"
 	}), client.request({
-		uri: "/canvases",
+		url: "/canvases",
 		query: { organizationId },
 		tag: "org-resources.canvases"
 	})]), mediaLibraryId = getFirstResourceId(mediaLibrariesResult), canvasId = getFirstResourceId(canvasesResult);
@@ -870,7 +675,7 @@ function InferredResourcesProvider(t0) {
 function OrganizationResourcesProvider(t0) {
 	let $ = c(10), { resources: t1, inferMediaLibraryAndCanvas, children } = t0, t2;
 	$[0] === t1 ? t2 = $[1] : (t2 = t1 === void 0 ? {} : t1, $[0] = t1, $[1] = t2);
-	let explicitResources = t2, instance = useSanityInstance(), orgId = useDashboardOrganizationId();
+	let explicitResources = t2, instance = useSanityInstance(), orgId = useOrganizationId();
 	if (!inferMediaLibraryAndCanvas || !orgId) {
 		let t3;
 		return $[2] !== children || $[3] !== explicitResources ? (t3 = /* @__PURE__ */ jsx(ResourcesContext.Provider, {
@@ -1885,71 +1690,6 @@ function useAgentPatch(resourceHandle) {
 	return $[2] !== instance || $[3] !== resource ? (t1 = (options) => firstValueFrom(agentPatch(instance, options, resource)), $[2] = instance, $[3] = resource, $[4] = t1) : t1 = $[4], t1;
 }
 /**
-* @public
-* Hook for emitting agent resource context updates to the Dashboard.
-* This allows the Agent to understand what resource the user is currently
-* interacting with (e.g., which document they're editing).
-*
-* The hook will automatically emit the context when it changes, and also
-* emit the initial context when the hook is first mounted.
-*
-* @category Agent
-* @param options - The resource context options containing projectId, dataset, and optional documentId
-*
-* @example
-* ```tsx
-* import {useAgentResourceContext} from '@sanity/sdk-react'
-*
-* function MyComponent() {
-*   const documentId = 'my-document-id'
-*
-*   // Automatically updates the Agent's context whenever the document changes
-*   useAgentResourceContext({
-*     projectId: 'my-project',
-*     dataset: 'production',
-*     documentId,
-*   })
-*
-*   return <div>Editing document: {documentId}</div>
-* }
-* ```
-*/
-function useAgentResourceContext(options) {
-	let $ = c(9), { projectId, dataset, documentId } = options, t0;
-	$[0] === Symbol.for("react.memo_cache_sentinel") ? (t0 = {
-		name: SDK_NODE_NAME,
-		connectTo: SDK_CHANNEL_NAME
-	}, $[0] = t0) : t0 = $[0];
-	let { sendMessage } = useWindowConnection(t0), lastContextRef = useRef(null), t1;
-	$[1] !== dataset || $[2] !== documentId || $[3] !== projectId || $[4] !== sendMessage ? (t1 = () => {
-		if (!projectId || !dataset) {
-			console.warn("[useAgentResourceContext] projectId and dataset are required", {
-				projectId,
-				dataset
-			});
-			return;
-		}
-		let contextKey = `${projectId}:${dataset}:${documentId || ""}`;
-		if (lastContextRef.current !== contextKey) try {
-			let message = {
-				type: "dashboard/v1/events/agent/resource/update",
-				data: {
-					projectId,
-					dataset,
-					documentId
-				}
-			};
-			sendMessage(message.type, message.data), lastContextRef.current = contextKey;
-		} catch (t2) {
-			console.error("[useAgentResourceContext] Failed to update context:", t2);
-		}
-	}, $[1] = dataset, $[2] = documentId, $[3] = projectId, $[4] = sendMessage, $[5] = t1) : t1 = $[5];
-	let updateContext = t1, t2, t3;
-	$[6] === updateContext ? (t2 = $[7], t3 = $[8]) : (t2 = () => {
-		updateContext();
-	}, t3 = [updateContext], $[6] = updateContext, $[7] = t2, $[8] = t3), useEffect(t2, t3);
-}
-/**
 * Returns a single application by id.
 *
 * The hook suspends until the first fetch succeeds, so `data` is always present.
@@ -2300,311 +2040,52 @@ function useResource() {
 	return useEffectiveContextResource();
 }
 /**
-* @public
-*
-* A helper hook designed to be injected into routing components for apps within the Dashboard.
-* While the Dashboard can usually handle navigation, there are special cases when you
-* are already within a target app, and need to navigate to another route inside of that app.
-*
-* For example, your user might "favorite" a document inside of your application.
-* If they click on the Dashboard favorites item in the sidebar, and are already within your application,
-* there needs to be some way for the dashboard to signal to your application to reroute to where that document was favorited.
-*
-* This hook is intended to receive those messages, and takes a function to route to the correct path.
+* Resolves {@link UseFavoriteProps} into the {@link FavoriteDocumentContext}
+* shared by the favorites fetcher and mutation, defaulting a studio `resourceId`
+* from the instance's project and dataset.
 *
-* @param navigateFn - Function to handle navigation; should accept:
-* - `path`: a string, which will be a relative path (for example, 'my-route')
-* - `type`: 'push', 'replace', or 'pop', which will be the type of navigation to perform
-*
-* @example
-* ```tsx
-* import {useDashboardNavigate} from '@sanity/sdk-react'
-* import {BrowserRouter, useNavigate} from 'react-router'
-* import {Suspense} from 'react'
-*
-* function DashboardNavigationHandler() {
-*   const navigate = useNavigate()
-*   useDashboardNavigate(({path, type}) => {
-*     navigate(path, {replace: type === 'replace'})
-*   })
-*   return null
-* }
-*
-* // Wrap the component with Suspense since the hook may suspend
-* function MyApp() {
-*   return (
-*     <BrowserRouter>
-*       <Suspense>
-*         <DashboardNavigationHandler />
-*       </Suspense>
-*     </BrowserRouter>
-*   )
-* }
-* ```
-*/
-function useDashboardNavigate(navigateFn) {
-	let $ = c(2), t0;
-	$[0] === navigateFn ? t0 = $[1] : (t0 = {
-		name: SDK_NODE_NAME,
-		connectTo: SDK_CHANNEL_NAME,
-		onMessage: { "dashboard/v1/history/change-path": (data) => {
-			navigateFn(data);
-		} }
-	}, $[0] = navigateFn, $[1] = t0), useWindowConnection(t0);
-}
-/**
 * @internal
-*
-* This hook provides functionality to add and remove documents from favorites,
-* and tracks the current favorite status of the document.
-* @param documentHandle - The document handle containing document ID and type, like `{_id: '123', _type: 'book'}`
-* @returns An object containing:
-* - `favorite` - Function to add document to favorites
-* - `unfavorite` - Function to remove document from favorites
-* - `isFavorited` - Boolean indicating if document is currently favorited
-*
-* @example
-* ```tsx
-* function FavoriteButton(props: DocumentActionProps) {
-*   const {documentId, documentType} = props
-*   const {favorite, unfavorite, isFavorited} = useManageFavorite({
-*     documentId,
-*     documentType
-*   })
-*
-*   return (
-*     <Button
-*       onClick={() => isFavorited ? unfavorite() : favorite()}
-*       text={isFavorited ? 'Remove from favorites' : 'Add to favorites'}
-*     />
-*   )
-* }
-*
-* // Wrap the component with Suspense since the hook may suspend
-* function MyDocumentAction(props: DocumentActionProps) {
-*   return (
-*     <Suspense
-*       fallback={
-*         <Button
-*           text="Loading..."
-*           disabled
-*         />
-*       }
-*     >
-*       <FavoriteButton {...props} />
-*     </Suspense>
-*   )
-* }
-* ```
 */
-function useManageFavorite({ documentId, documentType, projectId: paramProjectId, dataset: paramDataset, resourceId: paramResourceId, resourceType, schemaName }) {
-	let { fetch } = useWindowConnection({
-		name: SDK_NODE_NAME,
-		connectTo: SDK_CHANNEL_NAME
-	}), instance = useSanityInstance(), { config } = instance, instanceProjectId = config?.projectId, instanceDataset = config?.dataset, projectId = paramProjectId ?? instanceProjectId, dataset = paramDataset ?? instanceDataset;
+function useFavoriteContext(t0) {
+	let $ = c(6), { documentId, documentType, projectId: paramProjectId, dataset: paramDataset, resourceId: paramResourceId, resourceType, schemaName } = t0, { config } = useSanityInstance(), projectId = paramProjectId ?? config?.projectId, dataset = paramDataset ?? config?.dataset;
 	if (resourceType === "studio" && (!projectId || !dataset)) throw Error("projectId and dataset are required for studio resources");
 	let resourceId = resourceType === "studio" && !paramResourceId ? `${projectId}.${dataset}` : paramResourceId;
 	if (!resourceId) throw Error("resourceId is required for media-library and canvas resources");
-	let context = useMemo(() => ({
-		documentId,
-		documentType,
-		resourceId,
-		resourceType,
-		schemaName
-	}), [
+	let t1;
+	return $[0] !== documentId || $[1] !== documentType || $[2] !== resourceId || $[3] !== resourceType || $[4] !== schemaName ? (t1 = {
 		documentId,
 		documentType,
 		resourceId,
 		resourceType,
 		schemaName
-	]), favoriteState = getFavoritesState(instance, context), isFavorited = useSyncExternalStore(favoriteState.subscribe, favoriteState.getCurrent)?.isFavorited ?? !1, handleFavoriteAction = useCallback(async (action) => {
-		if (!(!fetch || !documentId || !documentType || !resourceType)) try {
-			let payload = {
-				eventType: action,
-				document: {
-					id: documentId,
-					type: documentType,
-					resource: {
-						id: resourceId,
-						type: resourceType,
-						...schemaName ? { schemaName } : {}
-					}
-				}
-			};
-			(await fetch("dashboard/v1/events/favorite/mutate", payload)).success && await resolveFavoritesState(instance, context);
-		} catch (err) {
-			throw console.error(`Failed to ${action === "added" ? "favorite" : "unfavorite"} document:`, err), err;
-		}
-	}, [
-		fetch,
-		documentId,
-		documentType,
-		resourceId,
-		resourceType,
-		schemaName,
-		instance,
-		context
-	]);
-	return {
-		favorite: useCallback(() => handleFavoriteAction("added"), [handleFavoriteAction]),
-		unfavorite: useCallback(() => handleFavoriteAction("removed"), [handleFavoriteAction]),
-		isFavorited
-	};
+	}, $[0] = documentId, $[1] = documentType, $[2] = resourceId, $[3] = resourceType, $[4] = schemaName, $[5] = t1) : t1 = $[5], t1;
 }
+const useFavoriteStatus = createFetcherHook(favorites);
 /**
-* Hook that fetches studio workspaces and organizes them by projectId:dataset
 * @internal
 *
-* @example
-* ```tsx
-* import {useStudioWorkspacesByProjectIdDataset} from '@sanity/sdk-react'
-* import {Card, Code, Button} from '@sanity/ui'
-* import {Suspense} from 'react'
+* Reads whether a document is currently favorited. The write-side counterpart is
+* {@link useUpdateFavorite}.
 *
-* function WorkspacesCard() {
-*   const {workspacesByProjectIdAndDataset, error} = useStudioWorkspacesByProjectIdDataset()
-*   if (error) {
-*     return <div>Error: {error}</div>
-*   }
-*   return (
-*     <Card padding={4} radius={2} shadow={1}>
-*       <Code language="json">
-*         {JSON.stringify(workspacesByProjectIdAndDataset, null, 2)}
-*       </Code>
-*     </Card>
-*   )
-* }
+* The hook suspends until the first favorite status resolves, so wrap the
+* component in a `<Suspense>` boundary.
 *
-* // Wrap the component with Suspense since the hook may suspend
-* function DashboardWorkspaces() {
-*   return (
-*     <Suspense fallback={<Button text="Loading..." disabled />}>
-*       <WorkspacesCard />
-*     </Suspense>
-*   )
-* }
-* ```
-*/
-function useStudioWorkspacesByProjectIdDataset() {
-	let $ = c(8), t0;
-	$[0] === Symbol.for("react.memo_cache_sentinel") ? (t0 = {}, $[0] = t0) : t0 = $[0];
-	let [workspacesByProjectIdAndDataset, setWorkspacesByProjectIdAndDataset] = useState(t0), [error, setError] = useState(null), t1;
-	$[1] === Symbol.for("react.memo_cache_sentinel") ? (t1 = {
-		name: SDK_NODE_NAME,
-		connectTo: SDK_CHANNEL_NAME
-	}, $[1] = t1) : t1 = $[1];
-	let { fetch } = useWindowConnection(t1), t2, t3;
-	$[2] === fetch ? (t2 = $[3], t3 = $[4]) : (t2 = () => {
-		if (!fetch) return;
-		let fetchWorkspaces = async function fetchWorkspaces(signal) {
-			try {
-				let data = await fetch("dashboard/v1/context", void 0, { signal }), workspaceMap = {}, noProjectIdAndDataset = [];
-				data.context.availableResources.forEach((resource) => {
-					if (resource.type !== "studio") return;
-					if (!resource.projectId || !resource.dataset) {
-						noProjectIdAndDataset.push(resource);
-						return;
-					}
-					let key = `${resource.projectId}:${resource.dataset}`;
-					workspaceMap[key] || (workspaceMap[key] = []), workspaceMap[key].push(resource);
-				}), noProjectIdAndDataset.length > 0 && (workspaceMap["NO_PROJECT_ID:NO_DATASET"] = noProjectIdAndDataset), setWorkspacesByProjectIdAndDataset(workspaceMap), setError(null);
-			} catch (t4) {
-				let err = t4;
-				if (err instanceof Error) {
-					if (err.name === "AbortError") return;
-					setError("Failed to fetch workspaces");
-				}
-			}
-		}, controller = new AbortController();
-		return fetchWorkspaces(controller.signal), () => {
-			controller.abort();
-		};
-	}, t3 = [fetch], $[2] = fetch, $[3] = t2, $[4] = t3), useEffect(t2, t3);
-	let t4;
-	return $[5] !== error || $[6] !== workspacesByProjectIdAndDataset ? (t4 = {
-		workspacesByProjectIdAndDataset,
-		error
-	}, $[5] = error, $[6] = workspacesByProjectIdAndDataset, $[7] = t4) : t4 = $[7], t4;
-}
-/**
-* @public
-*
-* Hook that provides a function to navigate to a given document in its parent Studio.
-*
-* Uses the `projectId` and `dataset` properties of the {@link DocumentHandle} you provide to resolve the correct Studio.
-* This will only work if you have deployed a studio with a workspace with this `projectId` / `dataset` combination.
-*
-* @remarks If you write your own Document Handle to pass to this hook (as opposed to a Document Handle generated by another hook),
-* it must include values for `documentId`, `documentType`, `projectId`, and `dataset`.
-*
-* @category Documents
-* @param documentHandle - The document handle for the document to navigate to
-* @param preferredStudioUrl - The preferred studio url to navigate to if you have multiple
-* studios with the same projectId and dataset
-* @returns An object containing:
-* - `navigateToStudioDocument` - Function that when called will navigate to the studio document
+* @param props - The document handle plus the resource it lives in.
+* @returns `true` when the document is favorited, otherwise `false`.
 *
 * @example
 * ```tsx
-* import {useNavigateToStudioDocument, type DocumentHandle} from '@sanity/sdk-react'
-* import {Button} from '@sanity/ui'
-* import {Suspense} from 'react'
-*
-* function NavigateButton({documentHandle}: {documentHandle: DocumentHandle}) {
-*   const {navigateToStudioDocument} = useNavigateToStudioDocument(documentHandle)
-*   return (
-*     <Button
-*       onClick={navigateToStudioDocument}
-*       text="Navigate to Studio Document"
-*     />
-*   )
-* }
+* function FavoriteLabel(props: DocumentActionProps) {
+*   const {documentId, documentType} = props
+*   const isFavorited = useFavorite({documentId, documentType, resourceType: 'studio'})
 *
-* // Wrap the component with Suspense since the hook may suspend
-* function MyDocumentAction({documentHandle}: {documentHandle: DocumentHandle}) {
-*   return (
-*     <Suspense fallback={<Button text="Loading..." disabled />}>
-*       <NavigateButton documentHandle={documentHandle} />
-*     </Suspense>
-*   )
+*   return <span>{isFavorited ? 'Favorited' : 'Not favorited'}</span>
 * }
 * ```
 */
-function useNavigateToStudioDocument(documentHandle, preferredStudioUrl) {
-	let $ = c(8), { workspacesByProjectIdAndDataset } = useStudioWorkspacesByProjectIdDataset(), t0;
-	$[0] === Symbol.for("react.memo_cache_sentinel") ? (t0 = {
-		name: SDK_NODE_NAME,
-		connectTo: SDK_CHANNEL_NAME
-	}, $[0] = t0) : t0 = $[0];
-	let { sendMessage } = useWindowConnection(t0), t1;
-	$[1] !== documentHandle || $[2] !== preferredStudioUrl || $[3] !== sendMessage || $[4] !== workspacesByProjectIdAndDataset ? (t1 = () => {
-		let { projectId, dataset } = documentHandle;
-		if (!projectId || !dataset) {
-			console.warn("Project ID and dataset are required to navigate to a studio document");
-			return;
-		}
-		let workspace;
-		if (preferredStudioUrl) workspace = [...workspacesByProjectIdAndDataset[`${projectId}:${dataset}`] || [], ...workspacesByProjectIdAndDataset["NO_PROJECT_ID:NO_DATASET"] || []].find((w) => w.url === preferredStudioUrl);
-		else {
-			let workspaces = workspacesByProjectIdAndDataset[`${projectId}:${dataset}`];
-			workspaces?.length > 1 && (console.warn("Multiple workspaces found for document and no preferred studio url", documentHandle), console.warn("Using the first one", workspaces[0])), workspace = workspaces?.[0];
-		}
-		if (!workspace) {
-			console.warn(`No workspace found for document with projectId: ${projectId} and dataset: ${dataset}${preferredStudioUrl ? ` or with preferred studio url: ${preferredStudioUrl}` : ""}`);
-			return;
-		}
-		let message = {
-			type: "dashboard/v1/bridge/navigate-to-resource",
-			data: {
-				resourceId: workspace.id,
-				resourceType: "studio",
-				path: `/intent/edit/id=${documentHandle.documentId};type=${documentHandle.documentType}`
-			}
-		};
-		sendMessage(message.type, message.data);
-	}, $[1] = documentHandle, $[2] = preferredStudioUrl, $[3] = sendMessage, $[4] = workspacesByProjectIdAndDataset, $[5] = t1) : t1 = $[5];
-	let navigateToStudioDocument = t1, t2;
-	return $[6] === navigateToStudioDocument ? t2 = $[7] : (t2 = { navigateToStudioDocument }, $[6] = navigateToStudioDocument, $[7] = t2), t2;
+function useFavorite(props) {
+	let context = useFavoriteContext(props), { data } = useFavoriteStatus(context);
+	return data.isFavorited;
 }
 /**
 * @internal
@@ -2682,75 +2163,65 @@ function useRecordDocumentHistoryEvent(t0) {
 	let recordEvent = t2, t3;
 	return $[8] === recordEvent ? t3 = $[9] : (t3 = { recordEvent }, $[8] = recordEvent, $[9] = t3), t3;
 }
-function resolveAppTitle(resource) {
-	return resource.manifest?.title || resource.activeDeployment?.manifest?.title || resource.title;
-}
+const useSetFavorite = createMutationHook(setFavorite);
 /**
-* Sets the browser's document title, automatically including the app's name
-* from the manifest.
-*
-* This follows the same convention as Sanity Studio workspaces, where the
-* workspace name is always present in the title:
+* @internal
 *
-* - With a view title: `<viewTitle> | <appTitle>`
-* - Without a view title: `<appTitle>`
+* Adds or removes a document from favorites. The read-side counterpart is
+* {@link useFavorite}, which reflects the change once the mutation settles.
 *
-* The Sanity dashboard appends `| Sanity` to produce the final browser tab title.
+* Unlike {@link useFavorite}, this hook does not suspend.
 *
-* @param viewTitle - An optional view-specific title to prepend to the app title.
+* @param props - The document handle plus the resource it lives in.
+* @returns `favorite`/`unfavorite` actions and the `{isPending, error, reset}`
+*   mutation state.
 *
 * @example
 * ```tsx
-* import {useWindowTitle} from '@sanity/sdk-react'
+* function FavoriteButton(props: DocumentActionProps) {
+*   const {documentId, documentType} = props
+*   const handle = {documentId, documentType, resourceType: 'studio'} as const
+*   const isFavorited = useFavorite(handle)
+*   const {favorite, unfavorite, isPending} = useUpdateFavorite(handle)
 *
-* function MoviesList() {
-*   useWindowTitle('Movies')
-*   return <div>...</div>
+*   return (
+*     <Button
+*       disabled={isPending}
+*       onClick={() => (isFavorited ? unfavorite() : favorite())}
+*       text={isFavorited ? 'Remove from favorites' : 'Add to favorites'}
+*     />
+*   )
 * }
 *
-* // Browser tab: "Movies | My App | Sanity"
-* ```
-*
-* @example
-* ```tsx
-* // Call without arguments to show just the app title
-* function AppRoot() {
-*   useWindowTitle()
-*   return <Outlet />
+* // Wrap the component with Suspense since useFavorite suspends
+* function MyDocumentAction(props: DocumentActionProps) {
+*   return (
+*     <Suspense fallback={<Button text="Loading..." disabled />}>
+*       <FavoriteButton {...props} />
+*     </Suspense>
+*   )
 * }
-*
-* // Browser tab: "My App | Sanity"
 * ```
-*
-* @public
 */
-function useWindowTitle(viewTitle) {
-	let [appTitle, setAppTitle] = useState(null), { fetch } = useWindowConnection({
-		name: SDK_NODE_NAME,
-		connectTo: SDK_CHANNEL_NAME
-	});
-	useEffect(() => {
-		if (!fetch) return;
-		let controller = new AbortController();
-		async function fetchAppTitle(signal) {
-			try {
-				let title = resolveAppTitle((await fetch("dashboard/v1/context", void 0, { signal })).context.resource) || document.title;
-				title && setAppTitle(title);
-			} catch (err) {
-				if (err instanceof Error && err.name === "AbortError") return;
-				console.error("Failed to fetch app title from dashboard context:", err);
-			}
-		}
-		return fetchAppTitle(controller.signal), () => {
-			controller.abort();
-		};
-	}, [fetch]), useEffect(() => {
-		if (!appTitle) return;
-		let previous = document.title;
-		return document.title = viewTitle ? `${viewTitle} | ${appTitle}` : appTitle, () => {
-			document.title = previous;
-		};
-	}, [viewTitle, appTitle]);
+function useUpdateFavorite(props) {
+	let $ = c(12), context = useFavoriteContext(props), { mutate, isPending, error, reset } = useSetFavorite(), t0;
+	$[0] !== context || $[1] !== mutate ? (t0 = () => mutate({
+		...context,
+		isFavorited: !0
+	}), $[0] = context, $[1] = mutate, $[2] = t0) : t0 = $[2];
+	let favorite = t0, t1;
+	$[3] !== context || $[4] !== mutate ? (t1 = () => mutate({
+		...context,
+		isFavorited: !1
+	}), $[3] = context, $[4] = mutate, $[5] = t1) : t1 = $[5];
+	let unfavorite = t1, t2;
+	return $[6] !== error || $[7] !== favorite || $[8] !== isPending || $[9] !== reset || $[10] !== unfavorite ? (t2 = {
+		favorite,
+		unfavorite,
+		isPending,
+		error,
+		reset
+	}, $[6] = error, $[7] = favorite, $[8] = isPending, $[9] = reset, $[10] = unfavorite, $[11] = t2) : t2 = $[11], t2;
 }
 /**
 * Resolves the effective `projectId` for project-scoped hooks (`useProject`,
@@ -2773,17 +2244,44 @@ function useResolvedProjectId(options) {
 	let { resource } = useNormalizedResourceOptions(t0), contextProjectId = useContext(ProjectContext), t1;
 	return $[2] !== contextProjectId || $[3] !== options?.projectId || $[4] !== resource ? (t1 = options?.projectId ?? contextProjectId ?? (resource && isDatasetResource(resource) ? resource.projectId : void 0), $[2] = contextProjectId, $[3] = options?.projectId, $[4] = resource, $[5] = t1) : t1 = $[5], t1;
 }
-const useDatasetsBase = createStateSourceHook({
-	getState: getDatasetsState,
-	shouldSuspend: (instance, projectHandle) => getDatasetsState(instance, projectHandle).getCurrent() === void 0,
-	suspender: resolveDatasets
-}), useDatasets = (options) => {
+const useDatasetsBase = createFetcherHook(datasets);
+/**
+* Returns metadata for each dataset the current user has access to.
+*
+* @category Datasets
+* @param options - Optional project/resource to read datasets for. Defaults to
+*   the resource named in `ResourceProvider`/`SDKProvider`.
+* @returns A {@link FetcherHookResult} whose `data` is the metadata for the
+*   datasets.
+*
+* @example
+* ```tsx
+* const {data: datasets} = useDatasets()
+*
+* return (
+*   <select>
+*     {datasets.map((dataset) => (
+*       <option key={dataset.name}>{dataset.name}</option>
+*     ))}
+*   </select>
+* )
+* ```
+*
+* @remarks
+* The `projectId` is resolved in order from:
+* 1. an explicit `projectId` option
+* 2. A legacy ProjectContext (e.g. a `<ResourceProvider projectId="…">` with no dataset), then
+* 3. The active resource (`ResourceProvider`/`SDKProvider`)
+* 4. `instance.config`.
+* @public
+*/
+function useDatasets(options) {
 	let $ = c(3), projectId = useResolvedProjectId(options), t0;
 	return $[0] !== options || $[1] !== projectId ? (t0 = projectId ? {
 		...options,
 		projectId
 	} : options, $[0] = options, $[1] = projectId, $[2] = t0) : t0 = $[2], useDatasetsBase(t0);
-};
+}
 /**
 * @internal
 *
@@ -3043,7 +2541,7 @@ function useCreateDocument(options) {
 	trackHookUsage(useSanityInstance(), "useCreateDocument");
 	let apply = useApplyDocumentActions(), t0;
 	return $[0] !== apply || $[1] !== options ? (t0 = async (initialValue, overrides) => {
-		let documentId = overrides?.documentId ?? options.documentId ?? crypto.randomUUID(), handle = {
+		let documentId = overrides?.documentId ?? options.documentId ?? randomUuid(), handle = {
 			...options,
 			documentId
 		};
@@ -4515,7 +4013,7 @@ function useUsers(options) {
 		loadMore
 	}, $[20] = data, $[21] = hasMore, $[22] = isPending, $[23] = loadMore, $[24] = t8) : t8 = $[24], t8;
 }
-var version = "3.0.0-rc.2";
+var version = "3.1.0";
 function getEnv(key) {
 	if (import.meta.env) return import.meta.env[key];
 	if (typeof process < "u" && process.env) return process.env[key];
@@ -4526,6 +4024,6 @@ function getEnv(key) {
 * @internal
 */
 const REACT_SDK_VERSION = getEnv("PKG_VERSION") || `${version}-development`;
-export { AuthBoundary, ComlinkTokenRefreshProvider, REACT_SDK_VERSION, ResourceProvider, SDKProvider, SDKStudioContext, SanityApp, SanityInstanceProvider, renderSanityApp, useActiveReleases, useAgentGenerate, useAgentPatch, useAgentPrompt, useAgentResourceContext, useAgentTransform, useAgentTranslate, useAllReleases, useApplication, useApplications, useApplyDocumentActions, useApplyReleaseActions, useAuthState, useAuthToken, useCheckPermissions, useClient, useCommentActions, useCommentThreads, useComments, useCreateDocument, useCurrentUser, useDashboardNavigate, useDashboardOrganizationId, useDatasets, useDeleteApplication, useDocument, useDocumentEvent, useDocumentPermissions, useDocumentPreview, useDocumentProjection, useDocumentSyncStatus, useDocuments, useEditDocument, useFrameConnection, useHandleAuthCallback, useInstallation, useInstallations, useLogOut, useLoginUrl, useManageFavorite, useNavigateToStudioDocument, useOrganization, useOrganizations, usePaginatedDocuments, usePerspective, usePresence, usePresenceForDocument, useProject, useProjects, useQuery, useRecordDocumentHistoryEvent, useReportPresence, useResource, useSanityInstance, useStudioWorkspacesByProjectIdDataset, useUpdateApplication, useUser, useUsers, useVerifyOrgProjects, useWindowConnection, useWindowTitle };
+export { AuthBoundary, ComlinkTokenRefreshProvider, REACT_SDK_VERSION, ResourceProvider, SDKProvider, SDKStudioContext, SanityApp, SanityInstanceProvider, renderSanityApp, useActiveReleases, useAgentGenerate, useAgentPatch, useAgentPrompt, useAgentTransform, useAgentTranslate, useAllReleases, useApplication, useApplications, useApplyDocumentActions, useApplyReleaseActions, useAuthState, useAuthToken, useCheckPermissions, useClient, useCommentActions, useCommentThreads, useComments, useCreateDocument, useCurrentUser, useDatasets, useDeleteApplication, useDocument, useDocumentEvent, useDocumentPermissions, useDocumentPreview, useDocumentProjection, useDocumentSyncStatus, useDocuments, useEditDocument, useFavorite, useFrameConnection, useHandleAuthCallback, useInstallation, useInstallations, useLogOut, useLoginUrl, useOrganization, useOrganizations, usePaginatedDocuments, usePerspective, usePresence, usePresenceForDocument, useProject, useProjects, useQuery, useRecordDocumentHistoryEvent, useReportPresence, useResource, useSanityInstance, useStudioWorkspacesByProjectIdDataset, useUpdateApplication, useUpdateFavorite, useUser, useUsers, useVerifyOrgProjects, useWindowConnection };
 
 //# sourceMappingURL=index.js.map