@cronwatch/sdk 0.10.0 → 0.11.0

package/README.md

@@ -25,7 +25,7 @@ export const nightlyReport = cw.job("nightly-report", {
   schedule: "0 2 * * *",     // cron, "@hourly", or "every 15m"
   timezone: "UTC",
   grace: "15m",              // how late a start may be before it is missed
-  timeout: "30m",            // a run still going after this is stuck
+  timeout: "30m",            // a run still going after this is stuck (maxDuration: a finished run longer than it is slow)
   expect: "Report written",  // output must contain this, or the run failed
   budget: { cost: 2 },       // cost above 2 is over budget
 });
@@ -57,7 +57,7 @@ export const { GET, POST, DELETE } = cw.routes();
 await nightlyReport.run(async (job) => { /* ... */ });
 
 // Missed and stuck runs are found by the check: on an interval, or a cron hitting /cronwatch/api/check
-cw.start();
+cw.startChecking();
 ```
 
 ## What it catches
@@ -77,13 +77,13 @@ An `expect` RegExp runs in your process on the runtime's own engine and, like an
 
 | Import | |
 |---|---|
-| `@cronwatch/sdk` | `cronwatch`, `memory`, `custom`, `consoleChannel`, `createRoutes`, types |
+| `@cronwatch/sdk` | `cronwatch`, `Cronwatch`, `memory`, `custom`, `consoleChannel`, types; the dashboard is `cw.routes()` |
 | `@cronwatch/sdk/sqlite` | `sqlite({ path })`, needs `better-sqlite3` (and `@types/better-sqlite3` in TypeScript) |
 | `@cronwatch/sdk/postgres` | `postgres({ connectionString })`, needs `pg` (and `@types/pg` in TypeScript) |
 | `@cronwatch/sdk/d1` | `d1(env.DB)`, the Cloudflare D1 store; needs nothing |
 | `@cronwatch/sdk/pg-cron` | `pgCron(pool)`, a source that reads pg_cron jobs (Supabase Cron included) from Postgres on every check; pass it in `sources` |
 | `@cronwatch/sdk/node` | `toNodeHandler`, `toKoaMiddleware`, `toRequest`, `writeResponse`: fetch handlers on `http.createServer`, Express, Connect, NestJS and Koa |
-| `@cronwatch/sdk/slack`, `/discord`, `/webhook` | chat and signed webhook alert channels |
+| `@cronwatch/sdk/slack`, `/discord`, `/webhook` | chat and signed webhook alert channels; `/webhook` also has `signature(secret, body)` for a receiver |
 | `@cronwatch/sdk/resend`, `/postmark`, `/sendgrid`, `/mailgun`, `/ses` | email alert channels |
 | `@cronwatch/sdk/twilio` | SMS alerts |
 | `@cronwatch/sdk/sentry`, `/honeybadger`, `/datadog`, `/rollbar`, `/bugsnag`, `/newrelic` | alerts as events in an error tracker |

package/dist/anthropic.d.cts

@@ -1,5 +1,5 @@
 import Anthropic from '@anthropic-ai/sdk';
-import { o as TriageFn } from './types-DyWCxlSi.cjs';
+import { o as TriageFn } from './types-DLnlUie8.cjs';
 
 interface AnthropicTriageOptions {
     /** Defaults to what the Anthropic SDK resolves: ANTHROPIC_API_KEY, or an `ant auth login` profile. */

package/dist/anthropic.d.ts

@@ -1,5 +1,5 @@
 import Anthropic from '@anthropic-ai/sdk';
-import { o as TriageFn } from './types-DyWCxlSi.js';
+import { o as TriageFn } from './types-DLnlUie8.js';
 
 interface AnthropicTriageOptions {
     /** Defaults to what the Anthropic SDK resolves: ANTHROPIC_API_KEY, or an `ant auth login` profile. */

package/dist/bugsnag.d.cts

@@ -1,4 +1,4 @@
-import { A as Alert, a as AlertChannel } from './types-DyWCxlSi.cjs';
+import { A as Alert, a as AlertChannel } from './types-DLnlUie8.cjs';
 
 /**
  * Bugsnag, Error Reporting API, payload version 5.

package/dist/bugsnag.d.ts

@@ -1,4 +1,4 @@
-import { A as Alert, a as AlertChannel } from './types-DyWCxlSi.js';
+import { A as Alert, a as AlertChannel } from './types-DLnlUie8.js';
 
 /**
  * Bugsnag, Error Reporting API, payload version 5.

package/dist/{client-DUoSea7X.d.cts → client-CRMfhylq.d.cts}

@@ -1,4 +1,4 @@
-import { S as Store, a as AlertChannel, o as TriageFn, i as JobOptions, R as Run, A as Alert, D as Duration, J as JobDefinition, f as CheckResult, k as JobSummary, j as JobState } from './types-DyWCxlSi.cjs';
+import { J as JobOptions, R as Run, A as Alert, S as Store, a as AlertChannel, o as TriageFn, D as Duration, h as JobDefinition, f as CheckResult, k as JobSummary, j as JobState } from './types-DLnlUie8.cjs';
 
 /** What a job function receives. */
 interface JobContext {
@@ -19,10 +19,14 @@ interface RoutesOptions {
      * Required to reach anything. Send it as `Authorization: Bearer <token>`,
      * or open the dashboard once with `?token=<token>` and a cookie is set.
      * Defaults to process.env.CRONWATCH_TOKEN (on Cloudflare Workers, which
-     * have no process, pass env.CRONWATCH_TOKEN); an empty string counts as unset.
-     * With no token while NODE_ENV is "development" or "test", the routes make
-     * a random one and print a sign-in link to the server log on their first
-     * request; with no token otherwise they answer 503. Pass `null` to opt out
+     * have no process, pass env.CRONWATCH_TOKEN); an empty string or one of
+     * only whitespace, given here or in the variable, counts as unset, and any
+     * other type (false, a number) throws.
+     * With no token in development (the first of CRONWATCH_ENV, APP_ENV and
+     * NODE_ENV that is set names "development", "dev", "local", "test" or
+     * "testing"), the routes make a random one and print a sign-in link to the
+     * server log on their first request; with no token otherwise they answer
+     * 503. Pass `null` to opt out
      * and serve them open everywhere, for example behind your own auth.
      *
      * The check endpoint (/api/check) also accepts the client's cronSecret, so
@@ -62,12 +66,11 @@ interface Routes {
     DELETE: FetchHandler;
 }
 /**
- * A fetch-style handler serving the dashboard and a small JSON API. Mount it
- * in a Next.js app at app/cronwatch/[[...path]]/route.ts:
- *
- *   export const { GET, POST, DELETE } = cw.routes();
+ * The dashboard and its JSON API for a client.
+ * @deprecated Use `cw.routes(options)`, the one way to mount the dashboard
+ * in every port. This name still works through 1.x and goes in 2.0.
  */
-declare function createRoutes(cw: CronWatch, options?: RoutesOptions): Routes;
+declare function createRoutes(cw: Cronwatch, options?: RoutesOptions): Routes;
 
 type JobFn<T> = (job: JobContext) => Promise<T> | T;
 type HandlerFn<T> = (job: JobContext, request: Request) => Promise<T> | T;
@@ -75,9 +78,12 @@ interface HandlerOptions {
     /**
      * Callers must send `Authorization: Bearer <secret>`. Defaults to the
      * client's cronSecret, which defaults to process.env.CRON_SECRET (what
-     * Vercel sends its cron requests with). An empty string counts as unset.
-     * With no secret at all the handler answers 503 unless NODE_ENV is
-     * "development" or "test". Pass null to allow anyone.
+     * Vercel sends its cron requests with). An empty string, or one of only
+     * whitespace, counts as unset; any other type (false, a number) throws.
+     * With no secret at all the handler answers 503 unless the app is in
+     * development (the first of CRONWATCH_ENV, APP_ENV and NODE_ENV that is
+     * set names "development", "dev", "local", "test" or "testing"). Pass
+     * null to allow anyone.
      */
     secret?: string | null;
 }
@@ -162,13 +168,13 @@ interface RunHandle {
 }
 /**
  * What a Source may use of the client: declare jobs, read the store, and
- * record runs it found elsewhere. A CronWatch is one.
+ * record runs it found elsewhere. A Cronwatch is one.
  */
 interface SourceHost {
-    /** Declare a job, as CronWatch.job(). Throws for an invalid name or option. */
+    /** Declare a job, as Cronwatch.job(). Throws for an invalid name or option. */
     job(name: string, options?: JobOptions): unknown;
     /**
-     * The definitions declared now, as CronWatch.definedJobs(): a source reads
+     * The definitions declared now, as Cronwatch.definedJobs(): a source reads
      * it to declare again a job forgotten since (the dashboard's forget), whose
      * definition has not changed. A host without it is taken to keep every
      * job the source declared.
@@ -176,7 +182,7 @@ interface SourceHost {
     definedJobs?(): {
         name: string;
     }[];
-    /** See CronWatch.recordRun(). */
+    /** See Cronwatch.recordRun(). */
     recordRun(run: Run, options?: RecordRunOptions): Promise<Alert[]>;
     readonly store: Store;
     readonly now: () => number;
@@ -196,7 +202,7 @@ interface RecordRunOptions {
     /** False stores the run without evaluating it, for history imported on first sight. Default true. */
     evaluate?: boolean;
 }
-interface CronWatchOptions {
+interface CronwatchOptions {
     /** Where jobs, runs and state live. Defaults to an in-memory store that forgets on restart. */
     store?: Store;
     /**
@@ -212,8 +218,9 @@ interface CronWatchOptions {
     /**
      * Shared secret that handler() requests must carry. Defaults to
      * process.env.CRON_SECRET (on Cloudflare Workers, which have no process,
-     * pass env.CRON_SECRET); an empty string counts as unset. Pass null to
-     * let handlers run without one.
+     * pass env.CRON_SECRET); an empty string or one of only whitespace, given
+     * here or in the variable, counts as unset. Pass null to let handlers run
+     * without one. Any other type (false, a number) throws.
      */
     cronSecret?: string | null;
     /** How long finished runs are kept. Default "30d". */
@@ -243,7 +250,7 @@ interface CronWatchOptions {
     /** The clock. Tests use this. */
     now?: () => number;
 }
-declare class CronWatch {
+declare class Cronwatch {
     readonly store: Store;
     readonly alerts: AlertChannel[];
     readonly triage: TriageFn | undefined;
@@ -256,7 +263,7 @@ declare class CronWatch {
     /** cronSecret was passed as null: handlers may run without a secret. */
     private readonly secretOptOut;
     private readonly redact;
-    /** "check": queue alerts for another process's check instead of sending them. See CronWatchOptions.deliver. */
+    /** "check": queue alerts for another process's check instead of sending them. See CronwatchOptions.deliver. */
     private readonly deferDelivery;
     private readonly defaults;
     private readonly definitions;
@@ -275,7 +282,9 @@ declare class CronWatch {
     private usingDefaultStore;
     private warnedNoSecret;
     private warnedDeferredStart;
-    constructor(options?: CronWatchOptions);
+    /** Stored jobs read with a definition that was not a JSON object (see readJob). */
+    private readonly unreadable;
+    constructor(options?: CronwatchOptions);
     /** Declare a job. Call it once, at module level, and keep the handle. */
     job(name: string, options?: JobOptions): JobHandle;
     /** Run a job by name without keeping a handle. Defines it on first use. */
@@ -313,6 +322,10 @@ declare class CronWatch {
      * checked and shown while any process still declares it.
      */
     private storedJobs;
+    /** A stored job read leniently (readStoredJob); one whose definition is unreadable is remembered, so that evaluating it throws. */
+    private readJob;
+    /** Throws for a job whose stored definition was not a JSON object: reported, and shown as failing, while the others carry on. */
+    private evaluable;
     /**
      * Runs `fn` after every earlier state update for the same job has settled,
      * so two runs (or a run and a check) in this process never read and write
@@ -464,14 +477,27 @@ declare class CronWatch {
      * it on its next run there, or at that process's next check or dashboard read.
      */
     forget(name: string): Promise<void>;
-    /** The dashboard and JSON API as fetch-style handlers. See createRoutes(). */
+    /**
+     * The dashboard and JSON API as fetch-style handlers: the one way to mount
+     * them. A Next.js app exports them from app/cronwatch/[[...path]]/route.ts:
+     *
+     *   export const { GET, POST, DELETE } = cw.routes();
+     */
     routes(options?: RoutesOptions): Routes;
     /**
      * Check on an interval, for long-running servers. Default every minute.
      * Not for serverless functions or Cloudflare Workers, where nothing runs
-     * between requests: call check() from a cron there instead.
+     * between requests: call check() from a cron there instead. (A job's
+     * start() opens a run; this starts the checks.)
+     */
+    startChecking(every?: Duration): void;
+    /**
+     * startChecking(), under its former name.
+     * @deprecated Renamed `startChecking`, since a job's `start()` opens a run.
+     * This name still works through 1.x and goes in 2.0.
      */
     start(every?: Duration): void;
+    /** Stop the checks startChecking() began. */
     stop(): void;
     /**
      * Stop the interval, wait for a check already under way (bounded by its
@@ -516,4 +542,15 @@ declare function consoleChannel(): AlertChannel;
 /** Wrap any function as an alert channel. */
 declare function custom(name: string, send: (alert: Alert) => Promise<void> | void): AlertChannel;
 
-export { type CronWatchOptions as C, type FetchHandler as F, type HandlerFn as H, type JobContext as J, type RecordRunOptions as R, type Source as S, CronWatch as a, type HandlerOptions as b, type JobFn as c, type JobHandle as d, type Routes as e, type RoutesOptions as f, type RunHandle as g, type RunOutcome as h, type SourceHost as i, type StartOptions as j, consoleChannel as k, createRoutes as l, custom as m };
+/**
+ * The client's former name.
+ * @deprecated Renamed `Cronwatch`, the spelling every port uses. This name
+ * still works through 1.x and goes in 2.0.
+ */
+declare const CronWatch: typeof Cronwatch;
+/** @deprecated Renamed `Cronwatch`; this name goes in 2.0. */
+type CronWatch = Cronwatch;
+/** @deprecated Renamed `CronwatchOptions`; this name goes in 2.0. */
+type CronWatchOptions = CronwatchOptions;
+
+export { type CronwatchOptions as C, type FetchHandler as F, type HandlerFn as H, type JobContext as J, type RecordRunOptions as R, type Source as S, Cronwatch as a, CronWatch as b, type CronWatchOptions as c, type HandlerOptions as d, type JobFn as e, type JobHandle as f, type Routes as g, type RoutesOptions as h, type RunHandle as i, type RunOutcome as j, type SourceHost as k, type StartOptions as l, consoleChannel as m, createRoutes as n, custom as o };

package/dist/{client-BcIjVBiZ.d.ts → client-D2Xk2600.d.ts}

@@ -1,4 +1,4 @@
-import { S as Store, a as AlertChannel, o as TriageFn, i as JobOptions, R as Run, A as Alert, D as Duration, J as JobDefinition, f as CheckResult, k as JobSummary, j as JobState } from './types-DyWCxlSi.js';
+import { J as JobOptions, R as Run, A as Alert, S as Store, a as AlertChannel, o as TriageFn, D as Duration, h as JobDefinition, f as CheckResult, k as JobSummary, j as JobState } from './types-DLnlUie8.js';
 
 /** What a job function receives. */
 interface JobContext {
@@ -19,10 +19,14 @@ interface RoutesOptions {
      * Required to reach anything. Send it as `Authorization: Bearer <token>`,
      * or open the dashboard once with `?token=<token>` and a cookie is set.
      * Defaults to process.env.CRONWATCH_TOKEN (on Cloudflare Workers, which
-     * have no process, pass env.CRONWATCH_TOKEN); an empty string counts as unset.
-     * With no token while NODE_ENV is "development" or "test", the routes make
-     * a random one and print a sign-in link to the server log on their first
-     * request; with no token otherwise they answer 503. Pass `null` to opt out
+     * have no process, pass env.CRONWATCH_TOKEN); an empty string or one of
+     * only whitespace, given here or in the variable, counts as unset, and any
+     * other type (false, a number) throws.
+     * With no token in development (the first of CRONWATCH_ENV, APP_ENV and
+     * NODE_ENV that is set names "development", "dev", "local", "test" or
+     * "testing"), the routes make a random one and print a sign-in link to the
+     * server log on their first request; with no token otherwise they answer
+     * 503. Pass `null` to opt out
      * and serve them open everywhere, for example behind your own auth.
      *
      * The check endpoint (/api/check) also accepts the client's cronSecret, so
@@ -62,12 +66,11 @@ interface Routes {
     DELETE: FetchHandler;
 }
 /**
- * A fetch-style handler serving the dashboard and a small JSON API. Mount it
- * in a Next.js app at app/cronwatch/[[...path]]/route.ts:
- *
- *   export const { GET, POST, DELETE } = cw.routes();
+ * The dashboard and its JSON API for a client.
+ * @deprecated Use `cw.routes(options)`, the one way to mount the dashboard
+ * in every port. This name still works through 1.x and goes in 2.0.
  */
-declare function createRoutes(cw: CronWatch, options?: RoutesOptions): Routes;
+declare function createRoutes(cw: Cronwatch, options?: RoutesOptions): Routes;
 
 type JobFn<T> = (job: JobContext) => Promise<T> | T;
 type HandlerFn<T> = (job: JobContext, request: Request) => Promise<T> | T;
@@ -75,9 +78,12 @@ interface HandlerOptions {
     /**
      * Callers must send `Authorization: Bearer <secret>`. Defaults to the
      * client's cronSecret, which defaults to process.env.CRON_SECRET (what
-     * Vercel sends its cron requests with). An empty string counts as unset.
-     * With no secret at all the handler answers 503 unless NODE_ENV is
-     * "development" or "test". Pass null to allow anyone.
+     * Vercel sends its cron requests with). An empty string, or one of only
+     * whitespace, counts as unset; any other type (false, a number) throws.
+     * With no secret at all the handler answers 503 unless the app is in
+     * development (the first of CRONWATCH_ENV, APP_ENV and NODE_ENV that is
+     * set names "development", "dev", "local", "test" or "testing"). Pass
+     * null to allow anyone.
      */
     secret?: string | null;
 }
@@ -162,13 +168,13 @@ interface RunHandle {
 }
 /**
  * What a Source may use of the client: declare jobs, read the store, and
- * record runs it found elsewhere. A CronWatch is one.
+ * record runs it found elsewhere. A Cronwatch is one.
  */
 interface SourceHost {
-    /** Declare a job, as CronWatch.job(). Throws for an invalid name or option. */
+    /** Declare a job, as Cronwatch.job(). Throws for an invalid name or option. */
     job(name: string, options?: JobOptions): unknown;
     /**
-     * The definitions declared now, as CronWatch.definedJobs(): a source reads
+     * The definitions declared now, as Cronwatch.definedJobs(): a source reads
      * it to declare again a job forgotten since (the dashboard's forget), whose
      * definition has not changed. A host without it is taken to keep every
      * job the source declared.
@@ -176,7 +182,7 @@ interface SourceHost {
     definedJobs?(): {
         name: string;
     }[];
-    /** See CronWatch.recordRun(). */
+    /** See Cronwatch.recordRun(). */
     recordRun(run: Run, options?: RecordRunOptions): Promise<Alert[]>;
     readonly store: Store;
     readonly now: () => number;
@@ -196,7 +202,7 @@ interface RecordRunOptions {
     /** False stores the run without evaluating it, for history imported on first sight. Default true. */
     evaluate?: boolean;
 }
-interface CronWatchOptions {
+interface CronwatchOptions {
     /** Where jobs, runs and state live. Defaults to an in-memory store that forgets on restart. */
     store?: Store;
     /**
@@ -212,8 +218,9 @@ interface CronWatchOptions {
     /**
      * Shared secret that handler() requests must carry. Defaults to
      * process.env.CRON_SECRET (on Cloudflare Workers, which have no process,
-     * pass env.CRON_SECRET); an empty string counts as unset. Pass null to
-     * let handlers run without one.
+     * pass env.CRON_SECRET); an empty string or one of only whitespace, given
+     * here or in the variable, counts as unset. Pass null to let handlers run
+     * without one. Any other type (false, a number) throws.
      */
     cronSecret?: string | null;
     /** How long finished runs are kept. Default "30d". */
@@ -243,7 +250,7 @@ interface CronWatchOptions {
     /** The clock. Tests use this. */
     now?: () => number;
 }
-declare class CronWatch {
+declare class Cronwatch {
     readonly store: Store;
     readonly alerts: AlertChannel[];
     readonly triage: TriageFn | undefined;
@@ -256,7 +263,7 @@ declare class CronWatch {
     /** cronSecret was passed as null: handlers may run without a secret. */
     private readonly secretOptOut;
     private readonly redact;
-    /** "check": queue alerts for another process's check instead of sending them. See CronWatchOptions.deliver. */
+    /** "check": queue alerts for another process's check instead of sending them. See CronwatchOptions.deliver. */
     private readonly deferDelivery;
     private readonly defaults;
     private readonly definitions;
@@ -275,7 +282,9 @@ declare class CronWatch {
     private usingDefaultStore;
     private warnedNoSecret;
     private warnedDeferredStart;
-    constructor(options?: CronWatchOptions);
+    /** Stored jobs read with a definition that was not a JSON object (see readJob). */
+    private readonly unreadable;
+    constructor(options?: CronwatchOptions);
     /** Declare a job. Call it once, at module level, and keep the handle. */
     job(name: string, options?: JobOptions): JobHandle;
     /** Run a job by name without keeping a handle. Defines it on first use. */
@@ -313,6 +322,10 @@ declare class CronWatch {
      * checked and shown while any process still declares it.
      */
     private storedJobs;
+    /** A stored job read leniently (readStoredJob); one whose definition is unreadable is remembered, so that evaluating it throws. */
+    private readJob;
+    /** Throws for a job whose stored definition was not a JSON object: reported, and shown as failing, while the others carry on. */
+    private evaluable;
     /**
      * Runs `fn` after every earlier state update for the same job has settled,
      * so two runs (or a run and a check) in this process never read and write
@@ -464,14 +477,27 @@ declare class CronWatch {
      * it on its next run there, or at that process's next check or dashboard read.
      */
     forget(name: string): Promise<void>;
-    /** The dashboard and JSON API as fetch-style handlers. See createRoutes(). */
+    /**
+     * The dashboard and JSON API as fetch-style handlers: the one way to mount
+     * them. A Next.js app exports them from app/cronwatch/[[...path]]/route.ts:
+     *
+     *   export const { GET, POST, DELETE } = cw.routes();
+     */
     routes(options?: RoutesOptions): Routes;
     /**
      * Check on an interval, for long-running servers. Default every minute.
      * Not for serverless functions or Cloudflare Workers, where nothing runs
-     * between requests: call check() from a cron there instead.
+     * between requests: call check() from a cron there instead. (A job's
+     * start() opens a run; this starts the checks.)
+     */
+    startChecking(every?: Duration): void;
+    /**
+     * startChecking(), under its former name.
+     * @deprecated Renamed `startChecking`, since a job's `start()` opens a run.
+     * This name still works through 1.x and goes in 2.0.
      */
     start(every?: Duration): void;
+    /** Stop the checks startChecking() began. */
     stop(): void;
     /**
      * Stop the interval, wait for a check already under way (bounded by its
@@ -516,4 +542,15 @@ declare function consoleChannel(): AlertChannel;
 /** Wrap any function as an alert channel. */
 declare function custom(name: string, send: (alert: Alert) => Promise<void> | void): AlertChannel;
 
-export { type CronWatchOptions as C, type FetchHandler as F, type HandlerFn as H, type JobContext as J, type RecordRunOptions as R, type Source as S, CronWatch as a, type HandlerOptions as b, type JobFn as c, type JobHandle as d, type Routes as e, type RoutesOptions as f, type RunHandle as g, type RunOutcome as h, type SourceHost as i, type StartOptions as j, consoleChannel as k, createRoutes as l, custom as m };
+/**
+ * The client's former name.
+ * @deprecated Renamed `Cronwatch`, the spelling every port uses. This name
+ * still works through 1.x and goes in 2.0.
+ */
+declare const CronWatch: typeof Cronwatch;
+/** @deprecated Renamed `Cronwatch`; this name goes in 2.0. */
+type CronWatch = Cronwatch;
+/** @deprecated Renamed `CronwatchOptions`; this name goes in 2.0. */
+type CronWatchOptions = CronwatchOptions;
+
+export { type CronwatchOptions as C, type FetchHandler as F, type HandlerFn as H, type JobContext as J, type RecordRunOptions as R, type Source as S, Cronwatch as a, CronWatch as b, type CronWatchOptions as c, type HandlerOptions as d, type JobFn as e, type JobHandle as f, type Routes as g, type RoutesOptions as h, type RunHandle as i, type RunOutcome as j, type SourceHost as k, type StartOptions as l, consoleChannel as m, createRoutes as n, custom as o };

package/dist/d1.cjs

@@ -54,7 +54,7 @@ function statements(dialect, p) {
   const byName = "name";
   const version = (column) => {
     const v = `json_extract(${column}, '$.version')`;
-    return `CASE WHEN json_type(${column}, '$.version') NOT IN ('integer', 'real') THEN 0 WHEN ${v} = CAST(${v} AS INTEGER) AND ${v} BETWEEN 0 AND 9007199254740991 THEN CAST(${v} AS INTEGER) ELSE 0 END`;
+    return `CASE WHEN NOT json_valid(${column}) THEN 0 WHEN json_type(${column}, '$.version') NOT IN ('integer', 'real') THEN 0 WHEN ${v} = CAST(${v} AS INTEGER) AND ${v} BETWEEN 0 AND 9007199254740991 THEN CAST(${v} AS INTEGER) ELSE 0 END`;
   };
   const sql = {
     upsertJob: `INSERT INTO ${p}jobs (name, definition, created_at, updated_at) VALUES (?, ?, ?, ?)
@@ -119,23 +119,41 @@ var params = {
   casInsert: (state) => [state.job, jsonText(state)],
   casUpdate: (state, expectedVersion) => [jsonText(state), state.job, expectedVersion]
 };
-var json = (v) => typeof v === "string" ? JSON.parse(v) : v;
-var num = (v) => v === null ? null : Number(v);
+var json = (v) => {
+  if (typeof v !== "string") return v;
+  try {
+    return JSON.parse(v);
+  } catch {
+    return null;
+  }
+};
+var number = (v) => typeof v === "number" ? v : typeof v === "string" && v.trim() !== "" ? Number(v) : Number.NaN;
+var time = (v) => {
+  const n = number(v);
+  return Number.isFinite(n) ? n : 0;
+};
+var maybeTime = (v) => {
+  const n = number(v);
+  return Number.isFinite(n) ? n : null;
+};
+var textOrNull = (v) => typeof v === "string" ? v : null;
+var isObject = (v) => typeof v === "object" && v !== null && !Array.isArray(v);
 function rowToJob(r) {
-  return { name: r.name, definition: json(r.definition), createdAt: Number(r.created_at), updatedAt: Number(r.updated_at) };
+  return { name: r.name, definition: json(r.definition), createdAt: time(r.created_at), updatedAt: time(r.updated_at) };
 }
 function rowToRun(r) {
+  const metrics = json(r.metrics);
   return {
     id: r.id,
     job: r.job,
     status: r.status,
-    startedAt: Number(r.started_at),
-    finishedAt: num(r.finished_at),
-    durationMs: num(r.duration_ms),
-    error: r.error,
-    output: r.output,
-    metrics: r.metrics === null ? {} : json(r.metrics),
-    trigger: r.trigger
+    startedAt: time(r.started_at),
+    finishedAt: maybeTime(r.finished_at),
+    durationMs: maybeTime(r.duration_ms),
+    error: textOrNull(r.error),
+    output: textOrNull(r.output),
+    metrics: isObject(metrics) ? metrics : {},
+    trigger: typeof r.trigger === "string" ? r.trigger : "run"
   };
 }
 function rowToState(r) {