next-observer 0.3.22 → 0.3.24

package/README.md

@@ -142,12 +142,61 @@ export default [
 Tools: `get_services`, `get_operation_stats`, `compare_versions`, `get_errors`, `search_traces`, `get_trace`.
 `next-observer` validates the file and lists the loaded specialists on start.
 
+## Scheduled checks
+
+Put `observe.checks.ts` (or `.mts`, `.js`, `.mjs`) in the app root to have the observer ask the app on a timer: is it
+up, is it fast enough, does it still refuse what it must refuse. The file is plain data — no imports:
+
+```ts
+export default [
+  { name: 'catalog answers fast', url: '/api/products', expect: { status: 200, maxMs: 300 } },
+  { name: 'home page shows the shop', url: '/', expect: { bodyIncludes: 'Porto Shop' } },
+  { name: 'guests cannot see orders', url: '/api/orders', expect: { status: [401, 403] } },
+  { name: 'checkout refuses a bad quantity', url: '/api/checkout', method: 'POST', body: { quantity: 99 }, expect: { status: 400 } },
+]
+```
+
+| Field | Default | |
+|---|---|---|
+| `name` | — | unique in the file |
+| `url` | — | a path (sent to the app) or a full `http(s)` URL |
+| `method`, `headers`, `body` | `GET` | a `body` that is not a string is sent as JSON |
+| `everySeconds` | `60` | at least 5 |
+| `timeoutMs` | `10000` | no answer within it is a failure |
+| `expect.status` | any 2xx | one status or a list; redirects are not followed — a 302 is an answer |
+| `expect.maxMs` | — | the whole answer, body included |
+| `expect.bodyIncludes` | — | text the body must contain |
+
+Paths go to `OBSERVE_APP_URL`; without it, to the host and port `next dev` was given (`-H`, `-p`, `PORT`), else
+`http://localhost:3000`. That is a guess: when the port is busy, `next dev` moves to the next free one — compare the
+address in the observer's banner with the one Next prints, and set `OBSERVE_APP_URL` if they differ.
+
+- Every request carries the header `x-observe-check` (the check's name, URL-encoded) and a trace id of its own, so each
+  result links to the trace the app recorded for it.
+- These requests are not traffic for the anomaly detector: an expected refusal is not an error, and a quiet app stays quiet.
+- While the app is still starting (it has not answered yet, first minute), a refused connection is not a failure — the
+  check is tried again every 5 s.
+- A body is read only when `maxMs` or `bodyIncludes` asks about it, and then its first megabyte; an event stream is
+  never read. So the status of a streaming route can be checked.
+- A field that is misspelled, or an expectation that can never hold (a body text on `HEAD`), is an error on start.
+
+Results: `GET /api/checks` — the last 50 per check and how many failed in a row.
+
+**When a check keeps failing, the AI agents look into it on their own** — the same way as with an anomaly in real
+traffic: it appears in the chat, and the investigation starts from the trace of the failing request.
+
+- twice in a row → `critical` (it is down now);
+- 3 of the last 10 runs → `warning` (it is unreliable — a check failing every third time never fails twice in a row);
+- one failure is not an anomaly: the first answer after a restart is often just slow;
+- the same check is reported once in 5 minutes; `OBSERVE_DETECTOR=off` switches this off too.
+
 ## Configuration
 
 | Variable | Default | |
 |---|---|---|
 | `OBSERVE_AI` | `mock` | `mock` \| `real` |
 | `OBSERVE_DETECTOR` | on | `off` disables the anomaly detector |
+| `OBSERVE_APP_URL` | `http://localhost:3000` | where the checks from `observe.checks.ts` are sent |
 | `OBSERVE_MODEL_TIMEOUT_MS` | `90000` | how long one model call may take before it is started again |
 | `OBSERVE_API_KEY` | — | require `x-api-key` on ingest (`/v1/traces`) |
 | `OBSERVE_UI_PASSWORD` | — | require a password for the UI, the query API and the chat (browser login, any user name) |

package/dist/checks/runner.d.ts

@@ -0,0 +1,91 @@
+import type { Check } from './spec.js';
+export interface CheckResult {
+    atMs: number;
+    ok: boolean;
+    durationMs: number;
+    /** Absent when no answer came at all. */
+    status?: number;
+    /** The trace id sent with the request. */
+    traceId: string;
+    /** Why it failed, in words; absent when ok. */
+    reason?: string;
+}
+export interface CheckStatus {
+    name: string;
+    method: string;
+    /** Where the request really goes. */
+    url: string;
+    everySeconds: number;
+    expect: Check['expect'];
+    /** Failed runs in a row up to now; 0 when the last run passed or nothing ran yet. */
+    failures: number;
+    last?: CheckResult;
+    /** Oldest first. */
+    history: CheckResult[];
+}
+export interface CheckRunnerOptions {
+    checks: Check[];
+    /** Where checks with a path go, e.g. http://localhost:3000. */
+    baseUrl: string;
+    fetch?: typeof fetch;
+    /** Wall clock, for `atMs`. */
+    now?: () => number;
+    /** A clock that never jumps (NTP, sleep), for durations. Default performance.now. */
+    elapsed?: () => number;
+    /** Results kept per check. Default 50. */
+    history?: number;
+    /** The first run of every check waits this long (the app may still be starting). Default 3 s. */
+    firstDelayMs?: number;
+    /**
+     * While the app has not answered yet, a refused connection to it within this time of start() is not a result:
+     * `next dev` is still starting. After it, "nobody is listening" is exactly what a check is for. Default 60 s.
+     */
+    startupGraceMs?: number;
+    /** A run that met the starting app is tried again this soon, whatever the check's interval. Default 5 s. */
+    startupRetryMs?: number;
+    onResult?: (check: Check, result: CheckResult, failures: number) => void;
+}
+/** Marks the request as the observer's own (the value is the check's name, URL-encoded: header values are ASCII). */
+export declare const CHECK_HEADER = "x-observe-check";
+/** As much of a body as is read: enough for `bodyIncludes`, and a large download is not buffered every minute. */
+export declare const MAX_BODY_BYTES = 1000000;
+export declare class CheckRunner {
+    private readonly options;
+    readonly baseUrl: string;
+    private readonly checks;
+    private readonly fetch;
+    private readonly now;
+    private readonly elapsed;
+    private readonly keep;
+    private readonly firstDelayMs;
+    private readonly startupGraceMs;
+    private readonly startupRetryMs;
+    private readonly results;
+    /** Failed runs in a row per check — counted, not derived from the kept history, which is cut at `keep`. */
+    private readonly streak;
+    private readonly traces;
+    private running;
+    private inFlight;
+    private timers;
+    /** Changes on every start()/stop(): a run from an earlier one must not report into this one. */
+    private generation;
+    /** On the `elapsed` clock: a wall clock stepping back would keep the grace time open for ever. */
+    private startedAt;
+    /** The app itself (a check with a path) has answered since start(). */
+    private appAnswered;
+    constructor(options: CheckRunnerOptions);
+    /** Was this trace started by one of our own requests? Their spans are not real traffic. */
+    isCheckTrace(traceId: string): boolean;
+    urlOf(check: Check): string;
+    /**
+     * One request, judged. Never throws: a failed request is a result. Resolves with `undefined` when there is nothing
+     * to report — the runner was stopped meanwhile, or the app has not started listening yet (see startupGraceMs).
+     */
+    run(check: Check): Promise<CheckResult | undefined>;
+    private attempt;
+    /** Starts the timers. A check whose previous run is still waiting for its answer is skipped, not stacked. */
+    start(): void;
+    /** Stops the timers and drops the requests on their way: nothing is recorded or reported after this. */
+    stop(): void;
+    list(): CheckStatus[];
+}

package/dist/checks/runner.js

@@ -0,0 +1,239 @@
+// Runs the checks from observe.checks.ts on their timers and keeps the latest results. Each request carries a trace
+// id of its own (traceparent), so a result links to the trace the app recorded for exactly that request.
+import { randomBytes } from 'node:crypto';
+/** Marks the request as the observer's own (the value is the check's name, URL-encoded: header values are ASCII). */
+export const CHECK_HEADER = 'x-observe-check';
+/** As much of a body as is read: enough for `bodyIncludes`, and a large download is not buffered every minute. */
+export const MAX_BODY_BYTES = 1_000_000;
+/** Trace ids of recent check requests that are remembered, to tell their spans from real traffic. */
+const REMEMBERED_TRACES = 5000;
+const STREAM = /text\/event-stream/i;
+/**
+ * The body as text, up to MAX_BODY_BYTES (`cut` says whether more was left). Not read at all when nobody asked about
+ * it (`wanted` false) or when it is an event stream, which never ends.
+ */
+async function readBody(response, wanted) {
+    if (!response.body)
+        return { text: '', cut: false, read: true };
+    if (!wanted || STREAM.test(response.headers.get('content-type') ?? '')) {
+        await response.body.cancel().catch(() => { });
+        return { text: '', cut: false, read: false };
+    }
+    const reader = response.body.getReader();
+    const chunks = [];
+    let size = 0;
+    let cut = false;
+    for (;;) {
+        const { done, value } = await reader.read();
+        if (done)
+            break;
+        chunks.push(value);
+        size += value.byteLength;
+        if (size >= MAX_BODY_BYTES) {
+            cut = true;
+            await reader.cancel().catch(() => { });
+            break;
+        }
+    }
+    return { text: Buffer.concat(chunks).subarray(0, MAX_BODY_BYTES).toString('utf8'), cut, read: true };
+}
+/** What run() gives the timer when the app is not listening yet: try again soon. */
+const STARTING = Symbol('starting');
+export class CheckRunner {
+    options;
+    baseUrl;
+    checks;
+    fetch;
+    now;
+    elapsed;
+    keep;
+    firstDelayMs;
+    startupGraceMs;
+    startupRetryMs;
+    results = new Map();
+    /** Failed runs in a row per check — counted, not derived from the kept history, which is cut at `keep`. */
+    streak = new Map();
+    traces = new Set();
+    running = new Set();
+    inFlight = new Set();
+    timers = [];
+    /** Changes on every start()/stop(): a run from an earlier one must not report into this one. */
+    generation = 0;
+    /** On the `elapsed` clock: a wall clock stepping back would keep the grace time open for ever. */
+    startedAt = null;
+    /** The app itself (a check with a path) has answered since start(). */
+    appAnswered = false;
+    constructor(options) {
+        this.options = options;
+        this.checks = options.checks;
+        this.baseUrl = options.baseUrl.replace(/\/+$/, '');
+        this.fetch = options.fetch ?? globalThis.fetch;
+        this.now = options.now ?? Date.now;
+        this.elapsed = options.elapsed ?? (() => performance.now());
+        this.keep = Math.max(1, options.history ?? 50);
+        this.firstDelayMs = options.firstDelayMs ?? 3000;
+        this.startupGraceMs = options.startupGraceMs ?? 60_000;
+        this.startupRetryMs = options.startupRetryMs ?? 5000;
+    }
+    /** Was this trace started by one of our own requests? Their spans are not real traffic. */
+    isCheckTrace(traceId) {
+        return this.traces.has(traceId);
+    }
+    urlOf(check) {
+        return check.url.startsWith('/') ? `${this.baseUrl}${check.url}` : check.url;
+    }
+    /**
+     * One request, judged. Never throws: a failed request is a result. Resolves with `undefined` when there is nothing
+     * to report — the runner was stopped meanwhile, or the app has not started listening yet (see startupGraceMs).
+     */
+    async run(check) {
+        const result = await this.attempt(check);
+        return result === STARTING ? undefined : result;
+    }
+    async attempt(check) {
+        const own = check.url.startsWith('/');
+        const generation = this.generation;
+        const traceId = randomBytes(16).toString('hex');
+        this.traces.add(traceId);
+        if (this.traces.size > REMEMBERED_TRACES)
+            this.traces.delete(this.traces.values().next().value);
+        const atMs = this.now();
+        const started = this.elapsed();
+        const controller = new AbortController();
+        this.inFlight.add(controller);
+        let timedOut = false;
+        const timer = setTimeout(() => {
+            timedOut = true;
+            controller.abort();
+        }, check.timeoutMs);
+        let result;
+        try {
+            const response = await this.fetch(this.urlOf(check), {
+                method: check.method,
+                // Ours last: a check cannot switch off its own trace link or mark.
+                headers: { ...check.headers, traceparent: `00-${traceId}-${randomBytes(8).toString('hex')}-01`, [CHECK_HEADER]: encodeURIComponent(check.name) },
+                body: check.body,
+                // A redirect is an answer ("anonymous visitors are sent to /login"), not something to follow.
+                redirect: 'manual',
+                signal: controller.signal,
+            });
+            if (own)
+                this.appAnswered = true;
+            const e = check.expect;
+            // The status is known from here on: a body that never finishes must not turn it into "no answer".
+            let body;
+            try {
+                body = await readBody(response, e.bodyIncludes !== undefined || e.maxMs !== undefined);
+            }
+            catch (error) {
+                if (!timedOut)
+                    throw error;
+            }
+            const durationMs = this.elapsed() - started;
+            const reasons = [];
+            if (e.status ? !e.status.includes(response.status) : response.status < 200 || response.status > 299) {
+                reasons.push(`expected status ${e.status ? e.status.join(' or ') : '2xx'}, got ${response.status}`);
+            }
+            if (e.maxMs !== undefined && durationMs > e.maxMs)
+                reasons.push(`took ${Math.round(durationMs)} ms, limit ${e.maxMs} ms`);
+            if (!body)
+                reasons.push(`the body did not finish within ${check.timeoutMs} ms`);
+            else if (e.bodyIncludes !== undefined && !body.text.includes(e.bodyIncludes)) {
+                const where = !body.read ? ' (an event stream is not read)' : body.cut ? ' in its first megabyte (the rest is not read)' : '';
+                reasons.push(`body does not contain ${JSON.stringify(e.bodyIncludes)}${where}`);
+            }
+            result = { atMs, ok: reasons.length === 0, durationMs, status: response.status, traceId, ...(reasons.length ? { reason: reasons.join('; ') } : {}) };
+        }
+        catch (error) {
+            const durationMs = this.elapsed() - started;
+            const cause = error?.cause;
+            // Only the app's own checks, only "nobody is listening": a wrong host name or a certificate error is news at once.
+            const starting = own && cause?.code === 'ECONNREFUSED' && !this.appAnswered && this.startedAt !== null && started - this.startedAt < this.startupGraceMs;
+            if (starting)
+                return generation === this.generation ? STARTING : undefined;
+            const reason = timedOut ? `no answer within ${check.timeoutMs} ms` : `request failed: ${cause?.code ?? cause?.message ?? error?.message ?? String(error)}`;
+            result = { atMs, ok: false, durationMs, traceId, reason };
+        }
+        finally {
+            clearTimeout(timer);
+            this.inFlight.delete(controller);
+        }
+        if (generation !== this.generation)
+            return undefined;
+        const list = this.results.get(check.name) ?? [];
+        list.push(result);
+        if (list.length > this.keep)
+            list.splice(0, list.length - this.keep);
+        this.results.set(check.name, list);
+        const failures = result.ok ? 0 : (this.streak.get(check.name) ?? 0) + 1;
+        this.streak.set(check.name, failures);
+        try {
+            this.options.onResult?.(check, result, failures);
+        }
+        catch {
+            // A listener's problem must not stop the checks.
+        }
+        return result;
+    }
+    /** Starts the timers. A check whose previous run is still waiting for its answer is skipped, not stacked. */
+    start() {
+        this.stop();
+        this.startedAt = this.elapsed();
+        this.appAnswered = false;
+        const generation = this.generation;
+        // This start's own set: a run left over from an earlier start must not hold back the first tick of this one.
+        const running = this.running;
+        for (const check of this.checks) {
+            let retryPending = false;
+            const tick = () => {
+                if (running.has(check.name))
+                    return;
+                running.add(check.name);
+                void this.attempt(check)
+                    .then((result) => {
+                    // The app is not up yet: do not make a check with a long interval wait a whole interval for its first
+                    // result. One retry at a time — the interval's own ticks must not each start a chain of them.
+                    if (result !== STARTING || generation !== this.generation || retryPending)
+                        return;
+                    retryPending = true;
+                    const retry = setTimeout(() => {
+                        retryPending = false;
+                        tick();
+                    }, this.startupRetryMs);
+                    retry.unref?.();
+                    this.timers.push(retry);
+                })
+                    .finally(() => running.delete(check.name));
+            };
+            const first = setTimeout(() => {
+                tick();
+                const every = setInterval(tick, check.everyMs);
+                every.unref?.();
+                this.timers.push(every);
+            }, Math.min(this.firstDelayMs, check.everyMs));
+            first.unref?.();
+            this.timers.push(first);
+        }
+    }
+    /** Stops the timers and drops the requests on their way: nothing is recorded or reported after this. */
+    stop() {
+        this.generation++;
+        // clearTimeout also clears an interval.
+        for (const timer of this.timers)
+            clearTimeout(timer);
+        this.timers = [];
+        for (const controller of this.inFlight)
+            controller.abort();
+        this.inFlight = new Set();
+        this.running = new Set();
+        this.startedAt = null;
+    }
+    list() {
+        return this.checks.map((check) => {
+            const history = this.results.get(check.name) ?? [];
+            const last = history.at(-1);
+            return { name: check.name, method: check.method, url: this.urlOf(check), everySeconds: check.everyMs / 1000, expect: check.expect, failures: this.streak.get(check.name) ?? 0, ...(last ? { last } : {}), history: [...history] };
+        });
+    }
+}
+//# sourceMappingURL=runner.js.map

package/dist/checks/runner.js.map

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

package/dist/checks/spec.d.ts

@@ -0,0 +1,47 @@
+export interface CheckExpect {
+    /** The status (or any of several) that counts as good. Default: any 2xx. */
+    status?: number | number[];
+    /** The answer, body included (its first megabyte), must arrive within this many ms. */
+    maxMs?: number;
+    /** Text the body must contain. */
+    bodyIncludes?: string;
+}
+export interface CheckSpec {
+    /** Shown in the UI and in anomalies; unique in the file. */
+    name: string;
+    /** A path ("/api/products") — sent to the app — or a full http(s) URL. */
+    url: string;
+    /** Default GET. */
+    method?: string;
+    headers?: Record<string, string>;
+    /** A string is sent as is; anything else as JSON. */
+    body?: unknown;
+    /** Default 60, at least 5. */
+    everySeconds?: number;
+    /** Default 10 000. */
+    timeoutMs?: number;
+    expect?: CheckExpect;
+}
+/** A validated check with the defaults filled in. */
+export interface Check {
+    name: string;
+    url: string;
+    method: string;
+    headers: Record<string, string>;
+    body?: string;
+    everyMs: number;
+    timeoutMs: number;
+    expect: {
+        status?: number[];
+        maxMs?: number;
+        bodyIncludes?: string;
+    };
+}
+export declare const CHECK_DEFAULTS: {
+    everySeconds: number;
+    timeoutMs: number;
+};
+/** Throws with a message that names the check and the field. */
+export declare function validateCheck(raw: unknown): Check;
+/** Validates the whole file's export; names must be unique — results are kept by name. */
+export declare function validateChecks(exported: unknown): Check[];

package/dist/checks/spec.js

@@ -0,0 +1,117 @@
+// Scheduled checks: the app's observe.checks.ts lists requests the observer sends on a timer and what a good answer
+// looks like — is the app up, is it fast enough, does it still refuse what it must refuse. Plain data, no functions and
+// no imports: the file is read by the observer, never by the app.
+export const CHECK_DEFAULTS = { everySeconds: 60, timeoutMs: 10_000 };
+const METHODS = ['GET', 'HEAD', 'POST', 'PUT', 'PATCH', 'DELETE', 'OPTIONS'];
+const KEYS = ['name', 'url', 'method', 'headers', 'body', 'everySeconds', 'timeoutMs', 'expect'];
+const EXPECT_KEYS = ['status', 'maxMs', 'bodyIncludes'];
+/** Statuses whose answer never has a body. */
+const NO_BODY = [204, 205, 304];
+const isRecord = (v) => typeof v === 'object' && v !== null && !Array.isArray(v);
+/** A key nobody reads is a silent typo ("expects", "maxMS") — the check would pass forever. */
+function unknownKey(value, known) {
+    return Object.keys(value).find((key) => !known.includes(key));
+}
+function numberIn(value, min, max) {
+    return typeof value === 'number' && Number.isFinite(value) && value >= min && value <= max;
+}
+/** Throws with a message that names the check and the field. */
+export function validateCheck(raw) {
+    if (!isRecord(raw))
+        throw new Error('a check must be an object like { name, url, expect }');
+    const name = raw.name;
+    if (typeof name !== 'string' || name.trim() === '' || name.length > 80)
+        throw new Error('a check needs a `name` (1–80 characters)');
+    const fail = (message) => {
+        throw new Error(`check "${name}": ${message}`);
+    };
+    const stray = unknownKey(raw, KEYS);
+    if (stray)
+        fail(`unknown field \`${stray}\` (known: ${KEYS.join(', ')})`);
+    const url = raw.url;
+    if (typeof url !== 'string' || !(url.startsWith('/') || /^https?:\/\//i.test(url)))
+        fail('`url` must be a path starting with "/" or a full http(s) URL');
+    if (typeof url === 'string' && !url.startsWith('/') && !URL.canParse(url))
+        fail(`\`url\` is not a valid URL: ${url}`);
+    const method = raw.method === undefined ? 'GET' : typeof raw.method === 'string' ? raw.method.toUpperCase() : '';
+    if (!METHODS.includes(method))
+        fail(`\`method\` must be one of ${METHODS.join(', ')}`);
+    const headers = {};
+    if (raw.headers !== undefined) {
+        if (!isRecord(raw.headers))
+            fail('`headers` must be an object of strings');
+        for (const [key, value] of Object.entries(raw.headers)) {
+            if (typeof value !== 'string')
+                fail(`header \`${key}\` must be a string`);
+            headers[key.toLowerCase()] = value;
+        }
+    }
+    let body;
+    if (raw.body !== undefined) {
+        if (method === 'GET' || method === 'HEAD')
+            fail(`a ${method} request cannot have a \`body\``);
+        if (typeof raw.body === 'string')
+            body = raw.body;
+        else {
+            // A function or a symbol gives undefined, a BigInt or a cycle throws — neither is a body anyone meant to send.
+            try {
+                body = JSON.stringify(raw.body);
+            }
+            catch {
+                body = undefined;
+            }
+            if (body === undefined)
+                fail('`body` cannot be sent as JSON — use plain data or a string');
+            headers['content-type'] ??= 'application/json';
+        }
+    }
+    const everySeconds = raw.everySeconds ?? CHECK_DEFAULTS.everySeconds;
+    if (!numberIn(everySeconds, 5, 86_400))
+        fail('`everySeconds` must be a number from 5 to 86400');
+    const timeoutMs = raw.timeoutMs ?? CHECK_DEFAULTS.timeoutMs;
+    if (!numberIn(timeoutMs, 100, 120_000))
+        fail('`timeoutMs` must be a number from 100 to 120000');
+    const expect = {};
+    if (raw.expect !== undefined) {
+        const e = raw.expect;
+        if (!isRecord(e))
+            return fail('`expect` must be an object like { status: 200, maxMs: 500 }');
+        const strayExpect = unknownKey(e, EXPECT_KEYS);
+        if (strayExpect)
+            fail(`unknown field \`expect.${strayExpect}\` (known: ${EXPECT_KEYS.join(', ')})`);
+        if (e.status !== undefined) {
+            const list = Array.isArray(e.status) ? e.status : [e.status];
+            if (list.length === 0 || !list.every((s) => Number.isInteger(s) && numberIn(s, 100, 599)))
+                fail('`expect.status` must be a status code (100–599) or a list of them');
+            expect.status = list;
+        }
+        if (e.maxMs !== undefined) {
+            if (!numberIn(e.maxMs, 1, 120_000))
+                fail('`expect.maxMs` must be a number from 1 to 120000');
+            expect.maxMs = e.maxMs;
+        }
+        if (e.bodyIncludes !== undefined) {
+            if (typeof e.bodyIncludes !== 'string' || e.bodyIncludes === '')
+                fail('`expect.bodyIncludes` must be a non-empty string');
+            // An answer without a body can never contain it: the check would fail forever.
+            if (method === 'HEAD')
+                fail('`expect.bodyIncludes` cannot be used with HEAD — the answer has no body');
+            if (expect.status?.every((s) => NO_BODY.includes(s)))
+                fail(`\`expect.bodyIncludes\` cannot be used with status ${expect.status.join(' or ')} — the answer has no body`);
+            expect.bodyIncludes = e.bodyIncludes;
+        }
+    }
+    return { name, url: url, method, headers, ...(body === undefined ? {} : { body }), everyMs: everySeconds * 1000, timeoutMs: timeoutMs, expect };
+}
+/** Validates the whole file's export; names must be unique — results are kept by name. */
+export function validateChecks(exported) {
+    if (!Array.isArray(exported))
+        throw new Error('export default an array of checks: [{ name, url, expect }]');
+    const checks = exported.map(validateCheck);
+    const names = checks.map((c) => c.name);
+    const duplicate = names.find((name, i) => names.indexOf(name) !== i);
+    if (duplicate)
+        throw new Error(`check "${duplicate}" is defined twice`);
+    return checks;
+}
+//# sourceMappingURL=spec.js.map

package/dist/checks/spec.js.map

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

package/dist/checks/watch.d.ts

@@ -0,0 +1,25 @@
+import type { Anomaly } from '../debug/detector.js';
+import type { CheckResult } from './runner.js';
+import type { Check } from './spec.js';
+export interface CheckWatchOptions {
+    /** Failed runs in a row that make an anomaly. Default 2. */
+    failuresInRow?: number;
+    /** How many of the latest runs the share rule looks at. Default 10. */
+    shareWindow?: number;
+    /** Failed runs among them that make an anomaly — a check failing every third time never fails twice in a row. Default 3. */
+    shareFailures?: number;
+    /** The same check is not reported again within this time. Default 5 min, like the detector. */
+    cooldownMs?: number;
+}
+export declare class CheckWatch {
+    readonly options: Required<CheckWatchOptions>;
+    private readonly recent;
+    private readonly lastReportedMs;
+    private pending;
+    private seq;
+    constructor(options?: CheckWatchOptions);
+    /** The runner's `onResult`. */
+    observe: (check: Check, result: CheckResult, failures: number, url?: string) => void;
+    /** New anomalies since the last call. */
+    take(): Anomaly[];
+}