@connextar/house 0.9.0 → 0.11.0

package/dist/ai/provider.js

@@ -58,11 +58,6 @@ export class AiUnusableAnswerError extends AiUnavailableError {
         this.usage = usage;
     }
 }
-/** The image types both providers accept inline. */
-export const AI_IMAGE_TYPES = ["image/jpeg", "image/png", "image/gif", "image/webp"];
-export function isAiImageType(value) {
-    return AI_IMAGE_TYPES.includes(value);
-}
 /**
  * An OpenAI reasoning model bills its thinking against the same budget as its
  * answer, so a 900-token ceiling can be spent entirely before the prose starts.

package/dist/ai/provider.js.map

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

package/dist/jobs/counts.d.ts

@@ -0,0 +1,82 @@
+/**
+ * What a run did, in words a person reads.
+ *
+ * Both apps stored a job's result as `Record<string, number>` and printed it
+ * key by key, so production showed "0 chargesRaised · 0 totalOutstanding" —
+ * a variable name where a sentence belonged, and an amount of money printed as
+ * if it were a number of things. The fix is not a better printer. It is that a
+ * count cannot reach the screen without having been declared: every key has
+ * the words that follow its number, and a kind that says how the number is
+ * written. An undeclared key is not shown at all, so there is no fallback for
+ * a raw name to slip through.
+ *
+ * No imports: this runs in a server component, a route and a client card alike.
+ */
+export type CountKind = "count" | "money" | "duration";
+/** The words after the number: one form, or a singular and a plural. */
+export type CountLabel = string | {
+    one: string;
+    other: string;
+};
+/**
+ * One thing a job reports. The label is what follows the number —
+ * "reminders sent", so the line reads "3 reminders sent".
+ *
+ * Money says its currency **and its unit**, because the two apps already
+ * disagree: AltEd's `totalOutstanding` is pounds, summed from a decimal column,
+ * while a new job would count pence. A declaration that left the unit to a
+ * default would be out by a factor of a hundred for one of them.
+ */
+export type CountDeclaration = {
+    label: CountLabel;
+    kind?: "count";
+} | {
+    label: CountLabel;
+    kind: "money";
+    currency: string;
+    unit: "minor" | "major";
+} | {
+    label: CountLabel;
+    kind: "duration";
+    unit: "ms" | "s";
+};
+export type CountDeclarations = Readonly<Record<string, CountDeclaration>>;
+/** What a job's `run` resolves with: a number for every key it declared. */
+export type CountValues<C extends CountDeclarations> = {
+    [K in keyof C]: number;
+};
+/** One count, ready to show. `text` is the whole phrase: "£1,204.50 outstanding". */
+export interface CountLine {
+    key: string;
+    kind: CountKind;
+    value: number;
+    text: string;
+}
+export interface CountFormatOptions {
+    /** BCP 47 locale for numbers and currency. Default `en-GB`. */
+    locale?: string;
+}
+/** An amount of money in its currency's own style. Float noise (12.300000000000001) is rounded away here. */
+export declare function formatMoney(value: number, currency: string, unit: "minor" | "major", locale?: string): string;
+/** How long something took, compactly: "450 ms", "2.5 s", "2 min 5 s", "1 h 3 min", "2 days 4 h". */
+export declare function formatDuration(ms: number, locale?: string): string;
+/**
+ * A threshold in the unit a person would say it in: "26 hours", "8 days",
+ * "90 minutes". For "no successful run in over 26 hours", where "1 day 2 h"
+ * would read as a stopwatch.
+ */
+export declare function describeSpan(ms: number): string;
+/** One declared count as its phrase. */
+export declare function formatCount(value: number, declaration: CountDeclaration, options?: CountFormatOptions): string;
+/**
+ * A stored result, read through the job's declarations: in declaration order,
+ * each with its phrase. Keys the job no longer declares, and values that are not
+ * finite numbers, are left out — a ledger row is JSON someone wrote at another
+ * time, so it is repaired rather than trusted.
+ */
+export declare function countLines(declarations: CountDeclarations, stored: unknown, options?: CountFormatOptions): CountLine[];
+/** Only the declared, finite counts — what the dispatcher writes to the ledger. */
+export declare function declaredCounts(declarations: CountDeclarations, returned: unknown): Record<string, number>;
+/** The phrases joined for one line: "3 reminders sent · £1,204.50 outstanding". */
+export declare function countsSummary(lines: readonly CountLine[], separator?: string): string;
+//# sourceMappingURL=counts.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"counts.d.ts","sourceRoot":"","sources":["../../src/jobs/counts.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,MAAM,MAAM,SAAS,GAAG,OAAO,GAAG,OAAO,GAAG,UAAU,CAAC;AAEvD,wEAAwE;AACxE,MAAM,MAAM,UAAU,GAAG,MAAM,GAAG;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC;AAEjE;;;;;;;;GAQG;AACH,MAAM,MAAM,gBAAgB,GACxB;IAAE,KAAK,EAAE,UAAU,CAAC;IAAC,IAAI,CAAC,EAAE,OAAO,CAAA;CAAE,GACrC;IAAE,KAAK,EAAE,UAAU,CAAC;IAAC,IAAI,EAAE,OAAO,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,OAAO,GAAG,OAAO,CAAA;CAAE,GAC/E;IAAE,KAAK,EAAE,UAAU,CAAC;IAAC,IAAI,EAAE,UAAU,CAAC;IAAC,IAAI,EAAE,IAAI,GAAG,GAAG,CAAA;CAAE,CAAC;AAE9D,MAAM,MAAM,iBAAiB,GAAG,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAC,CAAC;AAE3E,4EAA4E;AAC5E,MAAM,MAAM,WAAW,CAAC,CAAC,SAAS,iBAAiB,IAAI;KAAG,CAAC,IAAI,MAAM,CAAC,GAAG,MAAM;CAAE,CAAC;AAElF,qFAAqF;AACrF,MAAM,WAAW,SAAS;IACxB,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,SAAS,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,kBAAkB;IACjC,+DAA+D;IAC/D,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AASD,6GAA6G;AAC7G,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,GAAG,OAAO,EAAE,MAAM,SAAiB,UAI5G;AAOD,qGAAqG;AACrG,wBAAgB,cAAc,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,SAAiB,GAAG,MAAM,CAc1E;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,CAM/C;AAED,wCAAwC;AACxC,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,WAAW,EAAE,gBAAgB,EAAE,OAAO,GAAE,kBAAuB,GAAG,MAAM,CAWlH;AAED;;;;;GAKG;AACH,wBAAgB,UAAU,CACxB,YAAY,EAAE,iBAAiB,EAC/B,MAAM,EAAE,OAAO,EACf,OAAO,GAAE,kBAAuB,GAC/B,SAAS,EAAE,CAQb;AAED,mFAAmF;AACnF,wBAAgB,cAAc,CAAC,YAAY,EAAE,iBAAiB,EAAE,QAAQ,EAAE,OAAO,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CASzG;AAED,mFAAmF;AACnF,wBAAgB,aAAa,CAAC,KAAK,EAAE,SAAS,SAAS,EAAE,EAAE,SAAS,SAAQ,GAAG,MAAM,CAEpF"}

package/dist/jobs/counts.js

@@ -0,0 +1,112 @@
+/**
+ * What a run did, in words a person reads.
+ *
+ * Both apps stored a job's result as `Record<string, number>` and printed it
+ * key by key, so production showed "0 chargesRaised · 0 totalOutstanding" —
+ * a variable name where a sentence belonged, and an amount of money printed as
+ * if it were a number of things. The fix is not a better printer. It is that a
+ * count cannot reach the screen without having been declared: every key has
+ * the words that follow its number, and a kind that says how the number is
+ * written. An undeclared key is not shown at all, so there is no fallback for
+ * a raw name to slip through.
+ *
+ * No imports: this runs in a server component, a route and a client card alike.
+ */
+const DEFAULT_LOCALE = "en-GB";
+function labelFor(label, value, locale) {
+    if (typeof label === "string")
+        return label;
+    return new Intl.PluralRules(locale).select(value) === "one" ? label.one : label.other;
+}
+/** An amount of money in its currency's own style. Float noise (12.300000000000001) is rounded away here. */
+export function formatMoney(value, currency, unit, locale = DEFAULT_LOCALE) {
+    const format = new Intl.NumberFormat(locale, { style: "currency", currency });
+    const digits = format.resolvedOptions().maximumFractionDigits ?? 2;
+    return format.format(unit === "minor" ? value / 10 ** digits : value);
+}
+const SECOND = 1000;
+const MINUTE = 60 * SECOND;
+const HOUR = 60 * MINUTE;
+const DAY = 24 * HOUR;
+/** How long something took, compactly: "450 ms", "2.5 s", "2 min 5 s", "1 h 3 min", "2 days 4 h". */
+export function formatDuration(ms, locale = DEFAULT_LOCALE) {
+    const n = (value, digits = 0) => new Intl.NumberFormat(locale, { maximumFractionDigits: digits }).format(value);
+    const abs = Math.abs(ms);
+    if (abs < SECOND)
+        return `${n(ms)} ms`;
+    if (abs < 10 * SECOND)
+        return `${n(ms / SECOND, 1)} s`;
+    if (abs < MINUTE)
+        return `${n(Math.round(ms / SECOND))} s`;
+    const pair = (big, bigUnit, small, smallUnit) => small ? `${n(big)} ${bigUnit} ${n(small)} ${smallUnit}` : `${n(big)} ${bigUnit}`;
+    const whole = Math.round(abs / SECOND) * SECOND;
+    if (whole < HOUR)
+        return pair(Math.floor(whole / MINUTE), "min", Math.round((whole % MINUTE) / SECOND), "s");
+    if (whole < DAY)
+        return pair(Math.floor(whole / HOUR), "h", Math.round((whole % HOUR) / MINUTE), "min");
+    const days = Math.floor(whole / DAY);
+    return pair(days, days === 1 ? "day" : "days", Math.round((whole % DAY) / HOUR), "h");
+}
+/**
+ * A threshold in the unit a person would say it in: "26 hours", "8 days",
+ * "90 minutes". For "no successful run in over 26 hours", where "1 day 2 h"
+ * would read as a stopwatch.
+ */
+export function describeSpan(ms) {
+    const unit = (value, one, many) => `${value} ${value === 1 ? one : many}`;
+    if (ms >= 2 * DAY && ms % DAY === 0)
+        return unit(ms / DAY, "day", "days");
+    if (ms >= HOUR && ms % HOUR === 0)
+        return unit(ms / HOUR, "hour", "hours");
+    if (ms >= MINUTE && ms % MINUTE === 0)
+        return unit(ms / MINUTE, "minute", "minutes");
+    return formatDuration(ms);
+}
+/** One declared count as its phrase. */
+export function formatCount(value, declaration, options = {}) {
+    const locale = options.locale ?? DEFAULT_LOCALE;
+    const label = labelFor(declaration.label, value, locale);
+    switch (declaration.kind) {
+        case "money":
+            return `${formatMoney(value, declaration.currency, declaration.unit, locale)} ${label}`;
+        case "duration":
+            return `${formatDuration(declaration.unit === "s" ? value * SECOND : value, locale)} ${label}`;
+        default:
+            return `${new Intl.NumberFormat(locale).format(value)} ${label}`;
+    }
+}
+/**
+ * A stored result, read through the job's declarations: in declaration order,
+ * each with its phrase. Keys the job no longer declares, and values that are not
+ * finite numbers, are left out — a ledger row is JSON someone wrote at another
+ * time, so it is repaired rather than trusted.
+ */
+export function countLines(declarations, stored, options = {}) {
+    if (!stored || typeof stored !== "object" || Array.isArray(stored))
+        return [];
+    const values = stored;
+    return Object.entries(declarations).flatMap(([key, declaration]) => {
+        const value = values[key];
+        if (typeof value !== "number" || !Number.isFinite(value))
+            return [];
+        return [{ key, kind: declaration.kind ?? "count", value, text: formatCount(value, declaration, options) }];
+    });
+}
+/** Only the declared, finite counts — what the dispatcher writes to the ledger. */
+export function declaredCounts(declarations, returned) {
+    if (!returned || typeof returned !== "object")
+        return {};
+    const values = returned;
+    const kept = {};
+    for (const key of Object.keys(declarations)) {
+        const value = values[key];
+        if (typeof value === "number" && Number.isFinite(value))
+            kept[key] = value;
+    }
+    return kept;
+}
+/** The phrases joined for one line: "3 reminders sent · £1,204.50 outstanding". */
+export function countsSummary(lines, separator = " · ") {
+    return lines.map((line) => line.text).join(separator);
+}
+//# sourceMappingURL=counts.js.map

package/dist/jobs/counts.js.map

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

package/dist/jobs/cron-auth.d.ts

@@ -0,0 +1,44 @@
+/**
+ * Whether a request may run the scheduled jobs: the shared `CRON_SECRET`, as
+ * Vercel's cron sends it (`Authorization: Bearer <secret>`).
+ *
+ * Both apps wrote this, the same way in substance. The union keeps each one's
+ * better half:
+ *
+ * - **An unset secret refuses everything (503)** rather than running
+ *   unauthenticated. Both.
+ * - **Compared as SHA-256 digests with `timingSafeEqual`** (Quickie). Equal
+ *   lengths whatever was sent, so the comparison is constant-time and leaks not
+ *   even the secret's length. AltEd compared the raw bytes after a length check.
+ * - **A committed development secret is refused in production** (Quickie). Next
+ *   loads `.env` in production too, so a host that forgets its own value would
+ *   otherwise run on the one in the repository.
+ * - **No secret in the address unless asked for** (AltEd). `?secret=` lands in
+ *   every request log on the way; a route only Vercel calls has no use for it.
+ *   Quickie accepted it everywhere, AltEd on the tick. Off by default here.
+ * - **The Bearer scheme is required.** Quickie's check stripped an optional
+ *   prefix, so a bare secret in the header also passed.
+ *
+ * Returns a decision, not a `Response`: each app answers in its own envelope.
+ */
+export type CronAuthResult = {
+    ok: true;
+} | {
+    ok: false;
+    status: 401 | 503;
+    message: string;
+};
+export interface CronAuthOptions {
+    /** The secret. Default `process.env.CRON_SECRET`. */
+    secret?: string;
+    /** Accept `?secret=` from a scheduler that can only call an address. Default `false`. */
+    allowQuery?: boolean;
+    /** Values that are public — committed to the repository — and so refused in production. */
+    publicSecrets?: readonly string[];
+    /** Default `process.env.NODE_ENV === "production"`. */
+    production?: boolean;
+    /** What the refusal calls this endpoint: "Cron", "The harvest". Default "Cron". */
+    label?: string;
+}
+export declare function checkCronRequest(request: Request, options?: CronAuthOptions): CronAuthResult;
+//# sourceMappingURL=cron-auth.d.ts.map

package/dist/jobs/cron-auth.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cron-auth.d.ts","sourceRoot":"","sources":["../../src/jobs/cron-auth.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,MAAM,MAAM,cAAc,GAAG;IAAE,EAAE,EAAE,IAAI,CAAA;CAAE,GAAG;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,GAAG,GAAG,GAAG,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC;AAE9F,MAAM,WAAW,eAAe;IAC9B,qDAAqD;IACrD,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,yFAAyF;IACzF,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,2FAA2F;IAC3F,aAAa,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAClC,uDAAuD;IACvD,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,mFAAmF;IACnF,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAID,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,GAAE,eAAoB,GAAG,cAAc,CAiBhG"}

package/dist/jobs/cron-auth.js

@@ -0,0 +1,20 @@
+import { createHash, timingSafeEqual } from "node:crypto";
+const digest = (value) => createHash("sha256").update(value).digest();
+export function checkCronRequest(request, options = {}) {
+    const label = options.label ?? "Cron";
+    const secret = options.secret ?? process.env.CRON_SECRET ?? "";
+    if (!secret)
+        return { ok: false, status: 503, message: `${label} is not configured (CRON_SECRET unset).` };
+    const production = options.production ?? process.env.NODE_ENV === "production";
+    if (production && options.publicSecrets?.includes(secret)) {
+        return { ok: false, status: 503, message: `${label} is not configured (CRON_SECRET is the development value).` };
+    }
+    const header = request.headers.get("authorization") ?? "";
+    const bearer = /^Bearer\s+(.+)$/i.exec(header)?.[1];
+    const provided = bearer ?? (options.allowQuery ? (new URL(request.url).searchParams.get("secret") ?? undefined) : undefined);
+    if (!provided || !timingSafeEqual(digest(provided), digest(secret))) {
+        return { ok: false, status: 401, message: "Unauthorized" };
+    }
+    return { ok: true };
+}
+//# sourceMappingURL=cron-auth.js.map

package/dist/jobs/cron-auth.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cron-auth.js","sourceRoot":"","sources":["../../src/jobs/cron-auth.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAwC1D,MAAM,MAAM,GAAG,CAAC,KAAa,EAAE,EAAE,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,MAAM,EAAE,CAAC;AAE9E,MAAM,UAAU,gBAAgB,CAAC,OAAgB,EAAE,UAA2B,EAAE;IAC9E,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,IAAI,MAAM,CAAC;IACtC,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,IAAI,OAAO,CAAC,GAAG,CAAC,WAAW,IAAI,EAAE,CAAC;IAC/D,IAAI,CAAC,MAAM;QAAE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,OAAO,EAAE,GAAG,KAAK,yCAAyC,EAAE,CAAC;IAC3G,MAAM,UAAU,GAAG,OAAO,CAAC,UAAU,IAAI,OAAO,CAAC,GAAG,CAAC,QAAQ,KAAK,YAAY,CAAC;IAC/E,IAAI,UAAU,IAAI,OAAO,CAAC,aAAa,EAAE,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC;QAC1D,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,OAAO,EAAE,GAAG,KAAK,4DAA4D,EAAE,CAAC;IACnH,CAAC;IAED,MAAM,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,eAAe,CAAC,IAAI,EAAE,CAAC;IAC1D,MAAM,MAAM,GAAG,kBAAkB,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;IACpD,MAAM,QAAQ,GACZ,MAAM,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,IAAI,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,YAAY,CAAC,GAAG,CAAC,QAAQ,CAAC,IAAI,SAAS,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;IAC9G,IAAI,CAAC,QAAQ,IAAI,CAAC,eAAe,CAAC,MAAM,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC;QACpE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,OAAO,EAAE,cAAc,EAAE,CAAC;IAC7D,CAAC;IACD,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,CAAC;AACtB,CAAC"}

package/dist/jobs/health.d.ts

@@ -0,0 +1,157 @@
+import { type CountFormatOptions, type CountLine } from "./counts.js";
+import type { AnyJob, RunNowScope } from "./registry.js";
+import type { JobRunRecord, JobSwitchState } from "./store.js";
+/**
+ * A job's health — derived every time it is shown, never stored.
+ *
+ * A stored status is a second copy of the truth that drifts from the first.
+ * Health here is a function of the ledger, the switch and the clock, so the
+ * card cannot say "Healthy" about a job whose last run failed an hour ago.
+ *
+ * Six states, in the order they win:
+ *
+ * 1. **paused** — switched off. Whatever the runs say, nothing new will start.
+ * 2. **never-run** — no run this viewer can see.
+ * 3. **running** — the latest run has not finished, and is inside its timeout.
+ * 4. **failed** — the latest run failed, or started and never finished. Both
+ *    apps showed a run still in progress as "Errored", because an unfinished
+ *    row has `ok = false`; and a run cut off by the platform's time limit stayed
+ *    that way for ever with no message at all. Past its timeout it is a failure
+ *    that says so.
+ * 5. **stale** — no successful *whole* run for longer than the threshold (a
+ *    run exactly at the threshold is still healthy). A tenant's own Run now
+ *    sweeps one tenant, so it proves nothing about the schedule and does not
+ *    reset the clock — in Quickie it did, so one owner's click made a job look
+ *    healthy to everyone.
+ * 6. **healthy**.
+ */
+export type JobHealthState = "paused" | "never-run" | "running" | "failed" | "stale" | "healthy";
+export type JobHealth = {
+    state: "paused";
+} | {
+    state: "never-run";
+} | {
+    state: "running";
+    since: string;
+} | {
+    state: "failed";
+    at: string;
+    error: string | null;
+    unfinished: boolean;
+} | {
+    state: "stale";
+    lastSuccessAt: string | null;
+    thresholdMs: number;
+} | {
+    state: "healthy";
+    lastSuccessAt: string;
+};
+/** The fields of a run that health reads. */
+export interface RunFacts {
+    startedAt: Date;
+    finishedAt: Date | null;
+    ok: boolean;
+    error: string | null;
+}
+export interface HealthInput {
+    paused: boolean;
+    /** The latest run the viewer can see. */
+    latest: RunFacts | null;
+    /** The latest successful run over every tenant — the one staleness is measured from. */
+    lastWholeSuccess: RunFacts | null;
+    staleAfterMs: number | null;
+    timeoutMs: number;
+    now: Date;
+}
+export declare function deriveHealth(input: HealthInput): JobHealth;
+/**
+ * Who is looking. A platform viewer (AltEd's administrators, Quickie's
+ * operators) may switch jobs and sees every sweep's detail; a tenant viewer
+ * (Quickie's owners) sees their own Run now results in full, and of a sweep
+ * over every tenant only whether it ran and when.
+ */
+export interface JobAudience {
+    platform: boolean;
+    tenantId?: string | null;
+}
+/** One run, as the card shows it. Dates are ISO strings, so it crosses from a server component intact. */
+export interface JobRunView {
+    startedAt: string;
+    finishedAt: string | null;
+    ok: boolean;
+    trigger: "schedule" | "manual";
+    by: string | null;
+    /** A tenant's Run now: it swept one tenant, not all. */
+    tenantScoped: boolean;
+    counts: CountLine[];
+    error: string | null;
+    /**
+     * Counts and error left out: a sweep over every tenant, seen by one tenant.
+     * Quickie showed each owner the platform-wide ledger, so "412 emails sent"
+     * read as theirs, and an error from another organisation's data was on every
+     * owner's settings page.
+     */
+    withheld: boolean;
+}
+/** A job as the health screen draws it — plain data, every count already in words. */
+export interface JobView {
+    id: string;
+    label: string;
+    cadence: string;
+    schedule: "tick" | "own";
+    staleAfterMs: number | null;
+    health: JobHealth;
+    /** Health with the switch ignored, so the badge is right the moment someone switches it back on. */
+    healthIfOn: JobHealth;
+    paused: boolean;
+    switchedAt: string | null;
+    switchedBy: string | null;
+    /** This viewer may switch it. */
+    canSwitch: boolean;
+    /** This viewer may press Run now, and what it would sweep. */
+    runNow: RunNowScope | null;
+    lastRun: JobRunView | null;
+    lastSuccess: JobRunView | null;
+}
+/** What the view needs from the store for one job. */
+export interface JobFacts {
+    switch: JobSwitchState | null;
+    latest: JobRunRecord | null;
+    lastWholeSuccess: JobRunRecord | null;
+    lastVisibleSuccess: JobRunRecord | null;
+}
+export interface JobViewOptions extends CountFormatOptions {
+    now: Date;
+}
+export declare function effectiveTimeout(job: AnyJob, fallback: number): number;
+/** Whether this viewer may press Run now on this job. */
+export declare function runNowFor(job: AnyJob, audience: JobAudience): RunNowScope | null;
+export declare function buildJobView(job: AnyJob, facts: JobFacts, audience: JobAudience, options: JobViewOptions & {
+    timeoutMs: number;
+}): JobView;
+export interface WhenOptions {
+    locale?: string;
+    /**
+     * Whose clock. Default `Europe/London`. Never the runtime's own: the card is
+     * drawn on a server in UTC and again in a browser in BST, and two different
+     * times in one element is a hydration error.
+     */
+    timeZone?: string;
+}
+/** "30 Sept 2026, 14:05". */
+export declare function formatWhen(iso: string, options?: WhenOptions): string;
+/** "29 Sept 2026". */
+export declare function formatDay(iso: string, options?: WhenOptions): string;
+export interface HealthWords {
+    label: string;
+    /** A sentence under the badge, or `null` when the badge says it all. */
+    detail: string | null;
+    tone: "good" | "neutral" | "warning" | "bad";
+}
+/** The badge and the sentence under it. */
+export declare function describeHealth(health: JobHealth, options?: WhenOptions): HealthWords;
+/** "Paused 29 Sept 2026 by AltEd Admin", "Turned back on …", or nothing if it was never switched. */
+export declare function describeSwitch(view: Pick<JobView, "paused" | "switchedAt" | "switchedBy">, options?: WhenOptions): string | null;
+/** "Last run 30 Sept 2026, 14:05 · Run now by Ann Lee". */
+export declare function describeRun(run: JobRunView, prefix: string, options?: WhenOptions): string;
+//# sourceMappingURL=health.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"health.d.ts","sourceRoot":"","sources":["../../src/jobs/health.ts"],"names":[],"mappings":"AAAA,OAAO,EAA4B,KAAK,kBAAkB,EAAE,KAAK,SAAS,EAAE,MAAM,aAAa,CAAC;AAChG,OAAO,KAAK,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AACzD,OAAO,KAAK,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAG/D;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,MAAM,MAAM,cAAc,GAAG,QAAQ,GAAG,WAAW,GAAG,SAAS,GAAG,QAAQ,GAAG,OAAO,GAAG,SAAS,CAAC;AAEjG,MAAM,MAAM,SAAS,GACjB;IAAE,KAAK,EAAE,QAAQ,CAAA;CAAE,GACnB;IAAE,KAAK,EAAE,WAAW,CAAA;CAAE,GACtB;IAAE,KAAK,EAAE,SAAS,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GACnC;IAAE,KAAK,EAAE,QAAQ,CAAC;IAAC,EAAE,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IAAC,UAAU,EAAE,OAAO,CAAA;CAAE,GAC1E;IAAE,KAAK,EAAE,OAAO,CAAC;IAAC,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAAC,WAAW,EAAE,MAAM,CAAA;CAAE,GACrE;IAAE,KAAK,EAAE,SAAS,CAAC;IAAC,aAAa,EAAE,MAAM,CAAA;CAAE,CAAC;AAEhD,6CAA6C;AAC7C,MAAM,WAAW,QAAQ;IACvB,SAAS,EAAE,IAAI,CAAC;IAChB,UAAU,EAAE,IAAI,GAAG,IAAI,CAAC;IACxB,EAAE,EAAE,OAAO,CAAC;IACZ,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;CACtB;AAED,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,OAAO,CAAC;IAChB,yCAAyC;IACzC,MAAM,EAAE,QAAQ,GAAG,IAAI,CAAC;IACxB,wFAAwF;IACxF,gBAAgB,EAAE,QAAQ,GAAG,IAAI,CAAC;IAClC,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,SAAS,EAAE,MAAM,CAAC;IAClB,GAAG,EAAE,IAAI,CAAC;CACX;AAED,wBAAgB,YAAY,CAAC,KAAK,EAAE,WAAW,GAAG,SAAS,CAyB1D;AAED;;;;;GAKG;AACH,MAAM,WAAW,WAAW;IAC1B,QAAQ,EAAE,OAAO,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC1B;AAED,0GAA0G;AAC1G,MAAM,WAAW,UAAU;IACzB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,EAAE,EAAE,OAAO,CAAC;IACZ,OAAO,EAAE,UAAU,GAAG,QAAQ,CAAC;IAC/B,EAAE,EAAE,MAAM,GAAG,IAAI,CAAC;IAClB,wDAAwD;IACxD,YAAY,EAAE,OAAO,CAAC;IACtB,MAAM,EAAE,SAAS,EAAE,CAAC;IACpB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB;;;;;OAKG;IACH,QAAQ,EAAE,OAAO,CAAC;CACnB;AAED,sFAAsF;AACtF,MAAM,WAAW,OAAO;IACtB,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,GAAG,KAAK,CAAC;IACzB,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,MAAM,EAAE,SAAS,CAAC;IAClB,oGAAoG;IACpG,UAAU,EAAE,SAAS,CAAC;IACtB,MAAM,EAAE,OAAO,CAAC;IAChB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,iCAAiC;IACjC,SAAS,EAAE,OAAO,CAAC;IACnB,8DAA8D;IAC9D,MAAM,EAAE,WAAW,GAAG,IAAI,CAAC;IAC3B,OAAO,EAAE,UAAU,GAAG,IAAI,CAAC;IAC3B,WAAW,EAAE,UAAU,GAAG,IAAI,CAAC;CAChC;AAED,sDAAsD;AACtD,MAAM,WAAW,QAAQ;IACvB,MAAM,EAAE,cAAc,GAAG,IAAI,CAAC;IAC9B,MAAM,EAAE,YAAY,GAAG,IAAI,CAAC;IAC5B,gBAAgB,EAAE,YAAY,GAAG,IAAI,CAAC;IACtC,kBAAkB,EAAE,YAAY,GAAG,IAAI,CAAC;CACzC;AAED,MAAM,WAAW,cAAe,SAAQ,kBAAkB;IACxD,GAAG,EAAE,IAAI,CAAC;CACX;AAED,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAEtE;AAED,yDAAyD;AACzD,wBAAgB,SAAS,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,WAAW,GAAG,WAAW,GAAG,IAAI,CAIhF;AAiBD,wBAAgB,YAAY,CAC1B,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,QAAQ,EACf,QAAQ,EAAE,WAAW,EACrB,OAAO,EAAE,cAAc,GAAG;IAAE,SAAS,EAAE,MAAM,CAAA;CAAE,GAC9C,OAAO,CA+BT;AAED,MAAM,WAAW,WAAW;IAC1B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;;;;OAIG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,6BAA6B;AAC7B,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,GAAE,WAAgB,GAAG,MAAM,CASzE;AAED,sBAAsB;AACtB,wBAAgB,SAAS,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,GAAE,WAAgB,GAAG,MAAM,CAOxE;AAED,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,MAAM,CAAC;IACd,wEAAwE;IACxE,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,IAAI,EAAE,MAAM,GAAG,SAAS,GAAG,SAAS,GAAG,KAAK,CAAC;CAC9C;AAED,2CAA2C;AAC3C,wBAAgB,cAAc,CAAC,MAAM,EAAE,SAAS,EAAE,OAAO,GAAE,WAAgB,GAAG,WAAW,CA2BxF;AAED,qGAAqG;AACrG,wBAAgB,cAAc,CAC5B,IAAI,EAAE,IAAI,CAAC,OAAO,EAAE,QAAQ,GAAG,YAAY,GAAG,YAAY,CAAC,EAC3D,OAAO,GAAE,WAAgB,GACxB,MAAM,GAAG,IAAI,CAIf;AAED,2DAA2D;AAC3D,wBAAgB,WAAW,CAAC,GAAG,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,GAAE,WAAgB,GAAG,MAAM,CAG9F"}

package/dist/jobs/health.js

@@ -0,0 +1,146 @@
+import { countLines, describeSpan } from "./counts.js";
+import { isManualKey } from "./windows.js";
+export function deriveHealth(input) {
+    const { latest, lastWholeSuccess, now } = input;
+    if (input.paused)
+        return { state: "paused" };
+    if (!latest && !lastWholeSuccess)
+        return { state: "never-run" };
+    if (latest && !latest.finishedAt) {
+        if (now.getTime() - latest.startedAt.getTime() <= input.timeoutMs) {
+            return { state: "running", since: latest.startedAt.toISOString() };
+        }
+        return { state: "failed", at: latest.startedAt.toISOString(), error: null, unfinished: true };
+    }
+    if (latest && !latest.ok) {
+        return { state: "failed", at: latest.startedAt.toISOString(), error: latest.error, unfinished: false };
+    }
+    if (input.staleAfterMs !== null &&
+        (!lastWholeSuccess || now.getTime() - lastWholeSuccess.startedAt.getTime() > input.staleAfterMs)) {
+        return {
+            state: "stale",
+            lastSuccessAt: lastWholeSuccess?.startedAt.toISOString() ?? null,
+            thresholdMs: input.staleAfterMs,
+        };
+    }
+    const success = lastWholeSuccess ?? latest;
+    return { state: "healthy", lastSuccessAt: success.startedAt.toISOString() };
+}
+export function effectiveTimeout(job, fallback) {
+    return job.timeoutMs ?? fallback;
+}
+/** Whether this viewer may press Run now on this job. */
+export function runNowFor(job, audience) {
+    if (!job.runNow)
+        return null;
+    if (job.runNow.scope === "tenant")
+        return audience.tenantId ? "tenant" : null;
+    return audience.platform ? "platform" : null;
+}
+function runView(job, run, audience, options) {
+    const withheld = !audience.platform && run.tenantId === null;
+    return {
+        startedAt: run.startedAt.toISOString(),
+        finishedAt: run.finishedAt?.toISOString() ?? null,
+        ok: run.ok,
+        trigger: isManualKey(run.windowKey) ? "manual" : "schedule",
+        by: run.by,
+        tenantScoped: run.tenantId !== null,
+        counts: withheld ? [] : countLines(job.counts, run.counts, options),
+        error: withheld ? null : run.error,
+        withheld,
+    };
+}
+export function buildJobView(job, facts, audience, options) {
+    const switchable = job.switchable ?? true;
+    const paused = switchable && Boolean(facts.switch?.paused);
+    const lastRun = facts.latest ? runView(job, facts.latest, audience, options) : null;
+    const input = {
+        latest: facts.latest,
+        lastWholeSuccess: facts.lastWholeSuccess,
+        staleAfterMs: job.staleAfterMs,
+        timeoutMs: effectiveTimeout(job, options.timeoutMs),
+        now: options.now,
+    };
+    const healthIfOn = deriveHealth({ ...input, paused: false });
+    // A withheld failure keeps its state and loses its words.
+    const redact = (health) => health.state === "failed" && lastRun?.withheld ? { ...health, error: null } : health;
+    return {
+        id: job.id,
+        label: job.label,
+        cadence: job.cadence,
+        schedule: job.schedule ?? "tick",
+        staleAfterMs: job.staleAfterMs,
+        health: redact(paused ? { state: "paused" } : healthIfOn),
+        healthIfOn: redact(healthIfOn),
+        paused,
+        switchedAt: switchable ? (facts.switch?.at?.toISOString() ?? null) : null,
+        switchedBy: switchable ? (facts.switch?.by ?? null) : null,
+        canSwitch: switchable && audience.platform,
+        runNow: runNowFor(job, audience),
+        lastRun,
+        lastSuccess: facts.lastVisibleSuccess ? runView(job, facts.lastVisibleSuccess, audience, options) : null,
+    };
+}
+/** "30 Sept 2026, 14:05". */
+export function formatWhen(iso, options = {}) {
+    return new Intl.DateTimeFormat(options.locale ?? "en-GB", {
+        day: "numeric",
+        month: "short",
+        year: "numeric",
+        hour: "2-digit",
+        minute: "2-digit",
+        timeZone: options.timeZone ?? "Europe/London",
+    }).format(new Date(iso));
+}
+/** "29 Sept 2026". */
+export function formatDay(iso, options = {}) {
+    return new Intl.DateTimeFormat(options.locale ?? "en-GB", {
+        day: "numeric",
+        month: "short",
+        year: "numeric",
+        timeZone: options.timeZone ?? "Europe/London",
+    }).format(new Date(iso));
+}
+/** The badge and the sentence under it. */
+export function describeHealth(health, options = {}) {
+    switch (health.state) {
+        case "paused":
+            return { label: "Paused", detail: null, tone: "neutral" };
+        case "never-run":
+            return { label: "Never run", detail: "No runs recorded yet.", tone: "neutral" };
+        case "running":
+            return { label: "Running", detail: `Started ${formatWhen(health.since, options)}.`, tone: "neutral" };
+        case "failed":
+            return {
+                label: "Failed",
+                detail: health.unfinished
+                    ? `Started ${formatWhen(health.at, options)} and never finished — it was probably cut off.`
+                    : (health.error ?? "The last run failed."),
+                tone: "bad",
+            };
+        case "stale":
+            return {
+                label: "Stale",
+                detail: health.lastSuccessAt
+                    ? `No successful run in over ${describeSpan(health.thresholdMs)} — the last was ${formatWhen(health.lastSuccessAt, options)}.`
+                    : `No successful run on its schedule yet; one is expected every ${describeSpan(health.thresholdMs)}.`,
+                tone: "warning",
+            };
+        case "healthy":
+            return { label: "Healthy", detail: null, tone: "good" };
+    }
+}
+/** "Paused 29 Sept 2026 by AltEd Admin", "Turned back on …", or nothing if it was never switched. */
+export function describeSwitch(view, options = {}) {
+    if (!view.switchedAt)
+        return view.paused ? "Paused" : null;
+    const by = view.switchedBy ? ` by ${view.switchedBy}` : "";
+    return `${view.paused ? "Paused" : "Turned back on"} ${formatDay(view.switchedAt, options)}${by}`;
+}
+/** "Last run 30 Sept 2026, 14:05 · Run now by Ann Lee". */
+export function describeRun(run, prefix, options = {}) {
+    const when = `${prefix} ${formatWhen(run.startedAt, options)}`;
+    return run.trigger === "manual" ? `${when} · Run now${run.by ? ` by ${run.by}` : ""}` : when;
+}
+//# sourceMappingURL=health.js.map