@forumone/throughline 0.0.0-stage → 1.0.0-next.0

package/dist/jobs/payload/adapter.d.ts

@@ -0,0 +1,33 @@
+import type { Plugin } from 'payload';
+import type { WorkflowFailureHandler } from '../workflow-types.js';
+import type { Job, JobEvent, JobsAdapter } from '../types.js';
+export interface PayloadJobsOptions {
+    /** The Payload queue every job runs on. Default `'throughline'`. */
+    queue?: string;
+    /** Every job's terminal-failure handler, unless the job declares its own. */
+    onFailure?: WorkflowFailureHandler;
+    /** How long an idempotency key holds. Default 24 hours, matching Inngest. */
+    idempotencyWindowMs?: number;
+}
+export interface PayloadJobsAdapter extends JobsAdapter {
+    readonly runner: 'payload';
+    /**
+     * The Payload plugin that registers `jobs` as workflows. Add it to the
+     * config's `plugins`; `emit` works once Payload has initialised.
+     */
+    plugin(jobs: readonly Job[]): Plugin;
+}
+/** Where idempotency keys are held. Added only when a job declares one. */
+export declare const JOB_KEYS_COLLECTION = "throughline-job-keys";
+/** A job's idempotency key for an event, as `inngestIdempotency` would key it. */
+export declare function payloadIdempotencyKey(job: Job, event: JobEvent): string | undefined;
+/**
+ * Run jobs on Payload's own queue.
+ *
+ * ```ts
+ * const jobs = payloadJobs({ onFailure: createTerminalFailureHandler({ payload }) })
+ * export default buildConfig({ plugins: [jobs.plugin(allJobs)], jobs: { autoRun: [{ cron: '* * * * *' }] } })
+ * ```
+ */
+export declare function payloadJobs(options?: PayloadJobsOptions): PayloadJobsAdapter;
+//# sourceMappingURL=adapter.d.ts.map

package/dist/jobs/payload/adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapter.d.ts","sourceRoot":"","sources":["../../../src/jobs/payload/adapter.ts"],"names":[],"mappings":"AAwCA,OAAO,KAAK,EAAmB,MAAM,EAAE,MAAM,SAAS,CAAA;AACtD,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,sBAAsB,CAAA;AAElE,OAAO,KAAK,EACV,GAAG,EAEH,QAAQ,EAER,WAAW,EAEZ,MAAM,aAAa,CAAA;AAEpB,MAAM,WAAW,kBAAkB;IACjC,oEAAoE;IACpE,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,6EAA6E;IAC7E,SAAS,CAAC,EAAE,sBAAsB,CAAA;IAClC,6EAA6E;IAC7E,mBAAmB,CAAC,EAAE,MAAM,CAAA;CAC7B;AAED,MAAM,WAAW,kBAAmB,SAAQ,WAAW;IACrD,QAAQ,CAAC,MAAM,EAAE,SAAS,CAAA;IAC1B;;;OAGG;IACH,MAAM,CAAC,IAAI,EAAE,SAAS,GAAG,EAAE,GAAG,MAAM,CAAA;CACrC;AAYD,2EAA2E;AAC3E,eAAO,MAAM,mBAAmB,yBAAyB,CAAA;AAsBzD,kFAAkF;AAClF,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,GAAG,EAAE,KAAK,EAAE,QAAQ,GAAG,MAAM,GAAG,SAAS,CAcnF;AAED;;;;;;;GAOG;AACH,wBAAgB,WAAW,CAAC,OAAO,GAAE,kBAAuB,GAAG,kBAAkB,CAqNhF"}

package/dist/jobs/payload/adapter.js

@@ -0,0 +1,257 @@
+import { jobEvents } from '../inngest/adapter.js';
+const DAY_MS = 24 * 60 * 60 * 1000;
+/** Where idempotency keys are held. Added only when a job declares one. */
+export const JOB_KEYS_COLLECTION = 'throughline-job-keys';
+const SLEPT = 'slept';
+/** Thrown by `step.sleepUntil` to end this job once its continuation is queued. */
+class SleepingUntil extends Error {
+    constructor() {
+        super('Sleeping until a continuation runs.');
+        this.name = 'SleepingUntil';
+    }
+}
+/** Payload's logger is pino, which takes the context first. */
+function jobLogger(payload) {
+    const log = payload.logger;
+    return {
+        debug: (message, context) => log.debug(context ?? {}, message),
+        info: (message, context) => log.info(context ?? {}, message),
+        warn: (message, context) => log.warn(context ?? {}, message),
+        error: (message, context) => log.error(context ?? {}, message),
+    };
+}
+/** A job's idempotency key for an event, as `inngestIdempotency` would key it. */
+export function payloadIdempotencyKey(job, event) {
+    if (!job.idempotency)
+        return undefined;
+    const data = (event.data ?? {});
+    const values = job.idempotency.fields.map((field) => String(field
+        .split('.')
+        .reduce((value, key) => value?.[key], data)));
+    return `${job.id}:${values.join(job.idempotency.separator ?? ':')}`;
+}
+/**
+ * Run jobs on Payload's own queue.
+ *
+ * ```ts
+ * const jobs = payloadJobs({ onFailure: createTerminalFailureHandler({ payload }) })
+ * export default buildConfig({ plugins: [jobs.plugin(allJobs)], jobs: { autoRun: [{ cron: '* * * * *' }] } })
+ * ```
+ */
+export function payloadJobs(options = {}) {
+    const queue = options.queue ?? 'throughline';
+    const windowMs = options.idempotencyWindowMs ?? DAY_MS;
+    let registered = [];
+    let payloadRef;
+    const requirePayload = () => {
+        if (!payloadRef)
+            throw new Error('payloadJobs: emit() was called before Payload initialised.');
+        return payloadRef;
+    };
+    /**
+     * Claim a key for the window. False when it is already held: the unique
+     * index makes two concurrent claims of one key resolve to one winner.
+     */
+    async function claim(payload, key) {
+        const collection = JOB_KEYS_COLLECTION;
+        const { docs } = await payload.find({
+            collection,
+            where: { key: { equals: key } },
+            limit: 1,
+            depth: 0,
+            overrideAccess: true,
+        });
+        const held = docs[0];
+        if (held) {
+            if (held.expiresAt && Date.parse(held.expiresAt) > Date.now())
+                return false;
+            await payload.delete({ collection, id: held.id, overrideAccess: true });
+        }
+        try {
+            await payload.create({
+                collection,
+                data: { key, expiresAt: new Date(Date.now() + windowMs).toISOString() },
+                overrideAccess: true,
+            });
+            return true;
+        }
+        catch {
+            // Another emit claimed it between the read and the write.
+            return false;
+        }
+    }
+    async function emit(event) {
+        const payload = requirePayload();
+        const events = Array.isArray(event) ? event : [event];
+        for (const sent of events) {
+            const received = { name: sent.name, data: sent.data, ts: Date.now() };
+            for (const job of registered) {
+                if (!jobEvents(job).includes(sent.name))
+                    continue;
+                const idempotencyKey = payloadIdempotencyKey(job, sent);
+                if (idempotencyKey && !(await claim(payload, idempotencyKey)))
+                    continue;
+                await payload.jobs.queue({
+                    workflow: job.id,
+                    queue,
+                    input: { event: received, ...(idempotencyKey ? { idempotencyKey } : {}) },
+                    overrideAccess: true,
+                });
+            }
+        }
+    }
+    function workflowFor(job) {
+        const onFailure = job.onFailure ?? options.onFailure;
+        const retries = job.retries ?? 3;
+        return {
+            slug: job.id,
+            queue,
+            retries,
+            ...('cron' in job.on ? { schedule: [{ cron: job.on.cron, queue }] } : {}),
+            ...(job.concurrency !== undefined
+                ? { concurrency: { key: () => job.id, exclusive: true } }
+                : {}),
+            handler: async ({ job: running, inlineTask, req }) => {
+                const input = (running.input ?? {});
+                const steps = { ...input.steps };
+                const event = input.event ?? {
+                    name: 'cron',
+                    data: {},
+                    ts: Date.parse(running.createdAt),
+                };
+                const run = async (id, fn) => {
+                    if (Object.hasOwn(steps, id))
+                        return steps[id];
+                    const output = (await inlineTask(id, {
+                        task: async () => ({ output: { value: await fn() } }),
+                    }));
+                    steps[id] = output.value;
+                    return output.value;
+                };
+                const context = {
+                    event,
+                    runId: String(running.id),
+                    logger: jobLogger(req.payload),
+                    emit,
+                    payload: req.payload,
+                    step: {
+                        run,
+                        sleepUntil: async (id, until) => {
+                            const key = `sleep:${id}`;
+                            if (steps[key] === SLEPT)
+                                return;
+                            if (until.getTime() <= Date.now()) {
+                                steps[key] = SLEPT;
+                                return;
+                            }
+                            await inlineTask(key, {
+                                task: async () => {
+                                    await req.payload.jobs.queue({
+                                        workflow: job.id,
+                                        queue,
+                                        waitUntil: until,
+                                        input: { ...input, steps: { ...steps, [key]: SLEPT } },
+                                        overrideAccess: true,
+                                    });
+                                    return { output: {} };
+                                },
+                            });
+                            throw new SleepingUntil();
+                        },
+                        sendEvent: async (id, sent) => {
+                            await run(`send:${id}`, async () => {
+                                await emit(sent);
+                                return true;
+                            });
+                        },
+                    },
+                };
+                try {
+                    await job.handler(context);
+                }
+                catch (error) {
+                    if (error instanceof SleepingUntil)
+                        return;
+                    // Payload marks the failure final once totalTried reaches retries;
+                    // this attempt is counted after it fails, hence the + 1.
+                    const final = (running.totalTried ?? 0) + 1 > retries;
+                    if (final && onFailure) {
+                        try {
+                            await onFailure({
+                                error: error instanceof Error ? error : new Error(String(error)),
+                                event: {
+                                    data: {
+                                        function_id: job.id,
+                                        run_id: String(running.id),
+                                        event: { name: event.name },
+                                    },
+                                },
+                            });
+                        }
+                        catch {
+                            // A failure handler that throws must not mask the failure itself.
+                        }
+                    }
+                    throw error;
+                }
+            },
+        };
+    }
+    return {
+        runner: 'payload',
+        emit,
+        plugin: (jobs) => {
+            const seen = new Set();
+            for (const job of jobs) {
+                if (seen.has(job.id))
+                    throw new Error(`Two jobs share the id "${job.id}".`);
+                seen.add(job.id);
+            }
+            registered = jobs;
+            const keys = jobs.some((job) => job.idempotency);
+            return (incoming) => ({
+                ...incoming,
+                collections: [
+                    ...(incoming.collections ?? []),
+                    ...(keys
+                        ? [
+                            {
+                                slug: JOB_KEYS_COLLECTION,
+                                admin: { hidden: true },
+                                // Written and read only here, with overrideAccess.
+                                access: {
+                                    read: () => false,
+                                    create: () => false,
+                                    update: () => false,
+                                    delete: () => false,
+                                },
+                                fields: [
+                                    {
+                                        name: 'key',
+                                        type: 'text',
+                                        required: true,
+                                        unique: true,
+                                        index: true,
+                                    },
+                                    { name: 'expiresAt', type: 'date', required: true, index: true },
+                                ],
+                            },
+                        ]
+                        : []),
+                ],
+                jobs: {
+                    ...incoming.jobs,
+                    ...(jobs.some((job) => job.concurrency !== undefined)
+                        ? { enableConcurrencyControl: true }
+                        : {}),
+                    workflows: [...(incoming.jobs?.workflows ?? []), ...jobs.map(workflowFor)],
+                },
+                onInit: async (payload) => {
+                    await incoming.onInit?.(payload);
+                    payloadRef = payload;
+                },
+            });
+        },
+    };
+}
+//# sourceMappingURL=adapter.js.map

package/dist/jobs/payload/adapter.js.map

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

package/dist/jobs/payload/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * `@forumone/throughline/jobs/payload`: jobs on Payload's own queue. On Vercel
+ * it needs a per-minute cron calling Payload's run endpoint; elsewhere it runs
+ * with `autoRun`.
+ */
+export { JOB_KEYS_COLLECTION, payloadIdempotencyKey, payloadJobs } from './adapter.js';
+export type { PayloadJobsAdapter, PayloadJobsOptions } from './adapter.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/jobs/payload/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/jobs/payload/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAAE,mBAAmB,EAAE,qBAAqB,EAAE,WAAW,EAAE,MAAM,cAAc,CAAA;AACtF,YAAY,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAA"}

package/dist/jobs/payload/index.js

@@ -0,0 +1,7 @@
+/**
+ * `@forumone/throughline/jobs/payload`: jobs on Payload's own queue. On Vercel
+ * it needs a per-minute cron calling Payload's run endpoint; elsewhere it runs
+ * with `autoRun`.
+ */
+export { JOB_KEYS_COLLECTION, payloadIdempotencyKey, payloadJobs } from './adapter.js';
+//# sourceMappingURL=index.js.map

package/dist/jobs/payload/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/jobs/payload/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAAE,mBAAmB,EAAE,qBAAqB,EAAE,WAAW,EAAE,MAAM,cAAc,CAAA"}

package/dist/jobs/sender.d.ts

@@ -0,0 +1,4 @@
+import type { Inngest } from 'inngest';
+import type { JobsAdapter } from './types.js';
+export declare function eventSenderFor(adapter: Pick<JobsAdapter, 'emit'>): Inngest;
+//# sourceMappingURL=sender.d.ts.map

package/dist/jobs/sender.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sender.d.ts","sourceRoot":"","sources":["../../src/jobs/sender.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,SAAS,CAAA;AACtC,OAAO,KAAK,EAAY,WAAW,EAAE,MAAM,YAAY,CAAA;AAEvD,wBAAgB,cAAc,CAAC,OAAO,EAAE,IAAI,CAAC,WAAW,EAAE,MAAM,CAAC,GAAG,OAAO,CAiB1E"}

package/dist/jobs/sender.js

@@ -0,0 +1,19 @@
+export function eventSenderFor(adapter) {
+    const target = {
+        send: async (event) => {
+            await adapter.emit(event);
+            return { ids: [] };
+        },
+    };
+    return new Proxy(target, {
+        get(object, key) {
+            if (key in object)
+                return object[key];
+            // Read by `await`, inspection and coercion; none of them is a use.
+            if (typeof key === 'symbol' || key === 'then' || key === 'toJSON')
+                return undefined;
+            throw new Error(`This Inngest client is an event sender for a jobs adapter, and has no \`${key}\`. Only \`send\` works on it.`);
+        },
+    });
+}
+//# sourceMappingURL=sender.js.map

package/dist/jobs/sender.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sender.js","sourceRoot":"","sources":["../../src/jobs/sender.ts"],"names":[],"mappings":"AAgBA,MAAM,UAAU,cAAc,CAAC,OAAkC;IAC/D,MAAM,MAAM,GAAG;QACb,IAAI,EAAE,KAAK,EAAE,KAAqC,EAAE,EAAE;YACpD,MAAM,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;YACzB,OAAO,EAAE,GAAG,EAAE,EAAc,EAAE,CAAA;QAChC,CAAC;KACF,CAAA;IACD,OAAO,IAAI,KAAK,CAAC,MAAM,EAAE;QACvB,GAAG,CAAC,MAAM,EAAE,GAAG;YACb,IAAI,GAAG,IAAI,MAAM;gBAAE,OAAO,MAAM,CAAC,GAA0B,CAAC,CAAA;YAC5D,mEAAmE;YACnE,IAAI,OAAO,GAAG,KAAK,QAAQ,IAAI,GAAG,KAAK,MAAM,IAAI,GAAG,KAAK,QAAQ;gBAAE,OAAO,SAAS,CAAA;YACnF,MAAM,IAAI,KAAK,CACb,2EAA2E,GAAG,gCAAgC,CAC/G,CAAA;QACH,CAAC;KACF,CAAuB,CAAA;AAC1B,CAAC"}

package/dist/jobs/types.d.ts

@@ -0,0 +1,105 @@
+import type { Payload } from 'payload';
+import type { WorkflowFailureHandler } from './workflow-types.js';
+/**
+ * What a job reacts to: a named event, any of several, or a cron schedule.
+ * `revalidate-on-publish` is the case for a list: it answers publish,
+ * unpublish and rollback alike.
+ */
+export type JobTrigger = {
+    event: string | readonly string[];
+} | {
+    cron: string;
+};
+/**
+ * Runs of a job with the same key, within the runner's window, collapse into
+ * one.
+ *
+ * Declared as `event.data` fields rather than as an expression, because the
+ * two runners disagree about expressions: Inngest evaluates a CEL string,
+ * Payload Jobs has none. `{ fields: ['collection', 'id'], separator: '/' }`
+ * compiles to Inngest's `event.data.collection + "/" + event.data.id`, so a
+ * job that moves onto this keeps the key it had.
+ */
+export interface JobIdempotency {
+    fields: readonly string[];
+    /** Between field values. Default `':'`. */
+    separator?: string;
+}
+export interface JobDefinition {
+    /** Stable across deploys: a runner keys a run's history and its in-flight sleeps on it. */
+    id: string;
+    on: JobTrigger;
+    /** Attempts after the first. The runner's default when omitted. */
+    retries?: number;
+    /** Most runs at once. Unlimited when omitted. */
+    concurrency?: number;
+    idempotency?: JobIdempotency;
+    /**
+     * Called once when a run has exhausted its retries. Overrides the adapter's
+     * own `onFailure` for this job.
+     */
+    onFailure?: WorkflowFailureHandler;
+}
+/** An event, as a job receives it and as it sends one. */
+export interface JobEvent<TData = unknown> {
+    name: string;
+    data: TData;
+}
+export interface ReceivedJobEvent<TData = unknown> extends JobEvent<TData> {
+    /**
+     * When the event was sent, in epoch milliseconds, when the runner knows.
+     * Use it instead of the clock for anything a replay must agree on: a runner
+     * may run the handler from the top again after each step.
+     */
+    ts?: number;
+}
+/**
+ * The durable steps. A step's id names it in the run's history, so it must be
+ * unique within the job and stable across deploys, and a completed step is not
+ * run again when the handler replays.
+ */
+export interface JobStep {
+    run<T>(id: string, fn: () => Promise<T> | T): Promise<T>;
+    sleepUntil(id: string, until: Date): Promise<void>;
+    sendEvent(id: string, event: JobEvent | readonly JobEvent[]): Promise<void>;
+}
+export interface JobLogger {
+    debug(message: string, context?: Record<string, unknown>): void;
+    info(message: string, context?: Record<string, unknown>): void;
+    warn(message: string, context?: Record<string, unknown>): void;
+    error(message: string, context?: Record<string, unknown>): void;
+}
+export interface JobContext<TData = unknown> {
+    event: ReceivedJobEvent<TData>;
+    step: JobStep;
+    /**
+     * Send an event now, not as a step of its own. For a send that belongs to
+     * the step it is inside: expiring an approval updates the row, writes the
+     * audit event and announces it in one `step.run`, so a retry repeats all
+     * three together. Outside a step, prefer `step.sendEvent`, which a replay
+     * does not repeat.
+     */
+    emit(event: JobEvent | readonly JobEvent[]): Promise<void>;
+    /** The runner's id for this run, for logs and failure reports. */
+    runId: string;
+    /**
+     * The Payload instance, when the runner has one: always on Payload Jobs, and
+     * on Inngest when `inngestJobs` was given it. A job that needs Payload and
+     * may run without it should say so rather than guess.
+     */
+    payload?: Payload;
+    logger: JobLogger;
+}
+export type JobHandler<TData = unknown, TResult = unknown> = (context: JobContext<TData>) => Promise<TResult>;
+/** A job, ready for an adapter. Made by `defineJob`. */
+export interface Job<TData = unknown, TResult = unknown> extends JobDefinition {
+    readonly handler: JobHandler<TData, TResult>;
+}
+/** What every adapter offers, whatever it registers with its runner. */
+export interface JobsAdapter {
+    /** Which runner this is, for logs and for a host that branches on it. */
+    readonly runner: 'inngest' | 'payload';
+    /** Send events from outside a job: a Payload hook, a route, a seed. */
+    emit(event: JobEvent | readonly JobEvent[]): Promise<void>;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/jobs/types.d.ts.map

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

package/dist/jobs/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/jobs/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/jobs/types.ts"],"names":[],"mappings":""}