next-sanity 13.0.0-cache-components.37 → 13.0.0-cache-components.38

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

@@ -1,7 +1,7 @@
 import { t as isCorsOriginError } from "../../../isCorsOriginError.js";
 import { n as revalidate, t as cacheTagPrefixes } from "../../../constants.js";
-import { t as parseTags } from "../../../parseTags.js";
 import { n as validateStrictFetchOptions, r as validateStrictSanityLiveProps, t as resolvePerspectiveFromCookies } from "../../../resolvePerspectiveFromCookies.js";
+import { t as parseTags } from "../../../parseTags.js";
 import { jsx } from "react/jsx-runtime";
 import { SanityLive } from "next-sanity/live/client-components";
 import { actionRefresh, actionUpdateTags } from "next-sanity/live/server-actions";

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

@@ -1,7 +1,7 @@
 import { t as isCorsOriginError } from "../../../isCorsOriginError.js";
 import { t as cacheTagPrefixes } from "../../../constants.js";
-import { t as parseTags } from "../../../parseTags.js";
 import { n as validateStrictFetchOptions, r as validateStrictSanityLiveProps, t as resolvePerspectiveFromCookies } from "../../../resolvePerspectiveFromCookies.js";
+import { t as parseTags } from "../../../parseTags.js";
 import { t as sanitizePerspective } from "../../../sanitizePerspective.js";
 import { perspectiveCookieName } from "@sanity/preview-url-secret/constants";
 import { cookies, draftMode } from "next/headers";

package/dist/parseTags.d.ts

@@ -1,5 +1,8 @@
 import { cookies } from "next/headers";
 import { ClientPerspective, SyncTag } from "@sanity/client";
+/**
+* @deprecated - refactor to exporting the same function instead
+*/
 type ResolvePerspectiveFromCookies = (options: {
   /**
   * You must await the cookies() function from next/headers
@@ -14,14 +17,33 @@ type ResolvePerspectiveFromCookies = (options: {
   cookies: Awaited<ReturnType<typeof cookies>>;
 }) => Promise<Exclude<ClientPerspective, "raw">>;
 /**
-* Resolves the perspective from the cookie that is set by `import { defineEnableDraftMode } from "next-sanity/draft-mode"`
+* Reads the active draft-mode perspective from the cookie set by
+* {@link "next-sanity/draft-mode".defineEnableDraftMode | `defineEnableDraftMode`}, falling back to `'drafts'`
+* when the cookie is missing or contains an invalid value.
+*
+* This helper is intended for use with Next.js Cache Components (`cacheComponents: true`),
+* where `cookies()` and `draftMode()` cannot be called inside `'use cache'` boundaries.
+* Resolve the perspective once outside the cache boundary and pass it in as a prop / cache key.
+*
+* The caller is responsible for awaiting `cookies()` from `next/headers` and passing the
+* resulting cookie store as the `cookies` option — this keeps the helper free of dynamic APIs
+* so it can be invoked from anywhere a `ReadonlyRequestCookies` instance is available.
+*
+* @example
+* ```ts
+* import {cookies} from 'next/headers'
+* import {resolvePerspectiveFromCookies} from 'next-sanity/live'
+*
+* const perspective = await resolvePerspectiveFromCookies({cookies: await cookies()})
+* ```
+*
 * @public
 */
-declare const resolvePerspectiveFromCookies: ({
+declare function resolvePerspectiveFromCookies({
   cookies: jar
 }: {
   cookies: Awaited<ReturnType<typeof cookies>>;
-}) => Promise<Exclude<ClientPerspective, "raw">>;
+}): Promise<Exclude<ClientPerspective, "raw">>;
 declare const cacheTagPrefixes: {
   published: string;
   drafts: string;

package/dist/parseTags.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"parseTags.d.ts","names":[],"sources":["../src/live/shared/resolvePerspectiveFromCookies.ts","../src/live/shared/constants.ts","../src/live/shared/parseTags.ts"],"mappings":";;KAMY,6BAAA,IAAiC,OAAA;EAA7C;;;;;;;;;;EAWE,OAAA,EAAS,OAAA,CAAQ,UAAA,QAAkB,OAAA;AAAA,MAC/B,OAAA,CAAQ,OAAA,CAAQ,iBAAA;;;;;cAMT,6BAAA;EACX,OAAA,EAAS;AAAA;EAET,OAAA,EAAS,OAAA,CAAQ,UAAA,QAAkB,OAAA;AAAA,MACjC,OAAA,CAAQ,OAAA,CAAQ,iBAAA;AAAA,cCrBP,gBAAA;EACX,SAAA;EACA,MAAA;AAAA;AAAA,UCLQ,mBAAA;EACR,IAAA,YAAgB,gBAAA,CAAiB,SAAA,GAAY,OAAA;EAC7C,MAAA,SAAe,gBAAA,CAAiB,SAAA;EAChC,UAAA;AAAA;AAAA,UAEQ,eAAA;EACR,IAAA,YAAgB,gBAAA,CAAiB,MAAA,GAAS,OAAA;EAC1C,MAAA,SAAe,gBAAA,CAAiB,MAAA;EAChC,UAAA;AAAA;AAAA,KAEG,UAAA,GAAa,mBAAA,GAAsB,eAAA;;;;;;;;;;;;AFUxC;;;;;;;;;;iBEagB,SAAA,CAAU,UAAA,YAAsB,UAAA"}
+{"version":3,"file":"parseTags.d.ts","names":[],"sources":["../src/live/shared/resolvePerspectiveFromCookies.ts","../src/live/shared/constants.ts","../src/live/shared/parseTags.ts"],"mappings":";;;AASA;;KAAY,6BAAA,IAAiC,OAAA;;;;;;;;;;;EAW3C,OAAA,EAAS,OAAA,CAAQ,UAAA,QAAkB,OAAA;AAAA,MAC/B,OAAA,CAAQ,OAAA,CAAQ,iBAAA;;;;;;;AAyBtB;;;;;;;;;;;;;;;;;iBAAsB,6BAAA,CAAA;EACpB,OAAA,EAAS;AAAA;EAET,OAAA,EAAS,OAAA,CAAQ,UAAA,QAAkB,OAAA;AAAA,IACjC,OAAA,CAAQ,OAAA,CAAQ,iBAAA;AAAA,cC3CP,gBAAA;EACX,SAAA;EACA,MAAA;AAAA;AAAA,UCLQ,mBAAA;EACR,IAAA,YAAgB,gBAAA,CAAiB,SAAA,GAAY,OAAA;EAC7C,MAAA,SAAe,gBAAA,CAAiB,SAAA;EAChC,UAAA;AAAA;AAAA,UAEQ,eAAA;EACR,IAAA,YAAgB,gBAAA,CAAiB,MAAA,GAAS,OAAA;EAC1C,MAAA,SAAe,gBAAA,CAAiB,MAAA;EAChC,UAAA;AAAA;AAAA,KAEG,UAAA,GAAa,mBAAA,GAAsB,eAAA;;;;;;;;;;;;AFgCxC;;;;;;;;;;iBETgB,SAAA,CAAU,UAAA,YAAsB,UAAA"}

package/dist/resolvePerspectiveFromCookies.js

@@ -9,12 +9,31 @@ function validateStrictFetchOptions(options) {
 	if (typeof options.stega !== "boolean") throw new Error(`sanityFetch() requires an explicit \`stega\` option (true or false) when \`strict: true\` is set on \`defineLive\`.\n\nMore information: ${generateHelpUrl("next-sanity-fetch-strict")}`, { cause: options });
 }
 /**
-* Resolves the perspective from the cookie that is set by `import { defineEnableDraftMode } from "next-sanity/draft-mode"`
+* Reads the active draft-mode perspective from the cookie set by
+* {@link "next-sanity/draft-mode".defineEnableDraftMode | `defineEnableDraftMode`}, falling back to `'drafts'`
+* when the cookie is missing or contains an invalid value.
+*
+* This helper is intended for use with Next.js Cache Components (`cacheComponents: true`),
+* where `cookies()` and `draftMode()` cannot be called inside `'use cache'` boundaries.
+* Resolve the perspective once outside the cache boundary and pass it in as a prop / cache key.
+*
+* The caller is responsible for awaiting `cookies()` from `next/headers` and passing the
+* resulting cookie store as the `cookies` option — this keeps the helper free of dynamic APIs
+* so it can be invoked from anywhere a `ReadonlyRequestCookies` instance is available.
+*
+* @example
+* ```ts
+* import {cookies} from 'next/headers'
+* import {resolvePerspectiveFromCookies} from 'next-sanity/live'
+*
+* const perspective = await resolvePerspectiveFromCookies({cookies: await cookies()})
+* ```
+*
 * @public
 */
-const resolvePerspectiveFromCookies = async function resolvePerspectiveFromCookies({ cookies: jar }) {
+async function resolvePerspectiveFromCookies({ cookies: jar }) {
 	return jar.has(perspectiveCookieName) ? sanitizePerspective(jar.get(perspectiveCookieName)?.value, "drafts") : "drafts";
-};
+}
 export { validateStrictFetchOptions as n, validateStrictSanityLiveProps as r, resolvePerspectiveFromCookies as t };
 
 //# sourceMappingURL=resolvePerspectiveFromCookies.js.map

package/dist/resolvePerspectiveFromCookies.js.map

@@ -1 +1 @@
-{"version":3,"file":"resolvePerspectiveFromCookies.js","names":[],"sources":["../src/live/shared/strictValidation.ts","../src/live/shared/resolvePerspectiveFromCookies.ts"],"sourcesContent":["import {generateHelpUrl} from '@sanity/generate-help-url'\n\nexport function validateStrictSanityLiveProps(props: {includeDrafts?: unknown}): void {\n  if (typeof props.includeDrafts !== 'boolean') {\n    throw new Error(\n      `<SanityLive> requires an explicit \\`includeDrafts\\` prop (true or false) when \\`strict: true\\` is set on \\`defineLive\\`.\\n\\nMore information: ${generateHelpUrl('next-sanity-live-strict')}`,\n      {cause: props},\n    )\n  }\n}\n\nexport function validateStrictFetchOptions(options: {\n  perspective?: unknown\n  stega?: unknown\n}): void {\n  if (typeof options.perspective === 'undefined' || options.perspective === null) {\n    throw new Error(\n      `sanityFetch() requires an explicit \\`perspective\\` option when \\`strict: true\\` is set on \\`defineLive\\`.\\n\\nMore information: ${generateHelpUrl('next-sanity-fetch-strict')}`,\n      {cause: options},\n    )\n  }\n  if (typeof options.stega !== 'boolean') {\n    throw new Error(\n      `sanityFetch() requires an explicit \\`stega\\` option (true or false) when \\`strict: true\\` is set on \\`defineLive\\`.\\n\\nMore information: ${generateHelpUrl('next-sanity-fetch-strict')}`,\n      {cause: options},\n    )\n  }\n}\n","import type {ClientPerspective} from '@sanity/client'\nimport {perspectiveCookieName} from '@sanity/preview-url-secret/constants'\nimport type {cookies} from 'next/headers'\n\nimport {sanitizePerspective} from './sanitizePerspective'\n\nexport type ResolvePerspectiveFromCookies = (options: {\n  /**\n   * You must await the cookies() function from next/headers\n   * and pass it here.\n   * Example:\n   * ```ts\n   * import { cookies } from 'next/headers'\n   *\n   * const perspective = await resolvePerspectiveFromCookies({cookies: await cookies()})\n   * ```\n   */\n  cookies: Awaited<ReturnType<typeof cookies>>\n}) => Promise<Exclude<ClientPerspective, 'raw'>>\n\n/**\n * Resolves the perspective from the cookie that is set by `import { defineEnableDraftMode } from \"next-sanity/draft-mode\"`\n * @public\n */\nexport const resolvePerspectiveFromCookies = async function resolvePerspectiveFromCookies({\n  cookies: jar,\n}: {\n  cookies: Awaited<ReturnType<typeof cookies>>\n}): Promise<Exclude<ClientPerspective, 'raw'>> {\n  return jar.has(perspectiveCookieName)\n    ? sanitizePerspective(jar.get(perspectiveCookieName)?.value, 'drafts')\n    : 'drafts'\n}\n"],"mappings":";;;AAEA,SAAgB,8BAA8B,OAAwC;AACpF,KAAI,OAAO,MAAM,kBAAkB,UACjC,OAAM,IAAI,MACR,iJAAiJ,gBAAgB,0BAA0B,IAC3L,EAAC,OAAO,OAAM,CACf;;AAIL,SAAgB,2BAA2B,SAGlC;AACP,KAAI,OAAO,QAAQ,gBAAgB,eAAe,QAAQ,gBAAgB,KACxE,OAAM,IAAI,MACR,kIAAkI,gBAAgB,2BAA2B,IAC7K,EAAC,OAAO,SAAQ,CACjB;AAEH,KAAI,OAAO,QAAQ,UAAU,UAC3B,OAAM,IAAI,MACR,4IAA4I,gBAAgB,2BAA2B,IACvL,EAAC,OAAO,SAAQ,CACjB;;;;;;ACDL,MAAa,gCAAgC,eAAe,8BAA8B,EACxF,SAAS,OAGoC;AAC7C,QAAO,IAAI,IAAI,sBAAsB,GACjC,oBAAoB,IAAI,IAAI,sBAAsB,EAAE,OAAO,SAAS,GACpE"}
+{"version":3,"file":"resolvePerspectiveFromCookies.js","names":[],"sources":["../src/live/shared/strictValidation.ts","../src/live/shared/resolvePerspectiveFromCookies.ts"],"sourcesContent":["import {generateHelpUrl} from '@sanity/generate-help-url'\n\nexport function validateStrictSanityLiveProps(props: {includeDrafts?: unknown}): void {\n  if (typeof props.includeDrafts !== 'boolean') {\n    throw new Error(\n      `<SanityLive> requires an explicit \\`includeDrafts\\` prop (true or false) when \\`strict: true\\` is set on \\`defineLive\\`.\\n\\nMore information: ${generateHelpUrl('next-sanity-live-strict')}`,\n      {cause: props},\n    )\n  }\n}\n\nexport function validateStrictFetchOptions(options: {\n  perspective?: unknown\n  stega?: unknown\n}): void {\n  if (typeof options.perspective === 'undefined' || options.perspective === null) {\n    throw new Error(\n      `sanityFetch() requires an explicit \\`perspective\\` option when \\`strict: true\\` is set on \\`defineLive\\`.\\n\\nMore information: ${generateHelpUrl('next-sanity-fetch-strict')}`,\n      {cause: options},\n    )\n  }\n  if (typeof options.stega !== 'boolean') {\n    throw new Error(\n      `sanityFetch() requires an explicit \\`stega\\` option (true or false) when \\`strict: true\\` is set on \\`defineLive\\`.\\n\\nMore information: ${generateHelpUrl('next-sanity-fetch-strict')}`,\n      {cause: options},\n    )\n  }\n}\n","import type {ClientPerspective} from '@sanity/client'\nimport {perspectiveCookieName} from '@sanity/preview-url-secret/constants'\nimport type {cookies} from 'next/headers'\n\nimport {sanitizePerspective} from '#live/sanitizePerspective'\n\n/**\n * @deprecated - refactor to exporting the same function instead\n */\nexport type ResolvePerspectiveFromCookies = (options: {\n  /**\n   * You must await the cookies() function from next/headers\n   * and pass it here.\n   * Example:\n   * ```ts\n   * import { cookies } from 'next/headers'\n   *\n   * const perspective = await resolvePerspectiveFromCookies({cookies: await cookies()})\n   * ```\n   */\n  cookies: Awaited<ReturnType<typeof cookies>>\n}) => Promise<Exclude<ClientPerspective, 'raw'>>\n\n/**\n * Reads the active draft-mode perspective from the cookie set by\n * {@link \"next-sanity/draft-mode\".defineEnableDraftMode | `defineEnableDraftMode`}, falling back to `'drafts'`\n * when the cookie is missing or contains an invalid value.\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 * The caller is responsible for awaiting `cookies()` from `next/headers` and passing the\n * resulting cookie store as the `cookies` option — this keeps the helper free of dynamic APIs\n * so it can be invoked from anywhere a `ReadonlyRequestCookies` instance is available.\n *\n * @example\n * ```ts\n * import {cookies} from 'next/headers'\n * import {resolvePerspectiveFromCookies} from 'next-sanity/live'\n *\n * const perspective = await resolvePerspectiveFromCookies({cookies: await cookies()})\n * ```\n *\n * @public\n */\nexport async function resolvePerspectiveFromCookies({\n  cookies: jar,\n}: {\n  cookies: Awaited<ReturnType<typeof cookies>>\n}): Promise<Exclude<ClientPerspective, 'raw'>> {\n  return jar.has(perspectiveCookieName)\n    ? sanitizePerspective(jar.get(perspectiveCookieName)?.value, 'drafts')\n    : 'drafts'\n}\n"],"mappings":";;;AAEA,SAAgB,8BAA8B,OAAwC;AACpF,KAAI,OAAO,MAAM,kBAAkB,UACjC,OAAM,IAAI,MACR,iJAAiJ,gBAAgB,0BAA0B,IAC3L,EAAC,OAAO,OAAM,CACf;;AAIL,SAAgB,2BAA2B,SAGlC;AACP,KAAI,OAAO,QAAQ,gBAAgB,eAAe,QAAQ,gBAAgB,KACxE,OAAM,IAAI,MACR,kIAAkI,gBAAgB,2BAA2B,IAC7K,EAAC,OAAO,SAAQ,CACjB;AAEH,KAAI,OAAO,QAAQ,UAAU,UAC3B,OAAM,IAAI,MACR,4IAA4I,gBAAgB,2BAA2B,IACvL,EAAC,OAAO,SAAQ,CACjB;;;;;;;;;;;;;;;;;;;;;;;;;ACqBL,eAAsB,8BAA8B,EAClD,SAAS,OAGoC;AAC7C,QAAO,IAAI,IAAI,sBAAsB,GACjC,oBAAoB,IAAI,IAAI,sBAAsB,EAAE,OAAO,SAAS,GACpE"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "next-sanity",
-  "version": "13.0.0-cache-components.37",
+  "version": "13.0.0-cache-components.38",
   "description": "Sanity.io toolkit for Next.js",
   "keywords": [
     "live",
@@ -82,7 +82,7 @@
     "@vitejs/plugin-react": "^6.0.1",
     "@vitest/coverage-v8": "^4.1.5",
     "js-yaml": "^4.1.1",
-    "next": "16.3.0-canary.5",
+    "next": "16.3.0-canary.9",
     "publint": "^0.3.18",
     "react": "^19.2.5",
     "react-dom": "^19.2.5",