npm - next-sanity - Versions diffs - 13.0.0-cache-components.42 → 13.0.0-cache-components.43 - Mend

next-sanity 13.0.0-cache-components.42 → 13.0.0-cache-components.43

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (24) hide show

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

@@ -1,4 +1,4 @@
-import { a as SanityLiveAction, c as SanityLiveOnReconnect, l as SanityLiveOnRestart, o as SanityLiveOnError, s as SanityLiveOnGoaway, u as SanityLiveOnWelcome } from "../../types.js";
+import { a as SanityLiveAction, c as SanityLiveOnGoaway, d as SanityLiveOnWelcome, l as SanityLiveOnReconnect, s as SanityLiveOnError, u as SanityLiveOnRestart } from "../../types.js";
 import { InitializedClientConfig } from "@sanity/client";
 interface SanityClientConfig extends Pick<InitializedClientConfig, "projectId" | "dataset" | "apiHost" | "apiVersion" | "useProjectHostname" | "token" | "requestTagPrefix"> {}
 interface SanityLiveProps {

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

@@ -1,8 +1,153 @@
 import { t as isCorsOriginError } from "../../../isCorsOriginError.js";
-import { d as StrictDefinedFetchType, f as StrictDefinedLiveProps, i as LivePerspective, n as DefinedFetchType, r as DefinedLiveProps, t as DefineLiveOptions } from "../../../types.js";
+import { a as SanityLiveAction, c as SanityLiveOnGoaway, d as SanityLiveOnWelcome, f as StrictDefinedFetchType, i as LivePerspective, l as SanityLiveOnReconnect, n as DefinedFetchType, o as SanityLiveActionContext, p as StrictDefinedLiveProps, r as DefinedLiveProps, s as SanityLiveOnError, t as DefineLiveOptions, u as SanityLiveOnRestart } from "../../../types.js";
 import { n as resolvePerspectiveFromCookies$1, t as parseTags } from "../../../parseTags.js";
 /**
-* One
+* Set up Sanity Live for Cache Components. `defineLive` returns `sanityFetch`
+* and `<SanityLive />`, which connect your Sanity client to the Live Content API
+* so cached pages can update in response to fine-grained content changes.
+*
+* With `strict: true`, `perspective` and `stega` become required
+* `sanityFetch` options, and `includeDrafts` becomes required on
+* `<SanityLive />`. Resolve dynamic values from `draftMode()` and `cookies()`
+* outside `'use cache'` boundaries, then pass them into cached components.
+*
+* @see [Live Content API](https://www.sanity.io/docs/content-lake/live-content-api)
+* @see [Sanity Live](https://www.sanity.io/live)
+*
+* @example
+* ```tsx
+* // sanity/live.ts
+* import {cookies, draftMode} from 'next/headers'
+* import {createClient} from 'next-sanity'
+* import {
+*   defineLive,
+*   resolvePerspectiveFromCookies,
+*   type LivePerspective,
+* } from 'next-sanity/live'
+*
+* const client = createClient({
+*   projectId: process.env.NEXT_PUBLIC_SANITY_PROJECT_ID,
+*   dataset: process.env.NEXT_PUBLIC_SANITY_DATASET,
+*   useCdn: true,
+*   perspective: 'published',
+* })
+* const token = process.env.SANITY_API_READ_TOKEN
+*
+* export const {sanityFetch, SanityLive} = defineLive({
+*   client,
+*   browserToken: token,
+*   serverToken: token,
+*   strict: true,
+* })
+*
+* export interface DynamicFetchOptions {
+*   perspective: LivePerspective
+*   stega: boolean
+* }
+*
+* // Resolve dynamic values outside 'use cache' boundaries.
+* export async function getDynamicFetchOptions(): Promise<DynamicFetchOptions> {
+*   const {isEnabled: isDraftMode} = await draftMode()
+*   if (!isDraftMode) {
+*     return {perspective: 'published', stega: false}
+*   }
+*
+*   const jar = await cookies()
+*   const perspective = await resolvePerspectiveFromCookies({cookies: jar})
+*   return {perspective: perspective ?? 'drafts', stega: true}
+* }
+* ```
+*
+* @example
+* ```tsx
+* // app/layout.tsx
+* import {draftMode} from 'next/headers'
+*
+* import {SanityLive} from '@/sanity/live'
+*
+* export default async function RootLayout({children}: {children: React.ReactNode}) {
+*   const {isEnabled: isDraftMode} = await draftMode()
+*
+*   return (
+*     <html lang="en">
+*       <body>
+*         {children}
+*         <SanityLive includeDrafts={isDraftMode} />
+*       </body>
+*     </html>
+*   )
+* }
+* ```
+*
+* @example
+* ```tsx
+* // app/[slug]/page.tsx
+* import {draftMode} from 'next/headers'
+* import {Suspense} from 'react'
+* import {defineQuery} from 'next-sanity'
+*
+* import {
+*   getDynamicFetchOptions,
+*   sanityFetch,
+*   type DynamicFetchOptions,
+* } from '@/sanity/live'
+*
+* const POSTS_SLUGS_QUERY = defineQuery(`
+*   *[_type == "post" && slug.current]{"slug": slug.current}
+* `)
+* const POST_QUERY = defineQuery(`
+*   *[_type == "post" && slug.current == $slug][0]
+* `)
+*
+* export async function generateStaticParams() {
+*   const {data} = await sanityFetch({
+*     query: POSTS_SLUGS_QUERY,
+*     perspective: 'published',
+*     stega: false,
+*   })
+*
+*   return data
+* }
+*
+* export default async function Page(props: PageProps<'/[slug]'>) {
+*   const {isEnabled: isDraftMode} = await draftMode()
+*   if (isDraftMode) {
+*     return (
+*       <Suspense fallback={<div>Loading...</div>}>
+*         <DynamicPage params={props.params} />
+*       </Suspense>
+*     )
+*   }
+*
+*   const {slug} = await props.params
+*   return <CachedPage slug={slug} perspective="published" stega={false} />
+* }
+*
+* async function DynamicPage(props: Pick<PageProps<'/[slug]'>, 'params'>) {
+*   const {slug} = await props.params
+*   const {perspective, stega} = await getDynamicFetchOptions()
+*
+*   return <CachedPage slug={slug} perspective={perspective} stega={stega} />
+* }
+*
+* async function CachedPage({
+*   slug,
+*   perspective,
+*   stega,
+* }: {slug: string} & DynamicFetchOptions) {
+*   'use cache'
+*
+*   const {data} = await sanityFetch({
+*     query: POST_QUERY,
+*     params: {slug},
+*     perspective,
+*     stega,
+*   })
+*
+*   return <pre>{JSON.stringify(data, null, 2)}</pre>
+* }
+* ```
+*
 * @public
 */
 declare function defineLive(config: DefineLiveOptions & {
@@ -12,7 +157,81 @@ declare function defineLive(config: DefineLiveOptions & {
   SanityLive: React.ComponentType<StrictDefinedLiveProps>;
 };
 /**
-* Two
+* Set up Sanity Live. `defineLive` returns `sanityFetch` and `<SanityLive />`,
+* which connect your Sanity client to the Live Content API so pages can serve
+* cached content and update in response to fine-grained content changes.
+*
+* @see [Live Content API](https://www.sanity.io/docs/content-lake/live-content-api)
+* @see [Sanity Live](https://www.sanity.io/live)
+*
+* @example
+* ```tsx
+* import {createClient} from 'next-sanity'
+* import {defineLive} from 'next-sanity/live'
+*
+* const client = createClient({
+*   projectId: process.env.NEXT_PUBLIC_SANITY_PROJECT_ID,
+*   dataset: process.env.NEXT_PUBLIC_SANITY_DATASET,
+*   useCdn: true,
+*   perspective: 'published',
+* })
+*
+* export const {sanityFetch, SanityLive} = defineLive({
+*   client,
+* })
+* ```
+*
+* @example
+* ```tsx
+* // app/layout.tsx
+* import {SanityLive} from '@/sanity/live'
+*
+* export default function RootLayout({children}: {children: React.ReactNode}) {
+*   return (
+*     <html lang="en">
+*       <body>
+*         {children}
+*         <SanityLive />
+*       </body>
+*     </html>
+*   )
+* }
+* ```
+*
+* @example
+* ```tsx
+* // app/[slug]/page.tsx
+* import {defineQuery} from 'next-sanity'
+* import {sanityFetch} from '@/sanity/live'
+*
+* const POSTS_SLUGS_QUERY = defineQuery(`
+*   *[_type == "post" && slug.current]{"slug": slug.current}
+* `)
+* const POST_QUERY = defineQuery(`
+*   *[_type == "post" && slug.current == $slug][0]
+* `)
+*
+* export async function generateStaticParams() {
+*   const {data} = await sanityFetch({
+*     query: POSTS_SLUGS_QUERY,
+*     perspective: 'published',
+*     stega: false,
+*   })
+*
+*   return data
+* }
+*
+* export default async function Page(props: PageProps<'/[slug]'>) {
+*   const {slug} = await props.params
+*   const {data} = await sanityFetch({
+*     query: POST_QUERY,
+*     params: {slug},
+*   })
+*
+*   return <pre>{JSON.stringify(data, null, 2)}</pre>
+* }
+* ```
+*
 * @public
 */
 declare function defineLive(config: DefineLiveOptions & {
@@ -50,5 +269,5 @@ declare function defineLive(config: DefineLiveOptions & {
 * @public
 */
 declare const resolvePerspectiveFromCookies: typeof resolvePerspectiveFromCookies$1;
-export { type LivePerspective, defineLive, isCorsOriginError, parseTags, resolvePerspectiveFromCookies };
+export { type DefineLiveOptions, type DefinedFetchType, type DefinedLiveProps, type LivePerspective, type SanityLiveAction, type SanityLiveActionContext, type SanityLiveOnError, type SanityLiveOnGoaway, type SanityLiveOnReconnect, type SanityLiveOnRestart, type SanityLiveOnWelcome, type StrictDefinedFetchType, type StrictDefinedLiveProps, defineLive, isCorsOriginError, parseTags, resolvePerspectiveFromCookies };
 //# sourceMappingURL=index.d.ts.map

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

	@@ -1 +1 @@
1	- {"version":3,"file":"index.d.ts","names":[],"sources":["../../../../src/live/conditions/default/index.ts"],"mappings":";;;~~AAsBA;;;;AAAA~~,iBAAgB,UAAA,CAAW,MAAA,EAAQ,iBAAA;EAAqB,MAAA;AAAA;EACtD,WAAA,EAAa,sBAAA;EACb,UAAA,EAAY,KAAA,CAAM,aAAA,CAAc,sBAAA;AAAA~~;;;;;iBAMlB~~,UAAA,CAAW,MAAA,EAAQ,iBAAA;EAAqB,MAAA;AAAA;EACtD,WAAA,EAAa,gBAAA;EACb,UAAA,EAAY,KAAA,CAAM,aAAA,CAAc,gBAAA;AAAA~~;AAFlC;;;;;;;;;;;;;;;;;;;;AAwCA;;;;;;;;AAxCA~~,~~cAwCa,~~6BAAA,SAAsC,+BAAA"}
1	+ {"version":3,"file":"index.d.ts","names":[],"sources":["../../../../src/live/conditions/default/index.ts"],"mappings":";;;AAuKA;;;;;;;;;;;;;;;;;;;;AAkFA;;;;;;;;;;;;;;;;;;;;AAoCA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAtHA,iBAAgB,UAAA,CAAW,MAAA,EAAQ,iBAAA;EAAqB,MAAA;AAAA;EACtD,WAAA,EAAa,sBAAA;EACb,UAAA,EAAY,KAAA,CAAM,aAAA,CAAc,sBAAA;AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAgFlB,UAAA,CAAW,MAAA,EAAQ,iBAAA;EAAqB,MAAA;AAAA;EACtD,WAAA,EAAa,gBAAA;EACb,UAAA,EAAY,KAAA,CAAM,aAAA,CAAc,gBAAA;AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;cAkCrB,6BAAA,SAAsC,+BAAA"}

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

@@ -1,9 +1,5 @@
 import { t as isCorsOriginError } from "../../../isCorsOriginError.js";
 import { t as parseTags } from "../../../parseTags.js";
-/**
-* Three
-* @public
-*/
 function defineLive(_config) {
 	throw new Error(`defineLive can't be imported by a client component`);
 }

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

	@@ -1 +1 @@
1	- {"version":3,"file":"index.js","names":[],"sources":["../../../../src/live/conditions/default/index.ts"],"sourcesContent":["// This is the fallback export condition for `import 'next-sanity/live'`,\n// it should have the same type definitions as the other conditions so that userland don't have to worry about setting the right\n// `customCondition` in their `tsconfig.json` in order to get accurate typings.\n// The implementation here though should all throw errors, as importing this file means userland made a mistake and somehow a client component is\n// trying to pull in something it shouldn't.\n\nimport type {resolvePerspectiveFromCookies as _resolvePerspectiveFromCookies} from '#live/resolvePerspectiveFromCookies'\nimport type {\n DefinedFetchType,\n DefinedLiveProps,\n DefineLiveOptions,\n StrictDefinedFetchType,\n StrictDefinedLiveProps,\n} from '#live/types'\n\nexport {isCorsOriginError} from '#live/isCorsOriginError'\nexport {parseTags} from '#live/parseTags'\n\n/*\n ~~One~~\n * @public\n /\nexport function defineLive(config: DefineLiveOptions & {strict: true}): {\n sanityFetch: StrictDefinedFetchType\n SanityLive: React.ComponentType<StrictDefinedLiveProps>\n}\n/\n ~~Two~~\n * @public\n /\nexport function defineLive(config: DefineLiveOptions & {strict?: false}): {\n sanityFetch: DefinedFetchType\n SanityLive: React.ComponentType<DefinedLiveProps>\n}\~~n/\n Three\n * @public\n /\~~nexport function defineLive(_config: DefineLiveOptions): never {\n throw new Error(`defineLive 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 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 {resolvePerspectiveFromCookies, type LivePerspective} from 'next-sanity/live'\n * import {sanityFetch} from '#sanity/live'\n \n function Page() {\n * const {isEnabled: isDraftMode} = await draftMode()\n * let perspective: LivePerspective = 'published'\n * if(isDraftMode) {\n * perspective = await resolvePerspectiveFromCookies({cookies: await cookies()})\n * }\n * const {data} = await cachedFetch({query, perspective, stega: isDraftMode})\n * }\n * function cachedFetch({query, params, perspective, stega}: {query: string, perspective: LivePerspective, stega: boolean}) {}) {\n * 'use cache'\n * const {data} = await sanityFetch({query, params, perspective, stega})\n * return {data}\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\nexport type {LivePerspective} from '#live/types'\n"],"mappings":"~~;;;;;;AAsCA~~,SAAgB,WAAW,SAAmC;AAC5D,OAAM,IAAI,MAAM,qDAAqD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA+BvE,MAAa,sCAA6E;AACxF,OAAM,IAAI,MAAM,wEAAwE"}
1	+ {"version":3,"file":"index.js","names":[],"sources":["../../../../src/live/conditions/default/index.ts"],"sourcesContent":["// This is the fallback export condition for `import 'next-sanity/live'`,\n// it should have the same type definitions as the other conditions so that userland don't have to worry about setting the right\n// `customCondition` in their `tsconfig.json` in order to get accurate typings.\n// The implementation here though should all throw errors, as importing this file means userland made a mistake and somehow a client component is\n// trying to pull in something it shouldn't.\n\nimport type {resolvePerspectiveFromCookies as _resolvePerspectiveFromCookies} from '#live/resolvePerspectiveFromCookies'\nimport type {\n DefinedFetchType,\n DefinedLiveProps,\n DefineLiveOptions,\n StrictDefinedFetchType,\n StrictDefinedLiveProps,\n} from '#live/types'\n\nexport {isCorsOriginError} from '#live/isCorsOriginError'\nexport {parseTags} from '#live/parseTags'\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 @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 * 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 * 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 * return {perspective: perspective ?? 'drafts', 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, stega} = await getDynamicFetchOptions()\n \n return <CachedPage slug={slug} perspective={perspective} stega={stega} />\n * }\n \n async function CachedPage({\n * slug,\n * perspective,\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 * 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 \n export const {sanityFetch, SanityLive} = defineLive({\n * client,\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\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 {resolvePerspectiveFromCookies, type LivePerspective} from 'next-sanity/live'\n * import {sanityFetch} from '#sanity/live'\n \n function Page() {\n * const {isEnabled: isDraftMode} = await draftMode()\n * let perspective: LivePerspective = 'published'\n * if(isDraftMode) {\n * perspective = await resolvePerspectiveFromCookies({cookies: await cookies()})\n * }\n * const {data} = await cachedFetch({query, perspective, stega: isDraftMode})\n * }\n * function cachedFetch({query, params, perspective, stega}: {query: string, perspective: LivePerspective, stega: boolean}) {}) {\n * 'use cache'\n * const {data} = await sanityFetch({query, params, perspective, stega})\n * return {data}\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\nexport type {\n DefinedFetchType,\n DefinedLiveProps,\n DefineLiveOptions,\n LivePerspective,\n SanityLiveAction,\n SanityLiveActionContext,\n SanityLiveOnError,\n SanityLiveOnGoaway,\n SanityLiveOnReconnect,\n SanityLiveOnRestart,\n SanityLiveOnWelcome,\n StrictDefinedFetchType,\n StrictDefinedLiveProps,\n} from '#live/types'\n"],"mappings":";;AA6PA,SAAgB,WAAW,SAAmC;AAC5D,OAAM,IAAI,MAAM,qDAAqD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA+BvE,MAAa,sCAA6E;AACxF,OAAM,IAAI,MAAM,wEAAwE"}

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

@@ -1,17 +1,244 @@
 import { t as isCorsOriginError } from "../../../isCorsOriginError.js";
-import { d as StrictDefinedFetchType, f as StrictDefinedLiveProps, i as LivePerspective, n as DefinedFetchType, r as DefinedLiveProps, t as DefineLiveOptions } from "../../../types.js";
+import { a as SanityLiveAction, c as SanityLiveOnGoaway, d as SanityLiveOnWelcome, f as StrictDefinedFetchType, i as LivePerspective, l as SanityLiveOnReconnect, n as DefinedFetchType, o as SanityLiveActionContext, p as StrictDefinedLiveProps, r as DefinedLiveProps, s as SanityLiveOnError, t as DefineLiveOptions, u as SanityLiveOnRestart } from "../../../types.js";
 import { n as resolvePerspectiveFromCookies, t as parseTags } from "../../../parseTags.js";
+/**
+* Set up Sanity Live for Cache Components. `defineLive` returns `sanityFetch`
+* and `<SanityLive />`, which connect your Sanity client to the Live Content API
+* so cached pages can update in response to fine-grained content changes.
+*
+* With `strict: true`, `perspective` and `stega` become required
+* `sanityFetch` options, and `includeDrafts` becomes required on
+* `<SanityLive />`. Resolve dynamic values from `draftMode()` and `cookies()`
+* outside `'use cache'` boundaries, then pass them into cached components.
+*
+* @see [Live Content API](https://www.sanity.io/docs/content-lake/live-content-api)
+* @see [Sanity Live](https://www.sanity.io/live)
+*
+* @example
+* ```tsx
+* // sanity/live.ts
+* import {cookies, draftMode} from 'next/headers'
+* import {createClient} from 'next-sanity'
+* import {
+*   defineLive,
+*   resolvePerspectiveFromCookies,
+*   type LivePerspective,
+* } from 'next-sanity/live'
+*
+* const client = createClient({
+*   projectId: process.env.NEXT_PUBLIC_SANITY_PROJECT_ID,
+*   dataset: process.env.NEXT_PUBLIC_SANITY_DATASET,
+*   useCdn: true,
+*   perspective: 'published',
+* })
+* const token = process.env.SANITY_API_READ_TOKEN
+*
+* export const {sanityFetch, SanityLive} = defineLive({
+*   client,
+*   browserToken: token,
+*   serverToken: token,
+*   strict: true,
+* })
+*
+* export interface DynamicFetchOptions {
+*   perspective: LivePerspective
+*   stega: boolean
+* }
+*
+* // Resolve dynamic values outside 'use cache' boundaries.
+* export async function getDynamicFetchOptions(): Promise<DynamicFetchOptions> {
+*   const {isEnabled: isDraftMode} = await draftMode()
+*   if (!isDraftMode) {
+*     return {perspective: 'published', stega: false}
+*   }
+*
+*   const jar = await cookies()
+*   const perspective = await resolvePerspectiveFromCookies({cookies: jar})
+*   return {perspective: perspective ?? 'drafts', stega: true}
+* }
+* ```
+*
+* @example
+* ```tsx
+* // app/layout.tsx
+* import {draftMode} from 'next/headers'
+*
+* import {SanityLive} from '@/sanity/live'
+*
+* export default async function RootLayout({children}: {children: React.ReactNode}) {
+*   const {isEnabled: isDraftMode} = await draftMode()
+*
+*   return (
+*     <html lang="en">
+*       <body>
+*         {children}
+*         <SanityLive includeDrafts={isDraftMode} />
+*       </body>
+*     </html>
+*   )
+* }
+* ```
+*
+* @example
+* ```tsx
+* // app/[slug]/page.tsx
+* import {draftMode} from 'next/headers'
+* import {Suspense} from 'react'
+* import {defineQuery} from 'next-sanity'
+*
+* import {
+*   getDynamicFetchOptions,
+*   sanityFetch,
+*   type DynamicFetchOptions,
+* } from '@/sanity/live'
+*
+* const POSTS_SLUGS_QUERY = defineQuery(`
+*   *[_type == "post" && slug.current]{"slug": slug.current}
+* `)
+* const POST_QUERY = defineQuery(`
+*   *[_type == "post" && slug.current == $slug][0]
+* `)
+*
+* export async function generateStaticParams() {
+*   const {data} = await sanityFetch({
+*     query: POSTS_SLUGS_QUERY,
+*     perspective: 'published',
+*     stega: false,
+*   })
+*
+*   return data
+* }
+*
+* export default async function Page(props: PageProps<'/[slug]'>) {
+*   const {isEnabled: isDraftMode} = await draftMode()
+*   if (isDraftMode) {
+*     return (
+*       <Suspense fallback={<div>Loading...</div>}>
+*         <DynamicPage params={props.params} />
+*       </Suspense>
+*     )
+*   }
+*
+*   const {slug} = await props.params
+*   return <CachedPage slug={slug} perspective="published" stega={false} />
+* }
+*
+* async function DynamicPage(props: Pick<PageProps<'/[slug]'>, 'params'>) {
+*   const {slug} = await props.params
+*   const {perspective, stega} = await getDynamicFetchOptions()
+*
+*   return <CachedPage slug={slug} perspective={perspective} stega={stega} />
+* }
+*
+* async function CachedPage({
+*   slug,
+*   perspective,
+*   stega,
+* }: {slug: string} & DynamicFetchOptions) {
+*   'use cache'
+*
+*   const {data} = await sanityFetch({
+*     query: POST_QUERY,
+*     params: {slug},
+*     perspective,
+*     stega,
+*   })
+*
+*   return <pre>{JSON.stringify(data, null, 2)}</pre>
+* }
+* ```
+*
+* @public
+*/
 declare function defineLive(config: DefineLiveOptions & {
   strict: true;
 }): {
   sanityFetch: StrictDefinedFetchType;
   SanityLive: React.ComponentType<StrictDefinedLiveProps>;
 };
+/**
+* Set up Sanity Live. `defineLive` returns `sanityFetch` and `<SanityLive />`,
+* which connect your Sanity client to the Live Content API so pages can serve
+* cached content and update in response to fine-grained content changes.
+*
+* @see [Live Content API](https://www.sanity.io/docs/content-lake/live-content-api)
+* @see [Sanity Live](https://www.sanity.io/live)
+*
+* @example
+* ```tsx
+* import {createClient} from 'next-sanity'
+* import {defineLive} from 'next-sanity/live'
+*
+* const client = createClient({
+*   projectId: process.env.NEXT_PUBLIC_SANITY_PROJECT_ID,
+*   dataset: process.env.NEXT_PUBLIC_SANITY_DATASET,
+*   useCdn: true,
+*   perspective: 'published',
+* })
+*
+* export const {sanityFetch, SanityLive} = defineLive({
+*   client,
+* })
+* ```
+*
+* @example
+* ```tsx
+* // app/layout.tsx
+* import {SanityLive} from '@/sanity/live'
+*
+* export default function RootLayout({children}: {children: React.ReactNode}) {
+*   return (
+*     <html lang="en">
+*       <body>
+*         {children}
+*         <SanityLive />
+*       </body>
+*     </html>
+*   )
+* }
+* ```
+*
+* @example
+* ```tsx
+* // app/[slug]/page.tsx
+* import {defineQuery} from 'next-sanity'
+* import {sanityFetch} from '@/sanity/live'
+*
+* const POSTS_SLUGS_QUERY = defineQuery(`
+*   *[_type == "post" && slug.current]{"slug": slug.current}
+* `)
+* const POST_QUERY = defineQuery(`
+*   *[_type == "post" && slug.current == $slug][0]
+* `)
+*
+* export async function generateStaticParams() {
+*   const {data} = await sanityFetch({
+*     query: POSTS_SLUGS_QUERY,
+*     perspective: 'published',
+*     stega: false,
+*   })
+*
+*   return data
+* }
+*
+* export default async function Page(props: PageProps<'/[slug]'>) {
+*   const {slug} = await props.params
+*   const {data} = await sanityFetch({
+*     query: POST_QUERY,
+*     params: {slug},
+*   })
+*
+*   return <pre>{JSON.stringify(data, null, 2)}</pre>
+* }
+* ```
+*
+* @public
+*/
 declare function defineLive(config: DefineLiveOptions & {
   strict?: false;
 }): {
   sanityFetch: DefinedFetchType;
   SanityLive: React.ComponentType<DefinedLiveProps>;
 };
-export { type LivePerspective, defineLive, isCorsOriginError, parseTags, resolvePerspectiveFromCookies };
+export { type DefineLiveOptions, type DefinedFetchType, type DefinedLiveProps, type LivePerspective, type SanityLiveAction, type SanityLiveActionContext, type SanityLiveOnError, type SanityLiveOnGoaway, type SanityLiveOnReconnect, type SanityLiveOnRestart, type SanityLiveOnWelcome, type StrictDefinedFetchType, type StrictDefinedLiveProps, defineLive, isCorsOriginError, parseTags, resolvePerspectiveFromCookies };
 //# sourceMappingURL=index.d.ts.map

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

	@@ -1 +1 @@
1	- {"version":3,"file":"index.d.ts","names":[],"sources":["../../../../src/live/conditions/next-js/defineLive.tsx"],"mappings":"~~;;;iBAgBgB~~,UAAA,CAAW,MAAA,EAAQ,iBAAA;EAAqB,MAAA;AAAA;EACtD,WAAA,EAAa,sBAAA;EACb,UAAA,EAAY,KAAA,CAAM,aAAA,CAAc,sBAAA;AAAA~~;AAAA~~,~~iBAElB,~~UAAA,CAAW,MAAA,EAAQ,iBAAA;EAAqB,MAAA;AAAA;EACtD,WAAA,EAAa,gBAAA;EACb,UAAA,EAAY,KAAA,CAAM,aAAA,CAAc,gBAAA;AAAA"}
1	+ {"version":3,"file":"index.d.ts","names":[],"sources":["../../../../src/live/conditions/next-js/defineLive.tsx"],"mappings":";;;;;;AAqKA;;;;;;;;;;;;;;;;;;;;AAkFA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAlFgB,UAAA,CAAW,MAAA,EAAQ,iBAAA;EAAqB,MAAA;AAAA;EACtD,WAAA,EAAa,sBAAA;EACb,UAAA,EAAY,KAAA,CAAM,aAAA,CAAc,sBAAA;AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAgFlB,UAAA,CAAW,MAAA,EAAQ,iBAAA;EAAqB,MAAA;AAAA;EACtD,WAAA,EAAa,gBAAA;EACb,UAAA,EAAY,KAAA,CAAM,aAAA,CAAc,gBAAA;AAAA"}

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

	@@ -1 +1 @@
1	- {"version":3,"file":"index.js","names":["SanityLive","SanityLiveClientComponent"],"sources":["../../../../src/live/conditions/next-js/defineLive.tsx"],"sourcesContent":["import {SanityLive as SanityLiveClientComponent} from 'next-sanity/live/client-components'\nimport {refreshAction, revalidateSyncTagsAction} from 'next-sanity/live/server-actions'\nimport {cacheLife, cacheTag} from 'next/cache'\nimport {PHASE_PRODUCTION_BUILD} from 'next/constants'\nimport {preconnect} from 'react-dom'\n\nimport {cacheTagPrefixes, revalidate} from '#live/constants'\nimport {validateStrictFetchOptions, validateStrictSanityLiveProps} from '#live/strictValidation'\nimport type {\n DefinedFetchType,\n DefinedLiveProps,\n DefineLiveOptions,\n StrictDefinedFetchType,\n StrictDefinedLiveProps,\n} from '#live/types'\n\nexport function defineLive(config: DefineLiveOptions & {strict: true}): {\n sanityFetch: StrictDefinedFetchType\n SanityLive: React.ComponentType<StrictDefinedLiveProps>\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 !== 'production' && !serverToken && serverToken !== false) {\n console.warn(\n 'No `serverToken` provided to `defineLive`. This means that only published content will be fetched and respond to live events. You can silence this warning by setting `serverToken: false`.',\n )\n }\n\n if (process.env.NODE_ENV !== 'production' && !browserToken && browserToken !== false) {\n console.warn(\n 'No `browserToken` provided to `defineLive`. This means that live previewing drafts will only work when using the Presentation Tool in your Sanity Studio. To support live previewing drafts stand-alone, provide a `browserToken`. It is shared with the browser so it should only have Viewer rights or lower. You can silence this warning by setting `browserToken: false`.',\n )\n }\n\n const client = _client.withConfig({allowReconfigure: false, useCdn: true})\n const {token: originalToken, perspective: originalPerspective = 'published'} = client.config()\n\n const sanityFetch: DefinedFetchType = async function sanityFetch({\n query,\n params = {},\n perspective: _perspective,\n stega: _stega,\n tags: customCacheTags = [],\n requestTag = 'next-loader.fetch.cache-components',\n }) {\n if (strict) {\n validateStrictFetchOptions({perspective: _perspective, stega: _stega})\n }\n const perspective = _perspective ?? originalPerspective\n const stega = _stega ?? false\n const useCdn = perspective === 'published'\n const isBuildPhase = process.env['NEXT_PHASE'] === PHASE_PRODUCTION_BUILD\n const cacheMode = useCdn && !isBuildPhase ? 'noStale' : undefined\n\n const cacheTagPrefix =\n perspective === 'published' ? cacheTagPrefixes.published : cacheTagPrefixes.drafts\n const {result, resultSourceMap, syncTags} = await client.fetch(query, await params, {\n filterResponse: false,\n returnQuery: false,\n perspective,\n useCdn,\n stega,\n cacheMode,\n tag: requestTag,\n token: perspective === 'published' ? originalToken : serverToken \|\| originalToken, // @TODO can pass undefined instead of config.token here?\n })\n const tags = [...customCacheTags, ...(syncTags \|\| []).map((tag) => `${cacheTagPrefix}${tag}`)]\n /*\n The tags used here, are expired later on in the `expireTags` Server Action with the `expireTag` function from `next/cache`\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({revalidate})\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 = false,\n action = revalidateSyncTagsAction,\n onReconnect = refreshAction,\n onRestart = refreshAction,\n\n onWelcome,\n onError,\n onGoAway,\n\n refreshOnMount = false,\n refreshOnFocus = false,\n refreshOnReconnect = false,\n requestTag = 'next-loader.live.cache-components',\n } = props\n\n const shouldIncludeDrafts = typeof browserToken === 'string' && includeDrafts\n\n const {projectId, dataset, apiHost, apiVersion, useProjectHostname, requestTagPrefix} =\n client.config()\n\n // Preconnect to the Live Event API origin early, as the Sanity API is almost always on a different origin than the app\n const {origin} = new URL(client.getUrl('', false))\n preconnect(origin)\n\n return (\n <SanityLiveClientComponent\n config={{\n projectId,\n dataset,\n apiHost,\n apiVersion,\n useProjectHostname,\n requestTagPrefix,\n token: shouldIncludeDrafts ? browserToken : undefined,\n }}\n includeDrafts={shouldIncludeDrafts}\n action={action}\n onReconnect={onReconnect}\n onRestart={onRestart}\n onWelcome={onWelcome}\n onError={onError}\n onGoAway={onGoAway}\n requestTag={requestTag}\n refreshOnMount={refreshOnMount}\n refreshOnFocus={refreshOnFocus}\n refreshOnReconnect={refreshOnReconnect}\n />\n )\n }\n SanityLive.displayName = 'SanityLiveServerComponent'\n\n return {sanityFetch, SanityLive}\n}\n"],"mappings":";;;;;;;;;;AAwBA,SAAgB,WAAW,QAA2B;CACpD,MAAM,EAAC,QAAQ,SAAS,aAAa,cAAc,SAAS,UAAS;AAErE,KAAI,CAAC,QACH,OAAM,IAAI,MAAM,oDAAoD;AAGtE,KAAI,QAAQ,IAAI,aAAa,gBAAgB,CAAC,eAAe,gBAAgB,MAC3E,SAAQ,KACN,8LACD;AAGH,KAAI,QAAQ,IAAI,aAAa,gBAAgB,CAAC,gBAAgB,iBAAiB,MAC7E,SAAQ,KACN,iXACD;CAGH,MAAM,SAAS,QAAQ,WAAW;EAAC,kBAAkB;EAAO,QAAQ;EAAK,CAAC;CAC1E,MAAM,EAAC,OAAO,eAAe,aAAa,sBAAsB,gBAAe,OAAO,QAAQ;CAE9F,MAAM,cAAgC,eAAe,YAAY,EAC/D,OACA,SAAS,EAAE,EACX,aAAa,cACb,OAAO,QACP,MAAM,kBAAkB,EAAE,EAC1B,aAAa,wCACZ;AACD,MAAI,OACF,4BAA2B;GAAC,aAAa;GAAc,OAAO;GAAO,CAAC;EAExE,MAAM,cAAc,gBAAgB;EACpC,MAAM,QAAQ,UAAU;EACxB,MAAM,SAAS,gBAAgB;EAC/B,MAAM,eAAe,QAAQ,IAAI,kBAAkB;EACnD,MAAM,YAAY,UAAU,CAAC,eAAe,YAAY,KAAA;EAExD,MAAM,iBACJ,gBAAgB,cAAc,iBAAiB,YAAY,iBAAiB;EAC9E,MAAM,EAAC,QAAQ,iBAAiB,aAAY,MAAM,OAAO,MAAM,OAAO,MAAM,QAAQ;GAClF,gBAAgB;GAChB,aAAa;GACb;GACA;GACA;GACA;GACA,KAAK;GACL,OAAO,gBAAgB,cAAc,gBAAgB,eAAe;GACrE,CAAC;EACF,MAAM,OAAO,CAAC,GAAG,iBAAiB,IAAI,YAAY,EAAE,EAAE,KAAK,QAAQ,GAAG,iBAAiB,MAAM,CAAC;;;;AAI9F,WAAS,GAAG,KAAK;;;;;AAKjB,YAAU,EAAC,YAAW,CAAC;AAEvB,SAAO;GAAC,MAAM;GAAQ,WAAW,mBAAmB;GAAM;GAAK;;CAGjE,MAAMA,eAAoD,SAASA,aAAW,OAAO;AACnF,MAAI,OACF,+BAA8B,MAAM;EAEtC,MAAM,EACJ,gBAAgB,OAChB,SAAS,0BACT,cAAc,eACd,YAAY,eAEZ,WACA,SACA,UAEA,iBAAiB,OACjB,iBAAiB,OACjB,qBAAqB,OACrB,aAAa,wCACX;EAEJ,MAAM,sBAAsB,OAAO,iBAAiB,YAAY;EAEhE,MAAM,EAAC,WAAW,SAAS,SAAS,YAAY,oBAAoB,qBAClE,OAAO,QAAQ;EAGjB,MAAM,EAAC,WAAU,IAAI,IAAI,OAAO,OAAO,IAAI,MAAM,CAAC;AAClD,aAAW,OAAO;AAElB,SACE,oBAACC,YAAD;GACE,QAAQ;IACN;IACA;IACA;IACA;IACA;IACA;IACA,OAAO,sBAAsB,eAAe,KAAA;IAC7C;GACD,eAAe;GACP;GACK;GACF;GACA;GACF;GACC;GACE;GACI;GACA;GACI;GACpB,CAAA;;AAGN,cAAW,cAAc;AAEzB,QAAO;EAAC;EAAa,YAAA;EAAW"}
1	+ {"version":3,"file":"index.js","names":["SanityLive","SanityLiveClientComponent"],"sources":["../../../../src/live/conditions/next-js/defineLive.tsx"],"sourcesContent":["import {SanityLive as SanityLiveClientComponent} from 'next-sanity/live/client-components'\nimport {refreshAction, revalidateSyncTagsAction} from 'next-sanity/live/server-actions'\nimport {cacheLife, cacheTag} from 'next/cache'\nimport {PHASE_PRODUCTION_BUILD} from 'next/constants'\nimport {preconnect} from 'react-dom'\n\nimport {cacheTagPrefixes, revalidate} from '#live/constants'\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 @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 * 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 * 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 * return {perspective: perspective ?? 'drafts', 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, stega} = await getDynamicFetchOptions()\n \n return <CachedPage slug={slug} perspective={perspective} stega={stega} />\n * }\n \n async function CachedPage({\n * slug,\n * perspective,\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 * 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 \n export const {sanityFetch, SanityLive} = defineLive({\n * client,\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 !== 'production' && !serverToken && serverToken !== false) {\n console.warn(\n 'No `serverToken` provided to `defineLive`. This means that only published content will be fetched and respond to live events. You can silence this warning by setting `serverToken: false`.',\n )\n }\n\n if (process.env.NODE_ENV !== 'production' && !browserToken && browserToken !== false) {\n console.warn(\n 'No `browserToken` provided to `defineLive`. This means that live previewing drafts will only work when using the Presentation Tool in your Sanity Studio. To support live previewing drafts stand-alone, provide a `browserToken`. It is shared with the browser so it should only have Viewer rights or lower. You can silence this warning by setting `browserToken: false`.',\n )\n }\n\n const client = _client.withConfig({allowReconfigure: false, useCdn: true})\n const {token: originalToken, perspective: originalPerspective = 'published'} = client.config()\n\n const sanityFetch: DefinedFetchType = async function sanityFetch({\n query,\n params = {},\n perspective: _perspective,\n stega: _stega,\n tags: customCacheTags = [],\n requestTag = 'next-loader.fetch.cache-components',\n }) {\n if (strict) {\n validateStrictFetchOptions({perspective: _perspective, stega: _stega})\n }\n const perspective = _perspective ?? originalPerspective\n const stega = _stega ?? false\n const useCdn = perspective === 'published'\n const isBuildPhase = process.env['NEXT_PHASE'] === PHASE_PRODUCTION_BUILD\n const cacheMode = useCdn && !isBuildPhase ? 'noStale' : undefined\n\n const cacheTagPrefix =\n perspective === 'published' ? cacheTagPrefixes.published : cacheTagPrefixes.drafts\n const {result, resultSourceMap, syncTags} = await client.fetch(query, await params, {\n filterResponse: false,\n returnQuery: false,\n perspective,\n useCdn,\n stega,\n cacheMode,\n tag: requestTag,\n token: perspective === 'published' ? originalToken : serverToken \|\| originalToken, // @TODO can pass undefined instead of config.token here?\n })\n const tags = [...customCacheTags, ...(syncTags \|\| []).map((tag) => `${cacheTagPrefix}${tag}`)]\n /\n The tags used here, are expired later on in the `expireTags` Server Action with the `expireTag` function from `next/cache`\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({revalidate})\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 = false,\n action = revalidateSyncTagsAction,\n onReconnect = refreshAction,\n onRestart = refreshAction,\n\n onWelcome,\n onError,\n onGoAway,\n\n refreshOnMount = false,\n refreshOnFocus = false,\n refreshOnReconnect = false,\n requestTag = 'next-loader.live.cache-components',\n } = props\n\n const shouldIncludeDrafts = typeof browserToken === 'string' && includeDrafts\n\n const {projectId, dataset, apiHost, apiVersion, useProjectHostname, requestTagPrefix} =\n client.config()\n\n // Preconnect to the Live Event API origin early, as the Sanity API is almost always on a different origin than the app\n const {origin} = new URL(client.getUrl('', false))\n preconnect(origin)\n\n return (\n <SanityLiveClientComponent\n config={{\n projectId,\n dataset,\n apiHost,\n apiVersion,\n useProjectHostname,\n requestTagPrefix,\n token: shouldIncludeDrafts ? browserToken : undefined,\n }}\n includeDrafts={shouldIncludeDrafts}\n action={action}\n onReconnect={onReconnect}\n onRestart={onRestart}\n onWelcome={onWelcome}\n onError={onError}\n onGoAway={onGoAway}\n requestTag={requestTag}\n refreshOnMount={refreshOnMount}\n refreshOnFocus={refreshOnFocus}\n refreshOnReconnect={refreshOnReconnect}\n />\n )\n }\n SanityLive.displayName = 'SanityLiveServerComponent'\n\n return {sanityFetch, SanityLive}\n}\n"],"mappings":";;;;;;;;;;AA2PA,SAAgB,WAAW,QAA2B;CACpD,MAAM,EAAC,QAAQ,SAAS,aAAa,cAAc,SAAS,UAAS;AAErE,KAAI,CAAC,QACH,OAAM,IAAI,MAAM,oDAAoD;AAGtE,KAAI,QAAQ,IAAI,aAAa,gBAAgB,CAAC,eAAe,gBAAgB,MAC3E,SAAQ,KACN,8LACD;AAGH,KAAI,QAAQ,IAAI,aAAa,gBAAgB,CAAC,gBAAgB,iBAAiB,MAC7E,SAAQ,KACN,iXACD;CAGH,MAAM,SAAS,QAAQ,WAAW;EAAC,kBAAkB;EAAO,QAAQ;EAAK,CAAC;CAC1E,MAAM,EAAC,OAAO,eAAe,aAAa,sBAAsB,gBAAe,OAAO,QAAQ;CAE9F,MAAM,cAAgC,eAAe,YAAY,EAC/D,OACA,SAAS,EAAE,EACX,aAAa,cACb,OAAO,QACP,MAAM,kBAAkB,EAAE,EAC1B,aAAa,wCACZ;AACD,MAAI,OACF,4BAA2B;GAAC,aAAa;GAAc,OAAO;GAAO,CAAC;EAExE,MAAM,cAAc,gBAAgB;EACpC,MAAM,QAAQ,UAAU;EACxB,MAAM,SAAS,gBAAgB;EAC/B,MAAM,eAAe,QAAQ,IAAI,kBAAkB;EACnD,MAAM,YAAY,UAAU,CAAC,eAAe,YAAY,KAAA;EAExD,MAAM,iBACJ,gBAAgB,cAAc,iBAAiB,YAAY,iBAAiB;EAC9E,MAAM,EAAC,QAAQ,iBAAiB,aAAY,MAAM,OAAO,MAAM,OAAO,MAAM,QAAQ;GAClF,gBAAgB;GAChB,aAAa;GACb;GACA;GACA;GACA;GACA,KAAK;GACL,OAAO,gBAAgB,cAAc,gBAAgB,eAAe;GACrE,CAAC;EACF,MAAM,OAAO,CAAC,GAAG,iBAAiB,IAAI,YAAY,EAAE,EAAE,KAAK,QAAQ,GAAG,iBAAiB,MAAM,CAAC;;;;AAI9F,WAAS,GAAG,KAAK;;;;;AAKjB,YAAU,EAAC,YAAW,CAAC;AAEvB,SAAO;GAAC,MAAM;GAAQ,WAAW,mBAAmB;GAAM;GAAK;;CAGjE,MAAMA,eAAoD,SAASA,aAAW,OAAO;AACnF,MAAI,OACF,+BAA8B,MAAM;EAEtC,MAAM,EACJ,gBAAgB,OAChB,SAAS,0BACT,cAAc,eACd,YAAY,eAEZ,WACA,SACA,UAEA,iBAAiB,OACjB,iBAAiB,OACjB,qBAAqB,OACrB,aAAa,wCACX;EAEJ,MAAM,sBAAsB,OAAO,iBAAiB,YAAY;EAEhE,MAAM,EAAC,WAAW,SAAS,SAAS,YAAY,oBAAoB,qBAClE,OAAO,QAAQ;EAGjB,MAAM,EAAC,WAAU,IAAI,IAAI,OAAO,OAAO,IAAI,MAAM,CAAC;AAClD,aAAW,OAAO;AAElB,SACE,oBAACC,YAAD;GACE,QAAQ;IACN;IACA;IACA;IACA;IACA;IACA;IACA,OAAO,sBAAsB,eAAe,KAAA;IAC7C;GACD,eAAe;GACP;GACK;GACF;GACA;GACF;GACC;GACE;GACI;GACA;GACI;GACpB,CAAA;;AAGN,cAAW,cAAc;AAEzB,QAAO;EAAC;EAAa,YAAA;EAAW"}