@forumone/throughline 0.0.0 → 1.0.0-next.0

package/dist/integrations/types.d.ts

@@ -0,0 +1,183 @@
+import type { Field } from 'payload';
+import type { Inngest } from 'inngest';
+import type { Job, JobContext } from '../jobs/types.js';
+import type { WorkflowFailureHandler } from '../jobs/workflow-types.js';
+import type { McpToolDefinition } from '../plugin-contract/mcp.js';
+export type IntegrationCategory = 'crm' | 'marketing' | 'analytics' | 'webhook' | 'storage' | 'messaging' | 'other';
+export type IntegrationSyncStatus = 'success' | 'partial' | 'failed' | 'never-run';
+/**
+ * The status and message arguments of {@link IntegrationContext.updateStatus}.
+ *
+ * A run that was not clean has to say why: `partial` and `failed` carry a
+ * message, and `success` carries none. `never-run` is not here because a run
+ * that reports its status has run.
+ */
+export type IntegrationStatusUpdate = [status: 'success'] | [status: 'partial' | 'failed', error: string];
+export interface IntegrationConfigValidation {
+    ok: boolean;
+    reason?: string;
+}
+export interface IntegrationHealth {
+    ok: boolean;
+    details?: string;
+}
+/**
+ * The contract every integration module satisfies. Integrations are
+ * registered with the plugin and instantiated per-row via the Integrations
+ * collection. The contract is intentionally small: every future integration
+ * (Salesforce, Mailchimp, etc.) follows the same shape, so the productivity
+ * compounding is in keeping it stable.
+ *
+ * Integrations are events-in, events-out: they subscribe to system events
+ * (e.g. `content/page.published`) via Inngest functions returned by
+ * {@link Integration.createFunctions} and emit their own results events as
+ * needed. They never call other integrations directly.
+ */
+export interface Integration<Config = Record<string, unknown>, Fn = unknown> {
+    /** Unique slug. Used as the `integrationType` value in the collection. */
+    id: string;
+    /** Display name shown in the admin and `list_integration_types`. */
+    name: string;
+    /** One-line description for the admin and the listing tool. */
+    description: string;
+    /** Category for organizational grouping. */
+    category: IntegrationCategory;
+    /**
+     * Payload field definitions shown in the admin under each instance's
+     * `config` group. Integration authors keep this small and obvious — Claude
+     * cannot edit these (admin-only access) so unhelpful labels become support
+     * tickets, not chatbot mistakes.
+     */
+    configFields: Field[];
+    /**
+     * Validates a config object against this integration's requirements. Run
+     * by the collection's beforeChange hook so the Payload UI surfaces errors
+     * inline rather than failing at sync time.
+     */
+    validateConfig: (config: Config) => Promise<IntegrationConfigValidation>;
+    /** Which system events this integration subscribes to. Documentation only. */
+    subscribes: Array<{
+        event: string;
+        purpose: string;
+    }>;
+    /**
+     * Factory for the Inngest functions this integration contributes. Called
+     * during plugin init; the returned functions are exposed via the registry
+     * so the client app's Inngest endpoint can serve them. See
+     * `docs/integrations-wiring.md`.
+     *
+     * **Generic in the function type, and `unknown` by default, on purpose.**
+     * This plugin never inspects or invokes what comes back — the one use
+     * anywhere is `.length`, for a log line saying how many an integration
+     * contributed. The host serves them.
+     *
+     * Naming `InngestFunction.Any` here instead cost a consumer two casts. A host
+     * whose dependency graph resolves a different `inngest` instance — pnpm keys
+     * one by its peer set, and `inngest` has optional peers on `express`, `hono`
+     * and `next`, so installing anything that pulls one in is enough — got a type
+     * that is structurally identical and nominally different. Generic, the host's
+     * own `InngestFunction.Any` flows through and the question never arises:
+     *
+     * ```ts
+     * export const myIntegration: Integration<MyConfig, InngestFunction.Any> = { … }
+     * ```
+     */
+    createFunctions: (ctx: IntegrationContext) => Fn[];
+    /**
+     * The same work as runner-neutral jobs, for a site on `payloadJobs` (or any
+     * jobs adapter). Optional: an integration without it runs on Inngest only.
+     *
+     * Takes a function rather than a context, because a jobs adapter is handed
+     * its jobs while the config is being built, before the context exists. Call
+     * `getContext(jobContext)` inside the handler. An integration with both
+     * usually derives `createFunctions` from this, as the webhook does:
+     *
+     * ```ts
+     * createFunctions: (ctx) => inngestJobs(ctx.inngest).functions(createJobs(() => ctx)),
+     * ```
+     */
+    createJobs?: (getContext: (job: JobContext) => IntegrationContext) => Job[];
+    /**
+     * Optional MCP tools the integration adds to the integrations server. Most
+     * integrations need only the five built-in tools; this is for cases where
+     * the integration needs its own purpose-built tool (e.g. Salesforce's
+     * "preview field mapping").
+     */
+    mcpTools?: (ctx: IntegrationContext) => McpToolDefinition[];
+    /**
+     * Health check. Called by the `test_integration` MCP tool. Returns
+     * `{ ok: true }` for healthy or `{ ok: false, details }` for problems.
+     */
+    healthcheck?: (config: Config) => Promise<IntegrationHealth>;
+}
+/**
+ * Runtime context passed to integrations during initialization. Provides
+ * the framework's facilities (Inngest, audit) without coupling the
+ * integration to internal implementation details.
+ */
+export interface IntegrationContext {
+    /**
+     * The Inngest client. On a site that runs integrations as jobs and has no
+     * Inngest, any use of it throws, saying so. Send events with `emit`.
+     */
+    inngest: Inngest;
+    /** Send an event on whichever runner the site uses. */
+    emit: (event: {
+        name: string;
+        data: unknown;
+    }) => Promise<void>;
+    /**
+     * The site's terminal-failure handler, for an integration's Inngest functions:
+     * `inngestJobs(ctx.inngest, { onFailure: ctx.onFailure })`. On Payload Jobs
+     * the adapter's own `onFailure` applies instead.
+     */
+    onFailure?: WorkflowFailureHandler;
+    integrationsCollectionSlug: string;
+    /** Loads all enabled instances of an integration by id. */
+    loadInstances: <Config = Record<string, unknown>>(integrationId: string) => Promise<Array<IntegrationInstanceLoaded<Config>>>;
+    /**
+     * Records the outcome of a run on the instance: `lastSyncAt`,
+     * `lastSyncStatus`, and `lastError`.
+     *
+     * `success` takes no message and clears `lastError`. `partial` and `failed`
+     * require one, and it replaces `lastError`, so the admin always shows why
+     * the run was not clean. For a run with per-record failures, build the
+     * arguments from the list of failures with `statusFromProblems`:
+     *
+     * ```ts
+     * await ctx.updateStatus(instance.id, ...statusFromProblems(problems))
+     * ```
+     */
+    updateStatus: (instanceId: string, ...update: IntegrationStatusUpdate) => Promise<void>;
+    /** Writes an audit event. Thin wrapper over core's audit writer. */
+    recordAudit: (event: IntegrationAuditEvent) => Promise<void>;
+}
+export interface IntegrationInstanceLoaded<Config = Record<string, unknown>> {
+    id: string;
+    name: string;
+    config: Config;
+}
+export interface IntegrationAuditEvent {
+    /** The integration's id (e.g. 'webhook'). Used as the audit `integrationId`. */
+    integrationId: string;
+    /** The instance's display name. Surfaces in audit summaries. */
+    instanceName: string;
+    action: 'integration.synced' | 'integration.failed';
+    summary: string;
+    errorMessage?: string;
+}
+/**
+ * The shape of a single Integrations-collection row, as returned by Payload.
+ * Used by tests and by the helpers that read instances back out.
+ */
+export interface IntegrationInstance {
+    id: string;
+    name: string;
+    integrationType: string;
+    enabled: boolean;
+    config: Record<string, unknown>;
+    lastSyncAt?: string;
+    lastSyncStatus?: IntegrationSyncStatus;
+    lastError?: string;
+}
+//# sourceMappingURL=types.d.ts.map

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

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

package/dist/integrations/types.js

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

package/dist/integrations/types.js.map

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

package/dist/jobs/define.d.ts

@@ -0,0 +1,17 @@
+import type { Job, JobDefinition, JobHandler } from './types.js';
+/**
+ * Describe a job once, for any runner.
+ *
+ * ```ts
+ * export const expireStaleApprovals = defineJob(
+ *   { id: 'expire-stale-approvals', on: { cron: '0 2 * * *' }, concurrency: 1 },
+ *   async ({ step }) => step.run('expire', () => expire(payload)),
+ * )
+ * ```
+ *
+ * Validates what a runner would otherwise reject at registration, or worse,
+ * accept and misbehave on: an empty id, no trigger or two, an idempotency key
+ * with no fields, a fractional retry count.
+ */
+export declare function defineJob<TData = unknown, TResult = unknown>(definition: JobDefinition, handler: JobHandler<TData, TResult>): Job<TData, TResult>;
+//# sourceMappingURL=define.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"define.d.ts","sourceRoot":"","sources":["../../src/jobs/define.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,GAAG,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,YAAY,CAAA;AAEhE;;;;;;;;;;;;;GAaG;AACH,wBAAgB,SAAS,CAAC,KAAK,GAAG,OAAO,EAAE,OAAO,GAAG,OAAO,EAC1D,UAAU,EAAE,aAAa,EACzB,OAAO,EAAE,UAAU,CAAC,KAAK,EAAE,OAAO,CAAC,GAClC,GAAG,CAAC,KAAK,EAAE,OAAO,CAAC,CA4BrB"}

package/dist/jobs/define.js

@@ -0,0 +1,39 @@
+/**
+ * Describe a job once, for any runner.
+ *
+ * ```ts
+ * export const expireStaleApprovals = defineJob(
+ *   { id: 'expire-stale-approvals', on: { cron: '0 2 * * *' }, concurrency: 1 },
+ *   async ({ step }) => step.run('expire', () => expire(payload)),
+ * )
+ * ```
+ *
+ * Validates what a runner would otherwise reject at registration, or worse,
+ * accept and misbehave on: an empty id, no trigger or two, an idempotency key
+ * with no fields, a fractional retry count.
+ */
+export function defineJob(definition, handler) {
+    if (!definition.id || definition.id.trim() !== definition.id) {
+        throw new Error(`A job needs a non-empty id with no surrounding spaces; got ${JSON.stringify(definition.id)}.`);
+    }
+    const on = definition.on;
+    const hasEvent = typeof on.event === 'string' ||
+        (Array.isArray(on.event) && on.event.length > 0 && on.event.every((e) => typeof e === 'string'));
+    const hasCron = typeof on.cron === 'string';
+    if (hasEvent === hasCron) {
+        throw new Error(`Job "${definition.id}" needs exactly one of \`on.event\` or \`on.cron\`.`);
+    }
+    if (definition.idempotency && definition.idempotency.fields.length === 0) {
+        throw new Error(`Job "${definition.id}" declares idempotency with no fields.`);
+    }
+    for (const [key, value] of [
+        ['retries', definition.retries],
+        ['concurrency', definition.concurrency],
+    ]) {
+        if (value !== undefined && (!Number.isInteger(value) || value < 0)) {
+            throw new Error(`Job "${definition.id}" has ${key} ${String(value)}; it must be a whole number.`);
+        }
+    }
+    return Object.freeze({ ...definition, handler });
+}
+//# sourceMappingURL=define.js.map

package/dist/jobs/define.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"define.js","sourceRoot":"","sources":["../../src/jobs/define.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,SAAS,CACvB,UAAyB,EACzB,OAAmC;IAEnC,IAAI,CAAC,UAAU,CAAC,EAAE,IAAI,UAAU,CAAC,EAAE,CAAC,IAAI,EAAE,KAAK,UAAU,CAAC,EAAE,EAAE,CAAC;QAC7D,MAAM,IAAI,KAAK,CACb,8DAA8D,IAAI,CAAC,SAAS,CAAC,UAAU,CAAC,EAAE,CAAC,GAAG,CAC/F,CAAA;IACH,CAAC;IACD,MAAM,EAAE,GAAG,UAAU,CAAC,EAAyC,CAAA;IAC/D,MAAM,QAAQ,GACZ,OAAO,EAAE,CAAC,KAAK,KAAK,QAAQ;QAC5B,CAAC,KAAK,CAAC,OAAO,CAAC,EAAE,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAA;IAClG,MAAM,OAAO,GAAG,OAAO,EAAE,CAAC,IAAI,KAAK,QAAQ,CAAA;IAC3C,IAAI,QAAQ,KAAK,OAAO,EAAE,CAAC;QACzB,MAAM,IAAI,KAAK,CAAC,QAAQ,UAAU,CAAC,EAAE,qDAAqD,CAAC,CAAA;IAC7F,CAAC;IACD,IAAI,UAAU,CAAC,WAAW,IAAI,UAAU,CAAC,WAAW,CAAC,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACzE,MAAM,IAAI,KAAK,CAAC,QAAQ,UAAU,CAAC,EAAE,wCAAwC,CAAC,CAAA;IAChF,CAAC;IACD,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI;QACzB,CAAC,SAAS,EAAE,UAAU,CAAC,OAAO,CAAC;QAC/B,CAAC,aAAa,EAAE,UAAU,CAAC,WAAW,CAAC;KAC/B,EAAE,CAAC;QACX,IAAI,KAAK,KAAK,SAAS,IAAI,CAAC,CAAC,MAAM,CAAC,SAAS,CAAC,KAAK,CAAC,IAAI,KAAK,GAAG,CAAC,CAAC,EAAE,CAAC;YACnE,MAAM,IAAI,KAAK,CACb,QAAQ,UAAU,CAAC,EAAE,SAAS,GAAG,IAAI,MAAM,CAAC,KAAK,CAAC,8BAA8B,CACjF,CAAA;QACH,CAAC;IACH,CAAC;IACD,OAAO,MAAM,CAAC,MAAM,CAAC,EAAE,GAAG,UAAU,EAAE,OAAO,EAAE,CAAC,CAAA;AAClD,CAAC"}

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

@@ -0,0 +1,39 @@
+import type { Payload } from 'payload';
+import type { Logger } from '../plugin-contract/index.js';
+import { type ErrorReporter } from '../observability/report.js';
+import { type JobFailureWriter } from '../observability/writer.js';
+import type { HealthcheckOptions, WorkflowFailureHandler } from './workflow-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 })
+ * inngestJobs(inngest, { payload, onFailure: 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/jobs/failure-handler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"failure-handler.d.ts","sourceRoot":"","sources":["../../src/jobs/failure-handler.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,SAAS,CAAA;AACtC,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,6BAA6B,CAAA;AACzD,OAAO,EAKL,KAAK,aAAa,EAGnB,MAAM,4BAA4B,CAAA;AAEnC,OAAO,EAAE,KAAK,gBAAgB,EAAE,MAAM,4BAA4B,CAAA;AAElE,OAAO,KAAK,EAAE,kBAAkB,EAAE,sBAAsB,EAAE,MAAM,qBAAqB,CAAA;AAuBrF,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/jobs/failure-handler.js

@@ -0,0 +1,62 @@
+import { buildHealthcheckFailureReport, buildJobFailureReport, reportError, summariseReport, } from '../observability/report.js';
+import { getJobFailureWriter } from '../observability/plugin.js';
+import { defaultLogger } from '../logger/index.js';
+/**
+ * An `onTerminalFailure` handler for any workflow factory here — or for any
+ * Inngest function, as its `onFailure`.
+ *
+ * ```ts
+ * const onTerminalFailure = createTerminalFailureHandler({ payload })
+ * inngestJobs(inngest, { payload, onFailure: 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/jobs/failure-handler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"failure-handler.js","sourceRoot":"","sources":["../../src/jobs/failure-handler.ts"],"names":[],"mappings":"AAEA,OAAO,EACL,6BAA6B,EAC7B,qBAAqB,EACrB,WAAW,EACX,eAAe,GAIhB,MAAM,4BAA4B,CAAA;AACnC,OAAO,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAA;AAEhE,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAA;AA4ClD;;;;;;;;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/jobs/index.d.ts

@@ -0,0 +1,28 @@
+/**
+ * `@forumone/throughline/jobs`: background work written once and run on either
+ * adapter, `inngestJobs` (`/jobs/inngest`) or `payloadJobs` (`/jobs/payload`).
+ * The platform's own jobs live with their owners: `/publishing`, `/approvals`,
+ * `/audit` and `/integrations`.
+ *
+ * Extend the event taxonomy with module augmentation:
+ *
+ * ```ts
+ * declare module '@forumone/throughline/jobs' {
+ *   interface CoreEvents { 'site/thing.happened': { id: string } }
+ * }
+ * ```
+ *
+ * Nothing here loads a runner: `inngest` appears only as a type.
+ */
+export type { CoreEvents, FrameworkEvents } from '../events/taxonomy.js';
+export { defineJob } from './define.js';
+export { eventSenderFor } from './sender.js';
+export { jobEvents } from './inngest/adapter.js';
+export { jobPayload } from './options.js';
+export type { JobOptions } from './options.js';
+export type { Job, JobContext, JobDefinition, JobEvent, JobHandler, JobIdempotency, JobLogger, JobStep, JobsAdapter, JobTrigger, ReceivedJobEvent, } from './types.js';
+export { failureOptions } from './workflow-types.js';
+export type { BaseWorkflowOptions, FailureAwareOptions, WorkflowFailureHandler, } from './workflow-types.js';
+export { createHealthcheckFailureHandler, createTerminalFailureHandler } from './failure-handler.js';
+export type { FailureHandlerOptions, HealthcheckFailureHandlerOptions } from './failure-handler.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/jobs/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AACH,YAAY,EAAE,UAAU,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAA;AAExE,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAA;AACvC,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAA;AAC5C,OAAO,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAA;AAChD,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAA;AACzC,YAAY,EAAE,UAAU,EAAE,MAAM,cAAc,CAAA;AAC9C,YAAY,EACV,GAAG,EACH,UAAU,EACV,aAAa,EACb,QAAQ,EACR,UAAU,EACV,cAAc,EACd,SAAS,EACT,OAAO,EACP,WAAW,EACX,UAAU,EACV,gBAAgB,GACjB,MAAM,YAAY,CAAA;AAEnB,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAA;AACpD,YAAY,EACV,mBAAmB,EACnB,mBAAmB,EACnB,sBAAsB,GACvB,MAAM,qBAAqB,CAAA;AAE5B,OAAO,EAAE,+BAA+B,EAAE,4BAA4B,EAAE,MAAM,sBAAsB,CAAA;AACpG,YAAY,EAAE,qBAAqB,EAAE,gCAAgC,EAAE,MAAM,sBAAsB,CAAA"}

package/dist/jobs/index.js

@@ -0,0 +1,7 @@
+export { defineJob } from './define.js';
+export { eventSenderFor } from './sender.js';
+export { jobEvents } from './inngest/adapter.js';
+export { jobPayload } from './options.js';
+export { failureOptions } from './workflow-types.js';
+export { createHealthcheckFailureHandler, createTerminalFailureHandler } from './failure-handler.js';
+//# sourceMappingURL=index.js.map

package/dist/jobs/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/jobs/index.ts"],"names":[],"mappings":"AAkBA,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAA;AACvC,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAA;AAC5C,OAAO,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAA;AAChD,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAA;AAgBzC,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAA;AAOpD,OAAO,EAAE,+BAA+B,EAAE,4BAA4B,EAAE,MAAM,sBAAsB,CAAA"}

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

@@ -0,0 +1,39 @@
+import type { Inngest, InngestFunction } from 'inngest';
+import type { Payload } from 'payload';
+import type { WorkflowFailureHandler } from '../workflow-types.js';
+import type { Job, JobIdempotency, JobsAdapter } from '../types.js';
+export interface InngestJobsOptions {
+    /** Every job's terminal-failure handler, unless the job declares its own. */
+    onFailure?: WorkflowFailureHandler;
+    /** Handed to every job as `context.payload`. */
+    payload?: Payload;
+}
+export interface InngestJobsAdapter extends JobsAdapter {
+    readonly runner: 'inngest';
+    /** The Inngest function for one job. */
+    toFunction(job: Job): InngestFunction.Any;
+    /** The Inngest functions for many, in order, for `serve({ functions })`. */
+    functions(jobs: readonly Job[]): InngestFunction.Any[];
+}
+/**
+ * Inngest's idempotency expression for a field list:
+ * `{ fields: ['collection', 'id'], separator: '/' }` becomes
+ * `event.data.collection + "/" + event.data.id`.
+ */
+export declare function inngestIdempotency(idempotency: JobIdempotency): string;
+/** The config `createFunction` receives, built once so tests can read it. */
+export declare function inngestFunctionConfig(job: Job, options?: InngestJobsOptions): Record<string, unknown> & {
+    id: string;
+};
+/** The event names a job answers, as a list. Empty for a cron job. */
+export declare function jobEvents(job: Job): readonly string[];
+/**
+ * Run jobs on Inngest.
+ *
+ * ```ts
+ * const jobs = inngestJobs(inngest, { onFailure: createTerminalFailureHandler({ payload }) })
+ * export const { GET, POST, PUT } = serve({ client: inngest, functions: jobs.functions(allJobs) })
+ * ```
+ */
+export declare function inngestJobs(inngest: Inngest, options?: InngestJobsOptions): InngestJobsAdapter;
+//# sourceMappingURL=adapter.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"adapter.d.ts","sourceRoot":"","sources":["../../../src/jobs/inngest/adapter.ts"],"names":[],"mappings":"AAeA,OAAO,KAAK,EAAE,OAAO,EAAE,eAAe,EAAE,MAAM,SAAS,CAAA;AACvD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,SAAS,CAAA;AACtC,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,sBAAsB,CAAA;AAClE,OAAO,KAAK,EAAE,GAAG,EAAwB,cAAc,EAAa,WAAW,EAAE,MAAM,aAAa,CAAA;AAEpG,MAAM,WAAW,kBAAkB;IACjC,6EAA6E;IAC7E,SAAS,CAAC,EAAE,sBAAsB,CAAA;IAClC,gDAAgD;IAChD,OAAO,CAAC,EAAE,OAAO,CAAA;CAClB;AAED,MAAM,WAAW,kBAAmB,SAAQ,WAAW;IACrD,QAAQ,CAAC,MAAM,EAAE,SAAS,CAAA;IAC1B,wCAAwC;IACxC,UAAU,CAAC,GAAG,EAAE,GAAG,GAAG,eAAe,CAAC,GAAG,CAAA;IACzC,4EAA4E;IAC5E,SAAS,CAAC,IAAI,EAAE,SAAS,GAAG,EAAE,GAAG,eAAe,CAAC,GAAG,EAAE,CAAA;CACvD;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,WAAW,EAAE,cAAc,GAAG,MAAM,CAGtE;AAED,6EAA6E;AAC7E,wBAAgB,qBAAqB,CACnC,GAAG,EAAE,GAAG,EACR,OAAO,GAAE,kBAAuB,GAC/B,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG;IAAE,EAAE,EAAE,MAAM,CAAA;CAAE,CAa1C;AAaD,sEAAsE;AACtE,wBAAgB,SAAS,CAAC,GAAG,EAAE,GAAG,GAAG,SAAS,MAAM,EAAE,CAGrD;AA8BD;;;;;;;GAOG;AACH,wBAAgB,WAAW,CACzB,OAAO,EAAE,OAAO,EAChB,OAAO,GAAE,kBAAuB,GAC/B,kBAAkB,CA2BpB"}

package/dist/jobs/inngest/adapter.js

@@ -0,0 +1,81 @@
+/**
+ * Inngest's idempotency expression for a field list:
+ * `{ fields: ['collection', 'id'], separator: '/' }` becomes
+ * `event.data.collection + "/" + event.data.id`.
+ */
+export function inngestIdempotency(idempotency) {
+    const separator = JSON.stringify(idempotency.separator ?? ':');
+    return idempotency.fields.map((field) => `event.data.${field}`).join(` + ${separator} + `);
+}
+/** The config `createFunction` receives, built once so tests can read it. */
+export function inngestFunctionConfig(job, options = {}) {
+    const onFailure = job.onFailure ?? options.onFailure;
+    return {
+        id: job.id,
+        // Each key only when set: `exactOptionalPropertyTypes` is on, and Inngest
+        // reads the presence of a key, so `undefined` is not the same as absent.
+        ...(job.retries !== undefined ? { retries: job.retries } : {}),
+        ...(job.concurrency !== undefined ? { concurrency: job.concurrency } : {}),
+        ...(job.idempotency ? { idempotency: inngestIdempotency(job.idempotency) } : {}),
+        ...(onFailure ? { onFailure } : {}),
+        triggers: 'event' in job.on ? jobEvents(job).map((event) => ({ event })) : [{ cron: job.on.cron }],
+    };
+}
+/** The event names a job answers, as a list. Empty for a cron job. */
+export function jobEvents(job) {
+    if (!('event' in job.on))
+        return [];
+    return typeof job.on.event === 'string' ? [job.on.event] : job.on.event;
+}
+/** Inngest's handler arguments, as a job's context. */
+function toContext(args, emit, payload) {
+    return {
+        event: {
+            name: args.event.name,
+            data: args.event.data,
+            ...(typeof args.event.ts === 'number' ? { ts: args.event.ts } : {}),
+        },
+        step: {
+            run: (id, fn) => args.step.run(id, fn),
+            sleepUntil: async (id, until) => {
+                await args.step.sleepUntil(id, until);
+            },
+            sendEvent: async (id, event) => {
+                await args.step.sendEvent(id, Array.isArray(event) ? [...event] : event);
+            },
+        },
+        runId: args.runId ?? 'unknown',
+        logger: args.logger,
+        emit,
+        ...(payload ? { payload } : {}),
+    };
+}
+/**
+ * Run jobs on Inngest.
+ *
+ * ```ts
+ * const jobs = inngestJobs(inngest, { onFailure: createTerminalFailureHandler({ payload }) })
+ * export const { GET, POST, PUT } = serve({ client: inngest, functions: jobs.functions(allJobs) })
+ * ```
+ */
+export function inngestJobs(inngest, options = {}) {
+    const emit = async (event) => {
+        await inngest.send(Array.isArray(event) ? [...event] : event);
+    };
+    const toFunction = (job) => inngest.createFunction(inngestFunctionConfig(job, options), (args) => job.handler(toContext(args, emit, options.payload)));
+    return {
+        runner: 'inngest',
+        toFunction,
+        functions: (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);
+            }
+            return jobs.map(toFunction);
+        },
+        emit,
+    };
+}
+//# sourceMappingURL=adapter.js.map

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

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

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

@@ -0,0 +1,15 @@
+/**
+ * `@forumone/throughline/jobs/inngest`: jobs on Inngest. `inngestJobs` keeps
+ * every platform job's function id, so a run in flight survives an upgrade.
+ * Also the Inngest client, and the Vercel environment pinning that keeps a
+ * preview from registering crons.
+ *
+ * Kept off the package root so a site running on Payload Jobs never loads
+ * `inngest`.
+ */
+export { inngestFunctionConfig, inngestIdempotency, inngestJobs } from './adapter.js';
+export type { InngestJobsAdapter, InngestJobsOptions } from './adapter.js';
+export { createInngestClient } from '../../events/inngest.js';
+export type { InngestClientOptions } from '../../events/inngest.js';
+export { registersInngestCrons, registrableInngestFunctions, resolveInngestEnv, } from '../../events/vercel.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/jobs/inngest/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,OAAO,EAAE,qBAAqB,EAAE,kBAAkB,EAAE,WAAW,EAAE,MAAM,cAAc,CAAA;AACrF,YAAY,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAA;AAE1E,OAAO,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAA;AAC7D,YAAY,EAAE,oBAAoB,EAAE,MAAM,yBAAyB,CAAA;AACnE,OAAO,EACL,qBAAqB,EACrB,2BAA2B,EAC3B,iBAAiB,GAClB,MAAM,wBAAwB,CAAA"}

package/dist/jobs/inngest/index.js

@@ -0,0 +1,13 @@
+/**
+ * `@forumone/throughline/jobs/inngest`: jobs on Inngest. `inngestJobs` keeps
+ * every platform job's function id, so a run in flight survives an upgrade.
+ * Also the Inngest client, and the Vercel environment pinning that keeps a
+ * preview from registering crons.
+ *
+ * Kept off the package root so a site running on Payload Jobs never loads
+ * `inngest`.
+ */
+export { inngestFunctionConfig, inngestIdempotency, inngestJobs } from './adapter.js';
+export { createInngestClient } from '../../events/inngest.js';
+export { registersInngestCrons, registrableInngestFunctions, resolveInngestEnv, } from '../../events/vercel.js';
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/jobs/inngest/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,OAAO,EAAE,qBAAqB,EAAE,kBAAkB,EAAE,WAAW,EAAE,MAAM,cAAc,CAAA;AAGrF,OAAO,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAA;AAE7D,OAAO,EACL,qBAAqB,EACrB,2BAA2B,EAC3B,iBAAiB,GAClB,MAAM,wBAAwB,CAAA"}

package/dist/jobs/options.d.ts

@@ -0,0 +1,18 @@
+import type { Payload } from 'payload';
+/**
+ * A workflow factory's options, as its job builder takes them: no Inngest
+ * client, and Payload optional.
+ *
+ * Optional because a job may be declared before Payload exists — a jobs
+ * adapter like `payloadJobs` is handed its jobs while the config is still being
+ * built. Such a job finds Payload on its context when it runs instead.
+ */
+export type JobOptions<T> = Omit<T, 'inngest' | 'payload'> & {
+    payload?: Payload;
+};
+/**
+ * The Payload a job runs against: the one it was built with, or the one its
+ * runner supplies. Throws, naming the job, when there is neither.
+ */
+export declare function jobPayload(fromOptions: Payload | undefined, fromContext: Payload | undefined, jobId: string): Payload;
+//# sourceMappingURL=options.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"options.d.ts","sourceRoot":"","sources":["../../src/jobs/options.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,SAAS,CAAA;AAEtC;;;;;;;GAOG;AACH,MAAM,MAAM,UAAU,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,EAAE,SAAS,GAAG,SAAS,CAAC,GAAG;IAAE,OAAO,CAAC,EAAE,OAAO,CAAA;CAAE,CAAA;AAElF;;;GAGG;AACH,wBAAgB,UAAU,CACxB,WAAW,EAAE,OAAO,GAAG,SAAS,EAChC,WAAW,EAAE,OAAO,GAAG,SAAS,EAChC,KAAK,EAAE,MAAM,GACZ,OAAO,CAQT"}

package/dist/jobs/options.js

@@ -0,0 +1,12 @@
+/**
+ * The Payload a job runs against: the one it was built with, or the one its
+ * runner supplies. Throws, naming the job, when there is neither.
+ */
+export function jobPayload(fromOptions, fromContext, jobId) {
+    const payload = fromOptions ?? fromContext;
+    if (!payload) {
+        throw new Error(`Job "${jobId}" needs Payload: pass \`payload\` in its options, or run it on payloadJobs (or inngestJobs given \`payload\`).`);
+    }
+    return payload;
+}
+//# sourceMappingURL=options.js.map

package/dist/jobs/options.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"options.js","sourceRoot":"","sources":["../../src/jobs/options.ts"],"names":[],"mappings":"AAYA;;;GAGG;AACH,MAAM,UAAU,UAAU,CACxB,WAAgC,EAChC,WAAgC,EAChC,KAAa;IAEb,MAAM,OAAO,GAAG,WAAW,IAAI,WAAW,CAAA;IAC1C,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,MAAM,IAAI,KAAK,CACb,QAAQ,KAAK,gHAAgH,CAC9H,CAAA;IACH,CAAC;IACD,OAAO,OAAO,CAAA;AAChB,CAAC"}