@plenary/next 1.0.2 → 1.1.0

package/dist/{chunk-J5OXC4XR.js → chunk-7XALU3L6.js}

@@ -36,34 +36,15 @@ function createTaggedFetch(baseFetch = fetch) {
 
 // src/resolve.ts
 import {
-  isEntryWebhookPayload,
-  WEBHOOK_TEST_EVENT
+  planRevalidation as planPaths,
+  isEntryWebhookPayload
 } from "@plenary/client";
-function entryUrl(payload) {
-  const { slug, path } = payload.entry;
-  if (!slug) return null;
-  const dir = path && path !== "/" ? path : "";
-  if (!dir && slug === "home") return "/";
-  return `${dir}/${slug}`;
-}
+import { entryUrl } from "@plenary/client";
 function planRevalidation(payload, options) {
-  const none = { relevant: false, test: false, paths: [], tags: [] };
-  if (!isEntryWebhookPayload(payload)) return none;
-  const test = payload.event === WEBHOOK_TEST_EVENT;
-  if (!test && options.events && !options.events.includes(payload.event)) {
-    return none;
-  }
-  const modelKey = payload.model.key;
-  const mapped = modelKey === void 0 ? void 0 : options.paths?.[modelKey];
-  let paths;
-  if (mapped === void 0) {
-    paths = (options.entryUrl ?? entryUrl)(payload);
-  } else {
-    paths = typeof mapped === "function" ? mapped(payload) : mapped;
-  }
-  const pathList = paths == null ? [] : typeof paths === "string" ? [paths] : paths;
+  const plan = planPaths(payload, options);
   const tags = [];
-  if (options.tags) {
+  if (plan.relevant && options.tags && isEntryWebhookPayload(payload)) {
+    const modelKey = payload.model.key;
     if (modelKey) {
       tags.push(modelTag(modelKey));
       if (payload.changed.some((p) => p === "slug" || p === "path")) tags.push(modelEntriesTag(modelKey));
@@ -71,7 +52,7 @@ function planRevalidation(payload, options) {
     tags.push(entryTag(payload.entry.id));
     if (payload.entry.slug) tags.push(entryTag(payload.entry.slug));
   }
-  return { relevant: true, test, paths: [...new Set(pathList)], tags };
+  return { ...plan, tags };
 }
 
 export {
@@ -79,7 +60,7 @@ export {
   entryTag,
   modelEntriesTag,
   createTaggedFetch,
-  entryUrl,
-  planRevalidation
+  planRevalidation,
+  entryUrl
 };
-//# sourceMappingURL=chunk-J5OXC4XR.js.map
+//# sourceMappingURL=chunk-7XALU3L6.js.map

package/dist/chunk-7XALU3L6.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/tags.ts","../src/resolve.ts"],"sourcesContent":["/**\n * Cache-tag conventions shared by the tagged fetch and the revalidation\n * handler. A page that fetches Plenary content through\n * {@link createTaggedFetch} is tagged with the model and entry it read, so the\n * webhook handler can revalidate every page that used a piece of content\n * without a path map.\n */\n\n/** Tag carried by list reads of a model's content, which any entry event on\n * the model can change. */\nexport function modelTag(modelKey: string): string {\n  return `plenary:model:${modelKey}`;\n}\n\n/** Tag for one entry. The content API addresses entries by slug or UUID, and a\n * webhook payload carries both, so both spellings are revalidated. */\nexport function entryTag(slugOrId: string): string {\n  return `plenary:entry:${slugOrId}`;\n}\n\n/** Tag carried by every single-entry read of a model. A webhook revalidates it\n * only when an entry's slug or folder changes: the page at the old URL was\n * cached under the old slug, which the payload no longer names. */\nexport function modelEntriesTag(modelKey: string): string {\n  return `plenary:model-entries:${modelKey}`;\n}\n\n/** Next.js extends `RequestInit` with `next`; declared locally so this package\n * compiles against the standard DOM lib. */\ninterface NextRequestInit extends RequestInit {\n  next?: { tags?: string[]; revalidate?: number | false };\n}\n\nconst CONTENT_URL = /\\/api\\/v1\\/content\\/([^/?#]+)(?:\\/([^/?#]+))?/;\n\n/** The slug a list read pins with `where: { slug }`, if it pins exactly one. */\nfunction pinnedSlug(url: string): string | undefined {\n  const query = url.split(\"?\")[1]?.split(\"#\")[0];\n  if (!query) return undefined;\n  const params = new URLSearchParams(query);\n  const values = [...params.getAll(\"where:slug\"), ...params.getAll(\"where:slug.$eq\")];\n  return values.length === 1 ? values[0] : undefined;\n}\n\n/**\n * Wraps a fetch implementation so Plenary content reads carry cache tags.\n * Pass it to `createClient`:\n *\n * ```ts\n * const plenary = createClient({ ...config, fetch: createTaggedFetch() });\n * ```\n *\n * A read of one entry, `/api/v1/content/{model}/{slugOrId}` or a list read\n * pinned with `where: { slug }`, is tagged with that entry, so editing another\n * entry leaves its page cached. Other GET requests to `/api/v1/content/{model}`\n * are tagged with the model. Anything else passes through untouched.\n */\nexport function createTaggedFetch(baseFetch: typeof fetch = fetch): typeof fetch {\n  return ((input: RequestInfo | URL, init?: RequestInit) => {\n    const method = init?.method ?? \"GET\";\n    const url =\n      typeof input === \"string\" ? input : input instanceof URL ? input.href : input.url;\n    const match = method === \"GET\" ? CONTENT_URL.exec(url) : null;\n    if (!match?.[1]) return baseFetch(input, init);\n\n    const model = decodeURIComponent(match[1]);\n    const entry = match[2] ? decodeURIComponent(match[2]) : pinnedSlug(url);\n    const tags = entry ? [modelEntriesTag(model), entryTag(entry)] : [modelTag(model)];\n    const next = (init as NextRequestInit | undefined)?.next;\n    const merged: NextRequestInit = {\n      ...init,\n      next: { ...next, tags: [...(next?.tags ?? []), ...tags] },\n    };\n    return baseFetch(input, merged);\n  }) as typeof fetch;\n}\n","/**\n * The revalidation decision, shared by the App Router and Pages Router\n * handlers: which paths (and tags) one webhook payload maps to. The path\n * planning lives in `@plenary/client`; this adds the cache tags. Pure — the\n * handlers own the framework calls.\n */\n\nimport {\n  planRevalidation as planPaths,\n  isEntryWebhookPayload,\n  type RevalidateOptions as PathOptions,\n  type RevalidationPlan as PathPlan,\n  type WebhookPayload,\n} from \"@plenary/client\";\nimport { entryTag, modelEntriesTag, modelTag } from \"./tags.js\";\n\nexport { entryUrl, type RevalidatePaths } from \"@plenary/client\";\n\nexport interface RevalidateOptions extends PathOptions {\n  /** Also revalidate the `plenary:model:*` / `plenary:entry:*` cache tags used\n   * by `createTaggedFetch`. App Router only. */\n  tags?: boolean;\n}\n\nexport interface RevalidationPlan extends PathPlan {\n  tags: string[];\n}\n\n/** Decides what one payload revalidates. */\nexport function planRevalidation(\n  payload: WebhookPayload,\n  options: RevalidateOptions,\n): RevalidationPlan {\n  const plan = planPaths(payload, options);\n  const tags: string[] = [];\n  if (plan.relevant && options.tags && isEntryWebhookPayload(payload)) {\n    const modelKey = payload.model.key;\n    if (modelKey) {\n      tags.push(modelTag(modelKey));\n      if (payload.changed.some((p) => p === \"slug\" || p === \"path\")) tags.push(modelEntriesTag(modelKey));\n    }\n    tags.push(entryTag(payload.entry.id));\n    if (payload.entry.slug) tags.push(entryTag(payload.entry.slug));\n  }\n  return { ...plan, tags };\n}\n"],"mappings":";AAUO,SAAS,SAAS,UAA0B;AACjD,SAAO,iBAAiB,QAAQ;AAClC;AAIO,SAAS,SAAS,UAA0B;AACjD,SAAO,iBAAiB,QAAQ;AAClC;AAKO,SAAS,gBAAgB,UAA0B;AACxD,SAAO,yBAAyB,QAAQ;AAC1C;AAQA,IAAM,cAAc;AAGpB,SAAS,WAAW,KAAiC;AACnD,QAAM,QAAQ,IAAI,MAAM,GAAG,EAAE,CAAC,GAAG,MAAM,GAAG,EAAE,CAAC;AAC7C,MAAI,CAAC,MAAO,QAAO;AACnB,QAAM,SAAS,IAAI,gBAAgB,KAAK;AACxC,QAAM,SAAS,CAAC,GAAG,OAAO,OAAO,YAAY,GAAG,GAAG,OAAO,OAAO,gBAAgB,CAAC;AAClF,SAAO,OAAO,WAAW,IAAI,OAAO,CAAC,IAAI;AAC3C;AAeO,SAAS,kBAAkB,YAA0B,OAAqB;AAC/E,UAAQ,CAAC,OAA0B,SAAuB;AACxD,UAAM,SAAS,MAAM,UAAU;AAC/B,UAAM,MACJ,OAAO,UAAU,WAAW,QAAQ,iBAAiB,MAAM,MAAM,OAAO,MAAM;AAChF,UAAM,QAAQ,WAAW,QAAQ,YAAY,KAAK,GAAG,IAAI;AACzD,QAAI,CAAC,QAAQ,CAAC,EAAG,QAAO,UAAU,OAAO,IAAI;AAE7C,UAAM,QAAQ,mBAAmB,MAAM,CAAC,CAAC;AACzC,UAAM,QAAQ,MAAM,CAAC,IAAI,mBAAmB,MAAM,CAAC,CAAC,IAAI,WAAW,GAAG;AACtE,UAAM,OAAO,QAAQ,CAAC,gBAAgB,KAAK,GAAG,SAAS,KAAK,CAAC,IAAI,CAAC,SAAS,KAAK,CAAC;AACjF,UAAM,OAAQ,MAAsC;AACpD,UAAM,SAA0B;AAAA,MAC9B,GAAG;AAAA,MACH,MAAM,EAAE,GAAG,MAAM,MAAM,CAAC,GAAI,MAAM,QAAQ,CAAC,GAAI,GAAG,IAAI,EAAE;AAAA,IAC1D;AACA,WAAO,UAAU,OAAO,MAAM;AAAA,EAChC;AACF;;;ACpEA;AAAA,EACE,oBAAoB;AAAA,EACpB;AAAA,OAIK;AAGP,SAAS,gBAAsC;AAaxC,SAAS,iBACd,SACA,SACkB;AAClB,QAAM,OAAO,UAAU,SAAS,OAAO;AACvC,QAAM,OAAiB,CAAC;AACxB,MAAI,KAAK,YAAY,QAAQ,QAAQ,sBAAsB,OAAO,GAAG;AACnE,UAAM,WAAW,QAAQ,MAAM;AAC/B,QAAI,UAAU;AACZ,WAAK,KAAK,SAAS,QAAQ,CAAC;AAC5B,UAAI,QAAQ,QAAQ,KAAK,CAAC,MAAM,MAAM,UAAU,MAAM,MAAM,EAAG,MAAK,KAAK,gBAAgB,QAAQ,CAAC;AAAA,IACpG;AACA,SAAK,KAAK,SAAS,QAAQ,MAAM,EAAE,CAAC;AACpC,QAAI,QAAQ,MAAM,KAAM,MAAK,KAAK,SAAS,QAAQ,MAAM,IAAI,CAAC;AAAA,EAChE;AACA,SAAO,EAAE,GAAG,MAAM,KAAK;AACzB;","names":[]}

package/dist/index.cjs

@@ -23,7 +23,7 @@ __export(index_exports, {
   createRevalidateHandler: () => createRevalidateHandler,
   createTaggedFetch: () => createTaggedFetch,
   entryTag: () => entryTag,
-  entryUrl: () => entryUrl,
+  entryUrl: () => import_client2.entryUrl,
   modelEntriesTag: () => modelEntriesTag,
   modelTag: () => modelTag,
   planRevalidation: () => planRevalidation
@@ -32,7 +32,7 @@ module.exports = __toCommonJS(index_exports);
 
 // src/revalidate.ts
 var import_cache = require("next/cache");
-var import_client2 = require("@plenary/client");
+var import_client3 = require("@plenary/client");
 
 // src/resolve.ts
 var import_client = require("@plenary/client");
@@ -74,31 +74,12 @@ function createTaggedFetch(baseFetch = fetch) {
 }
 
 // src/resolve.ts
-function entryUrl(payload) {
-  const { slug, path } = payload.entry;
-  if (!slug) return null;
-  const dir = path && path !== "/" ? path : "";
-  if (!dir && slug === "home") return "/";
-  return `${dir}/${slug}`;
-}
+var import_client2 = require("@plenary/client");
 function planRevalidation(payload, options) {
-  const none = { relevant: false, test: false, paths: [], tags: [] };
-  if (!(0, import_client.isEntryWebhookPayload)(payload)) return none;
-  const test = payload.event === import_client.WEBHOOK_TEST_EVENT;
-  if (!test && options.events && !options.events.includes(payload.event)) {
-    return none;
-  }
-  const modelKey = payload.model.key;
-  const mapped = modelKey === void 0 ? void 0 : options.paths?.[modelKey];
-  let paths;
-  if (mapped === void 0) {
-    paths = (options.entryUrl ?? entryUrl)(payload);
-  } else {
-    paths = typeof mapped === "function" ? mapped(payload) : mapped;
-  }
-  const pathList = paths == null ? [] : typeof paths === "string" ? [paths] : paths;
+  const plan = (0, import_client.planRevalidation)(payload, options);
   const tags = [];
-  if (options.tags) {
+  if (plan.relevant && options.tags && (0, import_client.isEntryWebhookPayload)(payload)) {
+    const modelKey = payload.model.key;
     if (modelKey) {
       tags.push(modelTag(modelKey));
       if (payload.changed.some((p) => p === "slug" || p === "path")) tags.push(modelEntriesTag(modelKey));
@@ -106,7 +87,7 @@ function planRevalidation(payload, options) {
     tags.push(entryTag(payload.entry.id));
     if (payload.entry.slug) tags.push(entryTag(payload.entry.slug));
   }
-  return { relevant: true, test, paths: [...new Set(pathList)], tags };
+  return { ...plan, tags };
 }
 
 // src/revalidate.ts
@@ -114,9 +95,9 @@ function createRevalidateHandler(options) {
   return async (request) => {
     let payload;
     try {
-      payload = await (0, import_client2.parseWebhookRequest)(request, options);
+      payload = await (0, import_client3.parseWebhookRequest)(request, options);
     } catch (err) {
-      if (err instanceof import_client2.PlenaryWebhookError) {
+      if (err instanceof import_client3.PlenaryWebhookError) {
         return Response.json({ message: err.message }, { status: err.status });
       }
       throw err;

package/dist/index.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/index.ts","../src/revalidate.ts","../src/resolve.ts","../src/tags.ts"],"sourcesContent":["/**\n * @plenary/next — Next.js glue for Plenary: webhook-driven cache revalidation\n * and cache-tagged content fetching. The Pages Router handler lives in\n * `@plenary/next/pages` so this entry stays free of `next` type imports.\n */\n\nexport { createRevalidateHandler } from \"./revalidate.js\";\nexport {\n  entryUrl,\n  planRevalidation,\n  type RevalidateOptions,\n  type RevalidatePaths,\n  type RevalidationPlan,\n} from \"./resolve.js\";\nexport { createTaggedFetch, modelTag, modelEntriesTag, entryTag } from \"./tags.js\";\n","import { revalidatePath, revalidateTag } from \"next/cache\";\nimport { parseWebhookRequest, PlenaryWebhookError } from \"@plenary/client\";\nimport { planRevalidation, type RevalidateOptions } from \"./resolve.js\";\n\n/**\n * Builds an App Router route handler that turns Plenary entry webhooks into\n * `revalidatePath`/`revalidateTag` calls.\n *\n * ```ts\n * // app/api/revalidate/route.ts\n * export const POST = createRevalidateHandler({\n *   secret: process.env.PLENARY_WEBHOOK_SECRET!,\n * });\n * ```\n *\n * With no `paths` map, each event revalidates the entry's own URL (folder\n * path + slug). Point the webhook at the route, subscribed to the entry\n * events, with the secret in an `x-plenary-secret` header.\n *\n * The console's Test button gets a dry run: a 200 reporting what would have\n * been revalidated, without touching the cache.\n */\nexport function createRevalidateHandler(\n  options: RevalidateOptions,\n): (request: Request) => Promise<Response> {\n  return async (request) => {\n    let payload;\n    try {\n      payload = await parseWebhookRequest(request, options);\n    } catch (err) {\n      if (err instanceof PlenaryWebhookError) {\n        return Response.json({ message: err.message }, { status: err.status });\n      }\n      throw err;\n    }\n\n    const plan = planRevalidation(payload, options);\n    if (!plan.relevant) {\n      return Response.json({ revalidated: false, ignored: payload.event });\n    }\n    if (plan.test) {\n      return Response.json({ test: true, paths: plan.paths, tags: plan.tags });\n    }\n    for (const path of plan.paths) revalidatePath(path);\n    for (const tag of plan.tags) revalidateTag(tag);\n    return Response.json({ revalidated: true, paths: plan.paths, tags: plan.tags });\n  };\n}\n","/**\n * The revalidation decision, shared by the App Router and Pages Router\n * handlers: which paths (and tags) one webhook payload maps to. Pure — the\n * handlers own the framework calls.\n */\n\nimport {\n  isEntryWebhookPayload,\n  WEBHOOK_TEST_EVENT,\n  type EntryWebhookEvent,\n  type EntryWebhookPayload,\n  type ParseWebhookOptions,\n  type WebhookPayload,\n} from \"@plenary/client\";\nimport { entryTag, modelEntriesTag, modelTag } from \"./tags.js\";\n\n/** Paths for one model: a fixed path, a list, or a function of the payload.\n * A function may return `null`/`undefined` to revalidate nothing. */\nexport type RevalidatePaths =\n  | string\n  | string[]\n  | ((payload: EntryWebhookPayload) => string | string[] | null | undefined);\n\nexport interface RevalidateOptions extends ParseWebhookOptions {\n  /**\n   * Extra or overriding paths per model key. A mapped model replaces the\n   * default URL entirely — include `entryUrl(payload)` (exported) in the\n   * returned list to keep it.\n   */\n  paths?: Record<string, RevalidatePaths>;\n  /** Builds the default URL for unmapped models. Defaults to joining the\n   * entry's folder `path` and `slug`; return `null` to skip. */\n  entryUrl?: (payload: EntryWebhookPayload) => string | null | undefined;\n  /** Entry events that trigger revalidation. Default: all five — revalidation\n   * is idempotent and cheap, so over-firing beats a stale page. */\n  events?: EntryWebhookEvent[];\n  /** Also revalidate the `plenary:model:*` / `plenary:entry:*` cache tags used\n   * by `createTaggedFetch`. App Router only. */\n  tags?: boolean;\n}\n\n/** Default URL for an entry: folder path + slug (`/blog` + `spring-sale` →\n * `/blog/spring-sale`). A root-folder entry slugged `home` is the site's home\n * page, `/`. Entries without a slug (singletons) get no default. */\nexport function entryUrl(payload: EntryWebhookPayload): string | null {\n  const { slug, path } = payload.entry;\n  if (!slug) return null;\n  const dir = path && path !== \"/\" ? path : \"\";\n  if (!dir && slug === \"home\") return \"/\";\n  return `${dir}/${slug}`;\n}\n\nexport interface RevalidationPlan {\n  /** Whether this payload is one the handler acts on. */\n  relevant: boolean;\n  /** True for the console's Test button — report, don't revalidate. */\n  test: boolean;\n  paths: string[];\n  tags: string[];\n}\n\n/** Decides what one payload revalidates. */\nexport function planRevalidation(\n  payload: WebhookPayload,\n  options: RevalidateOptions,\n): RevalidationPlan {\n  const none = { relevant: false, test: false, paths: [], tags: [] };\n  if (!isEntryWebhookPayload(payload)) return none;\n\n  const test = payload.event === WEBHOOK_TEST_EVENT;\n  if (!test && options.events && !options.events.includes(payload.event as EntryWebhookEvent)) {\n    return none;\n  }\n\n  const modelKey = payload.model.key;\n  const mapped = modelKey === undefined ? undefined : options.paths?.[modelKey];\n  let paths: string | string[] | null | undefined;\n  if (mapped === undefined) {\n    paths = (options.entryUrl ?? entryUrl)(payload);\n  } else {\n    paths = typeof mapped === \"function\" ? mapped(payload) : mapped;\n  }\n  const pathList = paths == null ? [] : typeof paths === \"string\" ? [paths] : paths;\n\n  const tags: string[] = [];\n  if (options.tags) {\n    if (modelKey) {\n      tags.push(modelTag(modelKey));\n      if (payload.changed.some((p) => p === \"slug\" || p === \"path\")) tags.push(modelEntriesTag(modelKey));\n    }\n    tags.push(entryTag(payload.entry.id));\n    if (payload.entry.slug) tags.push(entryTag(payload.entry.slug));\n  }\n\n  return { relevant: true, test, paths: [...new Set(pathList)], tags };\n}\n","/**\n * Cache-tag conventions shared by the tagged fetch and the revalidation\n * handler. A page that fetches Plenary content through\n * {@link createTaggedFetch} is tagged with the model and entry it read, so the\n * webhook handler can revalidate every page that used a piece of content\n * without a path map.\n */\n\n/** Tag carried by list reads of a model's content, which any entry event on\n * the model can change. */\nexport function modelTag(modelKey: string): string {\n  return `plenary:model:${modelKey}`;\n}\n\n/** Tag for one entry. The content API addresses entries by slug or UUID, and a\n * webhook payload carries both, so both spellings are revalidated. */\nexport function entryTag(slugOrId: string): string {\n  return `plenary:entry:${slugOrId}`;\n}\n\n/** Tag carried by every single-entry read of a model. A webhook revalidates it\n * only when an entry's slug or folder changes: the page at the old URL was\n * cached under the old slug, which the payload no longer names. */\nexport function modelEntriesTag(modelKey: string): string {\n  return `plenary:model-entries:${modelKey}`;\n}\n\n/** Next.js extends `RequestInit` with `next`; declared locally so this package\n * compiles against the standard DOM lib. */\ninterface NextRequestInit extends RequestInit {\n  next?: { tags?: string[]; revalidate?: number | false };\n}\n\nconst CONTENT_URL = /\\/api\\/v1\\/content\\/([^/?#]+)(?:\\/([^/?#]+))?/;\n\n/** The slug a list read pins with `where: { slug }`, if it pins exactly one. */\nfunction pinnedSlug(url: string): string | undefined {\n  const query = url.split(\"?\")[1]?.split(\"#\")[0];\n  if (!query) return undefined;\n  const params = new URLSearchParams(query);\n  const values = [...params.getAll(\"where:slug\"), ...params.getAll(\"where:slug.$eq\")];\n  return values.length === 1 ? values[0] : undefined;\n}\n\n/**\n * Wraps a fetch implementation so Plenary content reads carry cache tags.\n * Pass it to `createClient`:\n *\n * ```ts\n * const plenary = createClient({ ...config, fetch: createTaggedFetch() });\n * ```\n *\n * A read of one entry, `/api/v1/content/{model}/{slugOrId}` or a list read\n * pinned with `where: { slug }`, is tagged with that entry, so editing another\n * entry leaves its page cached. Other GET requests to `/api/v1/content/{model}`\n * are tagged with the model. Anything else passes through untouched.\n */\nexport function createTaggedFetch(baseFetch: typeof fetch = fetch): typeof fetch {\n  return ((input: RequestInfo | URL, init?: RequestInit) => {\n    const method = init?.method ?? \"GET\";\n    const url =\n      typeof input === \"string\" ? input : input instanceof URL ? input.href : input.url;\n    const match = method === \"GET\" ? CONTENT_URL.exec(url) : null;\n    if (!match?.[1]) return baseFetch(input, init);\n\n    const model = decodeURIComponent(match[1]);\n    const entry = match[2] ? decodeURIComponent(match[2]) : pinnedSlug(url);\n    const tags = entry ? [modelEntriesTag(model), entryTag(entry)] : [modelTag(model)];\n    const next = (init as NextRequestInit | undefined)?.next;\n    const merged: NextRequestInit = {\n      ...init,\n      next: { ...next, tags: [...(next?.tags ?? []), ...tags] },\n    };\n    return baseFetch(input, merged);\n  }) as typeof fetch;\n}\n"],"mappings":"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","names":["import_client"]}
+{"version":3,"sources":["../src/index.ts","../src/revalidate.ts","../src/resolve.ts","../src/tags.ts"],"sourcesContent":["/**\n * @plenary/next — Next.js glue for Plenary: webhook-driven cache revalidation\n * and cache-tagged content fetching. The Pages Router handler lives in\n * `@plenary/next/pages` so this entry stays free of `next` type imports.\n */\n\nexport { createRevalidateHandler } from \"./revalidate.js\";\nexport {\n  entryUrl,\n  planRevalidation,\n  type RevalidateOptions,\n  type RevalidatePaths,\n  type RevalidationPlan,\n} from \"./resolve.js\";\nexport { createTaggedFetch, modelTag, modelEntriesTag, entryTag } from \"./tags.js\";\n","import { revalidatePath, revalidateTag } from \"next/cache\";\nimport { parseWebhookRequest, PlenaryWebhookError } from \"@plenary/client\";\nimport { planRevalidation, type RevalidateOptions } from \"./resolve.js\";\n\n/**\n * Builds an App Router route handler that turns Plenary entry webhooks into\n * `revalidatePath`/`revalidateTag` calls.\n *\n * ```ts\n * // app/api/revalidate/route.ts\n * export const POST = createRevalidateHandler({\n *   secret: process.env.PLENARY_WEBHOOK_SECRET!,\n * });\n * ```\n *\n * With no `paths` map, each event revalidates the entry's own URL (folder\n * path + slug). Point the webhook at the route, subscribed to the entry\n * events, with the secret in an `x-plenary-secret` header.\n *\n * The console's Test button gets a dry run: a 200 reporting what would have\n * been revalidated, without touching the cache.\n */\nexport function createRevalidateHandler(\n  options: RevalidateOptions,\n): (request: Request) => Promise<Response> {\n  return async (request) => {\n    let payload;\n    try {\n      payload = await parseWebhookRequest(request, options);\n    } catch (err) {\n      if (err instanceof PlenaryWebhookError) {\n        return Response.json({ message: err.message }, { status: err.status });\n      }\n      throw err;\n    }\n\n    const plan = planRevalidation(payload, options);\n    if (!plan.relevant) {\n      return Response.json({ revalidated: false, ignored: payload.event });\n    }\n    if (plan.test) {\n      return Response.json({ test: true, paths: plan.paths, tags: plan.tags });\n    }\n    for (const path of plan.paths) revalidatePath(path);\n    for (const tag of plan.tags) revalidateTag(tag);\n    return Response.json({ revalidated: true, paths: plan.paths, tags: plan.tags });\n  };\n}\n","/**\n * The revalidation decision, shared by the App Router and Pages Router\n * handlers: which paths (and tags) one webhook payload maps to. The path\n * planning lives in `@plenary/client`; this adds the cache tags. Pure — the\n * handlers own the framework calls.\n */\n\nimport {\n  planRevalidation as planPaths,\n  isEntryWebhookPayload,\n  type RevalidateOptions as PathOptions,\n  type RevalidationPlan as PathPlan,\n  type WebhookPayload,\n} from \"@plenary/client\";\nimport { entryTag, modelEntriesTag, modelTag } from \"./tags.js\";\n\nexport { entryUrl, type RevalidatePaths } from \"@plenary/client\";\n\nexport interface RevalidateOptions extends PathOptions {\n  /** Also revalidate the `plenary:model:*` / `plenary:entry:*` cache tags used\n   * by `createTaggedFetch`. App Router only. */\n  tags?: boolean;\n}\n\nexport interface RevalidationPlan extends PathPlan {\n  tags: string[];\n}\n\n/** Decides what one payload revalidates. */\nexport function planRevalidation(\n  payload: WebhookPayload,\n  options: RevalidateOptions,\n): RevalidationPlan {\n  const plan = planPaths(payload, options);\n  const tags: string[] = [];\n  if (plan.relevant && options.tags && isEntryWebhookPayload(payload)) {\n    const modelKey = payload.model.key;\n    if (modelKey) {\n      tags.push(modelTag(modelKey));\n      if (payload.changed.some((p) => p === \"slug\" || p === \"path\")) tags.push(modelEntriesTag(modelKey));\n    }\n    tags.push(entryTag(payload.entry.id));\n    if (payload.entry.slug) tags.push(entryTag(payload.entry.slug));\n  }\n  return { ...plan, tags };\n}\n","/**\n * Cache-tag conventions shared by the tagged fetch and the revalidation\n * handler. A page that fetches Plenary content through\n * {@link createTaggedFetch} is tagged with the model and entry it read, so the\n * webhook handler can revalidate every page that used a piece of content\n * without a path map.\n */\n\n/** Tag carried by list reads of a model's content, which any entry event on\n * the model can change. */\nexport function modelTag(modelKey: string): string {\n  return `plenary:model:${modelKey}`;\n}\n\n/** Tag for one entry. The content API addresses entries by slug or UUID, and a\n * webhook payload carries both, so both spellings are revalidated. */\nexport function entryTag(slugOrId: string): string {\n  return `plenary:entry:${slugOrId}`;\n}\n\n/** Tag carried by every single-entry read of a model. A webhook revalidates it\n * only when an entry's slug or folder changes: the page at the old URL was\n * cached under the old slug, which the payload no longer names. */\nexport function modelEntriesTag(modelKey: string): string {\n  return `plenary:model-entries:${modelKey}`;\n}\n\n/** Next.js extends `RequestInit` with `next`; declared locally so this package\n * compiles against the standard DOM lib. */\ninterface NextRequestInit extends RequestInit {\n  next?: { tags?: string[]; revalidate?: number | false };\n}\n\nconst CONTENT_URL = /\\/api\\/v1\\/content\\/([^/?#]+)(?:\\/([^/?#]+))?/;\n\n/** The slug a list read pins with `where: { slug }`, if it pins exactly one. */\nfunction pinnedSlug(url: string): string | undefined {\n  const query = url.split(\"?\")[1]?.split(\"#\")[0];\n  if (!query) return undefined;\n  const params = new URLSearchParams(query);\n  const values = [...params.getAll(\"where:slug\"), ...params.getAll(\"where:slug.$eq\")];\n  return values.length === 1 ? values[0] : undefined;\n}\n\n/**\n * Wraps a fetch implementation so Plenary content reads carry cache tags.\n * Pass it to `createClient`:\n *\n * ```ts\n * const plenary = createClient({ ...config, fetch: createTaggedFetch() });\n * ```\n *\n * A read of one entry, `/api/v1/content/{model}/{slugOrId}` or a list read\n * pinned with `where: { slug }`, is tagged with that entry, so editing another\n * entry leaves its page cached. Other GET requests to `/api/v1/content/{model}`\n * are tagged with the model. Anything else passes through untouched.\n */\nexport function createTaggedFetch(baseFetch: typeof fetch = fetch): typeof fetch {\n  return ((input: RequestInfo | URL, init?: RequestInit) => {\n    const method = init?.method ?? \"GET\";\n    const url =\n      typeof input === \"string\" ? input : input instanceof URL ? input.href : input.url;\n    const match = method === \"GET\" ? CONTENT_URL.exec(url) : null;\n    if (!match?.[1]) return baseFetch(input, init);\n\n    const model = decodeURIComponent(match[1]);\n    const entry = match[2] ? decodeURIComponent(match[2]) : pinnedSlug(url);\n    const tags = entry ? [modelEntriesTag(model), entryTag(entry)] : [modelTag(model)];\n    const next = (init as NextRequestInit | undefined)?.next;\n    const merged: NextRequestInit = {\n      ...init,\n      next: { ...next, tags: [...(next?.tags ?? []), ...tags] },\n    };\n    return baseFetch(input, merged);\n  }) as typeof fetch;\n}\n"],"mappings":"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","names":["import_client","import_client","planPaths"]}

package/dist/index.d.cts

@@ -1,6 +1,6 @@
-import { R as RevalidateOptions } from './resolve-RT8_HYfz.cjs';
-export { a as RevalidatePaths, b as RevalidationPlan, e as entryUrl, p as planRevalidation } from './resolve-RT8_HYfz.cjs';
-import '@plenary/client';
+import { R as RevalidateOptions } from './resolve-CvKtOFT_.cjs';
+export { a as RevalidationPlan, p as planRevalidation } from './resolve-CvKtOFT_.cjs';
+export { RevalidatePaths, entryUrl } from '@plenary/client';
 
 /**
  * Builds an App Router route handler that turns Plenary entry webhooks into

package/dist/index.d.ts

@@ -1,6 +1,6 @@
-import { R as RevalidateOptions } from './resolve-RT8_HYfz.js';
-export { a as RevalidatePaths, b as RevalidationPlan, e as entryUrl, p as planRevalidation } from './resolve-RT8_HYfz.js';
-import '@plenary/client';
+import { R as RevalidateOptions } from './resolve-CvKtOFT_.js';
+export { a as RevalidationPlan, p as planRevalidation } from './resolve-CvKtOFT_.js';
+export { RevalidatePaths, entryUrl } from '@plenary/client';
 
 /**
  * Builds an App Router route handler that turns Plenary entry webhooks into

package/dist/index.js

@@ -5,7 +5,7 @@ import {
   modelEntriesTag,
   modelTag,
   planRevalidation
-} from "./chunk-J5OXC4XR.js";
+} from "./chunk-7XALU3L6.js";
 
 // src/revalidate.ts
 import { revalidatePath, revalidateTag } from "next/cache";

package/dist/pages.cjs

@@ -23,7 +23,7 @@ __export(pages_exports, {
   createPagesRevalidateHandler: () => createPagesRevalidateHandler
 });
 module.exports = __toCommonJS(pages_exports);
-var import_client2 = require("@plenary/client");
+var import_client3 = require("@plenary/client");
 
 // src/resolve.ts
 var import_client = require("@plenary/client");
@@ -40,31 +40,12 @@ function modelEntriesTag(modelKey) {
 }
 
 // src/resolve.ts
-function entryUrl(payload) {
-  const { slug, path } = payload.entry;
-  if (!slug) return null;
-  const dir = path && path !== "/" ? path : "";
-  if (!dir && slug === "home") return "/";
-  return `${dir}/${slug}`;
-}
+var import_client2 = require("@plenary/client");
 function planRevalidation(payload, options) {
-  const none = { relevant: false, test: false, paths: [], tags: [] };
-  if (!(0, import_client.isEntryWebhookPayload)(payload)) return none;
-  const test = payload.event === import_client.WEBHOOK_TEST_EVENT;
-  if (!test && options.events && !options.events.includes(payload.event)) {
-    return none;
-  }
-  const modelKey = payload.model.key;
-  const mapped = modelKey === void 0 ? void 0 : options.paths?.[modelKey];
-  let paths;
-  if (mapped === void 0) {
-    paths = (options.entryUrl ?? entryUrl)(payload);
-  } else {
-    paths = typeof mapped === "function" ? mapped(payload) : mapped;
-  }
-  const pathList = paths == null ? [] : typeof paths === "string" ? [paths] : paths;
+  const plan = (0, import_client.planRevalidation)(payload, options);
   const tags = [];
-  if (options.tags) {
+  if (plan.relevant && options.tags && (0, import_client.isEntryWebhookPayload)(payload)) {
+    const modelKey = payload.model.key;
     if (modelKey) {
       tags.push(modelTag(modelKey));
       if (payload.changed.some((p) => p === "slug" || p === "path")) tags.push(modelEntriesTag(modelKey));
@@ -72,7 +53,7 @@ function planRevalidation(payload, options) {
     tags.push(entryTag(payload.entry.id));
     if (payload.entry.slug) tags.push(entryTag(payload.entry.slug));
   }
-  return { relevant: true, test, paths: [...new Set(pathList)], tags };
+  return { ...plan, tags };
 }
 
 // src/pages.ts
@@ -91,15 +72,15 @@ function createPagesRevalidateHandler(options) {
     const fromHeader = req.headers[header];
     const fromQuery = req.query[query];
     const provided = (Array.isArray(fromHeader) ? fromHeader[0] : fromHeader) ?? (Array.isArray(fromQuery) ? fromQuery[0] : fromQuery);
-    if (!(0, import_client2.verifyWebhookSecret)(provided, options.secret)) {
+    if (!(0, import_client3.verifyWebhookSecret)(provided, options.secret)) {
       res.status(401).json({ message: "Invalid webhook secret" });
       return;
     }
     let payload;
     try {
-      payload = (0, import_client2.parseWebhookPayload)(req.body);
+      payload = (0, import_client3.parseWebhookPayload)(req.body);
     } catch (err) {
-      if (err instanceof import_client2.PlenaryWebhookError) {
+      if (err instanceof import_client3.PlenaryWebhookError) {
         res.status(err.status).json({ message: err.message });
         return;
       }

package/dist/pages.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/pages.ts","../src/resolve.ts","../src/tags.ts"],"sourcesContent":["import type { NextApiRequest, NextApiResponse } from \"next\";\nimport {\n  parseWebhookPayload,\n  verifyWebhookSecret,\n  PlenaryWebhookError,\n} from \"@plenary/client\";\nimport { planRevalidation, type RevalidateOptions } from \"./resolve.js\";\n\n/**\n * The Pages Router counterpart of `createRevalidateHandler`, built on\n * `res.revalidate`.\n *\n * ```ts\n * // pages/api/revalidate.ts\n * export default createPagesRevalidateHandler({\n *   secret: process.env.PLENARY_WEBHOOK_SECRET!,\n * });\n * ```\n *\n * Cache tags are an App Router feature; the `tags` option is ignored here.\n */\nexport function createPagesRevalidateHandler(\n  options: RevalidateOptions,\n): (req: NextApiRequest, res: NextApiResponse) => Promise<void> {\n  const header = options.secretHeader ?? \"x-plenary-secret\";\n  const query = options.secretQuery ?? \"secret\";\n\n  return async (req, res) => {\n    if (req.method !== \"POST\") {\n      res.status(405).json({ message: \"Method not allowed\" });\n      return;\n    }\n    if (!options.secret) {\n      res.status(500).json({ message: \"Webhook secret is not configured\" });\n      return;\n    }\n    const fromHeader = req.headers[header];\n    const fromQuery = req.query[query];\n    const provided =\n      (Array.isArray(fromHeader) ? fromHeader[0] : fromHeader) ??\n      (Array.isArray(fromQuery) ? fromQuery[0] : fromQuery);\n    if (!verifyWebhookSecret(provided, options.secret)) {\n      res.status(401).json({ message: \"Invalid webhook secret\" });\n      return;\n    }\n\n    let payload;\n    try {\n      payload = parseWebhookPayload(req.body);\n    } catch (err) {\n      if (err instanceof PlenaryWebhookError) {\n        res.status(err.status).json({ message: err.message });\n        return;\n      }\n      throw err;\n    }\n\n    const plan = planRevalidation(payload, options);\n    if (!plan.relevant) {\n      res.json({ revalidated: false, ignored: payload.event });\n      return;\n    }\n    if (plan.test) {\n      res.json({ test: true, paths: plan.paths });\n      return;\n    }\n    await Promise.all(plan.paths.map((p) => res.revalidate(p)));\n    res.json({ revalidated: true, paths: plan.paths });\n  };\n}\n","/**\n * The revalidation decision, shared by the App Router and Pages Router\n * handlers: which paths (and tags) one webhook payload maps to. Pure — the\n * handlers own the framework calls.\n */\n\nimport {\n  isEntryWebhookPayload,\n  WEBHOOK_TEST_EVENT,\n  type EntryWebhookEvent,\n  type EntryWebhookPayload,\n  type ParseWebhookOptions,\n  type WebhookPayload,\n} from \"@plenary/client\";\nimport { entryTag, modelEntriesTag, modelTag } from \"./tags.js\";\n\n/** Paths for one model: a fixed path, a list, or a function of the payload.\n * A function may return `null`/`undefined` to revalidate nothing. */\nexport type RevalidatePaths =\n  | string\n  | string[]\n  | ((payload: EntryWebhookPayload) => string | string[] | null | undefined);\n\nexport interface RevalidateOptions extends ParseWebhookOptions {\n  /**\n   * Extra or overriding paths per model key. A mapped model replaces the\n   * default URL entirely — include `entryUrl(payload)` (exported) in the\n   * returned list to keep it.\n   */\n  paths?: Record<string, RevalidatePaths>;\n  /** Builds the default URL for unmapped models. Defaults to joining the\n   * entry's folder `path` and `slug`; return `null` to skip. */\n  entryUrl?: (payload: EntryWebhookPayload) => string | null | undefined;\n  /** Entry events that trigger revalidation. Default: all five — revalidation\n   * is idempotent and cheap, so over-firing beats a stale page. */\n  events?: EntryWebhookEvent[];\n  /** Also revalidate the `plenary:model:*` / `plenary:entry:*` cache tags used\n   * by `createTaggedFetch`. App Router only. */\n  tags?: boolean;\n}\n\n/** Default URL for an entry: folder path + slug (`/blog` + `spring-sale` →\n * `/blog/spring-sale`). A root-folder entry slugged `home` is the site's home\n * page, `/`. Entries without a slug (singletons) get no default. */\nexport function entryUrl(payload: EntryWebhookPayload): string | null {\n  const { slug, path } = payload.entry;\n  if (!slug) return null;\n  const dir = path && path !== \"/\" ? path : \"\";\n  if (!dir && slug === \"home\") return \"/\";\n  return `${dir}/${slug}`;\n}\n\nexport interface RevalidationPlan {\n  /** Whether this payload is one the handler acts on. */\n  relevant: boolean;\n  /** True for the console's Test button — report, don't revalidate. */\n  test: boolean;\n  paths: string[];\n  tags: string[];\n}\n\n/** Decides what one payload revalidates. */\nexport function planRevalidation(\n  payload: WebhookPayload,\n  options: RevalidateOptions,\n): RevalidationPlan {\n  const none = { relevant: false, test: false, paths: [], tags: [] };\n  if (!isEntryWebhookPayload(payload)) return none;\n\n  const test = payload.event === WEBHOOK_TEST_EVENT;\n  if (!test && options.events && !options.events.includes(payload.event as EntryWebhookEvent)) {\n    return none;\n  }\n\n  const modelKey = payload.model.key;\n  const mapped = modelKey === undefined ? undefined : options.paths?.[modelKey];\n  let paths: string | string[] | null | undefined;\n  if (mapped === undefined) {\n    paths = (options.entryUrl ?? entryUrl)(payload);\n  } else {\n    paths = typeof mapped === \"function\" ? mapped(payload) : mapped;\n  }\n  const pathList = paths == null ? [] : typeof paths === \"string\" ? [paths] : paths;\n\n  const tags: string[] = [];\n  if (options.tags) {\n    if (modelKey) {\n      tags.push(modelTag(modelKey));\n      if (payload.changed.some((p) => p === \"slug\" || p === \"path\")) tags.push(modelEntriesTag(modelKey));\n    }\n    tags.push(entryTag(payload.entry.id));\n    if (payload.entry.slug) tags.push(entryTag(payload.entry.slug));\n  }\n\n  return { relevant: true, test, paths: [...new Set(pathList)], tags };\n}\n","/**\n * Cache-tag conventions shared by the tagged fetch and the revalidation\n * handler. A page that fetches Plenary content through\n * {@link createTaggedFetch} is tagged with the model and entry it read, so the\n * webhook handler can revalidate every page that used a piece of content\n * without a path map.\n */\n\n/** Tag carried by list reads of a model's content, which any entry event on\n * the model can change. */\nexport function modelTag(modelKey: string): string {\n  return `plenary:model:${modelKey}`;\n}\n\n/** Tag for one entry. The content API addresses entries by slug or UUID, and a\n * webhook payload carries both, so both spellings are revalidated. */\nexport function entryTag(slugOrId: string): string {\n  return `plenary:entry:${slugOrId}`;\n}\n\n/** Tag carried by every single-entry read of a model. A webhook revalidates it\n * only when an entry's slug or folder changes: the page at the old URL was\n * cached under the old slug, which the payload no longer names. */\nexport function modelEntriesTag(modelKey: string): string {\n  return `plenary:model-entries:${modelKey}`;\n}\n\n/** Next.js extends `RequestInit` with `next`; declared locally so this package\n * compiles against the standard DOM lib. */\ninterface NextRequestInit extends RequestInit {\n  next?: { tags?: string[]; revalidate?: number | false };\n}\n\nconst CONTENT_URL = /\\/api\\/v1\\/content\\/([^/?#]+)(?:\\/([^/?#]+))?/;\n\n/** The slug a list read pins with `where: { slug }`, if it pins exactly one. */\nfunction pinnedSlug(url: string): string | undefined {\n  const query = url.split(\"?\")[1]?.split(\"#\")[0];\n  if (!query) return undefined;\n  const params = new URLSearchParams(query);\n  const values = [...params.getAll(\"where:slug\"), ...params.getAll(\"where:slug.$eq\")];\n  return values.length === 1 ? values[0] : undefined;\n}\n\n/**\n * Wraps a fetch implementation so Plenary content reads carry cache tags.\n * Pass it to `createClient`:\n *\n * ```ts\n * const plenary = createClient({ ...config, fetch: createTaggedFetch() });\n * ```\n *\n * A read of one entry, `/api/v1/content/{model}/{slugOrId}` or a list read\n * pinned with `where: { slug }`, is tagged with that entry, so editing another\n * entry leaves its page cached. Other GET requests to `/api/v1/content/{model}`\n * are tagged with the model. Anything else passes through untouched.\n */\nexport function createTaggedFetch(baseFetch: typeof fetch = fetch): typeof fetch {\n  return ((input: RequestInfo | URL, init?: RequestInit) => {\n    const method = init?.method ?? \"GET\";\n    const url =\n      typeof input === \"string\" ? input : input instanceof URL ? input.href : input.url;\n    const match = method === \"GET\" ? CONTENT_URL.exec(url) : null;\n    if (!match?.[1]) return baseFetch(input, init);\n\n    const model = decodeURIComponent(match[1]);\n    const entry = match[2] ? decodeURIComponent(match[2]) : pinnedSlug(url);\n    const tags = entry ? [modelEntriesTag(model), entryTag(entry)] : [modelTag(model)];\n    const next = (init as NextRequestInit | undefined)?.next;\n    const merged: NextRequestInit = {\n      ...init,\n      next: { ...next, tags: [...(next?.tags ?? []), ...tags] },\n    };\n    return baseFetch(input, merged);\n  }) as typeof fetch;\n}\n"],"mappings":"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","names":["import_client"]}
+{"version":3,"sources":["../src/pages.ts","../src/resolve.ts","../src/tags.ts"],"sourcesContent":["import type { NextApiRequest, NextApiResponse } from \"next\";\nimport {\n  parseWebhookPayload,\n  verifyWebhookSecret,\n  PlenaryWebhookError,\n} from \"@plenary/client\";\nimport { planRevalidation, type RevalidateOptions } from \"./resolve.js\";\n\n/**\n * The Pages Router counterpart of `createRevalidateHandler`, built on\n * `res.revalidate`.\n *\n * ```ts\n * // pages/api/revalidate.ts\n * export default createPagesRevalidateHandler({\n *   secret: process.env.PLENARY_WEBHOOK_SECRET!,\n * });\n * ```\n *\n * Cache tags are an App Router feature; the `tags` option is ignored here.\n */\nexport function createPagesRevalidateHandler(\n  options: RevalidateOptions,\n): (req: NextApiRequest, res: NextApiResponse) => Promise<void> {\n  const header = options.secretHeader ?? \"x-plenary-secret\";\n  const query = options.secretQuery ?? \"secret\";\n\n  return async (req, res) => {\n    if (req.method !== \"POST\") {\n      res.status(405).json({ message: \"Method not allowed\" });\n      return;\n    }\n    if (!options.secret) {\n      res.status(500).json({ message: \"Webhook secret is not configured\" });\n      return;\n    }\n    const fromHeader = req.headers[header];\n    const fromQuery = req.query[query];\n    const provided =\n      (Array.isArray(fromHeader) ? fromHeader[0] : fromHeader) ??\n      (Array.isArray(fromQuery) ? fromQuery[0] : fromQuery);\n    if (!verifyWebhookSecret(provided, options.secret)) {\n      res.status(401).json({ message: \"Invalid webhook secret\" });\n      return;\n    }\n\n    let payload;\n    try {\n      payload = parseWebhookPayload(req.body);\n    } catch (err) {\n      if (err instanceof PlenaryWebhookError) {\n        res.status(err.status).json({ message: err.message });\n        return;\n      }\n      throw err;\n    }\n\n    const plan = planRevalidation(payload, options);\n    if (!plan.relevant) {\n      res.json({ revalidated: false, ignored: payload.event });\n      return;\n    }\n    if (plan.test) {\n      res.json({ test: true, paths: plan.paths });\n      return;\n    }\n    await Promise.all(plan.paths.map((p) => res.revalidate(p)));\n    res.json({ revalidated: true, paths: plan.paths });\n  };\n}\n","/**\n * The revalidation decision, shared by the App Router and Pages Router\n * handlers: which paths (and tags) one webhook payload maps to. The path\n * planning lives in `@plenary/client`; this adds the cache tags. Pure — the\n * handlers own the framework calls.\n */\n\nimport {\n  planRevalidation as planPaths,\n  isEntryWebhookPayload,\n  type RevalidateOptions as PathOptions,\n  type RevalidationPlan as PathPlan,\n  type WebhookPayload,\n} from \"@plenary/client\";\nimport { entryTag, modelEntriesTag, modelTag } from \"./tags.js\";\n\nexport { entryUrl, type RevalidatePaths } from \"@plenary/client\";\n\nexport interface RevalidateOptions extends PathOptions {\n  /** Also revalidate the `plenary:model:*` / `plenary:entry:*` cache tags used\n   * by `createTaggedFetch`. App Router only. */\n  tags?: boolean;\n}\n\nexport interface RevalidationPlan extends PathPlan {\n  tags: string[];\n}\n\n/** Decides what one payload revalidates. */\nexport function planRevalidation(\n  payload: WebhookPayload,\n  options: RevalidateOptions,\n): RevalidationPlan {\n  const plan = planPaths(payload, options);\n  const tags: string[] = [];\n  if (plan.relevant && options.tags && isEntryWebhookPayload(payload)) {\n    const modelKey = payload.model.key;\n    if (modelKey) {\n      tags.push(modelTag(modelKey));\n      if (payload.changed.some((p) => p === \"slug\" || p === \"path\")) tags.push(modelEntriesTag(modelKey));\n    }\n    tags.push(entryTag(payload.entry.id));\n    if (payload.entry.slug) tags.push(entryTag(payload.entry.slug));\n  }\n  return { ...plan, tags };\n}\n","/**\n * Cache-tag conventions shared by the tagged fetch and the revalidation\n * handler. A page that fetches Plenary content through\n * {@link createTaggedFetch} is tagged with the model and entry it read, so the\n * webhook handler can revalidate every page that used a piece of content\n * without a path map.\n */\n\n/** Tag carried by list reads of a model's content, which any entry event on\n * the model can change. */\nexport function modelTag(modelKey: string): string {\n  return `plenary:model:${modelKey}`;\n}\n\n/** Tag for one entry. The content API addresses entries by slug or UUID, and a\n * webhook payload carries both, so both spellings are revalidated. */\nexport function entryTag(slugOrId: string): string {\n  return `plenary:entry:${slugOrId}`;\n}\n\n/** Tag carried by every single-entry read of a model. A webhook revalidates it\n * only when an entry's slug or folder changes: the page at the old URL was\n * cached under the old slug, which the payload no longer names. */\nexport function modelEntriesTag(modelKey: string): string {\n  return `plenary:model-entries:${modelKey}`;\n}\n\n/** Next.js extends `RequestInit` with `next`; declared locally so this package\n * compiles against the standard DOM lib. */\ninterface NextRequestInit extends RequestInit {\n  next?: { tags?: string[]; revalidate?: number | false };\n}\n\nconst CONTENT_URL = /\\/api\\/v1\\/content\\/([^/?#]+)(?:\\/([^/?#]+))?/;\n\n/** The slug a list read pins with `where: { slug }`, if it pins exactly one. */\nfunction pinnedSlug(url: string): string | undefined {\n  const query = url.split(\"?\")[1]?.split(\"#\")[0];\n  if (!query) return undefined;\n  const params = new URLSearchParams(query);\n  const values = [...params.getAll(\"where:slug\"), ...params.getAll(\"where:slug.$eq\")];\n  return values.length === 1 ? values[0] : undefined;\n}\n\n/**\n * Wraps a fetch implementation so Plenary content reads carry cache tags.\n * Pass it to `createClient`:\n *\n * ```ts\n * const plenary = createClient({ ...config, fetch: createTaggedFetch() });\n * ```\n *\n * A read of one entry, `/api/v1/content/{model}/{slugOrId}` or a list read\n * pinned with `where: { slug }`, is tagged with that entry, so editing another\n * entry leaves its page cached. Other GET requests to `/api/v1/content/{model}`\n * are tagged with the model. Anything else passes through untouched.\n */\nexport function createTaggedFetch(baseFetch: typeof fetch = fetch): typeof fetch {\n  return ((input: RequestInfo | URL, init?: RequestInit) => {\n    const method = init?.method ?? \"GET\";\n    const url =\n      typeof input === \"string\" ? input : input instanceof URL ? input.href : input.url;\n    const match = method === \"GET\" ? CONTENT_URL.exec(url) : null;\n    if (!match?.[1]) return baseFetch(input, init);\n\n    const model = decodeURIComponent(match[1]);\n    const entry = match[2] ? decodeURIComponent(match[2]) : pinnedSlug(url);\n    const tags = entry ? [modelEntriesTag(model), entryTag(entry)] : [modelTag(model)];\n    const next = (init as NextRequestInit | undefined)?.next;\n    const merged: NextRequestInit = {\n      ...init,\n      next: { ...next, tags: [...(next?.tags ?? []), ...tags] },\n    };\n    return baseFetch(input, merged);\n  }) as typeof fetch;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AACA,IAAAA,iBAIO;;;ACEP,oBAMO;;;ACHA,SAAS,SAAS,UAA0B;AACjD,SAAO,iBAAiB,QAAQ;AAClC;AAIO,SAAS,SAAS,UAA0B;AACjD,SAAO,iBAAiB,QAAQ;AAClC;AAKO,SAAS,gBAAgB,UAA0B;AACxD,SAAO,yBAAyB,QAAQ;AAC1C;;;ADTA,IAAAC,iBAA+C;AAaxC,SAAS,iBACd,SACA,SACkB;AAClB,QAAM,WAAO,cAAAC,kBAAU,SAAS,OAAO;AACvC,QAAM,OAAiB,CAAC;AACxB,MAAI,KAAK,YAAY,QAAQ,YAAQ,qCAAsB,OAAO,GAAG;AACnE,UAAM,WAAW,QAAQ,MAAM;AAC/B,QAAI,UAAU;AACZ,WAAK,KAAK,SAAS,QAAQ,CAAC;AAC5B,UAAI,QAAQ,QAAQ,KAAK,CAAC,MAAM,MAAM,UAAU,MAAM,MAAM,EAAG,MAAK,KAAK,gBAAgB,QAAQ,CAAC;AAAA,IACpG;AACA,SAAK,KAAK,SAAS,QAAQ,MAAM,EAAE,CAAC;AACpC,QAAI,QAAQ,MAAM,KAAM,MAAK,KAAK,SAAS,QAAQ,MAAM,IAAI,CAAC;AAAA,EAChE;AACA,SAAO,EAAE,GAAG,MAAM,KAAK;AACzB;;;ADxBO,SAAS,6BACd,SAC8D;AAC9D,QAAM,SAAS,QAAQ,gBAAgB;AACvC,QAAM,QAAQ,QAAQ,eAAe;AAErC,SAAO,OAAO,KAAK,QAAQ;AACzB,QAAI,IAAI,WAAW,QAAQ;AACzB,UAAI,OAAO,GAAG,EAAE,KAAK,EAAE,SAAS,qBAAqB,CAAC;AACtD;AAAA,IACF;AACA,QAAI,CAAC,QAAQ,QAAQ;AACnB,UAAI,OAAO,GAAG,EAAE,KAAK,EAAE,SAAS,mCAAmC,CAAC;AACpE;AAAA,IACF;AACA,UAAM,aAAa,IAAI,QAAQ,MAAM;AACrC,UAAM,YAAY,IAAI,MAAM,KAAK;AACjC,UAAM,YACH,MAAM,QAAQ,UAAU,IAAI,WAAW,CAAC,IAAI,gBAC5C,MAAM,QAAQ,SAAS,IAAI,UAAU,CAAC,IAAI;AAC7C,QAAI,KAAC,oCAAoB,UAAU,QAAQ,MAAM,GAAG;AAClD,UAAI,OAAO,GAAG,EAAE,KAAK,EAAE,SAAS,yBAAyB,CAAC;AAC1D;AAAA,IACF;AAEA,QAAI;AACJ,QAAI;AACF,oBAAU,oCAAoB,IAAI,IAAI;AAAA,IACxC,SAAS,KAAK;AACZ,UAAI,eAAe,oCAAqB;AACtC,YAAI,OAAO,IAAI,MAAM,EAAE,KAAK,EAAE,SAAS,IAAI,QAAQ,CAAC;AACpD;AAAA,MACF;AACA,YAAM;AAAA,IACR;AAEA,UAAM,OAAO,iBAAiB,SAAS,OAAO;AAC9C,QAAI,CAAC,KAAK,UAAU;AAClB,UAAI,KAAK,EAAE,aAAa,OAAO,SAAS,QAAQ,MAAM,CAAC;AACvD;AAAA,IACF;AACA,QAAI,KAAK,MAAM;AACb,UAAI,KAAK,EAAE,MAAM,MAAM,OAAO,KAAK,MAAM,CAAC;AAC1C;AAAA,IACF;AACA,UAAM,QAAQ,IAAI,KAAK,MAAM,IAAI,CAAC,MAAM,IAAI,WAAW,CAAC,CAAC,CAAC;AAC1D,QAAI,KAAK,EAAE,aAAa,MAAM,OAAO,KAAK,MAAM,CAAC;AAAA,EACnD;AACF;","names":["import_client","import_client","planPaths"]}

package/dist/pages.d.cts

@@ -1,5 +1,5 @@
 import { NextApiRequest, NextApiResponse } from 'next';
-import { R as RevalidateOptions } from './resolve-RT8_HYfz.cjs';
+import { R as RevalidateOptions } from './resolve-CvKtOFT_.cjs';
 import '@plenary/client';
 
 /**

package/dist/pages.d.ts

@@ -1,5 +1,5 @@
 import { NextApiRequest, NextApiResponse } from 'next';
-import { R as RevalidateOptions } from './resolve-RT8_HYfz.js';
+import { R as RevalidateOptions } from './resolve-CvKtOFT_.js';
 import '@plenary/client';
 
 /**

package/dist/pages.js

@@ -1,6 +1,6 @@
 import {
   planRevalidation
-} from "./chunk-J5OXC4XR.js";
+} from "./chunk-7XALU3L6.js";
 
 // src/pages.ts
 import {

package/dist/resolve-CvKtOFT_.d.cts

@@ -0,0 +1,21 @@
+import { RevalidateOptions as RevalidateOptions$1, RevalidationPlan as RevalidationPlan$1, WebhookPayload } from '@plenary/client';
+
+/**
+ * The revalidation decision, shared by the App Router and Pages Router
+ * handlers: which paths (and tags) one webhook payload maps to. The path
+ * planning lives in `@plenary/client`; this adds the cache tags. Pure — the
+ * handlers own the framework calls.
+ */
+
+interface RevalidateOptions extends RevalidateOptions$1 {
+    /** Also revalidate the `plenary:model:*` / `plenary:entry:*` cache tags used
+     * by `createTaggedFetch`. App Router only. */
+    tags?: boolean;
+}
+interface RevalidationPlan extends RevalidationPlan$1 {
+    tags: string[];
+}
+/** Decides what one payload revalidates. */
+declare function planRevalidation(payload: WebhookPayload, options: RevalidateOptions): RevalidationPlan;
+
+export { type RevalidateOptions as R, type RevalidationPlan as a, planRevalidation as p };

package/dist/resolve-CvKtOFT_.d.ts

@@ -0,0 +1,21 @@
+import { RevalidateOptions as RevalidateOptions$1, RevalidationPlan as RevalidationPlan$1, WebhookPayload } from '@plenary/client';
+
+/**
+ * The revalidation decision, shared by the App Router and Pages Router
+ * handlers: which paths (and tags) one webhook payload maps to. The path
+ * planning lives in `@plenary/client`; this adds the cache tags. Pure — the
+ * handlers own the framework calls.
+ */
+
+interface RevalidateOptions extends RevalidateOptions$1 {
+    /** Also revalidate the `plenary:model:*` / `plenary:entry:*` cache tags used
+     * by `createTaggedFetch`. App Router only. */
+    tags?: boolean;
+}
+interface RevalidationPlan extends RevalidationPlan$1 {
+    tags: string[];
+}
+/** Decides what one payload revalidates. */
+declare function planRevalidation(payload: WebhookPayload, options: RevalidateOptions): RevalidationPlan;
+
+export { type RevalidateOptions as R, type RevalidationPlan as a, planRevalidation as p };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@plenary/next",
-  "version": "1.0.2",
+  "version": "1.1.0",
   "description": "Plenary Next.js integration: webhook revalidation handlers and cache-tagged fetch.",
   "type": "module",
   "sideEffects": false,
@@ -23,7 +23,7 @@
     "dist"
   ],
   "dependencies": {
-    "@plenary/client": "1.0.2"
+    "@plenary/client": "1.1.0"
   },
   "peerDependencies": {
     "next": "^14 || ^15 || ^16"

package/dist/chunk-J5OXC4XR.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/tags.ts","../src/resolve.ts"],"sourcesContent":["/**\n * Cache-tag conventions shared by the tagged fetch and the revalidation\n * handler. A page that fetches Plenary content through\n * {@link createTaggedFetch} is tagged with the model and entry it read, so the\n * webhook handler can revalidate every page that used a piece of content\n * without a path map.\n */\n\n/** Tag carried by list reads of a model's content, which any entry event on\n * the model can change. */\nexport function modelTag(modelKey: string): string {\n  return `plenary:model:${modelKey}`;\n}\n\n/** Tag for one entry. The content API addresses entries by slug or UUID, and a\n * webhook payload carries both, so both spellings are revalidated. */\nexport function entryTag(slugOrId: string): string {\n  return `plenary:entry:${slugOrId}`;\n}\n\n/** Tag carried by every single-entry read of a model. A webhook revalidates it\n * only when an entry's slug or folder changes: the page at the old URL was\n * cached under the old slug, which the payload no longer names. */\nexport function modelEntriesTag(modelKey: string): string {\n  return `plenary:model-entries:${modelKey}`;\n}\n\n/** Next.js extends `RequestInit` with `next`; declared locally so this package\n * compiles against the standard DOM lib. */\ninterface NextRequestInit extends RequestInit {\n  next?: { tags?: string[]; revalidate?: number | false };\n}\n\nconst CONTENT_URL = /\\/api\\/v1\\/content\\/([^/?#]+)(?:\\/([^/?#]+))?/;\n\n/** The slug a list read pins with `where: { slug }`, if it pins exactly one. */\nfunction pinnedSlug(url: string): string | undefined {\n  const query = url.split(\"?\")[1]?.split(\"#\")[0];\n  if (!query) return undefined;\n  const params = new URLSearchParams(query);\n  const values = [...params.getAll(\"where:slug\"), ...params.getAll(\"where:slug.$eq\")];\n  return values.length === 1 ? values[0] : undefined;\n}\n\n/**\n * Wraps a fetch implementation so Plenary content reads carry cache tags.\n * Pass it to `createClient`:\n *\n * ```ts\n * const plenary = createClient({ ...config, fetch: createTaggedFetch() });\n * ```\n *\n * A read of one entry, `/api/v1/content/{model}/{slugOrId}` or a list read\n * pinned with `where: { slug }`, is tagged with that entry, so editing another\n * entry leaves its page cached. Other GET requests to `/api/v1/content/{model}`\n * are tagged with the model. Anything else passes through untouched.\n */\nexport function createTaggedFetch(baseFetch: typeof fetch = fetch): typeof fetch {\n  return ((input: RequestInfo | URL, init?: RequestInit) => {\n    const method = init?.method ?? \"GET\";\n    const url =\n      typeof input === \"string\" ? input : input instanceof URL ? input.href : input.url;\n    const match = method === \"GET\" ? CONTENT_URL.exec(url) : null;\n    if (!match?.[1]) return baseFetch(input, init);\n\n    const model = decodeURIComponent(match[1]);\n    const entry = match[2] ? decodeURIComponent(match[2]) : pinnedSlug(url);\n    const tags = entry ? [modelEntriesTag(model), entryTag(entry)] : [modelTag(model)];\n    const next = (init as NextRequestInit | undefined)?.next;\n    const merged: NextRequestInit = {\n      ...init,\n      next: { ...next, tags: [...(next?.tags ?? []), ...tags] },\n    };\n    return baseFetch(input, merged);\n  }) as typeof fetch;\n}\n","/**\n * The revalidation decision, shared by the App Router and Pages Router\n * handlers: which paths (and tags) one webhook payload maps to. Pure — the\n * handlers own the framework calls.\n */\n\nimport {\n  isEntryWebhookPayload,\n  WEBHOOK_TEST_EVENT,\n  type EntryWebhookEvent,\n  type EntryWebhookPayload,\n  type ParseWebhookOptions,\n  type WebhookPayload,\n} from \"@plenary/client\";\nimport { entryTag, modelEntriesTag, modelTag } from \"./tags.js\";\n\n/** Paths for one model: a fixed path, a list, or a function of the payload.\n * A function may return `null`/`undefined` to revalidate nothing. */\nexport type RevalidatePaths =\n  | string\n  | string[]\n  | ((payload: EntryWebhookPayload) => string | string[] | null | undefined);\n\nexport interface RevalidateOptions extends ParseWebhookOptions {\n  /**\n   * Extra or overriding paths per model key. A mapped model replaces the\n   * default URL entirely — include `entryUrl(payload)` (exported) in the\n   * returned list to keep it.\n   */\n  paths?: Record<string, RevalidatePaths>;\n  /** Builds the default URL for unmapped models. Defaults to joining the\n   * entry's folder `path` and `slug`; return `null` to skip. */\n  entryUrl?: (payload: EntryWebhookPayload) => string | null | undefined;\n  /** Entry events that trigger revalidation. Default: all five — revalidation\n   * is idempotent and cheap, so over-firing beats a stale page. */\n  events?: EntryWebhookEvent[];\n  /** Also revalidate the `plenary:model:*` / `plenary:entry:*` cache tags used\n   * by `createTaggedFetch`. App Router only. */\n  tags?: boolean;\n}\n\n/** Default URL for an entry: folder path + slug (`/blog` + `spring-sale` →\n * `/blog/spring-sale`). A root-folder entry slugged `home` is the site's home\n * page, `/`. Entries without a slug (singletons) get no default. */\nexport function entryUrl(payload: EntryWebhookPayload): string | null {\n  const { slug, path } = payload.entry;\n  if (!slug) return null;\n  const dir = path && path !== \"/\" ? path : \"\";\n  if (!dir && slug === \"home\") return \"/\";\n  return `${dir}/${slug}`;\n}\n\nexport interface RevalidationPlan {\n  /** Whether this payload is one the handler acts on. */\n  relevant: boolean;\n  /** True for the console's Test button — report, don't revalidate. */\n  test: boolean;\n  paths: string[];\n  tags: string[];\n}\n\n/** Decides what one payload revalidates. */\nexport function planRevalidation(\n  payload: WebhookPayload,\n  options: RevalidateOptions,\n): RevalidationPlan {\n  const none = { relevant: false, test: false, paths: [], tags: [] };\n  if (!isEntryWebhookPayload(payload)) return none;\n\n  const test = payload.event === WEBHOOK_TEST_EVENT;\n  if (!test && options.events && !options.events.includes(payload.event as EntryWebhookEvent)) {\n    return none;\n  }\n\n  const modelKey = payload.model.key;\n  const mapped = modelKey === undefined ? undefined : options.paths?.[modelKey];\n  let paths: string | string[] | null | undefined;\n  if (mapped === undefined) {\n    paths = (options.entryUrl ?? entryUrl)(payload);\n  } else {\n    paths = typeof mapped === \"function\" ? mapped(payload) : mapped;\n  }\n  const pathList = paths == null ? [] : typeof paths === \"string\" ? [paths] : paths;\n\n  const tags: string[] = [];\n  if (options.tags) {\n    if (modelKey) {\n      tags.push(modelTag(modelKey));\n      if (payload.changed.some((p) => p === \"slug\" || p === \"path\")) tags.push(modelEntriesTag(modelKey));\n    }\n    tags.push(entryTag(payload.entry.id));\n    if (payload.entry.slug) tags.push(entryTag(payload.entry.slug));\n  }\n\n  return { relevant: true, test, paths: [...new Set(pathList)], tags };\n}\n"],"mappings":"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","names":[]}

package/dist/resolve-RT8_HYfz.d.cts

@@ -1,44 +0,0 @@
-import { ParseWebhookOptions, EntryWebhookPayload, EntryWebhookEvent, WebhookPayload } from '@plenary/client';
-
-/**
- * The revalidation decision, shared by the App Router and Pages Router
- * handlers: which paths (and tags) one webhook payload maps to. Pure — the
- * handlers own the framework calls.
- */
-
-/** Paths for one model: a fixed path, a list, or a function of the payload.
- * A function may return `null`/`undefined` to revalidate nothing. */
-type RevalidatePaths = string | string[] | ((payload: EntryWebhookPayload) => string | string[] | null | undefined);
-interface RevalidateOptions extends ParseWebhookOptions {
-    /**
-     * Extra or overriding paths per model key. A mapped model replaces the
-     * default URL entirely — include `entryUrl(payload)` (exported) in the
-     * returned list to keep it.
-     */
-    paths?: Record<string, RevalidatePaths>;
-    /** Builds the default URL for unmapped models. Defaults to joining the
-     * entry's folder `path` and `slug`; return `null` to skip. */
-    entryUrl?: (payload: EntryWebhookPayload) => string | null | undefined;
-    /** Entry events that trigger revalidation. Default: all five — revalidation
-     * is idempotent and cheap, so over-firing beats a stale page. */
-    events?: EntryWebhookEvent[];
-    /** Also revalidate the `plenary:model:*` / `plenary:entry:*` cache tags used
-     * by `createTaggedFetch`. App Router only. */
-    tags?: boolean;
-}
-/** Default URL for an entry: folder path + slug (`/blog` + `spring-sale` →
- * `/blog/spring-sale`). A root-folder entry slugged `home` is the site's home
- * page, `/`. Entries without a slug (singletons) get no default. */
-declare function entryUrl(payload: EntryWebhookPayload): string | null;
-interface RevalidationPlan {
-    /** Whether this payload is one the handler acts on. */
-    relevant: boolean;
-    /** True for the console's Test button — report, don't revalidate. */
-    test: boolean;
-    paths: string[];
-    tags: string[];
-}
-/** Decides what one payload revalidates. */
-declare function planRevalidation(payload: WebhookPayload, options: RevalidateOptions): RevalidationPlan;
-
-export { type RevalidateOptions as R, type RevalidatePaths as a, type RevalidationPlan as b, entryUrl as e, planRevalidation as p };

package/dist/resolve-RT8_HYfz.d.ts

@@ -1,44 +0,0 @@
-import { ParseWebhookOptions, EntryWebhookPayload, EntryWebhookEvent, WebhookPayload } from '@plenary/client';
-
-/**
- * The revalidation decision, shared by the App Router and Pages Router
- * handlers: which paths (and tags) one webhook payload maps to. Pure — the
- * handlers own the framework calls.
- */
-
-/** Paths for one model: a fixed path, a list, or a function of the payload.
- * A function may return `null`/`undefined` to revalidate nothing. */
-type RevalidatePaths = string | string[] | ((payload: EntryWebhookPayload) => string | string[] | null | undefined);
-interface RevalidateOptions extends ParseWebhookOptions {
-    /**
-     * Extra or overriding paths per model key. A mapped model replaces the
-     * default URL entirely — include `entryUrl(payload)` (exported) in the
-     * returned list to keep it.
-     */
-    paths?: Record<string, RevalidatePaths>;
-    /** Builds the default URL for unmapped models. Defaults to joining the
-     * entry's folder `path` and `slug`; return `null` to skip. */
-    entryUrl?: (payload: EntryWebhookPayload) => string | null | undefined;
-    /** Entry events that trigger revalidation. Default: all five — revalidation
-     * is idempotent and cheap, so over-firing beats a stale page. */
-    events?: EntryWebhookEvent[];
-    /** Also revalidate the `plenary:model:*` / `plenary:entry:*` cache tags used
-     * by `createTaggedFetch`. App Router only. */
-    tags?: boolean;
-}
-/** Default URL for an entry: folder path + slug (`/blog` + `spring-sale` →
- * `/blog/spring-sale`). A root-folder entry slugged `home` is the site's home
- * page, `/`. Entries without a slug (singletons) get no default. */
-declare function entryUrl(payload: EntryWebhookPayload): string | null;
-interface RevalidationPlan {
-    /** Whether this payload is one the handler acts on. */
-    relevant: boolean;
-    /** True for the console's Test button — report, don't revalidate. */
-    test: boolean;
-    paths: string[];
-    tags: string[];
-}
-/** Decides what one payload revalidates. */
-declare function planRevalidation(payload: WebhookPayload, options: RevalidateOptions): RevalidationPlan;
-
-export { type RevalidateOptions as R, type RevalidatePaths as a, type RevalidationPlan as b, entryUrl as e, planRevalidation as p };