@cronwatch/sdk 0.1.0 → 0.3.1

package/dist/sqlite.d.cts

@@ -1,11 +1,13 @@
 import Database from 'better-sqlite3';
-import { S as Store } from './types-BQ1P8z55.cjs';
+import { S as Store } from './types-DUt2apl0.cjs';
 
 interface SqliteOptions {
     /** File path. The directory is created if missing. ":memory:" works too. */
     path?: string;
     /** Bring your own open better-sqlite3 database instead. */
     database?: Database.Database;
+    /** Table name prefix: lowercase letters, digits and underscores. Default "cronwatch_". */
+    prefix?: string;
 }
 /**
  * Keeps everything in one SQLite file through better-sqlite3. The right

package/dist/sqlite.d.ts

@@ -1,11 +1,13 @@
 import Database from 'better-sqlite3';
-import { S as Store } from './types-BQ1P8z55.js';
+import { S as Store } from './types-DUt2apl0.js';
 
 interface SqliteOptions {
     /** File path. The directory is created if missing. ":memory:" works too. */
     path?: string;
     /** Bring your own open better-sqlite3 database instead. */
     database?: Database.Database;
+    /** Table name prefix: lowercase letters, digits and underscores. Default "cronwatch_". */
+    prefix?: string;
 }
 /**
  * Keeps everything in one SQLite file through better-sqlite3. The right

package/dist/sqlite.js

@@ -1,136 +1,246 @@
 import Database from 'better-sqlite3';
-import { mkdirSync, chmodSync } from 'fs';
+import { mkdirSync, closeSync, openSync, chmodSync } from 'fs';
 import path from 'path';
 
 // src/stores/sqlite.ts
+
+// src/stores/busy.ts
+var BUSY_RETRY_MS = 2e3;
+function sleepSync(ms) {
+  Atomics.wait(new Int32Array(new SharedArrayBuffer(4)), 0, 0, ms);
+}
+function retryBusy(fn, budgetMs = BUSY_RETRY_MS, sleep = sleepSync) {
+  let waited = 0;
+  for (let attempt = 0; ; attempt++) {
+    try {
+      return fn();
+    } catch (e) {
+      const code = e?.code;
+      const busy = typeof code === "string" && (code.startsWith("SQLITE_BUSY") || code.startsWith("SQLITE_LOCKED"));
+      if (!busy || waited >= budgetMs) throw e;
+      const pause = Math.min(10 * 2 ** attempt, 200, budgetMs - waited);
+      sleep(pause);
+      waited += pause;
+    }
+  }
+}
+
+// src/stores/sql.ts
+var DEFAULT_PREFIX = "cronwatch_";
+var MAX_PREFIX = 63 - "runs_job_started".length;
+function tablePrefix(prefix = DEFAULT_PREFIX) {
+  if (!/^[a-z_][a-z0-9_]*$/.test(prefix) || prefix.length > MAX_PREFIX) {
+    throw new Error(
+      `cronwatch: invalid table prefix ${JSON.stringify(prefix)}. Use lowercase letters, digits and underscores, not starting with a digit, at most ${MAX_PREFIX} characters.`
+    );
+  }
+  return prefix;
+}
+function schema(dialect, p) {
+  const int = "INTEGER";
+  const json2 = "TEXT";
+  return `
+    CREATE TABLE IF NOT EXISTS ${p}jobs (
+      name TEXT PRIMARY KEY,
+      definition ${json2} NOT NULL,
+      created_at ${int} NOT NULL,
+      updated_at ${int} NOT NULL
+    );
+    CREATE TABLE IF NOT EXISTS ${p}runs (${""}
+      id TEXT PRIMARY KEY,
+      job TEXT NOT NULL,
+      status TEXT NOT NULL,
+      started_at ${int} NOT NULL,
+      finished_at ${int},
+      duration_ms ${int},
+      error TEXT,
+      output TEXT,
+      metrics ${json2} NOT NULL DEFAULT '{}',
+      trigger TEXT NOT NULL DEFAULT 'run'
+    );
+    CREATE INDEX IF NOT EXISTS ${p}runs_job_started ON ${p}runs (job, started_at DESC);
+    CREATE INDEX IF NOT EXISTS ${p}runs_running ON ${p}runs (status) WHERE status = 'running';
+    CREATE TABLE IF NOT EXISTS ${p}state (
+      job TEXT PRIMARY KEY,
+      state ${json2} NOT NULL
+    );
+  `;
+}
+function statements(dialect, p) {
+  const seq = "rowid";
+  const byName = "name";
+  const version = (column) => `COALESCE(json_extract(${column}, '$.version'), 0)`;
+  const sql = {
+    upsertJob: `INSERT INTO ${p}jobs (name, definition, created_at, updated_at) VALUES (?, ?, ?, ?)
+      ON CONFLICT (name) DO UPDATE SET definition = excluded.definition, updated_at = excluded.updated_at`,
+    getJob: `SELECT * FROM ${p}jobs WHERE name = ?`,
+    listJobs: `SELECT * FROM ${p}jobs ORDER BY ${byName}`,
+    deleteRuns: `DELETE FROM ${p}runs WHERE job = ?`,
+    deleteState: `DELETE FROM ${p}state WHERE job = ?`,
+    deleteJob: `DELETE FROM ${p}jobs WHERE name = ?`,
+    insertRun: `INSERT INTO ${p}runs (id, job, status, started_at, finished_at, duration_ms, error, output, metrics, trigger)
+      VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?)`,
+    updateRun: `UPDATE ${p}runs SET status = ?, finished_at = ?, duration_ms = ?, error = ?, output = ?, metrics = ? WHERE id = ?`,
+    getRun: `SELECT * FROM ${p}runs WHERE id = ?`,
+    listRuns: `SELECT * FROM ${p}runs WHERE job = ? ORDER BY started_at DESC, ${seq} DESC LIMIT ?`,
+    runningRuns: `SELECT * FROM ${p}runs WHERE status = 'running' ORDER BY started_at, ${seq}`,
+    getState: `SELECT state FROM ${p}state WHERE job = ?`,
+    setState: `INSERT INTO ${p}state (job, state) VALUES (?, ?) ON CONFLICT (job) DO UPDATE SET state = excluded.state`,
+    // compareAndSetState. Expecting version 0 also matches a missing row, so
+    // that case inserts; any other version must find its row.
+    casInsert: `INSERT INTO ${p}state (job, state) VALUES (?, ?)
+      ON CONFLICT (job) DO UPDATE SET state = excluded.state WHERE ${version(`${p}state.state`)} = 0`,
+    casUpdate: `UPDATE ${p}state SET state = ? WHERE job = ? AND ${version("state")} = ?`,
+    // Each job's newest run is kept whatever its age: without it, a job that
+    // runs less often than the retention looks like it never ran.
+    prune: `DELETE FROM ${p}runs WHERE status <> 'running' AND started_at < ?
+      AND started_at < (SELECT MAX(r.started_at) FROM ${p}runs r WHERE r.job = ${p}runs.job)`
+  };
+  return sql;
+}
+var params = {
+  upsertJob: (definition, now) => [definition.name, JSON.stringify(definition), now, now],
+  insertRun: (run) => [
+    run.id,
+    run.job,
+    run.status,
+    run.startedAt,
+    run.finishedAt,
+    run.durationMs,
+    run.error,
+    run.output,
+    JSON.stringify(run.metrics),
+    run.trigger
+  ],
+  updateRun: (run) => [run.status, run.finishedAt, run.durationMs, run.error, run.output, JSON.stringify(run.metrics), run.id],
+  setState: (state) => [state.job, JSON.stringify(state)],
+  casInsert: (state) => [state.job, JSON.stringify(state)],
+  casUpdate: (state, expectedVersion) => [JSON.stringify(state), state.job, expectedVersion]
+};
+var json = (v) => typeof v === "string" ? JSON.parse(v) : v;
+var num = (v) => v === null ? null : Number(v);
+function rowToJob(r) {
+  return { name: r.name, definition: json(r.definition), createdAt: Number(r.created_at), updatedAt: Number(r.updated_at) };
+}
 function rowToRun(r) {
   return {
     id: r.id,
     job: r.job,
     status: r.status,
-    startedAt: r.started_at,
-    finishedAt: r.finished_at,
-    durationMs: r.duration_ms,
+    startedAt: Number(r.started_at),
+    finishedAt: num(r.finished_at),
+    durationMs: num(r.duration_ms),
     error: r.error,
     output: r.output,
-    metrics: JSON.parse(r.metrics),
+    metrics: r.metrics === null ? {} : json(r.metrics),
     trigger: r.trigger
   };
 }
+function rowToState(r) {
+  return json(r.state);
+}
+
+// src/stores/sqlite.ts
 function sqlite(options = {}) {
+  const p = tablePrefix(options.prefix);
+  const sql = statements("sqlite", p);
   let db = options.database ?? null;
   const file = options.path ?? "./data/cronwatch.db";
+  const cache = /* @__PURE__ */ new Map();
   const open = () => {
     if (db) return db;
-    if (file !== ":memory:") {
+    const onDisk = file !== ":memory:" && file !== "";
+    if (onDisk) {
       mkdirSync(path.dirname(file), { recursive: true });
-    }
-    db = new Database(file);
-    if (file !== ":memory:") {
       try {
-        chmodSync(file, 384);
+        closeSync(openSync(file, "a", 384));
+        for (const f of [file, `${file}-wal`, `${file}-shm`]) {
+          try {
+            chmodSync(f, 384);
+          } catch {
+          }
+        }
       } catch {
       }
     }
-    db.pragma("journal_mode = WAL");
-    db.pragma("busy_timeout = 5000");
-    db.pragma("synchronous = NORMAL");
+    const opened = new Database(file, { timeout: 0 });
+    try {
+      retryBusy(() => opened.pragma("journal_mode = WAL"));
+      opened.pragma("busy_timeout = 5000");
+      opened.pragma("synchronous = NORMAL");
+    } catch (e) {
+      opened.close();
+      throw e;
+    }
+    db = opened;
     return db;
   };
+  const stmt = (text) => {
+    let s = cache.get(text);
+    if (!s) {
+      s = open().prepare(text);
+      cache.set(text, s);
+    }
+    return s;
+  };
+  const forget = (name) => {
+    stmt(sql.deleteRuns).run(name);
+    stmt(sql.deleteState).run(name);
+    stmt(sql.deleteJob).run(name);
+  };
   return {
     async init() {
-      const d = open();
-      d.exec(`
-        CREATE TABLE IF NOT EXISTS cronwatch_jobs (
-          name TEXT PRIMARY KEY,
-          definition TEXT NOT NULL,
-          created_at INTEGER NOT NULL,
-          updated_at INTEGER NOT NULL
-        );
-        CREATE TABLE IF NOT EXISTS cronwatch_runs (
-          id TEXT PRIMARY KEY,
-          job TEXT NOT NULL,
-          status TEXT NOT NULL,
-          started_at INTEGER NOT NULL,
-          finished_at INTEGER,
-          duration_ms INTEGER,
-          error TEXT,
-          output TEXT,
-          metrics TEXT NOT NULL DEFAULT '{}',
-          trigger TEXT NOT NULL DEFAULT 'run'
-        );
-        CREATE INDEX IF NOT EXISTS cronwatch_runs_job_started ON cronwatch_runs (job, started_at DESC);
-        CREATE INDEX IF NOT EXISTS cronwatch_runs_running ON cronwatch_runs (status) WHERE status = 'running';
-        CREATE TABLE IF NOT EXISTS cronwatch_state (
-          job TEXT PRIMARY KEY,
-          state TEXT NOT NULL
-        );
-      `);
+      open().exec(schema("sqlite", p));
     },
     async upsertJob(definition, now) {
-      open().prepare(`
-        INSERT INTO cronwatch_jobs (name, definition, created_at, updated_at) VALUES (?, ?, ?, ?)
-        ON CONFLICT(name) DO UPDATE SET definition = excluded.definition, updated_at = excluded.updated_at
-      `).run(definition.name, JSON.stringify(definition), now, now);
+      stmt(sql.upsertJob).run(...params.upsertJob(definition, now));
     },
     async getJob(name) {
-      const r = open().prepare("SELECT * FROM cronwatch_jobs WHERE name = ?").get(name);
-      return r ? { name: r.name, definition: JSON.parse(r.definition), createdAt: r.created_at, updatedAt: r.updated_at } : null;
+      const r = stmt(sql.getJob).get(name);
+      return r ? rowToJob(r) : null;
     },
     async listJobs() {
-      const rows = open().prepare("SELECT * FROM cronwatch_jobs ORDER BY name").all();
-      return rows.map((r) => ({ name: r.name, definition: JSON.parse(r.definition), createdAt: r.created_at, updatedAt: r.updated_at }));
+      return stmt(sql.listJobs).all().map(rowToJob);
     },
     async deleteJob(name) {
-      const d = open();
-      d.transaction(() => {
-        d.prepare("DELETE FROM cronwatch_runs WHERE job = ?").run(name);
-        d.prepare("DELETE FROM cronwatch_state WHERE job = ?").run(name);
-        d.prepare("DELETE FROM cronwatch_jobs WHERE name = ?").run(name);
-      })();
+      open().transaction(forget)(name);
     },
     async insertRun(run) {
-      open().prepare(`
-        INSERT INTO cronwatch_runs (id, job, status, started_at, finished_at, duration_ms, error, output, metrics, trigger)
-        VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?)
-      `).run(run.id, run.job, run.status, run.startedAt, run.finishedAt, run.durationMs, run.error, run.output, JSON.stringify(run.metrics), run.trigger);
+      stmt(sql.insertRun).run(...params.insertRun(run));
     },
     async updateRun(run) {
-      open().prepare(`
-        UPDATE cronwatch_runs SET status = ?, finished_at = ?, duration_ms = ?, error = ?, output = ?, metrics = ? WHERE id = ?
-      `).run(run.status, run.finishedAt, run.durationMs, run.error, run.output, JSON.stringify(run.metrics), run.id);
+      stmt(sql.updateRun).run(...params.updateRun(run));
     },
     async getRun(id) {
-      const r = open().prepare("SELECT * FROM cronwatch_runs WHERE id = ?").get(id);
+      const r = stmt(sql.getRun).get(id);
       return r ? rowToRun(r) : null;
     },
     async listRuns(job, limit) {
-      const rows = open().prepare("SELECT * FROM cronwatch_runs WHERE job = ? ORDER BY started_at DESC, rowid DESC LIMIT ?").all(job, limit);
-      return rows.map(rowToRun);
+      return stmt(sql.listRuns).all(job, limit).map(rowToRun);
     },
     async lastRun(job) {
-      const r = open().prepare("SELECT * FROM cronwatch_runs WHERE job = ? ORDER BY started_at DESC, rowid DESC LIMIT 1").get(job);
+      const r = stmt(sql.listRuns).get(job, 1);
       return r ? rowToRun(r) : null;
     },
     async runningRuns() {
-      const rows = open().prepare("SELECT * FROM cronwatch_runs WHERE status = 'running' ORDER BY started_at").all();
-      return rows.map(rowToRun);
+      return stmt(sql.runningRuns).all().map(rowToRun);
     },
     async getState(job) {
-      const r = open().prepare("SELECT state FROM cronwatch_state WHERE job = ?").get(job);
-      return r ? JSON.parse(r.state) : null;
+      const r = stmt(sql.getState).get(job);
+      return r ? rowToState(r) : null;
     },
     async setState(state) {
-      open().prepare(`
-        INSERT INTO cronwatch_state (job, state) VALUES (?, ?)
-        ON CONFLICT(job) DO UPDATE SET state = excluded.state
-      `).run(state.job, JSON.stringify(state));
+      stmt(sql.setState).run(...params.setState(state));
+    },
+    async compareAndSetState(state, expectedVersion) {
+      const result = expectedVersion === 0 ? stmt(sql.casInsert).run(...params.casInsert(state)) : stmt(sql.casUpdate).run(...params.casUpdate(state, expectedVersion));
+      return result.changes > 0;
     },
     async prune(before) {
-      const info = open().prepare("DELETE FROM cronwatch_runs WHERE status != 'running' AND started_at < ?").run(before);
-      return info.changes;
+      return stmt(sql.prune).run(before).changes;
     },
     async close() {
+      cache.clear();
       if (db && !options.database) {
         db.close();
         db = null;

package/dist/sqlite.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/stores/sqlite.ts"],"names":[],"mappings":"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","file":"sqlite.js","sourcesContent":["import Database from \"better-sqlite3\";\nimport { chmodSync, mkdirSync } from \"node:fs\";\nimport path from \"node:path\";\nimport type { JobState, Run, Store, StoredJob, StoredJobDefinition } from \"../types.js\";\n\nexport interface SqliteOptions {\n  /** File path. The directory is created if missing. \":memory:\" works too. */\n  path?: string;\n  /** Bring your own open better-sqlite3 database instead. */\n  database?: Database.Database;\n}\n\ninterface JobRow { name: string; definition: string; created_at: number; updated_at: number }\ninterface RunRow {\n  id: string; job: string; status: Run[\"status\"]; started_at: number; finished_at: number | null;\n  duration_ms: number | null; error: string | null; output: string | null; metrics: string; trigger: string;\n}\n\nfunction rowToRun(r: RunRow): Run {\n  return {\n    id: r.id, job: r.job, status: r.status, startedAt: r.started_at, finishedAt: r.finished_at,\n    durationMs: r.duration_ms, error: r.error, output: r.output, metrics: JSON.parse(r.metrics), trigger: r.trigger,\n  };\n}\n\n/**\n * Keeps everything in one SQLite file through better-sqlite3. The right\n * choice for a single server. WAL mode, so the app's reads never block on a\n * run being written.\n */\nexport function sqlite(options: SqliteOptions = {}): Store {\n  let db: Database.Database | null = options.database ?? null;\n  const file = options.path ?? \"./data/cronwatch.db\";\n\n  const open = (): Database.Database => {\n    if (db) return db;\n    if (file !== \":memory:\") {\n      mkdirSync(path.dirname(file), { recursive: true });\n    }\n    db = new Database(file);\n    if (file !== \":memory:\") {\n      try { chmodSync(file, 0o600); } catch { /* best effort: not every filesystem cares */ }\n    }\n    db.pragma(\"journal_mode = WAL\");\n    db.pragma(\"busy_timeout = 5000\");\n    db.pragma(\"synchronous = NORMAL\");\n    return db;\n  };\n\n  return {\n    async init() {\n      const d = open();\n      d.exec(`\n        CREATE TABLE IF NOT EXISTS cronwatch_jobs (\n          name TEXT PRIMARY KEY,\n          definition TEXT NOT NULL,\n          created_at INTEGER NOT NULL,\n          updated_at INTEGER NOT NULL\n        );\n        CREATE TABLE IF NOT EXISTS cronwatch_runs (\n          id TEXT PRIMARY KEY,\n          job TEXT NOT NULL,\n          status TEXT NOT NULL,\n          started_at INTEGER NOT NULL,\n          finished_at INTEGER,\n          duration_ms INTEGER,\n          error TEXT,\n          output TEXT,\n          metrics TEXT NOT NULL DEFAULT '{}',\n          trigger TEXT NOT NULL DEFAULT 'run'\n        );\n        CREATE INDEX IF NOT EXISTS cronwatch_runs_job_started ON cronwatch_runs (job, started_at DESC);\n        CREATE INDEX IF NOT EXISTS cronwatch_runs_running ON cronwatch_runs (status) WHERE status = 'running';\n        CREATE TABLE IF NOT EXISTS cronwatch_state (\n          job TEXT PRIMARY KEY,\n          state TEXT NOT NULL\n        );\n      `);\n    },\n    async upsertJob(definition: StoredJobDefinition, now: number) {\n      open().prepare(`\n        INSERT INTO cronwatch_jobs (name, definition, created_at, updated_at) VALUES (?, ?, ?, ?)\n        ON CONFLICT(name) DO UPDATE SET definition = excluded.definition, updated_at = excluded.updated_at\n      `).run(definition.name, JSON.stringify(definition), now, now);\n    },\n    async getJob(name) {\n      const r = open().prepare(\"SELECT * FROM cronwatch_jobs WHERE name = ?\").get(name) as JobRow | undefined;\n      return r ? { name: r.name, definition: JSON.parse(r.definition), createdAt: r.created_at, updatedAt: r.updated_at } : null;\n    },\n    async listJobs(): Promise<StoredJob[]> {\n      const rows = open().prepare(\"SELECT * FROM cronwatch_jobs ORDER BY name\").all() as JobRow[];\n      return rows.map((r) => ({ name: r.name, definition: JSON.parse(r.definition), createdAt: r.created_at, updatedAt: r.updated_at }));\n    },\n    async deleteJob(name) {\n      const d = open();\n      d.transaction(() => {\n        d.prepare(\"DELETE FROM cronwatch_runs WHERE job = ?\").run(name);\n        d.prepare(\"DELETE FROM cronwatch_state WHERE job = ?\").run(name);\n        d.prepare(\"DELETE FROM cronwatch_jobs WHERE name = ?\").run(name);\n      })();\n    },\n    async insertRun(run) {\n      open().prepare(`\n        INSERT INTO cronwatch_runs (id, job, status, started_at, finished_at, duration_ms, error, output, metrics, trigger)\n        VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?)\n      `).run(run.id, run.job, run.status, run.startedAt, run.finishedAt, run.durationMs, run.error, run.output, JSON.stringify(run.metrics), run.trigger);\n    },\n    async updateRun(run) {\n      open().prepare(`\n        UPDATE cronwatch_runs SET status = ?, finished_at = ?, duration_ms = ?, error = ?, output = ?, metrics = ? WHERE id = ?\n      `).run(run.status, run.finishedAt, run.durationMs, run.error, run.output, JSON.stringify(run.metrics), run.id);\n    },\n    async getRun(id) {\n      const r = open().prepare(\"SELECT * FROM cronwatch_runs WHERE id = ?\").get(id) as RunRow | undefined;\n      return r ? rowToRun(r) : null;\n    },\n    async listRuns(job, limit) {\n      const rows = open().prepare(\"SELECT * FROM cronwatch_runs WHERE job = ? ORDER BY started_at DESC, rowid DESC LIMIT ?\").all(job, limit) as RunRow[];\n      return rows.map(rowToRun);\n    },\n    async lastRun(job) {\n      const r = open().prepare(\"SELECT * FROM cronwatch_runs WHERE job = ? ORDER BY started_at DESC, rowid DESC LIMIT 1\").get(job) as RunRow | undefined;\n      return r ? rowToRun(r) : null;\n    },\n    async runningRuns() {\n      const rows = open().prepare(\"SELECT * FROM cronwatch_runs WHERE status = 'running' ORDER BY started_at\").all() as RunRow[];\n      return rows.map(rowToRun);\n    },\n    async getState(job) {\n      const r = open().prepare(\"SELECT state FROM cronwatch_state WHERE job = ?\").get(job) as { state: string } | undefined;\n      return r ? (JSON.parse(r.state) as JobState) : null;\n    },\n    async setState(state) {\n      open().prepare(`\n        INSERT INTO cronwatch_state (job, state) VALUES (?, ?)\n        ON CONFLICT(job) DO UPDATE SET state = excluded.state\n      `).run(state.job, JSON.stringify(state));\n    },\n    async prune(before) {\n      const info = open().prepare(\"DELETE FROM cronwatch_runs WHERE status != 'running' AND started_at < ?\").run(before);\n      return info.changes;\n    },\n    async close() {\n      if (db && !options.database) {\n        db.close();\n        db = null;\n      }\n    },\n  };\n}\n"]}
+{"version":3,"sources":["../src/stores/busy.ts","../src/stores/sql.ts","../src/stores/sqlite.ts"],"names":["json"],"mappings":"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","file":"sqlite.js","sourcesContent":["/** How long opening SQLite keeps retrying a busy database before it gives up. */\nexport const BUSY_RETRY_MS = 2_000;\n\nfunction sleepSync(ms: number): void {\n  Atomics.wait(new Int32Array(new SharedArrayBuffer(4)), 0, 0, ms);\n}\n\n/**\n * Runs `fn`, retrying while SQLite answers SQLITE_BUSY (or SQLITE_LOCKED),\n * with a short growing pause, for up to `budgetMs` in all. Opening a\n * better-sqlite3 database is synchronous, so the pause is too.\n */\nexport function retryBusy<T>(fn: () => T, budgetMs = BUSY_RETRY_MS, sleep: (ms: number) => void = sleepSync): T {\n  let waited = 0;\n  for (let attempt = 0; ; attempt++) {\n    try {\n      return fn();\n    } catch (e) {\n      const code = (e as { code?: unknown } | null)?.code;\n      const busy = typeof code === \"string\" && (code.startsWith(\"SQLITE_BUSY\") || code.startsWith(\"SQLITE_LOCKED\"));\n      if (!busy || waited >= budgetMs) throw e;\n      const pause = Math.min(10 * 2 ** attempt, 200, budgetMs - waited);\n      sleep(pause);\n      waited += pause;\n    }\n  }\n}\n","import type { JobState, Run, StoredJob, StoredJobDefinition } from \"../types.js\";\n\n/**\n * The schema, statements and row mapping shared by the SQLite and Postgres\n * stores. Imports no driver, so either entry point can pull it in alone.\n * Statements are written with `?` placeholders; Postgres numbers them.\n */\n\nexport type Dialect = \"sqlite\" | \"postgres\";\n\nexport const DEFAULT_PREFIX = \"cronwatch_\";\n\n// Postgres truncates identifiers past 63 bytes; the longest name we build is the prefix plus \"runs_job_started\".\nconst MAX_PREFIX = 63 - \"runs_job_started\".length;\n\n/**\n * Table names are built from the prefix, so it must be a plain lowercase\n * identifier. Uppercase is refused rather than folded: Postgres lowercases\n * unquoted names, so \"Monitoring_\" would quietly become \"monitoring_\".\n */\nexport function tablePrefix(prefix: string = DEFAULT_PREFIX): string {\n  if (!/^[a-z_][a-z0-9_]*$/.test(prefix) || prefix.length > MAX_PREFIX) {\n    throw new Error(\n      `cronwatch: invalid table prefix ${JSON.stringify(prefix)}. Use lowercase letters, digits and underscores, ` +\n        `not starting with a digit, at most ${MAX_PREFIX} characters.`,\n    );\n  }\n  return prefix;\n}\n\nexport function schema(dialect: Dialect, p: string): string {\n  const pg = dialect === \"postgres\";\n  const int = pg ? \"BIGINT\" : \"INTEGER\";\n  const json = pg ? \"JSONB\" : \"TEXT\";\n  return `\n    CREATE TABLE IF NOT EXISTS ${p}jobs (\n      name TEXT PRIMARY KEY,\n      definition ${json} NOT NULL,\n      created_at ${int} NOT NULL,\n      updated_at ${int} NOT NULL\n    );\n    CREATE TABLE IF NOT EXISTS ${p}runs (${pg ? \"\\n      seq BIGSERIAL,\" : \"\"}\n      id TEXT PRIMARY KEY,\n      job TEXT NOT NULL,\n      status TEXT NOT NULL,\n      started_at ${int} NOT NULL,\n      finished_at ${int},\n      duration_ms ${int},\n      error TEXT,\n      output TEXT,\n      metrics ${json} NOT NULL DEFAULT '{}',\n      trigger TEXT NOT NULL DEFAULT 'run'\n    );\n    CREATE INDEX IF NOT EXISTS ${p}runs_job_started ON ${p}runs (job, started_at DESC);\n    CREATE INDEX IF NOT EXISTS ${p}runs_running ON ${p}runs (status) WHERE status = 'running';\n    CREATE TABLE IF NOT EXISTS ${p}state (\n      job TEXT PRIMARY KEY,\n      state ${json} NOT NULL\n    );\n  `;\n}\n\nexport function statements(dialect: Dialect, p: string) {\n  const pg = dialect === \"postgres\";\n  // Insertion order, to break ties between runs that started in the same millisecond.\n  const seq = pg ? \"seq\" : \"rowid\";\n  // Byte order on both, so names sort the same whatever the database's collation.\n  const byName = pg ? `name COLLATE \"C\"` : \"name\";\n  // The version inside a state's JSON, 0 when it has none.\n  const version = (column: string) => (pg ? `COALESCE((${column}->>'version')::bigint, 0)` : `COALESCE(json_extract(${column}, '$.version'), 0)`);\n  const sql = {\n    upsertJob: `INSERT INTO ${p}jobs (name, definition, created_at, updated_at) VALUES (?, ?, ?, ?)\n      ON CONFLICT (name) DO UPDATE SET definition = excluded.definition, updated_at = excluded.updated_at`,\n    getJob: `SELECT * FROM ${p}jobs WHERE name = ?`,\n    listJobs: `SELECT * FROM ${p}jobs ORDER BY ${byName}`,\n    deleteRuns: `DELETE FROM ${p}runs WHERE job = ?`,\n    deleteState: `DELETE FROM ${p}state WHERE job = ?`,\n    deleteJob: `DELETE FROM ${p}jobs WHERE name = ?`,\n    insertRun: `INSERT INTO ${p}runs (id, job, status, started_at, finished_at, duration_ms, error, output, metrics, trigger)\n      VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?)`,\n    updateRun: `UPDATE ${p}runs SET status = ?, finished_at = ?, duration_ms = ?, error = ?, output = ?, metrics = ? WHERE id = ?`,\n    getRun: `SELECT * FROM ${p}runs WHERE id = ?`,\n    listRuns: `SELECT * FROM ${p}runs WHERE job = ? ORDER BY started_at DESC, ${seq} DESC LIMIT ?`,\n    runningRuns: `SELECT * FROM ${p}runs WHERE status = 'running' ORDER BY started_at, ${seq}`,\n    getState: `SELECT state FROM ${p}state WHERE job = ?`,\n    setState: `INSERT INTO ${p}state (job, state) VALUES (?, ?) ON CONFLICT (job) DO UPDATE SET state = excluded.state`,\n    // compareAndSetState. Expecting version 0 also matches a missing row, so\n    // that case inserts; any other version must find its row.\n    casInsert: `INSERT INTO ${p}state (job, state) VALUES (?, ?)\n      ON CONFLICT (job) DO UPDATE SET state = excluded.state WHERE ${version(`${p}state.state`)} = 0`,\n    casUpdate: `UPDATE ${p}state SET state = ? WHERE job = ? AND ${version(\"state\")} = ?`,\n    // Each job's newest run is kept whatever its age: without it, a job that\n    // runs less often than the retention looks like it never ran.\n    prune: `DELETE FROM ${p}runs WHERE status <> 'running' AND started_at < ?\n      AND started_at < (SELECT MAX(r.started_at) FROM ${p}runs r WHERE r.job = ${p}runs.job)`,\n  };\n  if (pg) {\n    for (const key of Object.keys(sql) as (keyof typeof sql)[]) {\n      let n = 0;\n      sql[key] = sql[key].replace(/\\?/g, () => `$${++n}`);\n    }\n  }\n  return sql;\n}\n\n// Parameters in statement order, so both drivers bind the same values.\nexport const params = {\n  upsertJob: (definition: StoredJobDefinition, now: number) => [definition.name, JSON.stringify(definition), now, now],\n  insertRun: (run: Run) => [\n    run.id, run.job, run.status, run.startedAt, run.finishedAt, run.durationMs, run.error, run.output, JSON.stringify(run.metrics), run.trigger,\n  ],\n  updateRun: (run: Run) => [run.status, run.finishedAt, run.durationMs, run.error, run.output, JSON.stringify(run.metrics), run.id],\n  setState: (state: JobState) => [state.job, JSON.stringify(state)],\n  casInsert: (state: JobState) => [state.job, JSON.stringify(state)],\n  casUpdate: (state: JobState, expectedVersion: number) => [JSON.stringify(state), state.job, expectedVersion],\n};\n\n// SQLite hands back JSON as TEXT and Postgres as parsed JSONB; Postgres returns BIGINT as a string.\ntype Json<T> = T | string;\ntype Int = number | string;\n\nexport interface JobRow { name: string; definition: Json<StoredJobDefinition>; created_at: Int; updated_at: Int }\nexport interface RunRow {\n  id: string; job: string; status: Run[\"status\"]; started_at: Int; finished_at: Int | null;\n  duration_ms: Int | null; error: string | null; output: string | null; metrics: Json<Record<string, number>> | null; trigger: string;\n}\nexport interface StateRow { state: Json<JobState> }\n\nconst json = <T>(v: Json<T>): T => (typeof v === \"string\" ? (JSON.parse(v) as T) : v);\nconst num = (v: Int | null): number | null => (v === null ? null : Number(v));\n\nexport function rowToJob(r: JobRow): StoredJob {\n  return { name: r.name, definition: json(r.definition), createdAt: Number(r.created_at), updatedAt: Number(r.updated_at) };\n}\n\nexport function rowToRun(r: RunRow): Run {\n  return {\n    id: r.id, job: r.job, status: r.status, startedAt: Number(r.started_at), finishedAt: num(r.finished_at),\n    durationMs: num(r.duration_ms), error: r.error, output: r.output, metrics: r.metrics === null ? {} : json(r.metrics), trigger: r.trigger,\n  };\n}\n\nexport function rowToState(r: StateRow): JobState {\n  return json(r.state);\n}\n","import Database from \"better-sqlite3\";\nimport { chmodSync, closeSync, mkdirSync, openSync } from \"node:fs\";\nimport path from \"node:path\";\nimport type { Store, StoredJob, StoredJobDefinition } from \"../types.js\";\nimport { retryBusy } from \"./busy.js\";\nimport { params, rowToJob, rowToRun, rowToState, schema, statements, tablePrefix, type JobRow, type RunRow, type StateRow } from \"./sql.js\";\n\nexport interface SqliteOptions {\n  /** File path. The directory is created if missing. \":memory:\" works too. */\n  path?: string;\n  /** Bring your own open better-sqlite3 database instead. */\n  database?: Database.Database;\n  /** Table name prefix: lowercase letters, digits and underscores. Default \"cronwatch_\". */\n  prefix?: string;\n}\n\n/**\n * Keeps everything in one SQLite file through better-sqlite3. The right\n * choice for a single server. WAL mode, so the app's reads never block on a\n * run being written.\n */\nexport function sqlite(options: SqliteOptions = {}): Store {\n  const p = tablePrefix(options.prefix);\n  const sql = statements(\"sqlite\", p);\n  let db: Database.Database | null = options.database ?? null;\n  const file = options.path ?? \"./data/cronwatch.db\";\n  const cache = new Map<string, Database.Statement>();\n\n  const open = (): Database.Database => {\n    if (db) return db;\n    const onDisk = file !== \":memory:\" && file !== \"\";\n    if (onDisk) {\n      mkdirSync(path.dirname(file), { recursive: true });\n      // Create the file private before SQLite opens it. SQLite gives the -wal and -shm files the\n      // main file's mode, so the whole set stays 0600; the chmods cover files left by an earlier open.\n      try {\n        closeSync(openSync(file, \"a\", 0o600));\n        for (const f of [file, `${file}-wal`, `${file}-shm`]) {\n          try { chmodSync(f, 0o600); } catch { /* the sidecar may not exist yet */ }\n        }\n      } catch { /* best effort: not every filesystem cares */ }\n    }\n    // No busy handler until WAL is on: switching journal mode can answer\n    // SQLITE_BUSY at once while another process is doing the same on a new\n    // file, so that is retried here. The database is kept only once every\n    // pragma has gone through; a failed open is tried afresh next time.\n    const opened = new Database(file, { timeout: 0 });\n    try {\n      retryBusy(() => opened.pragma(\"journal_mode = WAL\"));\n      opened.pragma(\"busy_timeout = 5000\");\n      opened.pragma(\"synchronous = NORMAL\");\n    } catch (e) {\n      opened.close();\n      throw e;\n    }\n    db = opened;\n    return db;\n  };\n\n  // Each statement is prepared once per open database.\n  const stmt = (text: string): Database.Statement => {\n    let s = cache.get(text);\n    if (!s) {\n      s = open().prepare(text);\n      cache.set(text, s);\n    }\n    return s;\n  };\n\n  const forget = (name: string) => {\n    stmt(sql.deleteRuns).run(name);\n    stmt(sql.deleteState).run(name);\n    stmt(sql.deleteJob).run(name);\n  };\n\n  return {\n    async init() {\n      open().exec(schema(\"sqlite\", p));\n    },\n    async upsertJob(definition: StoredJobDefinition, now: number) {\n      stmt(sql.upsertJob).run(...params.upsertJob(definition, now));\n    },\n    async getJob(name) {\n      const r = stmt(sql.getJob).get(name) as JobRow | undefined;\n      return r ? rowToJob(r) : null;\n    },\n    async listJobs(): Promise<StoredJob[]> {\n      return (stmt(sql.listJobs).all() as JobRow[]).map(rowToJob);\n    },\n    async deleteJob(name) {\n      open().transaction(forget)(name);\n    },\n    async insertRun(run) {\n      stmt(sql.insertRun).run(...params.insertRun(run));\n    },\n    async updateRun(run) {\n      stmt(sql.updateRun).run(...params.updateRun(run));\n    },\n    async getRun(id) {\n      const r = stmt(sql.getRun).get(id) as RunRow | undefined;\n      return r ? rowToRun(r) : null;\n    },\n    async listRuns(job, limit) {\n      return (stmt(sql.listRuns).all(job, limit) as RunRow[]).map(rowToRun);\n    },\n    async lastRun(job) {\n      const r = stmt(sql.listRuns).get(job, 1) as RunRow | undefined;\n      return r ? rowToRun(r) : null;\n    },\n    async runningRuns() {\n      return (stmt(sql.runningRuns).all() as RunRow[]).map(rowToRun);\n    },\n    async getState(job) {\n      const r = stmt(sql.getState).get(job) as StateRow | undefined;\n      return r ? rowToState(r) : null;\n    },\n    async setState(state) {\n      stmt(sql.setState).run(...params.setState(state));\n    },\n    async compareAndSetState(state, expectedVersion) {\n      const result = expectedVersion === 0\n        ? stmt(sql.casInsert).run(...params.casInsert(state))\n        : stmt(sql.casUpdate).run(...params.casUpdate(state, expectedVersion));\n      return result.changes > 0;\n    },\n    async prune(before) {\n      return stmt(sql.prune).run(before).changes;\n    },\n    async close() {\n      cache.clear();\n      if (db && !options.database) {\n        db.close();\n        db = null;\n      }\n    },\n  };\n}\n"]}

package/dist/{types-BQ1P8z55.d.cts → types-DUt2apl0.d.cts}

@@ -84,11 +84,66 @@ interface JobState {
     open: Partial<Record<Condition, number>>;
     consecutiveFailures: number;
     silencedUntil: number | null;
+    /** When an alert last reached at least one channel. */
     lastAlertAt: number | null;
+    /**
+     * Conditions that alerted and have since closed, waiting for the recovered
+     * message that the next successful run sends. Absent in state written
+     * before this field existed.
+     */
+    pendingRecovery?: Condition[];
+    /** Alerts that no channel accepted. Each check retries them once. */
+    undelivered?: Alert[];
+    /**
+     * Goes up by one on every write, so a store can refuse a write made from a
+     * stale read (see Store.compareAndSetState). Absent counts as 0.
+     */
+    version?: number;
 }
 type AlertType = Condition | "recovered";
-interface Alert {
-    type: AlertType;
+interface BudgetBreach {
+    metric: string;
+    value: number;
+    limit: number;
+    basis: string;
+}
+/** What each alert type carries in `details`. */
+interface AlertDetails {
+    missed: {
+        dueAt: number;
+        deadline: number;
+        graceMs: number;
+        lastRunAt: number | null;
+    };
+    failed: {
+        consecutiveFailures: number;
+        threshold: number;
+    };
+    stuck: {
+        consecutiveFailures: number;
+        threshold: number;
+    };
+    slow: {
+        durationMs: number;
+        thresholdMs: number;
+        basis: string;
+    };
+    over_budget: {
+        breaches: BudgetBreach[];
+    };
+    recovered: {
+        after: Condition[];
+    };
+}
+/** An alert before it has a title and message. See composeAlert(). */
+type AlertDraft = {
+    [K in AlertType]: {
+        type: K;
+        run: Run | null;
+        details: AlertDetails[K];
+    };
+}[AlertType];
+interface AlertBase {
     job: string;
     definition: StoredJobDefinition;
     run: Run | null;
@@ -96,11 +151,21 @@ interface Alert {
     title: string;
     /** A few lines of plain text with the specifics. */
     message: string;
-    details: Record<string, unknown>;
-    /** A short diagnosis from the triage function, when one is configured. */
-    triage?: string;
+    /**
+     * A short diagnosis from the triage function, when one is configured. Null
+     * when triage was tried and gave nothing (it threw, timed out or answered
+     * empty); it is not tried again for this alert.
+     */
+    triage?: string | null;
     at: number;
 }
+/** Narrow on `type` to read `details`: `if (alert.type === "slow") alert.details.durationMs`. */
+type Alert = {
+    [K in AlertType]: AlertBase & {
+        type: K;
+        details: AlertDetails[K];
+    };
+}[AlertType];
 interface AlertChannel {
     name: string;
     send(alert: Alert): Promise<void>;
@@ -120,7 +185,17 @@ interface Store {
     lastRun(job: string): Promise<Run | null>;
     runningRuns(): Promise<Run[]>;
     getState(job: string): Promise<JobState | null>;
+    /** Write a job's state unconditionally. Used only when compareAndSetState is missing. */
     setState(state: JobState): Promise<void>;
+    /**
+     * Write `state` only when the stored state's version (see JobState.version;
+     * absent, or no row at all, counts as 0) equals `expectedVersion`. Returns
+     * whether it wrote. This is what keeps two processes sharing a store from
+     * overwriting each other's updates: the client reads, computes, and on a
+     * refused write reads again. A store without it falls back to setState,
+     * which is safe only when one process at a time writes a job's state.
+     */
+    compareAndSetState?(state: JobState, expectedVersion: number): Promise<boolean>;
     /** Delete finished runs that started before this time. Returns how many. */
     prune(before: number): Promise<number>;
     close?(): Promise<void>;
@@ -136,7 +211,7 @@ interface JobSummary {
     nextExpectedAt: number | null;
     consecutiveFailures: number;
     silencedUntil: number | null;
-    /** From the last twenty successful runs. */
+    /** From the last twenty runs of any status; p50Ms and p95Ms are over the successful ones among them. */
     stats: {
         runs: number;
         okRate: number;
@@ -153,7 +228,9 @@ interface CheckResult {
 interface TriageContext {
     alert: Alert;
     recentRuns: Run[];
+    /** Aborts when the client stops waiting for a diagnosis. Pass it to any request you make. */
+    signal: AbortSignal;
 }
 type TriageFn = (context: TriageContext) => Promise<string | null>;
 
-export type { Alert as A, CheckResult as C, Duration as D, ExpectRule as E, JobOptions as J, Run as R, Store as S, TriageFn as T, AlertChannel as a, JobDefinition as b, JobSummary as c, JobState as d, Condition as e, StoredJobDefinition as f, AlertType as g, JobHealth as h, RunStatus as i, StoredJob as j, TriageContext as k };
+export type { Alert as A, BudgetBreach as B, CheckResult as C, Duration as D, ExpectRule as E, JobOptions as J, Run as R, Store as S, TriageFn as T, AlertChannel as a, JobDefinition as b, JobSummary as c, JobState as d, AlertDraft as e, StoredJobDefinition as f, AlertDetails as g, AlertType as h, Condition as i, JobHealth as j, RunStatus as k, StoredJob as l, TriageContext as m };