@connextar/house 0.10.0 → 0.11.0

package/dist/jobs/job-health-list.js

@@ -0,0 +1,115 @@
+"use client";
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { CircleCheck, CirclePause, CircleX, Clock, LoaderCircle, Play, TriangleAlert, } from "lucide-react";
+import * as React from "react";
+import { cx } from "../internal/cx.js";
+import { useKeyedAction } from "../ux/use-action.js";
+import { useOptimisticValue } from "../ux/use-optimistic-value.js";
+import { countsSummary } from "./counts.js";
+import { describeHealth, describeRun, describeSwitch, } from "./health.js";
+/** The house look, on the shared theme tokens. */
+export const JOB_HEALTH_CLASS_NAMES = {
+    list: "flex flex-col divide-y divide-border",
+    empty: "text-sm text-muted-foreground",
+    row: "flex flex-wrap items-start justify-between gap-3 py-3 first:pt-0 last:pb-0",
+    body: "flex min-w-0 flex-1 flex-col gap-1",
+    heading: "flex flex-wrap items-center gap-2",
+    label: "text-sm font-medium text-foreground",
+    badge: "inline-flex items-center gap-1 rounded-full border px-2 py-0.5 text-xs font-medium [&_svg]:size-3",
+    badgeGood: "border-primary/30 bg-primary/10 text-primary",
+    badgeNeutral: "border-border text-muted-foreground",
+    badgeWarning: "border-destructive/40 text-destructive",
+    badgeBad: "border-destructive/40 bg-destructive/10 text-destructive",
+    meta: "text-xs text-muted-foreground",
+    detail: "text-xs text-muted-foreground",
+    error: "text-xs text-destructive",
+    counts: "text-xs text-muted-foreground tabular-nums",
+    switched: "text-xs text-muted-foreground",
+    actions: "flex shrink-0 items-center gap-3",
+    runNow: "inline-flex items-center gap-1.5 rounded-md border border-border px-2.5 py-1 text-xs font-medium text-foreground transition-colors hover:bg-muted focus-visible:ring-2 focus-visible:ring-ring focus-visible:outline-none disabled:pointer-events-none disabled:opacity-60 [&_svg]:size-3.5",
+    switch: "relative inline-flex h-5 w-9 shrink-0 cursor-pointer items-center rounded-full border-2 border-transparent transition-colors focus-visible:ring-2 focus-visible:ring-ring focus-visible:outline-none",
+    switchOn: "bg-primary",
+    switchOff: "bg-muted-foreground/30",
+    thumb: "pointer-events-none block size-4 rounded-full bg-card shadow transition-transform",
+    thumbOn: "translate-x-4",
+    thumbOff: "translate-x-0",
+};
+const ICONS = {
+    paused: CirclePause,
+    "never-run": Clock,
+    running: LoaderCircle,
+    failed: CircleX,
+    stale: TriangleAlert,
+    healthy: CircleCheck,
+};
+/**
+ * The health screen's list: each job's schedule, last run, what it did in
+ * words, its health, and — for whoever may — its switch and Run now.
+ *
+ * The switch is an optimistic value: it moves on the click, the badge with it,
+ * and a refusal puts both back and says why. AltEd's switch did not move until
+ * the server answered, and greyed out every other switch on the screen while it
+ * waited.
+ *
+ * Draws plain elements on the theme tokens, like the wizard; there is still no
+ * `Button` in this package. The app wraps it in its own card and heading.
+ */
+export function JobHealthList({ jobs, onSwitch, onRunNow, onSettled, extra, emptyText = "No scheduled jobs.", className, classNames, locale, timeZone, }) {
+    const c = { ...JOB_HEALTH_CLASS_NAMES, ...classNames };
+    const actions = useKeyedAction();
+    if (jobs.length === 0)
+        return _jsx("p", { className: c.empty, children: emptyText });
+    return (_jsx("ul", { className: cx(c.list, className), children: jobs.map((job) => (_jsx(JobRow, { job: job, c: c, actions: actions, onSwitch: onSwitch, onRunNow: onRunNow, onSettled: onSettled, extra: extra, when: { locale, timeZone } }, job.id))) }));
+}
+function toneClass(c, words) {
+    switch (words.tone) {
+        case "good":
+            return c.badgeGood;
+        case "warning":
+            return c.badgeWarning;
+        case "bad":
+            return c.badgeBad;
+        default:
+            return c.badgeNeutral;
+    }
+}
+function JobRow({ job, c, actions, onSwitch, onRunNow, onSettled, extra, when, }) {
+    const on = useOptimisticValue(!job.paused, { onSettled });
+    // Health with the switch as the screen shows it, not as the server last said.
+    const health = on.value ? job.healthIfOn : { state: "paused" };
+    const words = describeHealth(health, when);
+    const Icon = ICONS[health.state];
+    const run = job.lastRun;
+    const success = job.lastSuccess;
+    const countsLine = run?.ok && run.counts.length
+        ? countsSummary(run.counts)
+        : success && !run?.ok
+            ? [describeRun(success, "Last success", when), countsSummary(success.counts)].filter(Boolean).join(": ")
+            : null;
+    const detail = health.state === "running" ? null : words.detail;
+    const switchLine = on.pending ? (on.value ? "Turning back on…" : "Pausing…") : describeSwitch(job, when);
+    const toggle = () => {
+        if (!onSwitch)
+            return;
+        const next = !on.value;
+        void on.set(next, async () => {
+            await onSwitch(job.id, next);
+        }, { error: next ? `Couldn't turn ${job.label} back on` : `Couldn't pause ${job.label}` });
+    };
+    const runNow = () => {
+        if (!onRunNow)
+            return;
+        void actions.run(job.id, () => onRunNow(job.id), {
+            success: (result) => (result && result.message) || `Ran ${job.label}.`,
+            error: `Couldn't run ${job.label}`,
+            // A failed run is on the ledger too, so the screen has something new to show either way.
+            onSuccess: () => onSettled?.(),
+            onError: () => onSettled?.(),
+        });
+    };
+    const running = actions.isPending(job.id);
+    const showSwitch = job.canSwitch && Boolean(onSwitch);
+    const showRunNow = job.runNow !== null && Boolean(onRunNow);
+    return (_jsxs("li", { className: c.row, "data-job": job.id, "data-health": health.state, children: [_jsxs("div", { className: c.body, children: [_jsxs("div", { className: c.heading, children: [_jsx("span", { className: c.label, children: job.label }), _jsxs("span", { className: cx(c.badge, toneClass(c, words)), children: [_jsx(Icon, { "aria-hidden": "true" }), words.label] })] }), _jsxs("p", { className: c.meta, children: [job.cadence, run ? ` · ${describeRun(run, "Last run", when)}` : ""] }), detail ? _jsx("p", { className: health.state === "failed" ? c.error : c.detail, children: detail }) : null, countsLine ? _jsx("p", { className: c.counts, children: countsLine }) : null, switchLine ? _jsx("p", { className: c.switched, children: switchLine }) : null, extra?.(job)] }), showSwitch || showRunNow ? (_jsxs("div", { className: c.actions, children: [showRunNow ? (_jsxs("button", { type: "button", className: c.runNow, onClick: runNow, disabled: running || !on.value, title: on.value ? undefined : "Switched off — turn it back on to run it", "data-busy": running ? "true" : undefined, "aria-label": `Run ${job.label} now`, children: [_jsx(Play, { "aria-hidden": "true" }), "Run now"] })) : null, showSwitch ? (_jsx("button", { type: "button", role: "switch", "aria-checked": on.value, "aria-label": job.label, "aria-busy": on.pending || undefined, className: cx(c.switch, on.value ? c.switchOn : c.switchOff), onClick: toggle, children: _jsx("span", { className: cx(c.thumb, on.value ? c.thumbOn : c.thumbOff) }) })) : null] })) : null] }));
+}
+//# sourceMappingURL=job-health-list.js.map

package/dist/jobs/job-health-list.js.map

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

package/dist/jobs/react-index.d.ts

@@ -0,0 +1,19 @@
+/**
+ * `@connextar/house/jobs/react` — the health screen's list, and the words it
+ * uses.
+ *
+ * Its own entry point because `@connextar/house/jobs` is server code: it
+ * checks the scheduler's secret with `node:crypto`, which no client bundle can
+ * load. Everything a client component needs — the list, the health and count
+ * wording, the view types — is here, and `entry-points.test.ts` follows the
+ * emitted imports to keep `node:` out of it.
+ *
+ * The switch and Run now go through `@connextar/house/ux` (`useOptimisticValue`,
+ * `useKeyedAction`), so a refusal is reported to the app's
+ * `ActionFeedbackProvider` and this module imports no toast library.
+ */
+export { countsSummary, describeSpan, formatDuration, formatMoney, type CountKind, type CountLine } from "./counts.js";
+export { describeHealth, describeRun, describeSwitch, formatDay, formatWhen, type HealthWords, type JobHealth, type JobHealthState, type JobRunView, type JobView, type WhenOptions, } from "./health.js";
+export { JOB_HEALTH_CLASS_NAMES, JobHealthList, type JobHealthClassNames, type JobHealthListProps, } from "./job-health-list.js";
+export type { RunNowScope } from "./registry.js";
+//# sourceMappingURL=react-index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"react-index.d.ts","sourceRoot":"","sources":["../../src/jobs/react-index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AACH,OAAO,EAAE,aAAa,EAAE,YAAY,EAAE,cAAc,EAAE,WAAW,EAAE,KAAK,SAAS,EAAE,KAAK,SAAS,EAAE,MAAM,aAAa,CAAC;AACvH,OAAO,EACL,cAAc,EACd,WAAW,EACX,cAAc,EACd,SAAS,EACT,UAAU,EACV,KAAK,WAAW,EAChB,KAAK,SAAS,EACd,KAAK,cAAc,EACnB,KAAK,UAAU,EACf,KAAK,OAAO,EACZ,KAAK,WAAW,GACjB,MAAM,aAAa,CAAC;AACrB,OAAO,EACL,sBAAsB,EACtB,aAAa,EACb,KAAK,mBAAmB,EACxB,KAAK,kBAAkB,GACxB,MAAM,sBAAsB,CAAC;AAC9B,YAAY,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC"}

package/dist/jobs/react-index.js

@@ -0,0 +1,18 @@
+/**
+ * `@connextar/house/jobs/react` — the health screen's list, and the words it
+ * uses.
+ *
+ * Its own entry point because `@connextar/house/jobs` is server code: it
+ * checks the scheduler's secret with `node:crypto`, which no client bundle can
+ * load. Everything a client component needs — the list, the health and count
+ * wording, the view types — is here, and `entry-points.test.ts` follows the
+ * emitted imports to keep `node:` out of it.
+ *
+ * The switch and Run now go through `@connextar/house/ux` (`useOptimisticValue`,
+ * `useKeyedAction`), so a refusal is reported to the app's
+ * `ActionFeedbackProvider` and this module imports no toast library.
+ */
+export { countsSummary, describeSpan, formatDuration, formatMoney } from "./counts.js";
+export { describeHealth, describeRun, describeSwitch, formatDay, formatWhen, } from "./health.js";
+export { JOB_HEALTH_CLASS_NAMES, JobHealthList, } from "./job-health-list.js";
+//# sourceMappingURL=react-index.js.map

package/dist/jobs/react-index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"react-index.js","sourceRoot":"","sources":["../../src/jobs/react-index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AACH,OAAO,EAAE,aAAa,EAAE,YAAY,EAAE,cAAc,EAAE,WAAW,EAAkC,MAAM,aAAa,CAAC;AACvH,OAAO,EACL,cAAc,EACd,WAAW,EACX,cAAc,EACd,SAAS,EACT,UAAU,GAOX,MAAM,aAAa,CAAC;AACrB,OAAO,EACL,sBAAsB,EACtB,aAAa,GAGd,MAAM,sBAAsB,CAAC"}

package/dist/jobs/registry.d.ts

@@ -0,0 +1,104 @@
+import type { CountDeclarations, CountValues } from "./counts.js";
+import type { JobWindow } from "./windows.js";
+/** Who did something: pressed Run now, switched a job off. Named, because the card says who. */
+export interface JobActor {
+    id: string;
+    name: string;
+}
+/**
+ * Who a manual run may sweep.
+ *
+ * - `tenant` — only the caller's own tenant. Quickie's owners: every signup owns
+ *   an organisation, so an unscoped Run now would let anyone fire every tenant's
+ *   automations, emailing other businesses' customers.
+ * - `platform` — everything, which only someone with platform authority may ask
+ *   for. AltEd's administrators: AltEd is single-tenant, so every job is a sweep
+ *   over shared tables and there is no smaller slice to offer.
+ */
+export type RunNowScope = "tenant" | "platform";
+export interface RunNowRule {
+    scope: RunNowScope;
+    /**
+     * How soon the same caller's scope may run it again. Default ten minutes. A
+     * manual run skips the job's hour gates, so without this a second press sends
+     * the whole batch again. `0` turns it off.
+     */
+    cooldownMs?: number;
+}
+/** What a run is handed. */
+export interface JobContext {
+    now: Date;
+    trigger: "schedule" | "manual";
+    /**
+     * `null`: sweep every tenant (the schedule, or a platform Run now). A string:
+     * sweep **only** this tenant — a tenant-scoped Run now always has one, and the
+     * job must pass it down to every query it makes.
+     */
+    tenantId: string | null;
+    /** A manual run: skip the job's own hour gates. It is not a licence to skip a per-recipient throttle. */
+    force: boolean;
+    windowKey: string;
+    /** Who pressed Run now; `null` for the schedule. */
+    by: JobActor | null;
+}
+export interface JobDefinition<C extends CountDeclarations = CountDeclarations> {
+    /** Stable, and stored: the ledger's `job` column and the switch's key. Lower-case, `-` between words, ≤ 60. */
+    id: string;
+    /** What the card calls it: "Payment reminders". */
+    label: string;
+    /** When it runs, in words: "Daily, from 09:00". The window is the rule; this is how the card says it. */
+    cadence: string;
+    /**
+     * `tick` (the default): the dispatcher runs it from the app's one tick route.
+     * `own`: it has its own route and clock — AltEd's harvest every ten minutes,
+     * its import runner every minute — which calls `runOwn`. The tick never runs it.
+     */
+    schedule?: "tick" | "own";
+    /** Which window a moment is in, or `null` when not due. Required for `tick`; optional for `own`. */
+    window?: JobWindow;
+    /**
+     * How long without a successful whole run before the card says **Stale**.
+     * `null` for a job that runs only when there is work — an import runner idle
+     * all week is not stale.
+     */
+    staleAfterMs: number | null;
+    /** How long a run may go unfinished before the card calls it failed. Default 15 minutes. */
+    timeoutMs?: number;
+    /** Whether an administrator may switch it off. Default `true`. */
+    switchable?: boolean;
+    /** Whether Run now is offered, and over whom. Default: never. */
+    runNow?: false | RunNowRule;
+    /** Every number `run` reports, each with its words and kind. See `CountDeclaration`. */
+    counts: C;
+    run: (context: JobContext) => Promise<CountValues<C>>;
+}
+/** A job with its count types erased — how the registry holds a list of different ones. */
+export type AnyJob = JobDefinition<CountDeclarations>;
+/** `R`, with every key `C` does not declare forbidden. */
+type OnlyDeclared<R, C> = R & {
+    [K in Exclude<keyof R, keyof C>]: never;
+};
+/**
+ * A job's definition, checked against its own counts at compile time: `run`
+ * must report every count `counts` declares, and nothing it does not — a
+ * number with no declaration has no words to be shown in. (At run time an
+ * undeclared key is dropped before it is stored, so it cannot reach a screen
+ * either way.)
+ */
+export declare function defineJob<const C extends CountDeclarations, R extends CountValues<C>>(job: Omit<JobDefinition<C>, "run"> & {
+    run: (context: JobContext) => Promise<OnlyDeclared<R, C>>;
+}): AnyJob;
+export declare const DEFAULT_TIMEOUT_MS: number;
+export declare const DEFAULT_COOLDOWN_MS: number;
+export declare const MAX_JOB_ID = 60;
+export declare const MAX_WINDOW_KEY = 120;
+/**
+ * Every way a list of jobs is wrong, as sentences — the same shape as
+ * `releaseHistoryProblems`, so a test can assert it is empty and read the
+ * failure when it is not.
+ */
+export declare function jobDefinitionProblems(jobs: readonly AnyJob[]): string[];
+/** The app's job list, checked once, when the module that declares it loads. Throws every problem at once. */
+export declare function defineJobs(jobs: readonly AnyJob[]): readonly AnyJob[];
+export {};
+//# sourceMappingURL=registry.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/jobs/registry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAClE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAE9C,gGAAgG;AAChG,MAAM,WAAW,QAAQ;IACvB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;;;;;;;;GASG;AACH,MAAM,MAAM,WAAW,GAAG,QAAQ,GAAG,UAAU,CAAC;AAEhD,MAAM,WAAW,UAAU;IACzB,KAAK,EAAE,WAAW,CAAC;IACnB;;;;OAIG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,4BAA4B;AAC5B,MAAM,WAAW,UAAU;IACzB,GAAG,EAAE,IAAI,CAAC;IACV,OAAO,EAAE,UAAU,GAAG,QAAQ,CAAC;IAC/B;;;;OAIG;IACH,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,yGAAyG;IACzG,KAAK,EAAE,OAAO,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,oDAAoD;IACpD,EAAE,EAAE,QAAQ,GAAG,IAAI,CAAC;CACrB;AAED,MAAM,WAAW,aAAa,CAAC,CAAC,SAAS,iBAAiB,GAAG,iBAAiB;IAC5E,+GAA+G;IAC/G,EAAE,EAAE,MAAM,CAAC;IACX,mDAAmD;IACnD,KAAK,EAAE,MAAM,CAAC;IACd,yGAAyG;IACzG,OAAO,EAAE,MAAM,CAAC;IAChB;;;;OAIG;IACH,QAAQ,CAAC,EAAE,MAAM,GAAG,KAAK,CAAC;IAC1B,oGAAoG;IACpG,MAAM,CAAC,EAAE,SAAS,CAAC;IACnB;;;;OAIG;IACH,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,4FAA4F;IAC5F,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,kEAAkE;IAClE,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,iEAAiE;IACjE,MAAM,CAAC,EAAE,KAAK,GAAG,UAAU,CAAC;IAC5B,wFAAwF;IACxF,MAAM,EAAE,CAAC,CAAC;IACV,GAAG,EAAE,CAAC,OAAO,EAAE,UAAU,KAAK,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC;CACvD;AAED,2FAA2F;AAC3F,MAAM,MAAM,MAAM,GAAG,aAAa,CAAC,iBAAiB,CAAC,CAAC;AAEtD,0DAA0D;AAC1D,KAAK,YAAY,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC,GAAG;KAAG,CAAC,IAAI,OAAO,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC,CAAC,GAAG,KAAK;CAAE,CAAC;AAE1E;;;;;;GAMG;AACH,wBAAgB,SAAS,CAAC,KAAK,CAAC,CAAC,SAAS,iBAAiB,EAAE,CAAC,SAAS,WAAW,CAAC,CAAC,CAAC,EACnF,GAAG,EAAE,IAAI,CAAC,aAAa,CAAC,CAAC,CAAC,EAAE,KAAK,CAAC,GAAG;IAAE,GAAG,EAAE,CAAC,OAAO,EAAE,UAAU,KAAK,OAAO,CAAC,YAAY,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAA;CAAE,GACjG,MAAM,CAER;AAED,eAAO,MAAM,kBAAkB,QAAiB,CAAC;AACjD,eAAO,MAAM,mBAAmB,QAAiB,CAAC;AAClD,eAAO,MAAM,UAAU,KAAK,CAAC;AAC7B,eAAO,MAAM,cAAc,MAAM,CAAC;AAMlC;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,GAAG,MAAM,EAAE,CA2CvE;AAED,8GAA8G;AAC9G,wBAAgB,UAAU,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,GAAG,SAAS,MAAM,EAAE,CAIrE"}

package/dist/jobs/registry.js

@@ -0,0 +1,72 @@
+/**
+ * A job's definition, checked against its own counts at compile time: `run`
+ * must report every count `counts` declares, and nothing it does not — a
+ * number with no declaration has no words to be shown in. (At run time an
+ * undeclared key is dropped before it is stored, so it cannot reach a screen
+ * either way.)
+ */
+export function defineJob(job) {
+    return job;
+}
+export const DEFAULT_TIMEOUT_MS = 15 * 60 * 1000;
+export const DEFAULT_COOLDOWN_MS = 10 * 60 * 1000;
+export const MAX_JOB_ID = 60;
+export const MAX_WINDOW_KEY = 120;
+const ID = /^[a-z0-9]+(?:-[a-z0-9]+)*$/;
+const positive = (value) => typeof value === "number" && Number.isFinite(value) && value > 0;
+/**
+ * Every way a list of jobs is wrong, as sentences — the same shape as
+ * `releaseHistoryProblems`, so a test can assert it is empty and read the
+ * failure when it is not.
+ */
+export function jobDefinitionProblems(jobs) {
+    const problems = [];
+    const seen = new Set();
+    for (const job of jobs) {
+        const name = job.id || "(a job with no id)";
+        if (!ID.test(job.id) || job.id.length > MAX_JOB_ID) {
+            problems.push(`"${name}" is not a job id: lower-case letters and digits, "-" between words, ${MAX_JOB_ID} at most.`);
+        }
+        if (seen.has(job.id))
+            problems.push(`"${name}" is declared twice.`);
+        seen.add(job.id);
+        if (!job.label?.trim())
+            problems.push(`"${name}" has no label.`);
+        if (!job.cadence?.trim())
+            problems.push(`"${name}" has no cadence — say when it runs, in words.`);
+        if ((job.schedule ?? "tick") === "tick" && typeof job.window !== "function") {
+            problems.push(`"${name}" runs from the tick but has no window, so it could never be due.`);
+        }
+        if (job.staleAfterMs !== null && !positive(job.staleAfterMs)) {
+            problems.push(`"${name}" needs a staleness threshold in milliseconds, or null for a job that runs only on demand.`);
+        }
+        if (job.timeoutMs !== undefined && !positive(job.timeoutMs))
+            problems.push(`"${name}" has a timeout that is not positive.`);
+        if (job.runNow) {
+            if (job.runNow.scope !== "tenant" && job.runNow.scope !== "platform") {
+                problems.push(`"${name}" offers Run now without saying over whom — "tenant" or "platform".`);
+            }
+            const cooldown = job.runNow.cooldownMs;
+            if (cooldown !== undefined && !(Number.isFinite(cooldown) && cooldown >= 0)) {
+                problems.push(`"${name}" has a Run now cool-down that is not zero or more.`);
+            }
+        }
+        for (const [key, count] of Object.entries(job.counts ?? {})) {
+            const words = typeof count.label === "string" ? count.label : `${count.label?.one ?? ""}${count.label?.other ?? ""}`;
+            if (!words.trim())
+                problems.push(`"${name}" reports "${key}" with no label, which would show as a bare key.`);
+            if (count.kind === "money" && !/^[A-Z]{3}$/.test(count.currency ?? "")) {
+                problems.push(`"${name}" reports "${key}" as money with no ISO currency code.`);
+            }
+        }
+    }
+    return problems;
+}
+/** The app's job list, checked once, when the module that declares it loads. Throws every problem at once. */
+export function defineJobs(jobs) {
+    const problems = jobDefinitionProblems(jobs);
+    if (problems.length)
+        throw new Error(`The scheduled jobs are misdeclared:\n- ${problems.join("\n- ")}`);
+    return Object.freeze([...jobs]);
+}
+//# sourceMappingURL=registry.js.map

package/dist/jobs/registry.js.map

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

package/dist/jobs/scheduler.d.ts

@@ -0,0 +1,89 @@
+import { type CountFormatOptions, type CountLine } from "./counts.js";
+import { type JobAudience, type JobView } from "./health.js";
+import { type AnyJob, type JobActor } from "./registry.js";
+import type { JobStore } from "./store.js";
+/** What the tick did with one job. */
+export type TickStatus = "ran" | "failed" | "already-ran" | "not-due" | "paused";
+export interface TickResult {
+    job: string;
+    status: TickStatus;
+    windowKey?: string;
+    counts?: Record<string, number>;
+    error?: string;
+    /** One sentence, for the route's answer and the log. */
+    message: string;
+}
+export type RunNowRefusal = "unknown" | "not-runnable" | "out-of-scope" | "paused" | "running" | "too-soon";
+export type RunNowOutcome = {
+    status: "ran";
+    job: string;
+    windowKey: string;
+    counts: CountLine[];
+    message: string;
+} | {
+    status: "failed";
+    job: string;
+    windowKey: string;
+    error: string;
+    message: string;
+} | {
+    status: "refused";
+    job: string;
+    reason: RunNowRefusal;
+    message: string;
+};
+export type SwitchRefusal = "unknown" | "not-switchable" | "out-of-scope";
+export type SwitchOutcome = {
+    status: "switched" | "unchanged";
+    job: string;
+    paused: boolean;
+    message: string;
+} | {
+    status: "refused";
+    job: string;
+    reason: SwitchRefusal;
+    message: string;
+};
+/** Who pressed Run now, and what they may reach. The app has already checked they are signed in and may use the screen. */
+export interface RunNowCaller extends JobAudience {
+    actor: JobActor;
+}
+export interface SwitchCaller {
+    actor: JobActor;
+    /** Switching a job off stops it for every tenant, so it takes platform authority. */
+    platform: boolean;
+}
+export interface SchedulerOptions extends CountFormatOptions {
+    jobs: readonly AnyJob[];
+    store: JobStore;
+    /** How long a run may stay unfinished before it reads as failed, for jobs that do not say. Default 15 minutes. */
+    timeoutMs?: number;
+    /** The clock. Tests pass one; everything else leaves it. */
+    clock?: () => Date;
+}
+export interface Scheduler {
+    readonly jobs: readonly AnyJob[];
+    /** The tick route's whole body: every `tick` job whose window is open, once per window, one failure isolated. */
+    tick(now?: Date): Promise<TickResult[]>;
+    /** An own-schedule job's route: the switch, its window if it has one, the ledger. */
+    runOwn(jobId: string, now?: Date): Promise<TickResult>;
+    /** Run now — refused unless the job offers it, over a scope the caller holds. */
+    runNow(jobId: string, caller: RunNowCaller, now?: Date): Promise<RunNowOutcome>;
+    /** Switch a job off or on, recording who and when. */
+    setPaused(jobId: string, paused: boolean, caller: SwitchCaller, now?: Date): Promise<SwitchOutcome>;
+    /** Every job as the health screen draws it, for this viewer. */
+    views(audience: JobAudience, now?: Date): Promise<JobView[]>;
+}
+/**
+ * The dispatcher, and everything else that touches the ledger.
+ *
+ * Declared once in the app beside its jobs and its store adapter; the tick
+ * route, the own-schedule routes, the Run now and switch routes and the health
+ * page all call this one object.
+ */
+export declare function createScheduler(options: SchedulerOptions): Scheduler;
+/** The tick in one line: "2 ran, 1 failed, 1 paused, 5 not due". */
+export declare function summariseTick(results: readonly TickResult[]): string;
+/** The HTTP status a refusal maps to, so every app answers the same refusal the same way. */
+export declare function refusalStatus(reason: RunNowRefusal | SwitchRefusal): 403 | 404 | 409 | 429;
+//# sourceMappingURL=scheduler.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"scheduler.d.ts","sourceRoot":"","sources":["../../src/jobs/scheduler.ts"],"names":[],"mappings":"AACA,OAAO,EAA6C,KAAK,kBAAkB,EAAE,KAAK,SAAS,EAAE,MAAM,aAAa,CAAC;AACjH,OAAO,EAA8C,KAAK,WAAW,EAAE,KAAK,OAAO,EAAE,MAAM,aAAa,CAAC;AACzG,OAAO,EAIL,KAAK,MAAM,EACX,KAAK,QAAQ,EAEd,MAAM,eAAe,CAAC;AACvB,OAAO,KAAK,EAAE,QAAQ,EAAkB,MAAM,YAAY,CAAC;AAG3D,sCAAsC;AACtC,MAAM,MAAM,UAAU,GAAG,KAAK,GAAG,QAAQ,GAAG,aAAa,GAAG,SAAS,GAAG,QAAQ,CAAC;AAEjF,MAAM,WAAW,UAAU;IACzB,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,UAAU,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAChC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,wDAAwD;IACxD,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,MAAM,aAAa,GAAG,SAAS,GAAG,cAAc,GAAG,cAAc,GAAG,QAAQ,GAAG,SAAS,GAAG,UAAU,CAAC;AAE5G,MAAM,MAAM,aAAa,GACrB;IAAE,MAAM,EAAE,KAAK,CAAC;IAAC,GAAG,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,SAAS,EAAE,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GACvF;IAAE,MAAM,EAAE,QAAQ,CAAC;IAAC,GAAG,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GACpF;IAAE,MAAM,EAAE,SAAS,CAAC;IAAC,GAAG,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,aAAa,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC;AAE/E,MAAM,MAAM,aAAa,GAAG,SAAS,GAAG,gBAAgB,GAAG,cAAc,CAAC;AAE1E,MAAM,MAAM,aAAa,GACrB;IAAE,MAAM,EAAE,UAAU,GAAG,WAAW,CAAC;IAAC,GAAG,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,OAAO,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GACnF;IAAE,MAAM,EAAE,SAAS,CAAC;IAAC,GAAG,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,aAAa,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC;AAE/E,2HAA2H;AAC3H,MAAM,WAAW,YAAa,SAAQ,WAAW;IAC/C,KAAK,EAAE,QAAQ,CAAC;CACjB;AAED,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,QAAQ,CAAC;IAChB,qFAAqF;IACrF,QAAQ,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,WAAW,gBAAiB,SAAQ,kBAAkB;IAC1D,IAAI,EAAE,SAAS,MAAM,EAAE,CAAC;IACxB,KAAK,EAAE,QAAQ,CAAC;IAChB,kHAAkH;IAClH,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,4DAA4D;IAC5D,KAAK,CAAC,EAAE,MAAM,IAAI,CAAC;CACpB;AAED,MAAM,WAAW,SAAS;IACxB,QAAQ,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,CAAC;IACjC,iHAAiH;IACjH,IAAI,CAAC,GAAG,CAAC,EAAE,IAAI,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC,CAAC;IACxC,qFAAqF;IACrF,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,IAAI,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;IACvD,iFAAiF;IACjF,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,YAAY,EAAE,GAAG,CAAC,EAAE,IAAI,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC;IAChF,sDAAsD;IACtD,SAAS,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,YAAY,EAAE,GAAG,CAAC,EAAE,IAAI,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC;IACpG,gEAAgE;IAChE,KAAK,CAAC,QAAQ,EAAE,WAAW,EAAE,GAAG,CAAC,EAAE,IAAI,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC;CAC9D;AAcD;;;;;;GAMG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,gBAAgB,GAAG,SAAS,CAoQpE;AAED,oEAAoE;AACpE,wBAAgB,aAAa,CAAC,OAAO,EAAE,SAAS,UAAU,EAAE,GAAG,MAAM,CAapE;AAED,6FAA6F;AAC7F,wBAAgB,aAAa,CAAC,MAAM,EAAE,aAAa,GAAG,aAAa,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,CAc1F"}