hydrogen-sanity 5.1.0 → 5.1.2

package/dist/_chunks-es/provider.js

@@ -9,7 +9,7 @@ function assertSanityProviderValue(value) {
   return true;
 }
 function useSanityProviderValue() {
-  const providerValue = globalThis[Symbol.for("Sanity Provider")];
+  const providerValue = globalThis[/* @__PURE__ */ Symbol.for("Sanity Provider")];
   assertSanityProviderValue(providerValue);
   return providerValue;
 }
@@ -35,7 +35,7 @@ function Sanity(props) {
   );
 }
 function setProviderValue(value) {
-  globalThis[Symbol.for("Sanity Provider")] = Object.freeze(value);
+  globalThis[/* @__PURE__ */ Symbol.for("Sanity Provider")] = Object.freeze(value);
 }
 
 export { Sanity, SanityProvider, useSanityProviderValue };

package/dist/_chunks-es/provider.js.map

@@ -1 +1 @@
-{"version":3,"file":"provider.js","sources":["../../src/provider.tsx"],"sourcesContent":["import type {InitializedClientConfig} from '@sanity/client'\nimport type {HTMLProps, PropsWithChildren, ReactNode} from 'react'\n\n/**\n * Contains essential Sanity client configuration and preview/stega state.\n */\nexport interface SanityProviderValue\n  extends Required<\n    Pick<\n      InitializedClientConfig,\n      'projectId' | 'dataset' | 'apiHost' | 'apiVersion' | 'perspective'\n    >\n  > {\n  previewEnabled: boolean\n  stegaEnabled: boolean\n}\n\n/**\n * Type guard that asserts a value is a valid SanityProviderValue.\n * Throws an error if the provider value is missing or invalid.\n */\nexport function assertSanityProviderValue(value: unknown): value is SanityProviderValue {\n  if (typeof value === 'undefined') {\n    throw new Error(\n      'Failed to find a Sanity provider value. Did you forget to wrap your app in a `SanityProvider`?',\n    )\n  }\n\n  return true\n}\n\n/**\n * Hook that retrieves the current Sanity provider configuration.\n * Must be used within a SanityProvider component tree.\n */\nexport function useSanityProviderValue(): SanityProviderValue {\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  const providerValue = (globalThis as any)[Symbol.for('Sanity Provider')]\n  assertSanityProviderValue(providerValue)\n  return providerValue\n}\n\n/**\n * Provider that makes Sanity configuration available to child components.\n * Serializes configuration across server-client boundary via globalThis.\n */\nexport function SanityProvider({\n  value,\n  children,\n}: PropsWithChildren<{value: SanityProviderValue}>): ReactNode {\n  setProviderValue(value)\n  return <>{children}</>\n}\n\n/**\n * Script component that hydrates Sanity configuration on the client side.\n * Injects provider configuration into the client bundle for SSR compatibility.\n */\nexport function Sanity(props: SanityProps): ReactNode {\n  const providerValue = useSanityProviderValue()\n  assertSanityProviderValue(providerValue)\n\n  return (\n    <script\n      {...props}\n      // eslint-disable-next-line react/no-danger\n      dangerouslySetInnerHTML={{\n        __html: `(${setProviderValue})(${JSON.stringify(providerValue)})`,\n      }}\n      suppressHydrationWarning\n    />\n  )\n}\n\n/**\n * Props for the Sanity script component.\n * Extends HTMLScriptElement props while excluding conflicting attributes.\n */\nexport type SanityProps = Omit<\n  HTMLProps<HTMLScriptElement>,\n  | 'children'\n  | 'async'\n  | 'defer'\n  | 'src'\n  | 'type'\n  | 'noModule'\n  | 'dangerouslySetInnerHTML'\n  | 'suppressHydrationWarning'\n>\n\nfunction setProviderValue(value: SanityProviderValue) {\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  ;(globalThis as any)[Symbol.for('Sanity Provider')] = Object.freeze(value)\n}\n"],"names":[],"mappings":";;AAqBO,SAAS,0BAA0B,KAAA,EAA8C;AACtF,EAAA,IAAI,OAAO,UAAU,WAAA,EAAa;AAChC,IAAA,MAAM,IAAI,KAAA;AAAA,MACR;AAAA,KACF;AAAA,EACF;AAEA,EAAA,OAAO,IAAA;AACT;AAMO,SAAS,sBAAA,GAA8C;AAE5D,EAAA,MAAM,aAAA,GAAiB,UAAA,CAAmB,MAAA,CAAO,GAAA,CAAI,iBAAiB,CAAC,CAAA;AACvE,EAAA,yBAAA,CAA0B,aAAa,CAAA;AACvC,EAAA,OAAO,aAAA;AACT;AAMO,SAAS,cAAA,CAAe;AAAA,EAC7B,KAAA;AAAA,EACA;AACF,CAAA,EAA+D;AAC7D,EAAA,gBAAA,CAAiB,KAAK,CAAA;AACtB,EAAA,uCAAU,QAAA,EAAS,CAAA;AACrB;AAMO,SAAS,OAAO,KAAA,EAA+B;AACpD,EAAA,MAAM,gBAAgB,sBAAA,EAAuB;AAC7C,EAAA,yBAAA,CAA0B,aAAa,CAAA;AAEvC,EAAA,uBACE,GAAA;AAAA,IAAC,QAAA;AAAA,IAAA;AAAA,MACE,GAAG,KAAA;AAAA,MAEJ,uBAAA,EAAyB;AAAA,QACvB,QAAQ,CAAA,CAAA,EAAI,gBAAgB,KAAK,IAAA,CAAK,SAAA,CAAU,aAAa,CAAC,CAAA,CAAA;AAAA,OAChE;AAAA,MACA,wBAAA,EAAwB;AAAA;AAAA,GAC1B;AAEJ;AAkBA,SAAS,iBAAiB,KAAA,EAA4B;AAEnD,EAAC,UAAA,CAAmB,OAAO,GAAA,CAAI,iBAAiB,CAAC,CAAA,GAAI,MAAA,CAAO,OAAO,KAAK,CAAA;AAC3E;;;;"}
+{"version":3,"file":"provider.js","sources":["../../src/provider.tsx"],"sourcesContent":["import type {InitializedClientConfig} from '@sanity/client'\nimport type {HTMLProps, PropsWithChildren, ReactNode} from 'react'\n\n/**\n * Contains essential Sanity client configuration and preview/stega state.\n */\nexport interface SanityProviderValue extends Required<\n  Pick<InitializedClientConfig, 'projectId' | 'dataset' | 'apiHost' | 'apiVersion' | 'perspective'>\n> {\n  previewEnabled: boolean\n  stegaEnabled: boolean\n}\n\n/**\n * Type guard that asserts a value is a valid SanityProviderValue.\n * Throws an error if the provider value is missing or invalid.\n */\nexport function assertSanityProviderValue(value: unknown): value is SanityProviderValue {\n  if (typeof value === 'undefined') {\n    throw new Error(\n      'Failed to find a Sanity provider value. Did you forget to wrap your app in a `SanityProvider`?',\n    )\n  }\n\n  return true\n}\n\n/**\n * Hook that retrieves the current Sanity provider configuration.\n * Must be used within a SanityProvider component tree.\n */\nexport function useSanityProviderValue(): SanityProviderValue {\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  const providerValue = (globalThis as any)[Symbol.for('Sanity Provider')]\n  assertSanityProviderValue(providerValue)\n  return providerValue\n}\n\n/**\n * Provider that makes Sanity configuration available to child components.\n * Serializes configuration across server-client boundary via globalThis.\n */\nexport function SanityProvider({\n  value,\n  children,\n}: PropsWithChildren<{value: SanityProviderValue}>): ReactNode {\n  setProviderValue(value)\n  return <>{children}</>\n}\n\n/**\n * Script component that hydrates Sanity configuration on the client side.\n * Injects provider configuration into the client bundle for SSR compatibility.\n */\nexport function Sanity(props: SanityProps): ReactNode {\n  const providerValue = useSanityProviderValue()\n  assertSanityProviderValue(providerValue)\n\n  return (\n    <script\n      {...props}\n      // eslint-disable-next-line react/no-danger\n      dangerouslySetInnerHTML={{\n        __html: `(${setProviderValue})(${JSON.stringify(providerValue)})`,\n      }}\n      suppressHydrationWarning\n    />\n  )\n}\n\n/**\n * Props for the Sanity script component.\n * Extends HTMLScriptElement props while excluding conflicting attributes.\n */\nexport type SanityProps = Omit<\n  HTMLProps<HTMLScriptElement>,\n  | 'children'\n  | 'async'\n  | 'defer'\n  | 'src'\n  | 'type'\n  | 'noModule'\n  | 'dangerouslySetInnerHTML'\n  | 'suppressHydrationWarning'\n>\n\nfunction setProviderValue(value: SanityProviderValue) {\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  ;(globalThis as any)[Symbol.for('Sanity Provider')] = Object.freeze(value)\n}\n"],"names":[],"mappings":";;AAiBO,SAAS,0BAA0B,KAAA,EAA8C;AACtF,EAAA,IAAI,OAAO,UAAU,WAAA,EAAa;AAChC,IAAA,MAAM,IAAI,KAAA;AAAA,MACR;AAAA,KACF;AAAA,EACF;AAEA,EAAA,OAAO,IAAA;AACT;AAMO,SAAS,sBAAA,GAA8C;AAE5D,EAAA,MAAM,aAAA,GAAiB,UAAA,iBAAmB,MAAA,CAAO,GAAA,CAAI,iBAAiB,CAAC,CAAA;AACvE,EAAA,yBAAA,CAA0B,aAAa,CAAA;AACvC,EAAA,OAAO,aAAA;AACT;AAMO,SAAS,cAAA,CAAe;AAAA,EAC7B,KAAA;AAAA,EACA;AACF,CAAA,EAA+D;AAC7D,EAAA,gBAAA,CAAiB,KAAK,CAAA;AACtB,EAAA,uCAAU,QAAA,EAAS,CAAA;AACrB;AAMO,SAAS,OAAO,KAAA,EAA+B;AACpD,EAAA,MAAM,gBAAgB,sBAAA,EAAuB;AAC7C,EAAA,yBAAA,CAA0B,aAAa,CAAA;AAEvC,EAAA,uBACE,GAAA;AAAA,IAAC,QAAA;AAAA,IAAA;AAAA,MACE,GAAG,KAAA;AAAA,MAEJ,uBAAA,EAAyB;AAAA,QACvB,QAAQ,CAAA,CAAA,EAAI,gBAAgB,KAAK,IAAA,CAAK,SAAA,CAAU,aAAa,CAAC,CAAA,CAAA;AAAA,OAChE;AAAA,MACA,wBAAA,EAAwB;AAAA;AAAA,GAC1B;AAEJ;AAkBA,SAAS,iBAAiB,KAAA,EAA4B;AAEnD,EAAC,UAAA,wBAA0B,GAAA,CAAI,iBAAiB,CAAC,CAAA,GAAI,MAAA,CAAO,OAAO,KAAK,CAAA;AAC3E;;;;"}

package/dist/index.d.ts

@@ -6,7 +6,7 @@ import {createDataAttribute} from '@sanity/react-loader'
 import {EncodeDataAttributeFunction} from '@sanity/core-loader/encode-data-attribute'
 import type {HTMLProps} from 'react'
 import {HydrogenSession} from '@shopify/hydrogen'
-import type {ImageUrlBuilder} from '@sanity/image-url/lib/types/builder'
+import type {ImageUrlBuilder} from '@sanity/image-url'
 import type {InitializedClientConfig} from '@sanity/client'
 import {PropsWithChildren} from 'react'
 import {QueryParams} from '@sanity/client'
@@ -15,7 +15,7 @@ import {QueryWithoutParams} from '@sanity/client'
 import {ReactNode} from 'react'
 import {ResponseQueryOptions} from '@sanity/client'
 import {SanityClient} from '@sanity/client'
-import type {SanityImageSource} from '@sanity/image-url/lib/types/types'
+import type {SanityImageSource} from '@sanity/image-url'
 import {Session} from 'react-router'
 import {SessionStorage} from 'react-router'
 import {SuspenseProps} from 'react'
@@ -143,8 +143,10 @@ declare interface QueryClientProps<Result = Any, Query extends string = string>
   ) => ReactNode
 }
 
-export declare interface QueryProps<Result = Any, Query extends string = string>
-  extends Omit<QueryClientProps<Result, Query>, 'options'> {
+export declare interface QueryProps<Result = Any, Query extends string = string> extends Omit<
+  QueryClientProps<Result, Query>,
+  'options'
+> {
   query: Query
   params?: QueryParams | QueryWithoutParams
   options: {
@@ -253,13 +255,9 @@ declare type SanityProps = Omit<
 /**
  * Contains essential Sanity client configuration and preview/stega state.
  */
-declare interface SanityProviderValue
-  extends Required<
-    Pick<
-      InitializedClientConfig,
-      'projectId' | 'dataset' | 'apiHost' | 'apiVersion' | 'perspective'
-    >
-  > {
+declare interface SanityProviderValue extends Required<
+  Pick<InitializedClientConfig, 'projectId' | 'dataset' | 'apiHost' | 'apiVersion' | 'perspective'>
+> {
   previewEnabled: boolean
   stegaEnabled: boolean
 }

package/dist/index.js

@@ -5,7 +5,7 @@ import { isPreviewEnabled, usePreviewMode } from './preview/index.js';
 import { SanityProvider, useSanityProviderValue } from './_chunks-es/provider.js';
 export { Sanity } from './_chunks-es/provider.js';
 import { supportsPerspectiveStack, getPerspective, hashQuery, isServer } from './_chunks-es/utils.js';
-import createImageUrlBuilder from '@sanity/image-url';
+import { createImageUrlBuilder } from '@sanity/image-url';
 import { jsx } from 'react/jsx-runtime';
 import { useQuery as useQuery$1 } from '@sanity/react-loader';
 export { createDataAttribute, useEncodeDataAttribute } from '@sanity/react-loader';
@@ -16,6 +16,8 @@ const DEFAULT_CACHE_STRATEGY = CacheLong();
 
 let didWarnAboutNoApiVersion = false;
 let didWarnAboutNoPerspectiveSupport = false;
+let didWarnAboutLoadQuery = false;
+let didInitializeLoader = false;
 async function createSanityContext(options) {
   const { cache, waitUntil = () => Promise.resolve(), request, preview, defaultStrategy } = options;
   const withCache = cache ? createWithCache({ cache, waitUntil, request }) : null;
@@ -57,8 +59,6 @@ You can find the latest version in the Sanity changelog: https://www.sanity.io/c
         token: preview.token,
         perspective
       });
-      const { setServerClient } = await import('@sanity/react-loader');
-      setServerClient(client);
     }
   }
   const { apiHost, projectId, dataset, apiVersion } = client.config();
@@ -71,12 +71,23 @@ You can find the latest version in the Sanity changelog: https://www.sanity.io/c
     perspective: client.config().perspective || "published",
     stegaEnabled: client.config().stega?.enabled ?? false
   };
-  const sanityContext = {
+  return {
     /**
      * Loads a Sanity query with client-side loader support and Hydrogen cache integration.
      * Bypasses Hydrogen cache in preview mode.
      */
     async loadQuery(query, params, loaderOptions) {
+      if (!didInitializeLoader) {
+        const { setServerClient } = await import('@sanity/react-loader');
+        setServerClient(client);
+        didInitializeLoader = true;
+      }
+      if (!previewEnabled && process.env.NODE_ENV === "development" && !didWarnAboutLoadQuery) {
+        console.warn(
+          `\`loadQuery\` is being called outside of preview mode. Consider using \`query\` instead, which automatically handles both preview and production modes efficiently, or use \`fetch\`. \`loadQuery\` is intended to be called conditionally in preview and visual editing contexts.`
+        );
+        didWarnAboutLoadQuery = true;
+      }
       if (!withCache || previewEnabled) {
         const { loadQuery } = await import('@sanity/react-loader');
         return await loadQuery(query, params, loaderOptions);
@@ -144,7 +155,6 @@ You can find the latest version in the Sanity changelog: https://www.sanity.io/c
       );
     }
   };
-  return sanityContext;
 }
 
 function useImageUrlBuilder() {

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sources":["../src/constants.ts","../src/context.ts","../src/image.ts","../src/Query.tsx","../src/visual-editing/useQuery.tsx"],"sourcesContent":["import {CacheLong, type CachingStrategy} from '@shopify/hydrogen'\n\n/** Default Sanity API version with perspective stack support */\nexport const DEFAULT_API_VERSION = 'v2025-02-19'\n\n/** Default Hydrogen caching strategy for Sanity queries */\nexport const DEFAULT_CACHE_STRATEGY: CachingStrategy = CacheLong()\n","import {\n  type Any,\n  type ClientConfig,\n  type ClientPerspective,\n  type ClientReturn,\n  createClient,\n  type QueryParams,\n  type QueryWithoutParams,\n  type ResponseQueryOptions,\n  SanityClient,\n} from '@sanity/client'\nimport type {QueryResponseInitial} from '@sanity/react-loader'\nimport {type CachingStrategy, createWithCache, type HydrogenSession} from '@shopify/hydrogen'\nimport {createElement, type PropsWithChildren, type ReactNode} from 'react'\n\nimport {DEFAULT_API_VERSION, DEFAULT_CACHE_STRATEGY} from './constants'\nimport type {SanityPreviewSession} from './preview/session'\nimport {isPreviewEnabled} from './preview/utils'\nimport {SanityProvider, type SanityProviderValue} from './provider'\nimport type {CacheActionFunctionParam, WaitUntil} from './types'\nimport {getPerspective} from './utils'\nimport {hashQuery, supportsPerspectiveStack} from './utils'\n\nlet didWarnAboutNoApiVersion = false\nlet didWarnAboutNoPerspectiveSupport = false\n\nexport type CreateSanityContextOptions = {\n  request: Request\n\n  cache?: Cache | undefined\n  waitUntil?: WaitUntil | undefined\n\n  /**\n   * Sanity client or configuration to use.\n   */\n  client: SanityClient | ClientConfig\n\n  /**\n   * The default caching strategy to use for `loadQuery` subrequests.\n   * @see https://shopify.dev/docs/custom-storefronts/hydrogen/caching#caching-strategies\n   *\n   * Defaults to `CacheLong`\n   */\n  defaultStrategy?: CachingStrategy | null\n\n  /**\n   * Configuration for enabling preview mode.\n   */\n  preview?: {\n    token: string\n    session: SanityPreviewSession | HydrogenSession\n  }\n}\n\ninterface RequestInit {\n  hydrogen?: {\n    /**\n     * The caching strategy to use for the subrequest.\n     * @see https://shopify.dev/docs/custom-storefronts/hydrogen/caching#caching-strategies\n     */\n    cache?: CachingStrategy\n\n    /**\n     * Optional debugging information to be displayed in the subrequest profiler.\n     * @see https://shopify.dev/docs/custom-storefronts/hydrogen/debugging/subrequest-profiler#how-to-provide-more-debug-information-for-a-request\n     */\n    debug?: {\n      displayName: string\n    }\n  }\n}\n\ntype HydrogenResponseQueryOptions = Omit<ResponseQueryOptions, 'next' | 'cache'> & {\n  hydrogen?: 'hydrogen' extends keyof RequestInit ? RequestInit['hydrogen'] : never\n}\n\nexport type LoadQueryOptions<T> = Pick<\n  HydrogenResponseQueryOptions,\n  'perspective' | 'hydrogen' | 'useCdn' | 'stega' | 'headers' | 'tag'\n> & {\n  hydrogen?: {\n    /**\n     * The caching strategy to use for the subrequest.\n     * @see https://shopify.dev/docs/custom-storefronts/hydrogen/caching#caching-strategies\n     */\n    cache?: CachingStrategy\n\n    /**\n     * Optional debugging information to be displayed in the subrequest profiler.\n     * @see https://shopify.dev/docs/custom-storefronts/hydrogen/debugging/subrequest-profiler#how-to-provide-more-debug-information-for-a-request\n     */\n    debug?: {\n      displayName: string\n    }\n\n    /**\n     * Whether to cache the result of the query or not.\n     * @defaultValue () => true\n     */\n    shouldCacheResult?: (value: QueryResponseInitial<T>) => boolean\n  }\n}\n\nexport type FetchOptions<T> = HydrogenResponseQueryOptions & {\n  hydrogen?: {\n    /**\n     * The caching strategy to use for the subrequest.\n     * @see https://shopify.dev/docs/custom-storefronts/hydrogen/caching#caching-strategies\n     */\n    cache?: CachingStrategy\n\n    /**\n     * Optional debugging information to be displayed in the subrequest profiler.\n     * @see https://shopify.dev/docs/custom-storefronts/hydrogen/debugging/subrequest-profiler#how-to-provide-more-debug-information-for-a-request\n     */\n    debug?: {\n      displayName: string\n    }\n\n    /**\n     * Whether to cache the result of the query or not.\n     * @defaultValue () => true\n     */\n    shouldCacheResult?: (value: QueryResponseInitial<T>) => boolean\n  }\n}\n\nexport interface SanityContext {\n  /**\n   * Query Sanity using the loader.\n   * @see https://www.sanity.io/docs/loaders\n   */\n  loadQuery<Result = Any, Query extends string = string>(\n    query: Query,\n    params?: QueryParams | QueryWithoutParams,\n    options?: LoadQueryOptions<ClientReturn<Query, Result>>,\n  ): Promise<QueryResponseInitial<ClientReturn<Query, Result>>>\n\n  /**\n   * Query Sanity using direct client fetch with Hydrogen caching.\n   * Use this when you need direct client results without react-loader integration.\n   * Automatically disables caching in preview mode for real-time updates.\n   */\n  fetch<Result = Any, Query extends string = string>(\n    query: Query,\n    params?: QueryParams | QueryWithoutParams,\n    options?: FetchOptions<Result>,\n  ): Promise<ClientReturn<Query, Result>>\n\n  /**\n   * Conditionally query Sanity using either loadQuery (for preview mode) or fetch (for static mode).\n   * This optimizes bundle size by only loading @sanity/react-loader dependencies when in preview mode.\n   */\n  query<Result = Any, Query extends string = string>(\n    query: Query,\n    params?: QueryParams | QueryWithoutParams,\n    options?: LoadQueryOptions<ClientReturn<Query, Result>> & FetchOptions<Result>,\n  ): Promise<QueryResponseInitial<ClientReturn<Query, Result>> | ClientReturn<Query, Result>>\n\n  /**\n   * The Sanity client, automatically configured for preview mode when enabled.\n   * Uses preview token, perspective, and CDN settings based on session state.\n   */\n  client: SanityClient\n\n  preview?: CreateSanityContextOptions['preview'] & {\n    /**\n     * Whether preview mode is currently enabled based on session detection\n     */\n    enabled: boolean\n  }\n\n  SanityProvider: (props: PropsWithChildren<object>) => ReactNode\n}\n\n/**\n * @public\n */\nexport async function createSanityContext(\n  options: CreateSanityContextOptions,\n): Promise<SanityContext> {\n  const {cache, waitUntil = () => Promise.resolve(), request, preview, defaultStrategy} = options\n  const withCache = cache ? createWithCache({cache, waitUntil, request}) : null\n  let client =\n    options.client instanceof SanityClient ? options.client : createClient(options.client)\n\n  if (client.config().apiVersion === '1') {\n    if (process.env.NODE_ENV === 'development' && !didWarnAboutNoApiVersion) {\n      console.warn(\n        `\nNo API version specified, defaulting to \\`${DEFAULT_API_VERSION}\\` which supports perspectives and Content Releases.\nYou can find the latest version in the Sanity changelog: https://www.sanity.io/changelog.\n    `.trim(),\n      )\n\n      didWarnAboutNoApiVersion = true\n    }\n\n    client = client.withConfig({apiVersion: DEFAULT_API_VERSION})\n  }\n\n  // Determine if preview is enabled and configure the client accordingly\n  let previewEnabled = false\n  if (preview) {\n    if (!preview.token) {\n      throw new Error('Enabling preview mode requires a token.')\n    }\n\n    previewEnabled = isPreviewEnabled(client.config().projectId!, preview.session)\n\n    if (previewEnabled) {\n      const apiVersion = client.config().apiVersion\n      let perspective: ClientPerspective\n      if (supportsPerspectiveStack(apiVersion)) {\n        perspective = getPerspective(preview.session)\n      } else {\n        if (process.env.NODE_ENV === 'development' && !didWarnAboutNoPerspectiveSupport) {\n          console.warn(\n            `API version \\`${apiVersion}\\` does not support perspective stacks. Using \\`previewDrafts\\` perspective. Consider upgrading to \\`v2025-02-19\\` or later for full perspective support.`,\n          )\n\n          didWarnAboutNoPerspectiveSupport = true\n        }\n        perspective = 'previewDrafts'\n      }\n\n      client = client.withConfig({\n        useCdn: false,\n        token: preview.token,\n        perspective,\n      })\n\n      // Set server client for react-loader when in preview mode\n      const {setServerClient} = await import('@sanity/react-loader')\n      setServerClient(client)\n    }\n  }\n\n  // Server client will be initialized lazily on first loadQuery call\n\n  const {apiHost, projectId, dataset, apiVersion} = client.config()\n  const providerValue: SanityProviderValue = {\n    projectId: projectId!,\n    dataset: dataset!,\n    apiHost,\n    apiVersion: apiVersion!,\n    previewEnabled,\n    perspective: client.config().perspective || 'published',\n    stegaEnabled: client.config().stega?.enabled ?? false,\n  }\n\n  const sanityContext: SanityContext = {\n    /**\n     * Loads a Sanity query with client-side loader support and Hydrogen cache integration.\n     * Bypasses Hydrogen cache in preview mode.\n     */\n    async loadQuery<Result = Any, Query extends string = string>(\n      query: Query,\n      params: QueryParams | QueryWithoutParams,\n      loaderOptions?: LoadQueryOptions<ClientReturn<Query, Result>>,\n    ): Promise<QueryResponseInitial<ClientReturn<Query, Result>>> {\n      if (!withCache || previewEnabled) {\n        const {loadQuery} = await import('@sanity/react-loader')\n        return await loadQuery<ClientReturn<Query, Result>>(query, params, loaderOptions)\n      }\n\n      const cacheStrategy =\n        loaderOptions?.hydrogen?.cache || defaultStrategy || DEFAULT_CACHE_STRATEGY\n      const queryHash = await hashQuery(query, params)\n      const shouldCacheResult = loaderOptions?.hydrogen?.shouldCacheResult ?? (() => true)\n\n      return await withCache.run(\n        {cacheKey: queryHash, cacheStrategy, shouldCacheResult},\n        async ({\n          addDebugData,\n        }: CacheActionFunctionParam): Promise<\n          QueryResponseInitial<ClientReturn<Query, Result>>\n        > => {\n          // Name displayed in the subrequest profiler\n          const displayName = loaderOptions?.hydrogen?.debug?.displayName || 'query Sanity'\n\n          addDebugData({\n            displayName,\n          })\n\n          const {loadQuery} = await import('@sanity/react-loader')\n          return await loadQuery<ClientReturn<Query, Result>>(query, params, loaderOptions)\n        },\n      )\n    },\n\n    /**\n     * Executes a Sanity query with Hydrogen cache integration.\n     * Direct client fetch without loader integration. Bypasses cache in preview mode.\n     */\n    async fetch<Result = Any, Query extends string = string>(\n      query: Query,\n      params: QueryParams | QueryWithoutParams = {},\n      fetchOptions?: Pick<\n        LoadQueryOptions<Result>,\n        'perspective' | 'hydrogen' | 'useCdn' | 'headers' | 'tag'\n      >,\n    ): Promise<ClientReturn<Query, Result>> {\n      if (!withCache || previewEnabled) {\n        return await client.fetch<ClientReturn<Query, Result>>(query, params, fetchOptions)\n      }\n\n      const cacheStrategy =\n        fetchOptions?.hydrogen?.cache || defaultStrategy || DEFAULT_CACHE_STRATEGY\n      const queryHash = await hashQuery(query, params)\n\n      return await withCache.run(\n        {cacheKey: queryHash, cacheStrategy, shouldCacheResult: () => true},\n        async ({addDebugData}: CacheActionFunctionParam): Promise<ClientReturn<Query, Result>> => {\n          // Name displayed in the subrequest profiler\n          const displayName = fetchOptions?.hydrogen?.debug?.displayName || 'fetch Sanity'\n\n          addDebugData({\n            displayName,\n          })\n\n          return await client.fetch<ClientReturn<Query, Result>>(query, params, fetchOptions)\n        },\n      )\n    },\n\n    /**\n     * Automatic query method that automatically adapts based on preview mode state.\n     * Uses `loadQuery` (with client-side loader integration) when preview is enabled, `fetch` otherwise.\n     * Bypasses cache in preview mode.\n     */\n    async query<Result = Any, Query extends string = string>(\n      query: Query,\n      params?: QueryParams | QueryWithoutParams,\n      queryOptions?: LoadQueryOptions<ClientReturn<Query, Result>> & FetchOptions<Result>,\n    ): Promise<QueryResponseInitial<ClientReturn<Query, Result>> | ClientReturn<Query, Result>> {\n      return await (previewEnabled ? this.loadQuery : this.fetch)(query, params, queryOptions)\n    },\n\n    /** The configured Sanity client instance */\n    client,\n\n    /** Preview configuration with session-based state, undefined when preview is not configured */\n    preview: preview ? {...preview, enabled: previewEnabled} : undefined,\n\n    /**\n     * React Provider component that serializes Sanity configuration across server-client boundary.\n     */\n    SanityProvider({children}: PropsWithChildren<object>) {\n      return createElement(\n        SanityProvider,\n        {\n          value: Object.freeze(providerValue),\n        },\n        children,\n      )\n    },\n  }\n\n  return sanityContext\n}\n","import {default as createImageUrlBuilder} from '@sanity/image-url'\nimport type {ImageUrlBuilder} from '@sanity/image-url/lib/types/builder'\nimport type {SanityImageSource, SanityModernClientLike} from '@sanity/image-url/lib/types/types'\nimport {useMemo} from 'react'\n\nimport {useSanityProviderValue} from './provider'\n\n/**\n * Hook that returns a Sanity image URL builder configured with current provider settings.\n * Use this to create custom image transformations beyond `useImageUrl`.\n */\nexport function useImageUrlBuilder(): ImageUrlBuilder {\n  const {projectId, dataset, apiHost} = useSanityProviderValue()\n  return useMemo(() => {\n    return createImageUrlBuilder({\n      config: () => ({projectId, dataset, apiHost}),\n    } as SanityModernClientLike)\n  }, [apiHost, dataset, projectId])\n}\n\n/**\n * Hook that generates image URLs from Sanity image assets.\n * Returns a configured image URL builder for the given source.\n */\nexport function useImageUrl(source: SanityImageSource): ImageUrlBuilder {\n  const builder = useImageUrlBuilder()\n  return builder.image(source)\n}\n\nexport type {ImageUrlBuilder} from '@sanity/image-url/lib/types/builder'\nexport type * from '@sanity/image-url/lib/types/types'\n","import type {Any, ClientReturn, QueryParams, QueryWithoutParams} from '@sanity/client'\nimport type {EncodeDataAttributeFunction} from '@sanity/core-loader/encode-data-attribute'\nimport type {QueryResponseInitial} from '@sanity/react-loader'\nimport {lazy, type ReactNode, Suspense, type SuspenseProps, useSyncExternalStore} from 'react'\n\nimport type {LoadQueryOptions} from './context'\nimport {usePreviewMode} from './preview/hooks'\nimport type {QueryClientProps} from './Query.client'\nimport {isServer} from './utils'\n\n/**\n * Fallback component that renders nothing, preventing hydration mismatches.\n */\nfunction SanityQueryFallback(): ReactNode {\n  return null\n}\n\n/**\n * Simple hydration store to avoid hydration mismatches.\n * Returns false on server, true on client after hydration.\n */\nfunction useIsHydrated(): boolean {\n  return useSyncExternalStore(\n    // eslint-disable-next-line no-empty-function\n    () => () => {},\n    () => true,\n    () => false,\n  )\n}\n\nconst QueryClient = isServer()\n  ? SanityQueryFallback\n  : (lazy(\n      () =>\n        /**\n         * `lazy` expects the component as the default export\n         * @see https://react.dev/reference/react/lazy\n         */\n        import('./Query.client'),\n    ) as <Result = Any, Query extends string = string>(\n      props: QueryClientProps<Result, Query>,\n    ) => ReactNode)\n\nconst noopEncodeDataAttribute: EncodeDataAttributeFunction = Object.assign(() => undefined, {\n  scope: () => noopEncodeDataAttribute,\n})\n\nexport interface QueryProps<Result = Any, Query extends string = string>\n  extends Omit<QueryClientProps<Result, Query>, 'options'> {\n  query: Query\n  params?: QueryParams | QueryWithoutParams\n  options: {\n    initial: ClientReturn<Query, Result> | QueryResponseInitial<ClientReturn<Query, Result>>\n  } & LoadQueryOptions<ClientReturn<Query, Result>>\n  children: (\n    data: ClientReturn<Query, Result>,\n    encodeDataAttribute: EncodeDataAttributeFunction,\n  ) => ReactNode\n}\n\n/**\n * Query component that provides live updates in preview mode and static data otherwise.\n *\n * @public\n */\nexport function Query<Result = Any, Query extends string = string>({\n  query,\n  params,\n  options,\n  children,\n  ...suspenseProps\n}: QueryProps<Result, Query> & Omit<SuspenseProps, 'children'>): ReactNode {\n  const isPreviewMode = usePreviewMode()\n  const isHydrated = useIsHydrated()\n\n  // If in preview mode and hydrated, render the client component\n  if (isPreviewMode && isHydrated) {\n    return (\n      <Suspense {...suspenseProps} fallback={suspenseProps.fallback ?? <SanityQueryFallback />}>\n        <QueryClient<Result, Query>\n          query={query}\n          params={params}\n          options={options as QueryClientProps<Result, Query>['options']}\n        >\n          {children}\n        </QueryClient>\n      </Suspense>\n    )\n  }\n\n  // Render static data in non-preview mode or during hydration\n  return children(options.initial as ClientReturn<Query, Result>, noopEncodeDataAttribute)\n}\n","import {useQuery as _useQuery, type UseQueryOptionsDefinedInitial} from '@sanity/react-loader'\nimport {useEffect, useId} from 'react'\n\nimport {registerQuery} from './registry'\n\n/**\n * Automatically registers with the query detection system.\n * This enables automatic live mode detection in `VisualEditing` components.\n */\nexport function useQuery<QueryResponseResult = unknown>(\n  query: string,\n  params?: Record<string, unknown>,\n  options?: UseQueryOptionsDefinedInitial<QueryResponseResult>,\n): ReturnType<typeof _useQuery<QueryResponseResult>> {\n  // Generate stable ID for this `useQuery` instance\n  const id = useId()\n\n  // Register this `useQuery` instance with the detection system\n  useEffect(() => {\n    const unregister = registerQuery(id)\n    return unregister\n  }, [id])\n\n  // Call the original `useQuery` with all the same arguments\n  return _useQuery<QueryResponseResult>(query, params, options)\n}\n"],"names":["apiVersion","_useQuery"],"mappings":"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"}
+{"version":3,"file":"index.js","sources":["../src/constants.ts","../src/context.ts","../src/image.ts","../src/Query.tsx","../src/visual-editing/useQuery.tsx"],"sourcesContent":["import {CacheLong, type CachingStrategy} from '@shopify/hydrogen'\n\n/** Default Sanity API version with perspective stack support */\nexport const DEFAULT_API_VERSION = 'v2025-02-19'\n\n/** Default Hydrogen caching strategy for Sanity queries */\nexport const DEFAULT_CACHE_STRATEGY: CachingStrategy = CacheLong()\n","import {\n  type Any,\n  type ClientConfig,\n  type ClientPerspective,\n  type ClientReturn,\n  createClient,\n  type QueryParams,\n  type QueryWithoutParams,\n  type ResponseQueryOptions,\n  SanityClient,\n} from '@sanity/client'\nimport type {QueryResponseInitial} from '@sanity/react-loader'\nimport {type CachingStrategy, createWithCache, type HydrogenSession} from '@shopify/hydrogen'\nimport {createElement, type PropsWithChildren, type ReactNode} from 'react'\n\nimport {DEFAULT_API_VERSION, DEFAULT_CACHE_STRATEGY} from './constants'\nimport type {SanityPreviewSession} from './preview/session'\nimport {isPreviewEnabled} from './preview/utils'\nimport {SanityProvider, type SanityProviderValue} from './provider'\nimport type {CacheActionFunctionParam, WaitUntil} from './types'\nimport {getPerspective} from './utils'\nimport {hashQuery, supportsPerspectiveStack} from './utils'\n\nlet didWarnAboutNoApiVersion = false\nlet didWarnAboutNoPerspectiveSupport = false\nlet didWarnAboutLoadQuery = false\nlet didInitializeLoader = false\n\nexport type CreateSanityContextOptions = {\n  request: Request\n\n  cache?: Cache | undefined\n  waitUntil?: WaitUntil | undefined\n\n  /**\n   * Sanity client or configuration to use.\n   */\n  client: SanityClient | ClientConfig\n\n  /**\n   * The default caching strategy to use for `loadQuery` subrequests.\n   * @see https://shopify.dev/docs/custom-storefronts/hydrogen/caching#caching-strategies\n   *\n   * Defaults to `CacheLong`\n   */\n  defaultStrategy?: CachingStrategy | null\n\n  /**\n   * Configuration for enabling preview mode.\n   */\n  preview?: {\n    token: string\n    session: SanityPreviewSession | HydrogenSession\n  }\n}\n\ninterface RequestInit {\n  hydrogen?: {\n    /**\n     * The caching strategy to use for the subrequest.\n     * @see https://shopify.dev/docs/custom-storefronts/hydrogen/caching#caching-strategies\n     */\n    cache?: CachingStrategy\n\n    /**\n     * Optional debugging information to be displayed in the subrequest profiler.\n     * @see https://shopify.dev/docs/custom-storefronts/hydrogen/debugging/subrequest-profiler#how-to-provide-more-debug-information-for-a-request\n     */\n    debug?: {\n      displayName: string\n    }\n  }\n}\n\ntype HydrogenResponseQueryOptions = Omit<ResponseQueryOptions, 'next' | 'cache'> & {\n  hydrogen?: 'hydrogen' extends keyof RequestInit ? RequestInit['hydrogen'] : never\n}\n\nexport type LoadQueryOptions<T> = Pick<\n  HydrogenResponseQueryOptions,\n  'perspective' | 'hydrogen' | 'useCdn' | 'stega' | 'headers' | 'tag'\n> & {\n  hydrogen?: {\n    /**\n     * The caching strategy to use for the subrequest.\n     * @see https://shopify.dev/docs/custom-storefronts/hydrogen/caching#caching-strategies\n     */\n    cache?: CachingStrategy\n\n    /**\n     * Optional debugging information to be displayed in the subrequest profiler.\n     * @see https://shopify.dev/docs/custom-storefronts/hydrogen/debugging/subrequest-profiler#how-to-provide-more-debug-information-for-a-request\n     */\n    debug?: {\n      displayName: string\n    }\n\n    /**\n     * Whether to cache the result of the query or not.\n     * @defaultValue () => true\n     */\n    shouldCacheResult?: (value: QueryResponseInitial<T>) => boolean\n  }\n}\n\nexport type FetchOptions<T> = HydrogenResponseQueryOptions & {\n  hydrogen?: {\n    /**\n     * The caching strategy to use for the subrequest.\n     * @see https://shopify.dev/docs/custom-storefronts/hydrogen/caching#caching-strategies\n     */\n    cache?: CachingStrategy\n\n    /**\n     * Optional debugging information to be displayed in the subrequest profiler.\n     * @see https://shopify.dev/docs/custom-storefronts/hydrogen/debugging/subrequest-profiler#how-to-provide-more-debug-information-for-a-request\n     */\n    debug?: {\n      displayName: string\n    }\n\n    /**\n     * Whether to cache the result of the query or not.\n     * @defaultValue () => true\n     */\n    shouldCacheResult?: (value: QueryResponseInitial<T>) => boolean\n  }\n}\n\nexport interface SanityContext {\n  /**\n   * Query Sanity using the loader.\n   * @see https://www.sanity.io/docs/loaders\n   */\n  loadQuery<Result = Any, Query extends string = string>(\n    query: Query,\n    params?: QueryParams | QueryWithoutParams,\n    options?: LoadQueryOptions<ClientReturn<Query, Result>>,\n  ): Promise<QueryResponseInitial<ClientReturn<Query, Result>>>\n\n  /**\n   * Query Sanity using direct client fetch with Hydrogen caching.\n   * Use this when you need direct client results without react-loader integration.\n   * Automatically disables caching in preview mode for real-time updates.\n   */\n  fetch<Result = Any, Query extends string = string>(\n    query: Query,\n    params?: QueryParams | QueryWithoutParams,\n    options?: FetchOptions<Result>,\n  ): Promise<ClientReturn<Query, Result>>\n\n  /**\n   * Conditionally query Sanity using either loadQuery (for preview mode) or fetch (for static mode).\n   * This optimizes bundle size by only loading @sanity/react-loader dependencies when in preview mode.\n   */\n  query<Result = Any, Query extends string = string>(\n    query: Query,\n    params?: QueryParams | QueryWithoutParams,\n    options?: LoadQueryOptions<ClientReturn<Query, Result>> & FetchOptions<Result>,\n  ): Promise<QueryResponseInitial<ClientReturn<Query, Result>> | ClientReturn<Query, Result>>\n\n  /**\n   * The Sanity client, automatically configured for preview mode when enabled.\n   * Uses preview token, perspective, and CDN settings based on session state.\n   */\n  client: SanityClient\n\n  preview?: CreateSanityContextOptions['preview'] & {\n    /**\n     * Whether preview mode is currently enabled based on session detection\n     */\n    enabled: boolean\n  }\n\n  SanityProvider: (props: PropsWithChildren<object>) => ReactNode\n}\n\n/**\n * @public\n */\nexport async function createSanityContext(\n  options: CreateSanityContextOptions,\n): Promise<SanityContext> {\n  const {cache, waitUntil = () => Promise.resolve(), request, preview, defaultStrategy} = options\n  const withCache = cache ? createWithCache({cache, waitUntil, request}) : null\n  let client =\n    options.client instanceof SanityClient ? options.client : createClient(options.client)\n\n  if (client.config().apiVersion === '1') {\n    if (process.env.NODE_ENV === 'development' && !didWarnAboutNoApiVersion) {\n      console.warn(\n        `\nNo API version specified, defaulting to \\`${DEFAULT_API_VERSION}\\` which supports perspectives and Content Releases.\nYou can find the latest version in the Sanity changelog: https://www.sanity.io/changelog.\n    `.trim(),\n      )\n\n      didWarnAboutNoApiVersion = true\n    }\n\n    client = client.withConfig({apiVersion: DEFAULT_API_VERSION})\n  }\n\n  // Determine if preview is enabled and configure the client accordingly\n  let previewEnabled = false\n  if (preview) {\n    if (!preview.token) {\n      throw new Error('Enabling preview mode requires a token.')\n    }\n\n    previewEnabled = isPreviewEnabled(client.config().projectId!, preview.session)\n\n    if (previewEnabled) {\n      const apiVersion = client.config().apiVersion\n      let perspective: ClientPerspective\n      if (supportsPerspectiveStack(apiVersion)) {\n        perspective = getPerspective(preview.session)\n      } else {\n        if (process.env.NODE_ENV === 'development' && !didWarnAboutNoPerspectiveSupport) {\n          console.warn(\n            `API version \\`${apiVersion}\\` does not support perspective stacks. Using \\`previewDrafts\\` perspective. Consider upgrading to \\`v2025-02-19\\` or later for full perspective support.`,\n          )\n\n          didWarnAboutNoPerspectiveSupport = true\n        }\n        perspective = 'previewDrafts'\n      }\n\n      client = client.withConfig({\n        useCdn: false,\n        token: preview.token,\n        perspective,\n      })\n    }\n  }\n\n  // Server client will be initialized lazily on first loadQuery call\n  const {apiHost, projectId, dataset, apiVersion} = client.config()\n  const providerValue: SanityProviderValue = {\n    projectId: projectId!,\n    dataset: dataset!,\n    apiHost,\n    apiVersion: apiVersion!,\n    previewEnabled,\n    perspective: client.config().perspective || 'published',\n    stegaEnabled: client.config().stega?.enabled ?? false,\n  }\n\n  return {\n    /**\n     * Loads a Sanity query with client-side loader support and Hydrogen cache integration.\n     * Bypasses Hydrogen cache in preview mode.\n     */\n    async loadQuery<Result = Any, Query extends string = string>(\n      query: Query,\n      params: QueryParams | QueryWithoutParams,\n      loaderOptions?: LoadQueryOptions<ClientReturn<Query, Result>>,\n    ): Promise<QueryResponseInitial<ClientReturn<Query, Result>>> {\n      // Lazy initialize the loader on first call with the configured client\n      if (!didInitializeLoader) {\n        const {setServerClient} = await import('@sanity/react-loader')\n        setServerClient(client)\n        didInitializeLoader = true\n      }\n\n      // Warn users to migrate to `query` method when using loadQuery outside preview mode\n      if (!previewEnabled && process.env.NODE_ENV === 'development' && !didWarnAboutLoadQuery) {\n        console.warn(\n          `\\`loadQuery\\` is being called outside of preview mode. Consider using \\`query\\` instead, which automatically handles both preview and production modes efficiently, or use \\`fetch\\`. \\`loadQuery\\` is intended to be called conditionally in preview and visual editing contexts.`,\n        )\n        didWarnAboutLoadQuery = true\n      }\n\n      if (!withCache || previewEnabled) {\n        const {loadQuery} = await import('@sanity/react-loader')\n        return await loadQuery<ClientReturn<Query, Result>>(query, params, loaderOptions)\n      }\n\n      const cacheStrategy =\n        loaderOptions?.hydrogen?.cache || defaultStrategy || DEFAULT_CACHE_STRATEGY\n      const queryHash = await hashQuery(query, params)\n      const shouldCacheResult = loaderOptions?.hydrogen?.shouldCacheResult ?? (() => true)\n\n      return await withCache.run(\n        {cacheKey: queryHash, cacheStrategy, shouldCacheResult},\n        async ({\n          addDebugData,\n        }: CacheActionFunctionParam): Promise<\n          QueryResponseInitial<ClientReturn<Query, Result>>\n        > => {\n          // Name displayed in the subrequest profiler\n          const displayName = loaderOptions?.hydrogen?.debug?.displayName || 'query Sanity'\n\n          addDebugData({\n            displayName,\n          })\n\n          const {loadQuery} = await import('@sanity/react-loader')\n          return await loadQuery<ClientReturn<Query, Result>>(query, params, loaderOptions)\n        },\n      )\n    },\n\n    /**\n     * Executes a Sanity query with Hydrogen cache integration.\n     * Direct client fetch without loader integration. Bypasses cache in preview mode.\n     */\n    async fetch<Result = Any, Query extends string = string>(\n      query: Query,\n      params: QueryParams | QueryWithoutParams = {},\n      fetchOptions?: Pick<\n        LoadQueryOptions<Result>,\n        'perspective' | 'hydrogen' | 'useCdn' | 'headers' | 'tag'\n      >,\n    ): Promise<ClientReturn<Query, Result>> {\n      if (!withCache || previewEnabled) {\n        return await client.fetch<ClientReturn<Query, Result>>(query, params, fetchOptions)\n      }\n\n      const cacheStrategy =\n        fetchOptions?.hydrogen?.cache || defaultStrategy || DEFAULT_CACHE_STRATEGY\n      const queryHash = await hashQuery(query, params)\n\n      return await withCache.run(\n        {cacheKey: queryHash, cacheStrategy, shouldCacheResult: () => true},\n        async ({addDebugData}: CacheActionFunctionParam): Promise<ClientReturn<Query, Result>> => {\n          // Name displayed in the subrequest profiler\n          const displayName = fetchOptions?.hydrogen?.debug?.displayName || 'fetch Sanity'\n\n          addDebugData({\n            displayName,\n          })\n\n          return await client.fetch<ClientReturn<Query, Result>>(query, params, fetchOptions)\n        },\n      )\n    },\n\n    /**\n     * Automatic query method that automatically adapts based on preview mode state.\n     * Uses `loadQuery` (with client-side loader integration) when preview is enabled, `fetch` otherwise.\n     * Bypasses cache in preview mode.\n     */\n    async query<Result = Any, Query extends string = string>(\n      query: Query,\n      params?: QueryParams | QueryWithoutParams,\n      queryOptions?: LoadQueryOptions<ClientReturn<Query, Result>> & FetchOptions<Result>,\n    ): Promise<QueryResponseInitial<ClientReturn<Query, Result>> | ClientReturn<Query, Result>> {\n      return await (previewEnabled ? this.loadQuery : this.fetch)(query, params, queryOptions)\n    },\n\n    /** The configured Sanity client instance */\n    client,\n\n    /** Preview configuration with session-based state, undefined when preview is not configured */\n    preview: preview ? {...preview, enabled: previewEnabled} : undefined,\n\n    /**\n     * React Provider component that serializes Sanity configuration across server-client boundary.\n     */\n    SanityProvider({children}: PropsWithChildren<object>) {\n      return createElement(\n        SanityProvider,\n        {\n          value: Object.freeze(providerValue),\n        },\n        children,\n      )\n    },\n  } satisfies SanityContext\n}\n","import type {ImageUrlBuilder, SanityImageSource, SanityModernClientLike} from '@sanity/image-url'\nimport {createImageUrlBuilder} from '@sanity/image-url'\nimport {useMemo} from 'react'\n\nimport {useSanityProviderValue} from './provider'\n\n/**\n * Hook that returns a Sanity image URL builder configured with current provider settings.\n * Use this to create custom image transformations beyond `useImageUrl`.\n */\nexport function useImageUrlBuilder(): ImageUrlBuilder {\n  const {projectId, dataset, apiHost} = useSanityProviderValue()\n  return useMemo(() => {\n    return createImageUrlBuilder({\n      config: () => ({projectId, dataset, apiHost}),\n    } as SanityModernClientLike)\n  }, [apiHost, dataset, projectId])\n}\n\n/**\n * Hook that generates image URLs from Sanity image assets.\n * Returns a configured image URL builder for the given source.\n */\nexport function useImageUrl(source: SanityImageSource): ImageUrlBuilder {\n  const builder = useImageUrlBuilder()\n  return builder.image(source)\n}\n\nexport type * from '@sanity/image-url'\n","import type {Any, ClientReturn, QueryParams, QueryWithoutParams} from '@sanity/client'\nimport type {EncodeDataAttributeFunction} from '@sanity/core-loader/encode-data-attribute'\nimport type {QueryResponseInitial} from '@sanity/react-loader'\nimport {lazy, type ReactNode, Suspense, type SuspenseProps, useSyncExternalStore} from 'react'\n\nimport type {LoadQueryOptions} from './context'\nimport {usePreviewMode} from './preview/hooks'\nimport type {QueryClientProps} from './Query.client'\nimport {isServer} from './utils'\n\n/**\n * Fallback component that renders nothing, preventing hydration mismatches.\n */\nfunction SanityQueryFallback(): ReactNode {\n  return null\n}\n\n/**\n * Simple hydration store to avoid hydration mismatches.\n * Returns false on server, true on client after hydration.\n */\nfunction useIsHydrated(): boolean {\n  return useSyncExternalStore(\n    // eslint-disable-next-line no-empty-function\n    () => () => {},\n    () => true,\n    () => false,\n  )\n}\n\nconst QueryClient = isServer()\n  ? SanityQueryFallback\n  : (lazy(\n      () =>\n        /**\n         * `lazy` expects the component as the default export\n         * @see https://react.dev/reference/react/lazy\n         */\n        import('./Query.client'),\n    ) as <Result = Any, Query extends string = string>(\n      props: QueryClientProps<Result, Query>,\n    ) => ReactNode)\n\nconst noopEncodeDataAttribute: EncodeDataAttributeFunction = Object.assign(() => undefined, {\n  scope: () => noopEncodeDataAttribute,\n})\n\nexport interface QueryProps<Result = Any, Query extends string = string> extends Omit<\n  QueryClientProps<Result, Query>,\n  'options'\n> {\n  query: Query\n  params?: QueryParams | QueryWithoutParams\n  options: {\n    initial: ClientReturn<Query, Result> | QueryResponseInitial<ClientReturn<Query, Result>>\n  } & LoadQueryOptions<ClientReturn<Query, Result>>\n  children: (\n    data: ClientReturn<Query, Result>,\n    encodeDataAttribute: EncodeDataAttributeFunction,\n  ) => ReactNode\n}\n\n/**\n * Query component that provides live updates in preview mode and static data otherwise.\n *\n * @public\n */\nexport function Query<Result = Any, Query extends string = string>({\n  query,\n  params,\n  options,\n  children,\n  ...suspenseProps\n}: QueryProps<Result, Query> & Omit<SuspenseProps, 'children'>): ReactNode {\n  const isPreviewMode = usePreviewMode()\n  const isHydrated = useIsHydrated()\n\n  // If in preview mode and hydrated, render the client component\n  if (isPreviewMode && isHydrated) {\n    return (\n      <Suspense {...suspenseProps} fallback={suspenseProps.fallback ?? <SanityQueryFallback />}>\n        <QueryClient<Result, Query>\n          query={query}\n          params={params}\n          options={options as QueryClientProps<Result, Query>['options']}\n        >\n          {children}\n        </QueryClient>\n      </Suspense>\n    )\n  }\n\n  // Render static data in non-preview mode or during hydration\n  return children(options.initial as ClientReturn<Query, Result>, noopEncodeDataAttribute)\n}\n","import {useQuery as _useQuery, type UseQueryOptionsDefinedInitial} from '@sanity/react-loader'\nimport {useEffect, useId} from 'react'\n\nimport {registerQuery} from './registry'\n\n/**\n * Automatically registers with the query detection system.\n * This enables automatic live mode detection in `VisualEditing` components.\n */\nexport function useQuery<QueryResponseResult = unknown>(\n  query: string,\n  params?: Record<string, unknown>,\n  options?: UseQueryOptionsDefinedInitial<QueryResponseResult>,\n): ReturnType<typeof _useQuery<QueryResponseResult>> {\n  // Generate stable ID for this `useQuery` instance\n  const id = useId()\n\n  // Register this `useQuery` instance with the detection system\n  useEffect(() => {\n    const unregister = registerQuery(id)\n    return unregister\n  }, [id])\n\n  // Call the original `useQuery` with all the same arguments\n  return _useQuery<QueryResponseResult>(query, params, options)\n}\n"],"names":["apiVersion","_useQuery"],"mappings":"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"}

package/dist/vite/index.js

@@ -7,7 +7,7 @@ function sanity() {
         ssr: {
           optimizeDeps: {
             // Pre-bundle Sanity dependencies for better SSR performance
-            include: ["@sanity/client", "hydrogen-sanity > @sanity/image-url"]
+            include: ["@sanity/client"]
           },
           // Prevent externalization of Sanity dependencies to ensure proper ESM resolution
           noExternal: ["@sanity/client"]

package/dist/vite/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sources":["../../src/vite/plugin.ts"],"sourcesContent":["import type {Plugin, ResolvedConfig} from 'vite'\n\n/**\n * Vite plugin for optimizing Sanity integration in Hydrogen applications.\n * Configures SSR optimization, dependency bundling, and ESM resolution for Sanity packages.\n */\nexport function sanity(): Plugin {\n  return {\n    name: 'sanity',\n\n    async config() {\n      return {\n        envPrefix: ['SANITY_STUDIO_'],\n        ssr: {\n          optimizeDeps: {\n            // Pre-bundle Sanity dependencies for better SSR performance\n            include: ['@sanity/client', 'hydrogen-sanity > @sanity/image-url'],\n          },\n          // Prevent externalization of Sanity dependencies to ensure proper ESM resolution\n          noExternal: ['@sanity/client'],\n        },\n      }\n    },\n\n    configResolved(resolvedConfig: ResolvedConfig) {\n      // Force ESM resolution for transitive dependencies (specifically `rxjs`) in SSR builds\n      // The Hydrogen/Oxygen plugins add 'node' conditions which cause packages like rxjs\n      // to resolve to their CJS versions (dist/cjs/index.js) instead of ESM versions\n      // We prepend 'es2015' and filter out 'node'/'require' to force ESM resolution\n\n      // Prepend es2015 and remove node/require to force ESM resolution in SSR\n      const ssrConditions = [\n        'es2015',\n        ...(resolvedConfig.ssr?.resolve?.conditions || []).filter(\n          (condition) => condition !== 'es2015' && condition !== 'node' && condition !== 'require',\n        ),\n      ]\n\n      // Override SSR resolve conditions\n      if (resolvedConfig.ssr?.resolve) {\n        resolvedConfig.ssr.resolve.conditions = ssrConditions\n      }\n\n      // Handle SSR environment (modern environments API)\n      if (resolvedConfig.environments?.ssr?.resolve?.conditions) {\n        const envConditions = [\n          'es2015',\n          ...resolvedConfig.environments.ssr.resolve.conditions.filter(\n            (condition) =>\n              condition !== 'es2015' && condition !== 'node' && condition !== 'require',\n          ),\n        ]\n        resolvedConfig.environments.ssr.resolve.conditions = envConditions\n      }\n    },\n  }\n}\n"],"names":[],"mappings":"AAMO,SAAS,MAAA,GAAiB;AAC/B,EAAA,OAAO;AAAA,IACL,IAAA,EAAM,QAAA;AAAA,IAEN,MAAM,MAAA,GAAS;AACb,MAAA,OAAO;AAAA,QACL,SAAA,EAAW,CAAC,gBAAgB,CAAA;AAAA,QAC5B,GAAA,EAAK;AAAA,UACH,YAAA,EAAc;AAAA;AAAA,YAEZ,OAAA,EAAS,CAAC,gBAAA,EAAkB,qCAAqC;AAAA,WACnE;AAAA;AAAA,UAEA,UAAA,EAAY,CAAC,gBAAgB;AAAA;AAC/B,OACF;AAAA,IACF,CAAA;AAAA,IAEA,eAAe,cAAA,EAAgC;AAO7C,MAAA,MAAM,aAAA,GAAgB;AAAA,QACpB,QAAA;AAAA,QACA,IAAI,cAAA,CAAe,GAAA,EAAK,OAAA,EAAS,UAAA,IAAc,EAAC,EAAG,MAAA;AAAA,UACjD,CAAC,SAAA,KAAc,SAAA,KAAc,QAAA,IAAY,SAAA,KAAc,UAAU,SAAA,KAAc;AAAA;AACjF,OACF;AAGA,MAAA,IAAI,cAAA,CAAe,KAAK,OAAA,EAAS;AAC/B,QAAA,cAAA,CAAe,GAAA,CAAI,QAAQ,UAAA,GAAa,aAAA;AAAA,MAC1C;AAGA,MAAA,IAAI,cAAA,CAAe,YAAA,EAAc,GAAA,EAAK,OAAA,EAAS,UAAA,EAAY;AACzD,QAAA,MAAM,aAAA,GAAgB;AAAA,UACpB,QAAA;AAAA,UACA,GAAG,cAAA,CAAe,YAAA,CAAa,GAAA,CAAI,QAAQ,UAAA,CAAW,MAAA;AAAA,YACpD,CAAC,SAAA,KACC,SAAA,KAAc,QAAA,IAAY,SAAA,KAAc,UAAU,SAAA,KAAc;AAAA;AACpE,SACF;AACA,QAAA,cAAA,CAAe,YAAA,CAAa,GAAA,CAAI,OAAA,CAAQ,UAAA,GAAa,aAAA;AAAA,MACvD;AAAA,IACF;AAAA,GACF;AACF;;;;"}
+{"version":3,"file":"index.js","sources":["../../src/vite/plugin.ts"],"sourcesContent":["import type {Plugin, ResolvedConfig} from 'vite'\n\n/**\n * Vite plugin for optimizing Sanity integration in Hydrogen applications.\n * Configures SSR optimization, dependency bundling, and ESM resolution for Sanity packages.\n */\nexport function sanity(): Plugin {\n  return {\n    name: 'sanity',\n\n    async config() {\n      return {\n        envPrefix: ['SANITY_STUDIO_'],\n        ssr: {\n          optimizeDeps: {\n            // Pre-bundle Sanity dependencies for better SSR performance\n            include: ['@sanity/client'],\n          },\n          // Prevent externalization of Sanity dependencies to ensure proper ESM resolution\n          noExternal: ['@sanity/client'],\n        },\n      }\n    },\n\n    configResolved(resolvedConfig: ResolvedConfig) {\n      // Force ESM resolution for transitive dependencies (specifically `rxjs`) in SSR builds\n      // The Hydrogen/Oxygen plugins add 'node' conditions which cause packages like rxjs\n      // to resolve to their CJS versions (dist/cjs/index.js) instead of ESM versions\n      // We prepend 'es2015' and filter out 'node'/'require' to force ESM resolution\n\n      // Prepend es2015 and remove node/require to force ESM resolution in SSR\n      const ssrConditions = [\n        'es2015',\n        ...(resolvedConfig.ssr?.resolve?.conditions || []).filter(\n          (condition) => condition !== 'es2015' && condition !== 'node' && condition !== 'require',\n        ),\n      ]\n\n      // Override SSR resolve conditions\n      if (resolvedConfig.ssr?.resolve) {\n        resolvedConfig.ssr.resolve.conditions = ssrConditions\n      }\n\n      // Handle SSR environment (modern environments API)\n      if (resolvedConfig.environments?.ssr?.resolve?.conditions) {\n        const envConditions = [\n          'es2015',\n          ...resolvedConfig.environments.ssr.resolve.conditions.filter(\n            (condition) =>\n              condition !== 'es2015' && condition !== 'node' && condition !== 'require',\n          ),\n        ]\n        resolvedConfig.environments.ssr.resolve.conditions = envConditions\n      }\n    },\n  }\n}\n"],"names":[],"mappings":"AAMO,SAAS,MAAA,GAAiB;AAC/B,EAAA,OAAO;AAAA,IACL,IAAA,EAAM,QAAA;AAAA,IAEN,MAAM,MAAA,GAAS;AACb,MAAA,OAAO;AAAA,QACL,SAAA,EAAW,CAAC,gBAAgB,CAAA;AAAA,QAC5B,GAAA,EAAK;AAAA,UACH,YAAA,EAAc;AAAA;AAAA,YAEZ,OAAA,EAAS,CAAC,gBAAgB;AAAA,WAC5B;AAAA;AAAA,UAEA,UAAA,EAAY,CAAC,gBAAgB;AAAA;AAC/B,OACF;AAAA,IACF,CAAA;AAAA,IAEA,eAAe,cAAA,EAAgC;AAO7C,MAAA,MAAM,aAAA,GAAgB;AAAA,QACpB,QAAA;AAAA,QACA,IAAI,cAAA,CAAe,GAAA,EAAK,OAAA,EAAS,UAAA,IAAc,EAAC,EAAG,MAAA;AAAA,UACjD,CAAC,SAAA,KAAc,SAAA,KAAc,QAAA,IAAY,SAAA,KAAc,UAAU,SAAA,KAAc;AAAA;AACjF,OACF;AAGA,MAAA,IAAI,cAAA,CAAe,KAAK,OAAA,EAAS;AAC/B,QAAA,cAAA,CAAe,GAAA,CAAI,QAAQ,UAAA,GAAa,aAAA;AAAA,MAC1C;AAGA,MAAA,IAAI,cAAA,CAAe,YAAA,EAAc,GAAA,EAAK,OAAA,EAAS,UAAA,EAAY;AACzD,QAAA,MAAM,aAAA,GAAgB;AAAA,UACpB,QAAA;AAAA,UACA,GAAG,cAAA,CAAe,YAAA,CAAa,GAAA,CAAI,QAAQ,UAAA,CAAW,MAAA;AAAA,YACpD,CAAC,SAAA,KACC,SAAA,KAAc,QAAA,IAAY,SAAA,KAAc,UAAU,SAAA,KAAc;AAAA;AACpE,SACF;AACA,QAAA,cAAA,CAAe,YAAA,CAAa,GAAA,CAAI,OAAA,CAAQ,UAAA,GAAa,aAAA;AAAA,MACvD;AAAA,IACF;AAAA,GACF;AACF;;;;"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "hydrogen-sanity",
-  "version": "5.1.0",
+  "version": "5.1.2",
   "description": "Sanity.io toolkit for Hydrogen",
   "keywords": [
     "sanity",
@@ -17,11 +17,17 @@
   },
   "repository": {
     "type": "git",
-    "url": "git+ssh://git@github.com/sanity-io/hydrogen-sanity.git"
+    "url": "git+https://github.com/sanity-io/hydrogen-sanity.git",
+    "directory": "packages/hydrogen-sanity"
   },
   "license": "MIT",
   "author": "Sanity.io <hello@sanity.io>",
   "sideEffects": false,
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/",
+    "provenance": true
+  },
   "type": "module",
   "exports": {
     ".": {
@@ -95,7 +101,7 @@
   "dependencies": {
     "@sanity/comlink": "^3.0.9",
     "@sanity/core-loader": "^1.8.18",
-    "@sanity/image-url": "^1.1.0",
+    "@sanity/image-url": "^2.0.2",
     "@sanity/presentation-comlink": "^1.0.28",
     "@sanity/preview-url-secret": "^2.1.14",
     "@sanity/react-loader": "^1.11.18",
@@ -103,32 +109,32 @@
     "use-effect-event": "^2.0.3"
   },
   "devDependencies": {
-    "@eslint/eslintrc": "^3.3.1",
-    "@eslint/js": "^9.34.0",
-    "@rollup/plugin-node-resolve": "^16.0.1",
+    "@eslint/eslintrc": "^3.3.3",
+    "@eslint/js": "^9.39.1",
+    "@rollup/plugin-node-resolve": "^16.0.3",
     "@sanity/client": "^7.9.0",
-    "@sanity/pkg-utils": "^7.11.9",
-    "@sanity/semantic-release-preset": "^5.0.0",
+    "@sanity/pkg-utils": "^10.1.2",
+    "@sanity/semantic-release-preset": "^6.0.0",
     "@shopify/hydrogen": "~2025.7.0",
     "@testing-library/react": "^16.3.0",
     "@types/react": "^18.3.24",
-    "@typescript-eslint/eslint-plugin": "^8.41.0",
-    "@typescript-eslint/parser": "^8.41.0",
-    "eslint": "^9.34.0",
+    "@typescript-eslint/eslint-plugin": "^8.49.0",
+    "@typescript-eslint/parser": "^8.49.0",
+    "eslint": "^9.39.1",
     "eslint-config-prettier": "^10.1.8",
     "eslint-config-sanity": "^7.1.4",
     "eslint-plugin-prettier": "^5.5.4",
     "eslint-plugin-react": "^7.37.5",
     "eslint-plugin-react-hooks": "0.0.0-experimental-f3a80361-20250911",
     "eslint-plugin-simple-import-sort": "^12.1.1",
-    "groq": "^4.5.0",
+    "groq": "^4.21.0",
     "react": "^18.3.1",
     "react-dom": "^18.3.1",
     "react-router": "7.9.2",
-    "semantic-release": "^24.2.7",
-    "typescript": "^5.9.2",
+    "semantic-release": "^25.0.2",
+    "typescript": "^5.9.3",
     "vite": "^6.3.5",
-    "vitest": "^3.2.4"
+    "vitest": "^4.0.15"
   },
   "peerDependencies": {
     "@sanity/client": "^7",

package/src/Query.tsx

@@ -45,8 +45,10 @@ const noopEncodeDataAttribute: EncodeDataAttributeFunction = Object.assign(() =>
   scope: () => noopEncodeDataAttribute,
 })
 
-export interface QueryProps<Result = Any, Query extends string = string>
-  extends Omit<QueryClientProps<Result, Query>, 'options'> {
+export interface QueryProps<Result = Any, Query extends string = string> extends Omit<
+  QueryClientProps<Result, Query>,
+  'options'
+> {
   query: Query
   params?: QueryParams | QueryWithoutParams
   options: {

package/src/context.test.ts

@@ -21,6 +21,7 @@ const cache = vi.hoisted<Cache>(() => ({
 }))
 
 const loadQuery = vi.hoisted<QueryStore['loadQuery']>(() => vi.fn().mockResolvedValue(null))
+const setServerClient = vi.hoisted(() => vi.fn())
 let withCache = vi.hoisted<WithCache | null>(() => null)
 
 vi.mock('@shopify/hydrogen', async (importOriginal) => {
@@ -43,6 +44,7 @@ vi.mock('@sanity/react-loader', async (importOriginal) => {
   return {
     ...module,
     loadQuery,
+    setServerClient,
   }
 })
 
@@ -436,3 +438,140 @@ describe('stegaEnabled serialization', () => {
     expect(Object.isFrozen(providerValue)).toBe(true)
   })
 })
+
+describe('lazy-initialize loaders', () => {
+  const request = new Request('https://example.com')
+
+  beforeEach(() => {
+    vi.clearAllMocks()
+  })
+
+  it("shouldn't call `setServerClient` during context creation", async () => {
+    await createSanityContext({
+      request,
+      cache,
+      client,
+    })
+
+    expect(setServerClient).not.toHaveBeenCalled()
+  })
+
+  it('should allow `loadQuery` to be called not in preview mode', async () => {
+    const context = await createSanityContext({
+      request,
+      cache,
+      client,
+    })
+
+    // loadQuery should work in non-preview mode (backwards compatibility)
+    // The actual loadQuery function will be called from the mocked module
+    await context.loadQuery<boolean>(query, params)
+
+    // Verify the mock was called (actual behavior testing is done in other tests)
+    expect(loadQuery).toHaveBeenCalled()
+  })
+
+  it('should call `setServerClient` on first `loadQuery` invocation in preview mode', async () => {
+    const previewSession = new PreviewSession()
+    previewSession.set('projectId', projectId)
+
+    const context = await createSanityContext({
+      request,
+      cache,
+      client,
+      preview: {
+        token: 'my-token',
+        session: previewSession,
+      },
+    })
+
+    // First call to `loadQuery`
+    await context.loadQuery<boolean>(query, params)
+
+    // Should be called with the preview-configured client
+    // Check the most recent call
+    const latestCall = setServerClient.mock.calls[setServerClient.mock.calls.length - 1]
+    if (latestCall) {
+      const calledWithClient = latestCall[0]
+      expect(calledWithClient.config().useCdn).toBe(false)
+      expect(calledWithClient.config().token).toBe('my-token')
+    }
+  })
+
+  it('should display warning when `loadQuery` called outside preview mode in development', async () => {
+    const originalNodeEnv = process.env.NODE_ENV
+    process.env.NODE_ENV = 'development'
+    const warnSpy = vi.spyOn(console, 'warn').mockImplementation(() => undefined)
+
+    const context = await createSanityContext({
+      request,
+      cache,
+      client,
+    })
+
+    const callsBefore = warnSpy.mock.calls.length
+
+    await context.loadQuery<boolean>(query, params)
+
+    // Should have warned about loadQuery usage (may have other warnings too)
+    expect(warnSpy.mock.calls.length).toBeGreaterThan(callsBefore)
+    expect(warnSpy).toHaveBeenCalledWith(
+      expect.stringContaining('`loadQuery` is being called outside of preview mode'),
+    )
+
+    const callsAfterFirst = warnSpy.mock.calls.length
+
+    // Second call should not warn again about loadQuery
+    await context.loadQuery<boolean>(query, params)
+    expect(warnSpy.mock.calls.length).toBe(callsAfterFirst)
+
+    warnSpy.mockRestore()
+    process.env.NODE_ENV = originalNodeEnv
+  })
+
+  it("shouldn't display warning in production", async () => {
+    const originalNodeEnv = process.env.NODE_ENV
+    process.env.NODE_ENV = 'production'
+    const warnSpy = vi.spyOn(console, 'warn').mockImplementation(() => undefined)
+
+    const context = await createSanityContext({
+      request,
+      cache,
+      client,
+    })
+
+    await context.loadQuery<boolean>(query, params)
+
+    expect(warnSpy).not.toHaveBeenCalled()
+
+    warnSpy.mockRestore()
+    process.env.NODE_ENV = originalNodeEnv
+  })
+
+  it("shouldn't display warning when in preview mode", async () => {
+    const originalNodeEnv = process.env.NODE_ENV
+    process.env.NODE_ENV = 'development'
+    const warnSpy = vi.spyOn(console, 'warn').mockImplementation(() => undefined)
+
+    const previewSession = new PreviewSession()
+    previewSession.set('projectId', projectId)
+
+    const context = await createSanityContext({
+      request,
+      cache,
+      client,
+      preview: {
+        token: 'my-token',
+        session: previewSession,
+      },
+    })
+
+    await context.loadQuery<boolean>(query, params)
+
+    // Should not warn because we're in preview mode
+    expect(warnSpy).not.toHaveBeenCalled()
+
+    warnSpy.mockRestore()
+    process.env.NODE_ENV = originalNodeEnv
+  })
+})

package/src/context.ts

@@ -23,6 +23,8 @@ import {hashQuery, supportsPerspectiveStack} from './utils'
 
 let didWarnAboutNoApiVersion = false
 let didWarnAboutNoPerspectiveSupport = false
+let didWarnAboutLoadQuery = false
+let didInitializeLoader = false
 
 export type CreateSanityContextOptions = {
   request: Request
@@ -229,15 +231,10 @@ You can find the latest version in the Sanity changelog: https://www.sanity.io/c
         token: preview.token,
         perspective,
       })
-
-      // Set server client for react-loader when in preview mode
-      const {setServerClient} = await import('@sanity/react-loader')
-      setServerClient(client)
     }
   }
 
   // Server client will be initialized lazily on first loadQuery call
-
   const {apiHost, projectId, dataset, apiVersion} = client.config()
   const providerValue: SanityProviderValue = {
     projectId: projectId!,
@@ -249,7 +246,7 @@ You can find the latest version in the Sanity changelog: https://www.sanity.io/c
     stegaEnabled: client.config().stega?.enabled ?? false,
   }
 
-  const sanityContext: SanityContext = {
+  return {
     /**
      * Loads a Sanity query with client-side loader support and Hydrogen cache integration.
      * Bypasses Hydrogen cache in preview mode.
@@ -259,6 +256,21 @@ You can find the latest version in the Sanity changelog: https://www.sanity.io/c
       params: QueryParams | QueryWithoutParams,
       loaderOptions?: LoadQueryOptions<ClientReturn<Query, Result>>,
     ): Promise<QueryResponseInitial<ClientReturn<Query, Result>>> {
+      // Lazy initialize the loader on first call with the configured client
+      if (!didInitializeLoader) {
+        const {setServerClient} = await import('@sanity/react-loader')
+        setServerClient(client)
+        didInitializeLoader = true
+      }
+
+      // Warn users to migrate to `query` method when using loadQuery outside preview mode
+      if (!previewEnabled && process.env.NODE_ENV === 'development' && !didWarnAboutLoadQuery) {
+        console.warn(
+          `\`loadQuery\` is being called outside of preview mode. Consider using \`query\` instead, which automatically handles both preview and production modes efficiently, or use \`fetch\`. \`loadQuery\` is intended to be called conditionally in preview and visual editing contexts.`,
+        )
+        didWarnAboutLoadQuery = true
+      }
+
       if (!withCache || previewEnabled) {
         const {loadQuery} = await import('@sanity/react-loader')
         return await loadQuery<ClientReturn<Query, Result>>(query, params, loaderOptions)
@@ -355,7 +367,5 @@ You can find the latest version in the Sanity changelog: https://www.sanity.io/c
         children,
       )
     },
-  }
-
-  return sanityContext
+  } satisfies SanityContext
 }

package/src/image.ts

@@ -1,6 +1,5 @@
-import {default as createImageUrlBuilder} from '@sanity/image-url'
-import type {ImageUrlBuilder} from '@sanity/image-url/lib/types/builder'
-import type {SanityImageSource, SanityModernClientLike} from '@sanity/image-url/lib/types/types'
+import type {ImageUrlBuilder, SanityImageSource, SanityModernClientLike} from '@sanity/image-url'
+import {createImageUrlBuilder} from '@sanity/image-url'
 import {useMemo} from 'react'
 
 import {useSanityProviderValue} from './provider'
@@ -27,5 +26,4 @@ export function useImageUrl(source: SanityImageSource): ImageUrlBuilder {
   return builder.image(source)
 }
 
-export type {ImageUrlBuilder} from '@sanity/image-url/lib/types/builder'
-export type * from '@sanity/image-url/lib/types/types'
+export type * from '@sanity/image-url'

package/src/provider.tsx

@@ -4,13 +4,9 @@ import type {HTMLProps, PropsWithChildren, ReactNode} from 'react'
 /**
  * Contains essential Sanity client configuration and preview/stega state.
  */
-export interface SanityProviderValue
-  extends Required<
-    Pick<
-      InitializedClientConfig,
-      'projectId' | 'dataset' | 'apiHost' | 'apiVersion' | 'perspective'
-    >
-  > {
+export interface SanityProviderValue extends Required<
+  Pick<InitializedClientConfig, 'projectId' | 'dataset' | 'apiHost' | 'apiVersion' | 'perspective'>
+> {
   previewEnabled: boolean
   stegaEnabled: boolean
 }

package/src/vite/plugin.ts

@@ -14,7 +14,7 @@ export function sanity(): Plugin {
         ssr: {
           optimizeDeps: {
             // Pre-bundle Sanity dependencies for better SSR performance
-            include: ['@sanity/client', 'hydrogen-sanity > @sanity/image-url'],
+            include: ['@sanity/client'],
           },
           // Prevent externalization of Sanity dependencies to ensure proper ESM resolution
           noExternal: ['@sanity/client'],