sermon-js 0.0.0-stage → 0.2.0

package/dist/stores/upstash.d.ts

@@ -0,0 +1,19 @@
+import { S as StatusStore } from '../store-_GuzSP0z.js';
+import '../types-CctvUAs2.js';
+
+type UpstashStoreOptions = {
+    /** REST URL of the database (`UPSTASH_REDIS_REST_URL` / Vercel KV's `KV_REST_API_URL`) */
+    url: string;
+    /** REST token (`UPSTASH_REDIS_REST_TOKEN` / `KV_REST_API_TOKEN`) */
+    token: string;
+    /** Prefix of every key (default "sermon"): lets several status pages share one database */
+    prefix?: string;
+    fetch?: typeof fetch;
+};
+/**
+ * Store on Upstash Redis or Vercel KV, over their REST API. It only needs `fetch`, so it works
+ * on serverless and edge runtimes, with no client library to install.
+ */
+declare function upstashStore({ url, token, prefix, fetch: fetchImpl }: UpstashStoreOptions): StatusStore;
+
+export { type UpstashStoreOptions, upstashStore };

package/dist/stores/upstash.js

@@ -0,0 +1,25 @@
+import { createRedisStore } from '../chunk-AH372HLN.js';
+
+// src/stores/upstash.ts
+function upstashStore({ url, token, prefix, fetch: fetchImpl = fetch }) {
+  if (!url || !token) throw new Error("sermon-js: upstashStore needs a url and a token");
+  const endpoint = `${url.replace(/\/+$/, "")}/pipeline`;
+  const exec = async (commands) => {
+    const response = await fetchImpl(endpoint, {
+      method: "POST",
+      headers: { authorization: `Bearer ${token}`, "content-type": "application/json" },
+      body: JSON.stringify(commands.map((command) => command.map(String)))
+    });
+    if (!response.ok) throw new Error(`sermon-js: Upstash request failed (HTTP ${response.status})`);
+    const replies = await response.json();
+    return replies.map((reply) => {
+      if (reply.error) throw new Error(`sermon-js: Upstash command failed: ${reply.error}`);
+      return reply.result;
+    });
+  };
+  return createRedisStore({ exec, prefix });
+}
+
+export { upstashStore };
+//# sourceMappingURL=upstash.js.map
+//# sourceMappingURL=upstash.js.map

package/dist/stores/upstash.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/stores/upstash.ts"],"names":[],"mappings":";;;AAiBO,SAAS,YAAA,CAAa,EAAE,GAAA,EAAK,KAAA,EAAO,QAAQ,KAAA,EAAO,SAAA,GAAY,OAAM,EAAqC;AAC/G,EAAA,IAAI,CAAC,GAAA,IAAO,CAAC,OAAO,MAAM,IAAI,MAAM,iDAAiD,CAAA;AACrF,EAAA,MAAM,WAAW,CAAA,EAAG,GAAA,CAAI,OAAA,CAAQ,MAAA,EAAQ,EAAE,CAAC,CAAA,SAAA,CAAA;AAE3C,EAAA,MAAM,IAAA,GAAkB,OAAO,QAAA,KAAa;AAC1C,IAAA,MAAM,QAAA,GAAW,MAAM,SAAA,CAAU,QAAA,EAAU;AAAA,MACzC,MAAA,EAAQ,MAAA;AAAA,MACR,SAAS,EAAE,aAAA,EAAe,UAAU,KAAK,CAAA,CAAA,EAAI,gBAAgB,kBAAA,EAAmB;AAAA,MAChF,IAAA,EAAM,IAAA,CAAK,SAAA,CAAU,QAAA,CAAS,GAAA,CAAI,CAAC,OAAA,KAAY,OAAA,CAAQ,GAAA,CAAI,MAAM,CAAC,CAAC;AAAA,KACpE,CAAA;AACD,IAAA,IAAI,CAAC,SAAS,EAAA,EAAI,MAAM,IAAI,KAAA,CAAM,CAAA,wCAAA,EAA2C,QAAA,CAAS,MAAM,CAAA,CAAA,CAAG,CAAA;AAC/F,IAAA,MAAM,OAAA,GAAW,MAAM,QAAA,CAAS,IAAA,EAAK;AACrC,IAAA,OAAO,OAAA,CAAQ,GAAA,CAAI,CAAC,KAAA,KAAU;AAC5B,MAAA,IAAI,KAAA,CAAM,OAAO,MAAM,IAAI,MAAM,CAAA,mCAAA,EAAsC,KAAA,CAAM,KAAK,CAAA,CAAE,CAAA;AACpF,MAAA,OAAO,KAAA,CAAM,MAAA;AAAA,IACf,CAAC,CAAA;AAAA,EACH,CAAA;AAEA,EAAA,OAAO,gBAAA,CAAiB,EAAE,IAAA,EAAM,MAAA,EAAQ,CAAA;AAC1C","file":"upstash.js","sourcesContent":["import type { StatusStore } from \"../store\";\nimport { createRedisStore, type RedisExec } from \"./redis-core\";\n\nexport type UpstashStoreOptions = {\n  /** REST URL of the database (`UPSTASH_REDIS_REST_URL` / Vercel KV's `KV_REST_API_URL`) */\n  url: string;\n  /** REST token (`UPSTASH_REDIS_REST_TOKEN` / `KV_REST_API_TOKEN`) */\n  token: string;\n  /** Prefix of every key (default \"sermon\"): lets several status pages share one database */\n  prefix?: string;\n  fetch?: typeof fetch;\n};\n\n/**\n * Store on Upstash Redis or Vercel KV, over their REST API. It only needs `fetch`, so it works\n * on serverless and edge runtimes, with no client library to install.\n */\nexport function upstashStore({ url, token, prefix, fetch: fetchImpl = fetch }: UpstashStoreOptions): StatusStore {\n  if (!url || !token) throw new Error(\"sermon-js: upstashStore needs a url and a token\");\n  const endpoint = `${url.replace(/\\/+$/, \"\")}/pipeline`;\n\n  const exec: RedisExec = async (commands) => {\n    const response = await fetchImpl(endpoint, {\n      method: \"POST\",\n      headers: { authorization: `Bearer ${token}`, \"content-type\": \"application/json\" },\n      body: JSON.stringify(commands.map((command) => command.map(String))),\n    });\n    if (!response.ok) throw new Error(`sermon-js: Upstash request failed (HTTP ${response.status})`);\n    const replies = (await response.json()) as Array<{ result?: unknown; error?: string }>;\n    return replies.map((reply) => {\n      if (reply.error) throw new Error(`sermon-js: Upstash command failed: ${reply.error}`);\n      return reply.result;\n    });\n  };\n\n  return createRedisStore({ exec, prefix });\n}\n"]}

package/dist/testing/index.cjs

@@ -0,0 +1,209 @@
+'use strict';
+
+var chunkPARE6EUZ_cjs = require('../chunk-PARE6EUZ.cjs');
+var chunkXHXEKB3Q_cjs = require('../chunk-XHXEKB3Q.cjs');
+
+// src/testing/index.ts
+var summary = (overrides = {}) => ({
+  at: 1e3,
+  trigger: "scheduled",
+  full: true,
+  score: 100,
+  label: "operational",
+  failing: {},
+  ...overrides
+});
+var result = (overrides = {}) => ({
+  key: "api",
+  status: "up",
+  checkedAt: 1e3,
+  probed: true,
+  latencyMs: 120,
+  ...overrides
+});
+var sample = (overrides = {}) => ({
+  key: "api",
+  at: 1e3,
+  status: "up",
+  latencyMs: 120,
+  ...overrides
+});
+var clean = (value) => JSON.parse(JSON.stringify(value));
+function resolveHarness(harness) {
+  if (harness) return harness;
+  const globals = globalThis;
+  if (globals.describe && globals.it && globals.expect) {
+    return { describe: globals.describe, it: globals.it, expect: globals.expect };
+  }
+  throw new Error(
+    "sermon-js/testing: pass your test runner's { describe, it, expect } as the third argument (or enable the runner's globals)."
+  );
+}
+function runStoreConformance(name, createStore, harness) {
+  const { describe, it, expect } = resolveHarness(harness);
+  describe(`${name}: StatusStore conformance`, () => {
+    it("starts empty", async () => {
+      const store = await createStore();
+      expect(await store.latest()).toEqual({});
+      expect(await store.runs({ since: 0, until: 1e4 })).toEqual([]);
+      expect(await store.samples("api", { since: 0, until: 1e4 })).toEqual([]);
+    });
+    it("keeps the latest result of each service, with all its fields", async () => {
+      const store = await createStore();
+      const rich = result({
+        key: "fly",
+        status: "degraded",
+        httpStatus: 200,
+        error: "1/2 machine(s) down: sin",
+        metrics: { machines: "1/2 running", count: 2 },
+        usage: [{ label: "Requests", used: 15, limit: 100, unit: "requests", resetsAt: 9999 }],
+        instances: [
+          { key: "ams", region: "ams", id: "m1", state: "started", status: "up", latencyMs: 80, httpStatus: 200 },
+          { key: "sin", region: "sin", id: "m2", state: "stopped", status: "down", error: "Out of memory" }
+        ]
+      });
+      await store.saveRun({
+        summary: summary(),
+        results: [result(), rich, result({ key: "off", status: "unconfigured", probed: false, latencyMs: void 0 })],
+        samples: [sample(), sample({ key: "fly", status: "degraded" })]
+      });
+      await store.saveRun({
+        summary: summary({ at: 2e3, full: false }),
+        results: [result({ checkedAt: 2e3, status: "down", error: "HTTP 500", latencyMs: 300 })],
+        samples: [sample({ at: 2e3, status: "down", error: "HTTP 500", latencyMs: 300 })]
+      });
+      const latest = await store.latest();
+      expect(Object.keys(latest).sort()).toEqual(["api", "fly", "off"]);
+      expect(clean(latest.api)).toEqual(clean(result({ checkedAt: 2e3, status: "down", error: "HTTP 500", latencyMs: 300 })));
+      expect(clean(latest.fly)).toEqual(clean(rich));
+      expect(latest.off?.status).toBe("unconfigured");
+    });
+    it("returns runs within an inclusive range, oldest first", async () => {
+      const store = await createStore();
+      for (const at of [3e3, 1e3, 2e3]) {
+        await store.saveRun({
+          summary: summary({ at, score: at / 100, failing: at === 2e3 ? { api: "down" } : {} }),
+          results: [],
+          samples: []
+        });
+      }
+      const runs = await store.runs({ since: 1e3, until: 2e3 });
+      expect(runs.map((run) => run.at)).toEqual([1e3, 2e3]);
+      expect(clean(runs[1])).toEqual(
+        clean(summary({ at: 2e3, score: 20, failing: { api: "down" } }))
+      );
+      expect((await store.runs({ since: 0, until: 9e3 })).map((run) => run.at)).toEqual([1e3, 2e3, 3e3]);
+    });
+    it("returns samples of one service within an inclusive range, oldest first", async () => {
+      const store = await createStore();
+      await store.saveRun({
+        summary: summary({ at: 2e3 }),
+        results: [],
+        samples: [
+          sample({ at: 2e3, instances: { ams: ["up", 80], sin: ["sleeping"] } }),
+          sample({ key: "other", at: 2e3 })
+        ]
+      });
+      await store.saveRun({ summary: summary({ at: 1e3 }), results: [], samples: [sample({ at: 1e3 })] });
+      await store.saveRun({ summary: summary({ at: 3e3 }), results: [], samples: [sample({ at: 3e3 })] });
+      const samples = await store.samples("api", { since: 1e3, until: 2e3 });
+      expect(samples.map((s) => s.at)).toEqual([1e3, 2e3]);
+      expect(samples.every((s) => s.key === "api")).toBe(true);
+      expect(clean(samples[1]?.instances)).toEqual({ ams: ["up", 80], sin: ["sleeping"] });
+    });
+    it("prunes old runs and samples", async () => {
+      const store = await createStore();
+      for (const at of [1e3, 2e3, 3e3]) {
+        await store.saveRun({ summary: summary({ at }), results: [result({ checkedAt: at })], samples: [sample({ at })] });
+      }
+      await store.prune({ before: 2e3 });
+      expect((await store.runs({ since: 0, until: 9e3 })).map((run) => run.at)).toEqual([2e3, 3e3]);
+      expect((await store.samples("api", { since: 0, until: 9e3 })).map((s) => s.at)).toEqual([2e3, 3e3]);
+      expect(Object.keys(await store.latest())).toEqual(["api"]);
+    });
+    it("drops services that are not in keepKeys", async () => {
+      const store = await createStore();
+      await store.saveRun({
+        summary: summary(),
+        results: [result(), result({ key: "removed" })],
+        samples: [sample(), sample({ key: "removed" })]
+      });
+      await store.prune({ before: 0, keepKeys: ["api"] });
+      expect(Object.keys(await store.latest())).toEqual(["api"]);
+      expect(await store.samples("removed", { since: 0, until: 9e3 })).toEqual([]);
+      expect(await store.samples("api", { since: 0, until: 9e3 })).toHaveLength(1);
+      expect(await store.runs({ since: 0, until: 9e3 })).toHaveLength(1);
+    });
+    it("locks by name until the time-to-live passes (when supported)", async () => {
+      const store = await createStore();
+      if (!store.lock) return;
+      expect(await store.lock("run-all", 6e4)).toEqual({ ok: true });
+      const second = await store.lock("run-all", 6e4);
+      expect(second.ok).toBe(false);
+      if (!second.ok) {
+        expect(second.retryAfterMs).toBeGreaterThan(0);
+        expect(second.retryAfterMs).toBeLessThanOrEqual(6e4);
+      }
+      expect(await store.lock("another", 6e4)).toEqual({ ok: true });
+      expect(await store.lock("short", 20)).toEqual({ ok: true });
+      await new Promise((resolve) => setTimeout(resolve, 60));
+      expect(await store.lock("short", 20)).toEqual({ ok: true });
+      if (store.unlock) {
+        await store.unlock("run-all");
+        expect(await store.lock("run-all", 6e4)).toEqual({ ok: true });
+        await store.unlock("never-taken");
+      }
+    });
+    it("caches small values with a time-to-live (when supported)", async () => {
+      const store = await createStore();
+      if (!store.cache) return;
+      expect(await store.cache.get("missing")).toBeNull();
+      await store.cache.set("stats", '{"a":1}', 6e4);
+      expect(await store.cache.get("stats")).toBe('{"a":1}');
+      await store.cache.set("stats", '{"a":2}', 6e4);
+      expect(await store.cache.get("stats")).toBe('{"a":2}');
+      await store.cache.set("brief", "x", 20);
+      await new Promise((resolve) => setTimeout(resolve, 60));
+      expect(await store.cache.get("brief")).toBeNull();
+    });
+  });
+}
+function mockFetch(routes) {
+  const calls = [];
+  const impl = async (input, init) => {
+    const url = typeof input === "string" ? input : input instanceof URL ? input.href : input.url;
+    const method = (init?.method ?? "GET").toUpperCase();
+    const headers = Object.fromEntries(new Headers(init?.headers).entries());
+    calls.push({ url, method, headers, body: typeof init?.body === "string" ? init.body : void 0 });
+    const route = routes.find(
+      (candidate) => (typeof candidate.url === "string" ? url.includes(candidate.url) : candidate.url.test(url)) && (!candidate.method || candidate.method.toUpperCase() === method)
+    );
+    if (!route) throw new TypeError(`mockFetch: no route for ${method} ${url}`);
+    if (route.delayMs) await new Promise((resolve) => setTimeout(resolve, route.delayMs));
+    if (route.error) throw route.error;
+    const body = route.body === void 0 ? "" : typeof route.body === "string" ? route.body : JSON.stringify(route.body);
+    return new Response(body || null, { status: route.status ?? 200, headers: route.headers });
+  };
+  return Object.assign(impl, { calls });
+}
+async function runCheck(service, options = {}) {
+  const [resolved] = [...chunkXHXEKB3Q_cjs.resolveTree([service]).services.values()];
+  const cache = options.cache ?? /* @__PURE__ */ new Map();
+  return chunkPARE6EUZ_cjs.runService({
+    service: resolved,
+    secretValues: chunkPARE6EUZ_cjs.collectSecretValues([...Object.values(service.secrets), ...service.sensitive ?? []]),
+    fetch: options.fetch,
+    now: options.now,
+    hideResponseBodies: options.hideResponseBodies,
+    cache: {
+      get: async (key) => cache.get(key) ?? null,
+      set: async (key, value) => void cache.set(key, value)
+    }
+  });
+}
+
+exports.mockFetch = mockFetch;
+exports.runCheck = runCheck;
+exports.runStoreConformance = runStoreConformance;
+//# sourceMappingURL=index.cjs.map
+//# sourceMappingURL=index.cjs.map

package/dist/testing/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/testing/index.ts"],"names":["resolveTree","runService","collectSecretValues"],"mappings":"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","file":"index.cjs","sourcesContent":["import { resolveTree, type ServiceDefinition } from \"../config\";\nimport { runService } from \"../runner\";\nimport { collectSecretValues } from \"../sanitize\";\nimport type { CheckSample, RunSummary, StatusStore } from \"../store\";\nimport type { CheckResult } from \"../types\";\n\nconst summary = (overrides: Partial<RunSummary> = {}): RunSummary => ({\n  at: 1_000,\n  trigger: \"scheduled\",\n  full: true,\n  score: 100,\n  label: \"operational\",\n  failing: {},\n  ...overrides,\n});\n\nconst result = (overrides: Partial<CheckResult> = {}): CheckResult => ({\n  key: \"api\",\n  status: \"up\",\n  checkedAt: 1_000,\n  probed: true,\n  latencyMs: 120,\n  ...overrides,\n});\n\nconst sample = (overrides: Partial<CheckSample> = {}): CheckSample => ({\n  key: \"api\",\n  at: 1_000,\n  status: \"up\",\n  latencyMs: 120,\n  ...overrides,\n});\n\n/** Stores may drop `undefined` fields or not: compare what matters */\nconst clean = <T>(value: T): T => JSON.parse(JSON.stringify(value)) as T;\n\n/** The few test-runner functions the suite needs. Vitest and Jest both fit. */\nexport type TestHarness = {\n  describe: (name: string, fn: () => void) => void;\n  it: (name: string, fn: () => Promise<void> | void) => void;\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  expect: (actual: any) => any;\n};\n\nfunction resolveHarness(harness?: TestHarness): TestHarness {\n  if (harness) return harness;\n  const globals = globalThis as Partial<TestHarness>;\n  if (globals.describe && globals.it && globals.expect) {\n    return { describe: globals.describe, it: globals.it, expect: globals.expect };\n  }\n  throw new Error(\n    \"sermon-js/testing: pass your test runner's { describe, it, expect } as the third argument \" +\n      \"(or enable the runner's globals).\"\n  );\n}\n\n/**\n * The contract every `StatusStore` must honour. Call it from a test file of your adapter:\n *\n * ```ts\n * import { describe, expect, it } from \"vitest\";            // or Jest's globals\n * import { runStoreConformance } from \"sermon-js/testing\";\n * runStoreConformance(\"my store\", () => myStore({ … }), { describe, it, expect });\n * ```\n *\n * `createStore` must return a fresh, empty store each time.\n */\nexport function runStoreConformance(\n  name: string,\n  createStore: () => StatusStore | Promise<StatusStore>,\n  harness?: TestHarness\n) {\n  const { describe, it, expect } = resolveHarness(harness);\n  describe(`${name}: StatusStore conformance`, () => {\n    it(\"starts empty\", async () => {\n      const store = await createStore();\n      expect(await store.latest()).toEqual({});\n      expect(await store.runs({ since: 0, until: 10_000 })).toEqual([]);\n      expect(await store.samples(\"api\", { since: 0, until: 10_000 })).toEqual([]);\n    });\n\n    it(\"keeps the latest result of each service, with all its fields\", async () => {\n      const store = await createStore();\n      const rich = result({\n        key: \"fly\",\n        status: \"degraded\",\n        httpStatus: 200,\n        error: \"1/2 machine(s) down: sin\",\n        metrics: { machines: \"1/2 running\", count: 2 },\n        usage: [{ label: \"Requests\", used: 15, limit: 100, unit: \"requests\", resetsAt: 9_999 }],\n        instances: [\n          { key: \"ams\", region: \"ams\", id: \"m1\", state: \"started\", status: \"up\", latencyMs: 80, httpStatus: 200 },\n          { key: \"sin\", region: \"sin\", id: \"m2\", state: \"stopped\", status: \"down\", error: \"Out of memory\" },\n        ],\n      });\n      await store.saveRun({\n        summary: summary(),\n        results: [result(), rich, result({ key: \"off\", status: \"unconfigured\", probed: false, latencyMs: undefined })],\n        samples: [sample(), sample({ key: \"fly\", status: \"degraded\" })],\n      });\n      await store.saveRun({\n        summary: summary({ at: 2_000, full: false }),\n        results: [result({ checkedAt: 2_000, status: \"down\", error: \"HTTP 500\", latencyMs: 300 })],\n        samples: [sample({ at: 2_000, status: \"down\", error: \"HTTP 500\", latencyMs: 300 })],\n      });\n\n      const latest = await store.latest();\n      expect(Object.keys(latest).sort()).toEqual([\"api\", \"fly\", \"off\"]);\n      expect(clean(latest.api)).toEqual(clean(result({ checkedAt: 2_000, status: \"down\", error: \"HTTP 500\", latencyMs: 300 })));\n      expect(clean(latest.fly)).toEqual(clean(rich));\n      expect(latest.off?.status).toBe(\"unconfigured\");\n    });\n\n    it(\"returns runs within an inclusive range, oldest first\", async () => {\n      const store = await createStore();\n      for (const at of [3_000, 1_000, 2_000]) {\n        await store.saveRun({\n          summary: summary({ at, score: at / 100, failing: at === 2_000 ? { api: \"down\" } : {} }),\n          results: [],\n          samples: [],\n        });\n      }\n      const runs = await store.runs({ since: 1_000, until: 2_000 });\n      expect(runs.map((run) => run.at)).toEqual([1_000, 2_000]);\n      expect(clean(runs[1])).toEqual(\n        clean(summary({ at: 2_000, score: 20, failing: { api: \"down\" } }))\n      );\n      expect((await store.runs({ since: 0, until: 9_000 })).map((run) => run.at)).toEqual([1_000, 2_000, 3_000]);\n    });\n\n    it(\"returns samples of one service within an inclusive range, oldest first\", async () => {\n      const store = await createStore();\n      await store.saveRun({\n        summary: summary({ at: 2_000 }),\n        results: [],\n        samples: [\n          sample({ at: 2_000, instances: { ams: [\"up\", 80], sin: [\"sleeping\"] } }),\n          sample({ key: \"other\", at: 2_000 }),\n        ],\n      });\n      await store.saveRun({ summary: summary({ at: 1_000 }), results: [], samples: [sample({ at: 1_000 })] });\n      await store.saveRun({ summary: summary({ at: 3_000 }), results: [], samples: [sample({ at: 3_000 })] });\n\n      const samples = await store.samples(\"api\", { since: 1_000, until: 2_000 });\n      expect(samples.map((s) => s.at)).toEqual([1_000, 2_000]);\n      expect(samples.every((s) => s.key === \"api\")).toBe(true);\n      expect(clean(samples[1]?.instances)).toEqual({ ams: [\"up\", 80], sin: [\"sleeping\"] });\n    });\n\n    it(\"prunes old runs and samples\", async () => {\n      const store = await createStore();\n      for (const at of [1_000, 2_000, 3_000]) {\n        await store.saveRun({ summary: summary({ at }), results: [result({ checkedAt: at })], samples: [sample({ at })] });\n      }\n      await store.prune({ before: 2_000 });\n      expect((await store.runs({ since: 0, until: 9_000 })).map((run) => run.at)).toEqual([2_000, 3_000]);\n      expect((await store.samples(\"api\", { since: 0, until: 9_000 })).map((s) => s.at)).toEqual([2_000, 3_000]);\n      // Latest results are not history: pruning by time keeps them\n      expect(Object.keys(await store.latest())).toEqual([\"api\"]);\n    });\n\n    it(\"drops services that are not in keepKeys\", async () => {\n      const store = await createStore();\n      await store.saveRun({\n        summary: summary(),\n        results: [result(), result({ key: \"removed\" })],\n        samples: [sample(), sample({ key: \"removed\" })],\n      });\n      await store.prune({ before: 0, keepKeys: [\"api\"] });\n      expect(Object.keys(await store.latest())).toEqual([\"api\"]);\n      expect(await store.samples(\"removed\", { since: 0, until: 9_000 })).toEqual([]);\n      expect(await store.samples(\"api\", { since: 0, until: 9_000 })).toHaveLength(1);\n      expect(await store.runs({ since: 0, until: 9_000 })).toHaveLength(1);\n    });\n\n    it(\"locks by name until the time-to-live passes (when supported)\", async () => {\n      const store = await createStore();\n      if (!store.lock) return;\n      expect(await store.lock(\"run-all\", 60_000)).toEqual({ ok: true });\n      const second = await store.lock(\"run-all\", 60_000);\n      expect(second.ok).toBe(false);\n      if (!second.ok) {\n        expect(second.retryAfterMs).toBeGreaterThan(0);\n        expect(second.retryAfterMs).toBeLessThanOrEqual(60_000);\n      }\n      expect(await store.lock(\"another\", 60_000)).toEqual({ ok: true });\n\n      expect(await store.lock(\"short\", 20)).toEqual({ ok: true });\n      await new Promise((resolve) => setTimeout(resolve, 60));\n      expect(await store.lock(\"short\", 20)).toEqual({ ok: true });\n\n      if (store.unlock) {\n        await store.unlock(\"run-all\");\n        expect(await store.lock(\"run-all\", 60_000)).toEqual({ ok: true });\n        // Releasing a lock nobody holds is fine\n        await store.unlock(\"never-taken\");\n      }\n    });\n\n    it(\"caches small values with a time-to-live (when supported)\", async () => {\n      const store = await createStore();\n      if (!store.cache) return;\n      expect(await store.cache.get(\"missing\")).toBeNull();\n      await store.cache.set(\"stats\", '{\"a\":1}', 60_000);\n      expect(await store.cache.get(\"stats\")).toBe('{\"a\":1}');\n      await store.cache.set(\"stats\", '{\"a\":2}', 60_000);\n      expect(await store.cache.get(\"stats\")).toBe('{\"a\":2}');\n\n      await store.cache.set(\"brief\", \"x\", 20);\n      await new Promise((resolve) => setTimeout(resolve, 60));\n      expect(await store.cache.get(\"brief\")).toBeNull();\n    });\n  });\n}\n\nexport type MockRoute = {\n  /** Matches when the request URL contains this string, or matches this pattern */\n  url: string | RegExp;\n  method?: string;\n  status?: number;\n  /** JSON-serialized when it's an object */\n  body?: unknown;\n  headers?: Record<string, string>;\n  /** Reject the request like a network failure */\n  error?: Error;\n  /** Delay the response, to simulate latency */\n  delayMs?: number;\n};\n\nexport type MockFetch = typeof fetch & {\n  /** Every request made, in order */\n  calls: Array<{ url: string; method: string; headers: Record<string, string>; body?: string }>;\n};\n\n/**\n * A `fetch` that answers from a list of routes (first match wins) and records every call.\n * Unmatched requests fail, so tests prove that nothing unexpected is called.\n */\nexport function mockFetch(routes: MockRoute[]): MockFetch {\n  const calls: MockFetch[\"calls\"] = [];\n  const impl = async (input: RequestInfo | URL, init?: RequestInit): Promise<Response> => {\n    const url = typeof input === \"string\" ? input : input instanceof URL ? input.href : input.url;\n    const method = (init?.method ?? \"GET\").toUpperCase();\n    const headers = Object.fromEntries(new Headers(init?.headers).entries());\n    calls.push({ url, method, headers, body: typeof init?.body === \"string\" ? init.body : undefined });\n\n    const route = routes.find(\n      (candidate) =>\n        (typeof candidate.url === \"string\" ? url.includes(candidate.url) : candidate.url.test(url)) &&\n        (!candidate.method || candidate.method.toUpperCase() === method)\n    );\n    if (!route) throw new TypeError(`mockFetch: no route for ${method} ${url}`);\n    if (route.delayMs) await new Promise((resolve) => setTimeout(resolve, route.delayMs));\n    if (route.error) throw route.error;\n    const body =\n      route.body === undefined ? \"\" : typeof route.body === \"string\" ? route.body : JSON.stringify(route.body);\n    // Null-body statuses (204, 304…) reject a body, even an empty one\n    return new Response(body || null, { status: route.status ?? 200, headers: route.headers });\n  };\n  return Object.assign(impl as typeof fetch, { calls });\n}\n\n/**\n * Run one service exactly as the engine would (shared rules, redaction, timing) and return\n * its result. For testing presets and custom checks:\n *\n * ```ts\n * const fetch = mockFetch([{ url: \"/health\", status: 200 }]);\n * const result = await runCheck(myPreset({ … }), { fetch });\n * ```\n */\nexport async function runCheck(\n  service: ServiceDefinition,\n  options: { fetch?: typeof fetch; now?: () => number; cache?: Map<string, string>; hideResponseBodies?: boolean } = {}\n): Promise<CheckResult> {\n  const [resolved] = [...resolveTree([service]).services.values()];\n  const cache = options.cache ?? new Map<string, string>();\n  return runService({\n    service: resolved!,\n    secretValues: collectSecretValues([...Object.values(service.secrets), ...(service.sensitive ?? [])]),\n    fetch: options.fetch,\n    now: options.now,\n    hideResponseBodies: options.hideResponseBodies,\n    cache: {\n      get: async (key) => cache.get(key) ?? null,\n      set: async (key, value) => void cache.set(key, value),\n    },\n  });\n}\n"]}

package/dist/testing/index.d.cts

@@ -0,0 +1,66 @@
+import { S as ServiceDefinition } from '../config-BEbP-uLf.cjs';
+import { S as StatusStore } from '../store-DybhDphS.cjs';
+import { g as CheckResult } from '../types-CctvUAs2.cjs';
+
+/** The few test-runner functions the suite needs. Vitest and Jest both fit. */
+type TestHarness = {
+    describe: (name: string, fn: () => void) => void;
+    it: (name: string, fn: () => Promise<void> | void) => void;
+    expect: (actual: any) => any;
+};
+/**
+ * The contract every `StatusStore` must honour. Call it from a test file of your adapter:
+ *
+ * ```ts
+ * import { describe, expect, it } from "vitest";            // or Jest's globals
+ * import { runStoreConformance } from "sermon-js/testing";
+ * runStoreConformance("my store", () => myStore({ … }), { describe, it, expect });
+ * ```
+ *
+ * `createStore` must return a fresh, empty store each time.
+ */
+declare function runStoreConformance(name: string, createStore: () => StatusStore | Promise<StatusStore>, harness?: TestHarness): void;
+type MockRoute = {
+    /** Matches when the request URL contains this string, or matches this pattern */
+    url: string | RegExp;
+    method?: string;
+    status?: number;
+    /** JSON-serialized when it's an object */
+    body?: unknown;
+    headers?: Record<string, string>;
+    /** Reject the request like a network failure */
+    error?: Error;
+    /** Delay the response, to simulate latency */
+    delayMs?: number;
+};
+type MockFetch = typeof fetch & {
+    /** Every request made, in order */
+    calls: Array<{
+        url: string;
+        method: string;
+        headers: Record<string, string>;
+        body?: string;
+    }>;
+};
+/**
+ * A `fetch` that answers from a list of routes (first match wins) and records every call.
+ * Unmatched requests fail, so tests prove that nothing unexpected is called.
+ */
+declare function mockFetch(routes: MockRoute[]): MockFetch;
+/**
+ * Run one service exactly as the engine would (shared rules, redaction, timing) and return
+ * its result. For testing presets and custom checks:
+ *
+ * ```ts
+ * const fetch = mockFetch([{ url: "/health", status: 200 }]);
+ * const result = await runCheck(myPreset({ … }), { fetch });
+ * ```
+ */
+declare function runCheck(service: ServiceDefinition, options?: {
+    fetch?: typeof fetch;
+    now?: () => number;
+    cache?: Map<string, string>;
+    hideResponseBodies?: boolean;
+}): Promise<CheckResult>;
+
+export { type MockFetch, type MockRoute, type TestHarness, mockFetch, runCheck, runStoreConformance };

package/dist/testing/index.d.ts

@@ -0,0 +1,66 @@
+import { S as ServiceDefinition } from '../config-w1tm1bdu.js';
+import { S as StatusStore } from '../store-_GuzSP0z.js';
+import { g as CheckResult } from '../types-CctvUAs2.js';
+
+/** The few test-runner functions the suite needs. Vitest and Jest both fit. */
+type TestHarness = {
+    describe: (name: string, fn: () => void) => void;
+    it: (name: string, fn: () => Promise<void> | void) => void;
+    expect: (actual: any) => any;
+};
+/**
+ * The contract every `StatusStore` must honour. Call it from a test file of your adapter:
+ *
+ * ```ts
+ * import { describe, expect, it } from "vitest";            // or Jest's globals
+ * import { runStoreConformance } from "sermon-js/testing";
+ * runStoreConformance("my store", () => myStore({ … }), { describe, it, expect });
+ * ```
+ *
+ * `createStore` must return a fresh, empty store each time.
+ */
+declare function runStoreConformance(name: string, createStore: () => StatusStore | Promise<StatusStore>, harness?: TestHarness): void;
+type MockRoute = {
+    /** Matches when the request URL contains this string, or matches this pattern */
+    url: string | RegExp;
+    method?: string;
+    status?: number;
+    /** JSON-serialized when it's an object */
+    body?: unknown;
+    headers?: Record<string, string>;
+    /** Reject the request like a network failure */
+    error?: Error;
+    /** Delay the response, to simulate latency */
+    delayMs?: number;
+};
+type MockFetch = typeof fetch & {
+    /** Every request made, in order */
+    calls: Array<{
+        url: string;
+        method: string;
+        headers: Record<string, string>;
+        body?: string;
+    }>;
+};
+/**
+ * A `fetch` that answers from a list of routes (first match wins) and records every call.
+ * Unmatched requests fail, so tests prove that nothing unexpected is called.
+ */
+declare function mockFetch(routes: MockRoute[]): MockFetch;
+/**
+ * Run one service exactly as the engine would (shared rules, redaction, timing) and return
+ * its result. For testing presets and custom checks:
+ *
+ * ```ts
+ * const fetch = mockFetch([{ url: "/health", status: 200 }]);
+ * const result = await runCheck(myPreset({ … }), { fetch });
+ * ```
+ */
+declare function runCheck(service: ServiceDefinition, options?: {
+    fetch?: typeof fetch;
+    now?: () => number;
+    cache?: Map<string, string>;
+    hideResponseBodies?: boolean;
+}): Promise<CheckResult>;
+
+export { type MockFetch, type MockRoute, type TestHarness, mockFetch, runCheck, runStoreConformance };

package/dist/testing/index.js

@@ -0,0 +1,205 @@
+import { runService, collectSecretValues } from '../chunk-2M4UBCDM.js';
+import { resolveTree } from '../chunk-XPXIDJUU.js';
+
+// src/testing/index.ts
+var summary = (overrides = {}) => ({
+  at: 1e3,
+  trigger: "scheduled",
+  full: true,
+  score: 100,
+  label: "operational",
+  failing: {},
+  ...overrides
+});
+var result = (overrides = {}) => ({
+  key: "api",
+  status: "up",
+  checkedAt: 1e3,
+  probed: true,
+  latencyMs: 120,
+  ...overrides
+});
+var sample = (overrides = {}) => ({
+  key: "api",
+  at: 1e3,
+  status: "up",
+  latencyMs: 120,
+  ...overrides
+});
+var clean = (value) => JSON.parse(JSON.stringify(value));
+function resolveHarness(harness) {
+  if (harness) return harness;
+  const globals = globalThis;
+  if (globals.describe && globals.it && globals.expect) {
+    return { describe: globals.describe, it: globals.it, expect: globals.expect };
+  }
+  throw new Error(
+    "sermon-js/testing: pass your test runner's { describe, it, expect } as the third argument (or enable the runner's globals)."
+  );
+}
+function runStoreConformance(name, createStore, harness) {
+  const { describe, it, expect } = resolveHarness(harness);
+  describe(`${name}: StatusStore conformance`, () => {
+    it("starts empty", async () => {
+      const store = await createStore();
+      expect(await store.latest()).toEqual({});
+      expect(await store.runs({ since: 0, until: 1e4 })).toEqual([]);
+      expect(await store.samples("api", { since: 0, until: 1e4 })).toEqual([]);
+    });
+    it("keeps the latest result of each service, with all its fields", async () => {
+      const store = await createStore();
+      const rich = result({
+        key: "fly",
+        status: "degraded",
+        httpStatus: 200,
+        error: "1/2 machine(s) down: sin",
+        metrics: { machines: "1/2 running", count: 2 },
+        usage: [{ label: "Requests", used: 15, limit: 100, unit: "requests", resetsAt: 9999 }],
+        instances: [
+          { key: "ams", region: "ams", id: "m1", state: "started", status: "up", latencyMs: 80, httpStatus: 200 },
+          { key: "sin", region: "sin", id: "m2", state: "stopped", status: "down", error: "Out of memory" }
+        ]
+      });
+      await store.saveRun({
+        summary: summary(),
+        results: [result(), rich, result({ key: "off", status: "unconfigured", probed: false, latencyMs: void 0 })],
+        samples: [sample(), sample({ key: "fly", status: "degraded" })]
+      });
+      await store.saveRun({
+        summary: summary({ at: 2e3, full: false }),
+        results: [result({ checkedAt: 2e3, status: "down", error: "HTTP 500", latencyMs: 300 })],
+        samples: [sample({ at: 2e3, status: "down", error: "HTTP 500", latencyMs: 300 })]
+      });
+      const latest = await store.latest();
+      expect(Object.keys(latest).sort()).toEqual(["api", "fly", "off"]);
+      expect(clean(latest.api)).toEqual(clean(result({ checkedAt: 2e3, status: "down", error: "HTTP 500", latencyMs: 300 })));
+      expect(clean(latest.fly)).toEqual(clean(rich));
+      expect(latest.off?.status).toBe("unconfigured");
+    });
+    it("returns runs within an inclusive range, oldest first", async () => {
+      const store = await createStore();
+      for (const at of [3e3, 1e3, 2e3]) {
+        await store.saveRun({
+          summary: summary({ at, score: at / 100, failing: at === 2e3 ? { api: "down" } : {} }),
+          results: [],
+          samples: []
+        });
+      }
+      const runs = await store.runs({ since: 1e3, until: 2e3 });
+      expect(runs.map((run) => run.at)).toEqual([1e3, 2e3]);
+      expect(clean(runs[1])).toEqual(
+        clean(summary({ at: 2e3, score: 20, failing: { api: "down" } }))
+      );
+      expect((await store.runs({ since: 0, until: 9e3 })).map((run) => run.at)).toEqual([1e3, 2e3, 3e3]);
+    });
+    it("returns samples of one service within an inclusive range, oldest first", async () => {
+      const store = await createStore();
+      await store.saveRun({
+        summary: summary({ at: 2e3 }),
+        results: [],
+        samples: [
+          sample({ at: 2e3, instances: { ams: ["up", 80], sin: ["sleeping"] } }),
+          sample({ key: "other", at: 2e3 })
+        ]
+      });
+      await store.saveRun({ summary: summary({ at: 1e3 }), results: [], samples: [sample({ at: 1e3 })] });
+      await store.saveRun({ summary: summary({ at: 3e3 }), results: [], samples: [sample({ at: 3e3 })] });
+      const samples = await store.samples("api", { since: 1e3, until: 2e3 });
+      expect(samples.map((s) => s.at)).toEqual([1e3, 2e3]);
+      expect(samples.every((s) => s.key === "api")).toBe(true);
+      expect(clean(samples[1]?.instances)).toEqual({ ams: ["up", 80], sin: ["sleeping"] });
+    });
+    it("prunes old runs and samples", async () => {
+      const store = await createStore();
+      for (const at of [1e3, 2e3, 3e3]) {
+        await store.saveRun({ summary: summary({ at }), results: [result({ checkedAt: at })], samples: [sample({ at })] });
+      }
+      await store.prune({ before: 2e3 });
+      expect((await store.runs({ since: 0, until: 9e3 })).map((run) => run.at)).toEqual([2e3, 3e3]);
+      expect((await store.samples("api", { since: 0, until: 9e3 })).map((s) => s.at)).toEqual([2e3, 3e3]);
+      expect(Object.keys(await store.latest())).toEqual(["api"]);
+    });
+    it("drops services that are not in keepKeys", async () => {
+      const store = await createStore();
+      await store.saveRun({
+        summary: summary(),
+        results: [result(), result({ key: "removed" })],
+        samples: [sample(), sample({ key: "removed" })]
+      });
+      await store.prune({ before: 0, keepKeys: ["api"] });
+      expect(Object.keys(await store.latest())).toEqual(["api"]);
+      expect(await store.samples("removed", { since: 0, until: 9e3 })).toEqual([]);
+      expect(await store.samples("api", { since: 0, until: 9e3 })).toHaveLength(1);
+      expect(await store.runs({ since: 0, until: 9e3 })).toHaveLength(1);
+    });
+    it("locks by name until the time-to-live passes (when supported)", async () => {
+      const store = await createStore();
+      if (!store.lock) return;
+      expect(await store.lock("run-all", 6e4)).toEqual({ ok: true });
+      const second = await store.lock("run-all", 6e4);
+      expect(second.ok).toBe(false);
+      if (!second.ok) {
+        expect(second.retryAfterMs).toBeGreaterThan(0);
+        expect(second.retryAfterMs).toBeLessThanOrEqual(6e4);
+      }
+      expect(await store.lock("another", 6e4)).toEqual({ ok: true });
+      expect(await store.lock("short", 20)).toEqual({ ok: true });
+      await new Promise((resolve) => setTimeout(resolve, 60));
+      expect(await store.lock("short", 20)).toEqual({ ok: true });
+      if (store.unlock) {
+        await store.unlock("run-all");
+        expect(await store.lock("run-all", 6e4)).toEqual({ ok: true });
+        await store.unlock("never-taken");
+      }
+    });
+    it("caches small values with a time-to-live (when supported)", async () => {
+      const store = await createStore();
+      if (!store.cache) return;
+      expect(await store.cache.get("missing")).toBeNull();
+      await store.cache.set("stats", '{"a":1}', 6e4);
+      expect(await store.cache.get("stats")).toBe('{"a":1}');
+      await store.cache.set("stats", '{"a":2}', 6e4);
+      expect(await store.cache.get("stats")).toBe('{"a":2}');
+      await store.cache.set("brief", "x", 20);
+      await new Promise((resolve) => setTimeout(resolve, 60));
+      expect(await store.cache.get("brief")).toBeNull();
+    });
+  });
+}
+function mockFetch(routes) {
+  const calls = [];
+  const impl = async (input, init) => {
+    const url = typeof input === "string" ? input : input instanceof URL ? input.href : input.url;
+    const method = (init?.method ?? "GET").toUpperCase();
+    const headers = Object.fromEntries(new Headers(init?.headers).entries());
+    calls.push({ url, method, headers, body: typeof init?.body === "string" ? init.body : void 0 });
+    const route = routes.find(
+      (candidate) => (typeof candidate.url === "string" ? url.includes(candidate.url) : candidate.url.test(url)) && (!candidate.method || candidate.method.toUpperCase() === method)
+    );
+    if (!route) throw new TypeError(`mockFetch: no route for ${method} ${url}`);
+    if (route.delayMs) await new Promise((resolve) => setTimeout(resolve, route.delayMs));
+    if (route.error) throw route.error;
+    const body = route.body === void 0 ? "" : typeof route.body === "string" ? route.body : JSON.stringify(route.body);
+    return new Response(body || null, { status: route.status ?? 200, headers: route.headers });
+  };
+  return Object.assign(impl, { calls });
+}
+async function runCheck(service, options = {}) {
+  const [resolved] = [...resolveTree([service]).services.values()];
+  const cache = options.cache ?? /* @__PURE__ */ new Map();
+  return runService({
+    service: resolved,
+    secretValues: collectSecretValues([...Object.values(service.secrets), ...service.sensitive ?? []]),
+    fetch: options.fetch,
+    now: options.now,
+    hideResponseBodies: options.hideResponseBodies,
+    cache: {
+      get: async (key) => cache.get(key) ?? null,
+      set: async (key, value) => void cache.set(key, value)
+    }
+  });
+}
+
+export { mockFetch, runCheck, runStoreConformance };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map