@forumone/throughline-workflows 0.4.0 → 0.5.0

package/CHANGELOG.md

@@ -1,5 +1,62 @@
 # @forumone/throughline-workflows
 
+## 0.5.0
+
+### Minor Changes
+
+- ab623e1: The `payload` peer range moves from `^3.0.0` to `^3.89.0` for every package that has one. **A site on Payload older than 3.89.0 must upgrade Payload before upgrading these packages.**
+
+  Before 3.89.0, the `payload-mcp-api-keys` collection that `@payloadcms/plugin-mcp` adds registered Payload's API-key strategy on every REST route. Any key could then become `req.user` outside `/api/mcp` and pass access rules written as `Boolean(req.user)`. Every Throughline site runs that plugin, so the floor is the same for every package. No package's code changes with this bump.
+
+- 653817e: Revalidation no longer guesses paths, and covers the changes a publish event never announces.
+
+  - **workflows (breaking)**: `createRevalidateOnPublishFunction` has no built-in URL
+    builders. They mapped `pages` to `/<slug>`, `posts` to `/blog/<slug>` and any other
+    collection to `/<slug>`, so a site whose routes differed revalidated the wrong path
+    without a word. `urlBuilders` is now required; a collection with no entry has its
+    tags dropped and no path revalidated, and the run logs a warning. To keep the old
+    behaviour, pass the old builders:
+
+    ```ts
+    urlBuilders: {
+      pages: (slug) => (slug === 'home' || slug === '' ? '/' : `/${slug}`),
+      posts: (slug) => `/blog/${slug}`,
+    }
+    ```
+
+    and then check them against your routes.
+
+  - **workflows**: `createTagRevalidationHooks` — collection `afterChange` and
+    `afterDelete`, and global `afterChange`, hooks that call
+    `revalidateTag(tag, { expire: 0 })`. Draft saves and autosave drop nothing (via
+    publishing's `isDraftWrite`); an unpublish still does. A hook never throws: outside a
+    Next request (seeds, migrations, the CLI) it logs at `debug`, and any other failure
+    at `error` with the tag and the cause.
+  - **workflows**: `createCacheTags` builds every tag string, so the hooks, the publish
+    workflow (new `cacheTags` option) and cached reads cannot name different tags.
+    Defaults: the bare slug for a collection, `global_<slug>` for a global. Also on the
+    dependency-free `@forumone/throughline-workflows/cache-tags` subpath for frontend code.
+    `@forumone/throughline-publishing` is now a dependency of this package.
+  - **create-throughline**: the scaffold adds `apps/web/src/lib/cache-tags.ts`, attaches
+    the tag hooks to `Pages`, and passes explicit `urlBuilders` and the shared
+    `cacheTags` to the publish workflow.
+
+- 70385c4: `onTerminalFailure` has a handler to pass it. `createTerminalFailureHandler({ payload })` logs a run that exhausted its retries, writes a `job-failures` row through core's `jobFailuresPlugin` when it is registered, and posts the report to `ERROR_WEBHOOK_URL`. `createHealthcheckFailureHandler({ payload })` does the same for the healthcheck's per-run `onFailure`. Neither throws, because a throwing `onFailure` is retried by Inngest. The terminal handler also works as the `onFailure` of any Inngest function.
+
+  Recording rows needs core's `jobFailuresPlugin` and its migration. Without the plugin, the handlers still log and report.
+
+### Patch Changes
+
+- Updated dependencies [006ae30]
+- Updated dependencies [549d292]
+- Updated dependencies [70385c4]
+- Updated dependencies [c8a86bf]
+- Updated dependencies [ab623e1]
+- Updated dependencies [ab623e1]
+- Updated dependencies [36728c4]
+  - @forumone/throughline-core@0.10.0
+  - @forumone/throughline-publishing@0.11.0
+
 ## 0.4.0
 
 ### Minor Changes

package/README.md

@@ -1,8 +1,8 @@
 # @forumone/throughline-workflows
 
-Composable Inngest function factories for the Throughline framework. Client apps import the factories they need and merge the functions into their Inngest endpoint.
+Composable Inngest function factories for the Throughline framework, and the Payload hooks that keep a Next cache honest. Client apps import the factories they need and merge the functions into their Inngest endpoint.
 
-This package has **no Payload plugin** — it exports factories only. Workflows subscribe to events the server packages emit; they don't modify Payload configuration.
+This package has **no Payload plugin** — it exports factories only. Workflows subscribe to events the server packages emit; they don't modify Payload configuration. The cache-revalidation hooks are factories too: you attach them to the collections and globals you choose.
 
 ## What this package provides
 
@@ -14,6 +14,18 @@ This package has **no Payload plugin** — it exports factories only. Workflows
 | `createExpireStaleApprovalsFunction` | Daily cron that flips pending approvals past `expiresAt` to `expired` and fires an `approval/expired` event |
 | `createAuditEventEchoFunction` | Fan-out point: turns `audit/event.recorded` into `notification/send-approval-*` events plus custom handlers |
 | `createHealthcheckFunction` | Periodic health monitoring with configurable checks |
+| `createTagRevalidationHooks` | Payload `afterChange` / `afterDelete` hooks that drop Next cache tags when a collection or global changes |
+| `createCacheTags` | The one tag scheme hooks, workflow and readers all build tags from (also on `@forumone/throughline-workflows/cache-tags`) |
+
+Plus two failure handlers, for the `onTerminalFailure` every factory accepts and the healthcheck's own `onFailure`:
+
+- `createTerminalFailureHandler({ payload })` — logs a run that exhausted its retries, writes a `job-failures` row (when core's `jobFailuresPlugin` is registered) and posts it to `ERROR_WEBHOOK_URL`. Never throws. Works as any Inngest function's `onFailure`.
+- `createHealthcheckFailureHandler({ payload })` — the same, once per healthcheck run with failing checks.
+
+```ts
+const onTerminalFailure = createTerminalFailureHandler({ payload })
+createExpireStaleApprovalsFunction({ inngest, payload, onTerminalFailure })
+```
 
 Plus two reusable check helpers used with the healthcheck factory:
 
@@ -26,7 +38,7 @@ Plus two reusable check helpers used with the healthcheck factory:
 pnpm add @forumone/throughline-workflows
 ```
 
-Peers: `payload@^3.0.0`, `inngest@^4.0.0`. `next` is an **optional** peer — install it only if you use `createRevalidateOnPublishFunction` with the default revalidator.
+Peers: `payload@^3.89.0`, `inngest@^4.0.0`. `next` is an **optional** peer — install it only if you use `createRevalidateOnPublishFunction` or `createTagRevalidationHooks` with their default revalidators.
 
 ## Usage
 
@@ -52,7 +64,16 @@ const payload = await getPayload({ config })
 export const { GET, POST, PUT } = serve({
   client: inngest,
   functions: [
-    createRevalidateOnPublishFunction({ inngest, payload }),
+    createRevalidateOnPublishFunction({
+      inngest,
+      payload,
+      // Required. Where each publishable collection is served.
+      urlBuilders: {
+        pages: (slug) => (slug === 'home' ? '/' : `/${slug}`),
+        posts: (slug) => `/news/${slug}`,
+      },
+      cacheTags, // the same scheme your readers use — see below
+    }),
     createExecuteScheduledPublishesFunction({
       inngest,
       payload,
@@ -77,14 +98,116 @@ By C10, every server package fires Inngest events when consequential things happ
 
 The factories-only shape (no Payload plugin) is the same reasoning. A workflow that wants to revalidate Next.js pages doesn't need to register a Payload collection. A scheduled-publish executor doesn't need a Payload hook. They're cron / event handlers that happen to read from Payload.
 
+The tag-revalidation hooks are the one place this package reaches into Payload configuration, and only because you put them there: they are plain hook functions, not a plugin. They live here rather than in `publishing` because this package already owns Next cache invalidation — the optional `next` peer, the Next 16 `revalidateTag` profile, and the tag `createRevalidateOnPublishFunction` fires — and one tag scheme has to serve both. They use publishing's `isDraftWrite`, which makes `publishing` a dependency of this package. Publishing depends on nothing here, so there is no cycle.
+
+## Cache tags: one scheme, both ends
+
+A cache tag has two ends: a reader that caches under it and a writer that drops it. Nothing in the type system connects them. Name them differently and everything compiles, every test passes, the hook runs, and the page never refreshes. So build both from one object:
+
+```typescript
+// src/lib/cache-tags.ts — imported by payload.config.ts, the Inngest route and readers
+import { createCacheTags } from '@forumone/throughline-workflows/cache-tags'
+
+export const cacheTags = createCacheTags()
+// or name them your way:
+// createCacheTags({ collection: (slug) => `c:${slug}`, global: (slug) => `g:${slug}` })
+```
+
+The defaults are the bare slug for a collection (`pages`, which is also what `createRevalidateOnPublishFunction` has always fired) and `global_<slug>` for a global. The `/cache-tags` subpath imports nothing, so frontend code can use it without pulling in Payload.
+
+A reader tags its cached read from the same object:
+
+```typescript
+import { unstable_cache } from 'next/cache'
+import { cacheTags } from '@/lib/cache-tags'
+
+export const getNavigation = unstable_cache(
+  async () => (await getPayload({ config })).findGlobal({ slug: 'navigation' }),
+  ['navigation'],
+  { tags: [cacheTags.global('navigation')] },
+)
+// With Cache Components: cacheTag(cacheTags.global('navigation')) inside a 'use cache' function.
+```
+
+## Tag-revalidation hooks
+
+`createRevalidateOnPublishFunction` reacts to publishing events, so it covers publishes, unpublishes and rollbacks of publishable collections — and nothing else. A global (navigation, footer, settings) is read on every page and usually cached, and nothing publishes it. A collection an integration writes emits no publishing event. A delete is not a publish. Each of those leaves the cached copy standing until the next deploy unless a hook drops it:
+
+```typescript
+import { createTagRevalidationHooks } from '@forumone/throughline-workflows'
+import { cacheTags } from './lib/cache-tags'
+
+const revalidation = createTagRevalidationHooks({ cacheTags })
+
+const Pages: CollectionConfig = {
+  slug: 'pages',
+  hooks: {
+    // Navigation links to pages and caches their slugs, so a page change drops it too.
+    afterChange: [
+      revalidation.afterCollectionChange({
+        tags: (t, slug) => [t.collection(slug), t.global('navigation')],
+      }),
+    ],
+    afterDelete: [revalidation.afterCollectionDelete()],
+  },
+  // ...
+}
+
+const Media: CollectionConfig = {
+  slug: 'media',
+  upload: true,
+  hooks: {
+    // An upload cannot be referenced by anything cached yet.
+    afterChange: [revalidation.afterCollectionChange({ operations: ['update'] })],
+    afterDelete: [revalidation.afterCollectionDelete()],
+  },
+  // ...
+}
+
+const Navigation: GlobalConfig = {
+  slug: 'navigation',
+  hooks: { afterChange: [revalidation.afterGlobalChange()] },
+  // ...
+}
+```
+
+What they do:
+
+- **Drop tags, not paths.** Each hook calls `revalidateTag(tag, { expire: 0 })`, the immediate expiry Next 16 requires a profile for. Paths are the workflow's job. A collection hook defaults to `cacheTags.collection(slug)`, a global hook to `cacheTags.global(slug)`; `tags` replaces that list.
+- **Skip draft writes.** On `update`, a collection hook asks publishing's `isDraftWrite`, so a draft save or an autosave tick drops nothing, while an unpublish still does. That answer is recorded by `publishingPlugin` for the collections it manages; on any other collection every write counts as visible, which is the safe direction. A `create` that lands as a draft is skipped too: nothing published existed a moment ago. Global hooks drop on every save.
+- **Never throw.** A throwing `afterChange` fails the editor's save over a cache miss. Outside a Next request — seeds, migrations, the Payload CLI under `tsx` — Next throws `static generation store missing`; there is no server to be stale, so that is logged at `debug`. Any other failure means the cache did not clear while a server was running, and is logged at `error` with the cause and the tag.
+- **Other frontends.** Pass `revalidateTag: (tag) => myCdn.purgeTag(tag)` to drop tags somewhere other than Next.
+
+These overlap with `createRevalidateOnPublishFunction` on a publish — both drop the collection tag — which is harmless: dropping a tag twice is dropping it once. Use the workflow for page paths and the sitemap, and the hooks for everything a publish event never announces.
+
+## Migrating from the built-in URL builders
+
+Before 0.5, `createRevalidateOnPublishFunction` guessed paths: `pages` → `/<slug>` (`home` → `/`), `posts` → `/blog/<slug>`, and any other collection → `/<slug>`. A site whose routes differed revalidated the wrong path without a word. `urlBuilders` is now required and has no built-in entries. A collection with no entry still has its tags dropped, but no path is revalidated and the run logs a warning.
+
+If you relied on the defaults, pass them explicitly — the same behaviour as before:
+
+```typescript
+createRevalidateOnPublishFunction({
+  inngest,
+  payload,
+  urlBuilders: {
+    pages: (slug) => (slug === 'home' || slug === '' ? '/' : `/${slug}`),
+    posts: (slug) => `/blog/${slug}`,
+  },
+})
+```
+
+Then check them against your routes: if your posts are not under `/blog`, they never were being revalidated.
+
 ## Non-Next.js frontends
 
-The default `revalidate` function dynamically imports `next/cache` and is a no-op anywhere `revalidatePath` / `revalidateTag` aren't available. For other frameworks supply your own:
+The default `revalidate` function dynamically imports `next/cache`, so the package installs and imports without Next. For other frameworks supply your own:
 
 ```typescript
 createRevalidateOnPublishFunction({
   inngest,
   payload,
+  urlBuilders,
   revalidate: async ({ path, tags }) => {
     if (path) await myCdn.purge(path)
     for (const tag of tags) await myCdn.purgeTag(tag)
@@ -192,9 +315,10 @@ Each handler runs in its own `step.run`, so failures isolate.
 
 ## Options reference
 
-Every factory takes a typed options object. See `src/types.ts` for the full surface — defaults documented there:
+Every factory takes a typed options object. See `src/types.ts` for the full surface — defaults documented there. All of them also accept `onTerminalFailure?` and `concurrency?`:
 
-- `RevalidateOnPublishOptions` — `revalidate?`, `urlBuilders?`, `collectionTags?`, `id?`
+- `RevalidateOnPublishOptions` — `urlBuilders` (required), `cacheTags?`, `collectionTags?`, `revalidate?`, `id?`
+- `TagRevalidationOptions` — `cacheTags?`, `revalidateTag?`; per hook, `tags?` and (collection `afterChange`) `operations?`
 - `PublishAtScheduledTimeOptions` — `collections[]`, `publish`, `maxSleepMs?` (default six days), `id?`
 - `ExecuteScheduledPublishesOptions` — `collections[]`, `publish`, `schedule?` (default `*/5 * * * *`), `overdueByMs?` (default 0), `id?`
 - `ExpireStaleApprovalsOptions` — `collectionSlug?` (default `approvals`), `schedule?` (default `0 2 * * *`), `id?`
@@ -204,6 +328,6 @@ Every factory takes a typed options object. See `src/types.ts` for the full surf
 ## Related packages
 
 - `@forumone/throughline-core` — required peer; provides the audit writer the approval-expiration cron uses
-- `@forumone/throughline-publishing` — emits the publishing events the revalidation cron subscribes to
+- `@forumone/throughline-publishing` — emits the publishing events the revalidation workflow subscribes to, and provides the `isDraftWrite` predicate the tag hooks use (a dependency)
 - `@forumone/throughline-approvals` — owns the approvals collection the expiration cron reads
 - `@forumone/throughline-email` (C11) — will subscribe to `notification/send-approval-*`

package/dist/cache-tags.d.ts

@@ -0,0 +1,31 @@
+/** How a site names its tags. Each builder is optional; omitted ones use the default. */
+export interface CacheTagScheme {
+    /**
+     * The tag for cached reads derived from a collection's documents.
+     * Default: the bare slug (`pages`), which is also what
+     * `createRevalidateOnPublishFunction` has always fired.
+     */
+    collection?: (slug: string) => string;
+    /** The tag for a cached global. Default: `global_<slug>`. */
+    global?: (slug: string) => string;
+}
+/** The built scheme. Pass the same instance to writers and readers. */
+export interface CacheTags {
+    collection(slug: string): string;
+    global(slug: string): string;
+}
+/**
+ * Builds the tag scheme both ends of the cache use.
+ *
+ * ```ts
+ * // src/lib/cache-tags.ts — imported by payload.config.ts and by readers
+ * export const cacheTags = createCacheTags()
+ *
+ * // a reader
+ * unstable_cache(load, ['navigation'], { tags: [cacheTags.global('navigation')] })
+ * ```
+ */
+export declare function createCacheTags(scheme?: CacheTagScheme): CacheTags;
+/** The scheme every writer uses when it is given none. */
+export declare const defaultCacheTags: CacheTags;
+//# sourceMappingURL=cache-tags.d.ts.map

package/dist/cache-tags.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache-tags.d.ts","sourceRoot":"","sources":["../src/cache-tags.ts"],"names":[],"mappings":"AAqBA,yFAAyF;AACzF,MAAM,WAAW,cAAc;IAC7B;;;;OAIG;IACH,UAAU,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,CAAA;IACrC,6DAA6D;IAC7D,MAAM,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,CAAA;CAClC;AAED,uEAAuE;AACvE,MAAM,WAAW,SAAS;IACxB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAAA;IAChC,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAAA;CAC7B;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,eAAe,CAAC,MAAM,GAAE,cAAmB,GAAG,SAAS,CAOtE;AAED,0DAA0D;AAC1D,eAAO,MAAM,gBAAgB,EAAE,SAA6B,CAAA"}

package/dist/cache-tags.js

@@ -0,0 +1,53 @@
+/*
+Next cache tags, named in one place.
+
+A tag is one string with two ends: the reader that caches under it
+(`unstable_cache(..., { tags })`, `cacheTag()`, `fetch(..., { next: { tags } })`)
+and the writer that drops it (the hooks in `revalidate-tag-hooks.ts`, and
+`createRevalidateOnPublishFunction`). Nothing in the type system connects the two
+ends. Name them differently and everything compiles, every test passes, the hook
+runs, and the page never refreshes — the first site on this suite shipped a hook
+that had never invalidated anything for exactly that reason.
+
+So both ends build tags from one object. A site makes it once, in a module its
+`payload.config.ts` and its frontend both import, and hands it to the hooks and
+the readers alike.
+
+Deliberately dependency-free, and published on its own subpath
+(`@forumone/throughline-workflows/cache-tags`): one of its importers is
+`payload.config.ts` and the other is frontend code, and neither should pull in
+the other's world to name a string.
+*/
+/**
+ * Builds the tag scheme both ends of the cache use.
+ *
+ * ```ts
+ * // src/lib/cache-tags.ts — imported by payload.config.ts and by readers
+ * export const cacheTags = createCacheTags()
+ *
+ * // a reader
+ * unstable_cache(load, ['navigation'], { tags: [cacheTags.global('navigation')] })
+ * ```
+ */
+export function createCacheTags(scheme = {}) {
+    const collection = scheme.collection ?? ((slug) => slug);
+    const global = scheme.global ?? ((slug) => `global_${slug}`);
+    return {
+        collection: (slug) => nonEmpty(collection(slug), 'collection', slug),
+        global: (slug) => nonEmpty(global(slug), 'global', slug),
+    };
+}
+/** The scheme every writer uses when it is given none. */
+export const defaultCacheTags = createCacheTags();
+/*
+An empty tag is the silent version of the mismatch above: `revalidateTag('')`
+does nothing and says nothing. A builder that produces one is a bug in the
+site's configuration, and the place to hear about it is the first call.
+*/
+function nonEmpty(tag, kind, slug) {
+    if (typeof tag !== 'string' || tag.length === 0) {
+        throw new Error(`The cache tag scheme built an empty ${kind} tag for "${slug}".`);
+    }
+    return tag;
+}
+//# sourceMappingURL=cache-tags.js.map

package/dist/cache-tags.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache-tags.js","sourceRoot":"","sources":["../src/cache-tags.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;EAmBE;AAoBF;;;;;;;;;;GAUG;AACH,MAAM,UAAU,eAAe,CAAC,SAAyB,EAAE;IACzD,MAAM,UAAU,GAAG,MAAM,CAAC,UAAU,IAAI,CAAC,CAAC,IAAY,EAAE,EAAE,CAAC,IAAI,CAAC,CAAA;IAChE,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,IAAI,CAAC,CAAC,IAAY,EAAE,EAAE,CAAC,UAAU,IAAI,EAAE,CAAC,CAAA;IACpE,OAAO;QACL,UAAU,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,QAAQ,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,YAAY,EAAE,IAAI,CAAC;QACpE,MAAM,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,QAAQ,EAAE,IAAI,CAAC;KACzD,CAAA;AACH,CAAC;AAED,0DAA0D;AAC1D,MAAM,CAAC,MAAM,gBAAgB,GAAc,eAAe,EAAE,CAAA;AAE5D;;;;EAIE;AACF,SAAS,QAAQ,CAAC,GAAW,EAAE,IAAY,EAAE,IAAY;IACvD,IAAI,OAAO,GAAG,KAAK,QAAQ,IAAI,GAAG,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAChD,MAAM,IAAI,KAAK,CAAC,uCAAuC,IAAI,aAAa,IAAI,IAAI,CAAC,CAAA;IACnF,CAAC;IACD,OAAO,GAAG,CAAA;AACZ,CAAC"}

package/dist/failure-handler.d.ts

@@ -0,0 +1,38 @@
+import type { Payload } from 'payload';
+import type { Logger } from '@forumone/throughline-core';
+import { type ErrorReporter, type JobFailureWriter } from '@forumone/throughline-core';
+import type { HealthcheckOptions, WorkflowFailureHandler } from './types.js';
+export interface FailureHandlerOptions {
+    /**
+     * The Payload instance whose `jobFailuresPlugin` writer receives the row.
+     * Without one — or without the plugin — the failure is logged and reported
+     * but not recorded.
+     */
+    payload?: Payload | undefined;
+    /** Replaces the writer found on `payload`. */
+    writer?: JobFailureWriter | undefined;
+    /** Default: `reportError` from core, which posts to `ERROR_WEBHOOK_URL`. Pass `false` to not report. */
+    report?: ErrorReporter | false | undefined;
+    /** Default: core's console logger. */
+    logger?: Logger | undefined;
+}
+export interface HealthcheckFailureHandlerOptions extends FailureHandlerOptions {
+    /** The healthcheck function's id, recorded as the failure's source. Default: `'healthcheck'`. */
+    functionId?: string | undefined;
+}
+/**
+ * An `onTerminalFailure` handler for any workflow factory here — or for any
+ * Inngest function, as its `onFailure`.
+ *
+ * ```ts
+ * const onTerminalFailure = createTerminalFailureHandler({ payload })
+ * createExpireStaleApprovalsFunction({ inngest, payload, onTerminalFailure })
+ * ```
+ */
+export declare function createTerminalFailureHandler(options?: FailureHandlerOptions): WorkflowFailureHandler;
+/**
+ * A `HealthcheckOptions.onFailure` handler: once per run with failing checks,
+ * to the same three places.
+ */
+export declare function createHealthcheckFailureHandler(options?: HealthcheckFailureHandlerOptions): NonNullable<HealthcheckOptions['onFailure']>;
+//# sourceMappingURL=failure-handler.d.ts.map

package/dist/failure-handler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"failure-handler.d.ts","sourceRoot":"","sources":["../src/failure-handler.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,SAAS,CAAA;AACtC,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,4BAA4B,CAAA;AACxD,OAAO,EAOL,KAAK,aAAa,EAGlB,KAAK,gBAAgB,EACtB,MAAM,4BAA4B,CAAA;AACnC,OAAO,KAAK,EAAE,kBAAkB,EAAE,sBAAsB,EAAE,MAAM,YAAY,CAAA;AAuB5E,MAAM,WAAW,qBAAqB;IACpC;;;;OAIG;IACH,OAAO,CAAC,EAAE,OAAO,GAAG,SAAS,CAAA;IAC7B,8CAA8C;IAC9C,MAAM,CAAC,EAAE,gBAAgB,GAAG,SAAS,CAAA;IACrC,wGAAwG;IACxG,MAAM,CAAC,EAAE,aAAa,GAAG,KAAK,GAAG,SAAS,CAAA;IAC1C,sCAAsC;IACtC,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;CAC5B;AAED,MAAM,WAAW,gCAAiC,SAAQ,qBAAqB;IAC7E,iGAAiG;IACjG,UAAU,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;CAChC;AAED;;;;;;;;GAQG;AACH,wBAAgB,4BAA4B,CAC1C,OAAO,GAAE,qBAA0B,GAClC,sBAAsB,CAgBxB;AAED;;;GAGG;AACH,wBAAgB,+BAA+B,CAC7C,OAAO,GAAE,gCAAqC,GAC7C,WAAW,CAAC,kBAAkB,CAAC,WAAW,CAAC,CAAC,CAa9C"}

package/dist/failure-handler.js

@@ -0,0 +1,60 @@
+import { buildHealthcheckFailureReport, buildJobFailureReport, defaultLogger, getJobFailureWriter, reportError, summariseReport, } from '@forumone/throughline-core';
+/**
+ * An `onTerminalFailure` handler for any workflow factory here — or for any
+ * Inngest function, as its `onFailure`.
+ *
+ * ```ts
+ * const onTerminalFailure = createTerminalFailureHandler({ payload })
+ * createExpireStaleApprovalsFunction({ inngest, payload, onTerminalFailure })
+ * ```
+ */
+export function createTerminalFailureHandler(options = {}) {
+    return async ({ error, event }) => {
+        let report;
+        try {
+            const data = event?.data;
+            report = buildJobFailureReport({
+                functionId: data?.function_id,
+                runId: data?.run_id,
+                triggerEvent: data?.event?.name,
+                error,
+            });
+        }
+        catch {
+            return;
+        }
+        await dispatch(report, '[job-failed]', options);
+    };
+}
+/**
+ * A `HealthcheckOptions.onFailure` handler: once per run with failing checks,
+ * to the same three places.
+ */
+export function createHealthcheckFailureHandler(options = {}) {
+    return async (failures) => {
+        let report;
+        try {
+            report = buildHealthcheckFailureReport(failures, options.functionId ? { functionId: options.functionId } : {});
+        }
+        catch {
+            return;
+        }
+        await dispatch(report, '[healthcheck-failed]', options);
+    };
+}
+async function dispatch(report, tag, options) {
+    const logger = options.logger ?? defaultLogger;
+    try {
+        // The stack goes to the log and the webhook; the row keeps the message.
+        logger.error(`${tag} ${summariseReport(report)}`, { report });
+    }
+    catch {
+        // Carry on to the other two.
+    }
+    const writer = options.writer ?? (options.payload ? getJobFailureWriter(options.payload) : undefined);
+    const reporter = options.report === false ? undefined : (options.report ?? reportError);
+    // Core's writer and reporter never reject. These wrappers are for a host's
+    // own, which may not keep that promise — or may throw before returning one.
+    await Promise.allSettled([(async () => writer?.(report))(), (async () => reporter?.(report))()]);
+}
+//# sourceMappingURL=failure-handler.js.map

package/dist/failure-handler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"failure-handler.js","sourceRoot":"","sources":["../src/failure-handler.ts"],"names":[],"mappings":"AAEA,OAAO,EACL,6BAA6B,EAC7B,qBAAqB,EACrB,aAAa,EACb,mBAAmB,EACnB,WAAW,EACX,eAAe,GAKhB,MAAM,4BAA4B,CAAA;AA4CnC;;;;;;;;GAQG;AACH,MAAM,UAAU,4BAA4B,CAC1C,UAAiC,EAAE;IAEnC,OAAO,KAAK,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE,EAAE;QAChC,IAAI,MAAwB,CAAA;QAC5B,IAAI,CAAC;YACH,MAAM,IAAI,GAAG,KAAK,EAAE,IAAI,CAAA;YACxB,MAAM,GAAG,qBAAqB,CAAC;gBAC7B,UAAU,EAAE,IAAI,EAAE,WAAW;gBAC7B,KAAK,EAAE,IAAI,EAAE,MAAM;gBACnB,YAAY,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI;gBAC/B,KAAK;aACN,CAAC,CAAA;QACJ,CAAC;QAAC,MAAM,CAAC;YACP,OAAM;QACR,CAAC;QACD,MAAM,QAAQ,CAAC,MAAM,EAAE,cAAc,EAAE,OAAO,CAAC,CAAA;IACjD,CAAC,CAAA;AACH,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,+BAA+B,CAC7C,UAA4C,EAAE;IAE9C,OAAO,KAAK,EAAE,QAAQ,EAAE,EAAE;QACxB,IAAI,MAAgC,CAAA;QACpC,IAAI,CAAC;YACH,MAAM,GAAG,6BAA6B,CACpC,QAAQ,EACR,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,OAAO,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC,EAAE,CAC7D,CAAA;QACH,CAAC;QAAC,MAAM,CAAC;YACP,OAAM;QACR,CAAC;QACD,MAAM,QAAQ,CAAC,MAAM,EAAE,sBAAsB,EAAE,OAAO,CAAC,CAAA;IACzD,CAAC,CAAA;AACH,CAAC;AAED,KAAK,UAAU,QAAQ,CACrB,MAAmD,EACnD,GAAW,EACX,OAA8B;IAE9B,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,IAAI,aAAa,CAAA;IAC9C,IAAI,CAAC;QACH,wEAAwE;QACxE,MAAM,CAAC,KAAK,CAAC,GAAG,GAAG,IAAI,eAAe,CAAC,MAAM,CAAC,EAAE,EAAE,EAAE,MAAM,EAAE,CAAC,CAAA;IAC/D,CAAC;IAAC,MAAM,CAAC;QACP,6BAA6B;IAC/B,CAAC;IAED,MAAM,MAAM,GACV,OAAO,CAAC,MAAM,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,mBAAmB,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAA;IACxF,MAAM,QAAQ,GAAG,OAAO,CAAC,MAAM,KAAK,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,IAAI,WAAW,CAAC,CAAA;IAEvF,2EAA2E;IAC3E,4EAA4E;IAC5E,MAAM,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC,KAAK,IAAI,EAAE,CAAC,MAAM,EAAE,CAAC,MAAM,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,IAAI,EAAE,CAAC,QAAQ,EAAE,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,CAAA;AAClG,CAAC"}

package/dist/index.d.ts

@@ -1,9 +1,15 @@
 export { createRevalidateOnPublishFunction } from './revalidate-on-publish.js';
+export { createTagRevalidationHooks } from './revalidate-tag-hooks.js';
+export type { CollectionTagHookOptions, GlobalTagHookOptions, RevalidateTagFn, TagRevalidationHooks, TagRevalidationOptions, TagSelector, } from './revalidate-tag-hooks.js';
+export { createCacheTags, defaultCacheTags } from './cache-tags.js';
+export type { CacheTags, CacheTagScheme } from './cache-tags.js';
 export { createExecuteScheduledPublishesFunction } from './execute-scheduled-publishes.js';
 export { createPublishAtScheduledTimeFunction } from './publish-at-scheduled-time.js';
 export { createExpireStaleApprovalsFunction } from './expire-stale-approvals.js';
 export { createAuditEventEchoFunction } from './audit-event-echo.js';
 export { createHealthcheckFunction, createPayloadReachableCheck, createManifestReachableCheck, } from './healthcheck.js';
 export { failureOptions } from './types.js';
+export { createHealthcheckFailureHandler, createTerminalFailureHandler, } from './failure-handler.js';
+export type { FailureHandlerOptions, HealthcheckFailureHandlerOptions, } from './failure-handler.js';
 export type { BaseWorkflowOptions, WorkflowFailureHandler, FailureAwareOptions, RevalidateFn, RevalidatePathsInput, RevalidateOnPublishOptions, ScheduledCollectionConfig, ExecuteScheduledPublishesOptions, PublishAtScheduledTimeOptions, ScheduledPublishRequest, ScheduledPublishResult, ExpireStaleApprovalsOptions, AuditEchoEvent, AuditEchoHandler, AuditEventEchoOptions, HealthcheckDefinition, HealthcheckOptions, HealthcheckResult, } from './types.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,iCAAiC,EAAE,MAAM,4BAA4B,CAAA;AAC9E,OAAO,EAAE,uCAAuC,EAAE,MAAM,kCAAkC,CAAA;AAC1F,OAAO,EAAE,oCAAoC,EAAE,MAAM,gCAAgC,CAAA;AACrF,OAAO,EAAE,kCAAkC,EAAE,MAAM,6BAA6B,CAAA;AAChF,OAAO,EAAE,4BAA4B,EAAE,MAAM,uBAAuB,CAAA;AACpE,OAAO,EACL,yBAAyB,EACzB,2BAA2B,EAC3B,4BAA4B,GAC7B,MAAM,kBAAkB,CAAA;AAEzB,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAA;AAE3C,YAAY,EACV,mBAAmB,EACnB,sBAAsB,EACtB,mBAAmB,EACnB,YAAY,EACZ,oBAAoB,EACpB,0BAA0B,EAC1B,yBAAyB,EACzB,gCAAgC,EAChC,6BAA6B,EAC7B,uBAAuB,EACvB,sBAAsB,EACtB,2BAA2B,EAC3B,cAAc,EACd,gBAAgB,EAChB,qBAAqB,EACrB,qBAAqB,EACrB,kBAAkB,EAClB,iBAAiB,GAClB,MAAM,YAAY,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iCAAiC,EAAE,MAAM,4BAA4B,CAAA;AAC9E,OAAO,EAAE,0BAA0B,EAAE,MAAM,2BAA2B,CAAA;AACtE,YAAY,EACV,wBAAwB,EACxB,oBAAoB,EACpB,eAAe,EACf,oBAAoB,EACpB,sBAAsB,EACtB,WAAW,GACZ,MAAM,2BAA2B,CAAA;AAKlC,OAAO,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAA;AACnE,YAAY,EAAE,SAAS,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAA;AAChE,OAAO,EAAE,uCAAuC,EAAE,MAAM,kCAAkC,CAAA;AAC1F,OAAO,EAAE,oCAAoC,EAAE,MAAM,gCAAgC,CAAA;AACrF,OAAO,EAAE,kCAAkC,EAAE,MAAM,6BAA6B,CAAA;AAChF,OAAO,EAAE,4BAA4B,EAAE,MAAM,uBAAuB,CAAA;AACpE,OAAO,EACL,yBAAyB,EACzB,2BAA2B,EAC3B,4BAA4B,GAC7B,MAAM,kBAAkB,CAAA;AAEzB,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAA;AAC3C,OAAO,EACL,+BAA+B,EAC/B,4BAA4B,GAC7B,MAAM,sBAAsB,CAAA;AAC7B,YAAY,EACV,qBAAqB,EACrB,gCAAgC,GACjC,MAAM,sBAAsB,CAAA;AAE7B,YAAY,EACV,mBAAmB,EACnB,sBAAsB,EACtB,mBAAmB,EACnB,YAAY,EACZ,oBAAoB,EACpB,0BAA0B,EAC1B,yBAAyB,EACzB,gCAAgC,EAChC,6BAA6B,EAC7B,uBAAuB,EACvB,sBAAsB,EACtB,2BAA2B,EAC3B,cAAc,EACd,gBAAgB,EAChB,qBAAqB,EACrB,qBAAqB,EACrB,kBAAkB,EAClB,iBAAiB,GAClB,MAAM,YAAY,CAAA"}

package/dist/index.js

@@ -1,9 +1,15 @@
-// Other factory exports land in subsequent commits.
 export { createRevalidateOnPublishFunction } from './revalidate-on-publish.js';
+export { createTagRevalidationHooks } from './revalidate-tag-hooks.js';
+/*
+Also on `@forumone/throughline-workflows/cache-tags`, which imports nothing —
+readers in frontend code should import it from there.
+*/
+export { createCacheTags, defaultCacheTags } from './cache-tags.js';
 export { createExecuteScheduledPublishesFunction } from './execute-scheduled-publishes.js';
 export { createPublishAtScheduledTimeFunction } from './publish-at-scheduled-time.js';
 export { createExpireStaleApprovalsFunction } from './expire-stale-approvals.js';
 export { createAuditEventEchoFunction } from './audit-event-echo.js';
 export { createHealthcheckFunction, createPayloadReachableCheck, createManifestReachableCheck, } from './healthcheck.js';
 export { failureOptions } from './types.js';
+export { createHealthcheckFailureHandler, createTerminalFailureHandler, } from './failure-handler.js';
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,oDAAoD;AAEpD,OAAO,EAAE,iCAAiC,EAAE,MAAM,4BAA4B,CAAA;AAC9E,OAAO,EAAE,uCAAuC,EAAE,MAAM,kCAAkC,CAAA;AAC1F,OAAO,EAAE,oCAAoC,EAAE,MAAM,gCAAgC,CAAA;AACrF,OAAO,EAAE,kCAAkC,EAAE,MAAM,6BAA6B,CAAA;AAChF,OAAO,EAAE,4BAA4B,EAAE,MAAM,uBAAuB,CAAA;AACpE,OAAO,EACL,yBAAyB,EACzB,2BAA2B,EAC3B,4BAA4B,GAC7B,MAAM,kBAAkB,CAAA;AAEzB,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iCAAiC,EAAE,MAAM,4BAA4B,CAAA;AAC9E,OAAO,EAAE,0BAA0B,EAAE,MAAM,2BAA2B,CAAA;AAStE;;;EAGE;AACF,OAAO,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAA;AAEnE,OAAO,EAAE,uCAAuC,EAAE,MAAM,kCAAkC,CAAA;AAC1F,OAAO,EAAE,oCAAoC,EAAE,MAAM,gCAAgC,CAAA;AACrF,OAAO,EAAE,kCAAkC,EAAE,MAAM,6BAA6B,CAAA;AAChF,OAAO,EAAE,4BAA4B,EAAE,MAAM,uBAAuB,CAAA;AACpE,OAAO,EACL,yBAAyB,EACzB,2BAA2B,EAC3B,4BAA4B,GAC7B,MAAM,kBAAkB,CAAA;AAEzB,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAA;AAC3C,OAAO,EACL,+BAA+B,EAC/B,4BAA4B,GAC7B,MAAM,sBAAsB,CAAA"}

package/dist/next-revalidate.d.ts

@@ -0,0 +1,43 @@
+import type * as NextCacheModule from 'next/cache';
+type NextCache = typeof NextCacheModule;
+/**
+ * How stale a caller may find a tag after it is dropped: not at all.
+ *
+ * Next 16 made `revalidateTag`'s second argument required — it is a cache-life
+ * profile — and one-argument calls log a deprecation warning on every call.
+ * `{ expire: 0 }` is the immediate expiry the one-argument form used to mean,
+ * and it is what an editor pressing Publish or Save expects.
+ *
+ * Passed unconditionally rather than behind a version check. The peer range is
+ * `next >= 15`, and Next 15's `revalidateTag` takes one parameter and ignores a
+ * second, so the two-argument call is correct on both.
+ *
+ * `updateTag`, which Next offers as the other way out of the deprecation, is
+ * not usable here: it throws outside a Server Action, and these run in an
+ * Inngest step or in Payload's route handler.
+ */
+export declare const IMMEDIATE: {
+    readonly expire: 0;
+};
+/**
+ * `next/cache`, loaded on first use.
+ *
+ * Dynamic so the package can be imported where Next is not installed (test
+ * runners, a non-Next frontend that passes its own revalidator). `next` is an
+ * optional peer.
+ */
+export declare function loadNextCache(): Promise<NextCache>;
+/**
+ * Whether `error` is Next saying there is no request to revalidate for.
+ *
+ * Seeds, migrations and the Payload CLI write through the same hooks under
+ * `tsx` rather than inside a Next server. `revalidateTag` then throws
+ * `Invariant: static generation store missing in revalidateTag ...`. Nothing is
+ * stale in that case — there is no server to be stale — so it is the one
+ * failure that is not a fault.
+ *
+ * Matched on the message, the only stable surface Next gives it.
+ */
+export declare function isOutsideNextRequest(error: unknown): boolean;
+export {};
+//# sourceMappingURL=next-revalidate.d.ts.map

package/dist/next-revalidate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"next-revalidate.d.ts","sourceRoot":"","sources":["../src/next-revalidate.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,eAAe,MAAM,YAAY,CAAA;AAElD,KAAK,SAAS,GAAG,OAAO,eAAe,CAAA;AAEvC;;;;;;;;;;;;;;;GAeG;AACH,eAAO,MAAM,SAAS;;CAAyB,CAAA;AAE/C;;;;;;GAMG;AACH,wBAAsB,aAAa,IAAI,OAAO,CAAC,SAAS,CAAC,CAExD;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAE5D"}

package/dist/next-revalidate.js

@@ -0,0 +1,42 @@
+/**
+ * How stale a caller may find a tag after it is dropped: not at all.
+ *
+ * Next 16 made `revalidateTag`'s second argument required — it is a cache-life
+ * profile — and one-argument calls log a deprecation warning on every call.
+ * `{ expire: 0 }` is the immediate expiry the one-argument form used to mean,
+ * and it is what an editor pressing Publish or Save expects.
+ *
+ * Passed unconditionally rather than behind a version check. The peer range is
+ * `next >= 15`, and Next 15's `revalidateTag` takes one parameter and ignores a
+ * second, so the two-argument call is correct on both.
+ *
+ * `updateTag`, which Next offers as the other way out of the deprecation, is
+ * not usable here: it throws outside a Server Action, and these run in an
+ * Inngest step or in Payload's route handler.
+ */
+export const IMMEDIATE = { expire: 0 };
+/**
+ * `next/cache`, loaded on first use.
+ *
+ * Dynamic so the package can be imported where Next is not installed (test
+ * runners, a non-Next frontend that passes its own revalidator). `next` is an
+ * optional peer.
+ */
+export async function loadNextCache() {
+    return await import('next/cache');
+}
+/**
+ * Whether `error` is Next saying there is no request to revalidate for.
+ *
+ * Seeds, migrations and the Payload CLI write through the same hooks under
+ * `tsx` rather than inside a Next server. `revalidateTag` then throws
+ * `Invariant: static generation store missing in revalidateTag ...`. Nothing is
+ * stale in that case — there is no server to be stale — so it is the one
+ * failure that is not a fault.
+ *
+ * Matched on the message, the only stable surface Next gives it.
+ */
+export function isOutsideNextRequest(error) {
+    return error instanceof Error && error.message.includes('static generation store missing');
+}
+//# sourceMappingURL=next-revalidate.js.map

package/dist/next-revalidate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"next-revalidate.js","sourceRoot":"","sources":["../src/next-revalidate.ts"],"names":[],"mappings":"AAIA;;;;;;;;;;;;;;;GAeG;AACH,MAAM,CAAC,MAAM,SAAS,GAAG,EAAE,MAAM,EAAE,CAAC,EAAW,CAAA;AAE/C;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa;IACjC,OAAO,MAAM,MAAM,CAAC,YAAY,CAAC,CAAA;AACnC,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,UAAU,oBAAoB,CAAC,KAAc;IACjD,OAAO,KAAK,YAAY,KAAK,IAAI,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,iCAAiC,CAAC,CAAA;AAC5F,CAAC"}

package/dist/revalidate-on-publish.d.ts

@@ -5,6 +5,16 @@ import type { RevalidateOnPublishOptions } from './types.js';
  * publishing taxonomy and revalidates Next.js cache entries for the affected
  * page, the listing routes, and the sitemap.
  *
+ * The page path comes from `options.urlBuilders`, which is required: only the
+ * site knows where a collection's documents are served. A collection with no
+ * builder gets its tags dropped and no path revalidated, with a warning —
+ * there used to be built-in builders (`pages` → `/<slug>`, `posts` →
+ * `/blog/<slug>`, anything else → `/<slug>`), and a site whose routes differed
+ * revalidated the wrong path without a word.
+ *
+ * Tags default to `cacheTags.collection(<collection>)`. Pass the same
+ * `cacheTags` your readers and your tag hooks use.
+ *
  * The default revalidate function dynamically imports `next/cache`, so the
  * package is safe to install in non-Next.js contexts. Pass `options.revalidate`
  * to use a different cache invalidation strategy.

package/dist/revalidate-on-publish.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"revalidate-on-publish.d.ts","sourceRoot":"","sources":["../src/revalidate-on-publish.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,SAAS,CAAA;AAC9C,OAAO,KAAK,EAAgB,0BAA0B,EAAwB,MAAM,YAAY,CAAA;AAOhG;;;;;;;;GAQG;AACH,wBAAgB,iCAAiC,CAC/C,OAAO,EAAE,0BAA0B,GAClC,eAAe,CAAC,GAAG,CA6CrB"}
+{"version":3,"file":"revalidate-on-publish.d.ts","sourceRoot":"","sources":["../src/revalidate-on-publish.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,SAAS,CAAA;AAG9C,OAAO,KAAK,EAAgB,0BAA0B,EAAwB,MAAM,YAAY,CAAA;AAEhG;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,iCAAiC,CAC/C,OAAO,EAAE,0BAA0B,GAClC,eAAe,CAAC,GAAG,CAqDrB"}

package/dist/revalidate-on-publish.js

@@ -1,19 +1,28 @@
 import { failureOptions } from './types.js';
-const DEFAULT_URL_BUILDERS = {
-    pages: (slug) => (slug === 'home' || slug === '' ? '/' : `/${slug}`),
-    posts: (slug) => `/blog/${slug}`,
-};
+import { defaultCacheTags } from './cache-tags.js';
+import { IMMEDIATE, loadNextCache } from './next-revalidate.js';
 /**
  * Builds the `revalidate-on-publish` Inngest function. Subscribes to the
  * publishing taxonomy and revalidates Next.js cache entries for the affected
  * page, the listing routes, and the sitemap.
  *
+ * The page path comes from `options.urlBuilders`, which is required: only the
+ * site knows where a collection's documents are served. A collection with no
+ * builder gets its tags dropped and no path revalidated, with a warning —
+ * there used to be built-in builders (`pages` → `/<slug>`, `posts` →
+ * `/blog/<slug>`, anything else → `/<slug>`), and a site whose routes differed
+ * revalidated the wrong path without a word.
+ *
+ * Tags default to `cacheTags.collection(<collection>)`. Pass the same
+ * `cacheTags` your readers and your tag hooks use.
+ *
  * The default revalidate function dynamically imports `next/cache`, so the
  * package is safe to install in non-Next.js contexts. Pass `options.revalidate`
  * to use a different cache invalidation strategy.
  */
 export function createRevalidateOnPublishFunction(options) {
-    const urlBuilders = { ...DEFAULT_URL_BUILDERS, ...options.urlBuilders };
+    const urlBuilders = options.urlBuilders;
+    const cacheTags = options.cacheTags ?? defaultCacheTags;
     const collectionTags = options.collectionTags ?? {};
     const revalidate = options.revalidate ?? defaultRevalidate;
     return options.inngest.createFunction({
@@ -34,9 +43,13 @@ export function createRevalidateOnPublishFunction(options) {
         const data = (event.data ?? {});
         const collection = data.collection ?? 'pages';
         const slug = data.slug ?? data.id ?? '';
-        const tags = collectionTags[collection] ?? [collection];
+        const tags = collectionTags[collection] ?? [cacheTags.collection(collection)];
         await step.run('revalidate-page-path', async () => {
-            const builder = urlBuilders[collection] ?? ((s) => `/${s}`);
+            const builder = Object.hasOwn(urlBuilders, collection) ? urlBuilders[collection] : undefined;
+            if (!builder) {
+                logger.warn('No urlBuilders entry for this collection, so no page path was revalidated. Add one to createRevalidateOnPublishFunction.', { collection, slug });
+                return;
+            }
             const path = builder(slug);
             await revalidate({ path, tags });
             logger.info('Revalidated page path', { path, tags });
@@ -50,23 +63,6 @@ export function createRevalidateOnPublishFunction(options) {
         return { collection, slug, revalidated: true };
     });
 }
-/**
- * How stale a caller may find a tag after this runs: not at all.
- *
- * Next 16 made `revalidateTag`'s second argument required — it is a cache-life
- * profile — and one-argument calls log a deprecation warning on every publish.
- * `{ expire: 0 }` is the immediate expiry the one-argument form used to mean,
- * and it is what an editor pressing Publish expects.
- *
- * Passed unconditionally rather than behind a version check. The peer range is
- * `next >= 15`, and Next 15's `revalidateTag` takes one parameter and ignores a
- * second, so the two-argument call is correct on both.
- *
- * `updateTag`, which Next offers as the other way out of the deprecation, is
- * not usable here: it throws outside a Server Action, and this runs in an
- * Inngest step behind a route handler.
- */
-const IMMEDIATE = { expire: 0 };
 /**
  * Default revalidator: dynamic-imports `next/cache` so the package can be
  * imported in environments without Next.js (e.g. test runners that don't
@@ -74,7 +70,7 @@ const IMMEDIATE = { expire: 0 };
  * because `revalidatePath('')` triggers a noisy Next.js warning.
  */
 const defaultRevalidate = async ({ path, tags }) => {
-    const { revalidatePath, revalidateTag } = (await import('next/cache'));
+    const { revalidatePath, revalidateTag } = await loadNextCache();
     if (path)
         revalidatePath(path);
     for (const tag of tags)

package/dist/revalidate-on-publish.js.map

@@ -1 +1 @@
-{"version":3,"file":"revalidate-on-publish.js","sourceRoot":"","sources":["../src/revalidate-on-publish.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"revalidate-on-publish.js","sourceRoot":"","sources":["../src/revalidate-on-publish.ts"],"names":[],"mappings":"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"}

package/dist/revalidate-tag-hooks.d.ts

@@ -0,0 +1,80 @@
+import type { CollectionAfterChangeHook, CollectionAfterDeleteHook, GlobalAfterChangeHook } from 'payload';
+import { type CacheTags } from './cache-tags.js';
+/** Drops one tag. Return a promise to have it awaited. */
+export type RevalidateTagFn = (tag: string) => void | Promise<void>;
+export interface TagRevalidationOptions {
+    /**
+     * The tag scheme. Pass the same object your readers build their tags from —
+     * that is the whole point of it. Default: `defaultCacheTags`.
+     */
+    cacheTags?: CacheTags;
+    /**
+     * How to drop a tag. Default: Next's `revalidateTag(tag, { expire: 0 })`,
+     * loaded from `next/cache` on first use. Supply your own for a non-Next
+     * frontend or a CDN.
+     */
+    revalidateTag?: RevalidateTagFn;
+}
+/** Which tags a hook drops, built from the scheme. */
+export type TagSelector = (cacheTags: CacheTags, slug: string) => readonly string[];
+export interface CollectionTagHookOptions {
+    /**
+     * The tags to drop. Default: the collection's own tag,
+     * `cacheTags.collection(slug)`. Use it to drop a tag a *different* reader
+     * owns — a navigation global that links to pages caches the pages' slugs:
+     *
+     * ```ts
+     * tags: (t, slug) => [t.collection(slug), t.global('navigation')]
+     * ```
+     */
+    tags?: TagSelector;
+    /**
+     * Which `afterChange` operations drop. Default: both. An upload collection
+     * can pass `['update']`: nothing can reference a document that did not exist
+     * a moment ago, so creating one makes no cached page untrue.
+     */
+    operations?: ReadonlyArray<'create' | 'update'>;
+}
+export interface GlobalTagHookOptions {
+    /** The tags to drop. Default: the global's own tag, `cacheTags.global(slug)`. */
+    tags?: TagSelector;
+}
+export interface TagRevalidationHooks {
+    /** `afterChange` for a collection. Skips draft writes. */
+    afterCollectionChange(options?: CollectionTagHookOptions): CollectionAfterChangeHook;
+    /** `afterDelete` for a collection. */
+    afterCollectionDelete(options?: Pick<CollectionTagHookOptions, 'tags'>): CollectionAfterDeleteHook;
+    /** `afterChange` for a global. */
+    afterGlobalChange(options?: GlobalTagHookOptions): GlobalAfterChangeHook;
+}
+/**
+ * Builds the tag-revalidation hooks for one tag scheme.
+ *
+ * ```ts
+ * import { createTagRevalidationHooks } from '@forumone/throughline-workflows'
+ * import { cacheTags } from './lib/cache-tags'
+ *
+ * const revalidation = createTagRevalidationHooks({ cacheTags })
+ *
+ * const Pages: CollectionConfig = {
+ *   slug: 'pages',
+ *   hooks: {
+ *     afterChange: [revalidation.afterCollectionChange()],
+ *     afterDelete: [revalidation.afterCollectionDelete()],
+ *   },
+ *   ...
+ * }
+ * const Navigation: GlobalConfig = {
+ *   slug: 'navigation',
+ *   hooks: { afterChange: [revalidation.afterGlobalChange()] },
+ *   ...
+ * }
+ * ```
+ *
+ * A hook never throws. Failing it would roll back the editor's save over a
+ * cache miss. A failure is logged at `error` instead, and the one expected
+ * failure — running outside a Next request, as seeds, migrations and the CLI
+ * do — at `debug`.
+ */
+export declare function createTagRevalidationHooks(options?: TagRevalidationOptions): TagRevalidationHooks;
+//# sourceMappingURL=revalidate-tag-hooks.d.ts.map

package/dist/revalidate-tag-hooks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"revalidate-tag-hooks.d.ts","sourceRoot":"","sources":["../src/revalidate-tag-hooks.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,yBAAyB,EACzB,yBAAyB,EACzB,qBAAqB,EAEtB,MAAM,SAAS,CAAA;AAEhB,OAAO,EAAE,KAAK,SAAS,EAAoB,MAAM,iBAAiB,CAAA;AAgBlE,0DAA0D;AAC1D,MAAM,MAAM,eAAe,GAAG,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;AAEnE,MAAM,WAAW,sBAAsB;IACrC;;;OAGG;IACH,SAAS,CAAC,EAAE,SAAS,CAAA;IACrB;;;;OAIG;IACH,aAAa,CAAC,EAAE,eAAe,CAAA;CAChC;AAED,sDAAsD;AACtD,MAAM,MAAM,WAAW,GAAG,CAAC,SAAS,EAAE,SAAS,EAAE,IAAI,EAAE,MAAM,KAAK,SAAS,MAAM,EAAE,CAAA;AAEnF,MAAM,WAAW,wBAAwB;IACvC;;;;;;;;OAQG;IACH,IAAI,CAAC,EAAE,WAAW,CAAA;IAClB;;;;OAIG;IACH,UAAU,CAAC,EAAE,aAAa,CAAC,QAAQ,GAAG,QAAQ,CAAC,CAAA;CAChD;AAED,MAAM,WAAW,oBAAoB;IACnC,iFAAiF;IACjF,IAAI,CAAC,EAAE,WAAW,CAAA;CACnB;AAED,MAAM,WAAW,oBAAoB;IACnC,0DAA0D;IAC1D,qBAAqB,CAAC,OAAO,CAAC,EAAE,wBAAwB,GAAG,yBAAyB,CAAA;IACpF,sCAAsC;IACtC,qBAAqB,CAAC,OAAO,CAAC,EAAE,IAAI,CAAC,wBAAwB,EAAE,MAAM,CAAC,GAAG,yBAAyB,CAAA;IAClG,kCAAkC;IAClC,iBAAiB,CAAC,OAAO,CAAC,EAAE,oBAAoB,GAAG,qBAAqB,CAAA;CACzE;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,wBAAgB,0BAA0B,CACxC,OAAO,GAAE,sBAA2B,GACnC,oBAAoB,CA2DtB"}

package/dist/revalidate-tag-hooks.js

@@ -0,0 +1,116 @@
+import { isDraftWrite } from '@forumone/throughline-publishing';
+import { defaultCacheTags } from './cache-tags.js';
+import { IMMEDIATE, isOutsideNextRequest, loadNextCache } from './next-revalidate.js';
+/**
+ * Builds the tag-revalidation hooks for one tag scheme.
+ *
+ * ```ts
+ * import { createTagRevalidationHooks } from '@forumone/throughline-workflows'
+ * import { cacheTags } from './lib/cache-tags'
+ *
+ * const revalidation = createTagRevalidationHooks({ cacheTags })
+ *
+ * const Pages: CollectionConfig = {
+ *   slug: 'pages',
+ *   hooks: {
+ *     afterChange: [revalidation.afterCollectionChange()],
+ *     afterDelete: [revalidation.afterCollectionDelete()],
+ *   },
+ *   ...
+ * }
+ * const Navigation: GlobalConfig = {
+ *   slug: 'navigation',
+ *   hooks: { afterChange: [revalidation.afterGlobalChange()] },
+ *   ...
+ * }
+ * ```
+ *
+ * A hook never throws. Failing it would roll back the editor's save over a
+ * cache miss. A failure is logged at `error` instead, and the one expected
+ * failure — running outside a Next request, as seeds, migrations and the CLI
+ * do — at `debug`.
+ */
+export function createTagRevalidationHooks(options = {}) {
+    const cacheTags = options.cacheTags ?? defaultCacheTags;
+    const revalidateTag = options.revalidateTag ?? nextRevalidateTag;
+    async function drop(tags, req) {
+        for (const tag of new Set(tags)) {
+            try {
+                await revalidateTag(tag);
+            }
+            catch (error) {
+                /*
+                Outside Next there is no server to be stale, so that one is noise.
+                Anything else means the cache did *not* clear while a server was
+                running — a real fault, so it is logged loudly. It is still not
+                thrown: an `afterChange` that throws fails the editor's save.
+                */
+                if (isOutsideNextRequest(error)) {
+                    req.payload.logger.debug({ tag }, 'Skipped cache revalidation: not inside a Next request.');
+                }
+                else {
+                    req.payload.logger.error({ err: error, tag }, 'Failed to revalidate a cache tag; the cached copy is stale.');
+                }
+            }
+        }
+    }
+    return {
+        afterCollectionChange(hookOptions = {}) {
+            const select = hookOptions.tags ?? ((t, slug) => [t.collection(slug)]);
+            const operations = new Set(hookOptions.operations ?? ['create', 'update']);
+            return async ({ collection, doc, operation, req }) => {
+                if (!operations.has(operation))
+                    return doc;
+                if (isUnpublishedWrite(req, collection.slug, doc, operation))
+                    return doc;
+                await drop(select(cacheTags, collection.slug), req);
+                return doc;
+            };
+        },
+        afterCollectionDelete(hookOptions = {}) {
+            const select = hookOptions.tags ?? ((t, slug) => [t.collection(slug)]);
+            return async ({ collection, doc, req }) => {
+                await drop(select(cacheTags, collection.slug), req);
+                return doc;
+            };
+        },
+        afterGlobalChange(hookOptions = {}) {
+            const select = hookOptions.tags ?? ((t, slug) => [t.global(slug)]);
+            return async ({ doc, global, req }) => {
+                await drop(select(cacheTags, global.slug), req);
+                return doc;
+            };
+        },
+    };
+}
+/*
+A write the public cannot see changes nothing cached, so there is nothing to
+drop — and with autosave on, "a draft save" is every few seconds of an open
+editor. Without this, one editing session evicts the tag over and over and every
+request in between pays a cold read for content that did not change.
+
+`isDraftWrite` is publishing's own predicate, the one its trust boundary uses.
+An `afterChange` hook cannot answer this for itself: Payload sets
+`data._status = 'draft'` on any `draft: true` update before hooks run, and
+`previousDoc` is the latest *version*, so a draft save of a published document
+and an unpublish of it look the same from in here. The publishing plugin records
+the operation's real `draft` argument in `beforeOperation`. That is recorded for
+the collections the plugin manages; on any other collection `isDraftWrite` is
+false and the hook drops, which is the safe direction.
+
+An unpublish is not a draft write and still drops — it is the case that would
+otherwise leave a cached link pointing at a 404.
+
+A *create* that lands as a draft is unambiguous on its own: nothing published
+existed a moment ago, so nothing cached can be about it.
+*/
+function isUnpublishedWrite(req, collectionSlug, doc, operation) {
+    if (operation === 'create')
+        return doc?._status === 'draft';
+    return isDraftWrite(req, collectionSlug, doc?.id);
+}
+async function nextRevalidateTag(tag) {
+    const { revalidateTag } = await loadNextCache();
+    revalidateTag(tag, IMMEDIATE);
+}
+//# sourceMappingURL=revalidate-tag-hooks.js.map

package/dist/revalidate-tag-hooks.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"revalidate-tag-hooks.js","sourceRoot":"","sources":["../src/revalidate-tag-hooks.ts"],"names":[],"mappings":"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"}

package/dist/types.d.ts

@@ -1,5 +1,6 @@
 import type { Inngest } from 'inngest';
 import type { Payload } from 'payload';
+import type { CacheTags } from './cache-tags.js';
 /**
  * Common dependencies for workflow factories. Every factory takes an
  * Inngest client and a Payload instance — the workflows-as-factories shape
@@ -92,15 +93,30 @@ export interface RevalidateOnPublishOptions extends BaseWorkflowOptions {
      */
     revalidate?: RevalidateFn;
     /**
-     * Per-collection URL builders. Built-in defaults: pages → /slug
-     * (with `home` mapped to `/`), posts → /blog/slug. Other collections
-     * fall back to /<slug> unless you provide a builder.
+     * Per-collection URL builders: where a document of each collection is
+     * served, given its slug. Required, and there are no built-in entries —
+     * only the site knows its routes. A collection with no entry has its tags
+     * dropped and no path revalidated, and the run logs a warning.
+     *
+     * ```ts
+     * urlBuilders: {
+     *   pages: (slug) => (slug === 'home' ? '/' : `/${slug}`),
+     *   posts: (slug) => `/news/${slug}`,
+     * }
+     * ```
+     */
+    urlBuilders: Record<string, (slug: string) => string>;
+    /**
+     * The tag scheme, shared with readers and with
+     * `createTagRevalidationHooks`. A collection with no `collectionTags` entry
+     * drops `[cacheTags.collection(<collection>)]`. Default: `defaultCacheTags`,
+     * whose collection tag is the bare slug.
      */
-    urlBuilders?: Record<string, (slug: string) => string>;
+    cacheTags?: CacheTags;
     /**
-     * Per-collection cache tags. Defaults to `[<collection>]`. Multiple tags
-     * supported for collections that participate in shared listings (e.g.
-     * `programs` → `['programs', 'sitemap']`).
+     * Per-collection cache tags, overriding the scheme for that collection.
+     * Multiple tags supported for collections that participate in shared
+     * listings (e.g. `programs` → `['programs', 'sitemap']`).
      */
     collectionTags?: Record<string, string[]>;
     /**

package/dist/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}

package/dist/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAoEA;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,cAAc,CAC5B,OAA4B,EAC5B,kBAA2B;IAE3B,MAAM,WAAW,GAAG,OAAO,CAAC,WAAW,IAAI,kBAAkB,CAAA;IAE7D,OAAO;QACL,wEAAwE;QACxE,oEAAoE;QACpE,GAAG,CAAC,OAAO,CAAC,iBAAiB,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,OAAO,CAAC,iBAAiB,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC9E,GAAG,CAAC,WAAW,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KACtD,CAAA;AACH,CAAC"}
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAqEA;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,cAAc,CAC5B,OAA4B,EAC5B,kBAA2B;IAE3B,MAAM,WAAW,GAAG,OAAO,CAAC,WAAW,IAAI,kBAAkB,CAAA;IAE7D,OAAO;QACL,wEAAwE;QACxE,oEAAoE;QACpE,GAAG,CAAC,OAAO,CAAC,iBAAiB,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,OAAO,CAAC,iBAAiB,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC9E,GAAG,CAAC,WAAW,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KACtD,CAAA;AACH,CAAC"}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@forumone/throughline-workflows",
-  "version": "0.4.0",
-  "description": "Composable Inngest function factories for the Throughline framework — revalidation, scheduled publishing, approval expiration, audit fan-out, healthcheck.",
+  "version": "0.5.0",
+  "description": "Composable Inngest function factories and Payload cache-revalidation hooks for the Throughline framework — revalidation, scheduled publishing, approval expiration, audit fan-out, healthcheck.",
   "type": "module",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
@@ -9,6 +9,10 @@
     ".": {
       "types": "./dist/index.d.ts",
       "default": "./dist/index.js"
+    },
+    "./cache-tags": {
+      "types": "./dist/cache-tags.d.ts",
+      "default": "./dist/cache-tags.js"
     }
   },
   "files": [
@@ -38,7 +42,7 @@
   "peerDependencies": {
     "inngest": "^4.0.0",
     "next": ">=15.0.0",
-    "payload": "^3.0.0"
+    "payload": "^3.89.0"
   },
   "peerDependenciesMeta": {
     "next": {
@@ -46,7 +50,8 @@
     }
   },
   "dependencies": {
-    "@forumone/throughline-core": "0.9.1"
+    "@forumone/throughline-core": "0.10.0",
+    "@forumone/throughline-publishing": "0.11.0"
   },
   "devDependencies": {
     "@types/node": "^24.13.2",