@plenary/next 1.0.0 → 1.0.2

package/dist/{chunk-BMLKEIKX.js → chunk-J5OXC4XR.js}

@@ -5,15 +5,26 @@ function modelTag(modelKey) {
 function entryTag(slugOrId) {
   return `plenary:entry:${slugOrId}`;
 }
+function modelEntriesTag(modelKey) {
+  return `plenary:model-entries:${modelKey}`;
+}
 var CONTENT_URL = /\/api\/v1\/content\/([^/?#]+)(?:\/([^/?#]+))?/;
+function pinnedSlug(url) {
+  const query = url.split("?")[1]?.split("#")[0];
+  if (!query) return void 0;
+  const params = new URLSearchParams(query);
+  const values = [...params.getAll("where:slug"), ...params.getAll("where:slug.$eq")];
+  return values.length === 1 ? values[0] : void 0;
+}
 function createTaggedFetch(baseFetch = fetch) {
   return ((input, init) => {
     const method = init?.method ?? "GET";
     const url = typeof input === "string" ? input : input instanceof URL ? input.href : input.url;
     const match = method === "GET" ? CONTENT_URL.exec(url) : null;
     if (!match?.[1]) return baseFetch(input, init);
-    const tags = [modelTag(decodeURIComponent(match[1]))];
-    if (match[2]) tags.push(entryTag(decodeURIComponent(match[2])));
+    const model = decodeURIComponent(match[1]);
+    const entry = match[2] ? decodeURIComponent(match[2]) : pinnedSlug(url);
+    const tags = entry ? [modelEntriesTag(model), entryTag(entry)] : [modelTag(model)];
     const next = init?.next;
     const merged = {
       ...init,
@@ -32,6 +43,7 @@ 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}`;
 }
 function planRevalidation(payload, options) {
@@ -52,7 +64,10 @@ function planRevalidation(payload, options) {
   const pathList = paths == null ? [] : typeof paths === "string" ? [paths] : paths;
   const tags = [];
   if (options.tags) {
-    if (modelKey) tags.push(modelTag(modelKey));
+    if (modelKey) {
+      tags.push(modelTag(modelKey));
+      if (payload.changed.some((p) => p === "slug" || p === "path")) tags.push(modelEntriesTag(modelKey));
+    }
     tags.push(entryTag(payload.entry.id));
     if (payload.entry.slug) tags.push(entryTag(payload.entry.slug));
   }
@@ -62,8 +77,9 @@ function planRevalidation(payload, options) {
 export {
   modelTag,
   entryTag,
+  modelEntriesTag,
   createTaggedFetch,
   entryUrl,
   planRevalidation
 };
-//# sourceMappingURL=chunk-BMLKEIKX.js.map
+//# sourceMappingURL=chunk-J5OXC4XR.js.map

package/dist/chunk-J5OXC4XR.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. 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/index.cjs

@@ -24,6 +24,7 @@ __export(index_exports, {
   createTaggedFetch: () => createTaggedFetch,
   entryTag: () => entryTag,
   entryUrl: () => entryUrl,
+  modelEntriesTag: () => modelEntriesTag,
   modelTag: () => modelTag,
   planRevalidation: () => planRevalidation
 });
@@ -43,15 +44,26 @@ function modelTag(modelKey) {
 function entryTag(slugOrId) {
   return `plenary:entry:${slugOrId}`;
 }
+function modelEntriesTag(modelKey) {
+  return `plenary:model-entries:${modelKey}`;
+}
 var CONTENT_URL = /\/api\/v1\/content\/([^/?#]+)(?:\/([^/?#]+))?/;
+function pinnedSlug(url) {
+  const query = url.split("?")[1]?.split("#")[0];
+  if (!query) return void 0;
+  const params = new URLSearchParams(query);
+  const values = [...params.getAll("where:slug"), ...params.getAll("where:slug.$eq")];
+  return values.length === 1 ? values[0] : void 0;
+}
 function createTaggedFetch(baseFetch = fetch) {
   return ((input, init) => {
     const method = init?.method ?? "GET";
     const url = typeof input === "string" ? input : input instanceof URL ? input.href : input.url;
     const match = method === "GET" ? CONTENT_URL.exec(url) : null;
     if (!match?.[1]) return baseFetch(input, init);
-    const tags = [modelTag(decodeURIComponent(match[1]))];
-    if (match[2]) tags.push(entryTag(decodeURIComponent(match[2])));
+    const model = decodeURIComponent(match[1]);
+    const entry = match[2] ? decodeURIComponent(match[2]) : pinnedSlug(url);
+    const tags = entry ? [modelEntriesTag(model), entryTag(entry)] : [modelTag(model)];
     const next = init?.next;
     const merged = {
       ...init,
@@ -66,6 +78,7 @@ 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}`;
 }
 function planRevalidation(payload, options) {
@@ -86,7 +99,10 @@ function planRevalidation(payload, options) {
   const pathList = paths == null ? [] : typeof paths === "string" ? [paths] : paths;
   const tags = [];
   if (options.tags) {
-    if (modelKey) tags.push(modelTag(modelKey));
+    if (modelKey) {
+      tags.push(modelTag(modelKey));
+      if (payload.changed.some((p) => p === "slug" || p === "path")) tags.push(modelEntriesTag(modelKey));
+    }
     tags.push(entryTag(payload.entry.id));
     if (payload.entry.slug) tags.push(entryTag(payload.entry.slug));
   }
@@ -123,6 +139,7 @@ function createRevalidateHandler(options) {
   createTaggedFetch,
   entryTag,
   entryUrl,
+  modelEntriesTag,
   modelTag,
   planRevalidation
 });

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, 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, 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`). 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  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) tags.push(modelTag(modelKey));\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 every read of a model's content. */\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/** 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/**\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 * GET requests to `/api/v1/content/{model}` are tagged with the model, and\n * `/api/v1/content/{model}/{slugOrId}` with the model and the entry. Anything\n * 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 tags = [modelTag(decodeURIComponent(match[1]))];\n    if (match[2]) tags.push(entryTag(decodeURIComponent(match[2])));\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. 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"]}

package/dist/index.d.cts

@@ -1,5 +1,5 @@
-import { R as RevalidateOptions } from './resolve-DzNy1GAi.cjs';
-export { a as RevalidatePaths, b as RevalidationPlan, e as entryUrl, p as planRevalidation } from './resolve-DzNy1GAi.cjs';
+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';
 
 /**
@@ -29,11 +29,16 @@ declare function createRevalidateHandler(options: RevalidateOptions): (request:
  * webhook handler can revalidate every page that used a piece of content
  * without a path map.
  */
-/** Tag carried by every read of a model's content. */
+/** Tag carried by list reads of a model's content, which any entry event on
+ * the model can change. */
 declare function modelTag(modelKey: string): string;
 /** Tag for one entry. The content API addresses entries by slug or UUID, and a
  * webhook payload carries both, so both spellings are revalidated. */
 declare function entryTag(slugOrId: string): string;
+/** Tag carried by every single-entry read of a model. A webhook revalidates it
+ * only when an entry's slug or folder changes: the page at the old URL was
+ * cached under the old slug, which the payload no longer names. */
+declare function modelEntriesTag(modelKey: string): string;
 /**
  * Wraps a fetch implementation so Plenary content reads carry cache tags.
  * Pass it to `createClient`:
@@ -42,10 +47,11 @@ declare function entryTag(slugOrId: string): string;
  * const plenary = createClient({ ...config, fetch: createTaggedFetch() });
  * ```
  *
- * GET requests to `/api/v1/content/{model}` are tagged with the model, and
- * `/api/v1/content/{model}/{slugOrId}` with the model and the entry. Anything
- * else passes through untouched.
+ * A read of one entry, `/api/v1/content/{model}/{slugOrId}` or a list read
+ * pinned with `where: { slug }`, is tagged with that entry, so editing another
+ * entry leaves its page cached. Other GET requests to `/api/v1/content/{model}`
+ * are tagged with the model. Anything else passes through untouched.
  */
 declare function createTaggedFetch(baseFetch?: typeof fetch): typeof fetch;
 
-export { RevalidateOptions, createRevalidateHandler, createTaggedFetch, entryTag, modelTag };
+export { RevalidateOptions, createRevalidateHandler, createTaggedFetch, entryTag, modelEntriesTag, modelTag };

package/dist/index.d.ts

@@ -1,5 +1,5 @@
-import { R as RevalidateOptions } from './resolve-DzNy1GAi.js';
-export { a as RevalidatePaths, b as RevalidationPlan, e as entryUrl, p as planRevalidation } from './resolve-DzNy1GAi.js';
+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';
 
 /**
@@ -29,11 +29,16 @@ declare function createRevalidateHandler(options: RevalidateOptions): (request:
  * webhook handler can revalidate every page that used a piece of content
  * without a path map.
  */
-/** Tag carried by every read of a model's content. */
+/** Tag carried by list reads of a model's content, which any entry event on
+ * the model can change. */
 declare function modelTag(modelKey: string): string;
 /** Tag for one entry. The content API addresses entries by slug or UUID, and a
  * webhook payload carries both, so both spellings are revalidated. */
 declare function entryTag(slugOrId: string): string;
+/** Tag carried by every single-entry read of a model. A webhook revalidates it
+ * only when an entry's slug or folder changes: the page at the old URL was
+ * cached under the old slug, which the payload no longer names. */
+declare function modelEntriesTag(modelKey: string): string;
 /**
  * Wraps a fetch implementation so Plenary content reads carry cache tags.
  * Pass it to `createClient`:
@@ -42,10 +47,11 @@ declare function entryTag(slugOrId: string): string;
  * const plenary = createClient({ ...config, fetch: createTaggedFetch() });
  * ```
  *
- * GET requests to `/api/v1/content/{model}` are tagged with the model, and
- * `/api/v1/content/{model}/{slugOrId}` with the model and the entry. Anything
- * else passes through untouched.
+ * A read of one entry, `/api/v1/content/{model}/{slugOrId}` or a list read
+ * pinned with `where: { slug }`, is tagged with that entry, so editing another
+ * entry leaves its page cached. Other GET requests to `/api/v1/content/{model}`
+ * are tagged with the model. Anything else passes through untouched.
  */
 declare function createTaggedFetch(baseFetch?: typeof fetch): typeof fetch;
 
-export { RevalidateOptions, createRevalidateHandler, createTaggedFetch, entryTag, modelTag };
+export { RevalidateOptions, createRevalidateHandler, createTaggedFetch, entryTag, modelEntriesTag, modelTag };

package/dist/index.js

@@ -2,9 +2,10 @@ import {
   createTaggedFetch,
   entryTag,
   entryUrl,
+  modelEntriesTag,
   modelTag,
   planRevalidation
-} from "./chunk-BMLKEIKX.js";
+} from "./chunk-J5OXC4XR.js";
 
 // src/revalidate.ts
 import { revalidatePath, revalidateTag } from "next/cache";
@@ -37,6 +38,7 @@ export {
   createTaggedFetch,
   entryTag,
   entryUrl,
+  modelEntriesTag,
   modelTag,
   planRevalidation
 };

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/revalidate.ts"],"sourcesContent":["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"],"mappings":";;;;;;;;;AAAA,SAAS,gBAAgB,qBAAqB;AAC9C,SAAS,qBAAqB,2BAA2B;AAqBlD,SAAS,wBACd,SACyC;AACzC,SAAO,OAAO,YAAY;AACxB,QAAI;AACJ,QAAI;AACF,gBAAU,MAAM,oBAAoB,SAAS,OAAO;AAAA,IACtD,SAAS,KAAK;AACZ,UAAI,eAAe,qBAAqB;AACtC,eAAO,SAAS,KAAK,EAAE,SAAS,IAAI,QAAQ,GAAG,EAAE,QAAQ,IAAI,OAAO,CAAC;AAAA,MACvE;AACA,YAAM;AAAA,IACR;AAEA,UAAM,OAAO,iBAAiB,SAAS,OAAO;AAC9C,QAAI,CAAC,KAAK,UAAU;AAClB,aAAO,SAAS,KAAK,EAAE,aAAa,OAAO,SAAS,QAAQ,MAAM,CAAC;AAAA,IACrE;AACA,QAAI,KAAK,MAAM;AACb,aAAO,SAAS,KAAK,EAAE,MAAM,MAAM,OAAO,KAAK,OAAO,MAAM,KAAK,KAAK,CAAC;AAAA,IACzE;AACA,eAAW,QAAQ,KAAK,MAAO,gBAAe,IAAI;AAClD,eAAW,OAAO,KAAK,KAAM,eAAc,GAAG;AAC9C,WAAO,SAAS,KAAK,EAAE,aAAa,MAAM,OAAO,KAAK,OAAO,MAAM,KAAK,KAAK,CAAC;AAAA,EAChF;AACF;","names":[]}
+{"version":3,"sources":["../src/revalidate.ts"],"sourcesContent":["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"],"mappings":";;;;;;;;;;AAAA,SAAS,gBAAgB,qBAAqB;AAC9C,SAAS,qBAAqB,2BAA2B;AAqBlD,SAAS,wBACd,SACyC;AACzC,SAAO,OAAO,YAAY;AACxB,QAAI;AACJ,QAAI;AACF,gBAAU,MAAM,oBAAoB,SAAS,OAAO;AAAA,IACtD,SAAS,KAAK;AACZ,UAAI,eAAe,qBAAqB;AACtC,eAAO,SAAS,KAAK,EAAE,SAAS,IAAI,QAAQ,GAAG,EAAE,QAAQ,IAAI,OAAO,CAAC;AAAA,MACvE;AACA,YAAM;AAAA,IACR;AAEA,UAAM,OAAO,iBAAiB,SAAS,OAAO;AAC9C,QAAI,CAAC,KAAK,UAAU;AAClB,aAAO,SAAS,KAAK,EAAE,aAAa,OAAO,SAAS,QAAQ,MAAM,CAAC;AAAA,IACrE;AACA,QAAI,KAAK,MAAM;AACb,aAAO,SAAS,KAAK,EAAE,MAAM,MAAM,OAAO,KAAK,OAAO,MAAM,KAAK,KAAK,CAAC;AAAA,IACzE;AACA,eAAW,QAAQ,KAAK,MAAO,gBAAe,IAAI;AAClD,eAAW,OAAO,KAAK,KAAM,eAAc,GAAG;AAC9C,WAAO,SAAS,KAAK,EAAE,aAAa,MAAM,OAAO,KAAK,OAAO,MAAM,KAAK,KAAK,CAAC;AAAA,EAChF;AACF;","names":[]}

package/dist/pages.cjs

@@ -35,12 +35,16 @@ function modelTag(modelKey) {
 function entryTag(slugOrId) {
   return `plenary:entry:${slugOrId}`;
 }
+function modelEntriesTag(modelKey) {
+  return `plenary:model-entries:${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}`;
 }
 function planRevalidation(payload, options) {
@@ -61,7 +65,10 @@ function planRevalidation(payload, options) {
   const pathList = paths == null ? [] : typeof paths === "string" ? [paths] : paths;
   const tags = [];
   if (options.tags) {
-    if (modelKey) tags.push(modelTag(modelKey));
+    if (modelKey) {
+      tags.push(modelTag(modelKey));
+      if (payload.changed.some((p) => p === "slug" || p === "path")) tags.push(modelEntriesTag(modelKey));
+    }
     tags.push(entryTag(payload.entry.id));
     if (payload.entry.slug) tags.push(entryTag(payload.entry.slug));
   }

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, 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`). 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  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) tags.push(modelTag(modelKey));\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 every read of a model's content. */\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/** 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/**\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 * GET requests to `/api/v1/content/{model}` are tagged with the model, and\n * `/api/v1/content/{model}/{slugOrId}` with the model and the entry. Anything\n * 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 tags = [modelTag(decodeURIComponent(match[1]))];\n    if (match[2]) tags.push(entryTag(decodeURIComponent(match[2])));\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. 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"]}

package/dist/pages.d.cts

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

package/dist/pages.d.ts

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

package/dist/pages.js

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

package/dist/{resolve-DzNy1GAi.d.cts → resolve-RT8_HYfz.d.cts}

@@ -27,7 +27,8 @@ interface RevalidateOptions extends ParseWebhookOptions {
     tags?: boolean;
 }
 /** Default URL for an entry: folder path + slug (`/blog` + `spring-sale` →
- * `/blog/spring-sale`). Entries without a slug (singletons) get no default. */
+ * `/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. */

package/dist/{resolve-DzNy1GAi.d.ts → resolve-RT8_HYfz.d.ts}

@@ -27,7 +27,8 @@ interface RevalidateOptions extends ParseWebhookOptions {
     tags?: boolean;
 }
 /** Default URL for an entry: folder path + slug (`/blog` + `spring-sale` →
- * `/blog/spring-sale`). Entries without a slug (singletons) get no default. */
+ * `/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. */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@plenary/next",
-  "version": "1.0.0",
+  "version": "1.0.2",
   "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.0"
+    "@plenary/client": "1.0.2"
   },
   "peerDependencies": {
     "next": "^14 || ^15 || ^16"

package/dist/chunk-BMLKEIKX.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 every read of a model's content. */\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/** 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/**\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 * GET requests to `/api/v1/content/{model}` are tagged with the model, and\n * `/api/v1/content/{model}/{slugOrId}` with the model and the entry. Anything\n * 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 tags = [modelTag(decodeURIComponent(match[1]))];\n    if (match[2]) tags.push(entryTag(decodeURIComponent(match[2])));\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, 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`). 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  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) tags.push(modelTag(modelKey));\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":";AASO,SAAS,SAAS,UAA0B;AACjD,SAAO,iBAAiB,QAAQ;AAClC;AAIO,SAAS,SAAS,UAA0B;AACjD,SAAO,iBAAiB,QAAQ;AAClC;AAQA,IAAM,cAAc;AAcb,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,OAAO,CAAC,SAAS,mBAAmB,MAAM,CAAC,CAAC,CAAC,CAAC;AACpD,QAAI,MAAM,CAAC,EAAG,MAAK,KAAK,SAAS,mBAAmB,MAAM,CAAC,CAAC,CAAC,CAAC;AAC9D,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;;;AClDA;AAAA,EACE;AAAA,EACA;AAAA,OAKK;AA8BA,SAAS,SAAS,SAA6C;AACpE,QAAM,EAAE,MAAM,KAAK,IAAI,QAAQ;AAC/B,MAAI,CAAC,KAAM,QAAO;AAClB,QAAM,MAAM,QAAQ,SAAS,MAAM,OAAO;AAC1C,SAAO,GAAG,GAAG,IAAI,IAAI;AACvB;AAYO,SAAS,iBACd,SACA,SACkB;AAClB,QAAM,OAAO,EAAE,UAAU,OAAO,MAAM,OAAO,OAAO,CAAC,GAAG,MAAM,CAAC,EAAE;AACjE,MAAI,CAAC,sBAAsB,OAAO,EAAG,QAAO;AAE5C,QAAM,OAAO,QAAQ,UAAU;AAC/B,MAAI,CAAC,QAAQ,QAAQ,UAAU,CAAC,QAAQ,OAAO,SAAS,QAAQ,KAA0B,GAAG;AAC3F,WAAO;AAAA,EACT;AAEA,QAAM,WAAW,QAAQ,MAAM;AAC/B,QAAM,SAAS,aAAa,SAAY,SAAY,QAAQ,QAAQ,QAAQ;AAC5E,MAAI;AACJ,MAAI,WAAW,QAAW;AACxB,aAAS,QAAQ,YAAY,UAAU,OAAO;AAAA,EAChD,OAAO;AACL,YAAQ,OAAO,WAAW,aAAa,OAAO,OAAO,IAAI;AAAA,EAC3D;AACA,QAAM,WAAW,SAAS,OAAO,CAAC,IAAI,OAAO,UAAU,WAAW,CAAC,KAAK,IAAI;AAE5E,QAAM,OAAiB,CAAC;AACxB,MAAI,QAAQ,MAAM;AAChB,QAAI,SAAU,MAAK,KAAK,SAAS,QAAQ,CAAC;AAC1C,SAAK,KAAK,SAAS,QAAQ,MAAM,EAAE,CAAC;AACpC,QAAI,QAAQ,MAAM,KAAM,MAAK,KAAK,SAAS,QAAQ,MAAM,IAAI,CAAC;AAAA,EAChE;AAEA,SAAO,EAAE,UAAU,MAAM,MAAM,OAAO,CAAC,GAAG,IAAI,IAAI,QAAQ,CAAC,GAAG,KAAK;AACrE;","names":[]}