@forumone/throughline 0.0.0 → 1.0.0-next.0

package/dist/publishing/jobs/execute-scheduled-publishes.js

@@ -0,0 +1,114 @@
+import { failureOptions } from '../../jobs/workflow-types.js';
+import { defineJob } from '../../jobs/define.js';
+import { jobPayload } from '../../jobs/options.js';
+const DEFAULT_SCHEDULE = '*/5 * * * *';
+const REASONING = 'Scheduled publish executed by workflow cron';
+/**
+ * Cron-driven scheduled publish executor. Every tick (default: every 5
+ * minutes) the function looks for documents in any of the configured
+ * collections whose latest version is still a draft and whose
+ * `scheduledPublishAt` has passed, and calls `options.publish` for each.
+ *
+ * `publishAtScheduledTimeJob` does the same job on time and without
+ * polling. Run alongside it, this is the backstop — set `overdueByMs` and a
+ * slow schedule, and it only ever finds a document whose event went missing.
+ *
+ * `publish` must go through the publishing pipeline — see the option's own
+ * documentation for the wiring. That is what makes a scheduled publish get the
+ * same composition / accessibility / approval checks as an interactive one.
+ *
+ * A refusal is logged and does not throw; the document stays at
+ * `_status: draft` until an admin intervenes or a later tick succeeds.
+ * Throwing would retry indefinitely on a permanent error (a composition
+ * failure, say), which is wrong for cron-style work.
+ */
+export function executeScheduledPublishesJob(options) {
+    const schedule = options.schedule ?? DEFAULT_SCHEDULE;
+    return defineJob({
+        id: options.id ?? 'execute-scheduled-publishes',
+        /*
+        One at a time by default, because this reads then acts: `find-due-<slug>`
+        collects the documents whose scheduled time has passed, and the publish
+        loop runs after. Two overlapping runs both see the same due document and
+        both publish it — which for a pipeline that gates on approvals means two
+        audit trails for one act, and an `approval.granted` consumed twice.
+  
+        The cost of the cap is nil: the poll finds nothing on almost every tick,
+        and a run that does find something is the only one that needs to.
+        */
+        ...failureOptions(options, 1),
+        on: { cron: schedule },
+    }, async ({ step, logger, payload: contextPayload }) => {
+        const payload = jobPayload(options.payload, contextPayload, options.id ?? 'execute-scheduled-publishes');
+        const dueBy = new Date(Date.now() - (options.overdueByMs ?? 0)).toISOString();
+        let publishedCount = 0;
+        let blockedCount = 0;
+        for (const config of options.collections) {
+            const statusField = config.statusField ?? '_status';
+            const scheduledField = config.scheduledField ?? 'scheduledPublishAt';
+            const due = await step.run(`find-due-${config.slug}`, async () => {
+                const result = await payload.find({
+                    collection: config.slug,
+                    where: {
+                        and: [
+                            { [statusField]: { equals: 'draft' } },
+                            { [scheduledField]: { exists: true } },
+                            { [scheduledField]: { less_than_equal: dueBy } },
+                        ],
+                    },
+                    /*
+                    The latest version, not the main row. A schedule is set by a draft
+                    save, and Payload writes a draft save to the versions table alone —
+                    so without this the poll read a column that the admin never wrote,
+                    and only a schedule set over MCP, by a non-draft update, was ever
+                    found. It is also what lets a revision of a live document be
+                    scheduled: its latest version is a draft even while the main row
+                    says `published`.
+                    */
+                    draft: true,
+                    limit: 100,
+                });
+                return result.docs.map((doc) => ({
+                    id: String(doc['id']),
+                    title: String(doc['title'] ?? doc['id']),
+                    collection: config.slug,
+                }));
+            });
+            for (const doc of due) {
+                const outcome = await step.run(`publish-${config.slug}-${doc.id}`, async () => {
+                    let result;
+                    try {
+                        result = await options.publish({
+                            collection: doc.collection,
+                            id: doc.id,
+                            reasoning: REASONING,
+                        }, { payload });
+                    }
+                    catch (error) {
+                        logger.error('Scheduled publish threw', {
+                            document: doc.title,
+                            error: error instanceof Error ? error.message : String(error),
+                        });
+                        return 'error';
+                    }
+                    if (!result.published) {
+                        logger.warn('Scheduled publish blocked by policy', {
+                            document: doc.title,
+                            reason: result.reason,
+                        });
+                        return 'blocked';
+                    }
+                    logger.info('Scheduled publish succeeded', { document: doc.title });
+                    return 'published';
+                });
+                if (outcome === 'published')
+                    publishedCount += 1;
+                if (outcome === 'blocked')
+                    blockedCount += 1;
+            }
+        }
+        logger.info('Scheduled publish tick complete', { publishedCount, blockedCount });
+        return { publishedCount, blockedCount };
+    });
+}
+//# sourceMappingURL=execute-scheduled-publishes.js.map

package/dist/publishing/jobs/execute-scheduled-publishes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"execute-scheduled-publishes.js","sourceRoot":"","sources":["../../../src/publishing/jobs/execute-scheduled-publishes.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAA;AAC7D,OAAO,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAA;AAEhD,OAAO,EAAE,UAAU,EAAmB,MAAM,uBAAuB,CAAA;AAGnE,MAAM,gBAAgB,GAAG,aAAa,CAAA;AACtC,MAAM,SAAS,GAAG,6CAA6C,CAAA;AAQ/D;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,UAAU,4BAA4B,CAC1C,OAAqD;IAErD,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ,IAAI,gBAAgB,CAAA;IAErD,OAAO,SAAS,CACd;QACE,EAAE,EAAE,OAAO,CAAC,EAAE,IAAI,6BAA6B;QAC/C;;;;;;;;;UASE;QACF,GAAG,cAAc,CAAC,OAAO,EAAE,CAAC,CAAC;QAC7B,EAAE,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;KACvB,EACD,KAAK,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,cAAc,EAAE,EAAE,EAAE;QAClD,MAAM,OAAO,GAAG,UAAU,CACxB,OAAO,CAAC,OAAO,EACf,cAAc,EACd,OAAO,CAAC,EAAE,IAAI,6BAA6B,CAC5C,CAAA;QACD,MAAM,KAAK,GAAG,IAAI,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,CAAC,OAAO,CAAC,WAAW,IAAI,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,CAAA;QAC7E,IAAI,cAAc,GAAG,CAAC,CAAA;QACtB,IAAI,YAAY,GAAG,CAAC,CAAA;QAEpB,KAAK,MAAM,MAAM,IAAI,OAAO,CAAC,WAAW,EAAE,CAAC;YACzC,MAAM,WAAW,GAAG,MAAM,CAAC,WAAW,IAAI,SAAS,CAAA;YACnD,MAAM,cAAc,GAAG,MAAM,CAAC,cAAc,IAAI,oBAAoB,CAAA;YAEpE,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,GAAG,CAAC,YAAY,MAAM,CAAC,IAAI,EAAE,EAAE,KAAK,IAAuB,EAAE;gBAClF,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,IAAI,CAAC;oBAChC,UAAU,EAAE,MAAM,CAAC,IAAI;oBACvB,KAAK,EAAE;wBACL,GAAG,EAAE;4BACH,EAAE,CAAC,WAAW,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,EAAE;4BACtC,EAAE,CAAC,cAAc,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,EAAE;4BACtC,EAAE,CAAC,cAAc,CAAC,EAAE,EAAE,eAAe,EAAE,KAAK,EAAE,EAAE;yBACjD;qBACF;oBACD;;;;;;;;sBAQE;oBACF,KAAK,EAAE,IAAI;oBACX,KAAK,EAAE,GAAG;iBACX,CAAC,CAAA;gBACF,OAAQ,MAAM,CAAC,IAAuC,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;oBACnE,EAAE,EAAE,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;oBACrB,KAAK,EAAE,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,GAAG,CAAC,IAAI,CAAC,CAAC;oBACxC,UAAU,EAAE,MAAM,CAAC,IAAI;iBACxB,CAAC,CAAC,CAAA;YACL,CAAC,CAAC,CAAA;YAEF,KAAK,MAAM,GAAG,IAAI,GAAG,EAAE,CAAC;gBACtB,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,GAAG,CAC5B,WAAW,MAAM,CAAC,IAAI,IAAI,GAAG,CAAC,EAAE,EAAE,EAClC,KAAK,IAAgD,EAAE;oBACrD,IAAI,MAAM,CAAA;oBACV,IAAI,CAAC;wBACH,MAAM,GAAG,MAAM,OAAO,CAAC,OAAO,CAC5B;4BACE,UAAU,EAAE,GAAG,CAAC,UAAU;4BAC1B,EAAE,EAAE,GAAG,CAAC,EAAE;4BACV,SAAS,EAAE,SAAS;yBACrB,EACD,EAAE,OAAO,EAAE,CACZ,CAAA;oBACH,CAAC;oBAAC,OAAO,KAAK,EAAE,CAAC;wBACf,MAAM,CAAC,KAAK,CAAC,yBAAyB,EAAE;4BACtC,QAAQ,EAAE,GAAG,CAAC,KAAK;4BACnB,KAAK,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC;yBAC9D,CAAC,CAAA;wBACF,OAAO,OAAO,CAAA;oBAChB,CAAC;oBAED,IAAI,CAAC,MAAM,CAAC,SAAS,EAAE,CAAC;wBACtB,MAAM,CAAC,IAAI,CAAC,qCAAqC,EAAE;4BACjD,QAAQ,EAAE,GAAG,CAAC,KAAK;4BACnB,MAAM,EAAE,MAAM,CAAC,MAAM;yBACtB,CAAC,CAAA;wBACF,OAAO,SAAS,CAAA;oBAClB,CAAC;oBAED,MAAM,CAAC,IAAI,CAAC,6BAA6B,EAAE,EAAE,QAAQ,EAAE,GAAG,CAAC,KAAK,EAAE,CAAC,CAAA;oBACnE,OAAO,WAAW,CAAA;gBACpB,CAAC,CACF,CAAA;gBACD,IAAI,OAAO,KAAK,WAAW;oBAAE,cAAc,IAAI,CAAC,CAAA;gBAChD,IAAI,OAAO,KAAK,SAAS;oBAAE,YAAY,IAAI,CAAC,CAAA;YAC9C,CAAC;QACH,CAAC;QAED,MAAM,CAAC,IAAI,CAAC,iCAAiC,EAAE,EAAE,cAAc,EAAE,YAAY,EAAE,CAAC,CAAA;QAChF,OAAO,EAAE,cAAc,EAAE,YAAY,EAAE,CAAA;IACzC,CAAC,CACF,CAAA;AACH,CAAC"}

package/dist/publishing/jobs/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/publishing/jobs/next-revalidate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"next-revalidate.d.ts","sourceRoot":"","sources":["../../../src/publishing/jobs/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/publishing/jobs/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/publishing/jobs/next-revalidate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"next-revalidate.js","sourceRoot":"","sources":["../../../src/publishing/jobs/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/publishing/jobs/publish-at-scheduled-time.d.ts

@@ -0,0 +1,24 @@
+import type { Job } from '../../jobs/types.js';
+import { type JobOptions } from '../../jobs/options.js';
+import type { PublishAtScheduledTimeOptions } from '../../jobs/workflow-types.js';
+/**
+ * Publishes a document at the moment it was scheduled for, by sleeping until
+ * then — rather than polling for due documents.
+ *
+ * Triggered by `content/page.scheduled`, which the publishing plugin sends
+ * whenever a document's scheduled time changes to a new value. The event is a
+ * wake-up call and nothing more: **the document is the source of truth.** On
+ * waking, the run re-reads the document's latest version and publishes only if
+ * it still carries this exact time. So a reschedule, a cancellation, a manual
+ * publish in the meantime or an unpublish — each of which changes or clears
+ * the field — leaves the old run to wake, find nothing to do, and end. No
+ * cancellation event has to arrive for that to be correct, and a duplicate
+ * event cannot publish twice (the `idempotency` key drops the second anyway).
+ *
+ * `publish` must go through the publishing pipeline, exactly as for
+ * `executeScheduledPublishesJob`: a scheduled publish gets the same
+ * composition / accessibility / approval checks as an interactive one, and a
+ * refusal is logged, not retried.
+ */
+export declare function publishAtScheduledTimeJob(options: JobOptions<PublishAtScheduledTimeOptions>): Job;
+//# sourceMappingURL=publish-at-scheduled-time.d.ts.map

package/dist/publishing/jobs/publish-at-scheduled-time.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"publish-at-scheduled-time.d.ts","sourceRoot":"","sources":["../../../src/publishing/jobs/publish-at-scheduled-time.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,qBAAqB,CAAA;AAC9C,OAAO,EAAc,KAAK,UAAU,EAAE,MAAM,uBAAuB,CAAA;AACnE,OAAO,KAAK,EACV,6BAA6B,EAE9B,MAAM,8BAA8B,CAAA;AA8BrC;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,yBAAyB,CAAC,OAAO,EAAE,UAAU,CAAC,6BAA6B,CAAC,GAAG,GAAG,CAoGjG"}

package/dist/publishing/jobs/publish-at-scheduled-time.js

@@ -0,0 +1,136 @@
+import { failureOptions } from '../../jobs/workflow-types.js';
+import { defineJob } from '../../jobs/define.js';
+import { jobPayload } from '../../jobs/options.js';
+const SCHEDULED_EVENT = 'content/page.scheduled';
+const REASONING = 'Scheduled publish executed at its scheduled time';
+/*
+Six days, under the seven Inngest's free plan allows a single sleep.
+
+A schedule further out than one hop is carried by a relay: the run sleeps a
+hop, then re-sends the event and ends, so each leg is its own run. That also
+keeps every run far inside the free plan's thirty-day run duration, which a
+loop of sleeps inside one run would not — a post scheduled for next quarter
+would simply be killed.
+*/
+const DEFAULT_MAX_SLEEP_MS = 6 * 24 * 60 * 60 * 1000;
+/**
+ * Publishes a document at the moment it was scheduled for, by sleeping until
+ * then — rather than polling for due documents.
+ *
+ * Triggered by `content/page.scheduled`, which the publishing plugin sends
+ * whenever a document's scheduled time changes to a new value. The event is a
+ * wake-up call and nothing more: **the document is the source of truth.** On
+ * waking, the run re-reads the document's latest version and publishes only if
+ * it still carries this exact time. So a reschedule, a cancellation, a manual
+ * publish in the meantime or an unpublish — each of which changes or clears
+ * the field — leaves the old run to wake, find nothing to do, and end. No
+ * cancellation event has to arrive for that to be correct, and a duplicate
+ * event cannot publish twice (the `idempotency` key drops the second anyway).
+ *
+ * `publish` must go through the publishing pipeline, exactly as for
+ * `executeScheduledPublishesJob`: a scheduled publish gets the same
+ * composition / accessibility / approval checks as an interactive one, and a
+ * refusal is logged, not retried.
+ */
+export function publishAtScheduledTimeJob(options) {
+    const maxSleepMs = options.maxSleepMs ?? DEFAULT_MAX_SLEEP_MS;
+    const collections = new Map(options.collections.map((c) => [c.slug, c]));
+    return defineJob({
+        id: options.id ?? 'publish-at-scheduled-time',
+        /*
+        One run per schedule. The plugin sends once per change, but an MCP
+        schedule and the field hook seeing the same write, or a retried send,
+        would otherwise start two sleepers that both wake and both publish.
+        Inngest keeps this key for 24 hours, and a relay is six days after the
+        event that started its leg, so a relay is never mistaken for a duplicate.
+        */
+        idempotency: { fields: ['collection', 'id', 'scheduledFor'] },
+        ...failureOptions(options),
+        on: { event: SCHEDULED_EVENT },
+    }, async ({ event, step, logger, payload: contextPayload }) => {
+        const payload = jobPayload(options.payload, contextPayload, options.id ?? 'publish-at-scheduled-time');
+        const data = event.data;
+        const config = data.collection ? collections.get(data.collection) : undefined;
+        const target = typeof data.scheduledFor === 'string' ? Date.parse(data.scheduledFor) : NaN;
+        if (!config || !data.id || !data.scheduledFor || Number.isNaN(target)) {
+            return { outcome: 'ignored', reason: 'not a scheduled publish this function handles' };
+        }
+        const request = { collection: config.slug, id: data.id, scheduledFor: data.scheduledFor };
+        /*
+        Measured from the event's own timestamp, not the clock. Inngest replays
+        the handler from the top after every step, so a `Date.now()` here would
+        give a different answer on each replay — and flipping from the relay
+        branch to the direct branch halfway through a run is a run whose steps
+        no longer match its history.
+        */
+        const startedAt = typeof event.ts === 'number' ? event.ts : Date.now();
+        if (target - startedAt > maxSleepMs) {
+            const hopUntil = new Date(startedAt + maxSleepMs);
+            await step.sleepUntil('wait-one-hop', hopUntil);
+            // Only relay a schedule that still stands, or a cancelled one would
+            // keep re-sending itself every six days until its date came round.
+            const current = await step.run('check-still-scheduled', () => isStillScheduled({ payload }, config, request));
+            if (!current)
+                return { outcome: 'superseded' };
+            await step.sendEvent('relay', { name: SCHEDULED_EVENT, data: request });
+            return { outcome: 'relayed', hopUntil: hopUntil.toISOString() };
+        }
+        await step.sleepUntil('wait-until-due', new Date(target));
+        const due = await step.run('check-still-scheduled', () => isStillScheduled({ payload }, config, request));
+        if (!due) {
+            logger.info('Scheduled publish superseded', request);
+            return { outcome: 'superseded' };
+        }
+        return step.run('publish', async () => {
+            try {
+                const result = await options.publish({
+                    collection: config.slug,
+                    id: request.id,
+                    reasoning: REASONING,
+                }, { payload });
+                if (!result.published) {
+                    logger.warn('Scheduled publish blocked by policy', {
+                        ...request,
+                        reason: result.reason,
+                    });
+                    return { outcome: 'blocked', reason: result.reason };
+                }
+                logger.info('Scheduled publish succeeded', request);
+                return { outcome: 'published' };
+            }
+            catch (error) {
+                /*
+                Not rethrown. A retry would re-run the pipeline against the same
+                document, and the daily backstop in
+                `executeScheduledPublishesJob` already comes back for a
+                document that is still a draft past its time.
+                */
+                const reason = error instanceof Error ? error.message : String(error);
+                logger.error('Scheduled publish threw', { ...request, error: reason });
+                return { outcome: 'error', reason };
+            }
+        });
+    });
+}
+/**
+ * Whether the document's latest version still carries this schedule.
+ *
+ * `draft: true`, because a schedule is written by a draft save and Payload
+ * writes a draft save to the versions table only — the main row is not
+ * touched, so a read without it would see a document with no schedule at all.
+ */
+async function isStillScheduled(options, config, request) {
+    const field = config.scheduledField ?? 'scheduledPublishAt';
+    const doc = (await options.payload.findByID({
+        collection: config.slug,
+        id: request.id,
+        draft: true,
+        depth: 0,
+        disableErrors: true,
+    }));
+    const value = doc?.[field];
+    if (typeof value !== 'string')
+        return false;
+    return Date.parse(value) === Date.parse(request.scheduledFor);
+}
+//# sourceMappingURL=publish-at-scheduled-time.js.map

package/dist/publishing/jobs/publish-at-scheduled-time.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"publish-at-scheduled-time.js","sourceRoot":"","sources":["../../../src/publishing/jobs/publish-at-scheduled-time.ts"],"names":[],"mappings":"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"}

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

@@ -0,0 +1,24 @@
+import type { JobOptions } from '../../jobs/options.js';
+import type { Job } from '../../jobs/types.js';
+import type { RevalidateOnPublishOptions } from '../../jobs/workflow-types.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 declare function revalidateOnPublishJob(options: JobOptions<RevalidateOnPublishOptions>): Job;
+//# sourceMappingURL=revalidate-on-publish.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"revalidate-on-publish.d.ts","sourceRoot":"","sources":["../../../src/publishing/jobs/revalidate-on-publish.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAA;AACvD,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,qBAAqB,CAAA;AAG9C,OAAO,KAAK,EAEV,0BAA0B,EAE3B,MAAM,8BAA8B,CAAA;AAErC;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,UAAU,CAAC,0BAA0B,CAAC,GAAG,GAAG,CAmD3F"}

package/dist/publishing/jobs/revalidate-on-publish.js

@@ -0,0 +1,78 @@
+import { failureOptions } from '../../jobs/workflow-types.js';
+import { defineJob } from '../../jobs/define.js';
+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 revalidateOnPublishJob(options) {
+    const urlBuilders = options.urlBuilders;
+    const cacheTags = options.cacheTags ?? defaultCacheTags;
+    const collectionTags = options.collectionTags ?? {};
+    const revalidate = options.revalidate ?? defaultRevalidate;
+    return defineJob({
+        id: options.id ?? 'revalidate-on-publish',
+        retries: 5,
+        /*
+        No default cap. This is event-driven and idempotent — it drops cache tags
+        and revalidates paths, and doing that twice is the same as doing it once —
+        so two publishes landing together should not queue behind each other.
+        */
+        ...failureOptions(options),
+        on: {
+            event: ['content/page.published', 'content/page.unpublished', 'content/page.rolled_back'],
+        },
+    }, async ({ event, step, logger }) => {
+        const data = (event.data ?? {});
+        const collection = data.collection ?? 'pages';
+        const slug = data.slug ?? data.id ?? '';
+        const tags = collectionTags[collection] ?? [cacheTags.collection(collection)];
+        await step.run('revalidate-page-path', async () => {
+            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 revalidateOnPublishJob.', { collection, slug });
+                return;
+            }
+            const path = builder(slug);
+            await revalidate({ path, tags });
+            logger.info('Revalidated page path', { path, tags });
+        });
+        await step.run('revalidate-listings', async () => {
+            await revalidate({ path: '', tags });
+        });
+        await step.run('revalidate-sitemap', async () => {
+            await revalidate({ path: '/sitemap.xml', tags: ['sitemap'] });
+        });
+        return { collection, slug, revalidated: true };
+    });
+}
+/**
+ * Default revalidator: dynamic-imports `next/cache` so the package can be
+ * imported in environments without Next.js (e.g. test runners that don't
+ * stub the module). Calls `revalidatePath` only when `path` is non-empty
+ * because `revalidatePath('')` triggers a noisy Next.js warning.
+ */
+const defaultRevalidate = async ({ path, tags }) => {
+    const { revalidatePath, revalidateTag } = await loadNextCache();
+    if (path)
+        revalidatePath(path);
+    for (const tag of tags)
+        revalidateTag(tag, IMMEDIATE);
+};
+//# sourceMappingURL=revalidate-on-publish.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"revalidate-on-publish.js","sourceRoot":"","sources":["../../../src/publishing/jobs/revalidate-on-publish.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAA;AAC7D,OAAO,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAA;AAGhD,OAAO,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAA;AACtD,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAA;AAO/D;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,UAAU,sBAAsB,CAAC,OAA+C;IACpF,MAAM,WAAW,GAAG,OAAO,CAAC,WAAW,CAAA;IACvC,MAAM,SAAS,GAAG,OAAO,CAAC,SAAS,IAAI,gBAAgB,CAAA;IACvD,MAAM,cAAc,GAAG,OAAO,CAAC,cAAc,IAAI,EAAE,CAAA;IACnD,MAAM,UAAU,GAAG,OAAO,CAAC,UAAU,IAAI,iBAAiB,CAAA;IAE1D,OAAO,SAAS,CACd;QACE,EAAE,EAAE,OAAO,CAAC,EAAE,IAAI,uBAAuB;QACzC,OAAO,EAAE,CAAC;QACV;;;;UAIE;QACF,GAAG,cAAc,CAAC,OAAO,CAAC;QAC1B,EAAE,EAAE;YACF,KAAK,EAAE,CAAC,wBAAwB,EAAE,0BAA0B,EAAE,0BAA0B,CAAC;SAC1F;KACF,EACD,KAAK,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE;QAChC,MAAM,IAAI,GAAG,CAAC,KAAK,CAAC,IAAI,IAAI,EAAE,CAAwD,CAAA;QACtF,MAAM,UAAU,GAAG,IAAI,CAAC,UAAU,IAAI,OAAO,CAAA;QAC7C,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,EAAE,IAAI,EAAE,CAAA;QACvC,MAAM,IAAI,GAAG,cAAc,CAAC,UAAU,CAAC,IAAI,CAAC,SAAS,CAAC,UAAU,CAAC,UAAU,CAAC,CAAC,CAAA;QAE7E,MAAM,IAAI,CAAC,GAAG,CAAC,sBAAsB,EAAE,KAAK,IAAI,EAAE;YAChD,MAAM,OAAO,GAAG,MAAM,CAAC,MAAM,CAAC,WAAW,EAAE,UAAU,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,SAAS,CAAA;YAC5F,IAAI,CAAC,OAAO,EAAE,CAAC;gBACb,MAAM,CAAC,IAAI,CACT,+GAA+G,EAC/G,EAAE,UAAU,EAAE,IAAI,EAAE,CACrB,CAAA;gBACD,OAAM;YACR,CAAC;YACD,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;YAC1B,MAAM,UAAU,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAA;YAChC,MAAM,CAAC,IAAI,CAAC,uBAAuB,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAA;QACtD,CAAC,CAAC,CAAA;QAEF,MAAM,IAAI,CAAC,GAAG,CAAC,qBAAqB,EAAE,KAAK,IAAI,EAAE;YAC/C,MAAM,UAAU,CAAC,EAAE,IAAI,EAAE,EAAE,EAAE,IAAI,EAAE,CAAC,CAAA;QACtC,CAAC,CAAC,CAAA;QAEF,MAAM,IAAI,CAAC,GAAG,CAAC,oBAAoB,EAAE,KAAK,IAAI,EAAE;YAC9C,MAAM,UAAU,CAAC,EAAE,IAAI,EAAE,cAAc,EAAE,IAAI,EAAE,CAAC,SAAS,CAAC,EAAE,CAAC,CAAA;QAC/D,CAAC,CAAC,CAAA;QAEF,OAAO,EAAE,UAAU,EAAE,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,CAAA;IAChD,CAAC,CACF,CAAA;AACH,CAAC;AAED;;;;;GAKG;AACH,MAAM,iBAAiB,GAAiB,KAAK,EAAE,EAAE,IAAI,EAAE,IAAI,EAAwB,EAAE,EAAE;IACrF,MAAM,EAAE,cAAc,EAAE,aAAa,EAAE,GAAG,MAAM,aAAa,EAAE,CAAA;IAC/D,IAAI,IAAI;QAAE,cAAc,CAAC,IAAI,CAAC,CAAA;IAC9B,KAAK,MAAM,GAAG,IAAI,IAAI;QAAE,aAAa,CAAC,GAAG,EAAE,SAAS,CAAC,CAAA;AACvD,CAAC,CAAA"}

package/dist/publishing/jobs/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/publishing'
+ * 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/publishing/jobs/revalidate-tag-hooks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"revalidate-tag-hooks.d.ts","sourceRoot":"","sources":["../../../src/publishing/jobs/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,qBAAqB,CAAA;AAgBtE,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"}