next-sanity 13.3.0 → 13.3.2

package/dist/index.d.ts

@@ -1,10 +1,133 @@
 import { t as isCorsOriginError } from "./isCorsOriginError.js";
 import { createClient, unstable__adapter, unstable__environment } from "@sanity/client";
-import { ClientReturnStega, StegaBranded, StegaCleaned, StegaString, stegaBrand, stegaClean } from "@sanity/client/stega";
+import { ClientReturnStega, StegaBranded, StegaBranded as StegaBranded$1, StegaCleaned, StegaCleaned as StegaCleaned$1, StegaString, stegaBrand, stegaClean } from "@sanity/client/stega";
 import { CreateDataAttribute, CreateDataAttributeProps, createDataAttribute } from "@sanity/visual-editing/create-data-attribute";
+import { InferComponents as InferComponents$1, InferStrictComponents as InferStrictComponents$1, InferValue as InferValue$1 } from "@portabletext/react";
 import groq, { defineQuery } from "groq";
 export * from "@sanity/client";
 export * from "@portabletext/react";
+/**
+ * Widens a query result type to cover both sides of stega branding:
+ * the clean TypeGen shape (`sanityFetch` with `stega: false`) and the
+ * stega-branded shape (`sanityFetch` when stega may be enabled).
+ *
+ * This is what lets the `Infer*` types accept `data` from any `sanityFetch`
+ * call without requiring a wholesale `stegaClean()`, which would strip the
+ * hidden characters Visual Editing needs to make each paragraph clickable.
+ */
+type StegaAware<T> = StegaCleaned$1<T> | StegaBranded$1<T>;
+/**
+ * Infer the Portable Text array value type from
+ * {@link https://www.sanity.io/docs/apis-and-sdks/sanity-typegen | Sanity TypeGen}
+ * generated types.
+ *
+ * Stega-aware version of `InferValue` from `@portabletext/react`: the inferred
+ * value type accepts both clean query results (`sanityFetch` with
+ * `stega: false`) and stega-branded results (`sanityFetch` when stega may be
+ * enabled). Don't clean the value with `stegaClean()` before rendering it,
+ * that strips the hidden characters `@sanity/visual-editing` uses to make each
+ * paragraph clickable. Instead, use `stegaClean` on individual strings at the
+ * point where they're compared against literals.
+ *
+ * Useful when building a re-usable wrapper component that only takes `value`
+ * as an input prop and sets up `components` internally. Pass a TypeGen-
+ * generated query result type that contains Portable Text fields - such as
+ * an individual query result like `PostQueryResult`, or the `SanityQueries`
+ * interface from `@sanity/client` - and `InferValue<T>` returns an array type
+ * containing every Portable Text item shape it can find.
+ *
+ * Always feed `InferValue<T>` query result types, not Sanity schema types.
+ * Schema types describe how content is stored, which can differ from how it
+ * is queried (e.g. references resolved with `->`).
+ *
+ * @example
+ * ```tsx
+ * // Re-usable component typed against every registered query. Relies on
+ * // `overloadClientMethods` being enabled in `sanity.cli.ts#typegen` (the default).
+ * import {
+ *   PortableText,
+ *   type InferStrictComponents,
+ *   type InferValue,
+ *   type SanityQueries,
+ * } from 'next-sanity'
+ *
+ * type PortableTextValue = InferValue<SanityQueries[keyof SanityQueries]>
+ *
+ * export function CustomPortableText(props: {value: PortableTextValue}) {
+ *   const components = {
+ *     types: {
+ *       // custom types are autocompleted and fully typed
+ *     },
+ *   } satisfies InferStrictComponents<PortableTextValue>
+ *
+ *   return <PortableText components={components} value={props.value} />
+ * }
+ * ```
+ *
+ * @example
+ * ```tsx
+ * // Rendering `sanityFetch` results, with or without stega, type-checks:
+ * const {data} = await sanityFetch({query: postQuery, params})
+ * return Array.isArray(data?.content) && <CustomPortableText value={data.content} />
+ * ```
+ */
+type InferValue<T> = InferValue$1<StegaAware<T>>;
+/**
+ * Infer Portable Text components from a value type. This matches the inference
+ * behavior of the `components` prop on `<PortableText>`.
+ *
+ * Stega-aware version of `InferComponents` from `@portabletext/react`: the
+ * inferred component props cover both clean query results (`sanityFetch` with
+ * `stega: false`) and stega-branded results (`sanityFetch` when stega may be
+ * enabled), so the same `components` object can render both. Strings that may
+ * carry stega payloads stay branded inside component props: render them as-is
+ * to keep Visual Editing working, and use `stegaClean` on the individual
+ * values you compare against string literals.
+ *
+ * This is useful when working with
+ * {@link https://www.sanity.io/docs/apis-and-sdks/sanity-typegen | Sanity TypeGen},
+ * where `defineQuery()` and `sanityFetch()` can infer the shape of Portable
+ * Text fields.
+ *
+ * @example
+ * ```tsx
+ * import {PortableText, type InferComponents, defineQuery} from 'next-sanity'
+ * import {sanityFetch} from '@/sanity/lib/live'
+ *
+ * export default async function Page({slug}: {slug: string}) {
+ *   const query = defineQuery(`*[_type == "post" && slug.current == $slug][0]{title,content}`)
+ *   const {data} = await sanityFetch({query, params: {slug}})
+ *   const components = {
+ *     block: {
+ *       // custom types are autocompleted and fully typed
+ *     },
+ *   } satisfies InferComponents<typeof data.content>
+ *
+ *   return (
+ *     <>
+ *       ...
+ *       {Array.isArray(data?.content) && <PortableText components={components} value={data.content} />}
+ *     </>
+ *   )
+ * }
+ * ```
+ */
+type InferComponents<T> = InferComponents$1<StegaAware<T>>;
+/**
+ * Infer Portable Text components from a value type, requiring handlers for all
+ * custom object types and disallowing extra custom object type handlers.
+ *
+ * Stega-aware version of `InferStrictComponents` from `@portabletext/react`,
+ * see {@link InferComponents} for how stega branding is handled.
+ *
+ * This is used the same way as {@link InferComponents}, but serves a different
+ * purpose: `InferComponents` is forgiving and mirrors the inline
+ * `<PortableText components={...} />` experience, allowing custom handlers to
+ * be omitted and allowing handlers for types that do not exist in, or could not
+ * be inferred from, the value type. `InferStrictComponents` is strict: it
+ * requires inferred custom handlers and rejects unknown ones.
+ */
+type InferStrictComponents<T> = InferStrictComponents$1<StegaAware<T>>;
 /**
  * API version required for editing variants queries.
  * Uses the `X` alias while variants are in beta; will move to a dated version when stable.
@@ -12,5 +135,5 @@ export * from "@portabletext/react";
  * @public
  */
 declare const variantsApiVersion = "X";
-export { type ClientReturnStega, type CreateDataAttribute, type CreateDataAttributeProps, type StegaBranded, type StegaCleaned, type StegaString, createClient, createDataAttribute, defineQuery, groq, isCorsOriginError, stegaBrand, stegaClean, unstable__adapter, unstable__environment, variantsApiVersion };
+export { type ClientReturnStega, type CreateDataAttribute, type CreateDataAttributeProps, type InferComponents, type InferStrictComponents, type InferValue, type StegaBranded, type StegaCleaned, type StegaString, createClient, createDataAttribute, defineQuery, groq, isCorsOriginError, stegaBrand, stegaClean, unstable__adapter, unstable__environment, variantsApiVersion };
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","names":[],"sources":["../src/variants/constants.ts"],"mappings":";;;;;;;;;;;;;cAMa"}
+{"version":3,"file":"index.d.ts","names":[],"sources":["../src/portable-text.ts","../src/variants/constants.ts"],"mappings":";;;;;;;;;;;;;;;;;KAgBK,WAAW,KAAK,eAAa,KAAK,eAAa;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;KAyDxC,WAAW,KAAK,aAAuB,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;KA0ClD,gBAAgB,KAAK,kBAA4B,WAAW;;;;;;;;;;;;;;;KAgB5D,sBAAsB,KAAK,wBAAkC,WAAW;;;;;;;cC7HvE"}

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

@@ -29,6 +29,7 @@ import { n as resolveVariantFromCookies$1, r as resolvePerspectiveFromCookies$1,
  *   resolvePerspectiveFromCookies,
  *   resolveVariantFromCookies,
  *   type LivePerspective,
+ *   type StrictDefinedFetchType,
  * } from 'next-sanity/live'
  *
  * const client = createClient({
@@ -46,6 +47,14 @@ import { n as resolveVariantFromCookies$1, r as resolvePerspectiveFromCookies$1,
  *   strict: true,
  * })
  *
+ * // The app's one shared 'use cache' boundary. `sanityFetch` calls
+ * // `cacheTag`/`cacheLife` internally but doesn't create the boundary —
+ * // this wrapper provides it once, so callers don't add their own.
+ * export const cachedSanity: StrictDefinedFetchType = async (options) => {
+ *   'use cache'
+ *   return sanityFetch(options)
+ * }
+ *
  * export interface DynamicFetchOptions {
  *   perspective: LivePerspective
  *   variant?: string
@@ -96,8 +105,8 @@ import { n as resolveVariantFromCookies$1, r as resolvePerspectiveFromCookies$1,
  * import {defineQuery} from 'next-sanity'
  *
  * import {
+ *   cachedSanity,
  *   getDynamicFetchOptions,
- *   sanityFetch,
  *   type DynamicFetchOptions,
  * } from '@/sanity/live'
  *
@@ -109,7 +118,7 @@ import { n as resolveVariantFromCookies$1, r as resolvePerspectiveFromCookies$1,
  * `)
  *
  * export async function generateStaticParams() {
- *   const {data} = await sanityFetch({
+ *   const {data} = await cachedSanity({
  *     query: POSTS_SLUGS_QUERY,
  *     perspective: 'published',
  *     stega: false,
@@ -145,9 +154,7 @@ import { n as resolveVariantFromCookies$1, r as resolvePerspectiveFromCookies$1,
  *   variant,
  *   stega,
  * }: {slug: string} & DynamicFetchOptions) {
- *   'use cache'
- *
- *   const {data} = await sanityFetch({
+ *   const {data} = await cachedSanity({
  *     query: POST_QUERY,
  *     params: {slug},
  *     perspective,
@@ -264,11 +271,11 @@ declare function defineLive(config: DefineLiveOptions & {
  * import {cookies, draftMode} from 'next/headers'
  * import {defineQuery} from 'next-sanity'
  * import {resolvePerspectiveFromCookies, type LivePerspective} from 'next-sanity/live'
- * import {sanityFetch, sanityFetchStaticParams} from '#sanity/live'
+ * import {cachedSanity, cachedSanityStaticParams} from '#sanity/live'
  *
  * export async function generateStaticParams() {
  *   const query = defineQuery(`*[_type == "page" && defined(slug.current)]{"slug": slug.current}`)
- *   return await sanityFetchStaticParams({query})
+ *   return await cachedSanityStaticParams({query})
  * }
  *
  * export default async function Page({params}: PageProps<'/[slug]'>) {
@@ -302,10 +309,8 @@ declare function defineLive(config: DefineLiveOptions & {
  *   perspective: LivePerspective
  *   stega: boolean
  * }) {
- *   'use cache'
- *
  *   const query = defineQuery(`*[_type == "page" && slug.current == $slug][0]`)
- *   const {data} = await sanityFetch({query, params: {slug}, perspective, stega})
+ *   const {data} = await cachedSanity({query, params: {slug}, perspective, stega})
  *
  *   return <article>...</article>
  * }
@@ -332,7 +337,7 @@ declare const resolvePerspectiveFromCookies: typeof resolvePerspectiveFromCookie
  *   resolveVariantFromCookies,
  *   type LivePerspective,
  * } from 'next-sanity/live'
- * import {sanityFetch} from '#sanity/live'
+ * import {cachedSanity} from '#sanity/live'
  *
  * export default async function Page({params}: PageProps<'/[slug]'>) {
  *   const {isEnabled: isDraftMode} = await draftMode()
@@ -369,10 +374,8 @@ declare const resolvePerspectiveFromCookies: typeof resolvePerspectiveFromCookie
  *   variant: string | undefined
  *   stega: boolean
  * }) {
- *   'use cache'
- *
  *   const query = defineQuery(`*[_type == "page" && slug.current == $slug][0]`)
- *   const {data} = await sanityFetch({query, params: {slug}, perspective, variant, stega})
+ *   const {data} = await cachedSanity({query, params: {slug}, perspective, variant, stega})
  *
  *   return <article>...</article>
  * }

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":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBA0KgB,WAAW,QAAQ;EAAqB;;EACtD,aAAa;EACb,YAAY,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAmFlB,WAAW,QAAQ;EAAqB;;EACtD,aAAa;EACb,YAAY,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;cAoFrB,sCAAsC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;cAsEtC,kCAAkC"}
+{"version":3,"file":"index.d.ts","names":[],"sources":["../../../../src/live/conditions/default/index.ts"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAiLgB,WAAW,QAAQ;EAAqB;;EACtD,aAAa;EACb,YAAY,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAmFlB,WAAW,QAAQ;EAAqB;;EACtD,aAAa;EACb,YAAY,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;cAkFrB,sCAAsC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;cAoEtC,kCAAkC"}

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

@@ -13,11 +13,11 @@ function defineLive(_config) {
 * import {cookies, draftMode} from 'next/headers'
 * import {defineQuery} from 'next-sanity'
 * import {resolvePerspectiveFromCookies, type LivePerspective} from 'next-sanity/live'
-* import {sanityFetch, sanityFetchStaticParams} from '#sanity/live'
+* import {cachedSanity, cachedSanityStaticParams} from '#sanity/live'
 *
 * export async function generateStaticParams() {
 *   const query = defineQuery(`*[_type == "page" && defined(slug.current)]{"slug": slug.current}`)
-*   return await sanityFetchStaticParams({query})
+*   return await cachedSanityStaticParams({query})
 * }
 *
 * export default async function Page({params}: PageProps<'/[slug]'>) {
@@ -51,10 +51,8 @@ function defineLive(_config) {
 *   perspective: LivePerspective
 *   stega: boolean
 * }) {
-*   'use cache'
-*
 *   const query = defineQuery(`*[_type == "page" && slug.current == $slug][0]`)
-*   const {data} = await sanityFetch({query, params: {slug}, perspective, stega})
+*   const {data} = await cachedSanity({query, params: {slug}, perspective, stega})
 *
 *   return <article>...</article>
 * }
@@ -83,7 +81,7 @@ const resolvePerspectiveFromCookies = () => {
 *   resolveVariantFromCookies,
 *   type LivePerspective,
 * } from 'next-sanity/live'
-* import {sanityFetch} from '#sanity/live'
+* import {cachedSanity} from '#sanity/live'
 *
 * export default async function Page({params}: PageProps<'/[slug]'>) {
 *   const {isEnabled: isDraftMode} = await draftMode()
@@ -120,10 +118,8 @@ const resolvePerspectiveFromCookies = () => {
 *   variant: string | undefined
 *   stega: boolean
 * }) {
-*   'use cache'
-*
 *   const query = defineQuery(`*[_type == "page" && slug.current == $slug][0]`)
-*   const {data} = await sanityFetch({query, params: {slug}, perspective, variant, stega})
+*   const {data} = await cachedSanity({query, params: {slug}, perspective, variant, stega})
 *
 *   return <article>...</article>
 * }

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 {resolvePerspectiveFromCookies as _resolvePerspectiveFromCookies} from '#live/resolvePerspectiveFromCookies'\nimport type {resolveVariantFromCookies as _resolveVariantFromCookies} from '#live/resolveVariantFromCookies'\nimport type {\n  DefinedFetchType,\n  DefinedLiveProps,\n  DefineLiveOptions,\n  StrictDefinedFetchType,\n  StrictDefinedLiveProps,\n} from '#live/types'\n\n/**\n * Set up Sanity Live for Cache Components. `defineLive` returns `sanityFetch`\n * and `<SanityLive />`, which connect your Sanity client to the Live Content API\n * so cached pages can update in response to fine-grained content changes.\n *\n * With `strict: true`, `perspective` and `stega` become required\n * `sanityFetch` options, and `includeDrafts` becomes required on\n * `<SanityLive />`. Resolve dynamic values from `draftMode()` and `cookies()`\n * outside `'use cache'` boundaries, then pass them into cached components.\n *\n * `sanityFetch` brands `data` with stega string types when `stega` is `true`,\n * a non-literal `boolean`, or omitted (react-server may auto-enable stega).\n * Pass the literal `stega: false` for clean TypeGen types. Use `stegaClean`\n * before comparing branded strings to literals.\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 * // sanity/live.ts\n * import {cookies, draftMode} from 'next/headers'\n * import {createClient} from 'next-sanity'\n * import {\n *   defineLive,\n *   resolvePerspectiveFromCookies,\n *   resolveVariantFromCookies,\n *   type LivePerspective,\n * } 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 *   strict: true,\n * })\n *\n * export interface DynamicFetchOptions {\n *   perspective: LivePerspective\n *   variant?: string\n *   // `boolean` brands `sanityFetch` `data`; use literal `false` for clean types\n *   stega: boolean\n * }\n *\n * // Resolve dynamic values outside 'use cache' boundaries.\n * export async function getDynamicFetchOptions(): Promise<DynamicFetchOptions> {\n *   const {isEnabled: isDraftMode} = await draftMode()\n *   if (!isDraftMode) {\n *     return {perspective: 'published', stega: false}\n *   }\n *\n *   const jar = await cookies()\n *   const perspective = await resolvePerspectiveFromCookies({cookies: jar})\n *   const variant = await resolveVariantFromCookies({cookies: jar})\n *   return {perspective: perspective ?? 'drafts', variant, stega: true}\n * }\n * ```\n *\n * @example\n * ```tsx\n * // app/layout.tsx\n * import {draftMode} from 'next/headers'\n *\n * import {SanityLive} from '@/sanity/live'\n *\n * export default async function RootLayout({children}: {children: React.ReactNode}) {\n *   const {isEnabled: isDraftMode} = await draftMode()\n *\n *   return (\n *     <html lang=\"en\">\n *       <body>\n *         {children}\n *         <SanityLive includeDrafts={isDraftMode} />\n *       </body>\n *     </html>\n *   )\n * }\n * ```\n *\n * @example\n * ```tsx\n * // app/[slug]/page.tsx\n * import {draftMode} from 'next/headers'\n * import {Suspense} from 'react'\n * import {defineQuery} from 'next-sanity'\n *\n * import {\n *   getDynamicFetchOptions,\n *   sanityFetch,\n *   type DynamicFetchOptions,\n * } 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 {isEnabled: isDraftMode} = await draftMode()\n *   if (isDraftMode) {\n *     return (\n *       <Suspense fallback={<div>Loading...</div>}>\n *         <DynamicPage params={props.params} />\n *       </Suspense>\n *     )\n *   }\n *\n *   const {slug} = await props.params\n *   return <CachedPage slug={slug} perspective=\"published\" stega={false} />\n * }\n *\n * async function DynamicPage(props: Pick<PageProps<'/[slug]'>, 'params'>) {\n *   const {slug} = await props.params\n *   const {perspective, variant, stega} = await getDynamicFetchOptions()\n *\n *   return <CachedPage slug={slug} perspective={perspective} variant={variant} stega={stega} />\n * }\n *\n * async function CachedPage({\n *   slug,\n *   perspective,\n *   variant,\n *   stega,\n * }: {slug: string} & DynamicFetchOptions) {\n *   'use cache'\n *\n *   const {data} = await sanityFetch({\n *     query: POST_QUERY,\n *     params: {slug},\n *     perspective,\n *     variant,\n *     stega,\n *   })\n *\n *   return <pre>{JSON.stringify(data, null, 2)}</pre>\n * }\n * ```\n *\n * @public\n */\nexport function defineLive(config: DefineLiveOptions & {strict: true}): {\n  sanityFetch: StrictDefinedFetchType\n  SanityLive: React.ComponentType<StrictDefinedLiveProps>\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 & {strict?: false}): {\n  sanityFetch: DefinedFetchType\n  SanityLive: React.ComponentType<DefinedLiveProps>\n}\nexport function defineLive(_config: DefineLiveOptions): never {\n  throw new Error(`defineLive can't be imported by a client component`)\n}\n\nexport type {\n  DefinedFetchType,\n  DefinedLiveProps,\n  DefineLiveOptions,\n  LivePerspective,\n  SanityLiveAction,\n  SanityLiveContext,\n  SanityLiveOnError,\n  SanityLiveOnGoaway,\n  SanityLiveOnReconnect,\n  SanityLiveOnRestart,\n  SanityLiveOnWelcome,\n  StrictDefinedFetchType,\n  StrictDefinedLiveProps,\n} from '#live/types'\n\nexport {isCorsOriginError} from '#live/isCorsOriginError'\nexport {parseTags} from '#live/parseTags'\n\n/**\n * This helper is intended for use with Next.js Cache Components (`cacheComponents: true`),\n * where `cookies()` and `draftMode()` cannot be called inside `'use cache'` boundaries.\n * Resolve the perspective once outside the cache boundary and pass it in as a prop / cache key.\n *\n * @example\n * ```tsx\n * import {cookies, draftMode} from 'next/headers'\n * import {defineQuery} from 'next-sanity'\n * import {resolvePerspectiveFromCookies, type LivePerspective} from 'next-sanity/live'\n * import {sanityFetch, sanityFetchStaticParams} from '#sanity/live'\n *\n * export async function generateStaticParams() {\n *   const query = defineQuery(`*[_type == \"page\" && defined(slug.current)]{\"slug\": slug.current}`)\n *   return await sanityFetchStaticParams({query})\n * }\n *\n * export default async function Page({params}: PageProps<'/[slug]'>) {\n *   const {isEnabled: isDraftMode} = await draftMode()\n *\n *   if (isDraftMode) {\n *     return (\n *       <Suspense>\n *         <DynamicPage params={params} />\n *       </Suspense>\n *     )\n *   }\n *\n *   const {slug} = await params\n *\n *   return <CachedPage slug={slug} perspective=\"published\" stega={false} />\n * }\n *\n * async function DynamicPage({params}: Pick<PageProps<'/[slug]'>, 'params'>) {\n *   const {slug} = await params\n *   const perspective = await resolvePerspectiveFromCookies({cookies: await cookies()})\n *\n *   return <CachedPage slug={slug} perspective={perspective} stega />\n * }\n *\n * async function CachedPage({\n *   slug,\n *   perspective,\n *   stega,\n * }: Awaited<PageProps<'/[slug]'>['params']> & {\n *   perspective: LivePerspective\n *   stega: boolean\n * }) {\n *   'use cache'\n *\n *   const query = defineQuery(`*[_type == \"page\" && slug.current == $slug][0]`)\n *   const {data} = await sanityFetch({query, params: {slug}, perspective, stega})\n *\n *   return <article>...</article>\n * }\n * ```\n *\n * @public\n */\nexport const resolvePerspectiveFromCookies: typeof _resolvePerspectiveFromCookies = () => {\n  throw new Error(`resolvePerspectiveFromCookies can't be imported by a client component`)\n}\n\n/**\n * This helper is intended for use with Next.js Cache Components (`cacheComponents: true`),\n * where `cookies()` and `draftMode()` cannot be called inside `'use cache'` boundaries.\n * Resolve the variant once outside the cache boundary and pass it in as a prop / cache key.\n *\n * Unlike `resolvePerspectiveFromCookies` there is no fallback value: when no\n * variant cookie is set (or its value is invalid) it resolves to `undefined`,\n * meaning \"no variant selected\" and queries return base content.\n *\n * @example\n * ```tsx\n * import {cookies, draftMode} from 'next/headers'\n * import {defineQuery} from 'next-sanity'\n * import {\n *   resolvePerspectiveFromCookies,\n *   resolveVariantFromCookies,\n *   type LivePerspective,\n * } from 'next-sanity/live'\n * import {sanityFetch} from '#sanity/live'\n *\n * export default async function Page({params}: PageProps<'/[slug]'>) {\n *   const {isEnabled: isDraftMode} = await draftMode()\n *\n *   if (isDraftMode) {\n *     return (\n *       <Suspense>\n *         <DynamicPage params={params} />\n *       </Suspense>\n *     )\n *   }\n *\n *   const {slug} = await params\n *\n *   return <CachedPage slug={slug} perspective=\"published\" stega={false} />\n * }\n *\n * async function DynamicPage({params}: Pick<PageProps<'/[slug]'>, 'params'>) {\n *   const {slug} = await params\n *   const jar = await cookies()\n *   const perspective = await resolvePerspectiveFromCookies({cookies: jar})\n *   const variant = await resolveVariantFromCookies({cookies: jar})\n *\n *   return <CachedPage slug={slug} perspective={perspective} variant={variant} stega />\n * }\n *\n * async function CachedPage({\n *   slug,\n *   perspective,\n *   variant,\n *   stega,\n * }: Awaited<PageProps<'/[slug]'>['params']> & {\n *   perspective: LivePerspective\n *   variant: string | undefined\n *   stega: boolean\n * }) {\n *   'use cache'\n *\n *   const query = defineQuery(`*[_type == \"page\" && slug.current == $slug][0]`)\n *   const {data} = await sanityFetch({query, params: {slug}, perspective, variant, stega})\n *\n *   return <article>...</article>\n * }\n * ```\n *\n * @public\n */\nexport const resolveVariantFromCookies: typeof _resolveVariantFromCookies = () => {\n  throw new Error(`resolveVariantFromCookies can't be imported by a client component`)\n}\n"],"mappings":";;AAmQA,SAAgB,WAAW,SAAmC;CAC5D,MAAM,IAAI,MAAM,oDAAoD;AACtE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAgFA,MAAa,sCAA6E;CACxF,MAAM,IAAI,MAAM,uEAAuE;AACzF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAoEA,MAAa,kCAAqE;CAChF,MAAM,IAAI,MAAM,mEAAmE;AACrF"}
+{"version":3,"file":"index.js","names":[],"sources":["../../../../src/live/conditions/default/index.ts"],"sourcesContent":["import type {resolvePerspectiveFromCookies as _resolvePerspectiveFromCookies} from '#live/resolvePerspectiveFromCookies'\nimport type {resolveVariantFromCookies as _resolveVariantFromCookies} from '#live/resolveVariantFromCookies'\nimport type {\n  DefinedFetchType,\n  DefinedLiveProps,\n  DefineLiveOptions,\n  StrictDefinedFetchType,\n  StrictDefinedLiveProps,\n} from '#live/types'\n\n/**\n * Set up Sanity Live for Cache Components. `defineLive` returns `sanityFetch`\n * and `<SanityLive />`, which connect your Sanity client to the Live Content API\n * so cached pages can update in response to fine-grained content changes.\n *\n * With `strict: true`, `perspective` and `stega` become required\n * `sanityFetch` options, and `includeDrafts` becomes required on\n * `<SanityLive />`. Resolve dynamic values from `draftMode()` and `cookies()`\n * outside `'use cache'` boundaries, then pass them into cached components.\n *\n * `sanityFetch` brands `data` with stega string types when `stega` is `true`,\n * a non-literal `boolean`, or omitted (react-server may auto-enable stega).\n * Pass the literal `stega: false` for clean TypeGen types. Use `stegaClean`\n * before comparing branded strings to literals.\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 * // sanity/live.ts\n * import {cookies, draftMode} from 'next/headers'\n * import {createClient} from 'next-sanity'\n * import {\n *   defineLive,\n *   resolvePerspectiveFromCookies,\n *   resolveVariantFromCookies,\n *   type LivePerspective,\n *   type StrictDefinedFetchType,\n * } 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 *   strict: true,\n * })\n *\n * // The app's one shared 'use cache' boundary. `sanityFetch` calls\n * // `cacheTag`/`cacheLife` internally but doesn't create the boundary —\n * // this wrapper provides it once, so callers don't add their own.\n * export const cachedSanity: StrictDefinedFetchType = async (options) => {\n *   'use cache'\n *   return sanityFetch(options)\n * }\n *\n * export interface DynamicFetchOptions {\n *   perspective: LivePerspective\n *   variant?: string\n *   // `boolean` brands `sanityFetch` `data`; use literal `false` for clean types\n *   stega: boolean\n * }\n *\n * // Resolve dynamic values outside 'use cache' boundaries.\n * export async function getDynamicFetchOptions(): Promise<DynamicFetchOptions> {\n *   const {isEnabled: isDraftMode} = await draftMode()\n *   if (!isDraftMode) {\n *     return {perspective: 'published', stega: false}\n *   }\n *\n *   const jar = await cookies()\n *   const perspective = await resolvePerspectiveFromCookies({cookies: jar})\n *   const variant = await resolveVariantFromCookies({cookies: jar})\n *   return {perspective: perspective ?? 'drafts', variant, stega: true}\n * }\n * ```\n *\n * @example\n * ```tsx\n * // app/layout.tsx\n * import {draftMode} from 'next/headers'\n *\n * import {SanityLive} from '@/sanity/live'\n *\n * export default async function RootLayout({children}: {children: React.ReactNode}) {\n *   const {isEnabled: isDraftMode} = await draftMode()\n *\n *   return (\n *     <html lang=\"en\">\n *       <body>\n *         {children}\n *         <SanityLive includeDrafts={isDraftMode} />\n *       </body>\n *     </html>\n *   )\n * }\n * ```\n *\n * @example\n * ```tsx\n * // app/[slug]/page.tsx\n * import {draftMode} from 'next/headers'\n * import {Suspense} from 'react'\n * import {defineQuery} from 'next-sanity'\n *\n * import {\n *   cachedSanity,\n *   getDynamicFetchOptions,\n *   type DynamicFetchOptions,\n * } 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 cachedSanity({\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 {isEnabled: isDraftMode} = await draftMode()\n *   if (isDraftMode) {\n *     return (\n *       <Suspense fallback={<div>Loading...</div>}>\n *         <DynamicPage params={props.params} />\n *       </Suspense>\n *     )\n *   }\n *\n *   const {slug} = await props.params\n *   return <CachedPage slug={slug} perspective=\"published\" stega={false} />\n * }\n *\n * async function DynamicPage(props: Pick<PageProps<'/[slug]'>, 'params'>) {\n *   const {slug} = await props.params\n *   const {perspective, variant, stega} = await getDynamicFetchOptions()\n *\n *   return <CachedPage slug={slug} perspective={perspective} variant={variant} stega={stega} />\n * }\n *\n * async function CachedPage({\n *   slug,\n *   perspective,\n *   variant,\n *   stega,\n * }: {slug: string} & DynamicFetchOptions) {\n *   const {data} = await cachedSanity({\n *     query: POST_QUERY,\n *     params: {slug},\n *     perspective,\n *     variant,\n *     stega,\n *   })\n *\n *   return <pre>{JSON.stringify(data, null, 2)}</pre>\n * }\n * ```\n *\n * @public\n */\nexport function defineLive(config: DefineLiveOptions & {strict: true}): {\n  sanityFetch: StrictDefinedFetchType\n  SanityLive: React.ComponentType<StrictDefinedLiveProps>\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 & {strict?: false}): {\n  sanityFetch: DefinedFetchType\n  SanityLive: React.ComponentType<DefinedLiveProps>\n}\nexport function defineLive(_config: DefineLiveOptions): never {\n  throw new Error(`defineLive can't be imported by a client component`)\n}\n\nexport type {\n  DefinedFetchType,\n  DefinedLiveProps,\n  DefineLiveOptions,\n  LivePerspective,\n  SanityLiveAction,\n  SanityLiveContext,\n  SanityLiveOnError,\n  SanityLiveOnGoaway,\n  SanityLiveOnReconnect,\n  SanityLiveOnRestart,\n  SanityLiveOnWelcome,\n  StrictDefinedFetchType,\n  StrictDefinedLiveProps,\n} from '#live/types'\n\nexport {isCorsOriginError} from '#live/isCorsOriginError'\nexport {parseTags} from '#live/parseTags'\n\n/**\n * This helper is intended for use with Next.js Cache Components (`cacheComponents: true`),\n * where `cookies()` and `draftMode()` cannot be called inside `'use cache'` boundaries.\n * Resolve the perspective once outside the cache boundary and pass it in as a prop / cache key.\n *\n * @example\n * ```tsx\n * import {cookies, draftMode} from 'next/headers'\n * import {defineQuery} from 'next-sanity'\n * import {resolvePerspectiveFromCookies, type LivePerspective} from 'next-sanity/live'\n * import {cachedSanity, cachedSanityStaticParams} from '#sanity/live'\n *\n * export async function generateStaticParams() {\n *   const query = defineQuery(`*[_type == \"page\" && defined(slug.current)]{\"slug\": slug.current}`)\n *   return await cachedSanityStaticParams({query})\n * }\n *\n * export default async function Page({params}: PageProps<'/[slug]'>) {\n *   const {isEnabled: isDraftMode} = await draftMode()\n *\n *   if (isDraftMode) {\n *     return (\n *       <Suspense>\n *         <DynamicPage params={params} />\n *       </Suspense>\n *     )\n *   }\n *\n *   const {slug} = await params\n *\n *   return <CachedPage slug={slug} perspective=\"published\" stega={false} />\n * }\n *\n * async function DynamicPage({params}: Pick<PageProps<'/[slug]'>, 'params'>) {\n *   const {slug} = await params\n *   const perspective = await resolvePerspectiveFromCookies({cookies: await cookies()})\n *\n *   return <CachedPage slug={slug} perspective={perspective} stega />\n * }\n *\n * async function CachedPage({\n *   slug,\n *   perspective,\n *   stega,\n * }: Awaited<PageProps<'/[slug]'>['params']> & {\n *   perspective: LivePerspective\n *   stega: boolean\n * }) {\n *   const query = defineQuery(`*[_type == \"page\" && slug.current == $slug][0]`)\n *   const {data} = await cachedSanity({query, params: {slug}, perspective, stega})\n *\n *   return <article>...</article>\n * }\n * ```\n *\n * @public\n */\nexport const resolvePerspectiveFromCookies: typeof _resolvePerspectiveFromCookies = () => {\n  throw new Error(`resolvePerspectiveFromCookies can't be imported by a client component`)\n}\n\n/**\n * This helper is intended for use with Next.js Cache Components (`cacheComponents: true`),\n * where `cookies()` and `draftMode()` cannot be called inside `'use cache'` boundaries.\n * Resolve the variant once outside the cache boundary and pass it in as a prop / cache key.\n *\n * Unlike `resolvePerspectiveFromCookies` there is no fallback value: when no\n * variant cookie is set (or its value is invalid) it resolves to `undefined`,\n * meaning \"no variant selected\" and queries return base content.\n *\n * @example\n * ```tsx\n * import {cookies, draftMode} from 'next/headers'\n * import {defineQuery} from 'next-sanity'\n * import {\n *   resolvePerspectiveFromCookies,\n *   resolveVariantFromCookies,\n *   type LivePerspective,\n * } from 'next-sanity/live'\n * import {cachedSanity} from '#sanity/live'\n *\n * export default async function Page({params}: PageProps<'/[slug]'>) {\n *   const {isEnabled: isDraftMode} = await draftMode()\n *\n *   if (isDraftMode) {\n *     return (\n *       <Suspense>\n *         <DynamicPage params={params} />\n *       </Suspense>\n *     )\n *   }\n *\n *   const {slug} = await params\n *\n *   return <CachedPage slug={slug} perspective=\"published\" stega={false} />\n * }\n *\n * async function DynamicPage({params}: Pick<PageProps<'/[slug]'>, 'params'>) {\n *   const {slug} = await params\n *   const jar = await cookies()\n *   const perspective = await resolvePerspectiveFromCookies({cookies: jar})\n *   const variant = await resolveVariantFromCookies({cookies: jar})\n *\n *   return <CachedPage slug={slug} perspective={perspective} variant={variant} stega />\n * }\n *\n * async function CachedPage({\n *   slug,\n *   perspective,\n *   variant,\n *   stega,\n * }: Awaited<PageProps<'/[slug]'>['params']> & {\n *   perspective: LivePerspective\n *   variant: string | undefined\n *   stega: boolean\n * }) {\n *   const query = defineQuery(`*[_type == \"page\" && slug.current == $slug][0]`)\n *   const {data} = await cachedSanity({query, params: {slug}, perspective, variant, stega})\n *\n *   return <article>...</article>\n * }\n * ```\n *\n * @public\n */\nexport const resolveVariantFromCookies: typeof _resolveVariantFromCookies = () => {\n  throw new Error(`resolveVariantFromCookies can't be imported by a client component`)\n}\n"],"mappings":";;AA0QA,SAAgB,WAAW,SAAmC;CAC5D,MAAM,IAAI,MAAM,oDAAoD;AACtE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA8EA,MAAa,sCAA6E;CACxF,MAAM,IAAI,MAAM,uEAAuE;AACzF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAkEA,MAAa,kCAAqE;CAChF,MAAM,IAAI,MAAM,mEAAmE;AACrF"}

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

@@ -29,6 +29,7 @@ import { n as resolveVariantFromCookies, r as resolvePerspectiveFromCookies, t a
  *   resolvePerspectiveFromCookies,
  *   resolveVariantFromCookies,
  *   type LivePerspective,
+ *   type StrictDefinedFetchType,
  * } from 'next-sanity/live'
  *
  * const client = createClient({
@@ -46,6 +47,14 @@ import { n as resolveVariantFromCookies, r as resolvePerspectiveFromCookies, t a
  *   strict: true,
  * })
  *
+ * // The app's one shared 'use cache' boundary. `sanityFetch` calls
+ * // `cacheTag`/`cacheLife` internally but doesn't create the boundary —
+ * // this wrapper provides it once, so callers don't add their own.
+ * export const cachedSanity: StrictDefinedFetchType = async (options) => {
+ *   'use cache'
+ *   return sanityFetch(options)
+ * }
+ *
  * export interface DynamicFetchOptions {
  *   perspective: LivePerspective
  *   variant?: string
@@ -96,8 +105,8 @@ import { n as resolveVariantFromCookies, r as resolvePerspectiveFromCookies, t a
  * import {defineQuery} from 'next-sanity'
  *
  * import {
+ *   cachedSanity,
  *   getDynamicFetchOptions,
- *   sanityFetch,
  *   type DynamicFetchOptions,
  * } from '@/sanity/live'
  *
@@ -109,7 +118,7 @@ import { n as resolveVariantFromCookies, r as resolvePerspectiveFromCookies, t a
  * `)
  *
  * export async function generateStaticParams() {
- *   const {data} = await sanityFetch({
+ *   const {data} = await cachedSanity({
  *     query: POSTS_SLUGS_QUERY,
  *     perspective: 'published',
  *     stega: false,
@@ -145,9 +154,7 @@ import { n as resolveVariantFromCookies, r as resolvePerspectiveFromCookies, t a
  *   variant,
  *   stega,
  * }: {slug: string} & DynamicFetchOptions) {
- *   'use cache'
- *
- *   const {data} = await sanityFetch({
+ *   const {data} = await cachedSanity({
  *     query: POST_QUERY,
  *     params: {slug},
  *     perspective,

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/defineLive.tsx"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAiLgB,WAAW,QAAQ;EAAqB;;EACtD,aAAa;EACb,YAAY,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAmFlB,WAAW,QAAQ;EAAqB;;EACtD,aAAa;EACb,YAAY,MAAM,cAAc"}
+{"version":3,"file":"index.d.ts","names":[],"sources":["../../../../src/live/conditions/next-js/defineLive.tsx"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAwLgB,WAAW,QAAQ;EAAqB;;EACtD,aAAa;EACb,YAAY,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAmFlB,WAAW,QAAQ;EAAqB;;EACtD,aAAa;EACb,YAAY,MAAM,cAAc"}

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

@@ -1 +1 @@
-{"version":3,"file":"index.js","names":["sanityCacheLife","SanityLive","SanityLiveClientComponent"],"sources":["../../../../src/live/conditions/next-js/defineLive.tsx"],"sourcesContent":["import {sanity as sanityCacheLife} from 'next-sanity/live/cache-life'\nimport {SanityLive as SanityLiveClientComponent} from 'next-sanity/live/client-components'\nimport {revalidateSyncTagsAction} from 'next-sanity/live/server-actions'\nimport {cacheLife, cacheTag} from 'next/cache'\nimport {PHASE_PRODUCTION_BUILD} from 'next/constants'\n\nimport {cacheTagPrefix, defaultApiHost} from '#live/constants'\nimport {preconnect} from '#live/preconnect'\nimport {validateStrictFetchOptions, validateStrictSanityLiveProps} from '#live/strictValidation'\nimport type {\n  DefinedFetchType,\n  DefinedLiveProps,\n  DefineLiveOptions,\n  StrictDefinedFetchType,\n  StrictDefinedLiveProps,\n} from '#live/types'\n\n/**\n * Set up Sanity Live for Cache Components. `defineLive` returns `sanityFetch`\n * and `<SanityLive />`, which connect your Sanity client to the Live Content API\n * so cached pages can update in response to fine-grained content changes.\n *\n * With `strict: true`, `perspective` and `stega` become required\n * `sanityFetch` options, and `includeDrafts` becomes required on\n * `<SanityLive />`. Resolve dynamic values from `draftMode()` and `cookies()`\n * outside `'use cache'` boundaries, then pass them into cached components.\n *\n * `sanityFetch` brands `data` with stega string types when `stega` is `true`,\n * a non-literal `boolean`, or omitted (react-server may auto-enable stega).\n * Pass the literal `stega: false` for clean TypeGen types. Use `stegaClean`\n * before comparing branded strings to literals.\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 * // sanity/live.ts\n * import {cookies, draftMode} from 'next/headers'\n * import {createClient} from 'next-sanity'\n * import {\n *   defineLive,\n *   resolvePerspectiveFromCookies,\n *   resolveVariantFromCookies,\n *   type LivePerspective,\n * } 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 *   strict: true,\n * })\n *\n * export interface DynamicFetchOptions {\n *   perspective: LivePerspective\n *   variant?: string\n *   // `boolean` brands `sanityFetch` `data`; use literal `false` for clean types\n *   stega: boolean\n * }\n *\n * // Resolve dynamic values outside 'use cache' boundaries.\n * export async function getDynamicFetchOptions(): Promise<DynamicFetchOptions> {\n *   const {isEnabled: isDraftMode} = await draftMode()\n *   if (!isDraftMode) {\n *     return {perspective: 'published', stega: false}\n *   }\n *\n *   const jar = await cookies()\n *   const perspective = await resolvePerspectiveFromCookies({cookies: jar})\n *   const variant = await resolveVariantFromCookies({cookies: jar})\n *   return {perspective: perspective ?? 'drafts', variant, stega: true}\n * }\n * ```\n *\n * @example\n * ```tsx\n * // app/layout.tsx\n * import {draftMode} from 'next/headers'\n *\n * import {SanityLive} from '@/sanity/live'\n *\n * export default async function RootLayout({children}: {children: React.ReactNode}) {\n *   const {isEnabled: isDraftMode} = await draftMode()\n *\n *   return (\n *     <html lang=\"en\">\n *       <body>\n *         {children}\n *         <SanityLive includeDrafts={isDraftMode} />\n *       </body>\n *     </html>\n *   )\n * }\n * ```\n *\n * @example\n * ```tsx\n * // app/[slug]/page.tsx\n * import {draftMode} from 'next/headers'\n * import {Suspense} from 'react'\n * import {defineQuery} from 'next-sanity'\n *\n * import {\n *   getDynamicFetchOptions,\n *   sanityFetch,\n *   type DynamicFetchOptions,\n * } 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 {isEnabled: isDraftMode} = await draftMode()\n *   if (isDraftMode) {\n *     return (\n *       <Suspense fallback={<div>Loading...</div>}>\n *         <DynamicPage params={props.params} />\n *       </Suspense>\n *     )\n *   }\n *\n *   const {slug} = await props.params\n *   return <CachedPage slug={slug} perspective=\"published\" stega={false} />\n * }\n *\n * async function DynamicPage(props: Pick<PageProps<'/[slug]'>, 'params'>) {\n *   const {slug} = await props.params\n *   const {perspective, variant, stega} = await getDynamicFetchOptions()\n *\n *   return <CachedPage slug={slug} perspective={perspective} variant={variant} stega={stega} />\n * }\n *\n * async function CachedPage({\n *   slug,\n *   perspective,\n *   variant,\n *   stega,\n * }: {slug: string} & DynamicFetchOptions) {\n *   'use cache'\n *\n *   const {data} = await sanityFetch({\n *     query: POST_QUERY,\n *     params: {slug},\n *     perspective,\n *     variant,\n *     stega,\n *   })\n *\n *   return <pre>{JSON.stringify(data, null, 2)}</pre>\n * }\n * ```\n *\n * @public\n */\nexport function defineLive(config: DefineLiveOptions & {strict: true}): {\n  sanityFetch: StrictDefinedFetchType\n  SanityLive: React.ComponentType<StrictDefinedLiveProps>\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 & {strict?: false}): {\n  sanityFetch: DefinedFetchType\n  SanityLive: React.ComponentType<DefinedLiveProps>\n}\nexport function defineLive(config: DefineLiveOptions) {\n  const {client: _client, serverToken, browserToken, strict = false} = config\n\n  if (!_client) {\n    throw new Error('`client` is required for `defineLive` to function')\n  }\n\n  if (process.env.NODE_ENV === 'development' && !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 === 'development' && !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({\n    allowReconfigure: false,\n    useCdn: true,\n    perspective: 'published',\n    stega: false,\n  })\n\n  const sanityFetch: DefinedFetchType = async function sanityFetch({\n    query,\n    params = {},\n    perspective,\n    variant,\n    stega,\n    tags: customCacheTags = [],\n    requestTag = 'next-loader.fetch.cache-components',\n  }) {\n    if (strict) {\n      validateStrictFetchOptions({perspective, stega})\n    }\n\n    const useCdn = perspective ? perspective === 'published' : undefined\n    const isBuildPhase = process.env['NEXT_PHASE'] === PHASE_PRODUCTION_BUILD\n    const cacheMode = useCdn !== false && !isBuildPhase ? 'noStale' : undefined\n    const token =\n      ((perspective && perspective !== 'published') || stega) && serverToken\n        ? serverToken\n        : undefined\n\n    const {result, resultSourceMap, syncTags} = await client.fetch(query, await params, {\n      filterResponse: false,\n      perspective,\n      variant,\n      stega,\n      returnQuery: false,\n      useCdn,\n      cacheMode,\n      tag: requestTag,\n      token,\n    })\n    const tags = [...customCacheTags, ...(syncTags || []).map((tag) => `${cacheTagPrefix}${tag}`)]\n    /**\n     * The tags used here, are expired later on in the `action` Server Action given to `<SanityLive />` with the `revalidateTag` function from `next/cache`,\n     * or by a route handler that userland sets up.\n     */\n    cacheTag(...tags)\n    /**\n     * Sanity Live handles on-demand revalidation, so the default 15min time-based revalidation is too short,\n     * userland can still set a shorter revalidate time by calling `cacheLife` themselves.\n     */\n    cacheLife(sanityCacheLife)\n\n    return {data: result, sourceMap: resultSourceMap || null, tags}\n  }\n\n  const SanityLive: React.ComponentType<DefinedLiveProps> = function SanityLive(props) {\n    if (strict) {\n      validateStrictSanityLiveProps(props)\n    }\n    const {\n      includeDrafts: _includeDrafts = false,\n      requestTag = 'next-loader.live.cache-components',\n      waitFor,\n\n      action,\n      onError,\n      onWelcome,\n      onReconnect,\n      onRestart,\n      onGoAway,\n    } = props\n    const {projectId, dataset, apiHost, apiVersion, useProjectHostname, requestTagPrefix} =\n      client.config()\n\n    const includeDrafts = typeof browserToken === 'string' && !!browserToken && _includeDrafts\n    const shouldWaitFor = waitFor === 'function' && !includeDrafts ? waitFor : undefined\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    preconnect(client)\n\n    return (\n      <SanityLiveClientComponent\n        config={{\n          projectId,\n          dataset,\n          apiHost: apiHost === defaultApiHost ? undefined : apiHost,\n          apiVersion,\n          useProjectHostname: useProjectHostname ? undefined : useProjectHostname,\n          requestTagPrefix,\n          token: includeDrafts ? browserToken : undefined,\n        }}\n        includeDrafts={includeDrafts ? true : undefined}\n        requestTag={requestTag}\n        waitFor={shouldWaitFor}\n        action={\n          action ??\n          (shouldWaitFor === 'function' || includeDrafts ? 'refresh' : revalidateSyncTagsAction)\n        }\n        onError={onError}\n        onWelcome={onWelcome}\n        onReconnect={onReconnect}\n        onRestart={onRestart}\n        onGoAway={onGoAway}\n      />\n    )\n  }\n  SanityLive.displayName = 'SanityLiveServerComponent'\n\n  return {sanityFetch, SanityLive}\n}\n"],"mappings":";;;;;;;;;;AA0QA,SAAgB,WAAW,QAA2B;CACpD,MAAM,EAAC,QAAQ,SAAS,aAAa,cAAc,SAAS,UAAS;CAErE,IAAI,CAAC,SACH,MAAM,IAAI,MAAM,mDAAmD;CAGrE,IAAI,QAAQ,IAAI,aAAa,iBAAiB,CAAC,eAAe,gBAAgB,OAC5E,QAAQ,KACN,6LACF;CAGF,IAAI,QAAQ,IAAI,aAAa,iBAAiB,CAAC,gBAAgB,iBAAiB,OAC9E,QAAQ,KACN,gXACF;CAGF,MAAM,SAAS,QAAQ,WAAW;EAChC,kBAAkB;EAClB,QAAQ;EACR,aAAa;EACb,OAAO;CACT,CAAC;CAED,MAAM,cAAgC,eAAe,YAAY,EAC/D,OACA,SAAS,CAAC,GACV,aACA,SACA,OACA,MAAM,kBAAkB,CAAC,GACzB,aAAa,wCACZ;EACD,IAAI,QACF,2BAA2B;GAAC;GAAa;EAAK,CAAC;EAGjD,MAAM,SAAS,cAAc,gBAAgB,cAAc,KAAA;EAC3D,MAAM,eAAe,QAAQ,IAAI,kBAAkB;EACnD,MAAM,YAAY,WAAW,SAAS,CAAC,eAAe,YAAY,KAAA;EAClE,MAAM,SACF,eAAe,gBAAgB,eAAgB,UAAU,cACvD,cACA,KAAA;EAEN,MAAM,EAAC,QAAQ,iBAAiB,aAAY,MAAM,OAAO,MAAM,OAAO,MAAM,QAAQ;GAClF,gBAAgB;GAChB;GACA;GACA;GACA,aAAa;GACb;GACA;GACA,KAAK;GACL;EACF,CAAC;EACD,MAAM,OAAO,CAAC,GAAG,iBAAiB,IAAI,YAAY,CAAC,EAAA,CAAG,KAAK,QAAQ,GAAG,iBAAiB,KAAK,CAAC;;;;;EAK7F,SAAS,GAAG,IAAI;;;;;EAKhB,UAAUA,MAAe;EAEzB,OAAO;GAAC,MAAM;GAAQ,WAAW,mBAAmB;GAAM;EAAI;CAChE;CAEA,MAAMC,eAAoD,SAASA,aAAW,OAAO;EACnF,IAAI,QACF,8BAA8B,KAAK;EAErC,MAAM,EACJ,eAAe,iBAAiB,OAChC,aAAa,qCACb,SAEA,QACA,SACA,WACA,aACA,WACA,aACE;EACJ,MAAM,EAAC,WAAW,SAAS,SAAS,YAAY,oBAAoB,qBAClE,OAAO,OAAO;EAEhB,MAAM,gBAAgB,OAAO,iBAAiB,YAAY,CAAC,CAAC,gBAAgB;EAC5E,MAAM,gBAAgB,YAAY,cAAc,CAAC,gBAAgB,UAAU,KAAA;EAG3E,WAAW,MAAM;EAEjB,OACE,oBAACC,YAAD;GACE,QAAQ;IACN;IACA;IACA,SAAS,YAAA,0BAA6B,KAAA,IAAY;IAClD;IACA,oBAAoB,qBAAqB,KAAA,IAAY;IACrD;IACA,OAAO,gBAAgB,eAAe,KAAA;GACxC;GACA,eAAe,gBAAgB,OAAO,KAAA;GAC1B;GACZ,SAAS;GACT,QACE,WACC,kBAAkB,cAAc,gBAAgB,YAAY;GAEtD;GACE;GACE;GACF;GACD;EACX,CAAA;CAEL;CACA,aAAW,cAAc;CAEzB,OAAO;EAAC;EAAa,YAAA;CAAU;AACjC"}
+{"version":3,"file":"index.js","names":["sanityCacheLife","SanityLive","SanityLiveClientComponent"],"sources":["../../../../src/live/conditions/next-js/defineLive.tsx"],"sourcesContent":["import {sanity as sanityCacheLife} from 'next-sanity/live/cache-life'\nimport {SanityLive as SanityLiveClientComponent} from 'next-sanity/live/client-components'\nimport {revalidateSyncTagsAction} from 'next-sanity/live/server-actions'\nimport {cacheLife, cacheTag} from 'next/cache'\nimport {PHASE_PRODUCTION_BUILD} from 'next/constants'\n\nimport {cacheTagPrefix, defaultApiHost} from '#live/constants'\nimport {preconnect} from '#live/preconnect'\nimport {validateStrictFetchOptions, validateStrictSanityLiveProps} from '#live/strictValidation'\nimport type {\n  DefinedFetchType,\n  DefinedLiveProps,\n  DefineLiveOptions,\n  StrictDefinedFetchType,\n  StrictDefinedLiveProps,\n} from '#live/types'\n\n/**\n * Set up Sanity Live for Cache Components. `defineLive` returns `sanityFetch`\n * and `<SanityLive />`, which connect your Sanity client to the Live Content API\n * so cached pages can update in response to fine-grained content changes.\n *\n * With `strict: true`, `perspective` and `stega` become required\n * `sanityFetch` options, and `includeDrafts` becomes required on\n * `<SanityLive />`. Resolve dynamic values from `draftMode()` and `cookies()`\n * outside `'use cache'` boundaries, then pass them into cached components.\n *\n * `sanityFetch` brands `data` with stega string types when `stega` is `true`,\n * a non-literal `boolean`, or omitted (react-server may auto-enable stega).\n * Pass the literal `stega: false` for clean TypeGen types. Use `stegaClean`\n * before comparing branded strings to literals.\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 * // sanity/live.ts\n * import {cookies, draftMode} from 'next/headers'\n * import {createClient} from 'next-sanity'\n * import {\n *   defineLive,\n *   resolvePerspectiveFromCookies,\n *   resolveVariantFromCookies,\n *   type LivePerspective,\n *   type StrictDefinedFetchType,\n * } 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 *   strict: true,\n * })\n *\n * // The app's one shared 'use cache' boundary. `sanityFetch` calls\n * // `cacheTag`/`cacheLife` internally but doesn't create the boundary —\n * // this wrapper provides it once, so callers don't add their own.\n * export const cachedSanity: StrictDefinedFetchType = async (options) => {\n *   'use cache'\n *   return sanityFetch(options)\n * }\n *\n * export interface DynamicFetchOptions {\n *   perspective: LivePerspective\n *   variant?: string\n *   // `boolean` brands `sanityFetch` `data`; use literal `false` for clean types\n *   stega: boolean\n * }\n *\n * // Resolve dynamic values outside 'use cache' boundaries.\n * export async function getDynamicFetchOptions(): Promise<DynamicFetchOptions> {\n *   const {isEnabled: isDraftMode} = await draftMode()\n *   if (!isDraftMode) {\n *     return {perspective: 'published', stega: false}\n *   }\n *\n *   const jar = await cookies()\n *   const perspective = await resolvePerspectiveFromCookies({cookies: jar})\n *   const variant = await resolveVariantFromCookies({cookies: jar})\n *   return {perspective: perspective ?? 'drafts', variant, stega: true}\n * }\n * ```\n *\n * @example\n * ```tsx\n * // app/layout.tsx\n * import {draftMode} from 'next/headers'\n *\n * import {SanityLive} from '@/sanity/live'\n *\n * export default async function RootLayout({children}: {children: React.ReactNode}) {\n *   const {isEnabled: isDraftMode} = await draftMode()\n *\n *   return (\n *     <html lang=\"en\">\n *       <body>\n *         {children}\n *         <SanityLive includeDrafts={isDraftMode} />\n *       </body>\n *     </html>\n *   )\n * }\n * ```\n *\n * @example\n * ```tsx\n * // app/[slug]/page.tsx\n * import {draftMode} from 'next/headers'\n * import {Suspense} from 'react'\n * import {defineQuery} from 'next-sanity'\n *\n * import {\n *   cachedSanity,\n *   getDynamicFetchOptions,\n *   type DynamicFetchOptions,\n * } 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 cachedSanity({\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 {isEnabled: isDraftMode} = await draftMode()\n *   if (isDraftMode) {\n *     return (\n *       <Suspense fallback={<div>Loading...</div>}>\n *         <DynamicPage params={props.params} />\n *       </Suspense>\n *     )\n *   }\n *\n *   const {slug} = await props.params\n *   return <CachedPage slug={slug} perspective=\"published\" stega={false} />\n * }\n *\n * async function DynamicPage(props: Pick<PageProps<'/[slug]'>, 'params'>) {\n *   const {slug} = await props.params\n *   const {perspective, variant, stega} = await getDynamicFetchOptions()\n *\n *   return <CachedPage slug={slug} perspective={perspective} variant={variant} stega={stega} />\n * }\n *\n * async function CachedPage({\n *   slug,\n *   perspective,\n *   variant,\n *   stega,\n * }: {slug: string} & DynamicFetchOptions) {\n *   const {data} = await cachedSanity({\n *     query: POST_QUERY,\n *     params: {slug},\n *     perspective,\n *     variant,\n *     stega,\n *   })\n *\n *   return <pre>{JSON.stringify(data, null, 2)}</pre>\n * }\n * ```\n *\n * @public\n */\nexport function defineLive(config: DefineLiveOptions & {strict: true}): {\n  sanityFetch: StrictDefinedFetchType\n  SanityLive: React.ComponentType<StrictDefinedLiveProps>\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 & {strict?: false}): {\n  sanityFetch: DefinedFetchType\n  SanityLive: React.ComponentType<DefinedLiveProps>\n}\nexport function defineLive(config: DefineLiveOptions) {\n  const {client: _client, serverToken, browserToken, strict = false} = config\n\n  if (!_client) {\n    throw new Error('`client` is required for `defineLive` to function')\n  }\n\n  if (process.env.NODE_ENV === 'development' && !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 === 'development' && !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({\n    allowReconfigure: false,\n    useCdn: true,\n    perspective: 'published',\n    stega: false,\n  })\n\n  const sanityFetch: DefinedFetchType = async function sanityFetch({\n    query,\n    params = {},\n    perspective,\n    variant,\n    stega,\n    tags: customCacheTags = [],\n    requestTag = 'next-loader.fetch.cache-components',\n  }) {\n    if (strict) {\n      validateStrictFetchOptions({perspective, stega})\n    }\n\n    const useCdn = perspective ? perspective === 'published' : undefined\n    const isBuildPhase = process.env['NEXT_PHASE'] === PHASE_PRODUCTION_BUILD\n    const cacheMode = useCdn !== false && !isBuildPhase ? 'noStale' : undefined\n    const token =\n      ((perspective && perspective !== 'published') || stega) && serverToken\n        ? serverToken\n        : undefined\n\n    const {result, resultSourceMap, syncTags} = await client.fetch(query, await params, {\n      filterResponse: false,\n      perspective,\n      variant,\n      stega,\n      returnQuery: false,\n      useCdn,\n      cacheMode,\n      tag: requestTag,\n      token,\n    })\n    const tags = [...customCacheTags, ...(syncTags || []).map((tag) => `${cacheTagPrefix}${tag}`)]\n    /**\n     * The tags used here, are expired later on in the `action` Server Action given to `<SanityLive />` with the `revalidateTag` function from `next/cache`,\n     * or by a route handler that userland sets up.\n     */\n    cacheTag(...tags)\n    /**\n     * Sanity Live handles on-demand revalidation, so the default 15min time-based revalidation is too short,\n     * userland can still set a shorter revalidate time by calling `cacheLife` themselves.\n     */\n    cacheLife(sanityCacheLife)\n\n    return {data: result, sourceMap: resultSourceMap || null, tags}\n  }\n\n  const SanityLive: React.ComponentType<DefinedLiveProps> = function SanityLive(props) {\n    if (strict) {\n      validateStrictSanityLiveProps(props)\n    }\n    const {\n      includeDrafts: _includeDrafts = false,\n      requestTag = 'next-loader.live.cache-components',\n      waitFor,\n\n      action,\n      onError,\n      onWelcome,\n      onReconnect,\n      onRestart,\n      onGoAway,\n    } = props\n    const {projectId, dataset, apiHost, apiVersion, useProjectHostname, requestTagPrefix} =\n      client.config()\n\n    const includeDrafts = typeof browserToken === 'string' && !!browserToken && _includeDrafts\n    const shouldWaitFor = waitFor === 'function' && !includeDrafts ? waitFor : undefined\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    preconnect(client)\n\n    return (\n      <SanityLiveClientComponent\n        config={{\n          projectId,\n          dataset,\n          apiHost: apiHost === defaultApiHost ? undefined : apiHost,\n          apiVersion,\n          useProjectHostname: useProjectHostname ? undefined : useProjectHostname,\n          requestTagPrefix,\n          token: includeDrafts ? browserToken : undefined,\n        }}\n        includeDrafts={includeDrafts ? true : undefined}\n        requestTag={requestTag}\n        waitFor={shouldWaitFor}\n        action={\n          action ??\n          (shouldWaitFor === 'function' || includeDrafts ? 'refresh' : revalidateSyncTagsAction)\n        }\n        onError={onError}\n        onWelcome={onWelcome}\n        onReconnect={onReconnect}\n        onRestart={onRestart}\n        onGoAway={onGoAway}\n      />\n    )\n  }\n  SanityLive.displayName = 'SanityLiveServerComponent'\n\n  return {sanityFetch, SanityLive}\n}\n"],"mappings":";;;;;;;;;;AAiRA,SAAgB,WAAW,QAA2B;CACpD,MAAM,EAAC,QAAQ,SAAS,aAAa,cAAc,SAAS,UAAS;CAErE,IAAI,CAAC,SACH,MAAM,IAAI,MAAM,mDAAmD;CAGrE,IAAI,QAAQ,IAAI,aAAa,iBAAiB,CAAC,eAAe,gBAAgB,OAC5E,QAAQ,KACN,6LACF;CAGF,IAAI,QAAQ,IAAI,aAAa,iBAAiB,CAAC,gBAAgB,iBAAiB,OAC9E,QAAQ,KACN,gXACF;CAGF,MAAM,SAAS,QAAQ,WAAW;EAChC,kBAAkB;EAClB,QAAQ;EACR,aAAa;EACb,OAAO;CACT,CAAC;CAED,MAAM,cAAgC,eAAe,YAAY,EAC/D,OACA,SAAS,CAAC,GACV,aACA,SACA,OACA,MAAM,kBAAkB,CAAC,GACzB,aAAa,wCACZ;EACD,IAAI,QACF,2BAA2B;GAAC;GAAa;EAAK,CAAC;EAGjD,MAAM,SAAS,cAAc,gBAAgB,cAAc,KAAA;EAC3D,MAAM,eAAe,QAAQ,IAAI,kBAAkB;EACnD,MAAM,YAAY,WAAW,SAAS,CAAC,eAAe,YAAY,KAAA;EAClE,MAAM,SACF,eAAe,gBAAgB,eAAgB,UAAU,cACvD,cACA,KAAA;EAEN,MAAM,EAAC,QAAQ,iBAAiB,aAAY,MAAM,OAAO,MAAM,OAAO,MAAM,QAAQ;GAClF,gBAAgB;GAChB;GACA;GACA;GACA,aAAa;GACb;GACA;GACA,KAAK;GACL;EACF,CAAC;EACD,MAAM,OAAO,CAAC,GAAG,iBAAiB,IAAI,YAAY,CAAC,EAAA,CAAG,KAAK,QAAQ,GAAG,iBAAiB,KAAK,CAAC;;;;;EAK7F,SAAS,GAAG,IAAI;;;;;EAKhB,UAAUA,MAAe;EAEzB,OAAO;GAAC,MAAM;GAAQ,WAAW,mBAAmB;GAAM;EAAI;CAChE;CAEA,MAAMC,eAAoD,SAASA,aAAW,OAAO;EACnF,IAAI,QACF,8BAA8B,KAAK;EAErC,MAAM,EACJ,eAAe,iBAAiB,OAChC,aAAa,qCACb,SAEA,QACA,SACA,WACA,aACA,WACA,aACE;EACJ,MAAM,EAAC,WAAW,SAAS,SAAS,YAAY,oBAAoB,qBAClE,OAAO,OAAO;EAEhB,MAAM,gBAAgB,OAAO,iBAAiB,YAAY,CAAC,CAAC,gBAAgB;EAC5E,MAAM,gBAAgB,YAAY,cAAc,CAAC,gBAAgB,UAAU,KAAA;EAG3E,WAAW,MAAM;EAEjB,OACE,oBAACC,YAAD;GACE,QAAQ;IACN;IACA;IACA,SAAS,YAAA,0BAA6B,KAAA,IAAY;IAClD;IACA,oBAAoB,qBAAqB,KAAA,IAAY;IACrD;IACA,OAAO,gBAAgB,eAAe,KAAA;GACxC;GACA,eAAe,gBAAgB,OAAO,KAAA;GAC1B;GACZ,SAAS;GACT,QACE,WACC,kBAAkB,cAAc,gBAAgB,YAAY;GAEtD;GACE;GACE;GACF;GACD;EACX,CAAA;CAEL;CACA,aAAW,cAAc;CAEzB,OAAO;EAAC;EAAa,YAAA;CAAU;AACjC"}

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

@@ -29,6 +29,7 @@ import { n as resolveVariantFromCookies, r as resolvePerspectiveFromCookies, t a
  *   resolvePerspectiveFromCookies,
  *   resolveVariantFromCookies,
  *   type LivePerspective,
+ *   type StrictDefinedFetchType,
  * } from 'next-sanity/live'
  *
  * const client = createClient({
@@ -46,6 +47,14 @@ import { n as resolveVariantFromCookies, r as resolvePerspectiveFromCookies, t a
  *   strict: true,
  * })
  *
+ * // The app's one shared 'use cache' boundary. `sanityFetch` calls
+ * // `cacheTag`/`cacheLife` internally but doesn't create the boundary —
+ * // this wrapper provides it once, so callers don't add their own.
+ * export const cachedSanity: StrictDefinedFetchType = async (options) => {
+ *   'use cache'
+ *   return sanityFetch(options)
+ * }
+ *
  * export interface DynamicFetchOptions {
  *   perspective: LivePerspective
  *   variant?: string
@@ -96,8 +105,8 @@ import { n as resolveVariantFromCookies, r as resolvePerspectiveFromCookies, t a
  * import {defineQuery} from 'next-sanity'
  *
  * import {
+ *   cachedSanity,
  *   getDynamicFetchOptions,
- *   sanityFetch,
  *   type DynamicFetchOptions,
  * } from '@/sanity/live'
  *
@@ -109,7 +118,7 @@ import { n as resolveVariantFromCookies, r as resolvePerspectiveFromCookies, t a
  * `)
  *
  * export async function generateStaticParams() {
- *   const {data} = await sanityFetch({
+ *   const {data} = await cachedSanity({
  *     query: POSTS_SLUGS_QUERY,
  *     perspective: 'published',
  *     stega: false,
@@ -145,9 +154,7 @@ import { n as resolveVariantFromCookies, r as resolvePerspectiveFromCookies, t a
  *   variant,
  *   stega,
  * }: {slug: string} & DynamicFetchOptions) {
- *   'use cache'
- *
- *   const {data} = await sanityFetch({
+ *   const {data} = await cachedSanity({
  *     query: POST_QUERY,
  *     params: {slug},
  *     perspective,

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","names":[],"sources":["../../../../src/live/conditions/react-server/defineLive.tsx"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAmLgB,WAAW,QAAQ;EAAqB;;EACtD,aAAa;EACb,YAAY,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAmFlB,WAAW,QAAQ;EAAqB;;EACtD,aAAa;EACb,YAAY,MAAM,cAAc"}
+{"version":3,"file":"index.d.ts","names":[],"sources":["../../../../src/live/conditions/react-server/defineLive.tsx"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBA0LgB,WAAW,QAAQ;EAAqB;;EACtD,aAAa;EACb,YAAY,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAmFlB,WAAW,QAAQ;EAAqB;;EACtD,aAAa;EACb,YAAY,MAAM,cAAc"}

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 {SanityLive as SanityLiveClientComponent} from 'next-sanity/live/client-components'\nimport {revalidateSyncTagsAction} from 'next-sanity/live/server-actions'\nimport {PHASE_PRODUCTION_BUILD} from 'next/constants'\nimport {cookies, draftMode} from 'next/headers'\n\nimport {cacheTagPrefix, defaultApiHost} from '#live/constants'\nimport {preconnect} from '#live/preconnect'\nimport {resolvePerspectiveFromCookies} from '#live/resolvePerspectiveFromCookies'\nimport {resolveVariantFromCookies} from '#live/resolveVariantFromCookies'\nimport {validateStrictFetchOptions, validateStrictSanityLiveProps} from '#live/strictValidation'\nimport type {\n  DefinedFetchType,\n  DefinedLiveProps,\n  DefineLiveOptions,\n  LivePerspective,\n  StrictDefinedFetchType,\n  StrictDefinedLiveProps,\n} from '#live/types'\n\n/**\n * Set up Sanity Live for Cache Components. `defineLive` returns `sanityFetch`\n * and `<SanityLive />`, which connect your Sanity client to the Live Content API\n * so cached pages can update in response to fine-grained content changes.\n *\n * With `strict: true`, `perspective` and `stega` become required\n * `sanityFetch` options, and `includeDrafts` becomes required on\n * `<SanityLive />`. Resolve dynamic values from `draftMode()` and `cookies()`\n * outside `'use cache'` boundaries, then pass them into cached components.\n *\n * `sanityFetch` brands `data` with stega string types when `stega` is `true`,\n * a non-literal `boolean`, or omitted (react-server may auto-enable stega).\n * Pass the literal `stega: false` for clean TypeGen types. Use `stegaClean`\n * before comparing branded strings to literals.\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 * // sanity/live.ts\n * import {cookies, draftMode} from 'next/headers'\n * import {createClient} from 'next-sanity'\n * import {\n *   defineLive,\n *   resolvePerspectiveFromCookies,\n *   resolveVariantFromCookies,\n *   type LivePerspective,\n * } 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 *   strict: true,\n * })\n *\n * export interface DynamicFetchOptions {\n *   perspective: LivePerspective\n *   variant?: string\n *   // `boolean` brands `sanityFetch` `data`; use literal `false` for clean types\n *   stega: boolean\n * }\n *\n * // Resolve dynamic values outside 'use cache' boundaries.\n * export async function getDynamicFetchOptions(): Promise<DynamicFetchOptions> {\n *   const {isEnabled: isDraftMode} = await draftMode()\n *   if (!isDraftMode) {\n *     return {perspective: 'published', stega: false}\n *   }\n *\n *   const jar = await cookies()\n *   const perspective = await resolvePerspectiveFromCookies({cookies: jar})\n *   const variant = await resolveVariantFromCookies({cookies: jar})\n *   return {perspective: perspective ?? 'drafts', variant, stega: true}\n * }\n * ```\n *\n * @example\n * ```tsx\n * // app/layout.tsx\n * import {draftMode} from 'next/headers'\n *\n * import {SanityLive} from '@/sanity/live'\n *\n * export default async function RootLayout({children}: {children: React.ReactNode}) {\n *   const {isEnabled: isDraftMode} = await draftMode()\n *\n *   return (\n *     <html lang=\"en\">\n *       <body>\n *         {children}\n *         <SanityLive includeDrafts={isDraftMode} />\n *       </body>\n *     </html>\n *   )\n * }\n * ```\n *\n * @example\n * ```tsx\n * // app/[slug]/page.tsx\n * import {draftMode} from 'next/headers'\n * import {Suspense} from 'react'\n * import {defineQuery} from 'next-sanity'\n *\n * import {\n *   getDynamicFetchOptions,\n *   sanityFetch,\n *   type DynamicFetchOptions,\n * } 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 {isEnabled: isDraftMode} = await draftMode()\n *   if (isDraftMode) {\n *     return (\n *       <Suspense fallback={<div>Loading...</div>}>\n *         <DynamicPage params={props.params} />\n *       </Suspense>\n *     )\n *   }\n *\n *   const {slug} = await props.params\n *   return <CachedPage slug={slug} perspective=\"published\" stega={false} />\n * }\n *\n * async function DynamicPage(props: Pick<PageProps<'/[slug]'>, 'params'>) {\n *   const {slug} = await props.params\n *   const {perspective, variant, stega} = await getDynamicFetchOptions()\n *\n *   return <CachedPage slug={slug} perspective={perspective} variant={variant} stega={stega} />\n * }\n *\n * async function CachedPage({\n *   slug,\n *   perspective,\n *   variant,\n *   stega,\n * }: {slug: string} & DynamicFetchOptions) {\n *   'use cache'\n *\n *   const {data} = await sanityFetch({\n *     query: POST_QUERY,\n *     params: {slug},\n *     perspective,\n *     variant,\n *     stega,\n *   })\n *\n *   return <pre>{JSON.stringify(data, null, 2)}</pre>\n * }\n * ```\n *\n * @public\n */\nexport function defineLive(config: DefineLiveOptions & {strict: true}): {\n  sanityFetch: StrictDefinedFetchType\n  SanityLive: React.ComponentType<StrictDefinedLiveProps>\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 & {strict?: false}): {\n  sanityFetch: DefinedFetchType\n  SanityLive: React.ComponentType<DefinedLiveProps>\n}\nexport function defineLive(config: DefineLiveOptions) {\n  const {client: _client, serverToken, browserToken, strict = false} = config\n\n  if (!_client) {\n    throw new Error('`client` is required for `defineLive` to function')\n  }\n\n  if (process.env.NODE_ENV === 'development' && !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 === 'development' && !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({\n    allowReconfigure: false,\n    useCdn: true,\n    perspective: 'published',\n    stega: false,\n  })\n  const studioUrlDefined = typeof client.config().stega.studioUrl !== 'undefined'\n\n  const sanityFetch: DefinedFetchType = async function sanityFetch({\n    query,\n    params = {},\n    perspective: _perspective,\n    variant: _variant,\n    stega: _stega,\n    tags = [],\n    requestTag = 'next-loader.fetch',\n  }) {\n    if (strict) {\n      validateStrictFetchOptions({perspective: _perspective, stega: _stega})\n    }\n    const stega = strict\n      ? _stega\n      : (_stega ?? (serverToken && studioUrlDefined ? (await draftMode()).isEnabled : false))\n    const perspective = strict\n      ? _perspective\n      : (_perspective ?? (serverToken ? await resolveCookiePerspective() : undefined))\n    // The variant cookie is only auto-resolved when the perspective is too:\n    // an explicit `perspective` opts out of cookie resolution entirely, which\n    // keeps fetches with explicit options free of dynamic API calls.\n    const variant = strict\n      ? _variant\n      : (_variant ??\n        (serverToken && typeof _perspective === 'undefined'\n          ? await resolveCookieVariant()\n          : undefined))\n    const useCdn = perspective ? perspective === 'published' : undefined\n    const isBuildPhase = process.env['NEXT_PHASE'] === PHASE_PRODUCTION_BUILD\n    const cacheMode = useCdn !== false && !isBuildPhase ? 'noStale' : undefined\n    const token =\n      ((perspective && perspective !== 'published') || stega) && serverToken\n        ? serverToken\n        : undefined\n\n    // 1. Fetch the tags first, with an uncached request, but that does not count towards the Sanity API quota\n    const {syncTags} = await client.fetch(query, await params, {\n      filterResponse: false,\n      perspective,\n      variant,\n      stega: false,\n      resultSourceMap: false,\n      returnQuery: false,\n      useCdn,\n      cacheMode,\n      tag: [requestTag, 'fetch-sync-tags'].filter(Boolean).join('.'),\n      token,\n    })\n\n    const cacheTags = [...tags, ...(syncTags?.map((tag) => `${cacheTagPrefix}${tag}`) || [])]\n\n    // 2. Then fetch the data, using the fetch cache with specified tags\n    const {result, resultSourceMap} = await client.fetch(query, await params, {\n      filterResponse: false,\n      perspective,\n      variant,\n      stega,\n      next: {revalidate: false, tags: cacheTags},\n      useCdn,\n      cacheMode,\n      tag: requestTag,\n      token,\n    })\n    return {data: result, sourceMap: resultSourceMap || null, tags: cacheTags}\n  }\n\n  const SanityLive: React.ComponentType<DefinedLiveProps> = async function SanityLive(props) {\n    if (strict) {\n      validateStrictSanityLiveProps(props)\n    }\n    const {\n      includeDrafts: _includeDrafts,\n      requestTag = 'next-loader.live',\n      waitFor,\n\n      action,\n      onError,\n      onWelcome,\n      onReconnect,\n      onRestart,\n      onGoAway,\n    } = props\n    const {projectId, dataset, apiHost, apiVersion, useProjectHostname, requestTagPrefix} =\n      client.config()\n\n    const includeDrafts =\n      typeof browserToken === 'string' &&\n      !!browserToken &&\n      (_includeDrafts ?? (await draftMode()).isEnabled)\n    const shouldWaitFor = waitFor === 'function' && !includeDrafts ? waitFor : undefined\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    preconnect(client)\n\n    return (\n      <SanityLiveClientComponent\n        config={{\n          projectId,\n          dataset,\n          apiHost: apiHost === defaultApiHost ? undefined : apiHost,\n          apiVersion,\n          useProjectHostname: useProjectHostname ? undefined : useProjectHostname,\n          requestTagPrefix,\n          token: includeDrafts ? browserToken : undefined,\n        }}\n        includeDrafts={includeDrafts ? true : undefined}\n        requestTag={requestTag}\n        waitFor={shouldWaitFor}\n        action={\n          action ??\n          (shouldWaitFor === 'function' || includeDrafts ? 'refresh' : revalidateSyncTagsAction)\n        }\n        onError={onError}\n        onWelcome={onWelcome}\n        onReconnect={onReconnect}\n        onRestart={onRestart}\n        onGoAway={onGoAway}\n      />\n    )\n  }\n  SanityLive.displayName = 'SanityLiveServerComponent'\n\n  return {sanityFetch, SanityLive}\n}\n\nasync function resolveCookiePerspective(): Promise<LivePerspective | undefined> {\n  return (await draftMode()).isEnabled\n    ? await resolvePerspectiveFromCookies({cookies: await cookies()})\n    : undefined\n}\n\nasync function resolveCookieVariant(): Promise<string | undefined> {\n  return (await draftMode()).isEnabled\n    ? await resolveVariantFromCookies({cookies: await cookies()})\n    : undefined\n}\n"],"mappings":";;;;;;;;;AA4QA,SAAgB,WAAW,QAA2B;CACpD,MAAM,EAAC,QAAQ,SAAS,aAAa,cAAc,SAAS,UAAS;CAErE,IAAI,CAAC,SACH,MAAM,IAAI,MAAM,mDAAmD;CAGrE,IAAI,QAAQ,IAAI,aAAa,iBAAiB,CAAC,eAAe,gBAAgB,OAC5E,QAAQ,KACN,6LACF;CAGF,IAAI,QAAQ,IAAI,aAAa,iBAAiB,CAAC,gBAAgB,iBAAiB,OAC9E,QAAQ,KACN,gXACF;CAGF,MAAM,SAAS,QAAQ,WAAW;EAChC,kBAAkB;EAClB,QAAQ;EACR,aAAa;EACb,OAAO;CACT,CAAC;CACD,MAAM,mBAAmB,OAAO,OAAO,OAAO,CAAC,CAAC,MAAM,cAAc;CAEpE,MAAM,cAAgC,eAAe,YAAY,EAC/D,OACA,SAAS,CAAC,GACV,aAAa,cACb,SAAS,UACT,OAAO,QACP,OAAO,CAAC,GACR,aAAa,uBACZ;EACD,IAAI,QACF,2BAA2B;GAAC,aAAa;GAAc,OAAO;EAAM,CAAC;EAEvE,MAAM,QAAQ,SACV,SACC,WAAW,eAAe,oBAAoB,MAAM,UAAU,EAAA,CAAG,YAAY;EAClF,MAAM,cAAc,SAChB,eACC,iBAAiB,cAAc,MAAM,yBAAyB,IAAI,KAAA;EAIvE,MAAM,UAAU,SACZ,WACC,aACA,eAAe,OAAO,iBAAiB,cACpC,MAAM,qBAAqB,IAC3B,KAAA;EACR,MAAM,SAAS,cAAc,gBAAgB,cAAc,KAAA;EAC3D,MAAM,eAAe,QAAQ,IAAI,kBAAkB;EACnD,MAAM,YAAY,WAAW,SAAS,CAAC,eAAe,YAAY,KAAA;EAClE,MAAM,SACF,eAAe,gBAAgB,eAAgB,UAAU,cACvD,cACA,KAAA;EAGN,MAAM,EAAC,aAAY,MAAM,OAAO,MAAM,OAAO,MAAM,QAAQ;GACzD,gBAAgB;GAChB;GACA;GACA,OAAO;GACP,iBAAiB;GACjB,aAAa;GACb;GACA;GACA,KAAK,CAAC,YAAY,iBAAiB,CAAC,CAAC,OAAO,OAAO,CAAC,CAAC,KAAK,GAAG;GAC7D;EACF,CAAC;EAED,MAAM,YAAY,CAAC,GAAG,MAAM,GAAI,UAAU,KAAK,QAAQ,UAAoB,KAAK,KAAK,CAAC,CAAE;EAGxF,MAAM,EAAC,QAAQ,oBAAmB,MAAM,OAAO,MAAM,OAAO,MAAM,QAAQ;GACxE,gBAAgB;GAChB;GACA;GACA;GACA,MAAM;IAAC,YAAY;IAAO,MAAM;GAAS;GACzC;GACA;GACA,KAAK;GACL;EACF,CAAC;EACD,OAAO;GAAC,MAAM;GAAQ,WAAW,mBAAmB;GAAM,MAAM;EAAS;CAC3E;CAEA,MAAMA,eAAoD,eAAeA,aAAW,OAAO;EACzF,IAAI,QACF,8BAA8B,KAAK;EAErC,MAAM,EACJ,eAAe,gBACf,aAAa,oBACb,SAEA,QACA,SACA,WACA,aACA,WACA,aACE;EACJ,MAAM,EAAC,WAAW,SAAS,SAAS,YAAY,oBAAoB,qBAClE,OAAO,OAAO;EAEhB,MAAM,gBACJ,OAAO,iBAAiB,YACxB,CAAC,CAAC,iBACD,mBAAmB,MAAM,UAAU,EAAA,CAAG;EACzC,MAAM,gBAAgB,YAAY,cAAc,CAAC,gBAAgB,UAAU,KAAA;EAG3E,WAAW,MAAM;EAEjB,OACE,oBAACC,YAAD;GACE,QAAQ;IACN;IACA;IACA,SAAS,YAAA,0BAA6B,KAAA,IAAY;IAClD;IACA,oBAAoB,qBAAqB,KAAA,IAAY;IACrD;IACA,OAAO,gBAAgB,eAAe,KAAA;GACxC;GACA,eAAe,gBAAgB,OAAO,KAAA;GAC1B;GACZ,SAAS;GACT,QACE,WACC,kBAAkB,cAAc,gBAAgB,YAAY;GAEtD;GACE;GACE;GACF;GACD;EACX,CAAA;CAEL;CACA,aAAW,cAAc;CAEzB,OAAO;EAAC;EAAa,YAAA;CAAU;AACjC;AAEA,eAAe,2BAAiE;CAC9E,QAAQ,MAAM,UAAU,EAAA,CAAG,YACvB,MAAM,8BAA8B,EAAC,SAAS,MAAM,QAAQ,EAAC,CAAC,IAC9D,KAAA;AACN;AAEA,eAAe,uBAAoD;CACjE,QAAQ,MAAM,UAAU,EAAA,CAAG,YACvB,MAAM,0BAA0B,EAAC,SAAS,MAAM,QAAQ,EAAC,CAAC,IAC1D,KAAA;AACN"}
+{"version":3,"file":"index.js","names":["SanityLive","SanityLiveClientComponent"],"sources":["../../../../src/live/conditions/react-server/defineLive.tsx"],"sourcesContent":["import {SanityLive as SanityLiveClientComponent} from 'next-sanity/live/client-components'\nimport {revalidateSyncTagsAction} from 'next-sanity/live/server-actions'\nimport {PHASE_PRODUCTION_BUILD} from 'next/constants'\nimport {cookies, draftMode} from 'next/headers'\n\nimport {cacheTagPrefix, defaultApiHost} from '#live/constants'\nimport {preconnect} from '#live/preconnect'\nimport {resolvePerspectiveFromCookies} from '#live/resolvePerspectiveFromCookies'\nimport {resolveVariantFromCookies} from '#live/resolveVariantFromCookies'\nimport {validateStrictFetchOptions, validateStrictSanityLiveProps} from '#live/strictValidation'\nimport type {\n  DefinedFetchType,\n  DefinedLiveProps,\n  DefineLiveOptions,\n  LivePerspective,\n  StrictDefinedFetchType,\n  StrictDefinedLiveProps,\n} from '#live/types'\n\n/**\n * Set up Sanity Live for Cache Components. `defineLive` returns `sanityFetch`\n * and `<SanityLive />`, which connect your Sanity client to the Live Content API\n * so cached pages can update in response to fine-grained content changes.\n *\n * With `strict: true`, `perspective` and `stega` become required\n * `sanityFetch` options, and `includeDrafts` becomes required on\n * `<SanityLive />`. Resolve dynamic values from `draftMode()` and `cookies()`\n * outside `'use cache'` boundaries, then pass them into cached components.\n *\n * `sanityFetch` brands `data` with stega string types when `stega` is `true`,\n * a non-literal `boolean`, or omitted (react-server may auto-enable stega).\n * Pass the literal `stega: false` for clean TypeGen types. Use `stegaClean`\n * before comparing branded strings to literals.\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 * // sanity/live.ts\n * import {cookies, draftMode} from 'next/headers'\n * import {createClient} from 'next-sanity'\n * import {\n *   defineLive,\n *   resolvePerspectiveFromCookies,\n *   resolveVariantFromCookies,\n *   type LivePerspective,\n *   type StrictDefinedFetchType,\n * } 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 *   strict: true,\n * })\n *\n * // The app's one shared 'use cache' boundary. `sanityFetch` calls\n * // `cacheTag`/`cacheLife` internally but doesn't create the boundary —\n * // this wrapper provides it once, so callers don't add their own.\n * export const cachedSanity: StrictDefinedFetchType = async (options) => {\n *   'use cache'\n *   return sanityFetch(options)\n * }\n *\n * export interface DynamicFetchOptions {\n *   perspective: LivePerspective\n *   variant?: string\n *   // `boolean` brands `sanityFetch` `data`; use literal `false` for clean types\n *   stega: boolean\n * }\n *\n * // Resolve dynamic values outside 'use cache' boundaries.\n * export async function getDynamicFetchOptions(): Promise<DynamicFetchOptions> {\n *   const {isEnabled: isDraftMode} = await draftMode()\n *   if (!isDraftMode) {\n *     return {perspective: 'published', stega: false}\n *   }\n *\n *   const jar = await cookies()\n *   const perspective = await resolvePerspectiveFromCookies({cookies: jar})\n *   const variant = await resolveVariantFromCookies({cookies: jar})\n *   return {perspective: perspective ?? 'drafts', variant, stega: true}\n * }\n * ```\n *\n * @example\n * ```tsx\n * // app/layout.tsx\n * import {draftMode} from 'next/headers'\n *\n * import {SanityLive} from '@/sanity/live'\n *\n * export default async function RootLayout({children}: {children: React.ReactNode}) {\n *   const {isEnabled: isDraftMode} = await draftMode()\n *\n *   return (\n *     <html lang=\"en\">\n *       <body>\n *         {children}\n *         <SanityLive includeDrafts={isDraftMode} />\n *       </body>\n *     </html>\n *   )\n * }\n * ```\n *\n * @example\n * ```tsx\n * // app/[slug]/page.tsx\n * import {draftMode} from 'next/headers'\n * import {Suspense} from 'react'\n * import {defineQuery} from 'next-sanity'\n *\n * import {\n *   cachedSanity,\n *   getDynamicFetchOptions,\n *   type DynamicFetchOptions,\n * } 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 cachedSanity({\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 {isEnabled: isDraftMode} = await draftMode()\n *   if (isDraftMode) {\n *     return (\n *       <Suspense fallback={<div>Loading...</div>}>\n *         <DynamicPage params={props.params} />\n *       </Suspense>\n *     )\n *   }\n *\n *   const {slug} = await props.params\n *   return <CachedPage slug={slug} perspective=\"published\" stega={false} />\n * }\n *\n * async function DynamicPage(props: Pick<PageProps<'/[slug]'>, 'params'>) {\n *   const {slug} = await props.params\n *   const {perspective, variant, stega} = await getDynamicFetchOptions()\n *\n *   return <CachedPage slug={slug} perspective={perspective} variant={variant} stega={stega} />\n * }\n *\n * async function CachedPage({\n *   slug,\n *   perspective,\n *   variant,\n *   stega,\n * }: {slug: string} & DynamicFetchOptions) {\n *   const {data} = await cachedSanity({\n *     query: POST_QUERY,\n *     params: {slug},\n *     perspective,\n *     variant,\n *     stega,\n *   })\n *\n *   return <pre>{JSON.stringify(data, null, 2)}</pre>\n * }\n * ```\n *\n * @public\n */\nexport function defineLive(config: DefineLiveOptions & {strict: true}): {\n  sanityFetch: StrictDefinedFetchType\n  SanityLive: React.ComponentType<StrictDefinedLiveProps>\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 & {strict?: false}): {\n  sanityFetch: DefinedFetchType\n  SanityLive: React.ComponentType<DefinedLiveProps>\n}\nexport function defineLive(config: DefineLiveOptions) {\n  const {client: _client, serverToken, browserToken, strict = false} = config\n\n  if (!_client) {\n    throw new Error('`client` is required for `defineLive` to function')\n  }\n\n  if (process.env.NODE_ENV === 'development' && !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 === 'development' && !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({\n    allowReconfigure: false,\n    useCdn: true,\n    perspective: 'published',\n    stega: false,\n  })\n  const studioUrlDefined = typeof client.config().stega.studioUrl !== 'undefined'\n\n  const sanityFetch: DefinedFetchType = async function sanityFetch({\n    query,\n    params = {},\n    perspective: _perspective,\n    variant: _variant,\n    stega: _stega,\n    tags = [],\n    requestTag = 'next-loader.fetch',\n  }) {\n    if (strict) {\n      validateStrictFetchOptions({perspective: _perspective, stega: _stega})\n    }\n    const stega = strict\n      ? _stega\n      : (_stega ?? (serverToken && studioUrlDefined ? (await draftMode()).isEnabled : false))\n    const perspective = strict\n      ? _perspective\n      : (_perspective ?? (serverToken ? await resolveCookiePerspective() : undefined))\n    // The variant cookie is only auto-resolved when the perspective is too:\n    // an explicit `perspective` opts out of cookie resolution entirely, which\n    // keeps fetches with explicit options free of dynamic API calls.\n    const variant = strict\n      ? _variant\n      : (_variant ??\n        (serverToken && typeof _perspective === 'undefined'\n          ? await resolveCookieVariant()\n          : undefined))\n    const useCdn = perspective ? perspective === 'published' : undefined\n    const isBuildPhase = process.env['NEXT_PHASE'] === PHASE_PRODUCTION_BUILD\n    const cacheMode = useCdn !== false && !isBuildPhase ? 'noStale' : undefined\n    const token =\n      ((perspective && perspective !== 'published') || stega) && serverToken\n        ? serverToken\n        : undefined\n\n    // 1. Fetch the tags first, with an uncached request, but that does not count towards the Sanity API quota\n    const {syncTags} = await client.fetch(query, await params, {\n      filterResponse: false,\n      perspective,\n      variant,\n      stega: false,\n      resultSourceMap: false,\n      returnQuery: false,\n      useCdn,\n      cacheMode,\n      tag: [requestTag, 'fetch-sync-tags'].filter(Boolean).join('.'),\n      token,\n    })\n\n    const cacheTags = [...tags, ...(syncTags?.map((tag) => `${cacheTagPrefix}${tag}`) || [])]\n\n    // 2. Then fetch the data, using the fetch cache with specified tags\n    const {result, resultSourceMap} = await client.fetch(query, await params, {\n      filterResponse: false,\n      perspective,\n      variant,\n      stega,\n      next: {revalidate: false, tags: cacheTags},\n      useCdn,\n      cacheMode,\n      tag: requestTag,\n      token,\n    })\n    return {data: result, sourceMap: resultSourceMap || null, tags: cacheTags}\n  }\n\n  const SanityLive: React.ComponentType<DefinedLiveProps> = async function SanityLive(props) {\n    if (strict) {\n      validateStrictSanityLiveProps(props)\n    }\n    const {\n      includeDrafts: _includeDrafts,\n      requestTag = 'next-loader.live',\n      waitFor,\n\n      action,\n      onError,\n      onWelcome,\n      onReconnect,\n      onRestart,\n      onGoAway,\n    } = props\n    const {projectId, dataset, apiHost, apiVersion, useProjectHostname, requestTagPrefix} =\n      client.config()\n\n    const includeDrafts =\n      typeof browserToken === 'string' &&\n      !!browserToken &&\n      (_includeDrafts ?? (await draftMode()).isEnabled)\n    const shouldWaitFor = waitFor === 'function' && !includeDrafts ? waitFor : undefined\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    preconnect(client)\n\n    return (\n      <SanityLiveClientComponent\n        config={{\n          projectId,\n          dataset,\n          apiHost: apiHost === defaultApiHost ? undefined : apiHost,\n          apiVersion,\n          useProjectHostname: useProjectHostname ? undefined : useProjectHostname,\n          requestTagPrefix,\n          token: includeDrafts ? browserToken : undefined,\n        }}\n        includeDrafts={includeDrafts ? true : undefined}\n        requestTag={requestTag}\n        waitFor={shouldWaitFor}\n        action={\n          action ??\n          (shouldWaitFor === 'function' || includeDrafts ? 'refresh' : revalidateSyncTagsAction)\n        }\n        onError={onError}\n        onWelcome={onWelcome}\n        onReconnect={onReconnect}\n        onRestart={onRestart}\n        onGoAway={onGoAway}\n      />\n    )\n  }\n  SanityLive.displayName = 'SanityLiveServerComponent'\n\n  return {sanityFetch, SanityLive}\n}\n\nasync function resolveCookiePerspective(): Promise<LivePerspective | undefined> {\n  return (await draftMode()).isEnabled\n    ? await resolvePerspectiveFromCookies({cookies: await cookies()})\n    : undefined\n}\n\nasync function resolveCookieVariant(): Promise<string | undefined> {\n  return (await draftMode()).isEnabled\n    ? await resolveVariantFromCookies({cookies: await cookies()})\n    : undefined\n}\n"],"mappings":";;;;;;;;;AAmRA,SAAgB,WAAW,QAA2B;CACpD,MAAM,EAAC,QAAQ,SAAS,aAAa,cAAc,SAAS,UAAS;CAErE,IAAI,CAAC,SACH,MAAM,IAAI,MAAM,mDAAmD;CAGrE,IAAI,QAAQ,IAAI,aAAa,iBAAiB,CAAC,eAAe,gBAAgB,OAC5E,QAAQ,KACN,6LACF;CAGF,IAAI,QAAQ,IAAI,aAAa,iBAAiB,CAAC,gBAAgB,iBAAiB,OAC9E,QAAQ,KACN,gXACF;CAGF,MAAM,SAAS,QAAQ,WAAW;EAChC,kBAAkB;EAClB,QAAQ;EACR,aAAa;EACb,OAAO;CACT,CAAC;CACD,MAAM,mBAAmB,OAAO,OAAO,OAAO,CAAC,CAAC,MAAM,cAAc;CAEpE,MAAM,cAAgC,eAAe,YAAY,EAC/D,OACA,SAAS,CAAC,GACV,aAAa,cACb,SAAS,UACT,OAAO,QACP,OAAO,CAAC,GACR,aAAa,uBACZ;EACD,IAAI,QACF,2BAA2B;GAAC,aAAa;GAAc,OAAO;EAAM,CAAC;EAEvE,MAAM,QAAQ,SACV,SACC,WAAW,eAAe,oBAAoB,MAAM,UAAU,EAAA,CAAG,YAAY;EAClF,MAAM,cAAc,SAChB,eACC,iBAAiB,cAAc,MAAM,yBAAyB,IAAI,KAAA;EAIvE,MAAM,UAAU,SACZ,WACC,aACA,eAAe,OAAO,iBAAiB,cACpC,MAAM,qBAAqB,IAC3B,KAAA;EACR,MAAM,SAAS,cAAc,gBAAgB,cAAc,KAAA;EAC3D,MAAM,eAAe,QAAQ,IAAI,kBAAkB;EACnD,MAAM,YAAY,WAAW,SAAS,CAAC,eAAe,YAAY,KAAA;EAClE,MAAM,SACF,eAAe,gBAAgB,eAAgB,UAAU,cACvD,cACA,KAAA;EAGN,MAAM,EAAC,aAAY,MAAM,OAAO,MAAM,OAAO,MAAM,QAAQ;GACzD,gBAAgB;GAChB;GACA;GACA,OAAO;GACP,iBAAiB;GACjB,aAAa;GACb;GACA;GACA,KAAK,CAAC,YAAY,iBAAiB,CAAC,CAAC,OAAO,OAAO,CAAC,CAAC,KAAK,GAAG;GAC7D;EACF,CAAC;EAED,MAAM,YAAY,CAAC,GAAG,MAAM,GAAI,UAAU,KAAK,QAAQ,UAAoB,KAAK,KAAK,CAAC,CAAE;EAGxF,MAAM,EAAC,QAAQ,oBAAmB,MAAM,OAAO,MAAM,OAAO,MAAM,QAAQ;GACxE,gBAAgB;GAChB;GACA;GACA;GACA,MAAM;IAAC,YAAY;IAAO,MAAM;GAAS;GACzC;GACA;GACA,KAAK;GACL;EACF,CAAC;EACD,OAAO;GAAC,MAAM;GAAQ,WAAW,mBAAmB;GAAM,MAAM;EAAS;CAC3E;CAEA,MAAMA,eAAoD,eAAeA,aAAW,OAAO;EACzF,IAAI,QACF,8BAA8B,KAAK;EAErC,MAAM,EACJ,eAAe,gBACf,aAAa,oBACb,SAEA,QACA,SACA,WACA,aACA,WACA,aACE;EACJ,MAAM,EAAC,WAAW,SAAS,SAAS,YAAY,oBAAoB,qBAClE,OAAO,OAAO;EAEhB,MAAM,gBACJ,OAAO,iBAAiB,YACxB,CAAC,CAAC,iBACD,mBAAmB,MAAM,UAAU,EAAA,CAAG;EACzC,MAAM,gBAAgB,YAAY,cAAc,CAAC,gBAAgB,UAAU,KAAA;EAG3E,WAAW,MAAM;EAEjB,OACE,oBAACC,YAAD;GACE,QAAQ;IACN;IACA;IACA,SAAS,YAAA,0BAA6B,KAAA,IAAY;IAClD;IACA,oBAAoB,qBAAqB,KAAA,IAAY;IACrD;IACA,OAAO,gBAAgB,eAAe,KAAA;GACxC;GACA,eAAe,gBAAgB,OAAO,KAAA;GAC1B;GACZ,SAAS;GACT,QACE,WACC,kBAAkB,cAAc,gBAAgB,YAAY;GAEtD;GACE;GACE;GACF;GACD;EACX,CAAA;CAEL;CACA,aAAW,cAAc;CAEzB,OAAO;EAAC;EAAa,YAAA;CAAU;AACjC;AAEA,eAAe,2BAAiE;CAC9E,QAAQ,MAAM,UAAU,EAAA,CAAG,YACvB,MAAM,8BAA8B,EAAC,SAAS,MAAM,QAAQ,EAAC,CAAC,IAC9D,KAAA;AACN;AAEA,eAAe,uBAAoD;CACjE,QAAQ,MAAM,UAAU,EAAA,CAAG,YACvB,MAAM,0BAA0B,EAAC,SAAS,MAAM,QAAQ,EAAC,CAAC,IAC1D,KAAA;AACN"}

package/dist/parseTags.d.ts

@@ -11,11 +11,11 @@ import { SyncTag } from "@sanity/client";
  * import {cookies, draftMode} from 'next/headers'
  * import {defineQuery} from 'next-sanity'
  * import {resolvePerspectiveFromCookies, type LivePerspective} from 'next-sanity/live'
- * import {sanityFetch, sanityFetchStaticParams} from '#sanity/live'
+ * import {cachedSanity, cachedSanityStaticParams} from '#sanity/live'
  *
  * export async function generateStaticParams() {
  *   const query = defineQuery(`*[_type == "page" && defined(slug.current)]{"slug": slug.current}`)
- *   return await sanityFetchStaticParams({query})
+ *   return await cachedSanityStaticParams({query})
  * }
  *
  * export default async function Page({params}: PageProps<'/[slug]'>) {
@@ -49,10 +49,8 @@ import { SyncTag } from "@sanity/client";
  *   perspective: LivePerspective
  *   stega: boolean
  * }) {
- *   'use cache'
- *
  *   const query = defineQuery(`*[_type == "page" && slug.current == $slug][0]`)
- *   const {data} = await sanityFetch({query, params: {slug}, perspective, stega})
+ *   const {data} = await cachedSanity({query, params: {slug}, perspective, stega})
  *
  *   return <article>...</article>
  * }
@@ -81,7 +79,7 @@ declare function resolvePerspectiveFromCookies({ cookies: jar }: {
  *   resolveVariantFromCookies,
  *   type LivePerspective,
  * } from 'next-sanity/live'
- * import {sanityFetch} from '#sanity/live'
+ * import {cachedSanity} from '#sanity/live'
  *
  * export default async function Page({params}: PageProps<'/[slug]'>) {
  *   const {isEnabled: isDraftMode} = await draftMode()
@@ -118,10 +116,8 @@ declare function resolvePerspectiveFromCookies({ cookies: jar }: {
  *   variant: string | undefined
  *   stega: boolean
  * }) {
- *   'use cache'
- *
  *   const query = defineQuery(`*[_type == "page" && slug.current == $slug][0]`)
- *   const {data} = await sanityFetch({query, params: {slug}, perspective, variant, stega})
+ *   const {data} = await cachedSanity({query, params: {slug}, perspective, variant, stega})
  *
  *   return <article>...</article>
  * }

package/dist/parseTags.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"parseTags.d.ts","names":[],"sources":["../src/live/shared/resolvePerspectiveFromCookies.ts","../src/live/shared/resolveVariantFromCookies.ts","../src/live/shared/constants.ts","../src/live/shared/parseTags.ts"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAiEsB,gCACpB,SAAS;EAET,SAAS,QAAQ,kBAAkB;IACjC,QAAQ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBCEU,4BACpB,SAAS;EAET,SAAS,QAAQ,kBAAkB;IACjC;cCxES;UCCH;EACR,gBAAgB,iBAAiB;EACjC,mBAAmB;EACnB,eAAe;;;;;;;;;;;;;;;;;;;;;;;iBAwBD,UAAU,sBAAsB"}
+{"version":3,"file":"parseTags.d.ts","names":[],"sources":["../src/live/shared/resolvePerspectiveFromCookies.ts","../src/live/shared/resolveVariantFromCookies.ts","../src/live/shared/constants.ts","../src/live/shared/parseTags.ts"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBA+DsB,gCACpB,SAAS;EAET,SAAS,QAAQ,kBAAkB;IACjC,QAAQ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBCEU,4BACpB,SAAS;EAET,SAAS,QAAQ,kBAAkB;IACjC;cCtES;UCCH;EACR,gBAAgB,iBAAiB;EACjC,mBAAmB;EACnB,eAAe;;;;;;;;;;;;;;;;;;;;;;;iBAwBD,UAAU,sBAAsB"}

package/dist/resolveVariantFromCookies.js

@@ -26,11 +26,11 @@ function validateStrictFetchOptions(options) {
 * import {cookies, draftMode} from 'next/headers'
 * import {defineQuery} from 'next-sanity'
 * import {resolvePerspectiveFromCookies, type LivePerspective} from 'next-sanity/live'
-* import {sanityFetch, sanityFetchStaticParams} from '#sanity/live'
+* import {cachedSanity, cachedSanityStaticParams} from '#sanity/live'
 *
 * export async function generateStaticParams() {
 *   const query = defineQuery(`*[_type == "page" && defined(slug.current)]{"slug": slug.current}`)
-*   return await sanityFetchStaticParams({query})
+*   return await cachedSanityStaticParams({query})
 * }
 *
 * export default async function Page({params}: PageProps<'/[slug]'>) {
@@ -64,10 +64,8 @@ function validateStrictFetchOptions(options) {
 *   perspective: LivePerspective
 *   stega: boolean
 * }) {
-*   'use cache'
-*
 *   const query = defineQuery(`*[_type == "page" && slug.current == $slug][0]`)
-*   const {data} = await sanityFetch({query, params: {slug}, perspective, stega})
+*   const {data} = await cachedSanity({query, params: {slug}, perspective, stega})
 *
 *   return <article>...</article>
 * }
@@ -96,7 +94,7 @@ async function resolvePerspectiveFromCookies({ cookies: jar }) {
 *   resolveVariantFromCookies,
 *   type LivePerspective,
 * } from 'next-sanity/live'
-* import {sanityFetch} from '#sanity/live'
+* import {cachedSanity} from '#sanity/live'
 *
 * export default async function Page({params}: PageProps<'/[slug]'>) {
 *   const {isEnabled: isDraftMode} = await draftMode()
@@ -133,10 +131,8 @@ async function resolvePerspectiveFromCookies({ cookies: jar }) {
 *   variant: string | undefined
 *   stega: boolean
 * }) {
-*   'use cache'
-*
 *   const query = defineQuery(`*[_type == "page" && slug.current == $slug][0]`)
-*   const {data} = await sanityFetch({query, params: {slug}, perspective, variant, stega})
+*   const {data} = await cachedSanity({query, params: {slug}, perspective, variant, stega})
 *
 *   return <article>...</article>
 * }

package/dist/resolveVariantFromCookies.js.map

@@ -1 +1 @@
-{"version":3,"file":"resolveVariantFromCookies.js","names":["preconnect"],"sources":["../src/live/shared/preconnect.ts","../src/live/shared/strictValidation.ts","../src/live/shared/resolvePerspectiveFromCookies.ts","../src/live/shared/resolveVariantFromCookies.ts"],"sourcesContent":["import type {SanityClient} from 'next-sanity'\nimport {preconnect as reactDomPreconnect} from 'react-dom'\n\n/**\n * Uses the React DOM `preconnect` function to preconnect to the Live Event API origin early, Next.js will set the right headers and meta tags to speed up the connection.\n */\nexport function preconnect(client: SanityClient): void {\n  const {origin} = new URL(client.getUrl('', false))\n  reactDomPreconnect(origin)\n}\n","import {generateHelpUrl} from '@sanity/generate-help-url'\n\nexport function validateStrictSanityLiveProps(props: {includeDrafts?: unknown}): void {\n  if (typeof props.includeDrafts !== 'boolean') {\n    throw new Error(\n      `<SanityLive> requires an explicit \\`includeDrafts\\` prop (true or false) when \\`strict: true\\` is set on \\`defineLive\\`.\\n\\nMore information: ${generateHelpUrl('next-sanity-live-strict')}`,\n      {cause: props},\n    )\n  }\n}\n\nexport function validateStrictFetchOptions(options: {\n  perspective?: unknown\n  stega?: unknown\n}): void {\n  if (typeof options.perspective === 'undefined' || options.perspective === null) {\n    throw new Error(\n      `sanityFetch() requires an explicit \\`perspective\\` option when \\`strict: true\\` is set on \\`defineLive\\`.\\n\\nMore information: ${generateHelpUrl('next-sanity-fetch-strict')}`,\n      {cause: options},\n    )\n  }\n  if (typeof options.stega !== 'boolean') {\n    throw new Error(\n      `sanityFetch() requires an explicit \\`stega\\` option (true or false) when \\`strict: true\\` is set on \\`defineLive\\`.\\n\\nMore information: ${generateHelpUrl('next-sanity-fetch-strict')}`,\n      {cause: options},\n    )\n  }\n}\n","import {perspectiveCookieName} from '@sanity/preview-url-secret/constants'\nimport type {cookies} from 'next/headers'\n\nimport {sanitizePerspective} from '#live/sanitizePerspective'\nimport type {LivePerspective} from '#live/types'\n\n/**\n * This helper is intended for use with Next.js Cache Components (`cacheComponents: true`),\n * where `cookies()` and `draftMode()` cannot be called inside `'use cache'` boundaries.\n * Resolve the perspective once outside the cache boundary and pass it in as a prop / cache key.\n *\n * @example\n * ```tsx\n * import {cookies, draftMode} from 'next/headers'\n * import {defineQuery} from 'next-sanity'\n * import {resolvePerspectiveFromCookies, type LivePerspective} from 'next-sanity/live'\n * import {sanityFetch, sanityFetchStaticParams} from '#sanity/live'\n *\n * export async function generateStaticParams() {\n *   const query = defineQuery(`*[_type == \"page\" && defined(slug.current)]{\"slug\": slug.current}`)\n *   return await sanityFetchStaticParams({query})\n * }\n *\n * export default async function Page({params}: PageProps<'/[slug]'>) {\n *   const {isEnabled: isDraftMode} = await draftMode()\n *\n *   if (isDraftMode) {\n *     return (\n *       <Suspense>\n *         <DynamicPage params={params} />\n *       </Suspense>\n *     )\n *   }\n *\n *   const {slug} = await params\n *\n *   return <CachedPage slug={slug} perspective=\"published\" stega={false} />\n * }\n *\n * async function DynamicPage({params}: Pick<PageProps<'/[slug]'>, 'params'>) {\n *   const {slug} = await params\n *   const perspective = await resolvePerspectiveFromCookies({cookies: await cookies()})\n *\n *   return <CachedPage slug={slug} perspective={perspective} stega />\n * }\n *\n * async function CachedPage({\n *   slug,\n *   perspective,\n *   stega,\n * }: Awaited<PageProps<'/[slug]'>['params']> & {\n *   perspective: LivePerspective\n *   stega: boolean\n * }) {\n *   'use cache'\n *\n *   const query = defineQuery(`*[_type == \"page\" && slug.current == $slug][0]`)\n *   const {data} = await sanityFetch({query, params: {slug}, perspective, stega})\n *\n *   return <article>...</article>\n * }\n * ```\n *\n * @public\n */\nexport async function resolvePerspectiveFromCookies({\n  cookies: jar,\n}: {\n  cookies: Awaited<ReturnType<typeof cookies>>\n}): Promise<LivePerspective> {\n  return jar.has(perspectiveCookieName)\n    ? sanitizePerspective(jar.get(perspectiveCookieName)?.value, 'drafts')\n    : 'drafts'\n}\n","import {variantCookieName} from '@sanity/preview-url-secret/constants'\nimport type {cookies} from 'next/headers'\n\nimport {sanitizeVariant} from '#live/sanitizeVariant'\n\n/**\n * This helper is intended for use with Next.js Cache Components (`cacheComponents: true`),\n * where `cookies()` and `draftMode()` cannot be called inside `'use cache'` boundaries.\n * Resolve the variant once outside the cache boundary and pass it in as a prop / cache key.\n *\n * Unlike `resolvePerspectiveFromCookies` there is no fallback value: when no\n * variant cookie is set (or its value is invalid) it resolves to `undefined`,\n * meaning \"no variant selected\" and queries return base content.\n *\n * @example\n * ```tsx\n * import {cookies, draftMode} from 'next/headers'\n * import {defineQuery} from 'next-sanity'\n * import {\n *   resolvePerspectiveFromCookies,\n *   resolveVariantFromCookies,\n *   type LivePerspective,\n * } from 'next-sanity/live'\n * import {sanityFetch} from '#sanity/live'\n *\n * export default async function Page({params}: PageProps<'/[slug]'>) {\n *   const {isEnabled: isDraftMode} = await draftMode()\n *\n *   if (isDraftMode) {\n *     return (\n *       <Suspense>\n *         <DynamicPage params={params} />\n *       </Suspense>\n *     )\n *   }\n *\n *   const {slug} = await params\n *\n *   return <CachedPage slug={slug} perspective=\"published\" stega={false} />\n * }\n *\n * async function DynamicPage({params}: Pick<PageProps<'/[slug]'>, 'params'>) {\n *   const {slug} = await params\n *   const jar = await cookies()\n *   const perspective = await resolvePerspectiveFromCookies({cookies: jar})\n *   const variant = await resolveVariantFromCookies({cookies: jar})\n *\n *   return <CachedPage slug={slug} perspective={perspective} variant={variant} stega />\n * }\n *\n * async function CachedPage({\n *   slug,\n *   perspective,\n *   variant,\n *   stega,\n * }: Awaited<PageProps<'/[slug]'>['params']> & {\n *   perspective: LivePerspective\n *   variant: string | undefined\n *   stega: boolean\n * }) {\n *   'use cache'\n *\n *   const query = defineQuery(`*[_type == \"page\" && slug.current == $slug][0]`)\n *   const {data} = await sanityFetch({query, params: {slug}, perspective, variant, stega})\n *\n *   return <article>...</article>\n * }\n * ```\n *\n * @public\n */\nexport async function resolveVariantFromCookies({\n  cookies: jar,\n}: {\n  cookies: Awaited<ReturnType<typeof cookies>>\n}): Promise<string | undefined> {\n  return jar.has(variantCookieName) ? sanitizeVariant(jar.get(variantCookieName)?.value) : undefined\n}\n"],"mappings":";;;;;;;AAMA,SAAgBA,aAAW,QAA4B;CACrD,MAAM,EAAC,WAAU,IAAI,IAAI,OAAO,OAAO,IAAI,KAAK,CAAC;CACjD,WAAmB,MAAM;AAC3B;ACPA,SAAgB,8BAA8B,OAAwC;CACpF,IAAI,OAAO,MAAM,kBAAkB,WACjC,MAAM,IAAI,MACR,iJAAiJ,gBAAgB,yBAAyB,KAC1L,EAAC,OAAO,MAAK,CACf;AAEJ;AAEA,SAAgB,2BAA2B,SAGlC;CACP,IAAI,OAAO,QAAQ,gBAAgB,eAAe,QAAQ,gBAAgB,MACxE,MAAM,IAAI,MACR,kIAAkI,gBAAgB,0BAA0B,KAC5K,EAAC,OAAO,QAAO,CACjB;CAEF,IAAI,OAAO,QAAQ,UAAU,WAC3B,MAAM,IAAI,MACR,4IAA4I,gBAAgB,0BAA0B,KACtL,EAAC,OAAO,QAAO,CACjB;AAEJ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;ACsCA,eAAsB,8BAA8B,EAClD,SAAS,OAGkB;CAC3B,OAAO,IAAI,IAAI,qBAAqB,IAChC,oBAAoB,IAAI,IAAI,qBAAqB,CAAC,EAAE,OAAO,QAAQ,IACnE;AACN;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;ACFA,eAAsB,0BAA0B,EAC9C,SAAS,OAGqB;CAC9B,OAAO,IAAI,IAAI,iBAAiB,IAAI,gBAAgB,IAAI,IAAI,iBAAiB,CAAC,EAAE,KAAK,IAAI,KAAA;AAC3F"}
+{"version":3,"file":"resolveVariantFromCookies.js","names":["preconnect"],"sources":["../src/live/shared/preconnect.ts","../src/live/shared/strictValidation.ts","../src/live/shared/resolvePerspectiveFromCookies.ts","../src/live/shared/resolveVariantFromCookies.ts"],"sourcesContent":["import type {SanityClient} from 'next-sanity'\nimport {preconnect as reactDomPreconnect} from 'react-dom'\n\n/**\n * Uses the React DOM `preconnect` function to preconnect to the Live Event API origin early, Next.js will set the right headers and meta tags to speed up the connection.\n */\nexport function preconnect(client: SanityClient): void {\n  const {origin} = new URL(client.getUrl('', false))\n  reactDomPreconnect(origin)\n}\n","import {generateHelpUrl} from '@sanity/generate-help-url'\n\nexport function validateStrictSanityLiveProps(props: {includeDrafts?: unknown}): void {\n  if (typeof props.includeDrafts !== 'boolean') {\n    throw new Error(\n      `<SanityLive> requires an explicit \\`includeDrafts\\` prop (true or false) when \\`strict: true\\` is set on \\`defineLive\\`.\\n\\nMore information: ${generateHelpUrl('next-sanity-live-strict')}`,\n      {cause: props},\n    )\n  }\n}\n\nexport function validateStrictFetchOptions(options: {\n  perspective?: unknown\n  stega?: unknown\n}): void {\n  if (typeof options.perspective === 'undefined' || options.perspective === null) {\n    throw new Error(\n      `sanityFetch() requires an explicit \\`perspective\\` option when \\`strict: true\\` is set on \\`defineLive\\`.\\n\\nMore information: ${generateHelpUrl('next-sanity-fetch-strict')}`,\n      {cause: options},\n    )\n  }\n  if (typeof options.stega !== 'boolean') {\n    throw new Error(\n      `sanityFetch() requires an explicit \\`stega\\` option (true or false) when \\`strict: true\\` is set on \\`defineLive\\`.\\n\\nMore information: ${generateHelpUrl('next-sanity-fetch-strict')}`,\n      {cause: options},\n    )\n  }\n}\n","import {perspectiveCookieName} from '@sanity/preview-url-secret/constants'\nimport type {cookies} from 'next/headers'\n\nimport {sanitizePerspective} from '#live/sanitizePerspective'\nimport type {LivePerspective} from '#live/types'\n\n/**\n * This helper is intended for use with Next.js Cache Components (`cacheComponents: true`),\n * where `cookies()` and `draftMode()` cannot be called inside `'use cache'` boundaries.\n * Resolve the perspective once outside the cache boundary and pass it in as a prop / cache key.\n *\n * @example\n * ```tsx\n * import {cookies, draftMode} from 'next/headers'\n * import {defineQuery} from 'next-sanity'\n * import {resolvePerspectiveFromCookies, type LivePerspective} from 'next-sanity/live'\n * import {cachedSanity, cachedSanityStaticParams} from '#sanity/live'\n *\n * export async function generateStaticParams() {\n *   const query = defineQuery(`*[_type == \"page\" && defined(slug.current)]{\"slug\": slug.current}`)\n *   return await cachedSanityStaticParams({query})\n * }\n *\n * export default async function Page({params}: PageProps<'/[slug]'>) {\n *   const {isEnabled: isDraftMode} = await draftMode()\n *\n *   if (isDraftMode) {\n *     return (\n *       <Suspense>\n *         <DynamicPage params={params} />\n *       </Suspense>\n *     )\n *   }\n *\n *   const {slug} = await params\n *\n *   return <CachedPage slug={slug} perspective=\"published\" stega={false} />\n * }\n *\n * async function DynamicPage({params}: Pick<PageProps<'/[slug]'>, 'params'>) {\n *   const {slug} = await params\n *   const perspective = await resolvePerspectiveFromCookies({cookies: await cookies()})\n *\n *   return <CachedPage slug={slug} perspective={perspective} stega />\n * }\n *\n * async function CachedPage({\n *   slug,\n *   perspective,\n *   stega,\n * }: Awaited<PageProps<'/[slug]'>['params']> & {\n *   perspective: LivePerspective\n *   stega: boolean\n * }) {\n *   const query = defineQuery(`*[_type == \"page\" && slug.current == $slug][0]`)\n *   const {data} = await cachedSanity({query, params: {slug}, perspective, stega})\n *\n *   return <article>...</article>\n * }\n * ```\n *\n * @public\n */\nexport async function resolvePerspectiveFromCookies({\n  cookies: jar,\n}: {\n  cookies: Awaited<ReturnType<typeof cookies>>\n}): Promise<LivePerspective> {\n  return jar.has(perspectiveCookieName)\n    ? sanitizePerspective(jar.get(perspectiveCookieName)?.value, 'drafts')\n    : 'drafts'\n}\n","import {variantCookieName} from '@sanity/preview-url-secret/constants'\nimport type {cookies} from 'next/headers'\n\nimport {sanitizeVariant} from '#live/sanitizeVariant'\n\n/**\n * This helper is intended for use with Next.js Cache Components (`cacheComponents: true`),\n * where `cookies()` and `draftMode()` cannot be called inside `'use cache'` boundaries.\n * Resolve the variant once outside the cache boundary and pass it in as a prop / cache key.\n *\n * Unlike `resolvePerspectiveFromCookies` there is no fallback value: when no\n * variant cookie is set (or its value is invalid) it resolves to `undefined`,\n * meaning \"no variant selected\" and queries return base content.\n *\n * @example\n * ```tsx\n * import {cookies, draftMode} from 'next/headers'\n * import {defineQuery} from 'next-sanity'\n * import {\n *   resolvePerspectiveFromCookies,\n *   resolveVariantFromCookies,\n *   type LivePerspective,\n * } from 'next-sanity/live'\n * import {cachedSanity} from '#sanity/live'\n *\n * export default async function Page({params}: PageProps<'/[slug]'>) {\n *   const {isEnabled: isDraftMode} = await draftMode()\n *\n *   if (isDraftMode) {\n *     return (\n *       <Suspense>\n *         <DynamicPage params={params} />\n *       </Suspense>\n *     )\n *   }\n *\n *   const {slug} = await params\n *\n *   return <CachedPage slug={slug} perspective=\"published\" stega={false} />\n * }\n *\n * async function DynamicPage({params}: Pick<PageProps<'/[slug]'>, 'params'>) {\n *   const {slug} = await params\n *   const jar = await cookies()\n *   const perspective = await resolvePerspectiveFromCookies({cookies: jar})\n *   const variant = await resolveVariantFromCookies({cookies: jar})\n *\n *   return <CachedPage slug={slug} perspective={perspective} variant={variant} stega />\n * }\n *\n * async function CachedPage({\n *   slug,\n *   perspective,\n *   variant,\n *   stega,\n * }: Awaited<PageProps<'/[slug]'>['params']> & {\n *   perspective: LivePerspective\n *   variant: string | undefined\n *   stega: boolean\n * }) {\n *   const query = defineQuery(`*[_type == \"page\" && slug.current == $slug][0]`)\n *   const {data} = await cachedSanity({query, params: {slug}, perspective, variant, stega})\n *\n *   return <article>...</article>\n * }\n * ```\n *\n * @public\n */\nexport async function resolveVariantFromCookies({\n  cookies: jar,\n}: {\n  cookies: Awaited<ReturnType<typeof cookies>>\n}): Promise<string | undefined> {\n  return jar.has(variantCookieName) ? sanitizeVariant(jar.get(variantCookieName)?.value) : undefined\n}\n"],"mappings":";;;;;;;AAMA,SAAgBA,aAAW,QAA4B;CACrD,MAAM,EAAC,WAAU,IAAI,IAAI,OAAO,OAAO,IAAI,KAAK,CAAC;CACjD,WAAmB,MAAM;AAC3B;ACPA,SAAgB,8BAA8B,OAAwC;CACpF,IAAI,OAAO,MAAM,kBAAkB,WACjC,MAAM,IAAI,MACR,iJAAiJ,gBAAgB,yBAAyB,KAC1L,EAAC,OAAO,MAAK,CACf;AAEJ;AAEA,SAAgB,2BAA2B,SAGlC;CACP,IAAI,OAAO,QAAQ,gBAAgB,eAAe,QAAQ,gBAAgB,MACxE,MAAM,IAAI,MACR,kIAAkI,gBAAgB,0BAA0B,KAC5K,EAAC,OAAO,QAAO,CACjB;CAEF,IAAI,OAAO,QAAQ,UAAU,WAC3B,MAAM,IAAI,MACR,4IAA4I,gBAAgB,0BAA0B,KACtL,EAAC,OAAO,QAAO,CACjB;AAEJ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;ACoCA,eAAsB,8BAA8B,EAClD,SAAS,OAGkB;CAC3B,OAAO,IAAI,IAAI,qBAAqB,IAChC,oBAAoB,IAAI,IAAI,qBAAqB,CAAC,EAAE,OAAO,QAAQ,IACnE;AACN;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;ACFA,eAAsB,0BAA0B,EAC9C,SAAS,OAGqB;CAC9B,OAAO,IAAI,IAAI,iBAAiB,IAAI,gBAAgB,IAAI,IAAI,iBAAiB,CAAC,EAAE,KAAK,IAAI,KAAA;AAC3F"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "next-sanity",
-  "version": "13.3.0",
+  "version": "13.3.2",
   "description": "Sanity.io toolkit for Next.js",
   "keywords": [
     "live",
@@ -59,12 +59,12 @@
   },
   "dependencies": {
     "@portabletext/react": "^7.0.1",
-    "@sanity/client": "^7.26.0",
+    "@sanity/client": "^7.26.2",
     "@sanity/generate-help-url": "^4.0.0",
     "@sanity/preview-url-secret": "^4.1.2",
-    "@sanity/visual-editing": "^5.7.3",
+    "@sanity/visual-editing": "^6.0.1",
     "@sanity/webhook": "^4.0.4",
-    "groq": "^6.8.0",
+    "groq": "^6.9.2",
     "history": "^5.3.0"
   },
   "devDependencies": {
@@ -82,7 +82,7 @@
     "publint": "^0.3.22",
     "react": "^19.2.8",
     "react-dom": "^19.2.8",
-    "styled-components": "^6.4.4",
+    "styled-components": "^6.5.2",
     "tsdown": "^0.22.14",
     "typescript": "7.0.2",
     "vite": "^8.2.0",
@@ -91,7 +91,7 @@
     "vitest-package-exports": "^1.2.0"
   },
   "peerDependencies": {
-    "@sanity/client": "^7.26.0",
+    "@sanity/client": "^7.26.2",
     "next": "^16.0.0-0",
     "react": "^19.2.3",
     "react-dom": "^19.2.3",