@prismicio/next 2.2.4-pr.114.5e44dbe → 2.3.0-pr.139.dd4bae7

package/dist/PrismicNextLink.d.cts

@@ -23,7 +23,7 @@ type PrismicNextLinkProps = Omit<ComponentProps<typeof Link>, "field" | "documen
 });
 declare const PrismicNextLink: _$react.ForwardRefExoticComponent<(Omit<Omit<Omit<_$react.AnchorHTMLAttributes<HTMLAnchorElement>, keyof _$next_link0.LinkProps<any>> & _$next_link0.LinkProps<any> & {
   children?: React.ReactNode | undefined;
-} & _$react.RefAttributes<HTMLAnchorElement>, "rel" | "field" | "href" | "document"> & {
+} & _$react.RefAttributes<HTMLAnchorElement>, "href" | "rel" | "field" | "document"> & {
   linkResolver?: LinkResolverFunction;
   rel?: string | AsLinkAttrsConfig["rel"];
 } & {
@@ -32,7 +32,7 @@ declare const PrismicNextLink: _$react.ForwardRefExoticComponent<(Omit<Omit<Omit
   href?: never;
 }, "ref"> | Omit<Omit<Omit<_$react.AnchorHTMLAttributes<HTMLAnchorElement>, keyof _$next_link0.LinkProps<any>> & _$next_link0.LinkProps<any> & {
   children?: React.ReactNode | undefined;
-} & _$react.RefAttributes<HTMLAnchorElement>, "rel" | "field" | "href" | "document"> & {
+} & _$react.RefAttributes<HTMLAnchorElement>, "href" | "rel" | "field" | "document"> & {
   linkResolver?: LinkResolverFunction;
   rel?: string | AsLinkAttrsConfig["rel"];
 } & {
@@ -41,7 +41,7 @@ declare const PrismicNextLink: _$react.ForwardRefExoticComponent<(Omit<Omit<Omit
   href?: never;
 }, "ref"> | Omit<Omit<Omit<_$react.AnchorHTMLAttributes<HTMLAnchorElement>, keyof _$next_link0.LinkProps<any>> & _$next_link0.LinkProps<any> & {
   children?: React.ReactNode | undefined;
-} & _$react.RefAttributes<HTMLAnchorElement>, "rel" | "field" | "href" | "document"> & {
+} & _$react.RefAttributes<HTMLAnchorElement>, "href" | "rel" | "field" | "document"> & {
   linkResolver?: LinkResolverFunction;
   rel?: string | AsLinkAttrsConfig["rel"];
 } & {

package/dist/PrismicNextLink.d.ts

@@ -23,7 +23,7 @@ type PrismicNextLinkProps = Omit<ComponentProps<typeof Link>, "field" | "documen
 });
 declare const PrismicNextLink: _$react.ForwardRefExoticComponent<(Omit<Omit<Omit<_$react.AnchorHTMLAttributes<HTMLAnchorElement>, keyof _$next_link0.LinkProps<any>> & _$next_link0.LinkProps<any> & {
   children?: React.ReactNode | undefined;
-} & _$react.RefAttributes<HTMLAnchorElement>, "rel" | "field" | "href" | "document"> & {
+} & _$react.RefAttributes<HTMLAnchorElement>, "href" | "rel" | "field" | "document"> & {
   linkResolver?: LinkResolverFunction;
   rel?: string | AsLinkAttrsConfig["rel"];
 } & {
@@ -32,7 +32,7 @@ declare const PrismicNextLink: _$react.ForwardRefExoticComponent<(Omit<Omit<Omit
   href?: never;
 }, "ref"> | Omit<Omit<Omit<_$react.AnchorHTMLAttributes<HTMLAnchorElement>, keyof _$next_link0.LinkProps<any>> & _$next_link0.LinkProps<any> & {
   children?: React.ReactNode | undefined;
-} & _$react.RefAttributes<HTMLAnchorElement>, "rel" | "field" | "href" | "document"> & {
+} & _$react.RefAttributes<HTMLAnchorElement>, "href" | "rel" | "field" | "document"> & {
   linkResolver?: LinkResolverFunction;
   rel?: string | AsLinkAttrsConfig["rel"];
 } & {
@@ -41,7 +41,7 @@ declare const PrismicNextLink: _$react.ForwardRefExoticComponent<(Omit<Omit<Omit
   href?: never;
 }, "ref"> | Omit<Omit<Omit<_$react.AnchorHTMLAttributes<HTMLAnchorElement>, keyof _$next_link0.LinkProps<any>> & _$next_link0.LinkProps<any> & {
   children?: React.ReactNode | undefined;
-} & _$react.RefAttributes<HTMLAnchorElement>, "rel" | "field" | "href" | "document"> & {
+} & _$react.RefAttributes<HTMLAnchorElement>, "href" | "rel" | "field" | "document"> & {
   linkResolver?: LinkResolverFunction;
   rel?: string | AsLinkAttrsConfig["rel"];
 } & {

package/dist/cacheTagPrismicPages.cjs

@@ -2,6 +2,18 @@ require("./_virtual/_rolldown/runtime.cjs");
 const require_getPrismicCacheTags = require("./getPrismicCacheTags.cjs");
 let next_cache_js = require("next/cache.js");
 //#region src/cacheTagPrismicPages.ts
+/**
+* Tags the current cache entry with cache tags for a set of Prismic pages so they can be
+* revalidated when their content changes.
+*
+* Linked documents (via content relationships) are tagged as well, so the cache entry is
+* revalidated when any of its nested documents change.
+*
+* @param pages - A set of Prismic pages used to tag the cache entry.
+* @experimental
+*
+* @see {@link https://nextjs.org/docs/app/api-reference/functions/cacheTag}
+*/
 function cacheTagPrismicPages(pages) {
 	(0, next_cache_js.cacheTag)(...require_getPrismicCacheTags.getPrismicCacheTags(pages));
 }

package/dist/cacheTagPrismicPages.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"cacheTagPrismicPages.cjs","names":["getPrismicCacheTags"],"sources":["../src/cacheTagPrismicPages.ts"],"sourcesContent":["import type { PrismicDocument } from \"@prismicio/client\"\nimport { cacheTag } from \"next/cache\"\n\nimport { getPrismicCacheTags } from \"./getPrismicCacheTags\"\n\nexport function cacheTagPrismicPages(pages: PrismicDocument[]): void {\n\tcacheTag(...getPrismicCacheTags(pages))\n}\n"],"mappings":";;;;AAKA,SAAgB,qBAAqB,OAAgC;AACpE,EAAA,GAAA,cAAA,UAAS,GAAGA,4BAAAA,oBAAoB,MAAM,CAAC"}
+{"version":3,"file":"cacheTagPrismicPages.cjs","names":["getPrismicCacheTags"],"sources":["../src/cacheTagPrismicPages.ts"],"sourcesContent":["import type { PrismicDocument } from \"@prismicio/client\"\nimport { cacheTag } from \"next/cache\"\n\nimport { getPrismicCacheTags } from \"./getPrismicCacheTags\"\n\n/**\n * Tags the current cache entry with cache tags for a set of Prismic pages so they can be\n * revalidated when their content changes.\n *\n * Linked documents (via content relationships) are tagged as well, so the cache entry is\n * revalidated when any of its nested documents change.\n *\n * @param pages - A set of Prismic pages used to tag the cache entry.\n * @experimental\n *\n * @see {@link https://nextjs.org/docs/app/api-reference/functions/cacheTag}\n */\nexport function cacheTagPrismicPages(pages: PrismicDocument[]): void {\n\tcacheTag(...getPrismicCacheTags(pages))\n}\n"],"mappings":";;;;;;;;;;;;;;;;AAiBA,SAAgB,qBAAqB,OAAgC;AACpE,EAAA,GAAA,cAAA,UAAS,GAAGA,4BAAAA,oBAAoB,MAAM,CAAC"}

package/dist/cacheTagPrismicPages.d.cts

@@ -1,6 +1,18 @@
 import { PrismicDocument } from "@prismicio/client";
 
 //#region src/cacheTagPrismicPages.d.ts
+/**
+ * Tags the current cache entry with cache tags for a set of Prismic pages so they can be
+ * revalidated when their content changes.
+ *
+ * Linked documents (via content relationships) are tagged as well, so the cache entry is
+ * revalidated when any of its nested documents change.
+ *
+ * @param pages - A set of Prismic pages used to tag the cache entry.
+ * @experimental
+ *
+ * @see {@link https://nextjs.org/docs/app/api-reference/functions/cacheTag}
+ */
 declare function cacheTagPrismicPages(pages: PrismicDocument[]): void;
 //#endregion
 export { cacheTagPrismicPages };

package/dist/cacheTagPrismicPages.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"cacheTagPrismicPages.d.cts","names":[],"sources":["../src/cacheTagPrismicPages.ts"],"mappings":";;;iBAKgB,oBAAA,CAAqB,KAAA,EAAO,eAAA"}
+{"version":3,"file":"cacheTagPrismicPages.d.cts","names":[],"sources":["../src/cacheTagPrismicPages.ts"],"mappings":";;;;;AAiBA;;;;;;;;;;iBAAgB,oBAAA,CAAqB,KAAA,EAAO,eAAA"}

package/dist/cacheTagPrismicPages.d.ts

@@ -1,6 +1,18 @@
 import { PrismicDocument } from "@prismicio/client";
 
 //#region src/cacheTagPrismicPages.d.ts
+/**
+ * Tags the current cache entry with cache tags for a set of Prismic pages so they can be
+ * revalidated when their content changes.
+ *
+ * Linked documents (via content relationships) are tagged as well, so the cache entry is
+ * revalidated when any of its nested documents change.
+ *
+ * @param pages - A set of Prismic pages used to tag the cache entry.
+ * @experimental
+ *
+ * @see {@link https://nextjs.org/docs/app/api-reference/functions/cacheTag}
+ */
 declare function cacheTagPrismicPages(pages: PrismicDocument[]): void;
 //#endregion
 export { cacheTagPrismicPages };

package/dist/cacheTagPrismicPages.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cacheTagPrismicPages.d.ts","names":[],"sources":["../src/cacheTagPrismicPages.ts"],"mappings":";;;iBAKgB,oBAAA,CAAqB,KAAA,EAAO,eAAA"}
+{"version":3,"file":"cacheTagPrismicPages.d.ts","names":[],"sources":["../src/cacheTagPrismicPages.ts"],"mappings":";;;;;AAiBA;;;;;;;;;;iBAAgB,oBAAA,CAAqB,KAAA,EAAO,eAAA"}

package/dist/cacheTagPrismicPages.js

@@ -1,6 +1,18 @@
 import { getPrismicCacheTags } from "./getPrismicCacheTags.js";
 import { cacheTag } from "next/cache.js";
 //#region src/cacheTagPrismicPages.ts
+/**
+* Tags the current cache entry with cache tags for a set of Prismic pages so they can be
+* revalidated when their content changes.
+*
+* Linked documents (via content relationships) are tagged as well, so the cache entry is
+* revalidated when any of its nested documents change.
+*
+* @param pages - A set of Prismic pages used to tag the cache entry.
+* @experimental
+*
+* @see {@link https://nextjs.org/docs/app/api-reference/functions/cacheTag}
+*/
 function cacheTagPrismicPages(pages) {
 	cacheTag(...getPrismicCacheTags(pages));
 }

package/dist/cacheTagPrismicPages.js.map

@@ -1 +1 @@
-{"version":3,"file":"cacheTagPrismicPages.js","names":[],"sources":["../src/cacheTagPrismicPages.ts"],"sourcesContent":["import type { PrismicDocument } from \"@prismicio/client\"\nimport { cacheTag } from \"next/cache\"\n\nimport { getPrismicCacheTags } from \"./getPrismicCacheTags\"\n\nexport function cacheTagPrismicPages(pages: PrismicDocument[]): void {\n\tcacheTag(...getPrismicCacheTags(pages))\n}\n"],"mappings":";;;AAKA,SAAgB,qBAAqB,OAAgC;AACpE,UAAS,GAAG,oBAAoB,MAAM,CAAC"}
+{"version":3,"file":"cacheTagPrismicPages.js","names":[],"sources":["../src/cacheTagPrismicPages.ts"],"sourcesContent":["import type { PrismicDocument } from \"@prismicio/client\"\nimport { cacheTag } from \"next/cache\"\n\nimport { getPrismicCacheTags } from \"./getPrismicCacheTags\"\n\n/**\n * Tags the current cache entry with cache tags for a set of Prismic pages so they can be\n * revalidated when their content changes.\n *\n * Linked documents (via content relationships) are tagged as well, so the cache entry is\n * revalidated when any of its nested documents change.\n *\n * @param pages - A set of Prismic pages used to tag the cache entry.\n * @experimental\n *\n * @see {@link https://nextjs.org/docs/app/api-reference/functions/cacheTag}\n */\nexport function cacheTagPrismicPages(pages: PrismicDocument[]): void {\n\tcacheTag(...getPrismicCacheTags(pages))\n}\n"],"mappings":";;;;;;;;;;;;;;;AAiBA,SAAgB,qBAAqB,OAAgC;AACpE,UAAS,GAAG,oBAAoB,MAAM,CAAC"}

package/dist/getPreviewRef.cjs

@@ -2,13 +2,11 @@ require("./_virtual/_rolldown/runtime.cjs");
 let _prismicio_client = require("@prismicio/client");
 //#region src/getPreviewRef.ts
 /**
-* Reads the Prismic preview ref for the current request when an active preview
-* session exists.
+* Reads the Prismic preview ref for the current request when an active preview session exists.
 *
-* This is the read-side counterpart to `redirectToPreviewURL`, which writes the
-* preview cookie. Use it with Next.js Cache Components to read the ref _outside_
-* a cached function and pass it _in_ as an argument so it becomes part of the
-* cache key:
+* This is the read-side counterpart to `redirectToPreviewURL`, which writes the preview cookie. Use
+* it with Next.js Cache Components to read the ref _outside_ a cached function and pass it _in_ as
+* an argument so it becomes part of the cache key:
 *
 * @example
 * 	;```typescript
@@ -18,6 +16,7 @@ let _prismicio_client = require("@prismicio/client");
 * 	```
 *
 * @returns The active preview ref, or `undefined` if no preview session is active.
+* @experimental
 */
 async function getPreviewRef() {
 	const { cookies, draftMode } = await import("next/headers.js");

package/dist/getPreviewRef.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"getPreviewRef.cjs","names":["prismicCookie"],"sources":["../src/getPreviewRef.ts"],"sourcesContent":["import { cookie as prismicCookie } from \"@prismicio/client\"\n\n/**\n * Reads the Prismic preview ref for the current request when an active preview\n * session exists.\n *\n * This is the read-side counterpart to `redirectToPreviewURL`, which writes the\n * preview cookie. Use it with Next.js Cache Components to read the ref _outside_\n * a cached function and pass it _in_ as an argument so it becomes part of the\n * cache key:\n *\n * @example\n * \t;```typescript\n * \timport { getPreviewRef } from \"@prismicio/next\"\n *\n * \tconst page = await fetchPage(uid, await getPreviewRef())\n * \t```\n *\n * @returns The active preview ref, or `undefined` if no preview session is active.\n */\nexport async function getPreviewRef(): Promise<string | undefined> {\n\t// Need this to avoid the following Next.js build-time error:\n\t// You're importing a component that needs next/headers. That only works\n\t// in a Server Component which is not supported in the pages/ directory.\n\tconst { cookies, draftMode } = await import(\"next/headers\")\n\n\tlet isDraftModeEnabled = false\n\ttry {\n\t\tisDraftModeEnabled = (await draftMode()).isEnabled\n\t} catch {\n\t\t// `draftMode()` may have been called in a place that\n\t\t// does not have access to its async storage. This\n\t\t// occurs in places like `generateStaticParams()`. We\n\t\t// can ignore this case.\n\t\treturn\n\t}\n\tif (!isDraftModeEnabled) {\n\t\treturn\n\t}\n\n\tconst cookie = (await cookies()).get(prismicCookie.preview)?.value\n\tif (!cookie) {\n\t\treturn\n\t}\n\n\tconst isActiveCookie = cookie.includes(\"websitePreviewId=\")\n\tif (!isActiveCookie) {\n\t\treturn\n\t}\n\n\treturn cookie\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;AAoBA,eAAsB,gBAA6C;CAIlE,MAAM,EAAE,SAAS,cAAc,MAAM,OAAO;CAE5C,IAAI,qBAAqB;AACzB,KAAI;AACH,wBAAsB,MAAM,WAAW,EAAE;SAClC;AAKP;;AAED,KAAI,CAAC,mBACJ;CAGD,MAAM,UAAU,MAAM,SAAS,EAAE,IAAIA,kBAAAA,OAAc,QAAQ,EAAE;AAC7D,KAAI,CAAC,OACJ;AAID,KAAI,CADmB,OAAO,SAAS,oBAAoB,CAE1D;AAGD,QAAO"}
+{"version":3,"file":"getPreviewRef.cjs","names":["prismicCookie"],"sources":["../src/getPreviewRef.ts"],"sourcesContent":["import { cookie as prismicCookie } from \"@prismicio/client\"\n\n/**\n * Reads the Prismic preview ref for the current request when an active preview session exists.\n *\n * This is the read-side counterpart to `redirectToPreviewURL`, which writes the preview cookie. Use\n * it with Next.js Cache Components to read the ref _outside_ a cached function and pass it _in_ as\n * an argument so it becomes part of the cache key:\n *\n * @example\n * \t;```typescript\n * \timport { getPreviewRef } from \"@prismicio/next\"\n *\n * \tconst page = await fetchPage(uid, await getPreviewRef())\n * \t```\n *\n * @returns The active preview ref, or `undefined` if no preview session is active.\n * @experimental\n */\nexport async function getPreviewRef(): Promise<string | undefined> {\n\t// Need this to avoid the following Next.js build-time error:\n\t// You're importing a component that needs next/headers. That only works\n\t// in a Server Component which is not supported in the pages/ directory.\n\tconst { cookies, draftMode } = await import(\"next/headers\")\n\n\tlet isDraftModeEnabled = false\n\ttry {\n\t\tisDraftModeEnabled = (await draftMode()).isEnabled\n\t} catch {\n\t\t// `draftMode()` may have been called in a place that\n\t\t// does not have access to its async storage. This\n\t\t// occurs in places like `generateStaticParams()`. We\n\t\t// can ignore this case.\n\t\treturn\n\t}\n\tif (!isDraftModeEnabled) {\n\t\treturn\n\t}\n\n\tconst cookie = (await cookies()).get(prismicCookie.preview)?.value\n\tif (!cookie) {\n\t\treturn\n\t}\n\n\tconst isActiveCookie = cookie.includes(\"websitePreviewId=\")\n\tif (!isActiveCookie) {\n\t\treturn\n\t}\n\n\treturn cookie\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAmBA,eAAsB,gBAA6C;CAIlE,MAAM,EAAE,SAAS,cAAc,MAAM,OAAO;CAE5C,IAAI,qBAAqB;AACzB,KAAI;AACH,wBAAsB,MAAM,WAAW,EAAE;SAClC;AAKP;;AAED,KAAI,CAAC,mBACJ;CAGD,MAAM,UAAU,MAAM,SAAS,EAAE,IAAIA,kBAAAA,OAAc,QAAQ,EAAE;AAC7D,KAAI,CAAC,OACJ;AAID,KAAI,CADmB,OAAO,SAAS,oBAAoB,CAE1D;AAGD,QAAO"}

package/dist/getPreviewRef.d.cts

@@ -1,12 +1,10 @@
 //#region src/getPreviewRef.d.ts
 /**
- * Reads the Prismic preview ref for the current request when an active preview
- * session exists.
+ * Reads the Prismic preview ref for the current request when an active preview session exists.
  *
- * This is the read-side counterpart to `redirectToPreviewURL`, which writes the
- * preview cookie. Use it with Next.js Cache Components to read the ref _outside_
- * a cached function and pass it _in_ as an argument so it becomes part of the
- * cache key:
+ * This is the read-side counterpart to `redirectToPreviewURL`, which writes the preview cookie. Use
+ * it with Next.js Cache Components to read the ref _outside_ a cached function and pass it _in_ as
+ * an argument so it becomes part of the cache key:
  *
  * @example
  * 	;```typescript
@@ -16,6 +14,7 @@
  * 	```
  *
  * @returns The active preview ref, or `undefined` if no preview session is active.
+ * @experimental
  */
 declare function getPreviewRef(): Promise<string | undefined>;
 //#endregion

package/dist/getPreviewRef.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"getPreviewRef.d.cts","names":[],"sources":["../src/getPreviewRef.ts"],"mappings":";;AAoBA;;;;;;;;;;;;;;;;;iBAAsB,aAAA,CAAA,GAAiB,OAAA"}
+{"version":3,"file":"getPreviewRef.d.cts","names":[],"sources":["../src/getPreviewRef.ts"],"mappings":";;AAmBA;;;;;;;;;;;;;;;;iBAAsB,aAAA,CAAA,GAAiB,OAAA"}

package/dist/getPreviewRef.d.ts

@@ -1,12 +1,10 @@
 //#region src/getPreviewRef.d.ts
 /**
- * Reads the Prismic preview ref for the current request when an active preview
- * session exists.
+ * Reads the Prismic preview ref for the current request when an active preview session exists.
  *
- * This is the read-side counterpart to `redirectToPreviewURL`, which writes the
- * preview cookie. Use it with Next.js Cache Components to read the ref _outside_
- * a cached function and pass it _in_ as an argument so it becomes part of the
- * cache key:
+ * This is the read-side counterpart to `redirectToPreviewURL`, which writes the preview cookie. Use
+ * it with Next.js Cache Components to read the ref _outside_ a cached function and pass it _in_ as
+ * an argument so it becomes part of the cache key:
  *
  * @example
  * 	;```typescript
@@ -16,6 +14,7 @@
  * 	```
  *
  * @returns The active preview ref, or `undefined` if no preview session is active.
+ * @experimental
  */
 declare function getPreviewRef(): Promise<string | undefined>;
 //#endregion

package/dist/getPreviewRef.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"getPreviewRef.d.ts","names":[],"sources":["../src/getPreviewRef.ts"],"mappings":";;AAoBA;;;;;;;;;;;;;;;;;iBAAsB,aAAA,CAAA,GAAiB,OAAA"}
+{"version":3,"file":"getPreviewRef.d.ts","names":[],"sources":["../src/getPreviewRef.ts"],"mappings":";;AAmBA;;;;;;;;;;;;;;;;iBAAsB,aAAA,CAAA,GAAiB,OAAA"}

package/dist/getPreviewRef.js

@@ -1,13 +1,11 @@
 import { cookie } from "@prismicio/client";
 //#region src/getPreviewRef.ts
 /**
-* Reads the Prismic preview ref for the current request when an active preview
-* session exists.
+* Reads the Prismic preview ref for the current request when an active preview session exists.
 *
-* This is the read-side counterpart to `redirectToPreviewURL`, which writes the
-* preview cookie. Use it with Next.js Cache Components to read the ref _outside_
-* a cached function and pass it _in_ as an argument so it becomes part of the
-* cache key:
+* This is the read-side counterpart to `redirectToPreviewURL`, which writes the preview cookie. Use
+* it with Next.js Cache Components to read the ref _outside_ a cached function and pass it _in_ as
+* an argument so it becomes part of the cache key:
 *
 * @example
 * 	;```typescript
@@ -17,6 +15,7 @@ import { cookie } from "@prismicio/client";
 * 	```
 *
 * @returns The active preview ref, or `undefined` if no preview session is active.
+* @experimental
 */
 async function getPreviewRef() {
 	const { cookies, draftMode } = await import("next/headers.js");

package/dist/getPreviewRef.js.map

@@ -1 +1 @@
-{"version":3,"file":"getPreviewRef.js","names":["cookie","prismicCookie"],"sources":["../src/getPreviewRef.ts"],"sourcesContent":["import { cookie as prismicCookie } from \"@prismicio/client\"\n\n/**\n * Reads the Prismic preview ref for the current request when an active preview\n * session exists.\n *\n * This is the read-side counterpart to `redirectToPreviewURL`, which writes the\n * preview cookie. Use it with Next.js Cache Components to read the ref _outside_\n * a cached function and pass it _in_ as an argument so it becomes part of the\n * cache key:\n *\n * @example\n * \t;```typescript\n * \timport { getPreviewRef } from \"@prismicio/next\"\n *\n * \tconst page = await fetchPage(uid, await getPreviewRef())\n * \t```\n *\n * @returns The active preview ref, or `undefined` if no preview session is active.\n */\nexport async function getPreviewRef(): Promise<string | undefined> {\n\t// Need this to avoid the following Next.js build-time error:\n\t// You're importing a component that needs next/headers. That only works\n\t// in a Server Component which is not supported in the pages/ directory.\n\tconst { cookies, draftMode } = await import(\"next/headers\")\n\n\tlet isDraftModeEnabled = false\n\ttry {\n\t\tisDraftModeEnabled = (await draftMode()).isEnabled\n\t} catch {\n\t\t// `draftMode()` may have been called in a place that\n\t\t// does not have access to its async storage. This\n\t\t// occurs in places like `generateStaticParams()`. We\n\t\t// can ignore this case.\n\t\treturn\n\t}\n\tif (!isDraftModeEnabled) {\n\t\treturn\n\t}\n\n\tconst cookie = (await cookies()).get(prismicCookie.preview)?.value\n\tif (!cookie) {\n\t\treturn\n\t}\n\n\tconst isActiveCookie = cookie.includes(\"websitePreviewId=\")\n\tif (!isActiveCookie) {\n\t\treturn\n\t}\n\n\treturn cookie\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAoBA,eAAsB,gBAA6C;CAIlE,MAAM,EAAE,SAAS,cAAc,MAAM,OAAO;CAE5C,IAAI,qBAAqB;AACzB,KAAI;AACH,wBAAsB,MAAM,WAAW,EAAE;SAClC;AAKP;;AAED,KAAI,CAAC,mBACJ;CAGD,MAAMA,YAAU,MAAM,SAAS,EAAE,IAAIC,OAAc,QAAQ,EAAE;AAC7D,KAAI,CAACD,SACJ;AAID,KAAI,CADmBA,SAAO,SAAS,oBAAoB,CAE1D;AAGD,QAAOA"}
+{"version":3,"file":"getPreviewRef.js","names":["cookie","prismicCookie"],"sources":["../src/getPreviewRef.ts"],"sourcesContent":["import { cookie as prismicCookie } from \"@prismicio/client\"\n\n/**\n * Reads the Prismic preview ref for the current request when an active preview session exists.\n *\n * This is the read-side counterpart to `redirectToPreviewURL`, which writes the preview cookie. Use\n * it with Next.js Cache Components to read the ref _outside_ a cached function and pass it _in_ as\n * an argument so it becomes part of the cache key:\n *\n * @example\n * \t;```typescript\n * \timport { getPreviewRef } from \"@prismicio/next\"\n *\n * \tconst page = await fetchPage(uid, await getPreviewRef())\n * \t```\n *\n * @returns The active preview ref, or `undefined` if no preview session is active.\n * @experimental\n */\nexport async function getPreviewRef(): Promise<string | undefined> {\n\t// Need this to avoid the following Next.js build-time error:\n\t// You're importing a component that needs next/headers. That only works\n\t// in a Server Component which is not supported in the pages/ directory.\n\tconst { cookies, draftMode } = await import(\"next/headers\")\n\n\tlet isDraftModeEnabled = false\n\ttry {\n\t\tisDraftModeEnabled = (await draftMode()).isEnabled\n\t} catch {\n\t\t// `draftMode()` may have been called in a place that\n\t\t// does not have access to its async storage. This\n\t\t// occurs in places like `generateStaticParams()`. We\n\t\t// can ignore this case.\n\t\treturn\n\t}\n\tif (!isDraftModeEnabled) {\n\t\treturn\n\t}\n\n\tconst cookie = (await cookies()).get(prismicCookie.preview)?.value\n\tif (!cookie) {\n\t\treturn\n\t}\n\n\tconst isActiveCookie = cookie.includes(\"websitePreviewId=\")\n\tif (!isActiveCookie) {\n\t\treturn\n\t}\n\n\treturn cookie\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;AAmBA,eAAsB,gBAA6C;CAIlE,MAAM,EAAE,SAAS,cAAc,MAAM,OAAO;CAE5C,IAAI,qBAAqB;AACzB,KAAI;AACH,wBAAsB,MAAM,WAAW,EAAE;SAClC;AAKP;;AAED,KAAI,CAAC,mBACJ;CAGD,MAAMA,YAAU,MAAM,SAAS,EAAE,IAAIC,OAAc,QAAQ,EAAE;AAC7D,KAAI,CAACD,SACJ;AAID,KAAI,CADmBA,SAAO,SAAS,oBAAoB,CAE1D;AAGD,QAAOA"}

package/dist/getPrismicCacheTags.cjs

@@ -5,6 +5,8 @@ const CACHE_TAG_PREFIX = "prismic/";
 * relationship) are included to ensure all related content can be revalidated.
 *
 * @param pages - A set of Prismic pages used to tag the function.
+* @experimental
+*
 * @see {@link https://nextjs.org/docs/app/api-reference/functions/cacheTag}
 */
 function getPrismicCacheTags(pages) {

package/dist/getPrismicCacheTags.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"getPrismicCacheTags.cjs","names":[],"sources":["../src/getPrismicCacheTags.ts"],"sourcesContent":["import type { PrismicDocument } from \"@prismicio/client\"\n\nconst CACHE_TAG_PREFIX = \"prismic/\"\n\n/**\n * Generates cache tags for a set of Prismic pages. Tags for linked pages (e.g. a content\n * relationship) are included to ensure all related content can be revalidated.\n *\n * @param pages - A set of Prismic pages used to tag the function.\n * @see {@link https://nextjs.org/docs/app/api-reference/functions/cacheTag}\n */\nexport function getPrismicCacheTags(pages: PrismicDocument[]): string[] {\n\tconst ids = [...new Set(getPrismicDocumentIDs(pages))]\n\treturn ids.map((id) => buildPrismicCacheTag(id))\n}\n\nexport function buildPrismicCacheTag(id: string): string {\n\treturn `${CACHE_TAG_PREFIX}${id}`\n}\n\nfunction getPrismicDocumentIDs(input: unknown): string[] {\n\tif (typeof input !== \"object\" || input == null) return []\n\n\tif (Array.isArray(input)) return input.flatMap((item) => getPrismicDocumentIDs(item))\n\n\tif (\"id\" in input && typeof input.id === \"string\") {\n\t\t// Document\n\t\t// Content relationship or link\n\t\tif (\n\t\t\t(\"href\" in input &&\n\t\t\t\ttypeof input.href === \"string\" &&\n\t\t\t\tinput.href.includes(\"/api/v2/documents/search?\")) ||\n\t\t\t(\"link_type\" in input && input.link_type === \"Document\")\n\t\t) {\n\t\t\tif (\"data\" in input && typeof input.data === \"object\" && input.data !== null) {\n\t\t\t\treturn [input.id, ...getPrismicDocumentIDs(input.data)]\n\t\t\t} else {\n\t\t\t\treturn [input.id]\n\t\t\t}\n\t\t}\n\t}\n\n\treturn Object.values(input).flatMap((input) => getPrismicDocumentIDs(input))\n}\n"],"mappings":";AAEA,MAAM,mBAAmB;;;;;;;;AASzB,SAAgB,oBAAoB,OAAoC;AAEvE,QADY,CAAC,GAAG,IAAI,IAAI,sBAAsB,MAAM,CAAC,CAAC,CAC3C,KAAK,OAAO,qBAAqB,GAAG,CAAC;;AAGjD,SAAgB,qBAAqB,IAAoB;AACxD,QAAO,GAAG,mBAAmB;;AAG9B,SAAS,sBAAsB,OAA0B;AACxD,KAAI,OAAO,UAAU,YAAY,SAAS,KAAM,QAAO,EAAE;AAEzD,KAAI,MAAM,QAAQ,MAAM,CAAE,QAAO,MAAM,SAAS,SAAS,sBAAsB,KAAK,CAAC;AAErF,KAAI,QAAQ,SAAS,OAAO,MAAM,OAAO;MAItC,UAAU,SACV,OAAO,MAAM,SAAS,YACtB,MAAM,KAAK,SAAS,4BAA4B,IAChD,eAAe,SAAS,MAAM,cAAc,WAE7C,KAAI,UAAU,SAAS,OAAO,MAAM,SAAS,YAAY,MAAM,SAAS,KACvE,QAAO,CAAC,MAAM,IAAI,GAAG,sBAAsB,MAAM,KAAK,CAAC;MAEvD,QAAO,CAAC,MAAM,GAAG;;AAKpB,QAAO,OAAO,OAAO,MAAM,CAAC,SAAS,UAAU,sBAAsB,MAAM,CAAC"}
+{"version":3,"file":"getPrismicCacheTags.cjs","names":[],"sources":["../src/getPrismicCacheTags.ts"],"sourcesContent":["import type { PrismicDocument } from \"@prismicio/client\"\n\nconst CACHE_TAG_PREFIX = \"prismic/\"\n\n/**\n * Generates cache tags for a set of Prismic pages. Tags for linked pages (e.g. a content\n * relationship) are included to ensure all related content can be revalidated.\n *\n * @param pages - A set of Prismic pages used to tag the function.\n * @experimental\n *\n * @see {@link https://nextjs.org/docs/app/api-reference/functions/cacheTag}\n */\nexport function getPrismicCacheTags(pages: PrismicDocument[]): string[] {\n\tconst ids = [...new Set(getPrismicDocumentIDs(pages))]\n\treturn ids.map((id) => buildPrismicCacheTag(id))\n}\n\nexport function buildPrismicCacheTag(id: string): string {\n\treturn `${CACHE_TAG_PREFIX}${id}`\n}\n\nfunction getPrismicDocumentIDs(input: unknown): string[] {\n\tif (typeof input !== \"object\" || input == null) return []\n\n\tif (Array.isArray(input)) return input.flatMap((item) => getPrismicDocumentIDs(item))\n\n\tif (\"id\" in input && typeof input.id === \"string\") {\n\t\t// Document\n\t\t// Content relationship or link\n\t\tif (\n\t\t\t(\"href\" in input &&\n\t\t\t\ttypeof input.href === \"string\" &&\n\t\t\t\tinput.href.includes(\"/api/v2/documents/search?\")) ||\n\t\t\t(\"link_type\" in input && input.link_type === \"Document\")\n\t\t) {\n\t\t\tif (\"data\" in input && typeof input.data === \"object\" && input.data !== null) {\n\t\t\t\treturn [input.id, ...getPrismicDocumentIDs(input.data)]\n\t\t\t} else {\n\t\t\t\treturn [input.id]\n\t\t\t}\n\t\t}\n\t}\n\n\treturn Object.values(input).flatMap((input) => getPrismicDocumentIDs(input))\n}\n"],"mappings":";AAEA,MAAM,mBAAmB;;;;;;;;;;AAWzB,SAAgB,oBAAoB,OAAoC;AAEvE,QADY,CAAC,GAAG,IAAI,IAAI,sBAAsB,MAAM,CAAC,CAAC,CAC3C,KAAK,OAAO,qBAAqB,GAAG,CAAC;;AAGjD,SAAgB,qBAAqB,IAAoB;AACxD,QAAO,GAAG,mBAAmB;;AAG9B,SAAS,sBAAsB,OAA0B;AACxD,KAAI,OAAO,UAAU,YAAY,SAAS,KAAM,QAAO,EAAE;AAEzD,KAAI,MAAM,QAAQ,MAAM,CAAE,QAAO,MAAM,SAAS,SAAS,sBAAsB,KAAK,CAAC;AAErF,KAAI,QAAQ,SAAS,OAAO,MAAM,OAAO;MAItC,UAAU,SACV,OAAO,MAAM,SAAS,YACtB,MAAM,KAAK,SAAS,4BAA4B,IAChD,eAAe,SAAS,MAAM,cAAc,WAE7C,KAAI,UAAU,SAAS,OAAO,MAAM,SAAS,YAAY,MAAM,SAAS,KACvE,QAAO,CAAC,MAAM,IAAI,GAAG,sBAAsB,MAAM,KAAK,CAAC;MAEvD,QAAO,CAAC,MAAM,GAAG;;AAKpB,QAAO,OAAO,OAAO,MAAM,CAAC,SAAS,UAAU,sBAAsB,MAAM,CAAC"}

package/dist/getPrismicCacheTags.d.cts

@@ -6,6 +6,8 @@ import { PrismicDocument } from "@prismicio/client";
  * relationship) are included to ensure all related content can be revalidated.
  *
  * @param pages - A set of Prismic pages used to tag the function.
+ * @experimental
+ *
  * @see {@link https://nextjs.org/docs/app/api-reference/functions/cacheTag}
  */
 declare function getPrismicCacheTags(pages: PrismicDocument[]): string[];

package/dist/getPrismicCacheTags.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"getPrismicCacheTags.d.cts","names":[],"sources":["../src/getPrismicCacheTags.ts"],"mappings":";;;;;AAWA;;;;;iBAAgB,mBAAA,CAAoB,KAAA,EAAO,eAAA"}
+{"version":3,"file":"getPrismicCacheTags.d.cts","names":[],"sources":["../src/getPrismicCacheTags.ts"],"mappings":";;;;;AAaA;;;;;;;iBAAgB,mBAAA,CAAoB,KAAA,EAAO,eAAA"}

package/dist/getPrismicCacheTags.d.ts

@@ -6,6 +6,8 @@ import { PrismicDocument } from "@prismicio/client";
  * relationship) are included to ensure all related content can be revalidated.
  *
  * @param pages - A set of Prismic pages used to tag the function.
+ * @experimental
+ *
  * @see {@link https://nextjs.org/docs/app/api-reference/functions/cacheTag}
  */
 declare function getPrismicCacheTags(pages: PrismicDocument[]): string[];

package/dist/getPrismicCacheTags.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"getPrismicCacheTags.d.ts","names":[],"sources":["../src/getPrismicCacheTags.ts"],"mappings":";;;;;AAWA;;;;;iBAAgB,mBAAA,CAAoB,KAAA,EAAO,eAAA"}
+{"version":3,"file":"getPrismicCacheTags.d.ts","names":[],"sources":["../src/getPrismicCacheTags.ts"],"mappings":";;;;;AAaA;;;;;;;iBAAgB,mBAAA,CAAoB,KAAA,EAAO,eAAA"}

package/dist/getPrismicCacheTags.js

@@ -5,6 +5,8 @@ const CACHE_TAG_PREFIX = "prismic/";
 * relationship) are included to ensure all related content can be revalidated.
 *
 * @param pages - A set of Prismic pages used to tag the function.
+* @experimental
+*
 * @see {@link https://nextjs.org/docs/app/api-reference/functions/cacheTag}
 */
 function getPrismicCacheTags(pages) {

package/dist/getPrismicCacheTags.js.map

@@ -1 +1 @@
-{"version":3,"file":"getPrismicCacheTags.js","names":[],"sources":["../src/getPrismicCacheTags.ts"],"sourcesContent":["import type { PrismicDocument } from \"@prismicio/client\"\n\nconst CACHE_TAG_PREFIX = \"prismic/\"\n\n/**\n * Generates cache tags for a set of Prismic pages. Tags for linked pages (e.g. a content\n * relationship) are included to ensure all related content can be revalidated.\n *\n * @param pages - A set of Prismic pages used to tag the function.\n * @see {@link https://nextjs.org/docs/app/api-reference/functions/cacheTag}\n */\nexport function getPrismicCacheTags(pages: PrismicDocument[]): string[] {\n\tconst ids = [...new Set(getPrismicDocumentIDs(pages))]\n\treturn ids.map((id) => buildPrismicCacheTag(id))\n}\n\nexport function buildPrismicCacheTag(id: string): string {\n\treturn `${CACHE_TAG_PREFIX}${id}`\n}\n\nfunction getPrismicDocumentIDs(input: unknown): string[] {\n\tif (typeof input !== \"object\" || input == null) return []\n\n\tif (Array.isArray(input)) return input.flatMap((item) => getPrismicDocumentIDs(item))\n\n\tif (\"id\" in input && typeof input.id === \"string\") {\n\t\t// Document\n\t\t// Content relationship or link\n\t\tif (\n\t\t\t(\"href\" in input &&\n\t\t\t\ttypeof input.href === \"string\" &&\n\t\t\t\tinput.href.includes(\"/api/v2/documents/search?\")) ||\n\t\t\t(\"link_type\" in input && input.link_type === \"Document\")\n\t\t) {\n\t\t\tif (\"data\" in input && typeof input.data === \"object\" && input.data !== null) {\n\t\t\t\treturn [input.id, ...getPrismicDocumentIDs(input.data)]\n\t\t\t} else {\n\t\t\t\treturn [input.id]\n\t\t\t}\n\t\t}\n\t}\n\n\treturn Object.values(input).flatMap((input) => getPrismicDocumentIDs(input))\n}\n"],"mappings":";AAEA,MAAM,mBAAmB;;;;;;;;AASzB,SAAgB,oBAAoB,OAAoC;AAEvE,QADY,CAAC,GAAG,IAAI,IAAI,sBAAsB,MAAM,CAAC,CAAC,CAC3C,KAAK,OAAO,qBAAqB,GAAG,CAAC;;AAGjD,SAAgB,qBAAqB,IAAoB;AACxD,QAAO,GAAG,mBAAmB;;AAG9B,SAAS,sBAAsB,OAA0B;AACxD,KAAI,OAAO,UAAU,YAAY,SAAS,KAAM,QAAO,EAAE;AAEzD,KAAI,MAAM,QAAQ,MAAM,CAAE,QAAO,MAAM,SAAS,SAAS,sBAAsB,KAAK,CAAC;AAErF,KAAI,QAAQ,SAAS,OAAO,MAAM,OAAO;MAItC,UAAU,SACV,OAAO,MAAM,SAAS,YACtB,MAAM,KAAK,SAAS,4BAA4B,IAChD,eAAe,SAAS,MAAM,cAAc,WAE7C,KAAI,UAAU,SAAS,OAAO,MAAM,SAAS,YAAY,MAAM,SAAS,KACvE,QAAO,CAAC,MAAM,IAAI,GAAG,sBAAsB,MAAM,KAAK,CAAC;MAEvD,QAAO,CAAC,MAAM,GAAG;;AAKpB,QAAO,OAAO,OAAO,MAAM,CAAC,SAAS,UAAU,sBAAsB,MAAM,CAAC"}
+{"version":3,"file":"getPrismicCacheTags.js","names":[],"sources":["../src/getPrismicCacheTags.ts"],"sourcesContent":["import type { PrismicDocument } from \"@prismicio/client\"\n\nconst CACHE_TAG_PREFIX = \"prismic/\"\n\n/**\n * Generates cache tags for a set of Prismic pages. Tags for linked pages (e.g. a content\n * relationship) are included to ensure all related content can be revalidated.\n *\n * @param pages - A set of Prismic pages used to tag the function.\n * @experimental\n *\n * @see {@link https://nextjs.org/docs/app/api-reference/functions/cacheTag}\n */\nexport function getPrismicCacheTags(pages: PrismicDocument[]): string[] {\n\tconst ids = [...new Set(getPrismicDocumentIDs(pages))]\n\treturn ids.map((id) => buildPrismicCacheTag(id))\n}\n\nexport function buildPrismicCacheTag(id: string): string {\n\treturn `${CACHE_TAG_PREFIX}${id}`\n}\n\nfunction getPrismicDocumentIDs(input: unknown): string[] {\n\tif (typeof input !== \"object\" || input == null) return []\n\n\tif (Array.isArray(input)) return input.flatMap((item) => getPrismicDocumentIDs(item))\n\n\tif (\"id\" in input && typeof input.id === \"string\") {\n\t\t// Document\n\t\t// Content relationship or link\n\t\tif (\n\t\t\t(\"href\" in input &&\n\t\t\t\ttypeof input.href === \"string\" &&\n\t\t\t\tinput.href.includes(\"/api/v2/documents/search?\")) ||\n\t\t\t(\"link_type\" in input && input.link_type === \"Document\")\n\t\t) {\n\t\t\tif (\"data\" in input && typeof input.data === \"object\" && input.data !== null) {\n\t\t\t\treturn [input.id, ...getPrismicDocumentIDs(input.data)]\n\t\t\t} else {\n\t\t\t\treturn [input.id]\n\t\t\t}\n\t\t}\n\t}\n\n\treturn Object.values(input).flatMap((input) => getPrismicDocumentIDs(input))\n}\n"],"mappings":";AAEA,MAAM,mBAAmB;;;;;;;;;;AAWzB,SAAgB,oBAAoB,OAAoC;AAEvE,QADY,CAAC,GAAG,IAAI,IAAI,sBAAsB,MAAM,CAAC,CAAC,CAC3C,KAAK,OAAO,qBAAqB,GAAG,CAAC;;AAGjD,SAAgB,qBAAqB,IAAoB;AACxD,QAAO,GAAG,mBAAmB;;AAG9B,SAAS,sBAAsB,OAA0B;AACxD,KAAI,OAAO,UAAU,YAAY,SAAS,KAAM,QAAO,EAAE;AAEzD,KAAI,MAAM,QAAQ,MAAM,CAAE,QAAO,MAAM,SAAS,SAAS,sBAAsB,KAAK,CAAC;AAErF,KAAI,QAAQ,SAAS,OAAO,MAAM,OAAO;MAItC,UAAU,SACV,OAAO,MAAM,SAAS,YACtB,MAAM,KAAK,SAAS,4BAA4B,IAChD,eAAe,SAAS,MAAM,cAAc,WAE7C,KAAI,UAAU,SAAS,OAAO,MAAM,SAAS,YAAY,MAAM,SAAS,KACvE,QAAO,CAAC,MAAM,IAAI,GAAG,sBAAsB,MAAM,KAAK,CAAC;MAEvD,QAAO,CAAC,MAAM,GAAG;;AAKpB,QAAO,OAAO,OAAO,MAAM,CAAC,SAAS,UAAU,sBAAsB,MAAM,CAAC"}

package/dist/package.cjs

@@ -1,5 +1,5 @@
 //#region package.json
-var version = "2.2.4-pr.114.5e44dbe";
+var version = "2.3.0-pr.139.dd4bae7";
 //#endregion
 Object.defineProperty(exports, "version", {
 	enumerable: true,

package/dist/package.js

@@ -1,5 +1,5 @@
 //#region package.json
-var version = "2.2.4-pr.114.5e44dbe";
+var version = "2.3.0-pr.139.dd4bae7";
 //#endregion
 export { version };
 

package/dist/revalidatePrismicPages.cjs

@@ -7,6 +7,8 @@ let next_cache_js = require("next/cache.js");
 * typically comes from a Prismic webhook triggered when publishing content.
 *
 * @param ids - A list of Prismic page IDs to revalidate.
+* @experimental
+*
 * @see {@link https://nextjs.org/docs/app/api-reference/functions/revalidateTag}
 */
 function revalidatePrismicPages(ids) {

package/dist/revalidatePrismicPages.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"revalidatePrismicPages.cjs","names":["buildPrismicCacheTag"],"sources":["../src/revalidatePrismicPages.ts"],"sourcesContent":["import { revalidateTag } from \"next/cache\"\n\nimport { buildPrismicCacheTag } from \"./getPrismicCacheTags\"\n\n/**\n * Immediately revalidates a set of Prismic pages given a list of their IDs. The list of IDs\n * typically comes from a Prismic webhook triggered when publishing content.\n *\n * @param ids - A list of Prismic page IDs to revalidate.\n * @see {@link https://nextjs.org/docs/app/api-reference/functions/revalidateTag}\n */\nexport function revalidatePrismicPages(ids: string[]): void {\n\tfor (const id of ids) {\n\t\tconst tag = buildPrismicCacheTag(id)\n\t\trevalidateTag(tag, { expire: 0 })\n\t}\n}\n"],"mappings":";;;;;;;;;;;AAWA,SAAgB,uBAAuB,KAAqB;AAC3D,MAAK,MAAM,MAAM,IAEhB,EAAA,GAAA,cAAA,eADYA,4BAAAA,qBAAqB,GAAG,EACjB,EAAE,QAAQ,GAAG,CAAC"}
+{"version":3,"file":"revalidatePrismicPages.cjs","names":["buildPrismicCacheTag"],"sources":["../src/revalidatePrismicPages.ts"],"sourcesContent":["import { revalidateTag } from \"next/cache\"\n\nimport { buildPrismicCacheTag } from \"./getPrismicCacheTags\"\n\n/**\n * Immediately revalidates a set of Prismic pages given a list of their IDs. The list of IDs\n * typically comes from a Prismic webhook triggered when publishing content.\n *\n * @param ids - A list of Prismic page IDs to revalidate.\n * @experimental\n *\n * @see {@link https://nextjs.org/docs/app/api-reference/functions/revalidateTag}\n */\nexport function revalidatePrismicPages(ids: string[]): void {\n\tfor (const id of ids) {\n\t\tconst tag = buildPrismicCacheTag(id)\n\t\trevalidateTag(tag, { expire: 0 })\n\t}\n}\n"],"mappings":";;;;;;;;;;;;;AAaA,SAAgB,uBAAuB,KAAqB;AAC3D,MAAK,MAAM,MAAM,IAEhB,EAAA,GAAA,cAAA,eADYA,4BAAAA,qBAAqB,GAAG,EACjB,EAAE,QAAQ,GAAG,CAAC"}

package/dist/revalidatePrismicPages.d.cts

@@ -4,6 +4,8 @@
  * typically comes from a Prismic webhook triggered when publishing content.
  *
  * @param ids - A list of Prismic page IDs to revalidate.
+ * @experimental
+ *
  * @see {@link https://nextjs.org/docs/app/api-reference/functions/revalidateTag}
  */
 declare function revalidatePrismicPages(ids: string[]): void;

package/dist/revalidatePrismicPages.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"revalidatePrismicPages.d.cts","names":[],"sources":["../src/revalidatePrismicPages.ts"],"mappings":";;AAWA;;;;;;iBAAgB,sBAAA,CAAuB,GAAA"}
+{"version":3,"file":"revalidatePrismicPages.d.cts","names":[],"sources":["../src/revalidatePrismicPages.ts"],"mappings":";;AAaA;;;;;;;;iBAAgB,sBAAA,CAAuB,GAAA"}

package/dist/revalidatePrismicPages.d.ts

@@ -4,6 +4,8 @@
  * typically comes from a Prismic webhook triggered when publishing content.
  *
  * @param ids - A list of Prismic page IDs to revalidate.
+ * @experimental
+ *
  * @see {@link https://nextjs.org/docs/app/api-reference/functions/revalidateTag}
  */
 declare function revalidatePrismicPages(ids: string[]): void;

package/dist/revalidatePrismicPages.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"revalidatePrismicPages.d.ts","names":[],"sources":["../src/revalidatePrismicPages.ts"],"mappings":";;AAWA;;;;;;iBAAgB,sBAAA,CAAuB,GAAA"}
+{"version":3,"file":"revalidatePrismicPages.d.ts","names":[],"sources":["../src/revalidatePrismicPages.ts"],"mappings":";;AAaA;;;;;;;;iBAAgB,sBAAA,CAAuB,GAAA"}

package/dist/revalidatePrismicPages.js

@@ -6,6 +6,8 @@ import { revalidateTag } from "next/cache.js";
 * typically comes from a Prismic webhook triggered when publishing content.
 *
 * @param ids - A list of Prismic page IDs to revalidate.
+* @experimental
+*
 * @see {@link https://nextjs.org/docs/app/api-reference/functions/revalidateTag}
 */
 function revalidatePrismicPages(ids) {

package/dist/revalidatePrismicPages.js.map

@@ -1 +1 @@
-{"version":3,"file":"revalidatePrismicPages.js","names":[],"sources":["../src/revalidatePrismicPages.ts"],"sourcesContent":["import { revalidateTag } from \"next/cache\"\n\nimport { buildPrismicCacheTag } from \"./getPrismicCacheTags\"\n\n/**\n * Immediately revalidates a set of Prismic pages given a list of their IDs. The list of IDs\n * typically comes from a Prismic webhook triggered when publishing content.\n *\n * @param ids - A list of Prismic page IDs to revalidate.\n * @see {@link https://nextjs.org/docs/app/api-reference/functions/revalidateTag}\n */\nexport function revalidatePrismicPages(ids: string[]): void {\n\tfor (const id of ids) {\n\t\tconst tag = buildPrismicCacheTag(id)\n\t\trevalidateTag(tag, { expire: 0 })\n\t}\n}\n"],"mappings":";;;;;;;;;;AAWA,SAAgB,uBAAuB,KAAqB;AAC3D,MAAK,MAAM,MAAM,IAEhB,eADY,qBAAqB,GAAG,EACjB,EAAE,QAAQ,GAAG,CAAC"}
+{"version":3,"file":"revalidatePrismicPages.js","names":[],"sources":["../src/revalidatePrismicPages.ts"],"sourcesContent":["import { revalidateTag } from \"next/cache\"\n\nimport { buildPrismicCacheTag } from \"./getPrismicCacheTags\"\n\n/**\n * Immediately revalidates a set of Prismic pages given a list of their IDs. The list of IDs\n * typically comes from a Prismic webhook triggered when publishing content.\n *\n * @param ids - A list of Prismic page IDs to revalidate.\n * @experimental\n *\n * @see {@link https://nextjs.org/docs/app/api-reference/functions/revalidateTag}\n */\nexport function revalidatePrismicPages(ids: string[]): void {\n\tfor (const id of ids) {\n\t\tconst tag = buildPrismicCacheTag(id)\n\t\trevalidateTag(tag, { expire: 0 })\n\t}\n}\n"],"mappings":";;;;;;;;;;;;AAaA,SAAgB,uBAAuB,KAAqB;AAC3D,MAAK,MAAM,MAAM,IAEhB,eADY,qBAAqB,GAAG,EACjB,EAAE,QAAQ,GAAG,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@prismicio/next",
-	"version": "2.2.4-pr.114.5e44dbe",
+	"version": "2.3.0-pr.139.dd4bae7",
 	"description": "Helpers to integrate Prismic into Next.js apps",
 	"keywords": [
 		"next",

package/src/cacheTagPrismicPages.ts

@@ -3,6 +3,18 @@ import { cacheTag } from "next/cache"
 
 import { getPrismicCacheTags } from "./getPrismicCacheTags"
 
+/**
+ * Tags the current cache entry with cache tags for a set of Prismic pages so they can be
+ * revalidated when their content changes.
+ *
+ * Linked documents (via content relationships) are tagged as well, so the cache entry is
+ * revalidated when any of its nested documents change.
+ *
+ * @param pages - A set of Prismic pages used to tag the cache entry.
+ * @experimental
+ *
+ * @see {@link https://nextjs.org/docs/app/api-reference/functions/cacheTag}
+ */
 export function cacheTagPrismicPages(pages: PrismicDocument[]): void {
 	cacheTag(...getPrismicCacheTags(pages))
 }

package/src/getPreviewRef.ts

@@ -1,13 +1,11 @@
 import { cookie as prismicCookie } from "@prismicio/client"
 
 /**
- * Reads the Prismic preview ref for the current request when an active preview
- * session exists.
+ * Reads the Prismic preview ref for the current request when an active preview session exists.
  *
- * This is the read-side counterpart to `redirectToPreviewURL`, which writes the
- * preview cookie. Use it with Next.js Cache Components to read the ref _outside_
- * a cached function and pass it _in_ as an argument so it becomes part of the
- * cache key:
+ * This is the read-side counterpart to `redirectToPreviewURL`, which writes the preview cookie. Use
+ * it with Next.js Cache Components to read the ref _outside_ a cached function and pass it _in_ as
+ * an argument so it becomes part of the cache key:
  *
  * @example
  * 	;```typescript
@@ -17,6 +15,7 @@ import { cookie as prismicCookie } from "@prismicio/client"
  * 	```
  *
  * @returns The active preview ref, or `undefined` if no preview session is active.
+ * @experimental
  */
 export async function getPreviewRef(): Promise<string | undefined> {
 	// Need this to avoid the following Next.js build-time error:

package/src/getPrismicCacheTags.ts

@@ -7,6 +7,8 @@ const CACHE_TAG_PREFIX = "prismic/"
  * relationship) are included to ensure all related content can be revalidated.
  *
  * @param pages - A set of Prismic pages used to tag the function.
+ * @experimental
+ *
  * @see {@link https://nextjs.org/docs/app/api-reference/functions/cacheTag}
  */
 export function getPrismicCacheTags(pages: PrismicDocument[]): string[] {

package/src/revalidatePrismicPages.ts

@@ -7,6 +7,8 @@ import { buildPrismicCacheTag } from "./getPrismicCacheTags"
  * typically comes from a Prismic webhook triggered when publishing content.
  *
  * @param ids - A list of Prismic page IDs to revalidate.
+ * @experimental
+ *
  * @see {@link https://nextjs.org/docs/app/api-reference/functions/revalidateTag}
  */
 export function revalidatePrismicPages(ids: string[]): void {