sermon-js 0.0.0-stage → 0.2.0

package/dist/status-zd04ZQ98.d.ts

@@ -0,0 +1,146 @@
+import { d as ResolvedService, R as ResolvedNode, e as ServiceNode } from './config-w1tm1bdu.js';
+import { o as Status$1, k as ScoreLabel, T as Trigger, g as CheckResult, p as StatusSnapshot, H as HistoryRange, i as HistoryPayload } from './types-CctvUAs2.js';
+import { C as CheckSample, L as LockResult, S as StatusStore } from './store-_GuzSP0z.js';
+
+/** A number of milliseconds, or a string like "30s", "5m", "1h", "7d" */
+type Duration = number | `${number}${"ms" | "s" | "m" | "h" | "d"}`;
+declare function toMs(duration: Duration): number;
+
+type Scoring = {
+    /** How much more a critical service weighs than a normal one (default 3) */
+    criticalWeight: number;
+    /** Value of a degraded service between 0 and 1 (default 0.6) */
+    degradedValue: number;
+    thresholds: {
+        /** Score from which the system is "operational" (default 98) */
+        operational: number;
+        /** Score from which the system is "degraded" rather than "outage" (default 85) */
+        degraded: number;
+    };
+};
+declare const DEFAULT_SCORING: Scoring;
+type ScoringInput = {
+    criticalWeight?: number;
+    degradedValue?: number;
+    thresholds?: Partial<Scoring["thresholds"]>;
+};
+declare function labelForScore(score: number | null, scoring?: Scoring): ScoreLabel;
+/**
+ * Weighted share of healthy services, 0–100. Sleeping services are expected (scale to zero)
+ * and count as healthy; unconfigured ones are left out. Any critical service being down
+ * forces the "outage" label, whatever the number.
+ */
+declare function computeScore({ results, scoring, }: {
+    results: Array<{
+        status: Status$1;
+        critical: boolean;
+    }>;
+    scoring?: Scoring;
+}): {
+    score: number | null;
+    label: ScoreLabel;
+    counts: Record<Status$1, number>;
+};
+
+type StatusConfig = {
+    /** What to supervise: services built with presets or `custom()`, optionally nested in `group()`s */
+    services: ServiceNode[];
+    /** Where history is kept. Defaults to memory, which lasts as long as the process. */
+    store?: StatusStore;
+    /** How often a full run is due (default "5m"). Used by `tick()`, the scheduler and staleness. */
+    interval?: Duration;
+    /** How long history is kept (default "7d") */
+    retention?: Duration;
+    scoring?: ScoringInput;
+    /**
+     * Never quote what a service replied in public errors: a failed HTTP answer is reported by
+     * its status code only ("HTTP 500"). Turn it on when a checked service could answer with
+     * something sensitive, such as a debug page. Default false. Errors returned by `custom()`
+     * checks are yours and are kept (redacted) either way.
+     */
+    hideResponseBodies?: boolean;
+    /** Receives configuration warnings (default: `console.warn`) */
+    onWarning?: (message: string) => void;
+    /** Override `fetch` (tests, custom agents) */
+    fetch?: typeof fetch;
+    /** Override the clock (tests) */
+    now?: () => number;
+};
+type RunReport = {
+    at: number;
+    trigger: Trigger;
+    /** True when every service was checked */
+    full: boolean;
+    score: number | null;
+    label: ScoreLabel;
+    results: CheckResult[];
+};
+type ServiceHistory = {
+    schemaVersion: 1;
+    key: string;
+    range: HistoryRange;
+    samples: CheckSample[];
+};
+type TickResult = {
+    ran: true;
+    report: RunReport;
+} | {
+    ran: false;
+    /** "not-due": the last full run is recent enough. "locked": another tick is running. */
+    reason: "not-due" | "locked";
+    /** When the next full run is due (ms epoch) */
+    nextDueAt: number;
+};
+type Status = {
+    /** Check every service (or only `keys`) now, and record the results */
+    run(options?: {
+        keys?: string[];
+        trigger?: Trigger;
+    }): Promise<RunReport>;
+    /**
+     * Run every service only if a full run is due (the last one is older than `interval`), and
+     * never twice at once. Safe to call as often as you like, from any number of triggers:
+     * a cron, a platform scheduler, a timer, a page view.
+     */
+    tick(options?: {
+        force?: boolean;
+    }): Promise<TickResult>;
+    /** Everything a status page needs: the tree with latest results, statistics and the score */
+    snapshot(): Promise<StatusSnapshot>;
+    /** Score history in fixed buckets */
+    history(options?: {
+        range?: HistoryRange;
+    }): Promise<HistoryPayload>;
+    /** Raw samples of one service */
+    serviceHistory(key: string, options?: {
+        range?: HistoryRange;
+    }): Promise<ServiceHistory>;
+    /**
+     * Remove every configured secret (and anything shaped like a credential) from a text.
+     * Use it before logging errors that come from checks, stores or drivers.
+     */
+    redact(text: string): string;
+    /** Whether a service with this key exists */
+    has(key: string): boolean;
+    /** Take a named lock for `ttlMs` (the store's when it has one, otherwise in-process) */
+    lock(name: string, ttlMs: number): Promise<LockResult>;
+    /** When the last full run happened, if any within the retention window */
+    lastFullRun(): Promise<{
+        at: number;
+        trigger: Trigger;
+    } | null>;
+    readonly services: ReadonlyMap<string, ResolvedService>;
+    readonly tree: readonly ResolvedNode[];
+    readonly store: StatusStore;
+    readonly intervalMs: number;
+    readonly retentionMs: number;
+    readonly scoring: Scoring;
+    readonly warnings: readonly string[];
+};
+/**
+ * Describe what to supervise and get a status engine: run checks, read snapshots and history.
+ * Nothing here depends on a host or a framework; see "sermon-js/api" to expose it over HTTP.
+ */
+declare function defineStatus(config: StatusConfig): Status;
+
+export { type Duration as D, type RunReport as R, type Status as S, type TickResult as T, type Scoring as a, DEFAULT_SCORING as b, type ScoringInput as c, type ServiceHistory as d, type StatusConfig as e, computeScore as f, defineStatus as g, labelForScore as l, toMs as t };

package/dist/store-DybhDphS.d.cts

@@ -0,0 +1,77 @@
+import { o as Status, T as Trigger, k as ScoreLabel, g as CheckResult } from './types-CctvUAs2.cjs';
+
+/** One entry per run: drives the score history */
+type RunSummary = {
+    at: number;
+    trigger: Trigger;
+    /** True when every service was checked (single-service runs are partial) */
+    full: boolean;
+    score: number | null;
+    label: ScoreLabel;
+    /** Only services that were degraded or down: key → status */
+    failing: Record<string, Status>;
+};
+/** One entry per service per run: drives uptime, latency percentiles and sparklines */
+type CheckSample = {
+    key: string;
+    at: number;
+    status: Status;
+    latencyMs?: number;
+    httpStatus?: number;
+    error?: string;
+    /** Per instance (e.g. region): key → [status, latency] */
+    instances?: Record<string, [Status, number?]>;
+};
+type TimeRange = {
+    since: number;
+    until: number;
+};
+type LockResult = {
+    ok: true;
+} | {
+    ok: false;
+    retryAfterMs: number;
+};
+/**
+ * Persistence for sermon-js. Implement these few methods to store history anywhere
+ * (Redis, Postgres, MySQL, SQLite, MongoDB…). Statistics and bucketing are computed by the
+ * library from what the store returns, so adapters only save and read rows.
+ *
+ * Verify an implementation with `runStoreConformance` from "sermon-js/testing".
+ */
+interface StatusStore {
+    /** Persist one run: upsert the latest result of each service, append its sample and the summary */
+    saveRun(run: {
+        summary: RunSummary;
+        results: CheckResult[];
+        samples: CheckSample[];
+    }): Promise<void>;
+    /** The latest result of every service, by key */
+    latest(): Promise<Record<string, CheckResult>>;
+    /** Run summaries within the range (inclusive), oldest first */
+    runs(range: TimeRange): Promise<RunSummary[]>;
+    /** Samples of one service within the range (inclusive), oldest first */
+    samples(key: string, range: TimeRange): Promise<CheckSample[]>;
+    /**
+     * Drop runs and samples older than `before`. When `keepKeys` is given, also drop everything
+     * (latest results and samples) belonging to services not in that list.
+     */
+    prune(options: {
+        before: number;
+        keepKeys?: string[];
+    }): Promise<void>;
+    /**
+     * Optional cross-instance lock (rate limits, single scheduled run). Without it the library
+     * falls back to an in-process lock, which is enough for a single server.
+     */
+    lock?(name: string, ttlMs: number): Promise<LockResult>;
+    /** Release a lock taken with `lock` before its time-to-live (optional; without it locks just expire) */
+    unlock?(name: string): Promise<void>;
+    /** Optional small cache (computed statistics, check state such as daily peaks) */
+    cache?: {
+        get(key: string): Promise<string | null>;
+        set(key: string, value: string, ttlMs: number): Promise<void>;
+    };
+}
+
+export type { CheckSample as C, LockResult as L, RunSummary as R, StatusStore as S, TimeRange as T };

package/dist/store-_GuzSP0z.d.ts

@@ -0,0 +1,77 @@
+import { o as Status, T as Trigger, k as ScoreLabel, g as CheckResult } from './types-CctvUAs2.js';
+
+/** One entry per run: drives the score history */
+type RunSummary = {
+    at: number;
+    trigger: Trigger;
+    /** True when every service was checked (single-service runs are partial) */
+    full: boolean;
+    score: number | null;
+    label: ScoreLabel;
+    /** Only services that were degraded or down: key → status */
+    failing: Record<string, Status>;
+};
+/** One entry per service per run: drives uptime, latency percentiles and sparklines */
+type CheckSample = {
+    key: string;
+    at: number;
+    status: Status;
+    latencyMs?: number;
+    httpStatus?: number;
+    error?: string;
+    /** Per instance (e.g. region): key → [status, latency] */
+    instances?: Record<string, [Status, number?]>;
+};
+type TimeRange = {
+    since: number;
+    until: number;
+};
+type LockResult = {
+    ok: true;
+} | {
+    ok: false;
+    retryAfterMs: number;
+};
+/**
+ * Persistence for sermon-js. Implement these few methods to store history anywhere
+ * (Redis, Postgres, MySQL, SQLite, MongoDB…). Statistics and bucketing are computed by the
+ * library from what the store returns, so adapters only save and read rows.
+ *
+ * Verify an implementation with `runStoreConformance` from "sermon-js/testing".
+ */
+interface StatusStore {
+    /** Persist one run: upsert the latest result of each service, append its sample and the summary */
+    saveRun(run: {
+        summary: RunSummary;
+        results: CheckResult[];
+        samples: CheckSample[];
+    }): Promise<void>;
+    /** The latest result of every service, by key */
+    latest(): Promise<Record<string, CheckResult>>;
+    /** Run summaries within the range (inclusive), oldest first */
+    runs(range: TimeRange): Promise<RunSummary[]>;
+    /** Samples of one service within the range (inclusive), oldest first */
+    samples(key: string, range: TimeRange): Promise<CheckSample[]>;
+    /**
+     * Drop runs and samples older than `before`. When `keepKeys` is given, also drop everything
+     * (latest results and samples) belonging to services not in that list.
+     */
+    prune(options: {
+        before: number;
+        keepKeys?: string[];
+    }): Promise<void>;
+    /**
+     * Optional cross-instance lock (rate limits, single scheduled run). Without it the library
+     * falls back to an in-process lock, which is enough for a single server.
+     */
+    lock?(name: string, ttlMs: number): Promise<LockResult>;
+    /** Release a lock taken with `lock` before its time-to-live (optional; without it locks just expire) */
+    unlock?(name: string): Promise<void>;
+    /** Optional small cache (computed statistics, check state such as daily peaks) */
+    cache?: {
+        get(key: string): Promise<string | null>;
+        set(key: string, value: string, ttlMs: number): Promise<void>;
+    };
+}
+
+export type { CheckSample as C, LockResult as L, RunSummary as R, StatusStore as S, TimeRange as T };

package/dist/stores/mongodb.cjs

@@ -0,0 +1,99 @@
+'use strict';
+
+// src/stores/mongodb.ts
+var DUPLICATE_KEY = 11e3;
+function mongoStore({ db, collectionPrefix = "sermon_" }) {
+  const latest = db.collection(`${collectionPrefix}latest`);
+  const runs = db.collection(`${collectionPrefix}runs`);
+  const samples = db.collection(`${collectionPrefix}samples`);
+  const kv = db.collection(`${collectionPrefix}kv`);
+  let indexed;
+  const ready = () => {
+    indexed ??= Promise.all([
+      runs.createIndex({ at: 1 }),
+      samples.createIndex({ key: 1, at: 1 }),
+      samples.createIndex({ at: 1 })
+    ]).catch((error) => {
+      indexed = void 0;
+      throw error;
+    });
+    return indexed;
+  };
+  const strip = (doc) => {
+    const { _id, ...rest } = doc;
+    return rest;
+  };
+  return {
+    async saveRun({ summary, results, samples: newSamples }) {
+      await ready();
+      if (results.length) {
+        await latest.bulkWrite(
+          results.map((result) => ({
+            replaceOne: { filter: { _id: result.key }, replacement: { ...result }, upsert: true }
+          }))
+        );
+      }
+      if (newSamples.length) await samples.insertMany(newSamples.map((sample) => ({ ...sample })));
+      await runs.insertOne({ ...summary });
+    },
+    async latest() {
+      await ready();
+      const docs = await latest.find({}).toArray();
+      return Object.fromEntries(docs.map((doc) => [String(doc._id), strip(doc)]));
+    },
+    async runs({ since, until }) {
+      await ready();
+      const docs = await runs.find({ at: { $gte: since, $lte: until } }).sort({ at: 1 }).toArray();
+      return docs.map((doc) => strip(doc));
+    },
+    async samples(key, { since, until }) {
+      await ready();
+      const docs = await samples.find({ key, at: { $gte: since, $lte: until } }).sort({ at: 1 }).toArray();
+      return docs.map((doc) => strip(doc));
+    },
+    async prune({ before, keepKeys }) {
+      await ready();
+      await Promise.all([runs.deleteMany({ at: { $lt: before } }), samples.deleteMany({ at: { $lt: before } })]);
+      if (keepKeys) {
+        await Promise.all([
+          latest.deleteMany({ _id: { $nin: keepKeys } }),
+          samples.deleteMany({ key: { $nin: keepKeys } })
+        ]);
+      }
+    },
+    async lock(name, ttlMs) {
+      const id = `lock:${name}`;
+      const now = Date.now();
+      const expiresAt = now + Math.max(1, Math.round(ttlMs));
+      try {
+        await kv.updateOne({ _id: id, expiresAt: { $lte: now } }, { $set: { expiresAt } }, { upsert: true });
+        return { ok: true };
+      } catch (error) {
+        if (error.code !== DUPLICATE_KEY) throw error;
+        const held = await kv.findOne({ _id: id });
+        const until = Number(held?.expiresAt);
+        return { ok: false, retryAfterMs: Number.isFinite(until) ? Math.max(1, until - Date.now()) : ttlMs };
+      }
+    },
+    async unlock(name) {
+      await kv.deleteOne({ _id: `lock:${name}` });
+    },
+    cache: {
+      async get(key) {
+        const doc = await kv.findOne({ _id: `cache:${key}`, expiresAt: { $gt: Date.now() } });
+        return typeof doc?.value === "string" ? doc.value : null;
+      },
+      async set(key, value, ttlMs) {
+        await kv.updateOne(
+          { _id: `cache:${key}` },
+          { $set: { value, expiresAt: Date.now() + Math.max(1, Math.round(ttlMs)) } },
+          { upsert: true }
+        );
+      }
+    }
+  };
+}
+
+exports.mongoStore = mongoStore;
+//# sourceMappingURL=mongodb.cjs.map
+//# sourceMappingURL=mongodb.cjs.map

package/dist/stores/mongodb.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/stores/mongodb.ts"],"names":[],"mappings":";;;AA6BA,IAAM,aAAA,GAAgB,IAAA;AAWf,SAAS,UAAA,CAAW,EAAE,EAAA,EAAI,gBAAA,GAAmB,WAAU,EAAmC;AAC/F,EAAA,MAAM,MAAA,GAAS,EAAA,CAAG,UAAA,CAAW,CAAA,EAAG,gBAAgB,CAAA,MAAA,CAAQ,CAAA;AACxD,EAAA,MAAM,IAAA,GAAO,EAAA,CAAG,UAAA,CAAW,CAAA,EAAG,gBAAgB,CAAA,IAAA,CAAM,CAAA;AACpD,EAAA,MAAM,OAAA,GAAU,EAAA,CAAG,UAAA,CAAW,CAAA,EAAG,gBAAgB,CAAA,OAAA,CAAS,CAAA;AAC1D,EAAA,MAAM,EAAA,GAAK,EAAA,CAAG,UAAA,CAAW,CAAA,EAAG,gBAAgB,CAAA,EAAA,CAAI,CAAA;AAEhD,EAAA,IAAI,OAAA;AACJ,EAAA,MAAM,QAAQ,MAAM;AAClB,IAAA,OAAA,KAAY,QAAQ,GAAA,CAAI;AAAA,MACtB,IAAA,CAAK,WAAA,CAAY,EAAE,EAAA,EAAI,GAAG,CAAA;AAAA,MAC1B,QAAQ,WAAA,CAAY,EAAE,KAAK,CAAA,EAAG,EAAA,EAAI,GAAG,CAAA;AAAA,MACrC,OAAA,CAAQ,WAAA,CAAY,EAAE,EAAA,EAAI,GAAG;AAAA,KAC9B,CAAA,CAAE,KAAA,CAAM,CAAC,KAAA,KAAU;AAClB,MAAA,OAAA,GAAU,MAAA;AACV,MAAA,MAAM,KAAA;AAAA,IACR,CAAC,CAAA;AACD,IAAA,OAAO,OAAA;AAAA,EACT,CAAA;AAGA,EAAA,MAAM,KAAA,GAAQ,CAAI,GAAA,KAAgB;AAChC,IAAA,MAAM,EAAE,GAAA,EAAK,GAAG,IAAA,EAAK,GAAI,GAAA;AAEzB,IAAA,OAAO,IAAA;AAAA,EACT,CAAA;AAEA,EAAA,OAAO;AAAA,IACL,MAAM,OAAA,CAAQ,EAAE,SAAS,OAAA,EAAS,OAAA,EAAS,YAAW,EAAG;AACvD,MAAA,MAAM,KAAA,EAAM;AACZ,MAAA,IAAI,QAAQ,MAAA,EAAQ;AAClB,QAAA,MAAM,MAAA,CAAO,SAAA;AAAA,UACX,OAAA,CAAQ,GAAA,CAAI,CAAC,MAAA,MAAY;AAAA,YACvB,UAAA,EAAY,EAAE,MAAA,EAAQ,EAAE,KAAK,MAAA,CAAO,GAAA,EAAI,EAAG,WAAA,EAAa,EAAE,GAAG,MAAA,EAAO,EAAG,QAAQ,IAAA;AAAK,WACtF,CAAE;AAAA,SACJ;AAAA,MACF;AACA,MAAA,IAAI,UAAA,CAAW,MAAA,EAAQ,MAAM,OAAA,CAAQ,UAAA,CAAW,UAAA,CAAW,GAAA,CAAI,CAAC,MAAA,MAAY,EAAE,GAAG,MAAA,GAAS,CAAC,CAAA;AAC3F,MAAA,MAAM,IAAA,CAAK,SAAA,CAAU,EAAE,GAAG,SAAS,CAAA;AAAA,IACrC,CAAA;AAAA,IAEA,MAAM,MAAA,GAAS;AACb,MAAA,MAAM,KAAA,EAAM;AACZ,MAAA,MAAM,OAAO,MAAM,MAAA,CAAO,KAAK,EAAE,EAAE,OAAA,EAAQ;AAC3C,MAAA,OAAO,MAAA,CAAO,WAAA,CAAY,IAAA,CAAK,GAAA,CAAI,CAAC,GAAA,KAAQ,CAAC,MAAA,CAAO,GAAA,CAAI,GAAG,CAAA,EAAG,KAAA,CAAmB,GAAG,CAAC,CAAC,CAAC,CAAA;AAAA,IACzF,CAAA;AAAA,IAEA,MAAM,IAAA,CAAK,EAAE,KAAA,EAAO,OAAM,EAAG;AAC3B,MAAA,MAAM,KAAA,EAAM;AACZ,MAAA,MAAM,IAAA,GAAO,MAAM,IAAA,CAAK,IAAA,CAAK,EAAE,EAAA,EAAI,EAAE,MAAM,KAAA,EAAO,IAAA,EAAM,OAAM,EAAG,EAAE,IAAA,CAAK,EAAE,IAAI,CAAA,EAAG,EAAE,OAAA,EAAQ;AAC3F,MAAA,OAAO,KAAK,GAAA,CAAI,CAAC,GAAA,KAAQ,KAAA,CAAkB,GAAG,CAAC,CAAA;AAAA,IACjD,CAAA;AAAA,IAEA,MAAM,OAAA,CAAQ,GAAA,EAAK,EAAE,KAAA,EAAO,OAAM,EAAG;AACnC,MAAA,MAAM,KAAA,EAAM;AACZ,MAAA,MAAM,IAAA,GAAO,MAAM,OAAA,CAAQ,IAAA,CAAK,EAAE,GAAA,EAAK,EAAA,EAAI,EAAE,IAAA,EAAM,KAAA,EAAO,MAAM,KAAA,EAAM,EAAG,CAAA,CAAE,IAAA,CAAK,EAAE,EAAA,EAAI,CAAA,EAAG,CAAA,CAAE,OAAA,EAAQ;AACnG,MAAA,OAAO,KAAK,GAAA,CAAI,CAAC,GAAA,KAAQ,KAAA,CAAmB,GAAG,CAAC,CAAA;AAAA,IAClD,CAAA;AAAA,IAEA,MAAM,KAAA,CAAM,EAAE,MAAA,EAAQ,UAAS,EAAG;AAChC,MAAA,MAAM,KAAA,EAAM;AACZ,MAAA,MAAM,OAAA,CAAQ,IAAI,CAAC,IAAA,CAAK,WAAW,EAAE,EAAA,EAAI,EAAE,GAAA,EAAK,MAAA,EAAO,EAAG,CAAA,EAAG,OAAA,CAAQ,UAAA,CAAW,EAAE,EAAA,EAAI,EAAE,KAAK,MAAA,EAAO,EAAG,CAAC,CAAC,CAAA;AACzG,MAAA,IAAI,QAAA,EAAU;AACZ,QAAA,MAAM,QAAQ,GAAA,CAAI;AAAA,UAChB,MAAA,CAAO,WAAW,EAAE,GAAA,EAAK,EAAE,IAAA,EAAM,QAAA,IAAY,CAAA;AAAA,UAC7C,OAAA,CAAQ,WAAW,EAAE,GAAA,EAAK,EAAE,IAAA,EAAM,QAAA,IAAY;AAAA,SAC/C,CAAA;AAAA,MACH;AAAA,IACF,CAAA;AAAA,IAEA,MAAM,IAAA,CAAK,IAAA,EAAM,KAAA,EAA4B;AAC3C,MAAA,MAAM,EAAA,GAAK,QAAQ,IAAI,CAAA,CAAA;AACvB,MAAA,MAAM,GAAA,GAAM,KAAK,GAAA,EAAI;AACrB,MAAA,MAAM,SAAA,GAAY,MAAM,IAAA,CAAK,GAAA,CAAI,GAAG,IAAA,CAAK,KAAA,CAAM,KAAK,CAAC,CAAA;AACrD,MAAA,IAAI;AAGF,QAAA,MAAM,EAAA,CAAG,UAAU,EAAE,GAAA,EAAK,IAAI,SAAA,EAAW,EAAE,MAAM,GAAA,EAAI,IAAK,EAAE,IAAA,EAAM,EAAE,SAAA,EAAU,IAAK,EAAE,MAAA,EAAQ,MAAM,CAAA;AACnG,QAAA,OAAO,EAAE,IAAI,IAAA,EAAK;AAAA,MACpB,SAAS,KAAA,EAAO;AACd,QAAA,IAAK,KAAA,CAA4B,IAAA,KAAS,aAAA,EAAe,MAAM,KAAA;AAC/D,QAAA,MAAM,OAAO,MAAM,EAAA,CAAG,QAAQ,EAAE,GAAA,EAAK,IAAI,CAAA;AACzC,QAAA,MAAM,KAAA,GAAQ,MAAA,CAAO,IAAA,EAAM,SAAS,CAAA;AACpC,QAAA,OAAO,EAAE,EAAA,EAAI,KAAA,EAAO,YAAA,EAAc,MAAA,CAAO,SAAS,KAAK,CAAA,GAAI,IAAA,CAAK,GAAA,CAAI,GAAG,KAAA,GAAQ,IAAA,CAAK,GAAA,EAAK,IAAI,KAAA,EAAM;AAAA,MACrG;AAAA,IACF,CAAA;AAAA,IAEA,MAAM,OAAO,IAAA,EAAM;AACjB,MAAA,MAAM,GAAG,SAAA,CAAU,EAAE,KAAK,CAAA,KAAA,EAAQ,IAAI,IAAI,CAAA;AAAA,IAC5C,CAAA;AAAA,IAEA,KAAA,EAAO;AAAA,MACL,MAAM,IAAI,GAAA,EAAK;AACb,QAAA,MAAM,MAAM,MAAM,EAAA,CAAG,OAAA,CAAQ,EAAE,KAAK,CAAA,MAAA,EAAS,GAAG,CAAA,CAAA,EAAI,SAAA,EAAW,EAAE,GAAA,EAAK,IAAA,CAAK,GAAA,EAAI,IAAK,CAAA;AACpF,QAAA,OAAO,OAAO,GAAA,EAAK,KAAA,KAAU,QAAA,GAAW,IAAI,KAAA,GAAQ,IAAA;AAAA,MACtD,CAAA;AAAA,MACA,MAAM,GAAA,CAAI,GAAA,EAAK,KAAA,EAAO,KAAA,EAAO;AAC3B,QAAA,MAAM,EAAA,CAAG,SAAA;AAAA,UACP,EAAE,GAAA,EAAK,CAAA,MAAA,EAAS,GAAG,CAAA,CAAA,EAAG;AAAA,UACtB,EAAE,IAAA,EAAM,EAAE,KAAA,EAAO,SAAA,EAAW,KAAK,GAAA,EAAI,GAAI,IAAA,CAAK,GAAA,CAAI,GAAG,IAAA,CAAK,KAAA,CAAM,KAAK,CAAC,GAAE,EAAE;AAAA,UAC1E,EAAE,QAAQ,IAAA;AAAK,SACjB;AAAA,MACF;AAAA;AACF,GACF;AACF","file":"mongodb.cjs","sourcesContent":["import type { CheckSample, LockResult, RunSummary, StatusStore } from \"../store\";\nimport type { CheckResult } from \"../types\";\n\n// Structural types for the few driver methods used, so the `mongodb` package isn't required\n// to build against (any 5.x / 6.x `Db` fits).\ntype Doc = Record<string, unknown>;\ntype MongoCursor = { sort(spec: Record<string, 1 | -1>): MongoCursor; toArray(): Promise<Doc[]> };\n/* eslint-disable @typescript-eslint/no-explicit-any -- the driver's own generics are stricter than we need */\ntype MongoCollection = {\n  find(filter: any): MongoCursor;\n  findOne(filter: any): Promise<Doc | null>;\n  insertOne(doc: any): Promise<unknown>;\n  insertMany(docs: any[]): Promise<unknown>;\n  updateOne(filter: any, update: any, options?: any): Promise<unknown>;\n  bulkWrite(operations: any[]): Promise<unknown>;\n  deleteOne(filter: any): Promise<unknown>;\n  deleteMany(filter: any): Promise<unknown>;\n  createIndex(spec: any, options?: any): Promise<unknown>;\n};\n/* eslint-enable @typescript-eslint/no-explicit-any */\nexport type MongoDbLike = { collection(name: string): MongoCollection };\n\nexport type MongoStoreOptions = {\n  /** A `Db` from a connected MongoClient: `client.db(\"status\")` */\n  db: MongoDbLike;\n  /** Prefix of the four collections (default \"sermon_\") */\n  collectionPrefix?: string;\n};\n\nconst DUPLICATE_KEY = 11000;\n\n/**\n * Store on MongoDB, with the client you already have:\n *\n * ```ts\n * mongoStore({ db: client.db(\"status\") })\n * ```\n *\n * It uses four small collections and creates their indexes on first use.\n */\nexport function mongoStore({ db, collectionPrefix = \"sermon_\" }: MongoStoreOptions): StatusStore {\n  const latest = db.collection(`${collectionPrefix}latest`);\n  const runs = db.collection(`${collectionPrefix}runs`);\n  const samples = db.collection(`${collectionPrefix}samples`);\n  const kv = db.collection(`${collectionPrefix}kv`);\n\n  let indexed: Promise<unknown> | undefined;\n  const ready = () => {\n    indexed ??= Promise.all([\n      runs.createIndex({ at: 1 }),\n      samples.createIndex({ key: 1, at: 1 }),\n      samples.createIndex({ at: 1 }),\n    ]).catch((error) => {\n      indexed = undefined;\n      throw error;\n    });\n    return indexed;\n  };\n\n  /** Stored documents carry Mongo's own `_id`: give back exactly what was saved */\n  const strip = <T>(doc: Doc): T => {\n    const { _id, ...rest } = doc;\n    void _id;\n    return rest as T;\n  };\n\n  return {\n    async saveRun({ summary, results, samples: newSamples }) {\n      await ready();\n      if (results.length) {\n        await latest.bulkWrite(\n          results.map((result) => ({\n            replaceOne: { filter: { _id: result.key }, replacement: { ...result }, upsert: true },\n          }))\n        );\n      }\n      if (newSamples.length) await samples.insertMany(newSamples.map((sample) => ({ ...sample })));\n      await runs.insertOne({ ...summary });\n    },\n\n    async latest() {\n      await ready();\n      const docs = await latest.find({}).toArray();\n      return Object.fromEntries(docs.map((doc) => [String(doc._id), strip<CheckResult>(doc)]));\n    },\n\n    async runs({ since, until }) {\n      await ready();\n      const docs = await runs.find({ at: { $gte: since, $lte: until } }).sort({ at: 1 }).toArray();\n      return docs.map((doc) => strip<RunSummary>(doc));\n    },\n\n    async samples(key, { since, until }) {\n      await ready();\n      const docs = await samples.find({ key, at: { $gte: since, $lte: until } }).sort({ at: 1 }).toArray();\n      return docs.map((doc) => strip<CheckSample>(doc));\n    },\n\n    async prune({ before, keepKeys }) {\n      await ready();\n      await Promise.all([runs.deleteMany({ at: { $lt: before } }), samples.deleteMany({ at: { $lt: before } })]);\n      if (keepKeys) {\n        await Promise.all([\n          latest.deleteMany({ _id: { $nin: keepKeys } }),\n          samples.deleteMany({ key: { $nin: keepKeys } }),\n        ]);\n      }\n    },\n\n    async lock(name, ttlMs): Promise<LockResult> {\n      const id = `lock:${name}`;\n      const now = Date.now();\n      const expiresAt = now + Math.max(1, Math.round(ttlMs));\n      try {\n        // Takes the lock if it is free or expired. If a live lock exists the filter doesn't\n        // match, the upsert tries to insert the same _id, and the duplicate key tells us so.\n        await kv.updateOne({ _id: id, expiresAt: { $lte: now } }, { $set: { expiresAt } }, { upsert: true });\n        return { ok: true };\n      } catch (error) {\n        if ((error as { code?: number }).code !== DUPLICATE_KEY) throw error;\n        const held = await kv.findOne({ _id: id });\n        const until = Number(held?.expiresAt);\n        return { ok: false, retryAfterMs: Number.isFinite(until) ? Math.max(1, until - Date.now()) : ttlMs };\n      }\n    },\n\n    async unlock(name) {\n      await kv.deleteOne({ _id: `lock:${name}` });\n    },\n\n    cache: {\n      async get(key) {\n        const doc = await kv.findOne({ _id: `cache:${key}`, expiresAt: { $gt: Date.now() } });\n        return typeof doc?.value === \"string\" ? doc.value : null;\n      },\n      async set(key, value, ttlMs) {\n        await kv.updateOne(\n          { _id: `cache:${key}` },\n          { $set: { value, expiresAt: Date.now() + Math.max(1, Math.round(ttlMs)) } },\n          { upsert: true }\n        );\n      },\n    },\n  };\n}\n"]}

package/dist/stores/mongodb.d.cts

@@ -0,0 +1,40 @@
+import { S as StatusStore } from '../store-DybhDphS.cjs';
+import '../types-CctvUAs2.cjs';
+
+type Doc = Record<string, unknown>;
+type MongoCursor = {
+    sort(spec: Record<string, 1 | -1>): MongoCursor;
+    toArray(): Promise<Doc[]>;
+};
+type MongoCollection = {
+    find(filter: any): MongoCursor;
+    findOne(filter: any): Promise<Doc | null>;
+    insertOne(doc: any): Promise<unknown>;
+    insertMany(docs: any[]): Promise<unknown>;
+    updateOne(filter: any, update: any, options?: any): Promise<unknown>;
+    bulkWrite(operations: any[]): Promise<unknown>;
+    deleteOne(filter: any): Promise<unknown>;
+    deleteMany(filter: any): Promise<unknown>;
+    createIndex(spec: any, options?: any): Promise<unknown>;
+};
+type MongoDbLike = {
+    collection(name: string): MongoCollection;
+};
+type MongoStoreOptions = {
+    /** A `Db` from a connected MongoClient: `client.db("status")` */
+    db: MongoDbLike;
+    /** Prefix of the four collections (default "sermon_") */
+    collectionPrefix?: string;
+};
+/**
+ * Store on MongoDB, with the client you already have:
+ *
+ * ```ts
+ * mongoStore({ db: client.db("status") })
+ * ```
+ *
+ * It uses four small collections and creates their indexes on first use.
+ */
+declare function mongoStore({ db, collectionPrefix }: MongoStoreOptions): StatusStore;
+
+export { type MongoDbLike, type MongoStoreOptions, mongoStore };

package/dist/stores/mongodb.d.ts

@@ -0,0 +1,40 @@
+import { S as StatusStore } from '../store-_GuzSP0z.js';
+import '../types-CctvUAs2.js';
+
+type Doc = Record<string, unknown>;
+type MongoCursor = {
+    sort(spec: Record<string, 1 | -1>): MongoCursor;
+    toArray(): Promise<Doc[]>;
+};
+type MongoCollection = {
+    find(filter: any): MongoCursor;
+    findOne(filter: any): Promise<Doc | null>;
+    insertOne(doc: any): Promise<unknown>;
+    insertMany(docs: any[]): Promise<unknown>;
+    updateOne(filter: any, update: any, options?: any): Promise<unknown>;
+    bulkWrite(operations: any[]): Promise<unknown>;
+    deleteOne(filter: any): Promise<unknown>;
+    deleteMany(filter: any): Promise<unknown>;
+    createIndex(spec: any, options?: any): Promise<unknown>;
+};
+type MongoDbLike = {
+    collection(name: string): MongoCollection;
+};
+type MongoStoreOptions = {
+    /** A `Db` from a connected MongoClient: `client.db("status")` */
+    db: MongoDbLike;
+    /** Prefix of the four collections (default "sermon_") */
+    collectionPrefix?: string;
+};
+/**
+ * Store on MongoDB, with the client you already have:
+ *
+ * ```ts
+ * mongoStore({ db: client.db("status") })
+ * ```
+ *
+ * It uses four small collections and creates their indexes on first use.
+ */
+declare function mongoStore({ db, collectionPrefix }: MongoStoreOptions): StatusStore;
+
+export { type MongoDbLike, type MongoStoreOptions, mongoStore };

package/dist/stores/mongodb.js

@@ -0,0 +1,97 @@
+// src/stores/mongodb.ts
+var DUPLICATE_KEY = 11e3;
+function mongoStore({ db, collectionPrefix = "sermon_" }) {
+  const latest = db.collection(`${collectionPrefix}latest`);
+  const runs = db.collection(`${collectionPrefix}runs`);
+  const samples = db.collection(`${collectionPrefix}samples`);
+  const kv = db.collection(`${collectionPrefix}kv`);
+  let indexed;
+  const ready = () => {
+    indexed ??= Promise.all([
+      runs.createIndex({ at: 1 }),
+      samples.createIndex({ key: 1, at: 1 }),
+      samples.createIndex({ at: 1 })
+    ]).catch((error) => {
+      indexed = void 0;
+      throw error;
+    });
+    return indexed;
+  };
+  const strip = (doc) => {
+    const { _id, ...rest } = doc;
+    return rest;
+  };
+  return {
+    async saveRun({ summary, results, samples: newSamples }) {
+      await ready();
+      if (results.length) {
+        await latest.bulkWrite(
+          results.map((result) => ({
+            replaceOne: { filter: { _id: result.key }, replacement: { ...result }, upsert: true }
+          }))
+        );
+      }
+      if (newSamples.length) await samples.insertMany(newSamples.map((sample) => ({ ...sample })));
+      await runs.insertOne({ ...summary });
+    },
+    async latest() {
+      await ready();
+      const docs = await latest.find({}).toArray();
+      return Object.fromEntries(docs.map((doc) => [String(doc._id), strip(doc)]));
+    },
+    async runs({ since, until }) {
+      await ready();
+      const docs = await runs.find({ at: { $gte: since, $lte: until } }).sort({ at: 1 }).toArray();
+      return docs.map((doc) => strip(doc));
+    },
+    async samples(key, { since, until }) {
+      await ready();
+      const docs = await samples.find({ key, at: { $gte: since, $lte: until } }).sort({ at: 1 }).toArray();
+      return docs.map((doc) => strip(doc));
+    },
+    async prune({ before, keepKeys }) {
+      await ready();
+      await Promise.all([runs.deleteMany({ at: { $lt: before } }), samples.deleteMany({ at: { $lt: before } })]);
+      if (keepKeys) {
+        await Promise.all([
+          latest.deleteMany({ _id: { $nin: keepKeys } }),
+          samples.deleteMany({ key: { $nin: keepKeys } })
+        ]);
+      }
+    },
+    async lock(name, ttlMs) {
+      const id = `lock:${name}`;
+      const now = Date.now();
+      const expiresAt = now + Math.max(1, Math.round(ttlMs));
+      try {
+        await kv.updateOne({ _id: id, expiresAt: { $lte: now } }, { $set: { expiresAt } }, { upsert: true });
+        return { ok: true };
+      } catch (error) {
+        if (error.code !== DUPLICATE_KEY) throw error;
+        const held = await kv.findOne({ _id: id });
+        const until = Number(held?.expiresAt);
+        return { ok: false, retryAfterMs: Number.isFinite(until) ? Math.max(1, until - Date.now()) : ttlMs };
+      }
+    },
+    async unlock(name) {
+      await kv.deleteOne({ _id: `lock:${name}` });
+    },
+    cache: {
+      async get(key) {
+        const doc = await kv.findOne({ _id: `cache:${key}`, expiresAt: { $gt: Date.now() } });
+        return typeof doc?.value === "string" ? doc.value : null;
+      },
+      async set(key, value, ttlMs) {
+        await kv.updateOne(
+          { _id: `cache:${key}` },
+          { $set: { value, expiresAt: Date.now() + Math.max(1, Math.round(ttlMs)) } },
+          { upsert: true }
+        );
+      }
+    }
+  };
+}
+
+export { mongoStore };
+//# sourceMappingURL=mongodb.js.map
+//# sourceMappingURL=mongodb.js.map

package/dist/stores/mongodb.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/stores/mongodb.ts"],"names":[],"mappings":";AA6BA,IAAM,aAAA,GAAgB,IAAA;AAWf,SAAS,UAAA,CAAW,EAAE,EAAA,EAAI,gBAAA,GAAmB,WAAU,EAAmC;AAC/F,EAAA,MAAM,MAAA,GAAS,EAAA,CAAG,UAAA,CAAW,CAAA,EAAG,gBAAgB,CAAA,MAAA,CAAQ,CAAA;AACxD,EAAA,MAAM,IAAA,GAAO,EAAA,CAAG,UAAA,CAAW,CAAA,EAAG,gBAAgB,CAAA,IAAA,CAAM,CAAA;AACpD,EAAA,MAAM,OAAA,GAAU,EAAA,CAAG,UAAA,CAAW,CAAA,EAAG,gBAAgB,CAAA,OAAA,CAAS,CAAA;AAC1D,EAAA,MAAM,EAAA,GAAK,EAAA,CAAG,UAAA,CAAW,CAAA,EAAG,gBAAgB,CAAA,EAAA,CAAI,CAAA;AAEhD,EAAA,IAAI,OAAA;AACJ,EAAA,MAAM,QAAQ,MAAM;AAClB,IAAA,OAAA,KAAY,QAAQ,GAAA,CAAI;AAAA,MACtB,IAAA,CAAK,WAAA,CAAY,EAAE,EAAA,EAAI,GAAG,CAAA;AAAA,MAC1B,QAAQ,WAAA,CAAY,EAAE,KAAK,CAAA,EAAG,EAAA,EAAI,GAAG,CAAA;AAAA,MACrC,OAAA,CAAQ,WAAA,CAAY,EAAE,EAAA,EAAI,GAAG;AAAA,KAC9B,CAAA,CAAE,KAAA,CAAM,CAAC,KAAA,KAAU;AAClB,MAAA,OAAA,GAAU,MAAA;AACV,MAAA,MAAM,KAAA;AAAA,IACR,CAAC,CAAA;AACD,IAAA,OAAO,OAAA;AAAA,EACT,CAAA;AAGA,EAAA,MAAM,KAAA,GAAQ,CAAI,GAAA,KAAgB;AAChC,IAAA,MAAM,EAAE,GAAA,EAAK,GAAG,IAAA,EAAK,GAAI,GAAA;AAEzB,IAAA,OAAO,IAAA;AAAA,EACT,CAAA;AAEA,EAAA,OAAO;AAAA,IACL,MAAM,OAAA,CAAQ,EAAE,SAAS,OAAA,EAAS,OAAA,EAAS,YAAW,EAAG;AACvD,MAAA,MAAM,KAAA,EAAM;AACZ,MAAA,IAAI,QAAQ,MAAA,EAAQ;AAClB,QAAA,MAAM,MAAA,CAAO,SAAA;AAAA,UACX,OAAA,CAAQ,GAAA,CAAI,CAAC,MAAA,MAAY;AAAA,YACvB,UAAA,EAAY,EAAE,MAAA,EAAQ,EAAE,KAAK,MAAA,CAAO,GAAA,EAAI,EAAG,WAAA,EAAa,EAAE,GAAG,MAAA,EAAO,EAAG,QAAQ,IAAA;AAAK,WACtF,CAAE;AAAA,SACJ;AAAA,MACF;AACA,MAAA,IAAI,UAAA,CAAW,MAAA,EAAQ,MAAM,OAAA,CAAQ,UAAA,CAAW,UAAA,CAAW,GAAA,CAAI,CAAC,MAAA,MAAY,EAAE,GAAG,MAAA,GAAS,CAAC,CAAA;AAC3F,MAAA,MAAM,IAAA,CAAK,SAAA,CAAU,EAAE,GAAG,SAAS,CAAA;AAAA,IACrC,CAAA;AAAA,IAEA,MAAM,MAAA,GAAS;AACb,MAAA,MAAM,KAAA,EAAM;AACZ,MAAA,MAAM,OAAO,MAAM,MAAA,CAAO,KAAK,EAAE,EAAE,OAAA,EAAQ;AAC3C,MAAA,OAAO,MAAA,CAAO,WAAA,CAAY,IAAA,CAAK,GAAA,CAAI,CAAC,GAAA,KAAQ,CAAC,MAAA,CAAO,GAAA,CAAI,GAAG,CAAA,EAAG,KAAA,CAAmB,GAAG,CAAC,CAAC,CAAC,CAAA;AAAA,IACzF,CAAA;AAAA,IAEA,MAAM,IAAA,CAAK,EAAE,KAAA,EAAO,OAAM,EAAG;AAC3B,MAAA,MAAM,KAAA,EAAM;AACZ,MAAA,MAAM,IAAA,GAAO,MAAM,IAAA,CAAK,IAAA,CAAK,EAAE,EAAA,EAAI,EAAE,MAAM,KAAA,EAAO,IAAA,EAAM,OAAM,EAAG,EAAE,IAAA,CAAK,EAAE,IAAI,CAAA,EAAG,EAAE,OAAA,EAAQ;AAC3F,MAAA,OAAO,KAAK,GAAA,CAAI,CAAC,GAAA,KAAQ,KAAA,CAAkB,GAAG,CAAC,CAAA;AAAA,IACjD,CAAA;AAAA,IAEA,MAAM,OAAA,CAAQ,GAAA,EAAK,EAAE,KAAA,EAAO,OAAM,EAAG;AACnC,MAAA,MAAM,KAAA,EAAM;AACZ,MAAA,MAAM,IAAA,GAAO,MAAM,OAAA,CAAQ,IAAA,CAAK,EAAE,GAAA,EAAK,EAAA,EAAI,EAAE,IAAA,EAAM,KAAA,EAAO,MAAM,KAAA,EAAM,EAAG,CAAA,CAAE,IAAA,CAAK,EAAE,EAAA,EAAI,CAAA,EAAG,CAAA,CAAE,OAAA,EAAQ;AACnG,MAAA,OAAO,KAAK,GAAA,CAAI,CAAC,GAAA,KAAQ,KAAA,CAAmB,GAAG,CAAC,CAAA;AAAA,IAClD,CAAA;AAAA,IAEA,MAAM,KAAA,CAAM,EAAE,MAAA,EAAQ,UAAS,EAAG;AAChC,MAAA,MAAM,KAAA,EAAM;AACZ,MAAA,MAAM,OAAA,CAAQ,IAAI,CAAC,IAAA,CAAK,WAAW,EAAE,EAAA,EAAI,EAAE,GAAA,EAAK,MAAA,EAAO,EAAG,CAAA,EAAG,OAAA,CAAQ,UAAA,CAAW,EAAE,EAAA,EAAI,EAAE,KAAK,MAAA,EAAO,EAAG,CAAC,CAAC,CAAA;AACzG,MAAA,IAAI,QAAA,EAAU;AACZ,QAAA,MAAM,QAAQ,GAAA,CAAI;AAAA,UAChB,MAAA,CAAO,WAAW,EAAE,GAAA,EAAK,EAAE,IAAA,EAAM,QAAA,IAAY,CAAA;AAAA,UAC7C,OAAA,CAAQ,WAAW,EAAE,GAAA,EAAK,EAAE,IAAA,EAAM,QAAA,IAAY;AAAA,SAC/C,CAAA;AAAA,MACH;AAAA,IACF,CAAA;AAAA,IAEA,MAAM,IAAA,CAAK,IAAA,EAAM,KAAA,EAA4B;AAC3C,MAAA,MAAM,EAAA,GAAK,QAAQ,IAAI,CAAA,CAAA;AACvB,MAAA,MAAM,GAAA,GAAM,KAAK,GAAA,EAAI;AACrB,MAAA,MAAM,SAAA,GAAY,MAAM,IAAA,CAAK,GAAA,CAAI,GAAG,IAAA,CAAK,KAAA,CAAM,KAAK,CAAC,CAAA;AACrD,MAAA,IAAI;AAGF,QAAA,MAAM,EAAA,CAAG,UAAU,EAAE,GAAA,EAAK,IAAI,SAAA,EAAW,EAAE,MAAM,GAAA,EAAI,IAAK,EAAE,IAAA,EAAM,EAAE,SAAA,EAAU,IAAK,EAAE,MAAA,EAAQ,MAAM,CAAA;AACnG,QAAA,OAAO,EAAE,IAAI,IAAA,EAAK;AAAA,MACpB,SAAS,KAAA,EAAO;AACd,QAAA,IAAK,KAAA,CAA4B,IAAA,KAAS,aAAA,EAAe,MAAM,KAAA;AAC/D,QAAA,MAAM,OAAO,MAAM,EAAA,CAAG,QAAQ,EAAE,GAAA,EAAK,IAAI,CAAA;AACzC,QAAA,MAAM,KAAA,GAAQ,MAAA,CAAO,IAAA,EAAM,SAAS,CAAA;AACpC,QAAA,OAAO,EAAE,EAAA,EAAI,KAAA,EAAO,YAAA,EAAc,MAAA,CAAO,SAAS,KAAK,CAAA,GAAI,IAAA,CAAK,GAAA,CAAI,GAAG,KAAA,GAAQ,IAAA,CAAK,GAAA,EAAK,IAAI,KAAA,EAAM;AAAA,MACrG;AAAA,IACF,CAAA;AAAA,IAEA,MAAM,OAAO,IAAA,EAAM;AACjB,MAAA,MAAM,GAAG,SAAA,CAAU,EAAE,KAAK,CAAA,KAAA,EAAQ,IAAI,IAAI,CAAA;AAAA,IAC5C,CAAA;AAAA,IAEA,KAAA,EAAO;AAAA,MACL,MAAM,IAAI,GAAA,EAAK;AACb,QAAA,MAAM,MAAM,MAAM,EAAA,CAAG,OAAA,CAAQ,EAAE,KAAK,CAAA,MAAA,EAAS,GAAG,CAAA,CAAA,EAAI,SAAA,EAAW,EAAE,GAAA,EAAK,IAAA,CAAK,GAAA,EAAI,IAAK,CAAA;AACpF,QAAA,OAAO,OAAO,GAAA,EAAK,KAAA,KAAU,QAAA,GAAW,IAAI,KAAA,GAAQ,IAAA;AAAA,MACtD,CAAA;AAAA,MACA,MAAM,GAAA,CAAI,GAAA,EAAK,KAAA,EAAO,KAAA,EAAO;AAC3B,QAAA,MAAM,EAAA,CAAG,SAAA;AAAA,UACP,EAAE,GAAA,EAAK,CAAA,MAAA,EAAS,GAAG,CAAA,CAAA,EAAG;AAAA,UACtB,EAAE,IAAA,EAAM,EAAE,KAAA,EAAO,SAAA,EAAW,KAAK,GAAA,EAAI,GAAI,IAAA,CAAK,GAAA,CAAI,GAAG,IAAA,CAAK,KAAA,CAAM,KAAK,CAAC,GAAE,EAAE;AAAA,UAC1E,EAAE,QAAQ,IAAA;AAAK,SACjB;AAAA,MACF;AAAA;AACF,GACF;AACF","file":"mongodb.js","sourcesContent":["import type { CheckSample, LockResult, RunSummary, StatusStore } from \"../store\";\nimport type { CheckResult } from \"../types\";\n\n// Structural types for the few driver methods used, so the `mongodb` package isn't required\n// to build against (any 5.x / 6.x `Db` fits).\ntype Doc = Record<string, unknown>;\ntype MongoCursor = { sort(spec: Record<string, 1 | -1>): MongoCursor; toArray(): Promise<Doc[]> };\n/* eslint-disable @typescript-eslint/no-explicit-any -- the driver's own generics are stricter than we need */\ntype MongoCollection = {\n  find(filter: any): MongoCursor;\n  findOne(filter: any): Promise<Doc | null>;\n  insertOne(doc: any): Promise<unknown>;\n  insertMany(docs: any[]): Promise<unknown>;\n  updateOne(filter: any, update: any, options?: any): Promise<unknown>;\n  bulkWrite(operations: any[]): Promise<unknown>;\n  deleteOne(filter: any): Promise<unknown>;\n  deleteMany(filter: any): Promise<unknown>;\n  createIndex(spec: any, options?: any): Promise<unknown>;\n};\n/* eslint-enable @typescript-eslint/no-explicit-any */\nexport type MongoDbLike = { collection(name: string): MongoCollection };\n\nexport type MongoStoreOptions = {\n  /** A `Db` from a connected MongoClient: `client.db(\"status\")` */\n  db: MongoDbLike;\n  /** Prefix of the four collections (default \"sermon_\") */\n  collectionPrefix?: string;\n};\n\nconst DUPLICATE_KEY = 11000;\n\n/**\n * Store on MongoDB, with the client you already have:\n *\n * ```ts\n * mongoStore({ db: client.db(\"status\") })\n * ```\n *\n * It uses four small collections and creates their indexes on first use.\n */\nexport function mongoStore({ db, collectionPrefix = \"sermon_\" }: MongoStoreOptions): StatusStore {\n  const latest = db.collection(`${collectionPrefix}latest`);\n  const runs = db.collection(`${collectionPrefix}runs`);\n  const samples = db.collection(`${collectionPrefix}samples`);\n  const kv = db.collection(`${collectionPrefix}kv`);\n\n  let indexed: Promise<unknown> | undefined;\n  const ready = () => {\n    indexed ??= Promise.all([\n      runs.createIndex({ at: 1 }),\n      samples.createIndex({ key: 1, at: 1 }),\n      samples.createIndex({ at: 1 }),\n    ]).catch((error) => {\n      indexed = undefined;\n      throw error;\n    });\n    return indexed;\n  };\n\n  /** Stored documents carry Mongo's own `_id`: give back exactly what was saved */\n  const strip = <T>(doc: Doc): T => {\n    const { _id, ...rest } = doc;\n    void _id;\n    return rest as T;\n  };\n\n  return {\n    async saveRun({ summary, results, samples: newSamples }) {\n      await ready();\n      if (results.length) {\n        await latest.bulkWrite(\n          results.map((result) => ({\n            replaceOne: { filter: { _id: result.key }, replacement: { ...result }, upsert: true },\n          }))\n        );\n      }\n      if (newSamples.length) await samples.insertMany(newSamples.map((sample) => ({ ...sample })));\n      await runs.insertOne({ ...summary });\n    },\n\n    async latest() {\n      await ready();\n      const docs = await latest.find({}).toArray();\n      return Object.fromEntries(docs.map((doc) => [String(doc._id), strip<CheckResult>(doc)]));\n    },\n\n    async runs({ since, until }) {\n      await ready();\n      const docs = await runs.find({ at: { $gte: since, $lte: until } }).sort({ at: 1 }).toArray();\n      return docs.map((doc) => strip<RunSummary>(doc));\n    },\n\n    async samples(key, { since, until }) {\n      await ready();\n      const docs = await samples.find({ key, at: { $gte: since, $lte: until } }).sort({ at: 1 }).toArray();\n      return docs.map((doc) => strip<CheckSample>(doc));\n    },\n\n    async prune({ before, keepKeys }) {\n      await ready();\n      await Promise.all([runs.deleteMany({ at: { $lt: before } }), samples.deleteMany({ at: { $lt: before } })]);\n      if (keepKeys) {\n        await Promise.all([\n          latest.deleteMany({ _id: { $nin: keepKeys } }),\n          samples.deleteMany({ key: { $nin: keepKeys } }),\n        ]);\n      }\n    },\n\n    async lock(name, ttlMs): Promise<LockResult> {\n      const id = `lock:${name}`;\n      const now = Date.now();\n      const expiresAt = now + Math.max(1, Math.round(ttlMs));\n      try {\n        // Takes the lock if it is free or expired. If a live lock exists the filter doesn't\n        // match, the upsert tries to insert the same _id, and the duplicate key tells us so.\n        await kv.updateOne({ _id: id, expiresAt: { $lte: now } }, { $set: { expiresAt } }, { upsert: true });\n        return { ok: true };\n      } catch (error) {\n        if ((error as { code?: number }).code !== DUPLICATE_KEY) throw error;\n        const held = await kv.findOne({ _id: id });\n        const until = Number(held?.expiresAt);\n        return { ok: false, retryAfterMs: Number.isFinite(until) ? Math.max(1, until - Date.now()) : ttlMs };\n      }\n    },\n\n    async unlock(name) {\n      await kv.deleteOne({ _id: `lock:${name}` });\n    },\n\n    cache: {\n      async get(key) {\n        const doc = await kv.findOne({ _id: `cache:${key}`, expiresAt: { $gt: Date.now() } });\n        return typeof doc?.value === \"string\" ? doc.value : null;\n      },\n      async set(key, value, ttlMs) {\n        await kv.updateOne(\n          { _id: `cache:${key}` },\n          { $set: { value, expiresAt: Date.now() + Math.max(1, Math.round(ttlMs)) } },\n          { upsert: true }\n        );\n      },\n    },\n  };\n}\n"]}

package/dist/stores/redis.cjs

@@ -0,0 +1,23 @@
+'use strict';
+
+var chunkZI442ZA5_cjs = require('../chunk-ZI442ZA5.cjs');
+
+// src/stores/redis.ts
+function redisStore({ client, command, prefix }) {
+  let send = command;
+  if (!send && client) {
+    if ("call" in client && typeof client.call === "function") {
+      send = ([name, ...args]) => client.call(name, ...args);
+    } else if ("sendCommand" in client && typeof client.sendCommand === "function") {
+      send = (args) => client.sendCommand(args);
+    }
+  }
+  if (!send) throw new Error("sermon-js: redisStore needs a `client` (ioredis or node-redis) or a `command` function");
+  const run = send;
+  const exec = (commands) => Promise.all(commands.map((args) => run(args.map(String))));
+  return chunkZI442ZA5_cjs.createRedisStore({ exec, prefix });
+}
+
+exports.redisStore = redisStore;
+//# sourceMappingURL=redis.cjs.map
+//# sourceMappingURL=redis.cjs.map

package/dist/stores/redis.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/stores/redis.ts"],"names":["createRedisStore"],"mappings":";;;;;AA0BO,SAAS,UAAA,CAAW,EAAE,MAAA,EAAQ,OAAA,EAAS,QAAO,EAAmC;AACtF,EAAA,IAAI,IAAA,GAAO,OAAA;AACX,EAAA,IAAI,CAAC,QAAQ,MAAA,EAAQ;AACnB,IAAA,IAAI,MAAA,IAAU,MAAA,IAAU,OAAO,MAAA,CAAO,SAAS,UAAA,EAAY;AACzD,MAAA,IAAA,GAAO,CAAC,CAAC,IAAA,EAAS,GAAA,IAAI,MAAM,MAAA,CAAO,IAAA,CAAK,IAAA,EAAgB,GAAI,IAAiB,CAAA;AAAA,IAC/E,WAAW,aAAA,IAAiB,MAAA,IAAU,OAAO,MAAA,CAAO,gBAAgB,UAAA,EAAY;AAC9E,MAAA,IAAA,GAAO,CAAC,IAAA,KAAS,MAAA,CAAO,WAAA,CAAY,IAAI,CAAA;AAAA,IAC1C;AAAA,EACF;AACA,EAAA,IAAI,CAAC,IAAA,EAAM,MAAM,IAAI,MAAM,wFAAwF,CAAA;AAEnH,EAAA,MAAM,GAAA,GAAM,IAAA;AACZ,EAAA,MAAM,IAAA,GAAkB,CAAC,QAAA,KAAa,OAAA,CAAQ,IAAI,QAAA,CAAS,GAAA,CAAI,CAAC,IAAA,KAAS,IAAI,IAAA,CAAK,GAAA,CAAI,MAAM,CAAC,CAAC,CAAC,CAAA;AAC/F,EAAA,OAAOA,kCAAA,CAAiB,EAAE,IAAA,EAAM,MAAA,EAAQ,CAAA;AAC1C","file":"redis.cjs","sourcesContent":["import type { StatusStore } from \"../store\";\nimport { createRedisStore, type RedisExec } from \"./redis-core\";\n\n/** ioredis: `client.call(\"GET\", \"key\")` */\ntype CallClient = { call: (command: string, ...args: Array<string | number>) => Promise<unknown> };\n/** node-redis: `client.sendCommand([\"GET\", \"key\"])` */\ntype SendCommandClient = { sendCommand: (args: string[]) => Promise<unknown> };\n\nexport type RedisStoreOptions = {\n  /** An ioredis or node-redis client you created and connected */\n  client?: CallClient | SendCommandClient;\n  /** Or any function that sends one raw command, for other clients */\n  command?: (args: string[]) => Promise<unknown>;\n  /** Prefix of every key (default \"sermon\"): lets several status pages share one database */\n  prefix?: string;\n};\n\n/**\n * Store on any Redis-compatible server (Redis, Valkey, KeyDB, Dragonfly…), using the client\n * you already have:\n *\n * ```ts\n * redisStore({ client: new Redis(process.env.REDIS_URL) })          // ioredis\n * redisStore({ client: await createClient({ url }).connect() })     // node-redis\n * ```\n */\nexport function redisStore({ client, command, prefix }: RedisStoreOptions): StatusStore {\n  let send = command;\n  if (!send && client) {\n    if (\"call\" in client && typeof client.call === \"function\") {\n      send = ([name, ...args]) => client.call(name as string, ...(args as string[]));\n    } else if (\"sendCommand\" in client && typeof client.sendCommand === \"function\") {\n      send = (args) => client.sendCommand(args);\n    }\n  }\n  if (!send) throw new Error(\"sermon-js: redisStore needs a `client` (ioredis or node-redis) or a `command` function\");\n\n  const run = send;\n  const exec: RedisExec = (commands) => Promise.all(commands.map((args) => run(args.map(String))));\n  return createRedisStore({ exec, prefix });\n}\n"]}