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

package/dist/_exports/dashboard.d.ts

@@ -0,0 +1,250 @@
+import { DocumentHandle } from "@sanity/sdk";
+import React, { PropsWithChildren } from "react";
+import { PathChangeMessage } from "@sanity/message-protocol";
+/**
+ * Authenticates the SDK with the Sanity Dashboard's session when the app runs
+ * inside the dashboard.
+ *
+ * The dashboard owns the session there: this provider subscribes to the token
+ * the dashboard issues, writes each new value into the SDK's auth store (where
+ * SDK hooks read it from), and asks the dashboard for a fresh token when a
+ * request fails with a 401. Outside the dashboard it renders children
+ * unchanged and the app's normal auth flow applies.
+ *
+ * @remarks
+ * `AuthBoundary` mounts this automatically, so most apps never need it
+ * directly. Mount it yourself only when your app runs inside the dashboard
+ * without `AuthBoundary` — that is, the app renders its own loading and error
+ * UI instead of the SDK's login flow — but still uses SDK hooks such as
+ * `useQuery`, which need the dashboard's token in the auth store to
+ * authenticate their requests.
+ *
+ * Mount it once, inside the provider that creates the Sanity instance whose
+ * store should receive the token.
+ *
+ * @example
+ * ```tsx
+ * import {ResourceProvider} from '@sanity/sdk-react'
+ * import {TokenRefreshProvider} from '@sanity/sdk-react/dashboard'
+ *
+ * function EmbeddedApp() {
+ *   return (
+ *     <ResourceProvider fallback={<Loading />}>
+ *       <TokenRefreshProvider>
+ *         <App />
+ *       </TokenRefreshProvider>
+ *     </ResourceProvider>
+ *   )
+ * }
+ * ```
+ *
+ * @public
+ */
+declare const DashboardTokenRefreshProvider: React.FC<PropsWithChildren>;
+/**
+ * @public
+ */
+interface AgentResourceContextOptions {
+  /**
+   * The project ID of the current context
+   */
+  projectId: string;
+  /**
+   * The dataset of the current context
+   */
+  dataset: string;
+  /**
+   * Optional document ID if the user is viewing/editing a specific document
+   */
+  documentId?: string;
+}
+/**
+ * @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/dashboard'
+ *
+ * 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>
+ * }
+ * ```
+ */
+declare function useAgentResourceContext(options: AgentResourceContextOptions): void;
+/**
+ * @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.
+ *
+ * @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 {useNavigate} from '@sanity/sdk-react/dashboard'
+ * import {BrowserRouter, useNavigate as useRouterNavigate} from 'react-router'
+ * import {Suspense} from 'react'
+ *
+ * function DashboardNavigationHandler() {
+ *   const navigate = useRouterNavigate()
+ *   useNavigate(({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>
+ *   )
+ * }
+ * ```
+ */
+declare function useNavigate(navigateFn: (options: PathChangeMessage['data']) => void): void;
+/**
+ * @public
+ * @category Types
+ */
+interface NavigateToStudioResult {
+  navigateToStudioDocument: () => void;
+}
+/**
+ * @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
+ *
+ * @example
+ * ```tsx
+ * import {type DocumentHandle} from '@sanity/sdk-react'
+ * import {useNavigateToStudioDocument} from '@sanity/sdk-react/dashboard'
+ * 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"
+ *     />
+ *   )
+ * }
+ *
+ * // 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>
+ *   )
+ * }
+ * ```
+ */
+declare function useNavigateToStudioDocument(documentHandle: DocumentHandle, preferredStudioUrl?: string): NavigateToStudioResult;
+/**
+ * @public
+ *
+ * A React hook that retrieves the dashboard organization ID that is currently selected in the Sanity Dashboard.
+ *
+ * @example
+ * ```tsx
+ * function DashboardComponent() {
+ *   const orgId = useOrganizationId()
+ *
+ *   if (!orgId) return null
+ *
+ *   return <div>Organization ID: {String(orgId)}</div>
+ * }
+ * ```
+ *
+ * @category Dashboard
+ * @returns The dashboard organization ID (string | undefined)
+ */
+declare function useOrganizationId(): string | undefined;
+/**
+ * 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:
+ *
+ * - With a view title: `<viewTitle> | <appTitle>`
+ * - Without a view title: `<appTitle>`
+ *
+ * The Sanity dashboard appends `| Sanity` to produce the final browser tab title.
+ *
+ * @param viewTitle - An optional view-specific title to prepend to the app title.
+ *
+ * @example
+ * ```tsx
+ * import {useWindowTitle} from '@sanity/sdk-react/dashboard'
+ *
+ * function MoviesList() {
+ *   useWindowTitle('Movies')
+ *   return <div>...</div>
+ * }
+ *
+ * // Browser tab: "Movies | My App | Sanity"
+ * ```
+ *
+ * @example
+ * ```tsx
+ * // Call without arguments to show just the app title
+ * function AppRoot() {
+ *   useWindowTitle()
+ *   return <Outlet />
+ * }
+ *
+ * // Browser tab: "My App | Sanity"
+ * ```
+ *
+ * @public
+ */
+declare function useWindowTitle(viewTitle?: string): void;
+export { type AgentResourceContextOptions, type NavigateToStudioResult, DashboardTokenRefreshProvider as TokenRefreshProvider, useAgentResourceContext, useNavigate, useNavigateToStudioDocument, useOrganizationId, useWindowTitle };
+//# sourceMappingURL=dashboard.d.ts.map

package/dist/_exports/dashboard.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dashboard.d.ts","names":[],"sources":["../../src/context/DashboardTokenRefresh.tsx","../../src/hooks/dashboard/useAgentResourceContext.ts","../../src/hooks/dashboard/useNavigate.ts","../../src/hooks/dashboard/useNavigateToStudioDocument.ts","../../src/hooks/dashboard/useOrganizationId.tsx","../../src/hooks/dashboard/useWindowTitle.ts"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;cAwFa,+BAA+B,MAAM,GAAG;;;;UC/EpC;;;;EAIf;;;;EAIA;;;;EAIA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAiCc,wBAAwB,SAAS;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBCPjC,YACd,aAAa,SAAS;;;;;UClCP;EACf;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAgDc,4BACd,gBAAgB,gBAChB,8BACC;;;;;;;;;;;;;;;;;;;;iBC1Ca;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBC2CA,eAAe"}

package/dist/_exports/dashboard.js

@@ -0,0 +1,278 @@
+import { a as useWindowConnection, n as useOrganizationId, r as DashboardTokenRefreshProvider, t as useStudioWorkspacesByProjectIdDataset } from "../useStudioWorkspacesByProjectIdDataset-DxUlukmF.js";
+import { c } from "react-compiler-runtime";
+import "@sanity/sdk";
+import { useEffect, useRef, useState } from "react";
+import { SDK_CHANNEL_NAME, SDK_NODE_NAME } from "@sanity/message-protocol";
+import "@sanity/sdk/comlink";
+/**
+* @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/dashboard'
+*
+* 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);
+}
+/**
+* @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.
+*
+* @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 {useNavigate} from '@sanity/sdk-react/dashboard'
+* import {BrowserRouter, useNavigate as useRouterNavigate} from 'react-router'
+* import {Suspense} from 'react'
+*
+* function DashboardNavigationHandler() {
+*   const navigate = useRouterNavigate()
+*   useNavigate(({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 useNavigate(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);
+}
+/**
+* @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
+*
+* @example
+* ```tsx
+* import {type DocumentHandle} from '@sanity/sdk-react'
+* import {useNavigateToStudioDocument} from '@sanity/sdk-react/dashboard'
+* 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"
+*     />
+*   )
+* }
+*
+* // 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>
+*   )
+* }
+* ```
+*/
+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 resolveAppTitle(resource) {
+	return resource.manifest?.title || resource.activeDeployment?.manifest?.title || resource.title;
+}
+/**
+* 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:
+*
+* - With a view title: `<viewTitle> | <appTitle>`
+* - Without a view title: `<appTitle>`
+*
+* The Sanity dashboard appends `| Sanity` to produce the final browser tab title.
+*
+* @param viewTitle - An optional view-specific title to prepend to the app title.
+*
+* @example
+* ```tsx
+* import {useWindowTitle} from '@sanity/sdk-react/dashboard'
+*
+* function MoviesList() {
+*   useWindowTitle('Movies')
+*   return <div>...</div>
+* }
+*
+* // Browser tab: "Movies | My App | Sanity"
+* ```
+*
+* @example
+* ```tsx
+* // Call without arguments to show just the app title
+* function AppRoot() {
+*   useWindowTitle()
+*   return <Outlet />
+* }
+*
+* // 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]);
+}
+export { DashboardTokenRefreshProvider as TokenRefreshProvider, useAgentResourceContext, useNavigate, useNavigateToStudioDocument, useOrganizationId, useWindowTitle };
+
+//# sourceMappingURL=dashboard.js.map

package/dist/_exports/dashboard.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dashboard.js","names":["Events","SDK_CHANNEL_NAME","SDK_NODE_NAME","FrameMessage","useCallback","useEffect","useRef","useWindowConnection","AgentResourceContextOptions","projectId","dataset","documentId","useAgentResourceContext","options","$","_c","t0","Symbol","for","name","connectTo","sendMessage","lastContextRef","t1","console","warn","contextKey","current","message","type","data","t2","error","updateContext","t3","PathChangeMessage","SDK_CHANNEL_NAME","SDK_NODE_NAME","useWindowConnection","useNavigate","navigateFn","$","_c","t0","name","connectTo","onMessage","data","Bridge","SDK_CHANNEL_NAME","SDK_NODE_NAME","DocumentHandle","useCallback","useWindowConnection","DashboardResource","useStudioWorkspacesByProjectIdDataset","NavigateToStudioResult","navigateToStudioDocument","useNavigateToStudioDocument","documentHandle","preferredStudioUrl","$","_c","workspacesByProjectIdAndDataset","t0","Symbol","for","name","connectTo","sendMessage","t1","projectId","dataset","console","warn","workspace","allWorkspaces","find","w","url","workspaces","length","message","type","data","resourceId","id","resourceType","path","documentId","documentType","t2","SDK_CHANNEL_NAME","SDK_NODE_NAME","useEffect","useState","useWindowConnection","ContextResource","type","title","manifest","activeDeployment","ContextResponse","context","resource","resolveAppTitle","useWindowTitle","viewTitle","appTitle","setAppTitle","fetch","name","connectTo","controller","AbortController","fetchAppTitle","signal","AbortSignal","data","undefined","document","err","Error","console","error","abort","previous"],"sources":["../../src/hooks/dashboard/useAgentResourceContext.ts","../../src/hooks/dashboard/useNavigate.ts","../../src/hooks/dashboard/useNavigateToStudioDocument.ts","../../src/hooks/dashboard/useWindowTitle.ts"],"sourcesContent":["import {type Events, SDK_CHANNEL_NAME, SDK_NODE_NAME} from '@sanity/message-protocol'\nimport {type FrameMessage} from '@sanity/sdk/comlink'\nimport {useCallback, useEffect, useRef} from 'react'\n\nimport {useWindowConnection} from '../comlink/useWindowConnection'\n\n/**\n * @public\n */\nexport interface AgentResourceContextOptions {\n  /**\n   * The project ID of the current context\n   */\n  projectId: string\n  /**\n   * The dataset of the current context\n   */\n  dataset: string\n  /**\n   * Optional document ID if the user is viewing/editing a specific document\n   */\n  documentId?: string\n}\n\n/**\n * @public\n * Hook for emitting agent resource context updates to the Dashboard.\n * This allows the Agent to understand what resource the user is currently\n * interacting with (e.g., which document they're editing).\n *\n * The hook will automatically emit the context when it changes, and also\n * emit the initial context when the hook is first mounted.\n *\n * @category Agent\n * @param options - The resource context options containing projectId, dataset, and optional documentId\n *\n * @example\n * ```tsx\n * import {useAgentResourceContext} from '@sanity/sdk-react/dashboard'\n *\n * function MyComponent() {\n *   const documentId = 'my-document-id'\n *\n *   // Automatically updates the Agent's context whenever the document changes\n *   useAgentResourceContext({\n *     projectId: 'my-project',\n *     dataset: 'production',\n *     documentId,\n *   })\n *\n *   return <div>Editing document: {documentId}</div>\n * }\n * ```\n */\nexport function useAgentResourceContext(options: AgentResourceContextOptions): void {\n  const {projectId, dataset, documentId} = options\n  const {sendMessage} = useWindowConnection<Events.AgentResourceUpdateMessage, FrameMessage>({\n    name: SDK_NODE_NAME,\n    connectTo: SDK_CHANNEL_NAME,\n  })\n\n  // Track the last sent context to avoid duplicate updates\n  const lastContextRef = useRef<string | null>(null)\n\n  const updateContext = useCallback(() => {\n    // Validate required fields\n    if (!projectId || !dataset) {\n      // eslint-disable-next-line no-console\n      console.warn('[useAgentResourceContext] projectId and dataset are required', {\n        projectId,\n        dataset,\n      })\n      return\n    }\n\n    // Create a stable key for the current context\n    const contextKey = `${projectId}:${dataset}:${documentId || ''}`\n\n    // Skip if context hasn't changed\n    if (lastContextRef.current === contextKey) {\n      return\n    }\n\n    try {\n      const message: Events.AgentResourceUpdateMessage = {\n        type: 'dashboard/v1/events/agent/resource/update',\n        data: {\n          projectId,\n          dataset,\n          documentId,\n        },\n      }\n\n      sendMessage(message.type, message.data)\n      lastContextRef.current = contextKey\n    } catch (error) {\n      // eslint-disable-next-line no-console\n      console.error('[useAgentResourceContext] Failed to update context:', error)\n    }\n  }, [projectId, dataset, documentId, sendMessage])\n\n  // Update context whenever it changes\n  useEffect(() => {\n    updateContext()\n  }, [updateContext])\n}\n","import {type PathChangeMessage, SDK_CHANNEL_NAME, SDK_NODE_NAME} from '@sanity/message-protocol'\n\nimport {useWindowConnection} from '../comlink/useWindowConnection'\n\n/**\n * @public\n *\n * A helper hook designed to be injected into routing components for apps within the Dashboard.\n * While the Dashboard can usually handle navigation, there are special cases when you\n * are already within a target app, and need to navigate to another route inside of that app.\n *\n * For example, your user might \"favorite\" a document inside of your application.\n * If they click on the Dashboard favorites item in the sidebar, and are already within your application,\n * there needs to be some way for the dashboard to signal to your application to reroute to where that document was favorited.\n *\n * This hook is intended to receive those messages, and takes a function to route to the correct path.\n *\n * @param navigateFn - Function to handle navigation; should accept:\n * - `path`: a string, which will be a relative path (for example, 'my-route')\n * - `type`: 'push', 'replace', or 'pop', which will be the type of navigation to perform\n *\n * @example\n * ```tsx\n * import {useNavigate} from '@sanity/sdk-react/dashboard'\n * import {BrowserRouter, useNavigate as useRouterNavigate} from 'react-router'\n * import {Suspense} from 'react'\n *\n * function DashboardNavigationHandler() {\n *   const navigate = useRouterNavigate()\n *   useNavigate(({path, type}) => {\n *     navigate(path, {replace: type === 'replace'})\n *   })\n *   return null\n * }\n *\n * // Wrap the component with Suspense since the hook may suspend\n * function MyApp() {\n *   return (\n *     <BrowserRouter>\n *       <Suspense>\n *         <DashboardNavigationHandler />\n *       </Suspense>\n *     </BrowserRouter>\n *   )\n * }\n * ```\n */\nexport function useNavigate(\n  navigateFn: (options: PathChangeMessage['data']) => void,\n): void {\n  useWindowConnection<PathChangeMessage, never>({\n    name: SDK_NODE_NAME,\n    connectTo: SDK_CHANNEL_NAME,\n    onMessage: {\n      'dashboard/v1/history/change-path': (data: PathChangeMessage['data']) => {\n        navigateFn(data)\n      },\n    },\n  })\n}\n","import {type Bridge, SDK_CHANNEL_NAME, SDK_NODE_NAME} from '@sanity/message-protocol'\nimport {type DocumentHandle} from '@sanity/sdk'\nimport {useCallback} from 'react'\n\nimport {useWindowConnection} from '../comlink/useWindowConnection'\nimport {\n  type DashboardResource,\n  useStudioWorkspacesByProjectIdDataset,\n} from './useStudioWorkspacesByProjectIdDataset'\n\n/**\n * @public\n * @category Types\n */\nexport interface NavigateToStudioResult {\n  navigateToStudioDocument: () => void\n}\n\n/**\n * @public\n *\n * Hook that provides a function to navigate to a given document in its parent Studio.\n *\n * Uses the `projectId` and `dataset` properties of the {@link DocumentHandle} you provide to resolve the correct Studio.\n * This will only work if you have deployed a studio with a workspace with this `projectId` / `dataset` combination.\n *\n * @remarks If you write your own Document Handle to pass to this hook (as opposed to a Document Handle generated by another hook),\n * it must include values for `documentId`, `documentType`, `projectId`, and `dataset`.\n *\n * @category Documents\n * @param documentHandle - The document handle for the document to navigate to\n * @param preferredStudioUrl - The preferred studio url to navigate to if you have multiple\n * studios with the same projectId and dataset\n * @returns An object containing:\n * - `navigateToStudioDocument` - Function that when called will navigate to the studio document\n *\n * @example\n * ```tsx\n * import {type DocumentHandle} from '@sanity/sdk-react'\n * import {useNavigateToStudioDocument} from '@sanity/sdk-react/dashboard'\n * import {Button} from '@sanity/ui'\n * import {Suspense} from 'react'\n *\n * function NavigateButton({documentHandle}: {documentHandle: DocumentHandle}) {\n *   const {navigateToStudioDocument} = useNavigateToStudioDocument(documentHandle)\n *   return (\n *     <Button\n *       onClick={navigateToStudioDocument}\n *       text=\"Navigate to Studio Document\"\n *     />\n *   )\n * }\n *\n * // Wrap the component with Suspense since the hook may suspend\n * function MyDocumentAction({documentHandle}: {documentHandle: DocumentHandle}) {\n *   return (\n *     <Suspense fallback={<Button text=\"Loading...\" disabled />}>\n *       <NavigateButton documentHandle={documentHandle} />\n *     </Suspense>\n *   )\n * }\n * ```\n */\nexport function useNavigateToStudioDocument(\n  documentHandle: DocumentHandle,\n  preferredStudioUrl?: string,\n): NavigateToStudioResult {\n  const {workspacesByProjectIdAndDataset} = useStudioWorkspacesByProjectIdDataset()\n  const {sendMessage} = useWindowConnection<Bridge.Navigation.NavigateToResourceMessage, never>({\n    name: SDK_NODE_NAME,\n    connectTo: SDK_CHANNEL_NAME,\n  })\n\n  const navigateToStudioDocument = useCallback(() => {\n    const {projectId, dataset} = documentHandle\n\n    if (!projectId || !dataset) {\n      // eslint-disable-next-line no-console\n      console.warn('Project ID and dataset are required to navigate to a studio document')\n      return\n    }\n\n    let workspace: DashboardResource | undefined\n\n    if (preferredStudioUrl) {\n      // Get workspaces matching the projectId:dataset and any workspaces without projectId/dataset,\n      // in case there hasn't been a manifest loaded yet\n      const allWorkspaces = [\n        ...(workspacesByProjectIdAndDataset[`${projectId}:${dataset}`] || []),\n        ...(workspacesByProjectIdAndDataset['NO_PROJECT_ID:NO_DATASET'] || []),\n      ]\n      workspace = allWorkspaces.find((w) => w.url === preferredStudioUrl)\n    } else {\n      const workspaces = workspacesByProjectIdAndDataset[`${projectId}:${dataset}`]\n      if (workspaces?.length > 1) {\n        // eslint-disable-next-line no-console\n        console.warn(\n          'Multiple workspaces found for document and no preferred studio url',\n          documentHandle,\n        )\n        // eslint-disable-next-line no-console\n        console.warn('Using the first one', workspaces[0])\n      }\n\n      workspace = workspaces?.[0]\n    }\n\n    if (!workspace) {\n      // eslint-disable-next-line no-console\n      console.warn(\n        `No workspace found for document with projectId: ${projectId} and dataset: ${dataset}${preferredStudioUrl ? ` or with preferred studio url: ${preferredStudioUrl}` : ''}`,\n      )\n      return\n    }\n\n    const message: Bridge.Navigation.NavigateToResourceMessage = {\n      type: 'dashboard/v1/bridge/navigate-to-resource',\n      data: {\n        resourceId: workspace.id,\n        resourceType: 'studio',\n        path: `/intent/edit/id=${documentHandle.documentId};type=${documentHandle.documentType}`,\n      },\n    }\n\n    sendMessage(message.type, message.data)\n  }, [documentHandle, workspacesByProjectIdAndDataset, sendMessage, preferredStudioUrl])\n\n  return {\n    navigateToStudioDocument,\n  }\n}\n","import {SDK_CHANNEL_NAME, SDK_NODE_NAME} from '@sanity/message-protocol'\nimport {useEffect, useState} from 'react'\n\nimport {useWindowConnection} from '../comlink/useWindowConnection'\n\ninterface ContextResource {\n  type: string\n  title?: string\n  manifest?: {\n    title?: string\n  } | null\n  activeDeployment?: {\n    manifest?: {\n      title?: string\n    } | null\n  } | null\n}\n\ninterface ContextResponse {\n  context: {\n    resource: ContextResource\n  }\n}\n\nfunction resolveAppTitle(resource: ContextResource): string | undefined {\n  return resource.manifest?.title || resource.activeDeployment?.manifest?.title || resource.title\n}\n\n/**\n * Sets the browser's document title, automatically including the app's name\n * from the manifest.\n *\n * This follows the same convention as Sanity Studio workspaces, where the\n * workspace name is always present in the title:\n *\n * - With a view title: `<viewTitle> | <appTitle>`\n * - Without a view title: `<appTitle>`\n *\n * The Sanity dashboard appends `| Sanity` to produce the final browser tab title.\n *\n * @param viewTitle - An optional view-specific title to prepend to the app title.\n *\n * @example\n * ```tsx\n * import {useWindowTitle} from '@sanity/sdk-react/dashboard'\n *\n * function MoviesList() {\n *   useWindowTitle('Movies')\n *   return <div>...</div>\n * }\n *\n * // Browser tab: \"Movies | My App | Sanity\"\n * ```\n *\n * @example\n * ```tsx\n * // Call without arguments to show just the app title\n * function AppRoot() {\n *   useWindowTitle()\n *   return <Outlet />\n * }\n *\n * // Browser tab: \"My App | Sanity\"\n * ```\n *\n * @public\n */\nexport function useWindowTitle(viewTitle?: string): void {\n  const [appTitle, setAppTitle] = useState<string | null>(null)\n\n  const {fetch} = useWindowConnection({\n    name: SDK_NODE_NAME,\n    connectTo: SDK_CHANNEL_NAME,\n  })\n\n  useEffect(() => {\n    if (!fetch) return\n\n    const controller = new AbortController()\n\n    async function fetchAppTitle(signal: AbortSignal) {\n      try {\n        const data = await fetch<ContextResponse>('dashboard/v1/context', undefined, {signal})\n        // Local development resources do not have a registered title or deployment manifest.\n        // In that case, use the title rendered into the iframe HTML by the Sanity CLI.\n        const title = resolveAppTitle(data.context.resource) || document.title\n        if (title) {\n          setAppTitle(title)\n        }\n      } catch (err: unknown) {\n        if (err instanceof Error && err.name === 'AbortError') return\n        // eslint-disable-next-line no-console\n        console.error('Failed to fetch app title from dashboard context:', err)\n      }\n    }\n\n    fetchAppTitle(controller.signal)\n\n    return () => {\n      controller.abort()\n    }\n  }, [fetch])\n\n  useEffect(() => {\n    if (!appTitle) return\n\n    const previous = document.title\n    document.title = viewTitle ? `${viewTitle} | ${appTitle}` : appTitle\n\n    return () => {\n      document.title = previous\n    }\n  }, [viewTitle, appTitle])\n}\n"],"mappings":"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"}