@prismicio/next 2.2.4 → 2.3.0

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>, "href" | "rel" | "field" | "document"> & {
+} & _$react.RefAttributes<HTMLAnchorElement>, "rel" | "field" | "href" | "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>, "href" | "rel" | "field" | "document"> & {
+} & _$react.RefAttributes<HTMLAnchorElement>, "rel" | "field" | "href" | "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>, "href" | "rel" | "field" | "document"> & {
+} & _$react.RefAttributes<HTMLAnchorElement>, "rel" | "field" | "href" | "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>, "href" | "rel" | "field" | "document"> & {
+} & _$react.RefAttributes<HTMLAnchorElement>, "rel" | "field" | "href" | "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>, "href" | "rel" | "field" | "document"> & {
+} & _$react.RefAttributes<HTMLAnchorElement>, "rel" | "field" | "href" | "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>, "href" | "rel" | "field" | "document"> & {
+} & _$react.RefAttributes<HTMLAnchorElement>, "rel" | "field" | "href" | "document"> & {
   linkResolver?: LinkResolverFunction;
   rel?: string | AsLinkAttrsConfig["rel"];
 } & {

package/dist/cacheTagPrismicPages.cjs

@@ -0,0 +1,23 @@
+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));
+}
+//#endregion
+exports.cacheTagPrismicPages = cacheTagPrismicPages;
+
+//# sourceMappingURL=cacheTagPrismicPages.cjs.map

package/dist/cacheTagPrismicPages.cjs.map

@@ -0,0 +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\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

@@ -0,0 +1,19 @@
+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 };
+//# sourceMappingURL=cacheTagPrismicPages.d.cts.map

package/dist/cacheTagPrismicPages.d.cts.map

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

package/dist/cacheTagPrismicPages.d.ts

@@ -0,0 +1,19 @@
+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 };
+//# sourceMappingURL=cacheTagPrismicPages.d.ts.map

package/dist/cacheTagPrismicPages.d.ts.map

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

package/dist/cacheTagPrismicPages.js

@@ -0,0 +1,22 @@
+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));
+}
+//#endregion
+export { cacheTagPrismicPages };
+
+//# sourceMappingURL=cacheTagPrismicPages.js.map

package/dist/cacheTagPrismicPages.js.map

@@ -0,0 +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\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/enableAutoPreviews.cjs

@@ -1,5 +1,4 @@
-require("./_virtual/_rolldown/runtime.cjs");
-let _prismicio_client = require("@prismicio/client");
+const require_getPreviewRef = require("./getPreviewRef.cjs");
 //#region src/enableAutoPreviews.ts
 /**
 * Configures a Prismic client to automatically query draft content during a preview session.
@@ -7,20 +6,7 @@ let _prismicio_client = require("@prismicio/client");
 * @param config - Configuration for the function.
 */
 function enableAutoPreviews(config) {
-	config.client.queryContentFromRef(async () => {
-		const { cookies, draftMode } = await import("next/headers.js");
-		let isDraftModeEnabled = false;
-		try {
-			isDraftModeEnabled = (await draftMode()).isEnabled;
-		} catch {
-			return;
-		}
-		if (!isDraftModeEnabled) return;
-		const cookie = (await cookies()).get(_prismicio_client.cookie.preview)?.value;
-		if (!cookie) return;
-		if (!cookie.includes("websitePreviewId=")) return;
-		return cookie;
-	});
+	config.client.queryContentFromRef(() => require_getPreviewRef.getPreviewRef());
 }
 //#endregion
 exports.enableAutoPreviews = enableAutoPreviews;

package/dist/enableAutoPreviews.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"enableAutoPreviews.cjs","names":["prismicCookie"],"sources":["../src/enableAutoPreviews.ts"],"sourcesContent":["import { type Client, cookie as prismicCookie } from \"@prismicio/client\"\n\n/** Configuration for `enableAutoPreviews`. */\nexport type EnableAutoPreviewsConfig = {\n\t/** Prismic client with which automatic previews will be enabled. */\n\t// `Pick` is used to use the smallest possible subset of\n\t// `prismic.Client`. Doing this reduces the surface area for breaking\n\t// type changes.\n\tclient: Pick<Client, \"queryContentFromRef\" | \"enableAutoPreviewsFromReq\">\n}\n\n/**\n * Configures a Prismic client to automatically query draft content during a preview session.\n *\n * @param config - Configuration for the function.\n */\nexport function enableAutoPreviews(config: EnableAutoPreviewsConfig): void {\n\t// We use a function value so the cookie is checked on every\n\t// request. We don't have a static value to read from.\n\tconfig.client.queryContentFromRef(async () => {\n\t\t// Need this to avoid the following Next.js build-time error:\n\t\t// You're importing a component that needs next/headers. That only works\n\t\t// in a Server Component which is not supported in the pages/ directory.\n\t\tconst { cookies, draftMode } = await import(\"next/headers\")\n\n\t\tlet isDraftModeEnabled = false\n\t\ttry {\n\t\t\tisDraftModeEnabled = (await draftMode()).isEnabled\n\t\t} catch {\n\t\t\t// `draftMode()` may have been called in a palce that\n\t\t\t// does not have access to its async storage. This\n\t\t\t// occurs in places like `generateStaticParams()`. We\n\t\t\t// can ignore this case.\n\t\t\treturn\n\t\t}\n\t\tif (!isDraftModeEnabled) {\n\t\t\treturn\n\t\t}\n\n\t\tconst cookie = (await cookies()).get(prismicCookie.preview)?.value\n\t\tif (!cookie) {\n\t\t\treturn\n\t\t}\n\n\t\tconst isActiveCookie = cookie.includes(\"websitePreviewId=\")\n\t\tif (!isActiveCookie) {\n\t\t\treturn\n\t\t}\n\n\t\treturn cookie\n\t})\n}\n"],"mappings":";;;;;;;;AAgBA,SAAgB,mBAAmB,QAAwC;AAG1E,QAAO,OAAO,oBAAoB,YAAY;EAI7C,MAAM,EAAE,SAAS,cAAc,MAAM,OAAO;EAE5C,IAAI,qBAAqB;AACzB,MAAI;AACH,yBAAsB,MAAM,WAAW,EAAE;UAClC;AAKP;;AAED,MAAI,CAAC,mBACJ;EAGD,MAAM,UAAU,MAAM,SAAS,EAAE,IAAIA,kBAAAA,OAAc,QAAQ,EAAE;AAC7D,MAAI,CAAC,OACJ;AAID,MAAI,CADmB,OAAO,SAAS,oBAAoB,CAE1D;AAGD,SAAO;GACN"}
+{"version":3,"file":"enableAutoPreviews.cjs","names":["getPreviewRef"],"sources":["../src/enableAutoPreviews.ts"],"sourcesContent":["import type { Client } from \"@prismicio/client\"\n\nimport { getPreviewRef } from \"./getPreviewRef\"\n\n/** Configuration for `enableAutoPreviews`. */\nexport type EnableAutoPreviewsConfig = {\n\t/** Prismic client with which automatic previews will be enabled. */\n\t// `Pick` is used to use the smallest possible subset of\n\t// `prismic.Client`. Doing this reduces the surface area for breaking\n\t// type changes.\n\tclient: Pick<Client, \"queryContentFromRef\" | \"enableAutoPreviewsFromReq\">\n}\n\n/**\n * Configures a Prismic client to automatically query draft content during a preview session.\n *\n * @param config - Configuration for the function.\n */\nexport function enableAutoPreviews(config: EnableAutoPreviewsConfig): void {\n\t// We use a function value so the cookie is checked on every\n\t// request. We don't have a static value to read from.\n\tconfig.client.queryContentFromRef(() => getPreviewRef())\n}\n"],"mappings":";;;;;;;AAkBA,SAAgB,mBAAmB,QAAwC;AAG1E,QAAO,OAAO,0BAA0BA,sBAAAA,eAAe,CAAC"}

package/dist/enableAutoPreviews.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"enableAutoPreviews.d.cts","names":[],"sources":["../src/enableAutoPreviews.ts"],"mappings":";;;;KAGY,wBAAA;EAAA,oEAKX,MAAA,EAAQ,IAAA,CAAK,MAAA;AAAA;;;;;;iBAQE,kBAAA,CAAmB,MAAA,EAAQ,wBAAA"}
+{"version":3,"file":"enableAutoPreviews.d.cts","names":[],"sources":["../src/enableAutoPreviews.ts"],"mappings":";;;;KAKY,wBAAA;EAAA,oEAKX,MAAA,EAAQ,IAAA,CAAK,MAAA;AAAA;;;;;;iBAQE,kBAAA,CAAmB,MAAA,EAAQ,wBAAA"}

package/dist/enableAutoPreviews.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"enableAutoPreviews.d.ts","names":[],"sources":["../src/enableAutoPreviews.ts"],"mappings":";;;;KAGY,wBAAA;EAAA,oEAKX,MAAA,EAAQ,IAAA,CAAK,MAAA;AAAA;;;;;;iBAQE,kBAAA,CAAmB,MAAA,EAAQ,wBAAA"}
+{"version":3,"file":"enableAutoPreviews.d.ts","names":[],"sources":["../src/enableAutoPreviews.ts"],"mappings":";;;;KAKY,wBAAA;EAAA,oEAKX,MAAA,EAAQ,IAAA,CAAK,MAAA;AAAA;;;;;;iBAQE,kBAAA,CAAmB,MAAA,EAAQ,wBAAA"}

package/dist/enableAutoPreviews.js

@@ -1,4 +1,4 @@
-import { cookie } from "@prismicio/client";
+import { getPreviewRef } from "./getPreviewRef.js";
 //#region src/enableAutoPreviews.ts
 /**
 * Configures a Prismic client to automatically query draft content during a preview session.
@@ -6,20 +6,7 @@ import { cookie } from "@prismicio/client";
 * @param config - Configuration for the function.
 */
 function enableAutoPreviews(config) {
-	config.client.queryContentFromRef(async () => {
-		const { cookies, draftMode } = await import("next/headers.js");
-		let isDraftModeEnabled = false;
-		try {
-			isDraftModeEnabled = (await draftMode()).isEnabled;
-		} catch {
-			return;
-		}
-		if (!isDraftModeEnabled) return;
-		const cookie$1 = (await cookies()).get(cookie.preview)?.value;
-		if (!cookie$1) return;
-		if (!cookie$1.includes("websitePreviewId=")) return;
-		return cookie$1;
-	});
+	config.client.queryContentFromRef(() => getPreviewRef());
 }
 //#endregion
 export { enableAutoPreviews };

package/dist/enableAutoPreviews.js.map

@@ -1 +1 @@
-{"version":3,"file":"enableAutoPreviews.js","names":["cookie","prismicCookie"],"sources":["../src/enableAutoPreviews.ts"],"sourcesContent":["import { type Client, cookie as prismicCookie } from \"@prismicio/client\"\n\n/** Configuration for `enableAutoPreviews`. */\nexport type EnableAutoPreviewsConfig = {\n\t/** Prismic client with which automatic previews will be enabled. */\n\t// `Pick` is used to use the smallest possible subset of\n\t// `prismic.Client`. Doing this reduces the surface area for breaking\n\t// type changes.\n\tclient: Pick<Client, \"queryContentFromRef\" | \"enableAutoPreviewsFromReq\">\n}\n\n/**\n * Configures a Prismic client to automatically query draft content during a preview session.\n *\n * @param config - Configuration for the function.\n */\nexport function enableAutoPreviews(config: EnableAutoPreviewsConfig): void {\n\t// We use a function value so the cookie is checked on every\n\t// request. We don't have a static value to read from.\n\tconfig.client.queryContentFromRef(async () => {\n\t\t// Need this to avoid the following Next.js build-time error:\n\t\t// You're importing a component that needs next/headers. That only works\n\t\t// in a Server Component which is not supported in the pages/ directory.\n\t\tconst { cookies, draftMode } = await import(\"next/headers\")\n\n\t\tlet isDraftModeEnabled = false\n\t\ttry {\n\t\t\tisDraftModeEnabled = (await draftMode()).isEnabled\n\t\t} catch {\n\t\t\t// `draftMode()` may have been called in a palce that\n\t\t\t// does not have access to its async storage. This\n\t\t\t// occurs in places like `generateStaticParams()`. We\n\t\t\t// can ignore this case.\n\t\t\treturn\n\t\t}\n\t\tif (!isDraftModeEnabled) {\n\t\t\treturn\n\t\t}\n\n\t\tconst cookie = (await cookies()).get(prismicCookie.preview)?.value\n\t\tif (!cookie) {\n\t\t\treturn\n\t\t}\n\n\t\tconst isActiveCookie = cookie.includes(\"websitePreviewId=\")\n\t\tif (!isActiveCookie) {\n\t\t\treturn\n\t\t}\n\n\t\treturn cookie\n\t})\n}\n"],"mappings":";;;;;;;AAgBA,SAAgB,mBAAmB,QAAwC;AAG1E,QAAO,OAAO,oBAAoB,YAAY;EAI7C,MAAM,EAAE,SAAS,cAAc,MAAM,OAAO;EAE5C,IAAI,qBAAqB;AACzB,MAAI;AACH,yBAAsB,MAAM,WAAW,EAAE;UAClC;AAKP;;AAED,MAAI,CAAC,mBACJ;EAGD,MAAMA,YAAU,MAAM,SAAS,EAAE,IAAIC,OAAc,QAAQ,EAAE;AAC7D,MAAI,CAACD,SACJ;AAID,MAAI,CADmBA,SAAO,SAAS,oBAAoB,CAE1D;AAGD,SAAOA;GACN"}
+{"version":3,"file":"enableAutoPreviews.js","names":[],"sources":["../src/enableAutoPreviews.ts"],"sourcesContent":["import type { Client } from \"@prismicio/client\"\n\nimport { getPreviewRef } from \"./getPreviewRef\"\n\n/** Configuration for `enableAutoPreviews`. */\nexport type EnableAutoPreviewsConfig = {\n\t/** Prismic client with which automatic previews will be enabled. */\n\t// `Pick` is used to use the smallest possible subset of\n\t// `prismic.Client`. Doing this reduces the surface area for breaking\n\t// type changes.\n\tclient: Pick<Client, \"queryContentFromRef\" | \"enableAutoPreviewsFromReq\">\n}\n\n/**\n * Configures a Prismic client to automatically query draft content during a preview session.\n *\n * @param config - Configuration for the function.\n */\nexport function enableAutoPreviews(config: EnableAutoPreviewsConfig): void {\n\t// We use a function value so the cookie is checked on every\n\t// request. We don't have a static value to read from.\n\tconfig.client.queryContentFromRef(() => getPreviewRef())\n}\n"],"mappings":";;;;;;;AAkBA,SAAgB,mBAAmB,QAAwC;AAG1E,QAAO,OAAO,0BAA0B,eAAe,CAAC"}

package/dist/exitPreview.cjs

@@ -1,3 +1,5 @@
+require("./_virtual/_rolldown/runtime.cjs");
+let _prismicio_client = require("@prismicio/client");
 //#region src/exitPreview.ts
 /**
 * Ends a Prismic preview session within a Next.js app. This function should be used in a Router
@@ -15,8 +17,9 @@
 * 	```
 */
 async function exitPreview() {
-	const { draftMode } = await import("next/headers.js");
+	const { cookies, draftMode } = await import("next/headers.js");
 	(await draftMode()).disable();
+	(await cookies()).delete(_prismicio_client.cookie.preview);
 	return new Response(JSON.stringify({ success: true }), { headers: { "Cache-Control": "no-store" } });
 }
 //#endregion

package/dist/exitPreview.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"exitPreview.cjs","names":[],"sources":["../src/exitPreview.ts"],"sourcesContent":["/**\n * Ends a Prismic preview session within a Next.js app. This function should be used in a Router\n * Handler.\n *\n * @example\n * \t;```typescript\n * \t// src/app/api/exit-preview/route.js\n *\n * \timport { exitPreview } from \"@prismicio/next\"\n *\n * \texport async function GET() {\n * \t\treturn await exitPreview()\n * \t}\n * \t```\n */\nexport async function exitPreview(): Promise<Response> {\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 { draftMode } = await import(\"next/headers\")\n\n\t;(await draftMode()).disable()\n\n\t// `Cache-Control` header is used to prevent CDN-level caching.\n\treturn new Response(JSON.stringify({ success: true }), {\n\t\theaders: {\n\t\t\t\"Cache-Control\": \"no-store\",\n\t\t},\n\t})\n}\n"],"mappings":";;;;;;;;;;;;;;;;AAeA,eAAsB,cAAiC;CAItD,MAAM,EAAE,cAAc,MAAM,OAAO;AAElC,EAAC,MAAM,WAAW,EAAE,SAAS;AAG9B,QAAO,IAAI,SAAS,KAAK,UAAU,EAAE,SAAS,MAAM,CAAC,EAAE,EACtD,SAAS,EACR,iBAAiB,YACjB,EACD,CAAC"}
+{"version":3,"file":"exitPreview.cjs","names":["prismicCookie"],"sources":["../src/exitPreview.ts"],"sourcesContent":["import { cookie as prismicCookie } from \"@prismicio/client\"\n\n/**\n * Ends a Prismic preview session within a Next.js app. This function should be used in a Router\n * Handler.\n *\n * @example\n * \t;```typescript\n * \t// src/app/api/exit-preview/route.js\n *\n * \timport { exitPreview } from \"@prismicio/next\"\n *\n * \texport async function GET() {\n * \t\treturn await exitPreview()\n * \t}\n * \t```\n */\nexport async function exitPreview(): Promise<Response> {\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\t;(await draftMode()).disable()\n\n\t// `redirectToPreviewURL` writes the preview cookie, so `exitPreview`\n\t// clears it to close the preview-cookie loop.\n\t;(await cookies()).delete(prismicCookie.preview)\n\n\t// `Cache-Control` header is used to prevent CDN-level caching.\n\treturn new Response(JSON.stringify({ success: true }), {\n\t\theaders: {\n\t\t\t\"Cache-Control\": \"no-store\",\n\t\t},\n\t})\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;AAiBA,eAAsB,cAAiC;CAItD,MAAM,EAAE,SAAS,cAAc,MAAM,OAAO;AAE3C,EAAC,MAAM,WAAW,EAAE,SAAS;AAI7B,EAAC,MAAM,SAAS,EAAE,OAAOA,kBAAAA,OAAc,QAAQ;AAGhD,QAAO,IAAI,SAAS,KAAK,UAAU,EAAE,SAAS,MAAM,CAAC,EAAE,EACtD,SAAS,EACR,iBAAiB,YACjB,EACD,CAAC"}

package/dist/exitPreview.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"exitPreview.d.cts","names":[],"sources":["../src/exitPreview.ts"],"mappings":";;AAeA;;;;;;;;;;;;;;iBAAsB,WAAA,CAAA,GAAe,OAAA,CAAQ,QAAA"}
+{"version":3,"file":"exitPreview.d.cts","names":[],"sources":["../src/exitPreview.ts"],"mappings":";;AAiBA;;;;;;;;;;;;;;iBAAsB,WAAA,CAAA,GAAe,OAAA,CAAQ,QAAA"}

package/dist/exitPreview.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"exitPreview.d.ts","names":[],"sources":["../src/exitPreview.ts"],"mappings":";;AAeA;;;;;;;;;;;;;;iBAAsB,WAAA,CAAA,GAAe,OAAA,CAAQ,QAAA"}
+{"version":3,"file":"exitPreview.d.ts","names":[],"sources":["../src/exitPreview.ts"],"mappings":";;AAiBA;;;;;;;;;;;;;;iBAAsB,WAAA,CAAA,GAAe,OAAA,CAAQ,QAAA"}

package/dist/exitPreview.js

@@ -1,3 +1,4 @@
+import { cookie } from "@prismicio/client";
 //#region src/exitPreview.ts
 /**
 * Ends a Prismic preview session within a Next.js app. This function should be used in a Router
@@ -15,8 +16,9 @@
 * 	```
 */
 async function exitPreview() {
-	const { draftMode } = await import("next/headers.js");
+	const { cookies, draftMode } = await import("next/headers.js");
 	(await draftMode()).disable();
+	(await cookies()).delete(cookie.preview);
 	return new Response(JSON.stringify({ success: true }), { headers: { "Cache-Control": "no-store" } });
 }
 //#endregion

package/dist/exitPreview.js.map

@@ -1 +1 @@
-{"version":3,"file":"exitPreview.js","names":[],"sources":["../src/exitPreview.ts"],"sourcesContent":["/**\n * Ends a Prismic preview session within a Next.js app. This function should be used in a Router\n * Handler.\n *\n * @example\n * \t;```typescript\n * \t// src/app/api/exit-preview/route.js\n *\n * \timport { exitPreview } from \"@prismicio/next\"\n *\n * \texport async function GET() {\n * \t\treturn await exitPreview()\n * \t}\n * \t```\n */\nexport async function exitPreview(): Promise<Response> {\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 { draftMode } = await import(\"next/headers\")\n\n\t;(await draftMode()).disable()\n\n\t// `Cache-Control` header is used to prevent CDN-level caching.\n\treturn new Response(JSON.stringify({ success: true }), {\n\t\theaders: {\n\t\t\t\"Cache-Control\": \"no-store\",\n\t\t},\n\t})\n}\n"],"mappings":";;;;;;;;;;;;;;;;AAeA,eAAsB,cAAiC;CAItD,MAAM,EAAE,cAAc,MAAM,OAAO;AAElC,EAAC,MAAM,WAAW,EAAE,SAAS;AAG9B,QAAO,IAAI,SAAS,KAAK,UAAU,EAAE,SAAS,MAAM,CAAC,EAAE,EACtD,SAAS,EACR,iBAAiB,YACjB,EACD,CAAC"}
+{"version":3,"file":"exitPreview.js","names":["prismicCookie"],"sources":["../src/exitPreview.ts"],"sourcesContent":["import { cookie as prismicCookie } from \"@prismicio/client\"\n\n/**\n * Ends a Prismic preview session within a Next.js app. This function should be used in a Router\n * Handler.\n *\n * @example\n * \t;```typescript\n * \t// src/app/api/exit-preview/route.js\n *\n * \timport { exitPreview } from \"@prismicio/next\"\n *\n * \texport async function GET() {\n * \t\treturn await exitPreview()\n * \t}\n * \t```\n */\nexport async function exitPreview(): Promise<Response> {\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\t;(await draftMode()).disable()\n\n\t// `redirectToPreviewURL` writes the preview cookie, so `exitPreview`\n\t// clears it to close the preview-cookie loop.\n\t;(await cookies()).delete(prismicCookie.preview)\n\n\t// `Cache-Control` header is used to prevent CDN-level caching.\n\treturn new Response(JSON.stringify({ success: true }), {\n\t\theaders: {\n\t\t\t\"Cache-Control\": \"no-store\",\n\t\t},\n\t})\n}\n"],"mappings":";;;;;;;;;;;;;;;;;AAiBA,eAAsB,cAAiC;CAItD,MAAM,EAAE,SAAS,cAAc,MAAM,OAAO;AAE3C,EAAC,MAAM,WAAW,EAAE,SAAS;AAI7B,EAAC,MAAM,SAAS,EAAE,OAAOA,OAAc,QAAQ;AAGhD,QAAO,IAAI,SAAS,KAAK,UAAU,EAAE,SAAS,MAAM,CAAC,EAAE,EACtD,SAAS,EACR,iBAAiB,YACjB,EACD,CAAC"}

package/dist/getPreviewRef.cjs

@@ -0,0 +1,38 @@
+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.
+*
+* 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
+* 	import { getPreviewRef } from "@prismicio/next"
+*
+* 	const page = await fetchPage(uid, await getPreviewRef())
+* 	```
+*
+* @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");
+	let isDraftModeEnabled = false;
+	try {
+		isDraftModeEnabled = (await draftMode()).isEnabled;
+	} catch {
+		return;
+	}
+	if (!isDraftModeEnabled) return;
+	const cookie = (await cookies()).get(_prismicio_client.cookie.preview)?.value;
+	if (!cookie) return;
+	if (!cookie.includes("websitePreviewId=")) return;
+	return cookie;
+}
+//#endregion
+exports.getPreviewRef = getPreviewRef;
+
+//# sourceMappingURL=getPreviewRef.cjs.map

package/dist/getPreviewRef.cjs.map

@@ -0,0 +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 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

@@ -0,0 +1,22 @@
+//#region src/getPreviewRef.d.ts
+/**
+ * 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:
+ *
+ * @example
+ * 	;```typescript
+ * 	import { getPreviewRef } from "@prismicio/next"
+ *
+ * 	const page = await fetchPage(uid, await getPreviewRef())
+ * 	```
+ *
+ * @returns The active preview ref, or `undefined` if no preview session is active.
+ * @experimental
+ */
+declare function getPreviewRef(): Promise<string | undefined>;
+//#endregion
+export { getPreviewRef };
+//# sourceMappingURL=getPreviewRef.d.cts.map

package/dist/getPreviewRef.d.cts.map

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

package/dist/getPreviewRef.d.ts

@@ -0,0 +1,22 @@
+//#region src/getPreviewRef.d.ts
+/**
+ * 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:
+ *
+ * @example
+ * 	;```typescript
+ * 	import { getPreviewRef } from "@prismicio/next"
+ *
+ * 	const page = await fetchPage(uid, await getPreviewRef())
+ * 	```
+ *
+ * @returns The active preview ref, or `undefined` if no preview session is active.
+ * @experimental
+ */
+declare function getPreviewRef(): Promise<string | undefined>;
+//#endregion
+export { getPreviewRef };
+//# sourceMappingURL=getPreviewRef.d.ts.map

package/dist/getPreviewRef.d.ts.map

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

package/dist/getPreviewRef.js

@@ -0,0 +1,37 @@
+import { cookie } from "@prismicio/client";
+//#region src/getPreviewRef.ts
+/**
+* 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:
+*
+* @example
+* 	;```typescript
+* 	import { getPreviewRef } from "@prismicio/next"
+*
+* 	const page = await fetchPage(uid, await getPreviewRef())
+* 	```
+*
+* @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");
+	let isDraftModeEnabled = false;
+	try {
+		isDraftModeEnabled = (await draftMode()).isEnabled;
+	} catch {
+		return;
+	}
+	if (!isDraftModeEnabled) return;
+	const cookie$1 = (await cookies()).get(cookie.preview)?.value;
+	if (!cookie$1) return;
+	if (!cookie$1.includes("websitePreviewId=")) return;
+	return cookie$1;
+}
+//#endregion
+export { getPreviewRef };
+
+//# sourceMappingURL=getPreviewRef.js.map

package/dist/getPreviewRef.js.map

@@ -0,0 +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 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

@@ -0,0 +1,31 @@
+//#region src/getPrismicCacheTags.ts
+const CACHE_TAG_PREFIX = "prismic/";
+/**
+* Generates cache tags for a set of Prismic pages. Tags for linked pages (e.g. a content
+* 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) {
+	return [...new Set(getPrismicDocumentIDs(pages))].map((id) => buildPrismicCacheTag(id));
+}
+function buildPrismicCacheTag(id) {
+	return `${CACHE_TAG_PREFIX}${id}`;
+}
+function getPrismicDocumentIDs(input) {
+	if (typeof input !== "object" || input == null) return [];
+	if (Array.isArray(input)) return input.flatMap((item) => getPrismicDocumentIDs(item));
+	if ("id" in input && typeof input.id === "string") {
+		if ("href" in input && typeof input.href === "string" && input.href.includes("/api/v2/documents/search?") || "link_type" in input && input.link_type === "Document") if ("data" in input && typeof input.data === "object" && input.data !== null) return [input.id, ...getPrismicDocumentIDs(input.data)];
+		else return [input.id];
+	}
+	return Object.values(input).flatMap((input) => getPrismicDocumentIDs(input));
+}
+//#endregion
+exports.buildPrismicCacheTag = buildPrismicCacheTag;
+exports.getPrismicCacheTags = getPrismicCacheTags;
+
+//# sourceMappingURL=getPrismicCacheTags.cjs.map

package/dist/getPrismicCacheTags.cjs.map

@@ -0,0 +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 * @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

@@ -0,0 +1,16 @@
+import { PrismicDocument } from "@prismicio/client";
+
+//#region src/getPrismicCacheTags.d.ts
+/**
+ * Generates cache tags for a set of Prismic pages. Tags for linked pages (e.g. a content
+ * 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[];
+//#endregion
+export { getPrismicCacheTags };
+//# sourceMappingURL=getPrismicCacheTags.d.cts.map

package/dist/getPrismicCacheTags.d.cts.map

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

package/dist/getPrismicCacheTags.d.ts

@@ -0,0 +1,16 @@
+import { PrismicDocument } from "@prismicio/client";
+
+//#region src/getPrismicCacheTags.d.ts
+/**
+ * Generates cache tags for a set of Prismic pages. Tags for linked pages (e.g. a content
+ * 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[];
+//#endregion
+export { getPrismicCacheTags };
+//# sourceMappingURL=getPrismicCacheTags.d.ts.map

package/dist/getPrismicCacheTags.d.ts.map

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

package/dist/getPrismicCacheTags.js

@@ -0,0 +1,30 @@
+//#region src/getPrismicCacheTags.ts
+const CACHE_TAG_PREFIX = "prismic/";
+/**
+* Generates cache tags for a set of Prismic pages. Tags for linked pages (e.g. a content
+* 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) {
+	return [...new Set(getPrismicDocumentIDs(pages))].map((id) => buildPrismicCacheTag(id));
+}
+function buildPrismicCacheTag(id) {
+	return `${CACHE_TAG_PREFIX}${id}`;
+}
+function getPrismicDocumentIDs(input) {
+	if (typeof input !== "object" || input == null) return [];
+	if (Array.isArray(input)) return input.flatMap((item) => getPrismicDocumentIDs(item));
+	if ("id" in input && typeof input.id === "string") {
+		if ("href" in input && typeof input.href === "string" && input.href.includes("/api/v2/documents/search?") || "link_type" in input && input.link_type === "Document") if ("data" in input && typeof input.data === "object" && input.data !== null) return [input.id, ...getPrismicDocumentIDs(input.data)];
+		else return [input.id];
+	}
+	return Object.values(input).flatMap((input) => getPrismicDocumentIDs(input));
+}
+//#endregion
+export { buildPrismicCacheTag, getPrismicCacheTags };
+
+//# sourceMappingURL=getPrismicCacheTags.js.map

package/dist/getPrismicCacheTags.js.map

@@ -0,0 +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 * @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/index.cjs

@@ -2,6 +2,7 @@ Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 const require_exitPreview = require("./exitPreview.cjs");
 const require_PrismicPreview = require("./PrismicPreview.cjs");
 const require_PrismicNextLink = require("./PrismicNextLink.cjs");
+const require_getPreviewRef = require("./getPreviewRef.cjs");
 const require_enableAutoPreviews = require("./enableAutoPreviews.cjs");
 const require_redirectToPreviewURL = require("./redirectToPreviewURL.cjs");
 const require_imgixLoader = require("./imgixLoader.cjs");
@@ -9,13 +10,20 @@ const require_PrismicNextImage = require("./PrismicNextImage.cjs");
 const require_getSlices = require("./getSlices.cjs");
 const require_SliceSimulator = require("./SliceSimulator.cjs");
 const require_createLocaleRedirect = require("./createLocaleRedirect.cjs");
+const require_getPrismicCacheTags = require("./getPrismicCacheTags.cjs");
+const require_cacheTagPrismicPages = require("./cacheTagPrismicPages.cjs");
+const require_revalidatePrismicPages = require("./revalidatePrismicPages.cjs");
 exports.PrismicNextImage = require_PrismicNextImage.PrismicNextImage;
 exports.PrismicNextLink = require_PrismicNextLink.PrismicNextLink;
 exports.PrismicPreview = require_PrismicPreview.PrismicPreview;
 exports.SliceSimulator = require_SliceSimulator.SliceSimulator;
+exports.cacheTagPrismicPages = require_cacheTagPrismicPages.cacheTagPrismicPages;
 exports.createLocaleRedirect = require_createLocaleRedirect.createLocaleRedirect;
 exports.enableAutoPreviews = require_enableAutoPreviews.enableAutoPreviews;
 exports.exitPreview = require_exitPreview.exitPreview;
+exports.getPreviewRef = require_getPreviewRef.getPreviewRef;
+exports.getPrismicCacheTags = require_getPrismicCacheTags.getPrismicCacheTags;
 exports.getSlices = require_getSlices.getSlices;
 exports.imgixLoader = require_imgixLoader.imgixLoader;
 exports.redirectToPreviewURL = require_redirectToPreviewURL.redirectToPreviewURL;
+exports.revalidatePrismicPages = require_revalidatePrismicPages.revalidatePrismicPages;

package/dist/index.d.cts

@@ -2,6 +2,7 @@ import { exitPreview } from "./exitPreview.cjs";
 import { PrismicPreview, PrismicPreviewProps } from "./PrismicPreview.cjs";
 import { PrismicNextLink, PrismicNextLinkProps } from "./PrismicNextLink.cjs";
 import { EnableAutoPreviewsConfig, enableAutoPreviews } from "./enableAutoPreviews.cjs";
+import { getPreviewRef } from "./getPreviewRef.cjs";
 import { CreateClientConfig } from "./types.cjs";
 import { RedirectToPreviewURLConfig, redirectToPreviewURL } from "./redirectToPreviewURL.cjs";
 import { PrismicNextImage, PrismicNextImageProps } from "./PrismicNextImage.cjs";
@@ -9,4 +10,7 @@ import { SliceSimulator, SliceSimulatorParams, SliceSimulatorProps } from "./Sli
 import { getSlices } from "./getSlices.cjs";
 import { imgixLoader } from "./imgixLoader.cjs";
 import { CreateLocaleRedirectConfig, createLocaleRedirect } from "./createLocaleRedirect.cjs";
-export { type CreateClientConfig, type CreateLocaleRedirectConfig, type EnableAutoPreviewsConfig, PrismicNextImage, type PrismicNextImageProps, PrismicNextLink, type PrismicNextLinkProps, PrismicPreview, type PrismicPreviewProps, type RedirectToPreviewURLConfig, SliceSimulator, type SliceSimulatorParams, type SliceSimulatorProps, createLocaleRedirect, enableAutoPreviews, exitPreview, getSlices, imgixLoader, redirectToPreviewURL };
+import { getPrismicCacheTags } from "./getPrismicCacheTags.cjs";
+import { cacheTagPrismicPages } from "./cacheTagPrismicPages.cjs";
+import { revalidatePrismicPages } from "./revalidatePrismicPages.cjs";
+export { type CreateClientConfig, type CreateLocaleRedirectConfig, type EnableAutoPreviewsConfig, PrismicNextImage, type PrismicNextImageProps, PrismicNextLink, type PrismicNextLinkProps, PrismicPreview, type PrismicPreviewProps, type RedirectToPreviewURLConfig, SliceSimulator, type SliceSimulatorParams, type SliceSimulatorProps, cacheTagPrismicPages, createLocaleRedirect, enableAutoPreviews, exitPreview, getPreviewRef, getPrismicCacheTags, getSlices, imgixLoader, redirectToPreviewURL, revalidatePrismicPages };

package/dist/index.d.ts

@@ -2,6 +2,7 @@ import { exitPreview } from "./exitPreview.js";
 import { PrismicPreview, PrismicPreviewProps } from "./PrismicPreview.js";
 import { PrismicNextLink, PrismicNextLinkProps } from "./PrismicNextLink.js";
 import { EnableAutoPreviewsConfig, enableAutoPreviews } from "./enableAutoPreviews.js";
+import { getPreviewRef } from "./getPreviewRef.js";
 import { CreateClientConfig } from "./types.js";
 import { RedirectToPreviewURLConfig, redirectToPreviewURL } from "./redirectToPreviewURL.js";
 import { PrismicNextImage, PrismicNextImageProps } from "./PrismicNextImage.js";
@@ -9,4 +10,7 @@ import { SliceSimulator, SliceSimulatorParams, SliceSimulatorProps } from "./Sli
 import { getSlices } from "./getSlices.js";
 import { imgixLoader } from "./imgixLoader.js";
 import { CreateLocaleRedirectConfig, createLocaleRedirect } from "./createLocaleRedirect.js";
-export { type CreateClientConfig, type CreateLocaleRedirectConfig, type EnableAutoPreviewsConfig, PrismicNextImage, type PrismicNextImageProps, PrismicNextLink, type PrismicNextLinkProps, PrismicPreview, type PrismicPreviewProps, type RedirectToPreviewURLConfig, SliceSimulator, type SliceSimulatorParams, type SliceSimulatorProps, createLocaleRedirect, enableAutoPreviews, exitPreview, getSlices, imgixLoader, redirectToPreviewURL };
+import { getPrismicCacheTags } from "./getPrismicCacheTags.js";
+import { cacheTagPrismicPages } from "./cacheTagPrismicPages.js";
+import { revalidatePrismicPages } from "./revalidatePrismicPages.js";
+export { type CreateClientConfig, type CreateLocaleRedirectConfig, type EnableAutoPreviewsConfig, PrismicNextImage, type PrismicNextImageProps, PrismicNextLink, type PrismicNextLinkProps, PrismicPreview, type PrismicPreviewProps, type RedirectToPreviewURLConfig, SliceSimulator, type SliceSimulatorParams, type SliceSimulatorProps, cacheTagPrismicPages, createLocaleRedirect, enableAutoPreviews, exitPreview, getPreviewRef, getPrismicCacheTags, getSlices, imgixLoader, redirectToPreviewURL, revalidatePrismicPages };

package/dist/index.js

@@ -1,6 +1,7 @@
 import { exitPreview } from "./exitPreview.js";
 import { PrismicPreview } from "./PrismicPreview.js";
 import { PrismicNextLink } from "./PrismicNextLink.js";
+import { getPreviewRef } from "./getPreviewRef.js";
 import { enableAutoPreviews } from "./enableAutoPreviews.js";
 import { redirectToPreviewURL } from "./redirectToPreviewURL.js";
 import { imgixLoader } from "./imgixLoader.js";
@@ -8,4 +9,7 @@ import { PrismicNextImage } from "./PrismicNextImage.js";
 import { getSlices } from "./getSlices.js";
 import { SliceSimulator } from "./SliceSimulator.js";
 import { createLocaleRedirect } from "./createLocaleRedirect.js";
-export { PrismicNextImage, PrismicNextLink, PrismicPreview, SliceSimulator, createLocaleRedirect, enableAutoPreviews, exitPreview, getSlices, imgixLoader, redirectToPreviewURL };
+import { getPrismicCacheTags } from "./getPrismicCacheTags.js";
+import { cacheTagPrismicPages } from "./cacheTagPrismicPages.js";
+import { revalidatePrismicPages } from "./revalidatePrismicPages.js";
+export { PrismicNextImage, PrismicNextLink, PrismicPreview, SliceSimulator, cacheTagPrismicPages, createLocaleRedirect, enableAutoPreviews, exitPreview, getPreviewRef, getPrismicCacheTags, getSlices, imgixLoader, redirectToPreviewURL, revalidatePrismicPages };

package/dist/package.cjs

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

package/dist/package.js

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

package/dist/revalidatePrismicPages.cjs

@@ -0,0 +1,20 @@
+require("./_virtual/_rolldown/runtime.cjs");
+const require_getPrismicCacheTags = require("./getPrismicCacheTags.cjs");
+let next_cache_js = require("next/cache.js");
+//#region src/revalidatePrismicPages.ts
+/**
+* Immediately revalidates a set of Prismic pages given a list of their IDs. The list of IDs
+* 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) {
+	for (const id of ids) (0, next_cache_js.revalidateTag)(require_getPrismicCacheTags.buildPrismicCacheTag(id), { expire: 0 });
+}
+//#endregion
+exports.revalidatePrismicPages = revalidatePrismicPages;
+
+//# sourceMappingURL=revalidatePrismicPages.cjs.map

package/dist/revalidatePrismicPages.cjs.map

@@ -0,0 +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 * @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

@@ -0,0 +1,14 @@
+//#region src/revalidatePrismicPages.d.ts
+/**
+ * Immediately revalidates a set of Prismic pages given a list of their IDs. The list of IDs
+ * 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;
+//#endregion
+export { revalidatePrismicPages };
+//# sourceMappingURL=revalidatePrismicPages.d.cts.map

package/dist/revalidatePrismicPages.d.cts.map

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

package/dist/revalidatePrismicPages.d.ts

@@ -0,0 +1,14 @@
+//#region src/revalidatePrismicPages.d.ts
+/**
+ * Immediately revalidates a set of Prismic pages given a list of their IDs. The list of IDs
+ * 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;
+//#endregion
+export { revalidatePrismicPages };
+//# sourceMappingURL=revalidatePrismicPages.d.ts.map

package/dist/revalidatePrismicPages.d.ts.map

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

package/dist/revalidatePrismicPages.js

@@ -0,0 +1,19 @@
+import { buildPrismicCacheTag } from "./getPrismicCacheTags.js";
+import { revalidateTag } from "next/cache.js";
+//#region src/revalidatePrismicPages.ts
+/**
+* Immediately revalidates a set of Prismic pages given a list of their IDs. The list of IDs
+* 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) {
+	for (const id of ids) revalidateTag(buildPrismicCacheTag(id), { expire: 0 });
+}
+//#endregion
+export { revalidatePrismicPages };
+
+//# sourceMappingURL=revalidatePrismicPages.js.map

package/dist/revalidatePrismicPages.js.map

@@ -0,0 +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 * @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",
+	"version": "2.3.0",
 	"description": "Helpers to integrate Prismic into Next.js apps",
 	"keywords": [
 		"next",

package/src/cacheTagPrismicPages.ts

@@ -0,0 +1,20 @@
+import type { PrismicDocument } from "@prismicio/client"
+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/enableAutoPreviews.ts

@@ -1,4 +1,6 @@
-import { type Client, cookie as prismicCookie } from "@prismicio/client"
+import type { Client } from "@prismicio/client"
+
+import { getPreviewRef } from "./getPreviewRef"
 
 /** Configuration for `enableAutoPreviews`. */
 export type EnableAutoPreviewsConfig = {
@@ -17,36 +19,5 @@ export type EnableAutoPreviewsConfig = {
 export function enableAutoPreviews(config: EnableAutoPreviewsConfig): void {
 	// We use a function value so the cookie is checked on every
 	// request. We don't have a static value to read from.
-	config.client.queryContentFromRef(async () => {
-		// Need this to avoid the following Next.js build-time error:
-		// You're importing a component that needs next/headers. That only works
-		// in a Server Component which is not supported in the pages/ directory.
-		const { cookies, draftMode } = await import("next/headers")
-
-		let isDraftModeEnabled = false
-		try {
-			isDraftModeEnabled = (await draftMode()).isEnabled
-		} catch {
-			// `draftMode()` may have been called in a palce that
-			// does not have access to its async storage. This
-			// occurs in places like `generateStaticParams()`. We
-			// can ignore this case.
-			return
-		}
-		if (!isDraftModeEnabled) {
-			return
-		}
-
-		const cookie = (await cookies()).get(prismicCookie.preview)?.value
-		if (!cookie) {
-			return
-		}
-
-		const isActiveCookie = cookie.includes("websitePreviewId=")
-		if (!isActiveCookie) {
-			return
-		}
-
-		return cookie
-	})
+	config.client.queryContentFromRef(() => getPreviewRef())
 }

package/src/exitPreview.ts

@@ -1,3 +1,5 @@
+import { cookie as prismicCookie } from "@prismicio/client"
+
 /**
  * Ends a Prismic preview session within a Next.js app. This function should be used in a Router
  * Handler.
@@ -17,10 +19,14 @@ export async function exitPreview(): Promise<Response> {
 	// Need this to avoid the following Next.js build-time error:
 	// You're importing a component that needs next/headers. That only works
 	// in a Server Component which is not supported in the pages/ directory.
-	const { draftMode } = await import("next/headers")
+	const { cookies, draftMode } = await import("next/headers")
 
 	;(await draftMode()).disable()
 
+	// `redirectToPreviewURL` writes the preview cookie, so `exitPreview`
+	// clears it to close the preview-cookie loop.
+	;(await cookies()).delete(prismicCookie.preview)
+
 	// `Cache-Control` header is used to prevent CDN-level caching.
 	return new Response(JSON.stringify({ success: true }), {
 		headers: {

package/src/getPreviewRef.ts

@@ -0,0 +1,51 @@
+import { cookie as prismicCookie } from "@prismicio/client"
+
+/**
+ * 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:
+ *
+ * @example
+ * 	;```typescript
+ * 	import { getPreviewRef } from "@prismicio/next"
+ *
+ * 	const page = await fetchPage(uid, await getPreviewRef())
+ * 	```
+ *
+ * @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:
+	// You're importing a component that needs next/headers. That only works
+	// in a Server Component which is not supported in the pages/ directory.
+	const { cookies, draftMode } = await import("next/headers")
+
+	let isDraftModeEnabled = false
+	try {
+		isDraftModeEnabled = (await draftMode()).isEnabled
+	} catch {
+		// `draftMode()` may have been called in a place that
+		// does not have access to its async storage. This
+		// occurs in places like `generateStaticParams()`. We
+		// can ignore this case.
+		return
+	}
+	if (!isDraftModeEnabled) {
+		return
+	}
+
+	const cookie = (await cookies()).get(prismicCookie.preview)?.value
+	if (!cookie) {
+		return
+	}
+
+	const isActiveCookie = cookie.includes("websitePreviewId=")
+	if (!isActiveCookie) {
+		return
+	}
+
+	return cookie
+}

package/src/getPrismicCacheTags.ts

@@ -0,0 +1,46 @@
+import type { PrismicDocument } from "@prismicio/client"
+
+const CACHE_TAG_PREFIX = "prismic/"
+
+/**
+ * Generates cache tags for a set of Prismic pages. Tags for linked pages (e.g. a content
+ * 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[] {
+	const ids = [...new Set(getPrismicDocumentIDs(pages))]
+	return ids.map((id) => buildPrismicCacheTag(id))
+}
+
+export function buildPrismicCacheTag(id: string): string {
+	return `${CACHE_TAG_PREFIX}${id}`
+}
+
+function getPrismicDocumentIDs(input: unknown): string[] {
+	if (typeof input !== "object" || input == null) return []
+
+	if (Array.isArray(input)) return input.flatMap((item) => getPrismicDocumentIDs(item))
+
+	if ("id" in input && typeof input.id === "string") {
+		// Document
+		// Content relationship or link
+		if (
+			("href" in input &&
+				typeof input.href === "string" &&
+				input.href.includes("/api/v2/documents/search?")) ||
+			("link_type" in input && input.link_type === "Document")
+		) {
+			if ("data" in input && typeof input.data === "object" && input.data !== null) {
+				return [input.id, ...getPrismicDocumentIDs(input.data)]
+			} else {
+				return [input.id]
+			}
+		}
+	}
+
+	return Object.values(input).flatMap((input) => getPrismicDocumentIDs(input))
+}

package/src/index.ts

@@ -9,6 +9,8 @@ export type { PrismicNextLinkProps } from "./PrismicNextLink"
 export { enableAutoPreviews } from "./enableAutoPreviews"
 export type { EnableAutoPreviewsConfig } from "./enableAutoPreviews"
 
+export { getPreviewRef } from "./getPreviewRef"
+
 export { redirectToPreviewURL } from "./redirectToPreviewURL"
 export type { RedirectToPreviewURLConfig } from "./redirectToPreviewURL"
 
@@ -26,3 +28,9 @@ export type { CreateClientConfig } from "./types"
 
 export { createLocaleRedirect } from "./createLocaleRedirect"
 export type { CreateLocaleRedirectConfig } from "./createLocaleRedirect"
+
+export { getPrismicCacheTags } from "./getPrismicCacheTags"
+
+export { cacheTagPrismicPages } from "./cacheTagPrismicPages"
+
+export { revalidatePrismicPages } from "./revalidatePrismicPages"

package/src/revalidatePrismicPages.ts

@@ -0,0 +1,19 @@
+import { revalidateTag } from "next/cache"
+
+import { buildPrismicCacheTag } from "./getPrismicCacheTags"
+
+/**
+ * Immediately revalidates a set of Prismic pages given a list of their IDs. The list of IDs
+ * 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 {
+	for (const id of ids) {
+		const tag = buildPrismicCacheTag(id)
+		revalidateTag(tag, { expire: 0 })
+	}
+}