@connextar/house 0.10.0 → 0.12.0

package/dist/jobs/index.d.ts

@@ -0,0 +1,27 @@
+/**
+ * `@connextar/house/jobs` — scheduled jobs: declared once, run once per
+ * window, switched off and on by name, and honest about their health.
+ *
+ * AltEd and Quickie each wrote this, from the same seed, and each went on to
+ * prove something the other had not: AltEd that a job must be switchable with a
+ * name and a date against it, and that some jobs run on their own clock;
+ * Quickie that Run now must be fenced to the caller's own tenant. Both printed
+ * a job's result as its variable names. This is the union, with that made
+ * impossible: a count reaches the screen only through its declaration.
+ *
+ * Server code. It owns no schema — the app implements `JobStore` over its own
+ * table (the README has the Prisma model and adapter) — and it imports no
+ * framework: the only thing it reaches for is `node:crypto`, in the tick
+ * route's secret check. The health list is `@connextar/house/jobs/react`,
+ * which re-exports the words and types a client component needs, so nothing
+ * in the browser ever imports this entry.
+ */
+export { checkCronRequest, type CronAuthOptions, type CronAuthResult } from "./cron-auth.js";
+export { countLines, countsSummary, declaredCounts, describeSpan, formatCount, formatDuration, formatMoney, type CountDeclaration, type CountDeclarations, type CountFormatOptions, type CountKind, type CountLabel, type CountLine, type CountValues, } from "./counts.js";
+export { buildJobView, deriveHealth, describeHealth, describeRun, describeSwitch, formatDay, formatWhen, runNowFor, runNowScopesFor, type HealthInput, type HealthWords, type JobAudience, type JobFacts, type JobHealth, type JobHealthState, type JobRunView, type JobView, type RunFacts, type WhenOptions, } from "./health.js";
+export { DEFAULT_COOLDOWN_MS, DEFAULT_TIMEOUT_MS, MAX_JOB_ID, MAX_WINDOW_KEY, defineJob, defineJobs, jobDefinitionProblems, runNowScopes, type AnyJob, type JobActor, type JobContext, type JobDefinition, type RunNowRule, type RunNowScope, } from "./registry.js";
+export { DEFAULT_JOB_RUN_PRUNE_BATCH, DEFAULT_JOB_RUN_RETENTION_DAYS, JOB_RUN_PRUNE_COUNTS, pruneJobRuns, type JobRunPruneCounts, type PruneJobRunsOptions, } from "./prune.js";
+export { createScheduler, refusalStatus, summariseTick, type RunNowCaller, type RunNowOutcome, type RunNowRefusal, type Scheduler, type SchedulerOptions, type SwitchCaller, type SwitchOutcome, type SwitchRefusal, type TickResult, type TickStatus, } from "./scheduler.js";
+export { createMemoryJobStore, pausedFromStored, type JobRunClaim, type JobRunOutcome, type JobRunPrune, type JobRunQuery, type JobRunRecord, type JobStore, type JobSwitchChange, type JobSwitchState, } from "./store.js";
+export { MANUAL_KEY_PREFIX, daily, everyHours, hourly, isManualKey, monthly, weekly, type CalendarWindowOptions, type JobWindow, } from "./windows.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;;;;;;;;;;;;;;;;;GAiBG;AACH,OAAO,EAAE,gBAAgB,EAAE,KAAK,eAAe,EAAE,KAAK,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAC7F,OAAO,EACL,UAAU,EACV,aAAa,EACb,cAAc,EACd,YAAY,EACZ,WAAW,EACX,cAAc,EACd,WAAW,EACX,KAAK,gBAAgB,EACrB,KAAK,iBAAiB,EACtB,KAAK,kBAAkB,EACvB,KAAK,SAAS,EACd,KAAK,UAAU,EACf,KAAK,SAAS,EACd,KAAK,WAAW,GACjB,MAAM,aAAa,CAAC;AACrB,OAAO,EACL,YAAY,EACZ,YAAY,EACZ,cAAc,EACd,WAAW,EACX,cAAc,EACd,SAAS,EACT,UAAU,EACV,SAAS,EACT,eAAe,EACf,KAAK,WAAW,EAChB,KAAK,WAAW,EAChB,KAAK,WAAW,EAChB,KAAK,QAAQ,EACb,KAAK,SAAS,EACd,KAAK,cAAc,EACnB,KAAK,UAAU,EACf,KAAK,OAAO,EACZ,KAAK,QAAQ,EACb,KAAK,WAAW,GACjB,MAAM,aAAa,CAAC;AACrB,OAAO,EACL,mBAAmB,EACnB,kBAAkB,EAClB,UAAU,EACV,cAAc,EACd,SAAS,EACT,UAAU,EACV,qBAAqB,EACrB,YAAY,EACZ,KAAK,MAAM,EACX,KAAK,QAAQ,EACb,KAAK,UAAU,EACf,KAAK,aAAa,EAClB,KAAK,UAAU,EACf,KAAK,WAAW,GACjB,MAAM,eAAe,CAAC;AACvB,OAAO,EACL,2BAA2B,EAC3B,8BAA8B,EAC9B,oBAAoB,EACpB,YAAY,EACZ,KAAK,iBAAiB,EACtB,KAAK,mBAAmB,GACzB,MAAM,YAAY,CAAC;AACpB,OAAO,EACL,eAAe,EACf,aAAa,EACb,aAAa,EACb,KAAK,YAAY,EACjB,KAAK,aAAa,EAClB,KAAK,aAAa,EAClB,KAAK,SAAS,EACd,KAAK,gBAAgB,EACrB,KAAK,YAAY,EACjB,KAAK,aAAa,EAClB,KAAK,aAAa,EAClB,KAAK,UAAU,EACf,KAAK,UAAU,GAChB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EACL,oBAAoB,EACpB,gBAAgB,EAChB,KAAK,WAAW,EAChB,KAAK,aAAa,EAClB,KAAK,WAAW,EAChB,KAAK,WAAW,EAChB,KAAK,YAAY,EACjB,KAAK,QAAQ,EACb,KAAK,eAAe,EACpB,KAAK,cAAc,GACpB,MAAM,YAAY,CAAC;AACpB,OAAO,EACL,iBAAiB,EACjB,KAAK,EACL,UAAU,EACV,MAAM,EACN,WAAW,EACX,OAAO,EACP,MAAM,EACN,KAAK,qBAAqB,EAC1B,KAAK,SAAS,GACf,MAAM,cAAc,CAAC"}

package/dist/jobs/index.js

@@ -0,0 +1,27 @@
+/**
+ * `@connextar/house/jobs` — scheduled jobs: declared once, run once per
+ * window, switched off and on by name, and honest about their health.
+ *
+ * AltEd and Quickie each wrote this, from the same seed, and each went on to
+ * prove something the other had not: AltEd that a job must be switchable with a
+ * name and a date against it, and that some jobs run on their own clock;
+ * Quickie that Run now must be fenced to the caller's own tenant. Both printed
+ * a job's result as its variable names. This is the union, with that made
+ * impossible: a count reaches the screen only through its declaration.
+ *
+ * Server code. It owns no schema — the app implements `JobStore` over its own
+ * table (the README has the Prisma model and adapter) — and it imports no
+ * framework: the only thing it reaches for is `node:crypto`, in the tick
+ * route's secret check. The health list is `@connextar/house/jobs/react`,
+ * which re-exports the words and types a client component needs, so nothing
+ * in the browser ever imports this entry.
+ */
+export { checkCronRequest } from "./cron-auth.js";
+export { countLines, countsSummary, declaredCounts, describeSpan, formatCount, formatDuration, formatMoney, } from "./counts.js";
+export { buildJobView, deriveHealth, describeHealth, describeRun, describeSwitch, formatDay, formatWhen, runNowFor, runNowScopesFor, } from "./health.js";
+export { DEFAULT_COOLDOWN_MS, DEFAULT_TIMEOUT_MS, MAX_JOB_ID, MAX_WINDOW_KEY, defineJob, defineJobs, jobDefinitionProblems, runNowScopes, } from "./registry.js";
+export { DEFAULT_JOB_RUN_PRUNE_BATCH, DEFAULT_JOB_RUN_RETENTION_DAYS, JOB_RUN_PRUNE_COUNTS, pruneJobRuns, } from "./prune.js";
+export { createScheduler, refusalStatus, summariseTick, } from "./scheduler.js";
+export { createMemoryJobStore, pausedFromStored, } from "./store.js";
+export { MANUAL_KEY_PREFIX, daily, everyHours, hourly, isManualKey, monthly, weekly, } from "./windows.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":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AACH,OAAO,EAAE,gBAAgB,EAA6C,MAAM,gBAAgB,CAAC;AAC7F,OAAO,EACL,UAAU,EACV,aAAa,EACb,cAAc,EACd,YAAY,EACZ,WAAW,EACX,cAAc,EACd,WAAW,GAQZ,MAAM,aAAa,CAAC;AACrB,OAAO,EACL,YAAY,EACZ,YAAY,EACZ,cAAc,EACd,WAAW,EACX,cAAc,EACd,SAAS,EACT,UAAU,EACV,SAAS,EACT,eAAe,GAWhB,MAAM,aAAa,CAAC;AACrB,OAAO,EACL,mBAAmB,EACnB,kBAAkB,EAClB,UAAU,EACV,cAAc,EACd,SAAS,EACT,UAAU,EACV,qBAAqB,EACrB,YAAY,GAOb,MAAM,eAAe,CAAC;AACvB,OAAO,EACL,2BAA2B,EAC3B,8BAA8B,EAC9B,oBAAoB,EACpB,YAAY,GAGb,MAAM,YAAY,CAAC;AACpB,OAAO,EACL,eAAe,EACf,aAAa,EACb,aAAa,GAWd,MAAM,gBAAgB,CAAC;AACxB,OAAO,EACL,oBAAoB,EACpB,gBAAgB,GASjB,MAAM,YAAY,CAAC;AACpB,OAAO,EACL,iBAAiB,EACjB,KAAK,EACL,UAAU,EACV,MAAM,EACN,WAAW,EACX,OAAO,EACP,MAAM,GAGP,MAAM,cAAc,CAAC"}

package/dist/jobs/job-health-list.d.ts

@@ -0,0 +1,78 @@
+import * as React from "react";
+import { type JobView, type WhenOptions } from "./health.js";
+import type { RunNowScope } from "./registry.js";
+/** Every element the list draws. Each value replaces the default for that part. */
+export interface JobHealthClassNames {
+    list: string;
+    empty: string;
+    row: string;
+    body: string;
+    heading: string;
+    label: string;
+    badge: string;
+    badgeGood: string;
+    badgeNeutral: string;
+    badgeWarning: string;
+    badgeBad: string;
+    meta: string;
+    detail: string;
+    error: string;
+    counts: string;
+    switched: string;
+    actions: string;
+    runNow: string;
+    switch: string;
+    switchOn: string;
+    switchOff: string;
+    thumb: string;
+    thumbOn: string;
+    thumbOff: string;
+}
+/** The house look, on the shared theme tokens. */
+export declare const JOB_HEALTH_CLASS_NAMES: JobHealthClassNames;
+export interface JobHealthListProps extends WhenOptions {
+    /** From `scheduler.views(audience)` on the server. */
+    jobs: readonly JobView[];
+    /**
+     * Switch a job. **Throw to refuse**, with the reason as the message — the
+     * switch goes back where it was and the reason is reported through the
+     * `ActionFeedbackProvider`. Without it no switch is drawn.
+     */
+    onSwitch?: (jobId: string, on: boolean) => Promise<void>;
+    /**
+     * Run a job now, over `scope` — the button pressed. Resolve with the route's
+     * `message` to have it said; throw to refuse. Send the scope to the route and
+     * on to `scheduler.runNow` as the caller's `scope`: on a job that offers both,
+     * it is what tells the two buttons apart.
+     */
+    onRunNow?: (jobId: string, scope: RunNowScope) => Promise<{
+        message?: string;
+    } | void>;
+    /**
+     * What each Run now sweeps, in the app's words, for a row that offers this
+     * viewer both — "Run for every organisation", "Run for yours". A row with one
+     * says only "Run now". Default "every account" and "your account".
+     */
+    runNowWords?: Partial<Record<RunNowScope, string>>;
+    /** After a switch lands or a run finishes — usually `router.refresh()`. */
+    onSettled?: () => void;
+    /** Anything of the app's own under a row: AltEd's link to the harvest's screen. */
+    extra?: (job: JobView) => React.ReactNode;
+    emptyText?: React.ReactNode;
+    className?: string;
+    classNames?: Partial<JobHealthClassNames>;
+}
+/**
+ * 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 declare function JobHealthList({ jobs, onSwitch, onRunNow, onSettled, runNowWords, extra, emptyText, className, classNames, locale, timeZone, }: JobHealthListProps): React.JSX.Element;
+//# sourceMappingURL=job-health-list.d.ts.map

package/dist/jobs/job-health-list.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"job-health-list.d.ts","sourceRoot":"","sources":["../../src/jobs/job-health-list.tsx"],"names":[],"mappings":"AAYA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAM/B,OAAO,EAML,KAAK,OAAO,EACZ,KAAK,WAAW,EACjB,MAAM,aAAa,CAAC;AACrB,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAEjD,mFAAmF;AACnF,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,kDAAkD;AAClD,eAAO,MAAM,sBAAsB,EAAE,mBA2BpC,CAAC;AAWF,MAAM,WAAW,kBAAmB,SAAQ,WAAW;IACrD,sDAAsD;IACtD,IAAI,EAAE,SAAS,OAAO,EAAE,CAAC;IACzB;;;;OAIG;IACH,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,EAAE,OAAO,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACzD;;;;;OAKG;IACH,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,WAAW,KAAK,OAAO,CAAC;QAAE,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC,CAAC;IACvF;;;;OAIG;IACH,WAAW,CAAC,EAAE,OAAO,CAAC,MAAM,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC,CAAC;IACnD,2EAA2E;IAC3E,SAAS,CAAC,EAAE,MAAM,IAAI,CAAC;IACvB,mFAAmF;IACnF,KAAK,CAAC,EAAE,CAAC,GAAG,EAAE,OAAO,KAAK,KAAK,CAAC,SAAS,CAAC;IAC1C,SAAS,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IAC5B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,OAAO,CAAC,mBAAmB,CAAC,CAAC;CAC3C;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,aAAa,CAAC,EAC5B,IAAI,EACJ,QAAQ,EACR,QAAQ,EACR,SAAS,EACT,WAAW,EACX,KAAK,EACL,SAAgC,EAChC,SAAS,EACT,UAAU,EACV,MAAM,EACN,QAAQ,GACT,EAAE,kBAAkB,qBAsBpB"}

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

@@ -0,0 +1,119 @@
+"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, runNowWords, 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, scopeWords: { ...RUN_NOW_WORDS, ...runNowWords }, extra: extra, when: { locale, timeZone } }, job.id))) }));
+}
+const RUN_NOW_WORDS = { tenant: "your account", platform: "every account" };
+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, scopeWords, 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 = (scope) => {
+        if (!onRunNow)
+            return;
+        // Keyed on the job, not the scope: while one of its runs is under way, neither button starts another.
+        void actions.run(job.id, () => onRunNow(job.id, scope), {
+            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);
+    // `runNow` null is the last word: a view an app narrowed by hand offers nothing.
+    const scopes = !onRunNow || job.runNow === null ? [] : job.runNowScopes.length ? job.runNowScopes : [job.runNow];
+    const showRunNow = scopes.length > 0;
+    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: [scopes.map((scope) => (_jsxs("button", { type: "button", className: c.runNow, onClick: () => runNow(scope), disabled: running || !on.value, title: on.value ? undefined : "Switched off — turn it back on to run it", "data-busy": running ? "true" : undefined, "data-scope": scope, "aria-label": scopes.length > 1 ? `Run ${job.label} now for ${scopeWords[scope]}` : `Run ${job.label} now`, children: [_jsx(Play, { "aria-hidden": "true" }), scopes.length > 1 ? `Run for ${scopeWords[scope]}` : "Run now"] }, scope))), 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/prune.d.ts

@@ -0,0 +1,45 @@
+import type { CountValues } from "./counts.js";
+import type { JobStore } from "./store.js";
+/** How long a run is kept, unless it is one health reads. */
+export declare const DEFAULT_JOB_RUN_RETENTION_DAYS = 90;
+/** At most this many rows a call, so one housekeeping run never holds the table for long. */
+export declare const DEFAULT_JOB_RUN_PRUNE_BATCH = 1000;
+/**
+ * What `pruneJobRuns` reports, declared so it reads "12 old job runs removed".
+ * Spread it into the housekeeping job's `counts`, and the result into what its
+ * `run` returns.
+ */
+export declare const JOB_RUN_PRUNE_COUNTS: {
+    readonly jobRunsPruned: {
+        readonly label: {
+            readonly one: "old job run removed";
+            readonly other: "old job runs removed";
+        };
+    };
+};
+export type JobRunPruneCounts = CountValues<typeof JOB_RUN_PRUNE_COUNTS>;
+export interface PruneJobRunsOptions {
+    /** The clock. The housekeeping job passes its `now`. */
+    now?: Date;
+    /**
+     * Keep every run for this many days. Default 90. At least 1 — a day, not a
+     * millisecond count, so `90` cannot be mistaken for 90 ms and empty the ledger.
+     */
+    retentionDays?: number;
+    /** Delete at most this many rows in the call. Default 1000. Whatever is left goes next time. */
+    batchLimit?: number;
+}
+/**
+ * Delete runs older than the retention period — never the latest run or the
+ * latest successful run of a job (per tenant, for tenants' own runs, and once
+ * for the runs over every tenant), and never one that has not finished — at
+ * most `batchLimit` of them, oldest first. Running it again straight away
+ * deletes only what the first call's limit left.
+ *
+ * ```ts
+ * counts: { windowsPruned: { label: "…" }, ...JOB_RUN_PRUNE_COUNTS },
+ * run: async ({ now }) => ({ windowsPruned: await pruneRateLimits(), ...(await pruneJobRuns(jobStore, { now })) }),
+ * ```
+ */
+export declare function pruneJobRuns(store: JobStore, options?: PruneJobRunsOptions): Promise<JobRunPruneCounts>;
+//# sourceMappingURL=prune.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"prune.d.ts","sourceRoot":"","sources":["../../src/jobs/prune.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAqB,WAAW,EAAE,MAAM,aAAa,CAAC;AAClE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAkB3C,6DAA6D;AAC7D,eAAO,MAAM,8BAA8B,KAAK,CAAC;AAEjD,6FAA6F;AAC7F,eAAO,MAAM,2BAA2B,OAAO,CAAC;AAEhD;;;;GAIG;AACH,eAAO,MAAM,oBAAoB;;;;;;;CAEK,CAAC;AAEvC,MAAM,MAAM,iBAAiB,GAAG,WAAW,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAEzE,MAAM,WAAW,mBAAmB;IAClC,wDAAwD;IACxD,GAAG,CAAC,EAAE,IAAI,CAAC;IACX;;;OAGG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,gGAAgG;IAChG,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;;;;;;;;;;GAWG;AACH,wBAAsB,YAAY,CAAC,KAAK,EAAE,QAAQ,EAAE,OAAO,GAAE,mBAAwB,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAkBjH"}

package/dist/jobs/prune.js

@@ -0,0 +1,58 @@
+/**
+ * Pruning the ledger — from the app's own housekeeping job, a bounded batch a
+ * day.
+ *
+ * The ledger grows without end (AltEd writes about 150 rows a day), and a Run
+ * now row keeps the name of whoever pressed it. Old rows are history, not
+ * state — with two exceptions, which are the whole of the care here. Health is
+ * read from the latest run and the latest successful run of each job (and, for
+ * a tenant's own Run now, of each job for that tenant). Delete those and a
+ * monthly job that last ran 120 days ago reads **Never run**; delete an
+ * unfinished one and a run under way loses its row. So those are never
+ * deleted, however old, and everything else past the retention period is.
+ */
+const DAY = 24 * 60 * 60 * 1000;
+/** How long a run is kept, unless it is one health reads. */
+export const DEFAULT_JOB_RUN_RETENTION_DAYS = 90;
+/** At most this many rows a call, so one housekeeping run never holds the table for long. */
+export const DEFAULT_JOB_RUN_PRUNE_BATCH = 1000;
+/**
+ * What `pruneJobRuns` reports, declared so it reads "12 old job runs removed".
+ * Spread it into the housekeeping job's `counts`, and the result into what its
+ * `run` returns.
+ */
+export const JOB_RUN_PRUNE_COUNTS = {
+    jobRunsPruned: { label: { one: "old job run removed", other: "old job runs removed" } },
+};
+/**
+ * Delete runs older than the retention period — never the latest run or the
+ * latest successful run of a job (per tenant, for tenants' own runs, and once
+ * for the runs over every tenant), and never one that has not finished — at
+ * most `batchLimit` of them, oldest first. Running it again straight away
+ * deletes only what the first call's limit left.
+ *
+ * ```ts
+ * counts: { windowsPruned: { label: "…" }, ...JOB_RUN_PRUNE_COUNTS },
+ * run: async ({ now }) => ({ windowsPruned: await pruneRateLimits(), ...(await pruneJobRuns(jobStore, { now })) }),
+ * ```
+ */
+export async function pruneJobRuns(store, options = {}) {
+    const retentionDays = options.retentionDays ?? DEFAULT_JOB_RUN_RETENTION_DAYS;
+    const limit = options.batchLimit ?? DEFAULT_JOB_RUN_PRUNE_BATCH;
+    if (!(Number.isFinite(retentionDays) && retentionDays >= 1)) {
+        throw new RangeError(`The job run retention is a number of days, at least 1 (got ${retentionDays}).`);
+    }
+    if (!(Number.isInteger(limit) && limit >= 1)) {
+        throw new RangeError(`The job run prune batch is a whole number of rows, at least 1 (got ${limit}).`);
+    }
+    if (typeof store.pruneRuns !== "function") {
+        throw new Error("This JobStore can't prune old runs: add pruneRuns to the adapter (the README has it).");
+    }
+    const now = options.now ?? new Date();
+    const deleted = await store.pruneRuns({ startedBefore: new Date(now.getTime() - retentionDays * DAY), limit });
+    if (!(Number.isInteger(deleted) && deleted >= 0)) {
+        throw new Error(`The JobStore's pruneRuns didn't say how many runs it deleted (got ${String(deleted)}).`);
+    }
+    return { jobRunsPruned: deleted };
+}
+//# sourceMappingURL=prune.js.map

package/dist/jobs/prune.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prune.js","sourceRoot":"","sources":["../../src/jobs/prune.ts"],"names":[],"mappings":"AAGA;;;;;;;;;;;;GAYG;AAEH,MAAM,GAAG,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC;AAEhC,6DAA6D;AAC7D,MAAM,CAAC,MAAM,8BAA8B,GAAG,EAAE,CAAC;AAEjD,6FAA6F;AAC7F,MAAM,CAAC,MAAM,2BAA2B,GAAG,IAAI,CAAC;AAEhD;;;;GAIG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG;IAClC,aAAa,EAAE,EAAE,KAAK,EAAE,EAAE,GAAG,EAAE,qBAAqB,EAAE,KAAK,EAAE,sBAAsB,EAAE,EAAE;CACnD,CAAC;AAgBvC;;;;;;;;;;;GAWG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,KAAe,EAAE,UAA+B,EAAE;IACnF,MAAM,aAAa,GAAG,OAAO,CAAC,aAAa,IAAI,8BAA8B,CAAC;IAC9E,MAAM,KAAK,GAAG,OAAO,CAAC,UAAU,IAAI,2BAA2B,CAAC;IAChE,IAAI,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,aAAa,CAAC,IAAI,aAAa,IAAI,CAAC,CAAC,EAAE,CAAC;QAC5D,MAAM,IAAI,UAAU,CAAC,8DAA8D,aAAa,IAAI,CAAC,CAAC;IACxG,CAAC;IACD,IAAI,CAAC,CAAC,MAAM,CAAC,SAAS,CAAC,KAAK,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC,EAAE,CAAC;QAC7C,MAAM,IAAI,UAAU,CAAC,sEAAsE,KAAK,IAAI,CAAC,CAAC;IACxG,CAAC;IACD,IAAI,OAAO,KAAK,CAAC,SAAS,KAAK,UAAU,EAAE,CAAC;QAC1C,MAAM,IAAI,KAAK,CAAC,uFAAuF,CAAC,CAAC;IAC3G,CAAC;IACD,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,IAAI,IAAI,IAAI,EAAE,CAAC;IACtC,MAAM,OAAO,GAAG,MAAM,KAAK,CAAC,SAAS,CAAC,EAAE,aAAa,EAAE,IAAI,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,GAAG,aAAa,GAAG,GAAG,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC;IAC/G,IAAI,CAAC,CAAC,MAAM,CAAC,SAAS,CAAC,OAAO,CAAC,IAAI,OAAO,IAAI,CAAC,CAAC,EAAE,CAAC;QACjD,MAAM,IAAI,KAAK,CAAC,qEAAqE,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IAC5G,CAAC;IACD,OAAO,EAAE,aAAa,EAAE,OAAO,EAAE,CAAC;AACpC,CAAC"}

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,119 @@
+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 {
+    /**
+     * Over whom Run now may sweep: one scope, or both.
+     *
+     * `["tenant", "platform"]` — Quickie's per-organisation jobs: an owner re-runs
+     * their own organisation, and an operator re-runs the sweep over every
+     * organisation when the overnight one failed. The two are fenced from each
+     * other: each has its own cool-down (a tenant's per tenant), neither starts
+     * while the other is in flight, and only the platform run counts for the
+     * job's health. Offering both needs `JobStore.latestUnfinishedRun`.
+     */
+    scope: RunNowScope | readonly RunNowScope[];
+    /**
+     * How soon the same scope may run it again — per tenant for a tenant run.
+     * 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;
+}
+/**
+ * The scopes a rule offers, narrowest first, each once: `["tenant"]`,
+ * `["platform"]` or `["tenant", "platform"]`. Nothing when Run now is off.
+ */
+export declare function runNowScopes(rule: false | RunNowRule | undefined): RunNowScope[];
+/** 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":"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"}