@sanity/sdk-react 3.3.0-rc.1 → 3.4.0-rc.0

package/dist/_exports/dashboard-internal.d.ts

@@ -1,2 +1,2 @@
-import { installMessageBus, resetMessageBus } from "@sanity/sdk/_internal";
-export { installMessageBus, resetMessageBus };
+import { ApplicationStatus, ApplicationStatusUpdate, installMessageBus, resetMessageBus } from "@sanity/sdk/_internal";
+export { type ApplicationStatus, type ApplicationStatusUpdate, installMessageBus, resetMessageBus };

package/dist/_exports/dashboard.d.ts

@@ -2,6 +2,7 @@ import { Application, ApplicationBase, DocumentHandle } from "@sanity/sdk";
 import React, { PropsWithChildren } from "react";
 import { PathChangeMessage } from "@sanity/message-protocol";
 import { ApplicationConfig, ApplicationConfig as ApplicationConfig$1, ApplicationConfigAppType, ApplicationConfigAppType as ApplicationConfigAppType$1, ConnectMessageBusOptions, DashboardTopics, EventTopic, EventTopic as EventTopic$1, EventTopicDef, MessageBus, MessageBusAbortOptions, MessageBusClient, MessageBusConnection, MessageBusEmitOptions, MessageBusEmitOptions as MessageBusEmitOptions$1, MessageBusEmitResult, MessageBusEmitResult as MessageBusEmitResult$1, MessageBusError, MessageBusErrorCode, MessageBusHost, MessageBusMessage, MessageBusMeta, MessageBusQueryOptions, MessageBusStateSource, NavigationLocation, NavigationTarget, PayloadOf, PayloadOf as PayloadOf$1, RemoteModuleRef, RemoteModuleRef as RemoteModuleRef$1, ReplyOf, ReplyOf as ReplyOf$1, StateTopic, StateTopic as StateTopic$1, StateTopicDef, TopicData, TopicData as TopicData$1, TopicError, TopicName, TopicResult, Topics, ValueOf, ValueOf as ValueOf$1, connectMessageBus } from "@sanity/sdk/dashboard";
+import { CurrentUser as CurrentUser$1 } from "@sanity/types";
 import { UserOptions } from "@module-federation/runtime/types";
 /**
  * Authenticates the SDK with the Sanity Dashboard's session when the app runs
@@ -360,7 +361,7 @@ type DashboardWebWorker = Extract<DashboardApplicationInterface, {
  * The minimal Brett application fields with its loadable views and web workers.
  * @public
  */
-type DashboardApplication = ApplicationBase & {
+type DashboardApplication = DashboardTopicApplication & {
   readonly views: DashboardView[];
   readonly webWorkers: DashboardWebWorker[];
 };
@@ -397,6 +398,23 @@ export declare function useApplications(): DashboardApplication[];
  * @public
  */
 export declare function useApplication(applicationId: DashboardApplication['id']): DashboardApplication | null;
+/**
+ * Returns the base path for an application.
+ *
+ * Suspends until Dashboard publishes the path and throws a `TopicError` when the application is
+ * unknown.
+ *
+ * @example
+ * ```tsx
+ * function ApplicationBasePath() {
+ *   const basePath = useApplicationBasePath()
+ *   return <span>{basePath}</span>
+ * }
+ * ```
+ *
+ * @public
+ */
+export declare function useApplicationBasePath(): TopicData$1<'applications.base-path'>;
 /**
  * Selects an application configuration by application id or application type.
  * @public
@@ -461,6 +479,38 @@ export declare function useApplicationConfigs(): readonly ApplicationConfig$1[];
  * @public
  */
 export declare function useApplicationForegroundId(): Application['id'] | null;
+/**
+ * Returns the session token for the reading connection, or `null` while signed out.
+ *
+ * Suspends until Dashboard publishes the token.
+ *
+ * @example
+ * ```tsx
+ * function AuthToken() {
+ *   const token = useAuthToken()
+ *   return <span>{token ?? 'Signed out'}</span>
+ * }
+ * ```
+ *
+ * @public
+ */
+export declare function useAuthToken(): string | null;
+/**
+ * Returns the signed-in user, or `null` while signed out.
+ *
+ * Suspends until Dashboard publishes the current user.
+ *
+ * @example
+ * ```tsx
+ * function CurrentUser() {
+ *   const user = useCurrentUser()
+ *   return <span>{user?.name ?? 'Signed out'}</span>
+ * }
+ * ```
+ *
+ * @public
+ */
+export declare function useCurrentUser(): CurrentUser$1 | null;
 /**
  * Emits a dashboard event topic, typed to the topic's payload and reply.
  * @public
@@ -617,6 +667,9 @@ export declare function useNavigateToStudioDocument(documentHandle: DocumentHand
  *
  * A React hook that retrieves the dashboard organization ID that is currently selected in the Sanity Dashboard.
  *
+ * Works in both Dashboard runtimes: it reads the `organizations.current` message bus topic when a
+ * host has installed the bus, and falls back to the Comlink connection otherwise.
+ *
  * @example
  * ```tsx
  * function DashboardComponent() {
@@ -668,6 +721,9 @@ export declare const useTopic: <K extends StateTopic$1>(topic: K) => TopicData$1
  *
  * The Sanity dashboard appends `| Sanity` to produce the final browser tab title.
  *
+ * Works in both Dashboard runtimes: it manages the document title over the Comlink connection, and
+ * no-ops under the message bus, where the Dashboard host owns the title.
+ *
  * @param viewTitle - An optional view-specific title to prepend to the app title.
  *
  * @example

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

@@ -1 +1 @@
-{"version":3,"file":"dashboard.d.ts","names":[],"sources":["../../src/context/DashboardTokenRefresh.tsx","../../src/dashboard/createRemoteInstance.ts","../../src/dashboard/urlFor.ts","../../src/hooks/dashboard/useAgentResourceContext.ts","../../src/hooks/dashboard/useApplications.ts","../../src/hooks/dashboard/useApplication.ts","../../src/hooks/dashboard/useApplicationConfig.ts","../../src/hooks/dashboard/useApplicationConfigs.ts","../../src/hooks/dashboard/useApplicationForegroundId.ts","../../src/hooks/dashboard/useEmit.ts","../../src/hooks/dashboard/useNavigate.ts","../../src/hooks/dashboard/useNavigateToStudioDocument.ts","../../src/hooks/dashboard/useOrganizationId.tsx","../../src/hooks/dashboard/useRemoteClient.ts","../../src/hooks/dashboard/useTopic.ts","../../src/hooks/dashboard/useWindowTitle.ts"],"mappings":"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"}
+{"version":3,"file":"dashboard.d.ts","names":[],"sources":["../../src/context/DashboardTokenRefresh.tsx","../../src/dashboard/createRemoteInstance.ts","../../src/dashboard/urlFor.ts","../../src/hooks/dashboard/useAgentResourceContext.ts","../../src/hooks/dashboard/useApplications.ts","../../src/hooks/dashboard/useApplication.ts","../../src/hooks/dashboard/useApplicationBasePath.ts","../../src/hooks/dashboard/useApplicationConfig.ts","../../src/hooks/dashboard/useApplicationConfigs.ts","../../src/hooks/dashboard/useApplicationForegroundId.ts","../../src/hooks/dashboard/useAuthToken.ts","../../src/hooks/dashboard/useCurrentUser.ts","../../src/hooks/dashboard/useEmit.ts","../../src/hooks/dashboard/useNavigate.ts","../../src/hooks/dashboard/useNavigateToStudioDocument.ts","../../src/hooks/dashboard/useOrganizationId.tsx","../../src/hooks/dashboard/useRemoteClient.ts","../../src/hooks/dashboard/useTopic.ts","../../src/hooks/dashboard/useWindowTitle.ts"],"mappings":"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"}

package/dist/_exports/dashboard.js

@@ -1,12 +1,13 @@
-import { i as useWindowConnection, n as useOrganizationId, o as createStateSourceHook, r as DashboardTokenRefreshProvider, s as useSanityInstance, t as useStudioWorkspacesByProjectIdDataset } from "../useStudioWorkspacesByProjectIdDataset-BZ_Ud887.js";
+import { a as useWindowConnection, c as useSanityInstance, i as DashboardTokenRefreshProvider, n as useTopic, r as useOrganizationId, s as createStateSourceHook, t as useStudioWorkspacesByProjectIdDataset } from "../useStudioWorkspacesByProjectIdDataset-B5A5kBH9.js";
 import { c } from "react-compiler-runtime";
 import "@sanity/sdk";
-import { createLogger, getTopicState, requireDashboardMessageBus, resolveTopic } from "@sanity/sdk/_internal";
+import { createLogger, getApplicationOrigin, isDashboardEnvironment, requireDashboardMessageBus } from "@sanity/sdk/_internal";
 import { useEffect, useRef, useState } from "react";
 import { SDK_CHANNEL_NAME, SDK_NODE_NAME } from "@sanity/message-protocol";
 import "@sanity/sdk/comlink";
 import { of } from "rxjs";
 import { MessageBusError, TopicError, connectMessageBus } from "@sanity/sdk/dashboard";
+import "@sanity/types";
 import { createInstance } from "@module-federation/runtime";
 import "@module-federation/runtime/types";
 const MANIFEST_FILE = "mf-manifest.json";
@@ -445,41 +446,10 @@ function useAgentResourceContext(options) {
 		updateContext();
 	}, t3 = [updateContext], $[6] = updateContext, $[7] = t2, $[8] = t3), useEffect(t2, t3);
 }
-/**
-* Returns the current value of a dashboard state topic and follows later updates.
-*
-* The hook suspends until the topic publishes its first value, using the message bus query
-* deadline. A topic declared with `TopicResult` resolves to its successful value; a
-* failed result throws a `TopicError` to the nearest error boundary.
-*
-* @example
-* ```tsx
-* function ForegroundApplication() {
-*   const foregroundId = useTopic('applications.foreground')
-*   return <span>{foregroundId ?? 'No application in the foreground'}</span>
-* }
-* ```
-*
-* @public
-*/
-const useTopic = createStateSourceHook({
-	getState: getTopicState,
-	shouldSuspend: (instance, topic) => getTopicState(instance, topic).getCurrent() === void 0,
-	suspender: resolveTopic
-}), applicationOrigin = (application) => {
-	if (application.externalUrl !== null) return new URL(application.externalUrl).origin;
-	if (application.slug === null) return null;
-	let staging = globalThis.__SANITY_STAGING__ === !0;
-	if (application.isSingleton) {
-		let domain = staging ? "run.sanity.work" : "sanity.run";
-		return `https://${application.slug}-apps-${application.organizationId}.${domain}`;
-	}
-	let domain = staging ? "studio.sanity.work" : "sanity.studio";
-	return `https://${application.slug}.${domain}`;
-}, loadableInterfaces = ({ activeDeployment, config }) => config?.mfManifest === void 0 ? [] : activeDeployment?.interfaces ?? [], toApplication = (application) => {
-	let { activeDeployment: _activeDeployment, config: _config, ...applicationBase } = application, interfaces = loadableInterfaces(application), entry = interfaces.length === 0 ? null : applicationOrigin(applicationBase);
+const loadableInterfaces = ({ activeDeployment, config }) => config?.mfManifest === void 0 ? [] : activeDeployment?.interfaces ?? [], toApplication = (application) => {
+	let { activeDeployment: _activeDeployment, config: _config, ...applicationBase } = application, interfaces = loadableInterfaces(application), entry = interfaces.length === 0 ? null : getApplicationOrigin(applicationBase);
 	if (entry === null) return {
-		...applicationBase,
+		...application,
 		views: [],
 		webWorkers: []
 	};
@@ -507,7 +477,7 @@ const useTopic = createStateSourceHook({
 		});
 	}
 	return {
-		...applicationBase,
+		...application,
 		views,
 		webWorkers
 	};
@@ -553,6 +523,25 @@ function useApplication(applicationId) {
 		return id === applicationId;
 	}) ?? null;
 }
+/**
+* Returns the base path for an application.
+*
+* Suspends until Dashboard publishes the path and throws a `TopicError` when the application is
+* unknown.
+*
+* @example
+* ```tsx
+* function ApplicationBasePath() {
+*   const basePath = useApplicationBasePath()
+*   return <span>{basePath}</span>
+* }
+* ```
+*
+* @public
+*/
+function useApplicationBasePath() {
+	return useTopic("applications.base-path");
+}
 const NO_CONFIGS = Object.freeze([]);
 /**
 * Returns the application configuration modules available in the dashboard.
@@ -615,6 +604,42 @@ function useApplicationForegroundId() {
 	return useTopic("applications.foreground");
 }
 /**
+* Returns the session token for the reading connection, or `null` while signed out.
+*
+* Suspends until Dashboard publishes the token.
+*
+* @example
+* ```tsx
+* function AuthToken() {
+*   const token = useAuthToken()
+*   return <span>{token ?? 'Signed out'}</span>
+* }
+* ```
+*
+* @public
+*/
+function useAuthToken() {
+	return useTopic("auth.token");
+}
+/**
+* Returns the signed-in user, or `null` while signed out.
+*
+* Suspends until Dashboard publishes the current user.
+*
+* @example
+* ```tsx
+* function CurrentUser() {
+*   const user = useCurrentUser()
+*   return <span>{user?.name ?? 'Signed out'}</span>
+* }
+* ```
+*
+* @public
+*/
+function useCurrentUser() {
+	return useTopic("users.current");
+}
+/**
 * Returns a stable function that emits a dashboard event topic.
 *
 * The event is sent immediately. Ignore the lazy result for fire-and-forget delivery, await it
@@ -839,6 +864,9 @@ function resolveAppTitle(resource) {
 *
 * The Sanity dashboard appends `| Sanity` to produce the final browser tab title.
 *
+* Works in both Dashboard runtimes: it manages the document title over the Comlink connection, and
+* no-ops under the message bus, where the Dashboard host owns the title.
+*
 * @param viewTitle - An optional view-specific title to prepend to the app title.
 *
 * @example
@@ -867,6 +895,9 @@ function resolveAppTitle(resource) {
 * @public
 */
 function useWindowTitle(viewTitle) {
+	isDashboardEnvironment() || useComlinkWindowTitle(viewTitle);
+}
+function useComlinkWindowTitle(viewTitle) {
 	let [appTitle, setAppTitle] = useState(null), { fetch } = useWindowConnection({
 		name: SDK_NODE_NAME,
 		connectTo: SDK_CHANNEL_NAME
@@ -894,6 +925,6 @@ function useWindowTitle(viewTitle) {
 		};
 	}, [viewTitle, appTitle]);
 }
-export { MessageBusError, DashboardTokenRefreshProvider as TokenRefreshProvider, TopicError, UrlBuilder, connectMessageBus, createRemoteInstance, urlFor, useAgentResourceContext, useApplication, useApplicationConfig, useApplicationConfigs, useApplicationForegroundId, useApplications, useEmit, useNavigate, useNavigateToStudioDocument, useOrganizationId, useRemoteClient, useTopic, useWindowTitle };
+export { MessageBusError, DashboardTokenRefreshProvider as TokenRefreshProvider, TopicError, UrlBuilder, connectMessageBus, createRemoteInstance, urlFor, useAgentResourceContext, useApplication, useApplicationBasePath, useApplicationConfig, useApplicationConfigs, useApplicationForegroundId, useApplications, useAuthToken, useCurrentUser, useEmit, useNavigate, useNavigateToStudioDocument, useOrganizationId, useRemoteClient, useTopic, useWindowTitle };
 
 //# sourceMappingURL=dashboard.js.map