@marktiderman/genesis-notifications 0.2.2 → 0.3.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -1 +0,0 @@
1
- {"version":3,"sources":["../src/runner/index.ts"],"names":["seconds"],"mappings":"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","file":"chunk-UXNWI7OS.js","sourcesContent":["/**\n * `@marktiderman/genesis-notifications/runner`: the one outbox runner. Claim a\n * batch of due jobs, send them (grouped, so a destination that takes many at\n * once gets one request), and record what happened. No dependencies.\n *\n * The store is the caller's (a SQL outbox claimed with SKIP LOCKED, a\n * queue): `claim` hands over leased jobs and `record` takes back outcomes.\n * The runner owns the rest: turning each send result into an outcome with a\n * retry time, jittered backoff, the deferral cap, and never throwing for one\n * job's failure. The notifier's push and email channels run on it, and so do\n * genesis-forms' destinations (Sheets, webhooks), each with its own claim.\n *\n * Outcomes:\n * - `sent`: delivered (or already there, on a redelivery: `alreadyThere`).\n * - `filtered`: the sender decided it doesn't apply; nothing sent, nothing to retry.\n * - `skipped`: deliberately not sent (`notSent`: a reason safe to store); never retried.\n * - `retry`: a retryable failure. With the service's own Retry-After it is\n * deferred without counting an attempt (`counted: false`), until\n * `maxDeferrals`; otherwise it backs off by attempt (`counted: true`), until\n * `maxAttempts`.\n * - `failed`: permanent, or out of attempts. With `disable: true` the receiver\n * asked to be switched off (a 410 Gone): stop sending to it.\n *\n * It never logs content, addresses or secrets: only what `label` gives and\n * the senders' safe error messages.\n *\n * @packageDocumentation\n */\n\n/** One claimed job. Extend it with what your sender needs. */\nexport interface RunnerJob {\n /** Stable across retries (an idempotency key is made from it). */\n id: string;\n /** This attempt's number, from 1. */\n attempt: number;\n /** Deferrals so far (outcomes with `counted: false`); pass it back so `maxDeferrals` holds. Default 0. */\n deferrals?: number | undefined;\n /** An earlier attempt may have gone through (its lease ran out): senders that can look first do. */\n redelivery?: boolean | undefined;\n}\n\n/** What a sender says about one job. */\nexport type JobResult =\n | {\n ok: true;\n /** Deliberately sent nothing; the reason, safe to store. Recorded as `skipped`. */\n notSent?: string | undefined;\n /** It was already there (a redelivery), so nothing was sent this time. */\n alreadyThere?: boolean | undefined;\n }\n | JobFailure;\n\nexport interface JobFailure {\n ok: false;\n /** The same request may succeed later (rate limited, the service down, a timeout). */\n retryable: boolean;\n /** The service said when to come back: retry after this many seconds, without counting an attempt. */\n retryAfterSeconds?: number | undefined;\n status?: number | undefined;\n /** The receiver asked to be switched off. Always with `retryable: false`. */\n disable?: true | undefined;\n /** Safe to store and log: never secrets, content or addresses. */\n error: string;\n}\n\nexport type JobOutcome =\n | { status: \"sent\"; alreadyThere?: boolean }\n | { status: \"filtered\" }\n | { status: \"skipped\"; reason: string }\n | {\n status: \"retry\";\n error: string;\n retryAt: Date;\n retryAfterSeconds: number;\n /** Whether this attempt counts toward `maxAttempts`. False when the service said when to come back. */\n counted: boolean;\n httpStatus?: number;\n }\n | { status: \"failed\"; error: string; httpStatus?: number; disable?: true };\n\nexport interface RunReport {\n claimed: number;\n sent: number;\n filtered: number;\n skipped: number;\n /** Retryable failures, backed off by attempt. */\n retrying: number;\n /** Retryable failures the service said when to retry; no attempt used. */\n deferred: number;\n failed: number;\n /** Recorded after the claim was lost (`record` resolved false). */\n stale: number;\n /** `record` threw. */\n unrecorded: number;\n}\n\nexport interface ClaimRequest<Filter> {\n limit: number;\n filter?: Filter | undefined;\n}\n\nexport interface SendContext {\n signal?: AbortSignal | undefined;\n}\n\nexport interface RunnerOptions<J extends RunnerJob, Filter = undefined> {\n /** Claims up to `limit` due jobs, each leased so no other runner sends it meanwhile. */\n claim(request: ClaimRequest<Filter>): Promise<readonly J[]>;\n /**\n * Sends one group of jobs (those with the same `group` key) and resolves one\n * result per job, in order, or `\"filtered\"`. A throw fails the whole group\n * with a retryable error.\n */\n send(group: readonly J[], context: SendContext): Promise<readonly (JobResult | \"filtered\")[]>;\n /** Jobs with the same key are sent together. Default: each job alone. */\n group?: ((job: J) => string) | undefined;\n /**\n * Records an outcome. Resolve `false` when the claim was no longer held: it\n * is counted as stale. A rejection is counted as unrecorded; the lease runs\n * out and the job comes back on its own.\n */\n record(job: J, outcome: JobOutcome): Promise<void | boolean>;\n now?: (() => number) | undefined;\n /** Safe lines (ids, kinds, short reasons). Default: nothing is logged. */\n log?: ((message: string) => void) | undefined;\n /** How a job is named in a log line, capitalised (\"Delivery d1 (email)\"). Default `Job <id>`. */\n label?: ((job: J) => string) | undefined;\n /** How a job is named when recording it failed (\"delivery d1\"). Default `job <id>`. */\n recordLabel?: ((job: J) => string) | undefined;\n /** Jobs claimed per run. Default 25. */\n batchSize?: number | undefined;\n /** Counted attempts before a retryable failure is given up. Default 8. */\n maxAttempts?: number | undefined;\n /** Deferrals allowed before a further one counts as an attempt. Default 24. */\n maxDeferrals?: number | undefined;\n /** Seconds to wait after a counted failed attempt. Default `defaultBackoff`. */\n backoff?: ((attempt: number) => number) | undefined;\n}\n\nexport interface RunOptions<Filter> {\n filter?: Filter | undefined;\n /** Overrides `batchSize` for this run. */\n limit?: number | undefined;\n /** Aborts the sends in flight. */\n signal?: AbortSignal | undefined;\n}\n\nexport interface Runner<Filter = undefined> {\n /** One claim, its sends and their records. Never rejects for a job's failure; a failing `claim` rejects. */\n run(options?: RunOptions<Filter>): Promise<RunReport>;\n}\n\nexport const DEFAULT_MAX_ATTEMPTS = 8;\nexport const DEFAULT_MAX_DEFERRALS = 24;\nexport const DEFAULT_BATCH_SIZE = 25;\n\n/**\n * 5 minutes, quadrupling each attempt, at most 24 hours: 5m, 20m, 80m, 5h20m,\n * 21h20m, then 24h; about 3 days across 8 attempts. Each wait is jittered by\n * up to ±20%, so jobs that failed together don't all come back at once.\n */\nexport function defaultBackoff(attempt: number, random?: () => number): number {\n const nominal = Math.min(24 * 3600, 300 * 4 ** Math.max(0, attempt - 1));\n // A function only: `[1, 2].map(defaultBackoff)` passes an index here.\n const r = typeof random === \"function\" ? random() : Math.random();\n return Math.round(nominal * (0.8 + 0.4 * Math.min(1, Math.max(0, r))));\n}\n\n/** Turns a send result into an outcome for a job on its `attempt`. */\nexport function jobOutcome(\n result: JobResult,\n attempt: number,\n options: {\n now?: number | undefined;\n maxAttempts?: number | undefined;\n backoff?: ((attempt: number) => number) | undefined;\n deferrals?: number | undefined;\n maxDeferrals?: number | undefined;\n } = {},\n): JobOutcome {\n if (result.ok) {\n if (result.notSent) return { status: \"skipped\", reason: result.notSent.slice(0, 500) };\n return result.alreadyThere ? { status: \"sent\", alreadyThere: true } : { status: \"sent\" };\n }\n const http = result.status !== undefined ? { httpStatus: result.status } : {};\n if (result.disable) return { status: \"failed\", error: result.error, ...http, disable: true };\n if (!result.retryable) return { status: \"failed\", error: result.error, ...http };\n const now = options.now ?? Date.now();\n if (result.retryAfterSeconds !== undefined && (options.deferrals ?? 0) < (options.maxDeferrals ?? DEFAULT_MAX_DEFERRALS)) {\n const seconds = Math.max(1, Math.ceil(result.retryAfterSeconds));\n return { status: \"retry\", error: result.error, retryAt: new Date(now + seconds * 1000), retryAfterSeconds: seconds, counted: false, ...http };\n }\n const max = options.maxAttempts ?? DEFAULT_MAX_ATTEMPTS;\n if (attempt >= max) return { status: \"failed\", error: `${result.error} (gave up after ${attempt} attempts)`.slice(0, 500), ...http };\n const seconds = Math.max(1, Math.ceil((options.backoff ?? defaultBackoff)(attempt)));\n return { status: \"retry\", error: result.error, retryAt: new Date(now + seconds * 1000), retryAfterSeconds: seconds, counted: true, ...http };\n}\n\n/** A thrown error as a retryable failure with a safe message. */\nexport function failureOf(error: unknown): JobFailure {\n const e = error as { name?: unknown; message?: unknown; retryable?: unknown; retryAfterSeconds?: unknown; status?: unknown; disable?: unknown } | null;\n if (e && typeof e === \"object\" && typeof e.retryable === \"boolean\" && typeof e.message === \"string\") {\n return {\n ok: false,\n retryable: e.disable === true ? false : e.retryable,\n error: e.message.slice(0, 500),\n ...(typeof e.retryAfterSeconds === \"number\" ? { retryAfterSeconds: e.retryAfterSeconds } : {}),\n ...(typeof e.status === \"number\" ? { status: e.status } : {}),\n ...(e.disable === true ? { disable: true as const } : {}),\n };\n }\n const timeout = e && typeof e === \"object\" && (e.name === \"TimeoutError\" || e.name === \"AbortError\");\n return { ok: false, retryable: true, error: timeout ? \"Timed out\" : \"Unexpected error\" };\n}\n\n/**\n * The runner.\n *\n * @stability Beta\n */\nexport function createRunner<J extends RunnerJob, Filter = undefined>(options: RunnerOptions<J, Filter>): Runner<Filter> {\n const log = (message: string): void => {\n try {\n options.log?.(message);\n } catch {\n // A logger that throws never stops an outcome being recorded.\n }\n };\n const label = (job: J) => options.label?.(job) ?? `Job ${job.id}`;\n const recordLabel = (job: J) => options.recordLabel?.(job) ?? `job ${job.id}`;\n const now = () => options.now?.() ?? Date.now();\n\n return {\n async run(runOptions: RunOptions<Filter> = {}): Promise<RunReport> {\n const report: RunReport = { claimed: 0, sent: 0, filtered: 0, skipped: 0, retrying: 0, deferred: 0, failed: 0, stale: 0, unrecorded: 0 };\n const limit = runOptions.limit ?? options.batchSize ?? DEFAULT_BATCH_SIZE;\n const claimed = await options.claim({ limit, filter: runOptions.filter });\n report.claimed = claimed.length;\n\n const groups = new Map<string, J[]>();\n claimed.forEach((job, i) => {\n const key = options.group ? options.group(job) : `\\u0000${i}`;\n const list = groups.get(key) ?? [];\n list.push(job);\n groups.set(key, list);\n });\n\n await Promise.all(\n [...groups.values()].map(async (group) => {\n let results: readonly (JobResult | \"filtered\")[];\n try {\n results = await options.send(group, { signal: runOptions.signal });\n if (results.length !== group.length) throw new Error(\"send answered the wrong number of results\");\n } catch (error) {\n const failure = failureOf(error);\n results = group.map(() => failure);\n }\n const at = now();\n await Promise.all(\n group.map(async (job, i) => {\n const result = results[i]!;\n const outcome: JobOutcome =\n result === \"filtered\"\n ? { status: \"filtered\" }\n : jobOutcome(result, job.attempt, {\n now: at,\n maxAttempts: options.maxAttempts,\n backoff: options.backoff,\n deferrals: job.deferrals,\n maxDeferrals: options.maxDeferrals,\n });\n if (outcome.status === \"failed\" || outcome.status === \"retry\") {\n log(`${label(job)} ${outcome.status === \"failed\" ? \"failed\" : \"will be retried\"}: ${outcome.error}`);\n } else if (outcome.status === \"skipped\") {\n log(`${label(job)} skipped: ${outcome.reason}`);\n }\n let recorded: void | boolean;\n try {\n recorded = await options.record(job, outcome);\n } catch {\n report.unrecorded++;\n log(`Recording ${recordLabel(job)} failed`);\n return;\n }\n if (recorded === false) report.stale++;\n else if (outcome.status === \"sent\") report.sent++;\n else if (outcome.status === \"filtered\") report.filtered++;\n else if (outcome.status === \"skipped\") report.skipped++;\n else if (outcome.status === \"failed\") report.failed++;\n else if (outcome.counted) report.retrying++;\n else report.deferred++;\n }),\n );\n }),\n );\n return report;\n },\n };\n}\n"]}