next-sanity 12.4.0 → 12.4.1

package/dist/PresentationComlink.js.map

@@ -1 +1 @@
-{"version":3,"file":"PresentationComlink.js","names":[],"sources":["../src/live/client-components/PresentationComlink.tsx"],"sourcesContent":["import type {ClientPerspective} from '@sanity/client'\nimport {\n  createNode,\n  createNodeMachine,\n  // type Node,\n} from '@sanity/comlink'\nimport {\n  createCompatibilityActors,\n  type LoaderControllerMsg,\n  type LoaderNodeMsg,\n} from '@sanity/presentation-comlink'\nimport {setPerspectiveCookie} from 'next-sanity/live/server-actions'\nimport {useRouter} from 'next/navigation'\nimport {useEffect, useEffectEvent} from 'react'\n\nimport {setComlink, setComlinkClientConfig} from '../hooks/context'\n\nfunction PresentationComlink(props: {\n  projectId: string\n  dataset: string\n  // handleDraftModeAction: (secret: string) => Promise<void | string>\n  draftModeEnabled: boolean\n  draftModePerspective: ClientPerspective\n}): React.JSX.Element | null {\n  const {projectId, dataset, draftModeEnabled, draftModePerspective} = props\n  const router = useRouter()\n\n  // const [presentationComlink, setPresentationComlink] = useState<Node<\n  //   LoaderControllerMsg,\n  //   LoaderNodeMsg\n  // > | null>(null)\n\n  useEffect(() => {\n    setComlinkClientConfig(projectId, dataset)\n  }, [dataset, projectId])\n\n  const handlePerspectiveChange = useEffectEvent(\n    (perspective: ClientPerspective, signal: AbortSignal) => {\n      if (draftModeEnabled && perspective !== draftModePerspective) {\n        setPerspectiveCookie(perspective)\n          .then(() => {\n            if (signal.aborted) return\n            router.refresh()\n          })\n          .catch((reason) => console.error('Failed to set the preview perspective cookie', reason))\n      }\n    },\n  )\n\n  // const [status, setStatus] = useState('disconnected')\n  useEffect(() => {\n    const comlink = createNode<LoaderNodeMsg, LoaderControllerMsg>(\n      {\n        name: 'loaders',\n        connectTo: 'presentation',\n      },\n      createNodeMachine<LoaderNodeMsg, LoaderControllerMsg>().provide({\n        actors: createCompatibilityActors<LoaderNodeMsg>(),\n      }),\n    )\n\n    // comlink.onStatus((status) => {\n    //   setStatus(status)\n    // })\n\n    let controller: AbortController | undefined\n    comlink.on('loader/perspective', (data) => {\n      controller?.abort()\n      controller = new AbortController()\n      handlePerspectiveChange(data.perspective, controller.signal)\n    })\n\n    const stop = comlink.start()\n    // setPresentationComlink(comlink)\n    setComlink(comlink)\n    // console.log('setting comlink', comlink)\n    return () => {\n      // console.log('stopping comlink')\n      stop()\n    }\n  }, [])\n\n  // @TODO come back to this later\n  // const handleEnableDraftMode = useEffectEvent(async (signal: AbortSignal) => {\n  //   if (signal.aborted) return\n  //   const {secret} = await (presentationComlink?.fetch(\n  //     {\n  //       type: 'loader/fetch-preview-url-secret' as const,\n  //       data: {projectId, dataset},\n  //     },\n  //     {signal},\n  //   ) || {secret: null})\n  //   if (signal.aborted) return\n  //   const error = await handleDraftModeAction(secret!)\n  //   // eslint-disable-next-line no-console\n  //   // @TODO call another server action here that can tell us if draft mode is actually enabled\n  //   if (error) {\n  //     // @TODO use sonnet or whatever to push a toast with the error\n  //     // eslint-disable-next-line no-console\n  //     console.error('Error enabling draft mode', error)\n  //     return\n  //   }\n  //   // console.log('Draft mode enabled?', {enabled})\n  //   if (signal.aborted) return\n  //   router.refresh()\n  // })\n  // const connected = status === 'connected'\n  // useEffect(() => {\n  //   if (connected && !draftModeEnabled) {\n  //     const controller = new AbortController()\n  //     handleEnableDraftMode(controller.signal).catch((reason) => {\n  //       // eslint-disable-next-line no-console\n  //       console.error('Failed to enable draft mode', reason)\n  //       return handleEnableDraftMode(controller.signal)\n  //     })\n  //     return () => {\n  //       controller.abort()\n  //     }\n  //   }\n  //   return undefined\n  // }, [connected, draftModeEnabled, handleEnableDraftMode])\n\n  return null\n}\nPresentationComlink.displayName = 'PresentationComlink'\n\nexport default PresentationComlink\n"],"mappings":";;;;;;AAiBA,SAAS,oBAAoB,OAMA;CAC3B,MAAM,EAAC,WAAW,SAAS,kBAAkB,yBAAwB;CACrE,MAAM,SAAS,WAAW;AAO1B,iBAAgB;AACd,yBAAuB,WAAW,QAAQ;IACzC,CAAC,SAAS,UAAU,CAAC;CAExB,MAAM,0BAA0B,gBAC7B,aAAgC,WAAwB;AACvD,MAAI,oBAAoB,gBAAgB,qBACtC,sBAAqB,YAAY,CAC9B,WAAW;AACV,OAAI,OAAO,QAAS;AACpB,UAAO,SAAS;IAChB,CACD,OAAO,WAAW,QAAQ,MAAM,gDAAgD,OAAO,CAAC;GAGhG;AAGD,iBAAgB;EACd,MAAM,UAAU,WACd;GACE,MAAM;GACN,WAAW;GACZ,EACD,mBAAuD,CAAC,QAAQ,EAC9D,QAAQ,2BAA0C,EACnD,CAAC,CACH;EAMD,IAAI;AACJ,UAAQ,GAAG,uBAAuB,SAAS;AACzC,eAAY,OAAO;AACnB,gBAAa,IAAI,iBAAiB;AAClC,2BAAwB,KAAK,aAAa,WAAW,OAAO;IAC5D;EAEF,MAAM,OAAO,QAAQ,OAAO;AAE5B,aAAW,QAAQ;AAEnB,eAAa;AAEX,SAAM;;IAEP,EAAE,CAAC;AA0CN,QAAO;;AAET,oBAAoB,cAAc"}
+{"version":3,"file":"PresentationComlink.js","names":[],"sources":["../src/live/client-components/PresentationComlink.tsx"],"sourcesContent":["import type {ClientPerspective} from '@sanity/client'\nimport {createNode, createNodeMachine} from '@sanity/comlink'\nimport {\n  createCompatibilityActors,\n  type LoaderControllerMsg,\n  type LoaderNodeMsg,\n} from '@sanity/presentation-comlink'\nimport {setPerspectiveCookie} from 'next-sanity/live/server-actions'\nimport {useRouter} from 'next/navigation'\nimport {useEffect, useEffectEvent} from 'react'\n\nimport {setComlink, setComlinkClientConfig} from '../hooks/context'\n\nfunction PresentationComlink(props: {\n  projectId: string\n  dataset: string\n  draftModeEnabled: boolean\n  draftModePerspective: ClientPerspective\n}): React.JSX.Element | null {\n  const {projectId, dataset, draftModeEnabled, draftModePerspective} = props\n  const router = useRouter()\n\n  useEffect(() => {\n    setComlinkClientConfig(projectId, dataset)\n  }, [dataset, projectId])\n\n  const handlePerspectiveChange = useEffectEvent(\n    (perspective: ClientPerspective, signal: AbortSignal) => {\n      if (draftModeEnabled && perspective !== draftModePerspective) {\n        setPerspectiveCookie(perspective)\n          .then(() => {\n            if (signal.aborted) return\n            router.refresh()\n          })\n          .catch((reason) => console.error('Failed to set the preview perspective cookie', reason))\n      }\n    },\n  )\n\n  useEffect(() => {\n    const comlink = createNode<LoaderNodeMsg, LoaderControllerMsg>(\n      {\n        name: 'loaders',\n        connectTo: 'presentation',\n      },\n      createNodeMachine<LoaderNodeMsg, LoaderControllerMsg>().provide({\n        actors: createCompatibilityActors<LoaderNodeMsg>(),\n      }),\n    )\n\n    let controller: AbortController | undefined\n    comlink.on('loader/perspective', (data) => {\n      controller?.abort()\n      controller = new AbortController()\n      handlePerspectiveChange(data.perspective, controller.signal)\n    })\n\n    const stop = comlink.start()\n    setComlink(comlink)\n    return () => {\n      stop()\n    }\n  }, [])\n\n  return null\n}\nPresentationComlink.displayName = 'PresentationComlink'\n\nexport default PresentationComlink\n"],"mappings":";;;;;;AAaA,SAAS,oBAAoB,OAKA;CAC3B,MAAM,EAAC,WAAW,SAAS,kBAAkB,yBAAwB;CACrE,MAAM,SAAS,WAAW;AAE1B,iBAAgB;AACd,yBAAuB,WAAW,QAAQ;IACzC,CAAC,SAAS,UAAU,CAAC;CAExB,MAAM,0BAA0B,gBAC7B,aAAgC,WAAwB;AACvD,MAAI,oBAAoB,gBAAgB,qBACtC,sBAAqB,YAAY,CAC9B,WAAW;AACV,OAAI,OAAO,QAAS;AACpB,UAAO,SAAS;IAChB,CACD,OAAO,WAAW,QAAQ,MAAM,gDAAgD,OAAO,CAAC;GAGhG;AAED,iBAAgB;EACd,MAAM,UAAU,WACd;GACE,MAAM;GACN,WAAW;GACZ,EACD,mBAAuD,CAAC,QAAQ,EAC9D,QAAQ,2BAA0C,EACnD,CAAC,CACH;EAED,IAAI;AACJ,UAAQ,GAAG,uBAAuB,SAAS;AACzC,eAAY,OAAO;AACnB,gBAAa,IAAI,iBAAiB;AAClC,2BAAwB,KAAK,aAAa,WAAW,OAAO;IAC5D;EAEF,MAAM,OAAO,QAAQ,OAAO;AAC5B,aAAW,QAAQ;AACnB,eAAa;AACX,SAAM;;IAEP,EAAE,CAAC;AAEN,QAAO;;AAET,oBAAoB,cAAc"}

package/dist/SanityLive.js.map

@@ -1 +1 @@
-{"version":3,"file":"SanityLive.js","names":["defaultRevalidateSyncTags","revalidateSyncTags"],"sources":["../src/live/client-components/SanityLive.tsx"],"sourcesContent":["import {\n  createClient,\n  type ClientPerspective,\n  type InitializedClientConfig,\n  type LiveEvent,\n  type LiveEventGoAway,\n  type SyncTag,\n} from '@sanity/client'\nimport {isMaybePresentation, isMaybePreviewWindow} from '@sanity/presentation-comlink'\nimport {revalidateSyncTags as defaultRevalidateSyncTags} from 'next-sanity/live/server-actions'\nimport dynamic from 'next/dynamic'\nimport {useRouter} from 'next/navigation'\nimport {useEffect, useMemo, useRef, useState, useEffectEvent, startTransition} from 'react'\n\nimport {isCorsOriginError} from '#live/isCorsOriginError'\n\nimport {setEnvironment, setPerspective} from '../hooks/context'\n\nconst PresentationComlink = dynamic(() => import('./PresentationComlink'))\nconst RefreshOnFocus = dynamic(() => import('./RefreshOnFocus'))\nconst RefreshOnMount = dynamic(() => import('./RefreshOnMount'))\nconst RefreshOnInterval = dynamic(() => import('./RefreshOnInterval'))\nconst RefreshOnReconnect = dynamic(() => import('./RefreshOnReconnect'))\n\n/**\n * @public\n */\nexport interface SanityLiveProps extends Pick<\n  InitializedClientConfig,\n  | 'projectId'\n  | 'dataset'\n  | 'apiHost'\n  | 'apiVersion'\n  | 'useProjectHostname'\n  | 'token'\n  | 'requestTagPrefix'\n> {\n  // handleDraftModeAction: (secret: string) => Promise<void | string>\n  draftModeEnabled: boolean\n  draftModePerspective?: ClientPerspective\n  refreshOnMount?: boolean\n  refreshOnFocus?: boolean\n  refreshOnReconnect?: boolean\n  requestTag: string | undefined\n  /**\n   * Handle errors from the Live Events subscription.\n   * By default it's reported using `console.error`, you can override this prop to handle it in your own way.\n   */\n  onError?: (error: unknown) => void\n  intervalOnGoAway?: number | false\n  onGoAway?: (event: LiveEventGoAway, intervalOnGoAway: number | false) => void\n  revalidateSyncTags?: (tags: SyncTag[]) => Promise<void | 'refresh'>\n  /**\n   * Delays events until after a configured Sanity Function has processed them and called the callback endpoint.\n   * When omitted, events are delivered immediately.\n   *\n   * @remarks\n   * When set, any custom `revalidateSyncTags` will not be called — revalidation is handled by the Function instead.\n   */\n  waitFor?: 'function'\n}\n\nfunction handleError(error: unknown) {\n  if (isCorsOriginError(error)) {\n    console.warn(\n      `Sanity Live is unable to connect to the Sanity API as the current origin - ${window.origin} - is not in the list of allowed CORS origins for this Sanity Project.`,\n      error.addOriginUrl && `Add it here:`,\n      error.addOriginUrl?.toString(),\n    )\n  } else {\n    console.error(error)\n  }\n}\n\nfunction handleOnGoAway(event: LiveEventGoAway, intervalOnGoAway: number | false) {\n  if (intervalOnGoAway) {\n    console.warn(\n      'Sanity Live connection closed, switching to long polling set to a interval of',\n      intervalOnGoAway / 1000,\n      'seconds and the server gave this reason:',\n      event.reason,\n    )\n  } else {\n    console.error(\n      'Sanity Live connection closed, automatic revalidation is disabled, the server gave this reason:',\n      event.reason,\n    )\n  }\n}\n\nfunction SanityLive(props: SanityLiveProps): React.JSX.Element | null {\n  const {\n    projectId,\n    dataset,\n    apiHost,\n    apiVersion,\n    useProjectHostname,\n    token,\n    requestTagPrefix,\n    // handleDraftModeAction,\n    draftModeEnabled,\n    draftModePerspective,\n    refreshOnMount = false,\n    refreshOnFocus = draftModeEnabled\n      ? false\n      : typeof window === 'undefined'\n        ? true\n        : window.self === window.top,\n    refreshOnReconnect = true,\n    intervalOnGoAway = 30_000,\n    requestTag = 'next-loader.live',\n    onError = handleError,\n    onGoAway = handleOnGoAway,\n    revalidateSyncTags = defaultRevalidateSyncTags,\n    waitFor,\n  } = props\n\n  const client = useMemo(\n    () =>\n      createClient({\n        projectId,\n        dataset,\n        apiHost,\n        apiVersion,\n        useProjectHostname,\n        ignoreBrowserTokenWarning: true,\n        token,\n        useCdn: false,\n        requestTagPrefix,\n      }),\n    [apiHost, apiVersion, dataset, projectId, requestTagPrefix, token, useProjectHostname],\n  )\n  const [refreshOnInterval, setRefreshOnInterval] = useState<number | false>(false)\n\n  /**\n   * 1. Handle Live Events and call revalidateTag or router.refresh when needed\n   */\n  const router = useRouter()\n  const handleLiveEvent = useEffectEvent((event: LiveEvent) => {\n    if (process.env.NODE_ENV !== 'production' && event.type === 'welcome') {\n      // oxlint-disable-next-line no-console\n      console.info(\n        'Sanity is live with',\n        token\n          ? 'automatic revalidation for draft content changes as well as published content'\n          : draftModeEnabled\n            ? 'automatic revalidation for only published content. Provide a `browserToken` to `defineLive` to support draft content outside of Presentation Tool.'\n            : 'automatic revalidation of published content',\n      )\n      // Disable long polling when welcome event is received, this is a no-op if long polling is already disabled\n      startTransition(() => setRefreshOnInterval(false))\n    } else if (event.type === 'message') {\n      if (waitFor === 'function') {\n        // Cache is already revalidated by the Sanity Function, just refresh the router\n        startTransition(() => router.refresh())\n      } else {\n        void revalidateSyncTags(event.tags).then((result) => {\n          if (result === 'refresh') startTransition(() => router.refresh())\n        })\n      }\n    } else if (event.type === 'restart' || event.type === 'reconnect') {\n      // Disable long polling when restart/reconnect event is received, this is a no-op if long polling is already disabled\n      startTransition(() => setRefreshOnInterval(false))\n      // @TODO add support for `onRestart` and `onReconnect` events so this can be customized\n      startTransition(() => router.refresh())\n    } else if (event.type === 'goaway') {\n      onGoAway(event, intervalOnGoAway)\n      startTransition(() => setRefreshOnInterval(intervalOnGoAway))\n    }\n  })\n  useEffect(() => {\n    const subscription = client.live\n      .events({includeDrafts: !!token, tag: requestTag, waitFor})\n      .subscribe({\n        next: handleLiveEvent,\n        error: (err: unknown) => {\n          // console.error('What?', err)\n          onError(err)\n        },\n      })\n    return () => subscription.unsubscribe()\n  }, [client.live, onError, requestTag, token, waitFor])\n\n  /**\n   * 2. Notify what perspective we're in, when in Draft Mode\n   */\n  useEffect(() => {\n    if (draftModeEnabled && draftModePerspective) {\n      setPerspective(draftModePerspective)\n    } else {\n      setPerspective('unknown')\n    }\n  }, [draftModeEnabled, draftModePerspective])\n\n  const [loadComlink, setLoadComlink] = useState(false)\n  /**\n   * 3. Notify what environment we're in, when in Draft Mode\n   */\n  useEffect(() => {\n    // If we might be in Presentation Tool, then skip detecting here as it's handled later\n    if (isMaybePresentation()) return\n\n    // If we're definitely not in Presentation Tool, then we can set the environment as stand-alone live preview\n    // if we have both a browser token, and draft mode is enabled\n    if (draftModeEnabled && token) {\n      setEnvironment('live')\n      return\n    }\n    // If we're in draft mode, but don't have a browser token, then we're in static mode\n    // which means that published content is still live, but draft changes likely need manual refresh\n    if (draftModeEnabled) {\n      setEnvironment('static')\n      return\n    }\n\n    // Fallback to `unknown` otherwise, as we simply don't know how it's setup\n    setEnvironment('unknown')\n    return\n  }, [draftModeEnabled, token])\n\n  /**\n   * 4. If Presentation Tool is detected, load up the comlink and integrate with it\n   */\n  useEffect(() => {\n    if (!isMaybePresentation()) return\n    const controller = new AbortController()\n    // Wait for a while to see if Presentation Tool is detected, before assuming the env to be stand-alone live preview\n    const timeout = setTimeout(() => setEnvironment('live'), 3_000)\n    window.addEventListener(\n      'message',\n      ({data}: MessageEvent<unknown>) => {\n        if (\n          data &&\n          typeof data === 'object' &&\n          'domain' in data &&\n          data.domain === 'sanity/channels' &&\n          'from' in data &&\n          data.from === 'presentation'\n        ) {\n          clearTimeout(timeout)\n          setEnvironment(isMaybePreviewWindow() ? 'presentation-window' : 'presentation-iframe')\n          setLoadComlink(true)\n          controller.abort()\n        }\n      },\n      {signal: controller.signal},\n    )\n    return () => {\n      clearTimeout(timeout)\n      controller.abort()\n    }\n  }, [])\n\n  /**\n   * 5. Warn if draft mode is being disabled\n   * @TODO move logic into PresentationComlink, or maybe VisualEditing?\n   */\n  const draftModeEnabledWarnRef = useRef<ReturnType<typeof setTimeout> | undefined>(undefined)\n  useEffect(() => {\n    if (!draftModeEnabled) return\n    clearTimeout(draftModeEnabledWarnRef.current)\n    return () => {\n      draftModeEnabledWarnRef.current = setTimeout(() => {\n        console.warn('Sanity Live: Draft mode was enabled, but is now being disabled')\n      })\n    }\n  }, [draftModeEnabled])\n\n  return (\n    <>\n      {draftModeEnabled && loadComlink && (\n        <PresentationComlink\n          projectId={projectId!}\n          dataset={dataset!}\n          // handleDraftModeAction={handleDraftModeAction}\n          draftModeEnabled={draftModeEnabled}\n          draftModePerspective={draftModePerspective!}\n        />\n      )}\n      {!draftModeEnabled && refreshOnMount && <RefreshOnMount />}\n      {refreshOnInterval && Number.isFinite(refreshOnInterval) && refreshOnInterval > 0 && (\n        <RefreshOnInterval interval={refreshOnInterval} />\n      )}\n      {!draftModeEnabled && refreshOnFocus && <RefreshOnFocus />}\n      {!draftModeEnabled && refreshOnReconnect && <RefreshOnReconnect />}\n    </>\n  )\n}\n\nSanityLive.displayName = 'SanityLiveClientComponent'\n\nexport default SanityLive\n"],"mappings":"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"}
+{"version":3,"file":"SanityLive.js","names":["defaultRevalidateSyncTags","revalidateSyncTags"],"sources":["../src/live/client-components/SanityLive.tsx"],"sourcesContent":["import {\n  createClient,\n  type ClientPerspective,\n  type InitializedClientConfig,\n  type LiveEvent,\n  type LiveEventGoAway,\n  type SyncTag,\n} from '@sanity/client'\nimport {isMaybePresentation, isMaybePreviewWindow} from '@sanity/presentation-comlink'\nimport {revalidateSyncTags as defaultRevalidateSyncTags} from 'next-sanity/live/server-actions'\nimport dynamic from 'next/dynamic'\nimport {useRouter} from 'next/navigation'\nimport {useEffect, useMemo, useRef, useState, useEffectEvent, startTransition} from 'react'\n\nimport {isCorsOriginError} from '#live/isCorsOriginError'\n\nimport {setEnvironment, setPerspective} from '../hooks/context'\n\nconst PresentationComlink = dynamic(() => import('./PresentationComlink'))\nconst RefreshOnFocus = dynamic(() => import('./RefreshOnFocus'))\nconst RefreshOnMount = dynamic(() => import('./RefreshOnMount'))\nconst RefreshOnInterval = dynamic(() => import('./RefreshOnInterval'))\nconst RefreshOnReconnect = dynamic(() => import('./RefreshOnReconnect'))\n\n/**\n * @public\n */\nexport interface SanityLiveProps extends Pick<\n  InitializedClientConfig,\n  | 'projectId'\n  | 'dataset'\n  | 'apiHost'\n  | 'apiVersion'\n  | 'useProjectHostname'\n  | 'token'\n  | 'requestTagPrefix'\n> {\n  draftModeEnabled: boolean\n  draftModePerspective?: ClientPerspective\n  refreshOnMount?: boolean\n  refreshOnFocus?: boolean\n  refreshOnReconnect?: boolean\n  requestTag: string | undefined\n  onError?: (error: unknown) => void\n  intervalOnGoAway?: number | false\n  onGoAway?: (event: LiveEventGoAway, intervalOnGoAway: number | false) => void\n  revalidateSyncTags?: (tags: SyncTag[]) => Promise<void | 'refresh'>\n  waitFor?: 'function'\n}\n\nfunction handleError(error: unknown) {\n  if (isCorsOriginError(error)) {\n    console.warn(\n      `Sanity Live is unable to connect to the Sanity API as the current origin - ${window.origin} - is not in the list of allowed CORS origins for this Sanity Project.`,\n      error.addOriginUrl && `Add it here:`,\n      error.addOriginUrl?.toString(),\n    )\n  } else {\n    console.error(error)\n  }\n}\n\nfunction handleOnGoAway(event: LiveEventGoAway, intervalOnGoAway: number | false) {\n  if (intervalOnGoAway) {\n    console.warn(\n      'Sanity Live connection closed, switching to long polling set to a interval of',\n      intervalOnGoAway / 1000,\n      'seconds and the server gave this reason:',\n      event.reason,\n    )\n  } else {\n    console.error(\n      'Sanity Live connection closed, automatic revalidation is disabled, the server gave this reason:',\n      event.reason,\n    )\n  }\n}\n\nfunction SanityLive(props: SanityLiveProps): React.JSX.Element | null {\n  const {\n    projectId,\n    dataset,\n    apiHost,\n    apiVersion,\n    useProjectHostname,\n    token,\n    requestTagPrefix,\n    draftModeEnabled,\n    draftModePerspective,\n    refreshOnMount = false,\n    refreshOnFocus = draftModeEnabled\n      ? false\n      : typeof window === 'undefined'\n        ? true\n        : window.self === window.top,\n    refreshOnReconnect = true,\n    intervalOnGoAway = 30_000,\n    requestTag = 'next-loader.live',\n    onError = handleError,\n    onGoAway = handleOnGoAway,\n    revalidateSyncTags = defaultRevalidateSyncTags,\n    waitFor,\n  } = props\n\n  const client = useMemo(\n    () =>\n      createClient({\n        projectId,\n        dataset,\n        apiHost,\n        apiVersion,\n        useProjectHostname,\n        ignoreBrowserTokenWarning: true,\n        token,\n        useCdn: false,\n        requestTagPrefix,\n      }),\n    [apiHost, apiVersion, dataset, projectId, requestTagPrefix, token, useProjectHostname],\n  )\n  const [refreshOnInterval, setRefreshOnInterval] = useState<number | false>(false)\n\n  /**\n   * 1. Handle Live Events and call revalidateTag or router.refresh when needed\n   */\n  const router = useRouter()\n  const handleLiveEvent = useEffectEvent((event: LiveEvent) => {\n    if (process.env.NODE_ENV !== 'production' && event.type === 'welcome') {\n      // oxlint-disable-next-line no-console\n      console.info(\n        'Sanity is live with',\n        token\n          ? 'automatic revalidation for draft content changes as well as published content'\n          : draftModeEnabled\n            ? 'automatic revalidation for only published content. Provide a `browserToken` to `defineLive` to support draft content outside of Presentation Tool.'\n            : 'automatic revalidation of published content',\n      )\n      // Disable long polling when welcome event is received, this is a no-op if long polling is already disabled\n      startTransition(() => setRefreshOnInterval(false))\n    } else if (event.type === 'message') {\n      if (waitFor === 'function') {\n        // Cache is already revalidated by the Sanity Function, just refresh the router\n        startTransition(() => router.refresh())\n      } else {\n        void revalidateSyncTags(event.tags).then((result) => {\n          if (result === 'refresh') startTransition(() => router.refresh())\n        })\n      }\n    } else if (event.type === 'restart' || event.type === 'reconnect') {\n      // Disable long polling when restart/reconnect event is received, this is a no-op if long polling is already disabled\n      startTransition(() => setRefreshOnInterval(false))\n      // @TODO add support for `onRestart` and `onReconnect` events so this can be customized\n      startTransition(() => router.refresh())\n    } else if (event.type === 'goaway') {\n      onGoAway(event, intervalOnGoAway)\n      startTransition(() => setRefreshOnInterval(intervalOnGoAway))\n    }\n  })\n  useEffect(() => {\n    const subscription = client.live\n      .events({includeDrafts: !!token, tag: requestTag, waitFor})\n      .subscribe({\n        next: handleLiveEvent,\n        error: (err: unknown) => {\n          // console.error('What?', err)\n          onError(err)\n        },\n      })\n    return () => subscription.unsubscribe()\n  }, [client.live, onError, requestTag, token, waitFor])\n\n  /**\n   * 2. Notify what perspective we're in, when in Draft Mode\n   */\n  useEffect(() => {\n    if (draftModeEnabled && draftModePerspective) {\n      setPerspective(draftModePerspective)\n    } else {\n      setPerspective('unknown')\n    }\n  }, [draftModeEnabled, draftModePerspective])\n\n  const [loadComlink, setLoadComlink] = useState(false)\n  /**\n   * 3. Notify what environment we're in, when in Draft Mode\n   */\n  useEffect(() => {\n    // If we might be in Presentation Tool, then skip detecting here as it's handled later\n    if (isMaybePresentation()) return\n\n    // If we're definitely not in Presentation Tool, then we can set the environment as stand-alone live preview\n    // if we have both a browser token, and draft mode is enabled\n    if (draftModeEnabled && token) {\n      setEnvironment('live')\n      return\n    }\n    // If we're in draft mode, but don't have a browser token, then we're in static mode\n    // which means that published content is still live, but draft changes likely need manual refresh\n    if (draftModeEnabled) {\n      setEnvironment('static')\n      return\n    }\n\n    // Fallback to `unknown` otherwise, as we simply don't know how it's setup\n    setEnvironment('unknown')\n    return\n  }, [draftModeEnabled, token])\n\n  /**\n   * 4. If Presentation Tool is detected, load up the comlink and integrate with it\n   */\n  useEffect(() => {\n    if (!isMaybePresentation()) return\n    const controller = new AbortController()\n    // Wait for a while to see if Presentation Tool is detected, before assuming the env to be stand-alone live preview\n    const timeout = setTimeout(() => setEnvironment('live'), 3_000)\n    window.addEventListener(\n      'message',\n      ({data}: MessageEvent<unknown>) => {\n        if (\n          data &&\n          typeof data === 'object' &&\n          'domain' in data &&\n          data.domain === 'sanity/channels' &&\n          'from' in data &&\n          data.from === 'presentation'\n        ) {\n          clearTimeout(timeout)\n          setEnvironment(isMaybePreviewWindow() ? 'presentation-window' : 'presentation-iframe')\n          setLoadComlink(true)\n          controller.abort()\n        }\n      },\n      {signal: controller.signal},\n    )\n    return () => {\n      clearTimeout(timeout)\n      controller.abort()\n    }\n  }, [])\n\n  /**\n   * 5. Warn if draft mode is being disabled\n   * @TODO move logic into PresentationComlink, or maybe VisualEditing?\n   */\n  const draftModeEnabledWarnRef = useRef<ReturnType<typeof setTimeout> | undefined>(undefined)\n  useEffect(() => {\n    if (!draftModeEnabled) return\n    clearTimeout(draftModeEnabledWarnRef.current)\n    return () => {\n      draftModeEnabledWarnRef.current = setTimeout(() => {\n        console.warn('Sanity Live: Draft mode was enabled, but is now being disabled')\n      })\n    }\n  }, [draftModeEnabled])\n\n  return (\n    <>\n      {draftModeEnabled && loadComlink && (\n        <PresentationComlink\n          projectId={projectId!}\n          dataset={dataset!}\n          draftModeEnabled={draftModeEnabled}\n          draftModePerspective={draftModePerspective!}\n        />\n      )}\n      {!draftModeEnabled && refreshOnMount && <RefreshOnMount />}\n      {refreshOnInterval && Number.isFinite(refreshOnInterval) && refreshOnInterval > 0 && (\n        <RefreshOnInterval interval={refreshOnInterval} />\n      )}\n      {!draftModeEnabled && refreshOnFocus && <RefreshOnFocus />}\n      {!draftModeEnabled && refreshOnReconnect && <RefreshOnReconnect />}\n    </>\n  )\n}\n\nSanityLive.displayName = 'SanityLiveClientComponent'\n\nexport default SanityLive\n"],"mappings":"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"}

package/dist/isCorsOriginError.js.map

@@ -1 +1 @@
-{"version":3,"file":"isCorsOriginError.js","names":[],"sources":["../src/live/shared/isCorsOriginError.ts"],"sourcesContent":["import type {CorsOriginError} from '@sanity/client'\n\n/** @public */\nexport function isCorsOriginError(error: unknown): error is CorsOriginError {\n  return error instanceof Error && error.name === 'CorsOriginError'\n}\n\nexport type {CorsOriginError}\n"],"mappings":";AAGA,SAAgB,kBAAkB,OAA0C;AAC1E,QAAO,iBAAiB,SAAS,MAAM,SAAS"}
+{"version":3,"file":"isCorsOriginError.js","names":[],"sources":["../src/live/shared/isCorsOriginError.ts"],"sourcesContent":["import type {CorsOriginError} from '@sanity/client'\n\n/** @public */\nexport function isCorsOriginError(error: unknown): error is CorsOriginError {\n  return error instanceof Error && error.name === 'CorsOriginError'\n}\n"],"mappings":";AAGA,SAAgB,kBAAkB,OAA0C;AAC1E,QAAO,iBAAiB,SAAS,MAAM,SAAS"}

package/dist/live/client-components/index.d.ts

@@ -9,21 +9,10 @@ interface SanityLiveProps extends Pick<InitializedClientConfig, "projectId" | "d
   refreshOnFocus?: boolean;
   refreshOnReconnect?: boolean;
   requestTag: string | undefined;
-  /**
-  * Handle errors from the Live Events subscription.
-  * By default it's reported using `console.error`, you can override this prop to handle it in your own way.
-  */
   onError?: (error: unknown) => void;
   intervalOnGoAway?: number | false;
   onGoAway?: (event: LiveEventGoAway, intervalOnGoAway: number | false) => void;
   revalidateSyncTags?: (tags: SyncTag[]) => Promise<void | "refresh">;
-  /**
-  * Delays events until after a configured Sanity Function has processed them and called the callback endpoint.
-  * When omitted, events are delivered immediately.
-  *
-  * @remarks
-  * When set, any custom `revalidateSyncTags` will not be called — revalidation is handled by the Function instead.
-  */
   waitFor?: "function";
 }
 /**

package/dist/live/client-components/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","names":[],"sources":["../../../src/live/client-components/SanityLive.tsx","../../../src/live/client-components/index.ts"],"mappings":";;AA2BA;;UAAiB,eAAA,SAAwB,IAAA,CACvC,uBAAA;EAUA,gBAAA;EACA,oBAAA,GAAuB,iBAAA;EACvB,cAAA;EACA,cAAA;EACA,kBAAA;EACA,UAAA;;;;;EAKA,OAAA,IAAW,KAAA;EACX,gBAAA;EACA,QAAA,IAAY,KAAA,EAAO,eAAA,EAAiB,gBAAA;EACpC,kBAAA,IAAsB,IAAA,EAAM,OAAA,OAAc,OAAA;;;;;;;;EAQ1C,OAAA;AAAA;;AAhCF;;cCnBa,UAAA,EAAY,KAAA,CAAM,aAAA,CAAc,eAAA"}
+{"version":3,"file":"index.d.ts","names":[],"sources":["../../../src/live/client-components/SanityLive.tsx","../../../src/live/client-components/index.ts"],"mappings":";;AA2BA;;UAAiB,eAAA,SAAwB,IAAA,CACvC,uBAAA;EASA,gBAAA;EACA,oBAAA,GAAuB,iBAAA;EACvB,cAAA;EACA,cAAA;EACA,kBAAA;EACA,UAAA;EACA,OAAA,IAAW,KAAA;EACX,gBAAA;EACA,QAAA,IAAY,KAAA,EAAO,eAAA,EAAiB,gBAAA;EACpC,kBAAA,IAAsB,IAAA,EAAM,OAAA,OAAc,OAAA;EAC1C,OAAA;AAAA;;AApBF;;cCnBa,UAAA,EAAY,KAAA,CAAM,aAAA,CAAc,eAAA"}

package/dist/live/conditions/default/index.d.ts

@@ -1,11 +1,89 @@
 import { t as isCorsOriginError } from "../../../isCorsOriginError.js";
-import { n as DefinedSanityFetchType, r as DefinedSanityLiveProps, t as DefineSanityLiveOptions } from "../../../defineLive.js";
+import { i as LivePerspective, n as DefinedFetchType, r as DefinedLiveProps, t as DefineLiveOptions } from "../../../types.js";
 /**
+* Set up Sanity Live. `defineLive` returns `sanityFetch` and `<SanityLive />`,
+* which connect your Sanity client to the Live Content API so pages can serve
+* cached content and update in response to fine-grained content changes.
+*
+* @see [Live Content API](https://www.sanity.io/docs/content-lake/live-content-api)
+* @see [Sanity Live](https://www.sanity.io/live)
+*
+* @example
+* ```tsx
+* import {createClient} from 'next-sanity'
+* import {defineLive} from 'next-sanity/live'
+*
+* const client = createClient({
+*   projectId: process.env.NEXT_PUBLIC_SANITY_PROJECT_ID,
+*   dataset: process.env.NEXT_PUBLIC_SANITY_DATASET,
+*   useCdn: true,
+*   perspective: 'published',
+* })
+* const token = process.env.SANITY_API_READ_TOKEN
+*
+* export const {sanityFetch, SanityLive} = defineLive({
+*   client,
+*   browserToken: token,
+*   serverToken: token,
+* })
+* ```
+*
+* @example
+* ```tsx
+* // app/layout.tsx
+* import {SanityLive} from '@/sanity/live'
+*
+* export default function RootLayout({children}: {children: React.ReactNode}) {
+*   return (
+*     <html lang="en">
+*       <body>
+*         {children}
+*         <SanityLive />
+*       </body>
+*     </html>
+*   )
+* }
+* ```
+*
+* @example
+* ```tsx
+* // app/[slug]/page.tsx
+* import {defineQuery} from 'next-sanity'
+* import {sanityFetch} from '@/sanity/live'
+*
+* const POSTS_SLUGS_QUERY = defineQuery(`
+*   *[_type == "post" && slug.current]{"slug": slug.current}
+* `)
+* const POST_QUERY = defineQuery(`
+*   *[_type == "post" && slug.current == $slug][0]
+* `)
+*
+* export async function generateStaticParams() {
+*   const {data} = await sanityFetch({
+*     query: POSTS_SLUGS_QUERY,
+*     perspective: 'published',
+*     stega: false,
+*   })
+*
+*   return data
+* }
+*
+* export default async function Page(props: PageProps<'/[slug]'>) {
+*   const {slug} = await props.params
+*   const {data} = await sanityFetch({
+*     query: POST_QUERY,
+*     params: {slug},
+*   })
+*
+*   return <pre>{JSON.stringify(data, null, 2)}</pre>
+* }
+* ```
+*
 * @public
 */
-declare function defineLive(_config: DefineSanityLiveOptions): {
-  sanityFetch: DefinedSanityFetchType;
-  SanityLive: React.ComponentType<DefinedSanityLiveProps>;
+declare function defineLive(_config: DefineLiveOptions): {
+  sanityFetch: DefinedFetchType;
+  SanityLive: React.ComponentType<DefinedLiveProps>;
 };
-export { type DefineSanityLiveOptions, type DefinedSanityFetchType, type DefinedSanityLiveProps, defineLive, isCorsOriginError };
+export { type DefineLiveOptions as DefineSanityLiveOptions, type DefinedFetchType as DefinedSanityFetchType, type DefinedLiveProps as DefinedSanityLiveProps, type LivePerspective, defineLive, isCorsOriginError };
 //# sourceMappingURL=index.d.ts.map

package/dist/live/conditions/default/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","names":[],"sources":["../../../../src/live/conditions/default/index.ts"],"mappings":";;;;AASA;iBAAgB,UAAA,CAAW,OAAA,EAAS,uBAAA;EAClC,WAAA,EAAa,sBAAA;EACb,UAAA,EAAY,KAAA,CAAM,aAAA,CAAc,sBAAA;AAAA"}
+{"version":3,"file":"index.d.ts","names":[],"sources":["../../../../src/live/conditions/default/index.ts"],"mappings":";;;;AAmFA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAAgB,UAAA,CAAW,OAAA,EAAS,iBAAA;EAClC,WAAA,EAAa,gBAAA;EACb,UAAA,EAAY,KAAA,CAAM,aAAA,CAAc,gBAAA;AAAA"}

package/dist/live/conditions/default/index.js

@@ -1,5 +1,83 @@
 import { t as isCorsOriginError } from "../../../isCorsOriginError.js";
 /**
+* Set up Sanity Live. `defineLive` returns `sanityFetch` and `<SanityLive />`,
+* which connect your Sanity client to the Live Content API so pages can serve
+* cached content and update in response to fine-grained content changes.
+*
+* @see [Live Content API](https://www.sanity.io/docs/content-lake/live-content-api)
+* @see [Sanity Live](https://www.sanity.io/live)
+*
+* @example
+* ```tsx
+* import {createClient} from 'next-sanity'
+* import {defineLive} from 'next-sanity/live'
+*
+* const client = createClient({
+*   projectId: process.env.NEXT_PUBLIC_SANITY_PROJECT_ID,
+*   dataset: process.env.NEXT_PUBLIC_SANITY_DATASET,
+*   useCdn: true,
+*   perspective: 'published',
+* })
+* const token = process.env.SANITY_API_READ_TOKEN
+*
+* export const {sanityFetch, SanityLive} = defineLive({
+*   client,
+*   browserToken: token,
+*   serverToken: token,
+* })
+* ```
+*
+* @example
+* ```tsx
+* // app/layout.tsx
+* import {SanityLive} from '@/sanity/live'
+*
+* export default function RootLayout({children}: {children: React.ReactNode}) {
+*   return (
+*     <html lang="en">
+*       <body>
+*         {children}
+*         <SanityLive />
+*       </body>
+*     </html>
+*   )
+* }
+* ```
+*
+* @example
+* ```tsx
+* // app/[slug]/page.tsx
+* import {defineQuery} from 'next-sanity'
+* import {sanityFetch} from '@/sanity/live'
+*
+* const POSTS_SLUGS_QUERY = defineQuery(`
+*   *[_type == "post" && slug.current]{"slug": slug.current}
+* `)
+* const POST_QUERY = defineQuery(`
+*   *[_type == "post" && slug.current == $slug][0]
+* `)
+*
+* export async function generateStaticParams() {
+*   const {data} = await sanityFetch({
+*     query: POSTS_SLUGS_QUERY,
+*     perspective: 'published',
+*     stega: false,
+*   })
+*
+*   return data
+* }
+*
+* export default async function Page(props: PageProps<'/[slug]'>) {
+*   const {slug} = await props.params
+*   const {data} = await sanityFetch({
+*     query: POST_QUERY,
+*     params: {slug},
+*   })
+*
+*   return <pre>{JSON.stringify(data, null, 2)}</pre>
+* }
+* ```
+*
 * @public
 */
 function defineLive(_config) {

package/dist/live/conditions/default/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","names":[],"sources":["../../../../src/live/conditions/default/index.ts"],"sourcesContent":["import type {\n  DefineSanityLiveOptions,\n  DefinedSanityFetchType,\n  DefinedSanityLiveProps,\n} from '../react-server/defineLive'\n\n/**\n * @public\n */\nexport function defineLive(_config: DefineSanityLiveOptions): {\n  sanityFetch: DefinedSanityFetchType\n  SanityLive: React.ComponentType<DefinedSanityLiveProps>\n} {\n  throw new Error('defineLive can only be used in React Server Components')\n}\n\n/**\n * @public\n */\nexport type {DefineSanityLiveOptions, DefinedSanityFetchType, DefinedSanityLiveProps}\n\nexport {isCorsOriginError} from '#live/isCorsOriginError'\n"],"mappings":";;;;AASA,SAAgB,WAAW,SAGzB;AACA,OAAM,IAAI,MAAM,yDAAyD"}
+{"version":3,"file":"index.js","names":[],"sources":["../../../../src/live/conditions/default/index.ts"],"sourcesContent":["import type {DefinedFetchType, DefinedLiveProps, DefineLiveOptions} from '#live/types'\n\n/**\n * Set up Sanity Live. `defineLive` returns `sanityFetch` and `<SanityLive />`,\n * which connect your Sanity client to the Live Content API so pages can serve\n * cached content and update in response to fine-grained content changes.\n *\n * @see [Live Content API](https://www.sanity.io/docs/content-lake/live-content-api)\n * @see [Sanity Live](https://www.sanity.io/live)\n *\n * @example\n * ```tsx\n * import {createClient} from 'next-sanity'\n * import {defineLive} from 'next-sanity/live'\n *\n * const client = createClient({\n *   projectId: process.env.NEXT_PUBLIC_SANITY_PROJECT_ID,\n *   dataset: process.env.NEXT_PUBLIC_SANITY_DATASET,\n *   useCdn: true,\n *   perspective: 'published',\n * })\n * const token = process.env.SANITY_API_READ_TOKEN\n *\n * export const {sanityFetch, SanityLive} = defineLive({\n *   client,\n *   browserToken: token,\n *   serverToken: token,\n * })\n * ```\n *\n * @example\n * ```tsx\n * // app/layout.tsx\n * import {SanityLive} from '@/sanity/live'\n *\n * export default function RootLayout({children}: {children: React.ReactNode}) {\n *   return (\n *     <html lang=\"en\">\n *       <body>\n *         {children}\n *         <SanityLive />\n *       </body>\n *     </html>\n *   )\n * }\n * ```\n *\n * @example\n * ```tsx\n * // app/[slug]/page.tsx\n * import {defineQuery} from 'next-sanity'\n * import {sanityFetch} from '@/sanity/live'\n *\n * const POSTS_SLUGS_QUERY = defineQuery(`\n *   *[_type == \"post\" && slug.current]{\"slug\": slug.current}\n * `)\n * const POST_QUERY = defineQuery(`\n *   *[_type == \"post\" && slug.current == $slug][0]\n * `)\n *\n * export async function generateStaticParams() {\n *   const {data} = await sanityFetch({\n *     query: POSTS_SLUGS_QUERY,\n *     perspective: 'published',\n *     stega: false,\n *   })\n *\n *   return data\n * }\n *\n * export default async function Page(props: PageProps<'/[slug]'>) {\n *   const {slug} = await props.params\n *   const {data} = await sanityFetch({\n *     query: POST_QUERY,\n *     params: {slug},\n *   })\n *\n *   return <pre>{JSON.stringify(data, null, 2)}</pre>\n * }\n * ```\n *\n * @public\n */\nexport function defineLive(_config: DefineLiveOptions): {\n  sanityFetch: DefinedFetchType\n  SanityLive: React.ComponentType<DefinedLiveProps>\n} {\n  throw new Error('defineLive can only be used in React Server Components')\n}\n\nexport type {\n  DefinedFetchType as DefinedSanityFetchType,\n  DefinedLiveProps as DefinedSanityLiveProps,\n  DefineLiveOptions as DefineSanityLiveOptions,\n  LivePerspective,\n} from '#live/types'\n\nexport {isCorsOriginError} from '#live/isCorsOriginError'\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAmFA,SAAgB,WAAW,SAGzB;AACA,OAAM,IAAI,MAAM,yDAAyD"}

package/dist/live/conditions/next-js/index.d.ts

@@ -1,11 +1,89 @@
 import { t as isCorsOriginError } from "../../../isCorsOriginError.js";
-import { n as DefinedSanityFetchType, r as DefinedSanityLiveProps, t as DefineSanityLiveOptions } from "../../../defineLive.js";
+import { i as LivePerspective, n as DefinedFetchType, r as DefinedLiveProps, t as DefineLiveOptions } from "../../../types.js";
 /**
+* Set up Sanity Live. `defineLive` returns `sanityFetch` and `<SanityLive />`,
+* which connect your Sanity client to the Live Content API so pages can serve
+* cached content and update in response to fine-grained content changes.
+*
+* @see [Live Content API](https://www.sanity.io/docs/content-lake/live-content-api)
+* @see [Sanity Live](https://www.sanity.io/live)
+*
+* @example
+* ```tsx
+* import {createClient} from 'next-sanity'
+* import {defineLive} from 'next-sanity/live'
+*
+* const client = createClient({
+*   projectId: process.env.NEXT_PUBLIC_SANITY_PROJECT_ID,
+*   dataset: process.env.NEXT_PUBLIC_SANITY_DATASET,
+*   useCdn: true,
+*   perspective: 'published',
+* })
+* const token = process.env.SANITY_API_READ_TOKEN
+*
+* export const {sanityFetch, SanityLive} = defineLive({
+*   client,
+*   browserToken: token,
+*   serverToken: token,
+* })
+* ```
+*
+* @example
+* ```tsx
+* // app/layout.tsx
+* import {SanityLive} from '@/sanity/live'
+*
+* export default function RootLayout({children}: {children: React.ReactNode}) {
+*   return (
+*     <html lang="en">
+*       <body>
+*         {children}
+*         <SanityLive />
+*       </body>
+*     </html>
+*   )
+* }
+* ```
+*
+* @example
+* ```tsx
+* // app/[slug]/page.tsx
+* import {defineQuery} from 'next-sanity'
+* import {sanityFetch} from '@/sanity/live'
+*
+* const POSTS_SLUGS_QUERY = defineQuery(`
+*   *[_type == "post" && slug.current]{"slug": slug.current}
+* `)
+* const POST_QUERY = defineQuery(`
+*   *[_type == "post" && slug.current == $slug][0]
+* `)
+*
+* export async function generateStaticParams() {
+*   const {data} = await sanityFetch({
+*     query: POSTS_SLUGS_QUERY,
+*     perspective: 'published',
+*     stega: false,
+*   })
+*
+*   return data
+* }
+*
+* export default async function Page(props: PageProps<'/[slug]'>) {
+*   const {slug} = await props.params
+*   const {data} = await sanityFetch({
+*     query: POST_QUERY,
+*     params: {slug},
+*   })
+*
+*   return <pre>{JSON.stringify(data, null, 2)}</pre>
+* }
+* ```
+*
 * @public
 */
-declare function defineLive(_config: DefineSanityLiveOptions): {
-  sanityFetch: DefinedSanityFetchType;
-  SanityLive: React.ComponentType<DefinedSanityLiveProps>;
+declare function defineLive(_config: DefineLiveOptions): {
+  sanityFetch: DefinedFetchType;
+  SanityLive: React.ComponentType<DefinedLiveProps>;
 };
-export { type DefineSanityLiveOptions, type DefinedSanityFetchType, type DefinedSanityLiveProps, defineLive, isCorsOriginError };
+export { type DefineLiveOptions as DefineSanityLiveOptions, type DefinedFetchType as DefinedSanityFetchType, type DefinedLiveProps as DefinedSanityLiveProps, type LivePerspective, defineLive, isCorsOriginError };
 //# sourceMappingURL=index.d.ts.map

package/dist/live/conditions/next-js/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","names":[],"sources":["../../../../src/live/conditions/next-js/index.ts"],"mappings":";;;;AASA;iBAAgB,UAAA,CAAW,OAAA,EAAS,uBAAA;EAClC,WAAA,EAAa,sBAAA;EACb,UAAA,EAAY,KAAA,CAAM,aAAA,CAAc,sBAAA;AAAA"}
+{"version":3,"file":"index.d.ts","names":[],"sources":["../../../../src/live/conditions/next-js/index.ts"],"mappings":";;;;AAmFA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAAgB,UAAA,CAAW,OAAA,EAAS,iBAAA;EAClC,WAAA,EAAa,gBAAA;EACb,UAAA,EAAY,KAAA,CAAM,aAAA,CAAc,gBAAA;AAAA"}

package/dist/live/conditions/next-js/index.js

@@ -1,5 +1,83 @@
 import { t as isCorsOriginError } from "../../../isCorsOriginError.js";
 /**
+* Set up Sanity Live. `defineLive` returns `sanityFetch` and `<SanityLive />`,
+* which connect your Sanity client to the Live Content API so pages can serve
+* cached content and update in response to fine-grained content changes.
+*
+* @see [Live Content API](https://www.sanity.io/docs/content-lake/live-content-api)
+* @see [Sanity Live](https://www.sanity.io/live)
+*
+* @example
+* ```tsx
+* import {createClient} from 'next-sanity'
+* import {defineLive} from 'next-sanity/live'
+*
+* const client = createClient({
+*   projectId: process.env.NEXT_PUBLIC_SANITY_PROJECT_ID,
+*   dataset: process.env.NEXT_PUBLIC_SANITY_DATASET,
+*   useCdn: true,
+*   perspective: 'published',
+* })
+* const token = process.env.SANITY_API_READ_TOKEN
+*
+* export const {sanityFetch, SanityLive} = defineLive({
+*   client,
+*   browserToken: token,
+*   serverToken: token,
+* })
+* ```
+*
+* @example
+* ```tsx
+* // app/layout.tsx
+* import {SanityLive} from '@/sanity/live'
+*
+* export default function RootLayout({children}: {children: React.ReactNode}) {
+*   return (
+*     <html lang="en">
+*       <body>
+*         {children}
+*         <SanityLive />
+*       </body>
+*     </html>
+*   )
+* }
+* ```
+*
+* @example
+* ```tsx
+* // app/[slug]/page.tsx
+* import {defineQuery} from 'next-sanity'
+* import {sanityFetch} from '@/sanity/live'
+*
+* const POSTS_SLUGS_QUERY = defineQuery(`
+*   *[_type == "post" && slug.current]{"slug": slug.current}
+* `)
+* const POST_QUERY = defineQuery(`
+*   *[_type == "post" && slug.current == $slug][0]
+* `)
+*
+* export async function generateStaticParams() {
+*   const {data} = await sanityFetch({
+*     query: POSTS_SLUGS_QUERY,
+*     perspective: 'published',
+*     stega: false,
+*   })
+*
+*   return data
+* }
+*
+* export default async function Page(props: PageProps<'/[slug]'>) {
+*   const {slug} = await props.params
+*   const {data} = await sanityFetch({
+*     query: POST_QUERY,
+*     params: {slug},
+*   })
+*
+*   return <pre>{JSON.stringify(data, null, 2)}</pre>
+* }
+* ```
+*
 * @public
 */
 function defineLive(_config) {

package/dist/live/conditions/next-js/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","names":[],"sources":["../../../../src/live/conditions/next-js/index.ts"],"sourcesContent":["import type {\n  DefineSanityLiveOptions,\n  DefinedSanityFetchType,\n  DefinedSanityLiveProps,\n} from '../react-server/defineLive'\n\n/**\n * @public\n */\nexport function defineLive(_config: DefineSanityLiveOptions): {\n  sanityFetch: DefinedSanityFetchType\n  SanityLive: React.ComponentType<DefinedSanityLiveProps>\n} {\n  throw new Error('defineLive does not yet support `cacheComponents: true`. Wait for the next major version of next-sanity, or use the prerelease with `pnpm install next-sanity@cache-components`')\n}\n\n/**\n * @public\n */\nexport type {DefineSanityLiveOptions, DefinedSanityFetchType, DefinedSanityLiveProps}\n\nexport {isCorsOriginError} from '#live/isCorsOriginError'\n"],"mappings":";;;;AASA,SAAgB,WAAW,SAGzB;AACA,OAAM,IAAI,MAAM,kLAAkL"}
+{"version":3,"file":"index.js","names":[],"sources":["../../../../src/live/conditions/next-js/index.ts"],"sourcesContent":["import type {DefinedFetchType, DefinedLiveProps, DefineLiveOptions} from '#live/types'\n\n/**\n * Set up Sanity Live. `defineLive` returns `sanityFetch` and `<SanityLive />`,\n * which connect your Sanity client to the Live Content API so pages can serve\n * cached content and update in response to fine-grained content changes.\n *\n * @see [Live Content API](https://www.sanity.io/docs/content-lake/live-content-api)\n * @see [Sanity Live](https://www.sanity.io/live)\n *\n * @example\n * ```tsx\n * import {createClient} from 'next-sanity'\n * import {defineLive} from 'next-sanity/live'\n *\n * const client = createClient({\n *   projectId: process.env.NEXT_PUBLIC_SANITY_PROJECT_ID,\n *   dataset: process.env.NEXT_PUBLIC_SANITY_DATASET,\n *   useCdn: true,\n *   perspective: 'published',\n * })\n * const token = process.env.SANITY_API_READ_TOKEN\n *\n * export const {sanityFetch, SanityLive} = defineLive({\n *   client,\n *   browserToken: token,\n *   serverToken: token,\n * })\n * ```\n *\n * @example\n * ```tsx\n * // app/layout.tsx\n * import {SanityLive} from '@/sanity/live'\n *\n * export default function RootLayout({children}: {children: React.ReactNode}) {\n *   return (\n *     <html lang=\"en\">\n *       <body>\n *         {children}\n *         <SanityLive />\n *       </body>\n *     </html>\n *   )\n * }\n * ```\n *\n * @example\n * ```tsx\n * // app/[slug]/page.tsx\n * import {defineQuery} from 'next-sanity'\n * import {sanityFetch} from '@/sanity/live'\n *\n * const POSTS_SLUGS_QUERY = defineQuery(`\n *   *[_type == \"post\" && slug.current]{\"slug\": slug.current}\n * `)\n * const POST_QUERY = defineQuery(`\n *   *[_type == \"post\" && slug.current == $slug][0]\n * `)\n *\n * export async function generateStaticParams() {\n *   const {data} = await sanityFetch({\n *     query: POSTS_SLUGS_QUERY,\n *     perspective: 'published',\n *     stega: false,\n *   })\n *\n *   return data\n * }\n *\n * export default async function Page(props: PageProps<'/[slug]'>) {\n *   const {slug} = await props.params\n *   const {data} = await sanityFetch({\n *     query: POST_QUERY,\n *     params: {slug},\n *   })\n *\n *   return <pre>{JSON.stringify(data, null, 2)}</pre>\n * }\n * ```\n *\n * @public\n */\nexport function defineLive(_config: DefineLiveOptions): {\n  sanityFetch: DefinedFetchType\n  SanityLive: React.ComponentType<DefinedLiveProps>\n} {\n  throw new Error(\n    'defineLive does not yet support `cacheComponents: true`. Wait for the next major version of next-sanity, or use the prerelease with `pnpm install next-sanity@cache-components`',\n  )\n}\n\nexport type {\n  DefinedFetchType as DefinedSanityFetchType,\n  DefinedLiveProps as DefinedSanityLiveProps,\n  DefineLiveOptions as DefineSanityLiveOptions,\n  LivePerspective,\n} from '#live/types'\n\nexport {isCorsOriginError} from '#live/isCorsOriginError'\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAmFA,SAAgB,WAAW,SAGzB;AACA,OAAM,IAAI,MACR,kLACD"}

package/dist/live/conditions/react-server/index.d.ts

@@ -1,3 +1,89 @@
 import { t as isCorsOriginError } from "../../../isCorsOriginError.js";
-import { i as defineLive, n as DefinedSanityFetchType, r as DefinedSanityLiveProps, t as DefineSanityLiveOptions } from "../../../defineLive.js";
-export { type DefineSanityLiveOptions, type DefinedSanityFetchType, type DefinedSanityLiveProps, defineLive, isCorsOriginError };
+import { i as LivePerspective, n as DefinedFetchType, r as DefinedLiveProps, t as DefineLiveOptions } from "../../../types.js";
+/**
+* Set up Sanity Live. `defineLive` returns `sanityFetch` and `<SanityLive />`,
+* which connect your Sanity client to the Live Content API so pages can serve
+* cached content and update in response to fine-grained content changes.
+*
+* @see [Live Content API](https://www.sanity.io/docs/content-lake/live-content-api)
+* @see [Sanity Live](https://www.sanity.io/live)
+*
+* @example
+* ```tsx
+* import {createClient} from 'next-sanity'
+* import {defineLive} from 'next-sanity/live'
+*
+* const client = createClient({
+*   projectId: process.env.NEXT_PUBLIC_SANITY_PROJECT_ID,
+*   dataset: process.env.NEXT_PUBLIC_SANITY_DATASET,
+*   useCdn: true,
+*   perspective: 'published',
+* })
+* const token = process.env.SANITY_API_READ_TOKEN
+*
+* export const {sanityFetch, SanityLive} = defineLive({
+*   client,
+*   browserToken: token,
+*   serverToken: token,
+* })
+* ```
+*
+* @example
+* ```tsx
+* // app/layout.tsx
+* import {SanityLive} from '@/sanity/live'
+*
+* export default function RootLayout({children}: {children: React.ReactNode}) {
+*   return (
+*     <html lang="en">
+*       <body>
+*         {children}
+*         <SanityLive />
+*       </body>
+*     </html>
+*   )
+* }
+* ```
+*
+* @example
+* ```tsx
+* // app/[slug]/page.tsx
+* import {defineQuery} from 'next-sanity'
+* import {sanityFetch} from '@/sanity/live'
+*
+* const POSTS_SLUGS_QUERY = defineQuery(`
+*   *[_type == "post" && slug.current]{"slug": slug.current}
+* `)
+* const POST_QUERY = defineQuery(`
+*   *[_type == "post" && slug.current == $slug][0]
+* `)
+*
+* export async function generateStaticParams() {
+*   const {data} = await sanityFetch({
+*     query: POSTS_SLUGS_QUERY,
+*     perspective: 'published',
+*     stega: false,
+*   })
+*
+*   return data
+* }
+*
+* export default async function Page(props: PageProps<'/[slug]'>) {
+*   const {slug} = await props.params
+*   const {data} = await sanityFetch({
+*     query: POST_QUERY,
+*     params: {slug},
+*   })
+*
+*   return <pre>{JSON.stringify(data, null, 2)}</pre>
+* }
+* ```
+*
+* @public
+*/
+declare function defineLive(config: DefineLiveOptions): {
+  sanityFetch: DefinedFetchType;
+  SanityLive: React.ComponentType<DefinedLiveProps>;
+};
+export { type DefineLiveOptions as DefineSanityLiveOptions, type DefinedFetchType as DefinedSanityFetchType, type DefinedLiveProps as DefinedSanityLiveProps, type LivePerspective, defineLive, isCorsOriginError };
+//# sourceMappingURL=index.d.ts.map

package/dist/live/conditions/react-server/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","names":[],"sources":["../../../../src/live/conditions/react-server/defineLive.tsx"],"mappings":";;;;AA2FA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAAgB,UAAA,CAAW,MAAA,EAAQ,iBAAA;EACjC,WAAA,EAAa,gBAAA;EACb,UAAA,EAAY,KAAA,CAAM,aAAA,CAAc,gBAAA;AAAA"}

package/dist/live/conditions/react-server/index.js

@@ -3,11 +3,88 @@ import { t as sanitizePerspective } from "../../../sanitizePerspective.js";
 import { perspectiveCookieName } from "@sanity/preview-url-secret/constants";
 import { cookies, draftMode } from "next/headers";
 import { jsx } from "react/jsx-runtime";
-import "@sanity/client";
 import { SanityLive } from "next-sanity/live/client-components";
 import { PHASE_PRODUCTION_BUILD } from "next/constants";
 import { preconnect } from "react-dom";
 /**
+* Set up Sanity Live. `defineLive` returns `sanityFetch` and `<SanityLive />`,
+* which connect your Sanity client to the Live Content API so pages can serve
+* cached content and update in response to fine-grained content changes.
+*
+* @see [Live Content API](https://www.sanity.io/docs/content-lake/live-content-api)
+* @see [Sanity Live](https://www.sanity.io/live)
+*
+* @example
+* ```tsx
+* import {createClient} from 'next-sanity'
+* import {defineLive} from 'next-sanity/live'
+*
+* const client = createClient({
+*   projectId: process.env.NEXT_PUBLIC_SANITY_PROJECT_ID,
+*   dataset: process.env.NEXT_PUBLIC_SANITY_DATASET,
+*   useCdn: true,
+*   perspective: 'published',
+* })
+* const token = process.env.SANITY_API_READ_TOKEN
+*
+* export const {sanityFetch, SanityLive} = defineLive({
+*   client,
+*   browserToken: token,
+*   serverToken: token,
+* })
+* ```
+*
+* @example
+* ```tsx
+* // app/layout.tsx
+* import {SanityLive} from '@/sanity/live'
+*
+* export default function RootLayout({children}: {children: React.ReactNode}) {
+*   return (
+*     <html lang="en">
+*       <body>
+*         {children}
+*         <SanityLive />
+*       </body>
+*     </html>
+*   )
+* }
+* ```
+*
+* @example
+* ```tsx
+* // app/[slug]/page.tsx
+* import {defineQuery} from 'next-sanity'
+* import {sanityFetch} from '@/sanity/live'
+*
+* const POSTS_SLUGS_QUERY = defineQuery(`
+*   *[_type == "post" && slug.current]{"slug": slug.current}
+* `)
+* const POST_QUERY = defineQuery(`
+*   *[_type == "post" && slug.current == $slug][0]
+* `)
+*
+* export async function generateStaticParams() {
+*   const {data} = await sanityFetch({
+*     query: POSTS_SLUGS_QUERY,
+*     perspective: 'published',
+*     stega: false,
+*   })
+*
+*   return data
+* }
+*
+* export default async function Page(props: PageProps<'/[slug]'>) {
+*   const {slug} = await props.params
+*   const {data} = await sanityFetch({
+*     query: POST_QUERY,
+*     params: {slug},
+*   })
+*
+*   return <pre>{JSON.stringify(data, null, 2)}</pre>
+* }
+* ```
+*
 * @public
 */
 function defineLive(config) {
@@ -21,74 +98,77 @@ function defineLive(config) {
 	});
 	const { token: originalToken } = client.config();
 	const studioUrlDefined = typeof client.config().stega.studioUrl !== "undefined";
-	return {
-		sanityFetch: async function sanityFetch({ query, params = {}, stega: _stega, tags = [], perspective: _perspective, tag, requestTag = tag ?? "next-loader.fetch" }) {
-			const stega = _stega ?? (stegaEnabled && studioUrlDefined && (await draftMode()).isEnabled);
-			const perspective = _perspective ?? await resolveCookiePerspective();
-			const useCdn = perspective === "published";
-			const revalidate = fetchOptions?.revalidate !== void 0 ? fetchOptions.revalidate : process.env.NODE_ENV === "production" ? false : void 0;
-			const isBuildPhase = process.env["NEXT_PHASE"] === PHASE_PRODUCTION_BUILD;
-			const cacheMode = useCdn && !isBuildPhase ? "noStale" : void 0;
-			const { syncTags } = await client.fetch(query, await params, {
-				filterResponse: false,
-				perspective,
-				stega: false,
-				returnQuery: false,
-				next: {
-					revalidate,
-					tags: [...tags, "sanity:fetch-sync-tags"]
-				},
-				useCdn,
-				cacheMode,
-				tag: [requestTag, "fetch-sync-tags"].filter(Boolean).join(".")
-			});
-			const cacheTags = [...tags, ...syncTags?.map((tag) => `sanity:${tag}`) || []];
-			const { result, resultSourceMap } = await client.fetch(query, await params, {
-				filterResponse: false,
-				perspective,
-				stega,
-				token: perspective !== "published" && serverToken ? serverToken : originalToken,
-				next: {
-					revalidate,
-					tags: cacheTags
-				},
-				useCdn,
-				cacheMode,
-				tag: requestTag
-			});
-			return {
-				data: result,
-				sourceMap: resultSourceMap || null,
+	const sanityFetch = async function sanityFetch({ query, params = {}, stega: _stega, tags = [], perspective: _perspective, tag, requestTag = tag ?? "next-loader.fetch" }) {
+		const stega = _stega ?? (stegaEnabled && studioUrlDefined && (await draftMode()).isEnabled);
+		const perspective = _perspective ?? await resolveCookiePerspective();
+		const useCdn = perspective === "published";
+		const revalidate = fetchOptions?.revalidate !== void 0 ? fetchOptions.revalidate : process.env.NODE_ENV === "production" ? false : void 0;
+		const isBuildPhase = process.env["NEXT_PHASE"] === PHASE_PRODUCTION_BUILD;
+		const cacheMode = useCdn && !isBuildPhase ? "noStale" : void 0;
+		const { syncTags } = await client.fetch(query, await params, {
+			filterResponse: false,
+			perspective,
+			stega: false,
+			returnQuery: false,
+			next: {
+				revalidate,
+				tags: [...tags, "sanity:fetch-sync-tags"]
+			},
+			useCdn,
+			cacheMode,
+			tag: [requestTag, "fetch-sync-tags"].filter(Boolean).join(".")
+		});
+		const cacheTags = [...tags, ...syncTags?.map((tag) => `sanity:${tag}`) || []];
+		const { result, resultSourceMap } = await client.fetch(query, await params, {
+			filterResponse: false,
+			perspective,
+			stega,
+			token: perspective !== "published" && serverToken ? serverToken : originalToken,
+			next: {
+				revalidate,
 				tags: cacheTags
-			};
-		},
-		SanityLive: async function SanityLive$1(props) {
-			const { refreshOnMount, refreshOnFocus, refreshOnReconnect, tag, requestTag = tag, onError, onGoAway, intervalOnGoAway, revalidateSyncTags, waitFor } = props;
-			const { projectId, dataset, apiHost, apiVersion, useProjectHostname, requestTagPrefix } = client.config();
-			const { isEnabled: isDraftModeEnabled } = await draftMode();
-			const { origin } = new URL(client.getUrl("", false));
-			preconnect(origin);
-			return /* @__PURE__ */ jsx(SanityLive, {
-				projectId,
-				dataset,
-				apiHost,
-				apiVersion,
-				useProjectHostname,
-				requestTagPrefix,
-				requestTag,
-				token: typeof browserToken === "string" && isDraftModeEnabled ? browserToken : void 0,
-				draftModeEnabled: isDraftModeEnabled,
-				draftModePerspective: await resolveCookiePerspective(),
-				refreshOnMount,
-				refreshOnFocus,
-				refreshOnReconnect,
-				onError,
-				onGoAway,
-				intervalOnGoAway,
-				revalidateSyncTags,
-				waitFor
-			});
-		}
+			},
+			useCdn,
+			cacheMode,
+			tag: requestTag
+		});
+		return {
+			data: result,
+			sourceMap: resultSourceMap || null,
+			tags: cacheTags
+		};
+	};
+	const SanityLive$2 = async function SanityLive$1(props) {
+		const { refreshOnMount, refreshOnFocus, refreshOnReconnect, tag, requestTag = tag, onError, onGoAway, intervalOnGoAway, revalidateSyncTags, waitFor } = props;
+		const { projectId, dataset, apiHost, apiVersion, useProjectHostname, requestTagPrefix } = client.config();
+		const { isEnabled: isDraftModeEnabled } = await draftMode();
+		const { origin } = new URL(client.getUrl("", false));
+		preconnect(origin);
+		return /* @__PURE__ */ jsx(SanityLive, {
+			projectId,
+			dataset,
+			apiHost,
+			apiVersion,
+			useProjectHostname,
+			requestTagPrefix,
+			requestTag,
+			token: typeof browserToken === "string" && isDraftModeEnabled ? browserToken : void 0,
+			draftModeEnabled: isDraftModeEnabled,
+			draftModePerspective: await resolveCookiePerspective(),
+			refreshOnMount,
+			refreshOnFocus,
+			refreshOnReconnect,
+			onError,
+			onGoAway,
+			intervalOnGoAway,
+			revalidateSyncTags,
+			waitFor
+		});
+	};
+	SanityLive$2.displayName = "SanityLiveServerComponent";
+	return {
+		sanityFetch,
+		SanityLive: SanityLive$2
 	};
 }
 async function resolveCookiePerspective() {

package/dist/live/conditions/react-server/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","names":["SanityLive","SanityLiveClientComponent"],"sources":["../../../../src/live/conditions/react-server/defineLive.tsx"],"sourcesContent":["import {\n  type ClientPerspective,\n  type ClientReturn,\n  type ContentSourceMap,\n  type LiveEventGoAway,\n  type QueryParams,\n  type SanityClient,\n  type SyncTag,\n} from '@sanity/client'\nimport {perspectiveCookieName} from '@sanity/preview-url-secret/constants'\nimport {SanityLive as SanityLiveClientComponent} from 'next-sanity/live/client-components'\nimport {PHASE_PRODUCTION_BUILD} from 'next/constants'\nimport {draftMode, cookies} from 'next/headers'\nimport {preconnect} from 'react-dom'\n\nimport {sanitizePerspective} from '#live/sanitizePerspective'\n\n/**\n * @public\n */\nexport type DefinedSanityFetchType = <const QueryString extends string>(options: {\n  query: QueryString\n  params?: QueryParams | Promise<QueryParams>\n  /**\n   * Add custom `next.tags` to the underlying fetch request.\n   * @see https://nextjs.org/docs/app/api-reference/functions/fetch#optionsnexttags\n   * This can be used in conjunction with custom fallback revalidation strategies, as well as with custom Server Actions that mutate data and want to render with fresh data right away (faster than the Live Event latency).\n   * @defaultValue `['sanity']`\n   */\n  tags?: string[]\n  perspective?: Exclude<ClientPerspective, 'raw'>\n  stega?: boolean\n  /**\n   * @deprecated use `requestTag` instead\n   */\n  tag?: never\n  /**\n   * This request tag is used to identify the request when viewing request logs from your Sanity Content Lake.\n   * @see https://www.sanity.io/docs/reference-api-request-tags\n   * @defaultValue 'next-loader.fetch'\n   */\n  requestTag?: string\n}) => Promise<{\n  data: ClientReturn<QueryString>\n  sourceMap: ContentSourceMap | null\n  tags: string[]\n}>\n\n/**\n * @public\n */\nexport interface DefinedSanityLiveProps {\n  /**\n   * Automatic refresh of RSC when the component <SanityLive /> is mounted.\n   * Note that this is different from revalidation, which is based on tags and causes `sanityFetch` calls to be re-fetched.\n   * @defaultValue `true`\n   */\n  refreshOnMount?: boolean\n  /**\n   * Automatically refresh when window gets focused\n   * Note that this is different from revalidation, which is based on tags and causes `sanityFetch` calls to be re-fetched.\n   * @defaultValue `false` if draftMode().isEnabled, otherwise `true` if not inside an iframe\n   */\n  refreshOnFocus?: boolean\n  /**\n   * Automatically refresh when the browser regains a network connection (via navigator.onLine)\n   * Note that this is different from revalidation, which is based on tags and causes `sanityFetch` calls to be re-fetched.\n   * @defaultValue `true`\n   */\n  refreshOnReconnect?: boolean\n  /**\n   * Automatically refresh on an interval when the Live Event API emits a `goaway` event, which indicates that the connection is rejected or closed.\n   * This typically happens if the connection limit is reached, or if the connection is idle for too long.\n   * To disable this long polling fallback behavior set `intervalOnGoAway` to `false` or `0`.\n   * You can also use `onGoAway` to handle the `goaway` event in your own way, and read the reason why the event was emitted.\n   * @defaultValue `30_000` 30 seconds interval\n   */\n  intervalOnGoAway?: number | false\n\n  /**\n   * Delays events until after a Sanity Function has processed them and called the callback endpoint.\n   * When omitted, events are delivered immediately.\n   */\n  waitFor?: 'function'\n\n  /**\n   * @deprecated use `requestTag` instead\n   */\n  tag?: never\n\n  /**\n   * This request tag is used to identify the request when viewing request logs from your Sanity Content Lake.\n   * @see https://www.sanity.io/docs/reference-api-request-tags\n   * @defaultValue 'next-loader.live'\n   */\n  requestTag?: string\n\n  /**\n   * Handle errors from the Live Events subscription.\n   * By default it's reported using `console.error`, you can override this prop to handle it in your own way.\n   */\n  onError?: (error: unknown) => void\n\n  /**\n   * Handle the `goaway` event if the connection is rejected/closed.\n   * `event.reason` will be a string of why the event was emitted, for example `'connection limit reached'`.\n   * When this happens the `<SanityLive />` will fallback to long polling with a default interval of 30 seconds, providing your own `onGoAway` handler does not change this behavior.\n   * If you want to disable long polling set `intervalOnGoAway` to `false` or `0`.\n   */\n  onGoAway?: (event: LiveEventGoAway, intervalOnGoAway: number | false) => void\n\n  /**\n   * Override how cache tags are invalidated, you need to pass a server action here.\n   * You can also pass a `use client` function here, and have `router.refresh()` be called if the promise resolves to `'refresh'`.\n   */\n  revalidateSyncTags?: (tags: SyncTag[]) => Promise<void | 'refresh'>\n}\n\n/**\n * @public\n */\nexport interface DefineSanityLiveOptions {\n  /**\n   * Required for `sanityFetch` and `SanityLive` to work\n   */\n  client: SanityClient\n  /**\n   * Optional. If provided then the token needs to have permissions to query documents with `drafts.` prefixes in order for `perspective: 'drafts'` to work.\n   * This token is not shared with the browser.\n   */\n  serverToken?: string | false\n  /**\n   * Optional. This token is shared with the browser, and should only have access to query published documents.\n   * It is used to setup a `Live Draft Content` EventSource connection, and enables live previewing drafts stand-alone, outside of Presentation Tool.\n   */\n  browserToken?: string | false\n  /**\n   * Fetch options used by `sanityFetch`\n   * @deprecated this option is removed in the next major version, use `export const revalidate` on the `page.tsx` or `layout.tsx` instead\n   */\n  fetchOptions?: {\n    /**\n     * Optional, enables time based revalidation in addition to the EventSource connection.\n     * @defaultValue `false`\n     */\n    revalidate?: number | false\n  }\n  /**\n   * Optional. Include stega encoding when draft mode is enabled.\n   *  @defaultValue `true`\n   */\n  stega?: boolean\n}\n\n/**\n * @public\n */\nexport function defineLive(config: DefineSanityLiveOptions): {\n  /**\n   * Use this function to fetch data from Sanity in your React Server Components.\n   * @public\n   */\n  sanityFetch: DefinedSanityFetchType\n  /**\n   * Render this in your root layout.tsx to make your page revalidate on new content live, automatically.\n   * @public\n   */\n  SanityLive: React.ComponentType<DefinedSanityLiveProps>\n} {\n  const {\n    client: _client,\n    serverToken,\n    browserToken,\n    fetchOptions,\n    stega: stegaEnabled = true,\n  } = config\n\n  if (!_client) {\n    throw new Error('`client` is required for `defineLive` to function')\n  }\n\n  if (process.env.NODE_ENV !== 'production' && !serverToken && serverToken !== false) {\n    console.warn(\n      'No `serverToken` provided to `defineLive`. This means that only published content will be fetched and respond to live events. You can silence this warning by setting `serverToken: false`.',\n    )\n  }\n\n  if (process.env.NODE_ENV !== 'production' && !browserToken && browserToken !== false) {\n    console.warn(\n      'No `browserToken` provided to `defineLive`. This means that live previewing drafts will only work when using the Presentation Tool in your Sanity Studio. To support live previewing drafts stand-alone, provide a `browserToken`. It is shared with the browser so it should only have Viewer rights or lower. You can silence this warning by setting `browserToken: false`.',\n    )\n  }\n\n  const client = _client.withConfig({allowReconfigure: false, useCdn: false})\n  const {token: originalToken} = client.config()\n  const studioUrlDefined = typeof client.config().stega.studioUrl !== 'undefined'\n\n  const sanityFetch: DefinedSanityFetchType = async function sanityFetch<\n    const QueryString extends string,\n  >({\n    query,\n    params = {},\n    stega: _stega,\n    tags = [],\n    perspective: _perspective,\n    tag,\n    requestTag = tag ?? 'next-loader.fetch',\n  }: {\n    query: QueryString\n    params?: QueryParams | Promise<QueryParams>\n    stega?: boolean\n    tags?: string[]\n    perspective?: Exclude<ClientPerspective, 'raw'>\n    tag?: string\n    requestTag?: string\n  }) {\n    const stega = _stega ?? (stegaEnabled && studioUrlDefined && (await draftMode()).isEnabled)\n    const perspective = _perspective ?? (await resolveCookiePerspective())\n    const useCdn = perspective === 'published'\n    const revalidate =\n      fetchOptions?.revalidate !== undefined\n        ? fetchOptions.revalidate\n        : process.env.NODE_ENV === 'production'\n          ? false\n          : undefined\n    const isBuildPhase = process.env['NEXT_PHASE'] === PHASE_PRODUCTION_BUILD\n    const cacheMode = useCdn && !isBuildPhase ? 'noStale' : undefined\n\n    const {syncTags} = await client.fetch(query, await params, {\n      filterResponse: false,\n      perspective: perspective as ClientPerspective,\n      stega: false,\n      returnQuery: false,\n      next: {revalidate, tags: [...tags, 'sanity:fetch-sync-tags']},\n      useCdn,\n      cacheMode,\n      tag: [requestTag, 'fetch-sync-tags'].filter(Boolean).join('.'),\n    })\n\n    const cacheTags = [...tags, ...(syncTags?.map((tag) => `sanity:${tag}`) || [])]\n\n    const {result, resultSourceMap} = await client.fetch(query, await params, {\n      filterResponse: false,\n      perspective: perspective as ClientPerspective,\n      stega,\n      token: perspective !== 'published' && serverToken ? serverToken : originalToken,\n      next: {revalidate, tags: cacheTags},\n      useCdn,\n      cacheMode,\n      tag: requestTag,\n    })\n    return {data: result, sourceMap: resultSourceMap || null, tags: cacheTags}\n  }\n\n  const SanityLive: React.ComponentType<DefinedSanityLiveProps> = async function SanityLive(props) {\n    const {\n      refreshOnMount,\n      refreshOnFocus,\n      refreshOnReconnect,\n      tag,\n      requestTag = tag,\n      onError,\n      onGoAway,\n      intervalOnGoAway,\n      revalidateSyncTags,\n      waitFor,\n    } = props\n    const {projectId, dataset, apiHost, apiVersion, useProjectHostname, requestTagPrefix} =\n      client.config()\n    const {isEnabled: isDraftModeEnabled} = await draftMode()\n\n    // Preconnect to the Live Event API origin early, as the Sanity API is almost always on a different origin than the app\n    const {origin} = new URL(client.getUrl('', false))\n    preconnect(origin)\n\n    return (\n      <SanityLiveClientComponent\n        projectId={projectId}\n        dataset={dataset}\n        apiHost={apiHost}\n        apiVersion={apiVersion}\n        useProjectHostname={useProjectHostname}\n        requestTagPrefix={requestTagPrefix}\n        requestTag={requestTag}\n        token={typeof browserToken === 'string' && isDraftModeEnabled ? browserToken : undefined}\n        draftModeEnabled={isDraftModeEnabled}\n        draftModePerspective={await resolveCookiePerspective()}\n        refreshOnMount={refreshOnMount}\n        refreshOnFocus={refreshOnFocus}\n        refreshOnReconnect={refreshOnReconnect}\n        onError={onError}\n        onGoAway={onGoAway}\n        intervalOnGoAway={intervalOnGoAway}\n        revalidateSyncTags={revalidateSyncTags}\n        waitFor={waitFor}\n      />\n    )\n  }\n\n  return {\n    sanityFetch,\n    SanityLive,\n  }\n}\n\nasync function resolveCookiePerspective(): Promise<Exclude<ClientPerspective, 'raw'>> {\n  return (await draftMode()).isEnabled\n    ? (await cookies()).has(perspectiveCookieName)\n      ? sanitizePerspective((await cookies()).get(perspectiveCookieName)?.value, 'drafts')\n      : 'drafts'\n    : 'published'\n}\n"],"mappings":";;;;;;;;;;;;AA6JA,SAAgB,WAAW,QAWzB;CACA,MAAM,EACJ,QAAQ,SACR,aACA,cACA,cACA,OAAO,eAAe,SACpB;AAEJ,KAAI,CAAC,QACH,OAAM,IAAI,MAAM,oDAAoD;AAGtE,KAAI,QAAQ,IAAI,aAAa,gBAAgB,CAAC,eAAe,gBAAgB,MAC3E,SAAQ,KACN,8LACD;AAGH,KAAI,QAAQ,IAAI,aAAa,gBAAgB,CAAC,gBAAgB,iBAAiB,MAC7E,SAAQ,KACN,iXACD;CAGH,MAAM,SAAS,QAAQ,WAAW;EAAC,kBAAkB;EAAO,QAAQ;EAAM,CAAC;CAC3E,MAAM,EAAC,OAAO,kBAAiB,OAAO,QAAQ;CAC9C,MAAM,mBAAmB,OAAO,OAAO,QAAQ,CAAC,MAAM,cAAc;AAwGpE,QAAO;EACL,aAAA,eAvGyD,YAEzD,EACA,OACA,SAAS,EAAE,EACX,OAAO,QACP,OAAO,EAAE,EACT,aAAa,cACb,KACA,aAAa,OAAO,uBASnB;GACD,MAAM,QAAQ,WAAW,gBAAgB,qBAAqB,MAAM,WAAW,EAAE;GACjF,MAAM,cAAc,gBAAiB,MAAM,0BAA0B;GACrE,MAAM,SAAS,gBAAgB;GAC/B,MAAM,aACJ,cAAc,eAAe,KAAA,IACzB,aAAa,aACb,QAAQ,IAAI,aAAa,eACvB,QACA,KAAA;GACR,MAAM,eAAe,QAAQ,IAAI,kBAAkB;GACnD,MAAM,YAAY,UAAU,CAAC,eAAe,YAAY,KAAA;GAExD,MAAM,EAAC,aAAY,MAAM,OAAO,MAAM,OAAO,MAAM,QAAQ;IACzD,gBAAgB;IACH;IACb,OAAO;IACP,aAAa;IACb,MAAM;KAAC;KAAY,MAAM,CAAC,GAAG,MAAM,yBAAyB;KAAC;IAC7D;IACA;IACA,KAAK,CAAC,YAAY,kBAAkB,CAAC,OAAO,QAAQ,CAAC,KAAK,IAAI;IAC/D,CAAC;GAEF,MAAM,YAAY,CAAC,GAAG,MAAM,GAAI,UAAU,KAAK,QAAQ,UAAU,MAAM,IAAI,EAAE,CAAE;GAE/E,MAAM,EAAC,QAAQ,oBAAmB,MAAM,OAAO,MAAM,OAAO,MAAM,QAAQ;IACxE,gBAAgB;IACH;IACb;IACA,OAAO,gBAAgB,eAAe,cAAc,cAAc;IAClE,MAAM;KAAC;KAAY,MAAM;KAAU;IACnC;IACA;IACA,KAAK;IACN,CAAC;AACF,UAAO;IAAC,MAAM;IAAQ,WAAW,mBAAmB;IAAM,MAAM;IAAU;;EAkD1E,YAAA,eA/C6EA,aAAW,OAAO;GAC/F,MAAM,EACJ,gBACA,gBACA,oBACA,KACA,aAAa,KACb,SACA,UACA,kBACA,oBACA,YACE;GACJ,MAAM,EAAC,WAAW,SAAS,SAAS,YAAY,oBAAoB,qBAClE,OAAO,QAAQ;GACjB,MAAM,EAAC,WAAW,uBAAsB,MAAM,WAAW;GAGzD,MAAM,EAAC,WAAU,IAAI,IAAI,OAAO,OAAO,IAAI,MAAM,CAAC;AAClD,cAAW,OAAO;AAElB,UACE,oBAACC,YAAD;IACa;IACF;IACA;IACG;IACQ;IACF;IACN;IACZ,OAAO,OAAO,iBAAiB,YAAY,qBAAqB,eAAe,KAAA;IAC/E,kBAAkB;IAClB,sBAAsB,MAAM,0BAA0B;IACtC;IACA;IACI;IACX;IACC;IACQ;IACE;IACX;IACT,CAAA;;EAOL;;AAGH,eAAe,2BAAuE;AACpF,SAAQ,MAAM,WAAW,EAAE,aACtB,MAAM,SAAS,EAAE,IAAI,sBAAsB,GAC1C,qBAAqB,MAAM,SAAS,EAAE,IAAI,sBAAsB,EAAE,OAAO,SAAS,GAClF,WACF"}
+{"version":3,"file":"index.js","names":["SanityLive","SanityLiveClientComponent"],"sources":["../../../../src/live/conditions/react-server/defineLive.tsx"],"sourcesContent":["import type {ClientPerspective, QueryParams} from '@sanity/client'\nimport {perspectiveCookieName} from '@sanity/preview-url-secret/constants'\nimport {SanityLive as SanityLiveClientComponent} from 'next-sanity/live/client-components'\nimport {PHASE_PRODUCTION_BUILD} from 'next/constants'\nimport {cookies, draftMode} from 'next/headers'\nimport {preconnect} from 'react-dom'\n\nimport {sanitizePerspective} from '#live/sanitizePerspective'\nimport type {DefinedFetchType, DefinedLiveProps, DefineLiveOptions} from '#live/types'\n\n/**\n * Set up Sanity Live. `defineLive` returns `sanityFetch` and `<SanityLive />`,\n * which connect your Sanity client to the Live Content API so pages can serve\n * cached content and update in response to fine-grained content changes.\n *\n * @see [Live Content API](https://www.sanity.io/docs/content-lake/live-content-api)\n * @see [Sanity Live](https://www.sanity.io/live)\n *\n * @example\n * ```tsx\n * import {createClient} from 'next-sanity'\n * import {defineLive} from 'next-sanity/live'\n *\n * const client = createClient({\n *   projectId: process.env.NEXT_PUBLIC_SANITY_PROJECT_ID,\n *   dataset: process.env.NEXT_PUBLIC_SANITY_DATASET,\n *   useCdn: true,\n *   perspective: 'published',\n * })\n * const token = process.env.SANITY_API_READ_TOKEN\n *\n * export const {sanityFetch, SanityLive} = defineLive({\n *   client,\n *   browserToken: token,\n *   serverToken: token,\n * })\n * ```\n *\n * @example\n * ```tsx\n * // app/layout.tsx\n * import {SanityLive} from '@/sanity/live'\n *\n * export default function RootLayout({children}: {children: React.ReactNode}) {\n *   return (\n *     <html lang=\"en\">\n *       <body>\n *         {children}\n *         <SanityLive />\n *       </body>\n *     </html>\n *   )\n * }\n * ```\n *\n * @example\n * ```tsx\n * // app/[slug]/page.tsx\n * import {defineQuery} from 'next-sanity'\n * import {sanityFetch} from '@/sanity/live'\n *\n * const POSTS_SLUGS_QUERY = defineQuery(`\n *   *[_type == \"post\" && slug.current]{\"slug\": slug.current}\n * `)\n * const POST_QUERY = defineQuery(`\n *   *[_type == \"post\" && slug.current == $slug][0]\n * `)\n *\n * export async function generateStaticParams() {\n *   const {data} = await sanityFetch({\n *     query: POSTS_SLUGS_QUERY,\n *     perspective: 'published',\n *     stega: false,\n *   })\n *\n *   return data\n * }\n *\n * export default async function Page(props: PageProps<'/[slug]'>) {\n *   const {slug} = await props.params\n *   const {data} = await sanityFetch({\n *     query: POST_QUERY,\n *     params: {slug},\n *   })\n *\n *   return <pre>{JSON.stringify(data, null, 2)}</pre>\n * }\n * ```\n *\n * @public\n */\nexport function defineLive(config: DefineLiveOptions): {\n  sanityFetch: DefinedFetchType\n  SanityLive: React.ComponentType<DefinedLiveProps>\n} {\n  const {\n    client: _client,\n    serverToken,\n    browserToken,\n    fetchOptions,\n    stega: stegaEnabled = true,\n  } = config\n\n  if (!_client) {\n    throw new Error('`client` is required for `defineLive` to function')\n  }\n\n  if (process.env.NODE_ENV !== 'production' && !serverToken && serverToken !== false) {\n    console.warn(\n      'No `serverToken` provided to `defineLive`. This means that only published content will be fetched and respond to live events. You can silence this warning by setting `serverToken: false`.',\n    )\n  }\n\n  if (process.env.NODE_ENV !== 'production' && !browserToken && browserToken !== false) {\n    console.warn(\n      'No `browserToken` provided to `defineLive`. This means that live previewing drafts will only work when using the Presentation Tool in your Sanity Studio. To support live previewing drafts stand-alone, provide a `browserToken`. It is shared with the browser so it should only have Viewer rights or lower. You can silence this warning by setting `browserToken: false`.',\n    )\n  }\n\n  const client = _client.withConfig({allowReconfigure: false, useCdn: false})\n  const {token: originalToken} = client.config()\n  const studioUrlDefined = typeof client.config().stega.studioUrl !== 'undefined'\n\n  const sanityFetch: DefinedFetchType = async function sanityFetch<\n    const QueryString extends string,\n  >({\n    query,\n    params = {},\n    stega: _stega,\n    tags = [],\n    perspective: _perspective,\n    tag,\n    requestTag = tag ?? 'next-loader.fetch',\n  }: {\n    query: QueryString\n    params?: QueryParams | Promise<QueryParams>\n    stega?: boolean\n    tags?: string[]\n    perspective?: Exclude<ClientPerspective, 'raw'>\n    tag?: string\n    requestTag?: string\n  }) {\n    const stega = _stega ?? (stegaEnabled && studioUrlDefined && (await draftMode()).isEnabled)\n    const perspective = _perspective ?? (await resolveCookiePerspective())\n    const useCdn = perspective === 'published'\n    const revalidate =\n      fetchOptions?.revalidate !== undefined\n        ? fetchOptions.revalidate\n        : process.env.NODE_ENV === 'production'\n          ? false\n          : undefined\n    const isBuildPhase = process.env['NEXT_PHASE'] === PHASE_PRODUCTION_BUILD\n    const cacheMode = useCdn && !isBuildPhase ? 'noStale' : undefined\n\n    const {syncTags} = await client.fetch(query, await params, {\n      filterResponse: false,\n      perspective: perspective as ClientPerspective,\n      stega: false,\n      returnQuery: false,\n      next: {revalidate, tags: [...tags, 'sanity:fetch-sync-tags']},\n      useCdn,\n      cacheMode,\n      tag: [requestTag, 'fetch-sync-tags'].filter(Boolean).join('.'),\n    })\n\n    const cacheTags = [...tags, ...(syncTags?.map((tag) => `sanity:${tag}`) || [])]\n\n    const {result, resultSourceMap} = await client.fetch(query, await params, {\n      filterResponse: false,\n      perspective: perspective as ClientPerspective,\n      stega,\n      token: perspective !== 'published' && serverToken ? serverToken : originalToken,\n      next: {revalidate, tags: cacheTags},\n      useCdn,\n      cacheMode,\n      tag: requestTag,\n    })\n    return {data: result, sourceMap: resultSourceMap || null, tags: cacheTags}\n  }\n\n  const SanityLive: React.ComponentType<DefinedLiveProps> = async function SanityLive(props) {\n    const {\n      refreshOnMount,\n      refreshOnFocus,\n      refreshOnReconnect,\n      tag,\n      requestTag = tag,\n      onError,\n      onGoAway,\n      intervalOnGoAway,\n      revalidateSyncTags,\n      waitFor,\n    } = props\n    const {projectId, dataset, apiHost, apiVersion, useProjectHostname, requestTagPrefix} =\n      client.config()\n    const {isEnabled: isDraftModeEnabled} = await draftMode()\n\n    // Preconnect to the Live Event API origin early, as the Sanity API is almost always on a different origin than the app\n    const {origin} = new URL(client.getUrl('', false))\n    preconnect(origin)\n\n    return (\n      <SanityLiveClientComponent\n        projectId={projectId}\n        dataset={dataset}\n        apiHost={apiHost}\n        apiVersion={apiVersion}\n        useProjectHostname={useProjectHostname}\n        requestTagPrefix={requestTagPrefix}\n        requestTag={requestTag}\n        token={typeof browserToken === 'string' && isDraftModeEnabled ? browserToken : undefined}\n        draftModeEnabled={isDraftModeEnabled}\n        draftModePerspective={await resolveCookiePerspective()}\n        refreshOnMount={refreshOnMount}\n        refreshOnFocus={refreshOnFocus}\n        refreshOnReconnect={refreshOnReconnect}\n        onError={onError}\n        onGoAway={onGoAway}\n        intervalOnGoAway={intervalOnGoAway}\n        revalidateSyncTags={revalidateSyncTags}\n        waitFor={waitFor}\n      />\n    )\n  }\n  SanityLive.displayName = 'SanityLiveServerComponent'\n\n  return {sanityFetch, SanityLive}\n}\n\nasync function resolveCookiePerspective(): Promise<Exclude<ClientPerspective, 'raw'>> {\n  return (await draftMode()).isEnabled\n    ? (await cookies()).has(perspectiveCookieName)\n      ? sanitizePerspective((await cookies()).get(perspectiveCookieName)?.value, 'drafts')\n      : 'drafts'\n    : 'published'\n}\n"],"mappings":"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"}

package/dist/live/server-actions/{index.default.d.ts → index.d.ts}

@@ -2,4 +2,4 @@ import { ClientPerspective, SyncTag } from "@sanity/client";
 declare function revalidateSyncTags(tags: SyncTag[]): Promise<void>;
 declare function setPerspectiveCookie(perspective: ClientPerspective): Promise<void>;
 export { revalidateSyncTags, setPerspectiveCookie };
-//# sourceMappingURL=index.default.d.ts.map
+//# sourceMappingURL=index.d.ts.map

package/dist/live/server-actions/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","names":[],"sources":["../../../src/live/server-actions/index.ts"],"mappings":";iBASsB,kBAAA,CAAmB,IAAA,EAAM,OAAA,KAAY,OAAA;AAAA,iBAwBrC,oBAAA,CAAqB,WAAA,EAAa,iBAAA,GAAoB,OAAA"}

package/dist/live/server-actions/{index.default.js → index.js}

@@ -28,4 +28,4 @@ async function setPerspectiveCookie(perspective) {
 }
 export { revalidateSyncTags, setPerspectiveCookie };
 
-//# sourceMappingURL=index.default.js.map
+//# sourceMappingURL=index.js.map

package/dist/live/server-actions/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","names":[],"sources":["../../../src/live/server-actions/index.ts"],"sourcesContent":["'use server'\n\nimport type {ClientPerspective, SyncTag} from '@sanity/client'\nimport {perspectiveCookieName} from '@sanity/preview-url-secret/constants'\nimport {revalidateTag, updateTag} from 'next/cache'\nimport {cookies, draftMode} from 'next/headers'\n\nimport {sanitizePerspective} from '#live/sanitizePerspective'\n\nexport async function revalidateSyncTags(tags: SyncTag[]): Promise<void> {\n  const {isEnabled: isDraftMode} = await draftMode()\n\n  if (!isDraftMode) {\n    revalidateTag('sanity:fetch-sync-tags', 'max')\n  }\n\n  const logTags: string[] = []\n  for (const _tag of tags) {\n    const tag = `sanity:${_tag}`\n    if (isDraftMode) {\n      revalidateTag(tag, 'max')\n    } else {\n      updateTag(tag)\n    }\n    logTags.push(tag)\n  }\n\n  // oxlint-disable-next-line no-console\n  console.log(\n    `<SanityLive /> ${isDraftMode ? `revalidated tags: ${logTags.join(', ')} with cache profile \"max\" ` : `updated tags: ${logTags.join(', ')} and revalidated tag: \"sanity:fetch-sync-tags\" with cache profile \"max\"`}`,\n  )\n}\n\nexport async function setPerspectiveCookie(perspective: ClientPerspective): Promise<void> {\n  if (!(await draftMode()).isEnabled) {\n    // throw new Error('Draft mode is not enabled, setting perspective cookie is not allowed')\n    return\n  }\n  const sanitizedPerspective = sanitizePerspective(perspective, 'drafts')\n  if (perspective !== sanitizedPerspective) {\n    throw new Error(`Invalid perspective`, {cause: perspective})\n  }\n\n  ;(await cookies()).set(\n    perspectiveCookieName,\n    Array.isArray(sanitizedPerspective) ? sanitizedPerspective.join(',') : sanitizedPerspective,\n    {\n      httpOnly: true,\n      path: '/',\n      secure: true,\n      sameSite: 'none',\n    },\n  )\n}\n"],"mappings":";;;;;AASA,eAAsB,mBAAmB,MAAgC;CACvE,MAAM,EAAC,WAAW,gBAAe,MAAM,WAAW;AAElD,KAAI,CAAC,YACH,eAAc,0BAA0B,MAAM;CAGhD,MAAM,UAAoB,EAAE;AAC5B,MAAK,MAAM,QAAQ,MAAM;EACvB,MAAM,MAAM,UAAU;AACtB,MAAI,YACF,eAAc,KAAK,MAAM;MAEzB,WAAU,IAAI;AAEhB,UAAQ,KAAK,IAAI;;AAInB,SAAQ,IACN,kBAAkB,cAAc,qBAAqB,QAAQ,KAAK,KAAK,CAAC,8BAA8B,iBAAiB,QAAQ,KAAK,KAAK,CAAC,2EAC3I;;AAGH,eAAsB,qBAAqB,aAA+C;AACxF,KAAI,EAAE,MAAM,WAAW,EAAE,UAEvB;CAEF,MAAM,uBAAuB,oBAAoB,aAAa,SAAS;AACvE,KAAI,gBAAgB,qBAClB,OAAM,IAAI,MAAM,uBAAuB,EAAC,OAAO,aAAY,CAAC;AAG7D,EAAC,MAAM,SAAS,EAAE,IACjB,uBACA,MAAM,QAAQ,qBAAqB,GAAG,qBAAqB,KAAK,IAAI,GAAG,sBACvE;EACE,UAAU;EACV,MAAM;EACN,QAAQ;EACR,UAAU;EACX,CACF"}

package/dist/{defineLive.d.ts → types.d.ts}

@@ -1,19 +1,43 @@
-import { ClientPerspective, ClientReturn, ContentSourceMap, LiveEventGoAway, QueryParams, SanityClient, SyncTag } from "@sanity/client";
+import { ClientPerspective, ClientReturn, ContentSourceMap, LiveEventGoAway, QueryParams, SanityClient, SyncTag } from "next-sanity";
 /**
+* Perspectives supported by Sanity Live.
+* Using the legacy `'raw'` perspective is not supported and leads to undefined behavior.
+*/
+type LivePerspective = Exclude<ClientPerspective, "raw">;
+/**
+* Use this function to fetch data from Sanity in your React Server Components.
+* When used within a `generateMetadata` or `generateViewport` function, make sure you set `stega: false`.
+* When used within a `generateStaticParams` function, make sure you set `stega: false` and `perspective: 'published'`.
 * @public
 */
-type DefinedSanityFetchType = <const QueryString extends string>(options: {
+type DefinedFetchType = <const QueryString extends string>(options: {
+  /**
+  * GROQ query to execute.
+  */
   query: QueryString;
+  /**
+  * Parameters used by the GROQ query.
+  */
   params?: QueryParams | Promise<QueryParams>;
   /**
+  * Content perspective used for the fetch.
+  *
+  * @defaultValue 'published' or when in draft mode it's 'drafts' or the value of a cookie named 'sanity-preview-perspective' that is set by `defineEnableDraftMode`.
+  */
+  perspective?: LivePerspective;
+  /**
+  * Enables stega encoding of the data. This is typically only used in draft
+  * mode with `perspective: 'drafts'` and `@sanity/visual-editing`.
+  *
+  * @defaultValue `false` or when in draft mode it's `true`
+  */
+  stega?: boolean;
+  /**
   * Add custom `next.tags` to the underlying fetch request.
   * @see https://nextjs.org/docs/app/api-reference/functions/fetch#optionsnexttags
   * This can be used in conjunction with custom fallback revalidation strategies, as well as with custom Server Actions that mutate data and want to render with fresh data right away (faster than the Live Event latency).
-  * @defaultValue `['sanity']`
   */
   tags?: string[];
-  perspective?: Exclude<ClientPerspective, "raw">;
-  stega?: boolean;
   /**
   * @deprecated use `requestTag` instead
   */
@@ -25,14 +49,15 @@ type DefinedSanityFetchType = <const QueryString extends string>(options: {
   */
   requestTag?: string;
 }) => Promise<{
-  data: ClientReturn<QueryString>;
+  data: ClientReturn<QueryString, unknown>;
   sourceMap: ContentSourceMap | null;
   tags: string[];
 }>;
 /**
+* Render this in your root layout.tsx to make your page revalidate on new content live, automatically.
 * @public
 */
-interface DefinedSanityLiveProps {
+interface DefinedLiveProps {
   /**
   * Automatic refresh of RSC when the component <SanityLive /> is mounted.
   * Note that this is different from revalidation, which is based on tags and causes `sanityFetch` calls to be re-fetched.
@@ -60,8 +85,11 @@ interface DefinedSanityLiveProps {
   */
   intervalOnGoAway?: number | false;
   /**
-  * Delays events until after a Sanity Function has processed them and called the callback endpoint.
+  * Delays events until after a configured Sanity Function has processed them and called the callback endpoint.
   * When omitted, events are delivered immediately.
+  *
+  * @remarks
+  * When set, any custom `revalidateSyncTags` will not be called — revalidation is handled by the Function instead.
   */
   waitFor?: "function";
   /**
@@ -95,7 +123,7 @@ interface DefinedSanityLiveProps {
 /**
 * @public
 */
-interface DefineSanityLiveOptions {
+interface DefineLiveOptions {
   /**
   * Required for `sanityFetch` and `SanityLive` to work
   */
@@ -127,20 +155,5 @@ interface DefineSanityLiveOptions {
   */
   stega?: boolean;
 }
-/**
-* @public
-*/
-declare function defineLive(config: DefineSanityLiveOptions): {
-  /**
-  * Use this function to fetch data from Sanity in your React Server Components.
-  * @public
-  */
-  sanityFetch: DefinedSanityFetchType;
-  /**
-  * Render this in your root layout.tsx to make your page revalidate on new content live, automatically.
-  * @public
-  */
-  SanityLive: React.ComponentType<DefinedSanityLiveProps>;
-};
-export { defineLive as i, DefinedSanityFetchType as n, DefinedSanityLiveProps as r, DefineSanityLiveOptions as t };
-//# sourceMappingURL=defineLive.d.ts.map
+export { LivePerspective as i, DefinedFetchType as n, DefinedLiveProps as r, DefineLiveOptions as t };
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","names":[],"sources":["../src/live/shared/types.ts"],"mappings":";;AAcA;;;KAAY,eAAA,GAAkB,OAAA,CAAQ,iBAAA;;AAQtC;;;;;KAAY,gBAAA,sCAAsD,OAAA;;;;EAIhE,KAAA,EAAO,WAAA;;;;EAIP,MAAA,GAAS,WAAA,GAAc,OAAA,CAAQ,WAAA;;;;;;EAM/B,WAAA,GAAc,eAAA;;;;;;;EAOd,KAAA;;;;;;EAMA,IAAA;;;;EAIA,GAAA;EAiBF;;;;;EAXE,UAAA;AAAA,MACI,OAAA;EACJ,IAAA,EAAM,YAAA,CAAa,WAAA;EACnB,SAAA,EAAW,gBAAA;EACX,IAAA;AAAA;;;;;UAOe,gBAAA;;;;;;EAMf,cAAA;;;;;;EAMA,cAAA;EA6De;;;;;EAvDf,kBAAA;;;;;;;;EAQA,gBAAA;;;;;;;;EASA,OAAA;;;;EAKA,GAAA;;;;;;EAOA,UAAA;;;;;EAMA,OAAA,IAAW,KAAA;;;;;;;EAQX,QAAA,IAAY,KAAA,EAAO,eAAA,EAAiB,gBAAA;;;;;EAMpC,kBAAA,IAAsB,IAAA,EAAM,OAAA,OAAc,OAAA;AAAA;;;;UAM3B,iBAAA;;;;EAIf,MAAA,EAAQ,YAAA;;;;;EAKR,WAAA;;;;;EAKA,YAAA;;;;;EAKA,YAAA;;;;;IAKE,UAAA;EAAA;;;;;EAMF,KAAA;AAAA"}

package/dist/visual-editing/server-actions/index.d.ts

@@ -2,6 +2,6 @@ import { ClientPerspective } from "@sanity/client";
 /**
 * @internal CAUTION: this is an internal action and does not follow semver. Using it directly is at your own risk.
 */
-declare function actionPerspectiveChange(perspective: ClientPerspective): Promise<void>;
-export { actionPerspectiveChange };
+declare function perspectiveChangeAction(perspective: ClientPerspective): Promise<void>;
+export { perspectiveChangeAction };
 //# sourceMappingURL=index.d.ts.map

package/dist/visual-editing/server-actions/index.js

@@ -6,13 +6,13 @@ import { refresh } from "next/cache";
 /**
 * @internal CAUTION: this is an internal action and does not follow semver. Using it directly is at your own risk.
 */
-async function actionPerspectiveChange(perspective) {
+async function perspectiveChangeAction(perspective) {
 	const sanitizedPerspective = sanitizePerspective(perspective, "drafts");
 	if (!sanitizedPerspective || Array.isArray(sanitizedPerspective) && sanitizedPerspective.length === 0) throw new Error(`Invalid perspective`, { cause: perspective });
 	const nextPerspective = Array.isArray(sanitizedPerspective) ? sanitizedPerspective.join(",") : sanitizedPerspective;
 	const jar = await cookies();
 	if (nextPerspective === jar.get(perspectiveCookieName)?.value && process.env.NODE_ENV !== "production") {
-		console.debug("actionPerspectiveChange", "Perspective is the same, skipping", nextPerspective);
+		console.debug("perspectiveChangeAction", "Perspective is the same, skipping", nextPerspective);
 		return;
 	}
 	jar.set(perspectiveCookieName, nextPerspective, {
@@ -23,6 +23,6 @@ async function actionPerspectiveChange(perspective) {
 	});
 	refresh();
 }
-export { actionPerspectiveChange };
+export { perspectiveChangeAction };
 
 //# sourceMappingURL=index.js.map

package/dist/visual-editing/server-actions/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","names":[],"sources":["../../../src/visual-editing/server-actions/index.ts"],"sourcesContent":["'use server'\n\nimport type {ClientPerspective} from '@sanity/client'\nimport {perspectiveCookieName} from '@sanity/preview-url-secret/constants'\nimport {refresh} from 'next/cache'\nimport {cookies} from 'next/headers'\n\nimport {sanitizePerspective} from '#live/sanitizePerspective'\n\n/**\n * @internal CAUTION: this is an internal action and does not follow semver. Using it directly is at your own risk.\n */\nexport async function actionPerspectiveChange(perspective: ClientPerspective): Promise<void> {\n  const sanitizedPerspective = sanitizePerspective(perspective, 'drafts')\n  if (\n    !sanitizedPerspective ||\n    (Array.isArray(sanitizedPerspective) && sanitizedPerspective.length === 0)\n  ) {\n    throw new Error(`Invalid perspective`, {cause: perspective})\n  }\n\n  const nextPerspective = Array.isArray(sanitizedPerspective)\n    ? sanitizedPerspective.join(',')\n    : sanitizedPerspective\n  const jar = await cookies()\n  if (\n    nextPerspective === jar.get(perspectiveCookieName)?.value &&\n    process.env.NODE_ENV !== 'production'\n  ) {\n    // oxlint-disable-next-line no-console\n    console.debug('actionPerspectiveChange', 'Perspective is the same, skipping', nextPerspective)\n    return\n  }\n  jar.set(perspectiveCookieName, nextPerspective, {\n    httpOnly: true,\n    path: '/',\n    secure: true,\n    sameSite: 'none',\n  })\n\n  refresh()\n}\n"],"mappings":";;;;;;;;AAYA,eAAsB,wBAAwB,aAA+C;CAC3F,MAAM,uBAAuB,oBAAoB,aAAa,SAAS;AACvE,KACE,CAAC,wBACA,MAAM,QAAQ,qBAAqB,IAAI,qBAAqB,WAAW,EAExE,OAAM,IAAI,MAAM,uBAAuB,EAAC,OAAO,aAAY,CAAC;CAG9D,MAAM,kBAAkB,MAAM,QAAQ,qBAAqB,GACvD,qBAAqB,KAAK,IAAI,GAC9B;CACJ,MAAM,MAAM,MAAM,SAAS;AAC3B,KACE,oBAAoB,IAAI,IAAI,sBAAsB,EAAE,SACpD,QAAQ,IAAI,aAAa,cACzB;AAEA,UAAQ,MAAM,2BAA2B,qCAAqC,gBAAgB;AAC9F;;AAEF,KAAI,IAAI,uBAAuB,iBAAiB;EAC9C,UAAU;EACV,MAAM;EACN,QAAQ;EACR,UAAU;EACX,CAAC;AAEF,UAAS"}
+{"version":3,"file":"index.js","names":[],"sources":["../../../src/visual-editing/server-actions/index.ts"],"sourcesContent":["'use server'\n\nimport type {ClientPerspective} from '@sanity/client'\nimport {perspectiveCookieName} from '@sanity/preview-url-secret/constants'\nimport {refresh} from 'next/cache'\nimport {cookies} from 'next/headers'\n\nimport {sanitizePerspective} from '#live/sanitizePerspective'\n\n/**\n * @internal CAUTION: this is an internal action and does not follow semver. Using it directly is at your own risk.\n */\nexport async function perspectiveChangeAction(perspective: ClientPerspective): Promise<void> {\n  const sanitizedPerspective = sanitizePerspective(perspective, 'drafts')\n  if (\n    !sanitizedPerspective ||\n    (Array.isArray(sanitizedPerspective) && sanitizedPerspective.length === 0)\n  ) {\n    throw new Error(`Invalid perspective`, {cause: perspective})\n  }\n\n  const nextPerspective = Array.isArray(sanitizedPerspective)\n    ? sanitizedPerspective.join(',')\n    : sanitizedPerspective\n  const jar = await cookies()\n  if (\n    nextPerspective === jar.get(perspectiveCookieName)?.value &&\n    process.env.NODE_ENV !== 'production'\n  ) {\n    // oxlint-disable-next-line no-console\n    console.debug('perspectiveChangeAction', 'Perspective is the same, skipping', nextPerspective)\n    return\n  }\n  jar.set(perspectiveCookieName, nextPerspective, {\n    httpOnly: true,\n    path: '/',\n    secure: true,\n    sameSite: 'none',\n  })\n\n  refresh()\n}\n"],"mappings":";;;;;;;;AAYA,eAAsB,wBAAwB,aAA+C;CAC3F,MAAM,uBAAuB,oBAAoB,aAAa,SAAS;AACvE,KACE,CAAC,wBACA,MAAM,QAAQ,qBAAqB,IAAI,qBAAqB,WAAW,EAExE,OAAM,IAAI,MAAM,uBAAuB,EAAC,OAAO,aAAY,CAAC;CAG9D,MAAM,kBAAkB,MAAM,QAAQ,qBAAqB,GACvD,qBAAqB,KAAK,IAAI,GAC9B;CACJ,MAAM,MAAM,MAAM,SAAS;AAC3B,KACE,oBAAoB,IAAI,IAAI,sBAAsB,EAAE,SACpD,QAAQ,IAAI,aAAa,cACzB;AAEA,UAAQ,MAAM,2BAA2B,qCAAqC,gBAAgB;AAC9F;;AAEF,KAAI,IAAI,uBAAuB,iBAAiB;EAC9C,UAAU;EACV,MAAM;EACN,QAAQ;EACR,UAAU;EACX,CAAC;AAEF,UAAS"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "next-sanity",
-  "version": "12.4.0",
+  "version": "12.4.1",
   "description": "Sanity.io toolkit for Next.js",
   "keywords": [
     "live",
@@ -47,9 +47,7 @@
       "default": "./dist/live/conditions/default/index.js"
     },
     "./live/client-components": "./dist/live/client-components/index.js",
-    "./live/server-actions": {
-      "default": "./dist/live/server-actions/index.default.js"
-    },
+    "./live/server-actions": "./dist/live/server-actions/index.js",
     "./studio": "./dist/studio/index.js",
     "./studio/client-component": "./dist/studio/client-component/index.js",
     "./visual-editing": "./dist/visual-editing/index.js",
@@ -79,7 +77,7 @@
     "@vitejs/plugin-react": "^6.0.1",
     "@vitest/coverage-v8": "^4.1.5",
     "js-yaml": "^4.1.1",
-    "next": "16.3.0-canary.6",
+    "next": "16.3.0-canary.10",
     "publint": "^0.3.18",
     "react": "^19.2.5",
     "react-dom": "^19.2.5",

package/dist/defineLive.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"defineLive.d.ts","names":[],"sources":["../src/live/conditions/react-server/defineLive.tsx"],"mappings":";;AAoBA;;KAAY,sBAAA,sCAA4D,OAAA;EACtE,KAAA,EAAO,WAAA;EACP,MAAA,GAAS,WAAA,GAAc,OAAA,CAAQ,WAAA;;;;;;;EAO/B,IAAA;EACA,WAAA,GAAc,OAAA,CAAQ,iBAAA;EACtB,KAAA;EAWI;;;EAPJ,GAAA;;;;;;EAMA,UAAA;AAAA,MACI,OAAA;EACJ,IAAA,EAAM,YAAA,CAAa,WAAA;EACnB,SAAA,EAAW,gBAAA;EACX,IAAA;AAAA;;;;UAMe,sBAAA;;;;;;EAMf,cAAA;EANF;;;;;EAYE,cAAA;;;;;;EAMA,kBAAA;;;;;;;;EAQA,gBAAA;;;;;EAMA,OAAA;;;AAsCF;EAjCE,GAAA;;;;;;EAOA,UAAA;;;;;EAMA,OAAA,IAAW,KAAA;EAwDb;;;;;;EAhDE,QAAA,IAAY,KAAA,EAAO,eAAA,EAAiB,gBAAA;;;;;EAMpC,kBAAA,IAAsB,IAAA,EAAM,OAAA,OAAc,OAAA;AAAA;;;;UAM3B,uBAAA;;;;EAIf,MAAA,EAAQ,YAAA;;;;;EAKR,WAAA;;;;;EAKA,YAAA;;;;;EAKA,YAAA;;;;;IAKE,UAAA;EAAA;;;;;EAMF,KAAA;AAAA;;;;iBAMc,UAAA,CAAW,MAAA,EAAQ,uBAAA;;;;;EAKjC,WAAA,EAAa,sBAAA;;;;;EAKb,UAAA,EAAY,KAAA,CAAM,aAAA,CAAc,sBAAA;AAAA"}

package/dist/live/server-actions/index.default.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.default.d.ts","names":[],"sources":["../../../src/live/server-actions/index.default.ts"],"mappings":";iBASsB,kBAAA,CAAmB,IAAA,EAAM,OAAA,KAAY,OAAA;AAAA,iBAwBrC,oBAAA,CAAqB,WAAA,EAAa,iBAAA,GAAoB,OAAA"}

package/dist/live/server-actions/index.default.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.default.js","names":[],"sources":["../../../src/live/server-actions/index.default.ts"],"sourcesContent":["'use server'\n\nimport type {ClientPerspective, SyncTag} from '@sanity/client'\nimport {perspectiveCookieName} from '@sanity/preview-url-secret/constants'\nimport {revalidateTag, updateTag} from 'next/cache'\nimport {cookies, draftMode} from 'next/headers'\n\nimport {sanitizePerspective} from '#live/sanitizePerspective'\n\nexport async function revalidateSyncTags(tags: SyncTag[]): Promise<void> {\n  const {isEnabled: isDraftMode} = await draftMode()\n\n  if (!isDraftMode) {\n    revalidateTag('sanity:fetch-sync-tags', 'max')\n  }\n\n  const logTags: string[] = []\n  for (const _tag of tags) {\n    const tag = `sanity:${_tag}`\n    if (isDraftMode) {\n      revalidateTag(tag, 'max')\n    } else {\n      updateTag(tag)\n    }\n    logTags.push(tag)\n  }\n\n  // oxlint-disable-next-line no-console\n  console.log(\n    `<SanityLive /> ${isDraftMode ? `revalidated tags: ${logTags.join(', ')} with cache profile \"max\" ` : `updated tags: ${logTags.join(', ')} and revalidated tag: \"sanity:fetch-sync-tags\" with cache profile \"max\"`}`,\n  )\n}\n\nexport async function setPerspectiveCookie(perspective: ClientPerspective): Promise<void> {\n  if (!(await draftMode()).isEnabled) {\n    // throw new Error('Draft mode is not enabled, setting perspective cookie is not allowed')\n    return\n  }\n  const sanitizedPerspective = sanitizePerspective(perspective, 'drafts')\n  if (perspective !== sanitizedPerspective) {\n    throw new Error(`Invalid perspective`, {cause: perspective})\n  }\n\n  ;(await cookies()).set(\n    perspectiveCookieName,\n    Array.isArray(sanitizedPerspective) ? sanitizedPerspective.join(',') : sanitizedPerspective,\n    {\n      httpOnly: true,\n      path: '/',\n      secure: true,\n      sameSite: 'none',\n    },\n  )\n}\n"],"mappings":";;;;;AASA,eAAsB,mBAAmB,MAAgC;CACvE,MAAM,EAAC,WAAW,gBAAe,MAAM,WAAW;AAElD,KAAI,CAAC,YACH,eAAc,0BAA0B,MAAM;CAGhD,MAAM,UAAoB,EAAE;AAC5B,MAAK,MAAM,QAAQ,MAAM;EACvB,MAAM,MAAM,UAAU;AACtB,MAAI,YACF,eAAc,KAAK,MAAM;MAEzB,WAAU,IAAI;AAEhB,UAAQ,KAAK,IAAI;;AAInB,SAAQ,IACN,kBAAkB,cAAc,qBAAqB,QAAQ,KAAK,KAAK,CAAC,8BAA8B,iBAAiB,QAAQ,KAAK,KAAK,CAAC,2EAC3I;;AAGH,eAAsB,qBAAqB,aAA+C;AACxF,KAAI,EAAE,MAAM,WAAW,EAAE,UAEvB;CAEF,MAAM,uBAAuB,oBAAoB,aAAa,SAAS;AACvE,KAAI,gBAAgB,qBAClB,OAAM,IAAI,MAAM,uBAAuB,EAAC,OAAO,aAAY,CAAC;AAG7D,EAAC,MAAM,SAAS,EAAE,IACjB,uBACA,MAAM,QAAQ,qBAAqB,GAAG,qBAAqB,KAAK,IAAI,GAAG,sBACvE;EACE,UAAU;EACV,MAAM;EACN,QAAQ;EACR,UAAU;EACX,CACF"}