@sanity/sdk-react 2.5.0 → 2.6.0

package/README.md

@@ -322,6 +322,29 @@ The SDK handles updating the document state automatically:
 - `publishDocument()` copies draft → published, deletes draft
 - `discardDraft()` deletes draft, reverts to published
 
+#### LiveEdit Documents
+
+For documents that don't need the draft/published workflow (such as settings, configuration, or real-time collaborative documents), you can use **liveEdit mode** by setting `liveEdit: true` in the document handle:
+
+```tsx
+const settingsHandle: DocumentHandle = {
+  documentId: 'site-settings',
+  documentType: 'settings',
+  liveEdit: true, // Edits apply directly without creating a draft
+}
+
+// Edits are applied immediately to the published document
+const editSettings = useEditDocument(settingsHandle)
+```
+
+**When using liveEdit documents:**
+
+- Drafts will not be created when the document is edited
+- Edits will be applied directly to the published document
+- `publishDocument()`, `unpublishDocument()`, and `discardDraft()` actions cannot be used (since liveEdit documents are always published and do not have drafts)
+
+For more details, see the [Sanity documentation on liveEdit documents](https://www.sanity.io/docs/content-lake/drafts).
+
 ---
 
 ### Real-Time Behavior
@@ -340,43 +363,97 @@ Any mutation to a subscribed document (even fields you don't display) will trigg
 
 ### Multi-Project Access
 
-#### Specify Source in Handle
+The SDK supports accessing documents from multiple projects and datasets simultaneously. There are two main approaches:
+
+#### Approach 1: Specify Project/Dataset Directly in the Handle
+
+Pass `projectId` and `dataset` directly in document handles to fetch data from specific projects (note that any `projectId` and `dataset` pair you pass must be defined in your application’s array of [SanityConfig objects](https://www.sanity.io/docs/app-sdk/sdk-configuration#d95b8773097c)):
 
 ```tsx
-const handle: DocumentHandle = {
-  documentId: 'xyz',
-  documentType: 'product',
-  projectId: 'project-a',
-  dataset: 'production',
+import {useDocument} from '@sanity/sdk-react'
+
+function MultiProjectComponent() {
+  // Fetch from Project A
+  const {data: productA} = useDocument({
+    documentId: 'product-123',
+    documentType: 'product',
+    projectId: 'project-a',
+    dataset: 'production',
+  })
+
+  // Fetch from Project B
+  const {data: productB} = useDocument({
+    documentId: 'product-456',
+    documentType: 'product',
+    projectId: 'project-b',
+    dataset: 'staging',
+  })
+
+  return (
+    <div>
+      <h2>{productA?.title} (Project A)</h2>
+      <h2>{productB?.title} (Project B)</h2>
+    </div>
+  )
 }
 ```
 
-#### Use Resource Provider Context
+#### Approach 2: Use ResourceProvider to Set Context
+
+Wrap components in `ResourceProvider` to set default project/dataset values for all child components:
 
 ```tsx
 // App.tsx
-import {ResourceProvider} from '@sanity/sdk-react'
+import {ResourceProvider, useDocument, useSanityInstance} from '@sanity/sdk-react'
+
+function ProductCard({productId}: {productId: string}) {
+  // Get the current project/dataset from context
+  const {config} = useSanityInstance()
 
-import {ProductCard} from './ProductCard'
+  // No need to specify projectId/dataset - inherited from ResourceProvider
+  const {data: product} = useDocument({
+    documentId: productId,
+    documentType: 'product',
+  })
 
-export function WrappedProductCard() {
   return (
-    <ResourceProvider projectId="project-a" dataset="production">
-      <ProductCard productId="xyz" />
-    </ResourceProvider>
+    <div>
+      <h3>{product?.title}</h3>
+      <p>
+        From: {config.projectId}.{config.dataset}
+      </p>
+    </div>
   )
 }
 
-// ProductCard.tsx
-import {useProjectId, useDataset} from '@sanity/sdk-react'
-
-function ProductCard({productId}: {productId: string}) {
-  const projectId = useProjectId() // "project-a" from nearest configured ResourceProvider
-  const dataset = useDataset() // "production" from nearest configured ResourceProvider
-  // ...
+export function MultiProjectApp() {
+  return (
+    <div>
+      {/* Products from Project A */}
+      <ResourceProvider projectId="project-a" dataset="production" fallback={<div>Loading...</div>}>
+        <h2>Project A Products</h2>
+        <ProductCard productId="product-123" />
+        <ProductCard productId="product-456" />
+      </ResourceProvider>
+
+      {/* Products from Project B */}
+      <ResourceProvider projectId="project-b" dataset="staging" fallback={<div>Loading...</div>}>
+        <h2>Project B Products</h2>
+        <ProductCard productId="product-789" />
+      </ResourceProvider>
+    </div>
+  )
 }
 ```
 
+**Key Points:**
+
+- When using hooks that take document handles as arguments (such useDocument, useEditDocument, useQuery, etc.), the document handles’ `projectId` and `dataset` values can be explicitly set to fetch documents from arbitrary projects and datasets
+- The ResourceProvider component is used to create a project ID and dataset context that child components will inherit from; this can negate the need to specify the project ID and dataset values for document handles in hooks called by child components
+- Use `useSanityInstance()` to access the context configuration for the current component: `const {config} = useSanityInstance()`
+- You can nest ResourceProvider components to create component trees with different project/dataset configurations — but be aware that, when the project ID and dataset values for document handles are _not_ specified, the project ID and dataset from the closest ResourceProvider context will be used
+- Regardless of the approach you use, the project IDs and dataset names you reference (whether in document handles or ResourceProviders) must be enumerated in your application’s [SanityConfig objects](https://www.sanity.io/docs/app-sdk/sdk-configuration#d95b8773097c)
+
 ---
 
 ### TypeScript & TypeGen

package/dist/index.d.ts

@@ -176,18 +176,6 @@ declare interface DispatchIntent {
   dispatchIntent: () => void
 }
 
-/**
- * Document handle that optionally includes a source (e.g., media library source)
- * or projectId and dataset for traditional dataset sources
- * (but now marked optional since it's valid to just use a source)
- * @beta
- */
-declare interface DocumentHandleWithSource extends Omit<DocumentHandle, 'projectId' | 'dataset'> {
-  source?: DocumentSource
-  projectId?: string
-  dataset?: string
-}
-
 declare interface DocumentInteractionHistory {
   recordEvent: (eventType: 'viewed' | 'edited' | 'created' | 'deleted') => void
 }
@@ -218,6 +206,7 @@ export declare interface DocumentsOptions<
   batchSize?: number
   /**
    * Sorting configuration for the results
+   * @beta
    */
   orderings?: SortOrderingItem[]
   /**
@@ -307,6 +296,13 @@ export declare type MessageHandler<TWindowMessage extends WindowMessage> = (
   event: TWindowMessage['data'],
 ) => TWindowMessage['response'] | Promise<TWindowMessage['response']>
 
+/** In-flight CLI PR is using named sources since it's aspirational.
+ *  We can transform the shape in this function until it's finalized.
+ */
+declare interface NamedSources {
+  [key: string]: SanityConfig
+}
+
 /**
  * @public
  * @category Types
@@ -343,6 +339,7 @@ export declare interface PaginatedDocumentsOptions<
   pageSize?: number
   /**
    * Sorting configuration for the results
+   * @beta
    */
   orderings?: SortOrderingItem[]
   /**
@@ -446,6 +443,18 @@ export declare type ProjectWithoutMembers = Omit<SanityProject_2, 'members'>
  */
 export declare const REACT_SDK_VERSION: {}
 
+/** @internal */
+export declare function renderSanityApp(
+  rootElement: HTMLElement | null,
+  namedSources: NamedSources,
+  options: RenderSanitySDKAppOptions,
+  children: React.ReactNode,
+): () => void
+
+declare interface RenderSanitySDKAppOptions {
+  reactStrictMode?: boolean
+}
+
 /**
  * Provides a Sanity instance to child components through React Context
  *
@@ -583,6 +592,7 @@ export declare interface SanityAppProps {
   config: SanityConfig | SanityConfig[]
   /** @deprecated use the `config` prop instead. */
   sanityConfigs?: SanityConfig[]
+  sources?: Record<string, DocumentSource>
   children: React.ReactNode
   fallback: React.ReactNode
 }
@@ -612,6 +622,7 @@ export declare interface SDKProviderProps extends AuthBoundaryProps {
   children: ReactNode
   config: SanityConfig | SanityConfig[]
   fallback: ReactNode
+  sources?: Record<string, DocumentSource>
 }
 
 export {SortOrderingItem}
@@ -1146,7 +1157,7 @@ export declare function useDispatchIntent(params: UseDispatchIntentParams): Disp
 declare interface UseDispatchIntentParams {
   action?: 'edit'
   intentId?: string
-  documentHandle: DocumentHandleWithSource
+  documentHandle: DocumentHandle
   parameters?: Record<string, unknown>
 }
 
@@ -2458,8 +2469,9 @@ export declare function useQuery<
   TQuery extends string = string,
   TDataset extends string = string,
   TProjectId extends string = string,
+  TSourceName extends string = string,
 >(
-  options: QueryOptions<TQuery, TDataset, TProjectId>,
+  options: UseQueryOptions<TQuery, TDataset, TProjectId, TSourceName>,
 ): {
   /** The query result, typed based on the GROQ query string */
   data: SanityQueryResult<TQuery, `${TProjectId}.${TDataset}`>
@@ -2502,6 +2514,15 @@ export declare function useQuery<TData>(options: QueryOptions): {
   isPending: boolean
 }
 
+declare interface UseQueryOptions<
+  TQuery extends string = string,
+  TDataset extends string = string,
+  TProjectId extends string = string,
+  TSourceName extends string = string,
+> extends QueryOptions<TQuery, TDataset, TProjectId> {
+  sourceName?: TSourceName
+}
+
 /**
  * @internal
  * Hook for managing document interaction history in Sanity Studio.

package/dist/index.js

@@ -1,12 +1,13 @@
 import { jsx, jsxs, Fragment } from "react/jsx-runtime";
 import { c } from "react-compiler-runtime";
 import { ClientError, CorsOriginError } from "@sanity/client";
-import { getAuthState, getNodeState, getIsInDashboardState, setAuthToken, AuthStateType, getLoginUrlState, observeOrganizationVerificationState, handleAuthCallback, logout, isProjectUserNotFoundClientError, getClientErrorApiDescription, getClientErrorApiBody, getCorsErrorProjectId, createSanityInstance, agentGenerate, agentTransform, agentTranslate, agentPrompt, agentPatch, getTokenState, getCurrentUserState, getDashboardOrganizationId, getClientState, getOrCreateController, getOrCreateChannel, releaseChannel, getFavoritesState, resolveFavoritesState, resolveDatasets, getDatasetsState, applyDocumentActions, resolveDocument, getDocumentState, subscribeDocumentEvents, getPermissionsState, getDocumentSyncStatus, editDocument, getQueryKey, parseQueryKey, getQueryState, resolveQuery, createGroqSearchFilter, getPresence, getPreviewState, resolvePreview, getProjectionState, resolveProjection, resolveProject, getProjectState, resolveProjects, getProjectsState, getActiveReleasesState, getPerspectiveState, getUsersKey, parseUsersKey, getUsersState, resolveUsers, loadMoreUsers } from "@sanity/sdk";
+import { getAuthState, getNodeState, getIsInDashboardState, setAuthToken, AuthStateType, getLoginUrlState, observeOrganizationVerificationState, handleAuthCallback, logout, isProjectUserNotFoundClientError, getClientErrorApiDescription, getClientErrorApiBody, getCorsErrorProjectId, createSanityInstance, agentGenerate, agentTransform, agentTranslate, agentPrompt, agentPatch, getTokenState, getCurrentUserState, getDashboardOrganizationId, getClientState, getOrCreateController, getOrCreateChannel, releaseChannel, isDatasetSource, isMediaLibrarySource, isCanvasSource, getFavoritesState, resolveFavoritesState, resolveDatasets, getDatasetsState, applyDocumentActions, resolveDocument, getDocumentState, subscribeDocumentEvents, getPermissionsState, getDocumentSyncStatus, editDocument, getQueryKey, parseQueryKey, getQueryState, resolveQuery, createGroqSearchFilter, getPresence, getPreviewState, resolvePreview, getProjectionState, resolveProjection, resolveProject, getProjectState, resolveProjects, getProjectsState, getActiveReleasesState, getPerspectiveState, getUsersKey, parseUsersKey, getUsersState, resolveUsers, loadMoreUsers } from "@sanity/sdk";
 export * from "@sanity/sdk";
-import { createContext, useContext, useSyncExternalStore, useRef, useEffect, useState, Suspense, useCallback, useMemo, useInsertionEffect, useTransition } from "react";
+import { createContext, useContext, useSyncExternalStore, useRef, useEffect, useState, Suspense, StrictMode, useCallback, useMemo, useInsertionEffect, useTransition } from "react";
 import { ErrorBoundary } from "react-error-boundary";
 import { SDK_CHANNEL_NAME, SDK_NODE_NAME } from "@sanity/message-protocol";
 import { firstValueFrom, filter, identity, Observable, startWith, distinctUntilChanged, switchMap, EMPTY } from "rxjs";
+import { createRoot } from "react-dom/client";
 import { pick } from "lodash-es";
 const SanityInstanceContext = createContext(null), useSanityInstance = (config) => {
   const $ = c(3), instance = useContext(SanityInstanceContext);
@@ -65,7 +66,7 @@ function useWindowConnection(t0) {
     const [type, handler] = t42, messageUnsubscribe = node.on(type, handler);
     messageUnsubscribe && messageUnsubscribers.current.push(messageUnsubscribe);
   }), () => {
-    messageUnsubscribers.current.forEach(_temp$7), messageUnsubscribers.current = [];
+    messageUnsubscribers.current.forEach(_temp$8), 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);
@@ -83,7 +84,7 @@ function useWindowConnection(t0) {
     fetch
   }, $[16] = fetch, $[17] = sendMessage, $[18] = t7) : t7 = $[18], t7;
 }
-function _temp$7(unsubscribe) {
+function _temp$8(unsubscribe) {
   return unsubscribe();
 }
 const DEFAULT_RESPONSE_TIMEOUT = 1e4;
@@ -113,7 +114,7 @@ function DashboardTokenRefresh(t0) {
         if (clearRefreshTimeout(), res.token) {
           setAuthToken(instance, res.token);
           const errorContainer = document.getElementById("__sanityError");
-          errorContainer && Array.from(errorContainer.getElementsByTagName("div")).some(_temp$6) && errorContainer.remove();
+          errorContainer && Array.from(errorContainer.getElementsByTagName("div")).some(_temp$7) && errorContainer.remove();
         }
         isTokenRefreshInProgress.current = !1;
       } catch {
@@ -134,7 +135,7 @@ function DashboardTokenRefresh(t0) {
   let t7;
   return $[11] !== authState || $[12] !== requestNewToken ? (t7 = [authState, requestNewToken], $[11] = authState, $[12] = requestNewToken, $[13] = t7) : t7 = $[13], useEffect(t6, t7), children;
 }
-function _temp$6(div) {
+function _temp$7(div) {
   return div.textContent?.includes("Uncaught error: Unauthorized - A valid session is required for this endpoint");
 }
 const ComlinkTokenRefreshProvider = (t0) => {
@@ -289,10 +290,10 @@ function LoginCallback() {
   let t0, t1;
   return $[0] !== handleAuthCallback2 ? (t0 = () => {
     const url = new URL(location.href);
-    handleAuthCallback2(url.toString()).then(_temp$5);
+    handleAuthCallback2(url.toString()).then(_temp$6);
   }, t1 = [handleAuthCallback2], $[0] = handleAuthCallback2, $[1] = t0, $[2] = t1) : (t0 = $[1], t1 = $[2]), useEffect(t0, t1), null;
 }
-function _temp$5(replacementLocation) {
+function _temp$6(replacementLocation) {
   replacementLocation && history.replaceState(null, "", replacementLocation);
 }
 const useLogOut = createCallbackHook(logout);
@@ -419,14 +420,37 @@ function ResourceProvider(t0) {
   let t7;
   return $[13] !== instance || $[14] !== t6 ? (t7 = /* @__PURE__ */ jsx(SanityInstanceContext.Provider, { value: instance, children: t6 }), $[13] = instance, $[14] = t6, $[15] = t7) : t7 = $[15], t7;
 }
-function SDKProvider({
-  children,
-  config,
-  fallback,
-  ...props
-}) {
-  const configs = (Array.isArray(config) ? config : [config]).slice().reverse(), projectIds = configs.map((c2) => c2.projectId).filter((id) => !!id), createNestedProviders = (index) => index >= configs.length ? /* @__PURE__ */ jsx(AuthBoundary, { ...props, projectIds, children }) : /* @__PURE__ */ jsx(ResourceProvider, { ...configs[index], fallback, children: createNestedProviders(index + 1) });
-  return createNestedProviders(0);
+const SourcesContext = createContext({});
+function SDKProvider(t0) {
+  const $ = c(19);
+  let children, config, fallback, props;
+  $[0] !== t0 ? ({
+    children,
+    config,
+    fallback,
+    ...props
+  } = t0, $[0] = t0, $[1] = children, $[2] = config, $[3] = fallback, $[4] = props) : (children = $[1], config = $[2], fallback = $[3], props = $[4]);
+  let t1;
+  $[5] !== config ? (t1 = Array.isArray(config) ? config : [config], $[5] = config, $[6] = t1) : t1 = $[6];
+  let configs, t2;
+  $[7] !== t1 ? (configs = t1.slice().reverse(), t2 = configs.map(_temp$5).filter(_temp2$1), $[7] = t1, $[8] = configs, $[9] = t2) : (configs = $[8], t2 = $[9]);
+  const projectIds = t2;
+  let t3, t4;
+  $[10] !== props.sources ? (t4 = props.sources ?? {}, $[10] = props.sources, $[11] = t4) : t4 = $[11], t3 = t4;
+  const sourcesValue = t3;
+  let t5;
+  if ($[12] !== children || $[13] !== configs || $[14] !== fallback || $[15] !== projectIds || $[16] !== props || $[17] !== sourcesValue) {
+    const createNestedProviders = (index) => index >= configs.length ? /* @__PURE__ */ jsx(AuthBoundary, { ...props, projectIds, children: /* @__PURE__ */ jsx(SourcesContext.Provider, { value: sourcesValue, children }) }) : /* @__PURE__ */ jsx(ResourceProvider, { ...configs[index], fallback, children: createNestedProviders(index + 1) });
+    t5 = createNestedProviders(0), $[12] = children, $[13] = configs, $[14] = fallback, $[15] = projectIds, $[16] = props, $[17] = sourcesValue, $[18] = t5;
+  } else
+    t5 = $[18];
+  return t5;
+}
+function _temp2$1(id) {
+  return !!id;
+}
+function _temp$5(c2) {
+  return c2.projectId;
 }
 const REDIRECT_URL = "https://sanity.io/welcome";
 function SanityApp(t0) {
@@ -453,6 +477,14 @@ function SanityApp(t0) {
 function _temp$4() {
   console.warn("Redirecting to core", REDIRECT_URL), window.location.replace(REDIRECT_URL);
 }
+function renderSanityApp(rootElement, namedSources, options, children) {
+  if (!rootElement)
+    throw new Error("Missing root element to mount application into");
+  const {
+    reactStrictMode = !1
+  } = options, root = createRoot(rootElement), config = Object.values(namedSources);
+  return root.render(reactStrictMode ? /* @__PURE__ */ jsx(StrictMode, { children: /* @__PURE__ */ jsx(SanityApp, { config, fallback: /* @__PURE__ */ jsx("div", { children: "Loading..." }), children }) }) : /* @__PURE__ */ jsx(SanityApp, { config, fallback: /* @__PURE__ */ jsx("div", { children: "Loading..." }), children })), () => root.unmount();
+}
 const useAgentGenerate = createCallbackHook(agentGenerate), useAgentTransform = createCallbackHook(agentTransform), useAgentTranslate = createCallbackHook(agentTranslate);
 function promptAdapter(instance, options) {
   return firstValueFrom(agentPrompt(instance, options));
@@ -588,28 +620,28 @@ function useDashboardNavigate(navigateFn) {
     }
   }, $[0] = navigateFn, $[1] = t0) : t0 = $[1], useWindowConnection(t0);
 }
-const SOURCE_ID = "__sanity_internal_sourceId", isDocumentHandleWithSource = (documentHandle) => "source" in documentHandle;
-function getResourceIdFromDocumentHandle(documentHandle) {
-  let source;
-  const {
+function useSource(options) {
+  const sources = useContext(SourcesContext);
+  if (!(!options.sourceName && !options.source)) {
+    if (options.source)
+      return options.source;
+    if (options.sourceName && !Object.hasOwn(sources, options.sourceName))
+      throw new Error(`There's no source named ${JSON.stringify(options.sourceName)} in context. Please use <SourceProvider>.`);
+    return options.sourceName ? sources[options.sourceName] : void 0;
+  }
+}
+function useResourceIdFromDocumentHandle(documentHandle) {
+  const $ = c(3), source = useSource(documentHandle), {
     projectId,
     dataset
   } = documentHandle;
-  isDocumentHandleWithSource(documentHandle) && (source = documentHandle.source);
-  let resourceId = projectId + "." + dataset, resourceType;
-  if (source) {
-    const sourceId = source[SOURCE_ID];
-    if (Array.isArray(sourceId))
-      (sourceId[0] === "media-library" || sourceId[0] === "canvas") && (resourceType = sourceId[0], resourceId = sourceId[1]);
-    else if (sourceId && typeof sourceId == "object" && "projectId" in sourceId) {
-      const datasetSource = sourceId;
-      resourceId = `${datasetSource.projectId}.${datasetSource.dataset}`;
-    }
-  }
-  return {
+  let resourceId = "", resourceType;
+  projectId && dataset && (resourceId = `${projectId}.${dataset}`), source && (isDatasetSource(source) ? (resourceId = `${source.projectId}.${source.dataset}`, resourceType = void 0) : isMediaLibrarySource(source) ? (resourceId = source.mediaLibraryId, resourceType = "media-library") : isCanvasSource(source) && (resourceId = source.canvasId, resourceType = "canvas"));
+  let t0;
+  return $[0] !== resourceId || $[1] !== resourceType ? (t0 = {
     id: resourceId,
     type: resourceType
-  };
+  }, $[0] = resourceId, $[1] = resourceType, $[2] = t0) : t0 = $[2], t0;
 }
 function useDispatchIntent(params) {
   const {
@@ -622,7 +654,7 @@ function useDispatchIntent(params) {
   } = useWindowConnection({
     name: SDK_NODE_NAME,
     connectTo: SDK_CHANNEL_NAME
-  });
+  }), resource = useResourceIdFromDocumentHandle(documentHandle);
   return {
     dispatchIntent: useCallback(() => {
       try {
@@ -631,11 +663,11 @@ function useDispatchIntent(params) {
         const {
           projectId,
           dataset,
-          source
+          sourceName
         } = documentHandle;
-        if (action && intentId && console.warn("useDispatchIntent: Both `action` and `intentId` were provided. Using `intentId` and ignoring `action`."), !source && (!projectId || !dataset))
-          throw new Error("useDispatchIntent: Either `source` or both `projectId` and `dataset` must be provided in documentHandle.");
-        const resource = getResourceIdFromDocumentHandle(documentHandle), message = {
+        if (action && intentId && console.warn("useDispatchIntent: Both `action` and `intentId` were provided. Using `intentId` and ignoring `action`."), !sourceName && (!projectId || !dataset))
+          throw new Error("useDispatchIntent: Either `sourceName` or both `projectId` and `dataset` must be provided in documentHandle.");
+        const message = {
           type: "dashboard/v1/events/intents/dispatch-intent",
           data: {
             ...action && !intentId ? {
@@ -663,7 +695,7 @@ function useDispatchIntent(params) {
       } catch (error) {
         throw console.error("Failed to dispatch intent:", error), error;
       }
-    }, [action, intentId, documentHandle, parameters, sendMessage])
+    }, [action, intentId, documentHandle, parameters, sendMessage, resource.id, resource.type])
   };
 }
 function useManageFavorite({
@@ -1044,7 +1076,7 @@ function _temp$1(key) {
   return !ignoredKeys.includes(key);
 }
 function useQuery(options) {
-  const instance = useSanityInstance(options), [isPending, startTransition] = useTransition(), queryKey = getQueryKey(options), [deferredQueryKey, setDeferredQueryKey] = useState(queryKey), deferred = useMemo(() => parseQueryKey(deferredQueryKey), [deferredQueryKey]), ref = useRef(new AbortController());
+  const instance = useSanityInstance(options), source = useSource(options), [isPending, startTransition] = useTransition(), queryKey = getQueryKey(options), [deferredQueryKey, setDeferredQueryKey] = useState(queryKey), ref = useRef(new AbortController());
   useEffect(() => {
     queryKey !== deferredQueryKey && startTransition(() => {
       ref && !ref.current.signal.aborted && (ref.current.abort(), ref.current = new AbortController()), setDeferredQueryKey(queryKey);
@@ -1053,11 +1085,18 @@ function useQuery(options) {
   const {
     getCurrent,
     subscribe
-  } = useMemo(() => getQueryState(instance, deferred), [instance, deferred]);
+  } = useMemo(() => {
+    const deferred = parseQueryKey(deferredQueryKey);
+    return getQueryState(instance, {
+      ...deferred,
+      source
+    });
+  }, [instance, deferredQueryKey, source]);
   if (getCurrent() === void 0) {
-    const currentSignal = ref.current.signal;
+    const currentSignal = ref.current.signal, deferred_0 = parseQueryKey(deferredQueryKey);
     throw resolveQuery(instance, {
-      ...deferred,
+      ...deferred_0,
+      source,
       signal: currentSignal
     });
   }
@@ -1406,7 +1445,7 @@ function useUsers(options) {
     loadMore
   };
 }
-var version = "2.5.0";
+var version = "2.6.0";
 function getEnv(key) {
   if (typeof import.meta < "u" && import.meta.env)
     return import.meta.env[key];
@@ -1423,6 +1462,7 @@ export {
   ResourceProvider,
   SDKProvider,
   SanityApp,
+  renderSanityApp,
   useActiveReleases,
   useAgentGenerate,
   useAgentPatch,