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

package/dist/SanityLive.js

@@ -10,7 +10,7 @@ const RefreshOnMount = dynamic(() => import("./RefreshOnMount.js"));
 const RefreshOnInterval = dynamic(() => import("./RefreshOnInterval.js"));
 const RefreshOnReconnect = dynamic(() => import("./RefreshOnReconnect.js"));
 function SanityLive(props) {
-	const { config, includeDrafts = false, action, onError, onWelcome = handleWelcome, onReconnect, onRestart, onGoAway = handleGoaway, refreshOnMount = false, refreshOnFocus = false, refreshOnReconnect = true, requestTag } = props;
+	const { config, includeDrafts = false, requestTag, waitFor, action, onError, onWelcome = handleWelcome, onReconnect, onRestart, onGoAway = handleGoaway, refreshOnMount = false, refreshOnFocus = false, refreshOnReconnect = true } = props;
 	const { projectId, dataset, apiHost, apiVersion, useProjectHostname, token, requestTagPrefix } = config;
 	const actionContext = { includeDrafts };
 	const client = useMemo(() => createClient({
@@ -71,7 +71,8 @@ function SanityLive(props) {
 	useEffect(() => {
 		const subscription = client.live.events({
 			includeDrafts,
-			tag: requestTag
+			tag: requestTag,
+			waitFor
 		}).subscribe({
 			next: handleLiveEvent,
 			error: handleError
@@ -80,7 +81,8 @@ function SanityLive(props) {
 	}, [
 		client.live,
 		requestTag,
-		includeDrafts
+		includeDrafts,
+		waitFor
 	]);
 	return /* @__PURE__ */ jsxs(Fragment, { children: [
 		refreshOnMount && /* @__PURE__ */ jsx(RefreshOnMount, {}),

package/dist/SanityLive.js.map

@@ -1 +1 @@
-{"version":3,"file":"SanityLive.js","names":[],"sources":["../src/live/client-components/SanityLive.tsx"],"sourcesContent":["import {createClient, type InitializedClientConfig, type LiveEvent} from '@sanity/client'\nimport dynamic from 'next/dynamic'\nimport {useRouter} from 'next/navigation'\nimport {startTransition, useEffect, useEffectEvent, useMemo, useState} from 'react'\n\nimport {cacheTagPrefixes} from '#live/constants'\nimport {isCorsOriginError} from '#live/isCorsOriginError'\nimport type {\n  SanityLiveAction,\n  SanityLiveActionContext,\n  SanityLiveOnError,\n  SanityLiveOnGoaway,\n  SanityLiveOnReconnect,\n  SanityLiveOnRestart,\n  SanityLiveOnWelcome,\n} from '#live/types'\n\nconst RefreshOnFocus = dynamic(() => import('./RefreshOnFocus'))\nconst RefreshOnMount = dynamic(() => import('./RefreshOnMount'))\nconst RefreshOnInterval = dynamic(() => import('./RefreshOnInterval'))\nconst RefreshOnReconnect = dynamic(() => import('./RefreshOnReconnect'))\n\ninterface SanityClientConfig extends Pick<\n  InitializedClientConfig,\n  | 'projectId'\n  | 'dataset'\n  | 'apiHost'\n  | 'apiVersion'\n  | 'useProjectHostname'\n  | 'token'\n  | 'requestTagPrefix'\n> {}\n\nexport interface SanityLiveProps {\n  config: SanityClientConfig\n  includeDrafts?: boolean\n  requestTag: string\n\n  action: SanityLiveAction\n  onError: SanityLiveOnError | false | undefined\n  onWelcome: SanityLiveOnWelcome | false | undefined\n  onReconnect: SanityLiveOnReconnect | false | undefined\n  onRestart: SanityLiveOnRestart | false | undefined\n  onGoAway: SanityLiveOnGoaway | false | undefined\n\n  refreshOnMount?: boolean\n  refreshOnFocus?: boolean\n  refreshOnReconnect?: boolean\n}\n\nfunction SanityLive(props: SanityLiveProps): React.JSX.Element | null {\n  const {\n    config,\n    includeDrafts = false,\n    action,\n    onError,\n    onWelcome = handleWelcome,\n    onReconnect,\n    onRestart,\n    onGoAway = handleGoaway,\n    refreshOnMount = false,\n    refreshOnFocus = false,\n    refreshOnReconnect = true,\n    requestTag,\n  } = props\n  const {projectId, dataset, apiHost, apiVersion, useProjectHostname, token, requestTagPrefix} =\n    config\n  const actionContext = {includeDrafts} satisfies SanityLiveActionContext\n\n  const client = useMemo(\n    () =>\n      createClient({\n        projectId,\n        dataset,\n        apiHost,\n        apiVersion,\n        useProjectHostname,\n        ignoreBrowserTokenWarning: true,\n        token,\n        useCdn: false,\n        requestTagPrefix,\n      }),\n    [apiHost, apiVersion, dataset, projectId, requestTagPrefix, token, useProjectHostname],\n  )\n\n  const [refreshOnInterval, setRefreshOnInterval] = useState<number | false>(false)\n\n  const [error, setError] = useState<unknown>(null)\n  if (error) {\n    // Throw during render to bubble up to the nearest <ErrorBoundary>, if `onError` is provided we won't rethrow\n    throw error\n  }\n  const handleError = useEffectEvent((error: unknown) => {\n    if (onError) {\n      void onError(error, actionContext)\n    } else {\n      setError(\n        isCorsOriginError(error)\n          ? new Error(\n              `Sanity Live is unable to connect to the Sanity API as the current origin - ${window.origin} - is not in the list of allowed CORS origins for this Sanity Project.${error.addOriginUrl ? ` Add it here: ${error.addOriginUrl}` : ''}`,\n              {cause: error},\n            )\n          : error,\n      )\n    }\n  })\n\n  const router = useRouter()\n  const handleLiveEvent = useEffectEvent((event: LiveEvent) => {\n    switch (event.type) {\n      case 'welcome': {\n        // Disable long polling when welcome event is received, this is a no-op if long polling is already disabled\n        startTransition(() => setRefreshOnInterval(false))\n\n        if (onWelcome) {\n          startTransition(() => onWelcome(event, actionContext))\n        }\n        break\n      }\n      case 'message': {\n        startTransition(() =>\n          action(\n            event.tags.map(\n              (tag) =>\n                `${includeDrafts ? cacheTagPrefixes.drafts : cacheTagPrefixes.published}${tag}`,\n            ),\n          ).then((result) => {\n            if (result === 'refresh') {\n              startTransition(() => router.refresh())\n            }\n          }),\n        )\n        break\n      }\n      case 'restart': {\n        // Disable long polling when restart event is received, this is a no-op if long polling is already disabled\n        startTransition(() => setRefreshOnInterval(false))\n\n        if (onRestart) {\n          startTransition(() => onRestart(event, actionContext))\n        }\n        break\n      }\n      case 'reconnect': {\n        // Disable long polling when reconnect event is received, this is a no-op if long polling is already disabled\n        startTransition(() => setRefreshOnInterval(false))\n\n        if (onReconnect) {\n          startTransition(() => onReconnect(event, actionContext))\n        }\n        break\n      }\n      case 'goaway': {\n        if (onGoAway) {\n          startTransition(() =>\n            onGoAway(event, actionContext, (interval) =>\n              startTransition(() => setRefreshOnInterval(interval)),\n            ),\n          )\n        } else if (!onGoAway) {\n          handleError(\n            new Error(\n              `Sanity Live connection closed, automatic revalidation is disabled, the server gave this reason: ${event.reason}`,\n              {cause: event},\n            ),\n          )\n        }\n        break\n      }\n      default:\n        handleError(new Error(`Unknown live event type`, {cause: event}))\n        break\n    }\n  })\n  useEffect(() => {\n    const subscription = client.live\n      .events({includeDrafts, tag: requestTag})\n      .subscribe({next: handleLiveEvent, error: handleError})\n    return () => subscription.unsubscribe()\n  }, [client.live, requestTag, includeDrafts])\n\n  return (\n    <>\n      {refreshOnMount && <RefreshOnMount />}\n      {refreshOnInterval && Number.isFinite(refreshOnInterval) && refreshOnInterval > 0 && (\n        <RefreshOnInterval interval={refreshOnInterval} />\n      )}\n      {refreshOnFocus && <RefreshOnFocus />}\n      {refreshOnReconnect && <RefreshOnReconnect />}\n    </>\n  )\n}\n\nSanityLive.displayName = 'SanityLiveClientComponent'\n\nexport default SanityLive\n\nconst handleWelcome: SanityLiveOnWelcome = (_, {includeDrafts}) => {\n  // oxlint-disable-next-line no-console\n  console.info(\n    `<SanityLive${includeDrafts ? ' includeDrafts' : ''}> is connected and listening for live events to ${includeDrafts ? 'all content including drafts and version documents in content releases' : 'published content'}`,\n  )\n}\n\nconst handleGoaway: SanityLiveOnGoaway = (event, {includeDrafts}, setLongPollingInterval) => {\n  const interval = 30_000\n  console.warn(\n    `<SanityLive${includeDrafts ? ' includeDrafts' : ''}> connection is closed after receiving a 'goaway' event, the server gave this reason:`,\n    event.reason,\n    `Content will now be refreshed every ${interval / 1_000} seconds`,\n  )\n  setLongPollingInterval(interval)\n}\n"],"mappings":"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"}
+{"version":3,"file":"SanityLive.js","names":[],"sources":["../src/live/client-components/SanityLive.tsx"],"sourcesContent":["import {createClient, type LiveEvent} from '@sanity/client'\nimport dynamic from 'next/dynamic'\nimport {useRouter} from 'next/navigation'\nimport {useEffect, useMemo, useState, useEffectEvent, startTransition} from 'react'\n\nimport {cacheTagPrefixes} from '#live/constants'\nimport {isCorsOriginError} from '#live/isCorsOriginError'\nimport type {\n  SanityClientConfig,\n  SanityLiveAction,\n  SanityLiveActionContext,\n  SanityLiveOnError,\n  SanityLiveOnGoaway,\n  SanityLiveOnReconnect,\n  SanityLiveOnRestart,\n  SanityLiveOnWelcome,\n} from '#live/types'\n\nconst RefreshOnFocus = dynamic(() => import('./RefreshOnFocus'))\nconst RefreshOnMount = dynamic(() => import('./RefreshOnMount'))\nconst RefreshOnInterval = dynamic(() => import('./RefreshOnInterval'))\nconst RefreshOnReconnect = dynamic(() => import('./RefreshOnReconnect'))\n\nexport interface SanityLiveProps {\n  config: SanityClientConfig\n  includeDrafts: boolean | undefined\n  requestTag: string\n  waitFor: 'function' | undefined\n\n  action: SanityLiveAction\n  onError: SanityLiveOnError | false | undefined\n  onWelcome: SanityLiveOnWelcome | false | undefined\n  onReconnect: SanityLiveOnReconnect | false | undefined\n  onRestart: SanityLiveOnRestart | false | undefined\n  onGoAway: SanityLiveOnGoaway | false | undefined\n\n  refreshOnMount: boolean | undefined\n  refreshOnFocus: boolean | undefined\n  refreshOnReconnect: boolean | undefined\n}\n\nfunction SanityLive(props: SanityLiveProps): React.JSX.Element | null {\n  const {\n    config,\n    includeDrafts = false,\n    requestTag,\n    waitFor,\n\n    action,\n    onError,\n    onWelcome = handleWelcome,\n    onReconnect,\n    onRestart,\n    onGoAway = handleGoaway,\n\n    refreshOnMount = false,\n    refreshOnFocus = false,\n    refreshOnReconnect = true,\n  } = props\n  const {projectId, dataset, apiHost, apiVersion, useProjectHostname, token, requestTagPrefix} =\n    config\n  const actionContext = {includeDrafts} satisfies SanityLiveActionContext\n\n  const client = useMemo(\n    () =>\n      createClient({\n        projectId,\n        dataset,\n        apiHost,\n        apiVersion,\n        useProjectHostname,\n        ignoreBrowserTokenWarning: true,\n        token,\n        useCdn: false,\n        requestTagPrefix,\n      }),\n    [apiHost, apiVersion, dataset, projectId, requestTagPrefix, token, useProjectHostname],\n  )\n\n  const [refreshOnInterval, setRefreshOnInterval] = useState<number | false>(false)\n\n  const [error, setError] = useState<unknown>(null)\n  if (error) {\n    // Throw during render to bubble up to the nearest <ErrorBoundary>, if `onError` is provided we won't rethrow\n    throw error\n  }\n  const handleError = useEffectEvent((error: unknown) => {\n    if (onError) {\n      void onError(error, actionContext)\n    } else {\n      setError(\n        isCorsOriginError(error)\n          ? new Error(\n              `Sanity Live is unable to connect to the Sanity API as the current origin - ${window.origin} - is not in the list of allowed CORS origins for this Sanity Project.${error.addOriginUrl ? ` Add it here: ${error.addOriginUrl}` : ''}`,\n              {cause: error},\n            )\n          : error,\n      )\n    }\n  })\n\n  const router = useRouter()\n  const handleLiveEvent = useEffectEvent((event: LiveEvent) => {\n    switch (event.type) {\n      case 'welcome': {\n        // Disable long polling when welcome event is received, this is a no-op if long polling is already disabled\n        startTransition(() => setRefreshOnInterval(false))\n\n        if (onWelcome) {\n          startTransition(() => onWelcome(event, actionContext))\n        }\n        break\n      }\n      case 'message': {\n        startTransition(() =>\n          action(\n            event.tags.map(\n              (tag) =>\n                `${includeDrafts ? cacheTagPrefixes.drafts : cacheTagPrefixes.published}${tag}`,\n            ),\n          ).then((result) => {\n            if (result === 'refresh') {\n              startTransition(() => router.refresh())\n            }\n          }),\n        )\n        break\n      }\n      case 'restart': {\n        // Disable long polling when restart event is received, this is a no-op if long polling is already disabled\n        startTransition(() => setRefreshOnInterval(false))\n\n        if (onRestart) {\n          startTransition(() => onRestart(event, actionContext))\n        }\n        break\n      }\n      case 'reconnect': {\n        // Disable long polling when reconnect event is received, this is a no-op if long polling is already disabled\n        startTransition(() => setRefreshOnInterval(false))\n\n        if (onReconnect) {\n          startTransition(() => onReconnect(event, actionContext))\n        }\n        break\n      }\n      case 'goaway': {\n        if (onGoAway) {\n          startTransition(() =>\n            onGoAway(event, actionContext, (interval) =>\n              startTransition(() => setRefreshOnInterval(interval)),\n            ),\n          )\n        } else if (!onGoAway) {\n          handleError(\n            new Error(\n              `Sanity Live connection closed, automatic revalidation is disabled, the server gave this reason: ${event.reason}`,\n              {cause: event},\n            ),\n          )\n        }\n        break\n      }\n      default:\n        handleError(new Error(`Unknown live event type`, {cause: event}))\n        break\n    }\n  })\n  useEffect(() => {\n    const subscription = client.live\n      .events({includeDrafts, tag: requestTag, waitFor})\n      .subscribe({next: handleLiveEvent, error: handleError})\n    return () => subscription.unsubscribe()\n  }, [client.live, requestTag, includeDrafts, waitFor])\n\n  return (\n    <>\n      {refreshOnMount && <RefreshOnMount />}\n      {refreshOnInterval && Number.isFinite(refreshOnInterval) && refreshOnInterval > 0 && (\n        <RefreshOnInterval interval={refreshOnInterval} />\n      )}\n      {refreshOnFocus && <RefreshOnFocus />}\n      {refreshOnReconnect && <RefreshOnReconnect />}\n    </>\n  )\n}\n\nSanityLive.displayName = 'SanityLiveClientComponent'\n\nexport default SanityLive\n\nconst handleWelcome: SanityLiveOnWelcome = (_, {includeDrafts}) => {\n  // oxlint-disable-next-line no-console\n  console.info(\n    `<SanityLive${includeDrafts ? ' includeDrafts' : ''}> is connected and listening for live events to ${includeDrafts ? 'all content including drafts and version documents in content releases' : 'published content'}`,\n  )\n}\n\nconst handleGoaway: SanityLiveOnGoaway = (event, {includeDrafts}, setLongPollingInterval) => {\n  const interval = 30_000\n  console.warn(\n    `<SanityLive${includeDrafts ? ' includeDrafts' : ''}> connection is closed after receiving a 'goaway' event, the server gave this reason:`,\n    event.reason,\n    `Content will now be refreshed every ${interval / 1_000} seconds`,\n  )\n  setLongPollingInterval(interval)\n}\n"],"mappings":";;;;;;;AAkBA,MAAM,iBAAiB,cAAc,OAAO,uBAAoB;AAChE,MAAM,iBAAiB,cAAc,OAAO,uBAAoB;AAChE,MAAM,oBAAoB,cAAc,OAAO,0BAAuB;AACtE,MAAM,qBAAqB,cAAc,OAAO,2BAAwB;AAoBxE,SAAS,WAAW,OAAkD;CACpE,MAAM,EACJ,QACA,gBAAgB,OAChB,YACA,SAEA,QACA,SACA,YAAY,eACZ,aACA,WACA,WAAW,cAEX,iBAAiB,OACjB,iBAAiB,OACjB,qBAAqB,SACnB;CACJ,MAAM,EAAC,WAAW,SAAS,SAAS,YAAY,oBAAoB,OAAO,qBACzE;CACF,MAAM,gBAAgB,EAAC,eAAc;CAErC,MAAM,SAAS,cAEX,aAAa;EACX;EACA;EACA;EACA;EACA;EACA,2BAA2B;EAC3B;EACA,QAAQ;EACR;EACD,CAAC,EACJ;EAAC;EAAS;EAAY;EAAS;EAAW;EAAkB;EAAO;EAAmB,CACvF;CAED,MAAM,CAAC,mBAAmB,wBAAwB,SAAyB,MAAM;CAEjF,MAAM,CAAC,OAAO,YAAY,SAAkB,KAAK;AACjD,KAAI,MAEF,OAAM;CAER,MAAM,cAAc,gBAAgB,UAAmB;AACrD,MAAI,QACG,SAAQ,OAAO,cAAc;MAElC,UACE,kBAAkB,MAAM,GACpB,IAAI,MACF,8EAA8E,OAAO,OAAO,wEAAwE,MAAM,eAAe,iBAAiB,MAAM,iBAAiB,MACjO,EAAC,OAAO,OAAM,CACf,GACD,MACL;GAEH;CAEF,MAAM,SAAS,WAAW;CAC1B,MAAM,kBAAkB,gBAAgB,UAAqB;AAC3D,UAAQ,MAAM,MAAd;GACE,KAAK;AAEH,0BAAsB,qBAAqB,MAAM,CAAC;AAElD,QAAI,UACF,uBAAsB,UAAU,OAAO,cAAc,CAAC;AAExD;GAEF,KAAK;AACH,0BACE,OACE,MAAM,KAAK,KACR,QACC,GAAG,gBAAgB,iBAAiB,SAAS,iBAAiB,YAAY,MAC7E,CACF,CAAC,MAAM,WAAW;AACjB,SAAI,WAAW,UACb,uBAAsB,OAAO,SAAS,CAAC;MAEzC,CACH;AACD;GAEF,KAAK;AAEH,0BAAsB,qBAAqB,MAAM,CAAC;AAElD,QAAI,UACF,uBAAsB,UAAU,OAAO,cAAc,CAAC;AAExD;GAEF,KAAK;AAEH,0BAAsB,qBAAqB,MAAM,CAAC;AAElD,QAAI,YACF,uBAAsB,YAAY,OAAO,cAAc,CAAC;AAE1D;GAEF,KAAK;AACH,QAAI,SACF,uBACE,SAAS,OAAO,gBAAgB,aAC9B,sBAAsB,qBAAqB,SAAS,CAAC,CACtD,CACF;aACQ,CAAC,SACV,aACE,IAAI,MACF,mGAAmG,MAAM,UACzG,EAAC,OAAO,OAAM,CACf,CACF;AAEH;GAEF;AACE,gBAAY,IAAI,MAAM,2BAA2B,EAAC,OAAO,OAAM,CAAC,CAAC;AACjE;;GAEJ;AACF,iBAAgB;EACd,MAAM,eAAe,OAAO,KACzB,OAAO;GAAC;GAAe,KAAK;GAAY;GAAQ,CAAC,CACjD,UAAU;GAAC,MAAM;GAAiB,OAAO;GAAY,CAAC;AACzD,eAAa,aAAa,aAAa;IACtC;EAAC,OAAO;EAAM;EAAY;EAAe;EAAQ,CAAC;AAErD,QACE,qBAAA,UAAA,EAAA,UAAA;EACG,kBAAkB,oBAAC,gBAAD,EAAkB,CAAA;EACpC,qBAAqB,OAAO,SAAS,kBAAkB,IAAI,oBAAoB,KAC9E,oBAAC,mBAAD,EAAmB,UAAU,mBAAqB,CAAA;EAEnD,kBAAkB,oBAAC,gBAAD,EAAkB,CAAA;EACpC,sBAAsB,oBAAC,oBAAD,EAAsB,CAAA;EAC5C,EAAA,CAAA;;AAIP,WAAW,cAAc;AAIzB,MAAM,iBAAsC,GAAG,EAAC,oBAAmB;AAEjE,SAAQ,KACN,cAAc,gBAAgB,mBAAmB,GAAG,kDAAkD,gBAAgB,2EAA2E,sBAClM;;AAGH,MAAM,gBAAoC,OAAO,EAAC,iBAAgB,2BAA2B;CAC3F,MAAM,WAAW;AACjB,SAAQ,KACN,cAAc,gBAAgB,mBAAmB,GAAG,wFACpD,MAAM,QACN,uCAAuC,WAAW,IAAM,UACzD;AACD,wBAAuB,SAAS"}

package/dist/isCorsOriginError.js.map

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

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

@@ -1,22 +1,21 @@
-import { a as SanityLiveAction, c as SanityLiveOnReconnect, l as SanityLiveOnRestart, o as SanityLiveOnError, s as SanityLiveOnGoaway, u as SanityLiveOnWelcome } from "../../types.js";
-import { InitializedClientConfig } from "@sanity/client";
-interface SanityClientConfig extends Pick<InitializedClientConfig, "projectId" | "dataset" | "apiHost" | "apiVersion" | "useProjectHostname" | "token" | "requestTagPrefix"> {}
+import { a as SanityClientConfig, c as SanityLiveOnError, d as SanityLiveOnRestart, f as SanityLiveOnWelcome, l as SanityLiveOnGoaway, o as SanityLiveAction, u as SanityLiveOnReconnect } from "../../types.js";
 interface SanityLiveProps {
   config: SanityClientConfig;
-  includeDrafts?: boolean;
+  includeDrafts: boolean | undefined;
   requestTag: string;
+  waitFor: "function" | undefined;
   action: SanityLiveAction;
   onError: SanityLiveOnError | false | undefined;
   onWelcome: SanityLiveOnWelcome | false | undefined;
   onReconnect: SanityLiveOnReconnect | false | undefined;
   onRestart: SanityLiveOnRestart | false | undefined;
   onGoAway: SanityLiveOnGoaway | false | undefined;
-  refreshOnMount?: boolean;
-  refreshOnFocus?: boolean;
-  refreshOnReconnect?: boolean;
+  refreshOnMount: boolean | undefined;
+  refreshOnFocus: boolean | undefined;
+  refreshOnReconnect: boolean | undefined;
 }
 /**
-* @alpha CAUTION: this is an internal component and does not follow semver. Using it directly is at your own risk.
+* @internal CAUTION: this is an internal component and does not follow semver. Using it directly is at your own risk.
 */
 declare const SanityLive: React.ComponentType<SanityLiveProps>;
 export { SanityLive };

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","names":[],"sources":["../../../src/live/client-components/SanityLive.tsx","../../../src/live/client-components/index.ts"],"mappings":";;UAsBU,kBAAA,SAA2B,IAAA,CACnC,uBAAA;AAAA,UAUe,eAAA;EACf,MAAA,EAAQ,kBAAA;EACR,aAAA;EACA,UAAA;EAEA,MAAA,EAAQ,gBAAA;EACR,OAAA,EAAS,iBAAA;EACT,SAAA,EAAW,mBAAA;EACX,WAAA,EAAa,qBAAA;EACb,SAAA,EAAW,mBAAA;EACX,QAAA,EAAU,kBAAA;EAEV,cAAA;EACA,cAAA;EACA,kBAAA;AAAA;;;AAhCK;cCPM,UAAA,EAAY,KAAA,CAAM,aAAA,CAAc,eAAA"}
+{"version":3,"file":"index.d.ts","names":[],"sources":["../../../src/live/client-components/SanityLive.tsx","../../../src/live/client-components/index.ts"],"mappings":";UAuBiB,eAAA;EACf,MAAA,EAAQ,kBAAA;EACR,aAAA;EACA,UAAA;EACA,OAAA;EAEA,MAAA,EAAQ,gBAAA;EACR,OAAA,EAAS,iBAAA;EACT,SAAA,EAAW,mBAAA;EACX,WAAA,EAAa,qBAAA;EACb,SAAA,EAAW,mBAAA;EACX,QAAA,EAAU,kBAAA;EAEV,cAAA;EACA,cAAA;EACA,kBAAA;AAAA;;AAfF;;cCfa,UAAA,EAAY,KAAA,CAAM,aAAA,CAAc,eAAA"}

package/dist/live/client-components/index.js

@@ -1,7 +1,7 @@
 "use client";
 import dynamic from "next/dynamic";
 /**
-* @alpha CAUTION: this is an internal component and does not follow semver. Using it directly is at your own risk.
+* @internal CAUTION: this is an internal component and does not follow semver. Using it directly is at your own risk.
 */
 const SanityLive = dynamic(() => import("../../SanityLive.js"), { ssr: false });
 export { SanityLive };

package/dist/live/client-components/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","names":[],"sources":["../../../src/live/client-components/index.ts"],"sourcesContent":["'use client'\n\nimport dynamic from 'next/dynamic'\n\nimport type {SanityLiveProps} from './SanityLive'\n/**\n * @alpha CAUTION: this is an internal component and does not follow semver. Using it directly is at your own risk.\n */\nexport const SanityLive: React.ComponentType<SanityLiveProps> = dynamic(\n  () => import('./SanityLive'),\n  {ssr: false},\n)\n"],"mappings":";;;;;AAQA,MAAa,aAAmD,cACxD,OAAO,wBACb,EAAC,KAAK,OAAM,CACb"}
+{"version":3,"file":"index.js","names":[],"sources":["../../../src/live/client-components/index.ts"],"sourcesContent":["'use client'\n\nimport dynamic from 'next/dynamic'\n\nimport type {SanityLiveProps} from './SanityLive'\n/**\n * @internal CAUTION: this is an internal component and does not follow semver. Using it directly is at your own risk.\n */\nexport const SanityLive: React.ComponentType<SanityLiveProps> = dynamic(\n  () => import('./SanityLive'),\n  {ssr: false},\n)\n"],"mappings":";;;;;AAQA,MAAa,aAAmD,cACxD,OAAO,wBACb,EAAC,KAAK,OAAM,CACb"}

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

@@ -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 { c as SanityLiveOnError, d as SanityLiveOnRestart, f as SanityLiveOnWelcome, i as LivePerspective, l as SanityLiveOnGoaway, m as StrictDefinedLiveProps, n as DefinedFetchType, o as SanityLiveAction, p as StrictDefinedFetchType, r as DefinedLiveProps, s as SanityLiveActionContext, t as DefineLiveOptions, u as SanityLiveOnReconnect } 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,84 @@ 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',
+* })
+* const token = process.env.SANITY_API_READ_TOKEN
+*
+* export const {sanityFetch, SanityLive} = defineLive({
+*   client,
+*   browserToken: token,
+*   serverToken: token,
+* })
+* ```
+*
+* @example
+* ```tsx
+* // app/layout.tsx
+* import {SanityLive} from '@/sanity/live'
+*
+* export default function RootLayout({children}: {children: React.ReactNode}) {
+*   return (
+*     <html lang="en">
+*       <body>
+*         {children}
+*         <SanityLive />
+*       </body>
+*     </html>
+*   )
+* }
+* ```
+*
+* @example
+* ```tsx
+* // app/[slug]/page.tsx
+* import {defineQuery} from 'next-sanity'
+* import {sanityFetch} from '@/sanity/live'
+*
+* const POSTS_SLUGS_QUERY = defineQuery(`
+*   *[_type == "post" && slug.current]{"slug": slug.current}
+* `)
+* const POST_QUERY = defineQuery(`
+*   *[_type == "post" && slug.current == $slug][0]
+* `)
+*
+* export async function generateStaticParams() {
+*   const {data} = await sanityFetch({
+*     query: POSTS_SLUGS_QUERY,
+*     perspective: 'published',
+*     stega: false,
+*   })
+*
+*   return data
+* }
+*
+* export default async function Page(props: PageProps<'/[slug]'>) {
+*   const {slug} = await props.params
+*   const {data} = await sanityFetch({
+*     query: POST_QUERY,
+*     params: {slug},
+*   })
+*
+*   return <pre>{JSON.stringify(data, null, 2)}</pre>
+* }
+* ```
+*
 * @public
 */
 declare function defineLive(config: DefineLiveOptions & {
@@ -50,5 +272,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

@@ -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"}
+{"version":3,"file":"index.d.ts","names":[],"sources":["../../../../src/live/conditions/default/index.ts"],"mappings":";;;AAuKA;;;;;;;;;;;;;;;;;;;;AAqFA;;;;;;;;;;;;;;;;;;;;AAoCA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAzHA,iBAAgB,UAAA,CAAW,MAAA,EAAQ,iBAAA;EAAqB,MAAA;AAAA;EACtD,WAAA,EAAa,sBAAA;EACb,UAAA,EAAY,KAAA,CAAM,aAAA,CAAc,sBAAA;AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAmFlB,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

@@ -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

@@ -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"}
+{"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 * 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\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":";;AAgQA,SAAgB,WAAW,SAAmC;AAC5D,OAAM,IAAI,MAAM,qDAAqD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA+BvE,MAAa,sCAA6E;AACxF,OAAM,IAAI,MAAM,wEAAwE"}