@growth-labs/monitoring 0.1.0

package/CHANGELOG.md

@@ -0,0 +1,9 @@
+# @growth-labs/monitoring
+
+## 0.1.0 - 2026-05-18
+
+- Added synthetic prober factory with GET, POST, and code-signin happy-path runners.
+- Added Tail Worker trace categorization, redaction, fingerprinting, sampling, D1 persistence, and WAE writes.
+- Added alerting thresholds, incident dedup/open/close helpers, and escalation actions that delegate delivery to `@growth-labs/notify`.
+- Added D1 SQL migrations plus matching Drizzle schema for uptime checks, incidents, and error events.
+- Added Astro status-page integration, query helpers, read-only HTML view, and `/api/status.json`.

package/README.md

@@ -0,0 +1,115 @@
+# @growth-labs/monitoring
+
+Operational observability for Growth Labs Cloudflare Workers: synthetic probes,
+Tail Worker error capture, uptime/error schemas, alerting, and a small public
+status page.
+
+## Install
+
+```bash
+pnpm add @growth-labs/monitoring @growth-labs/notify @growth-labs/analytics
+```
+
+Peer: `astro ^6.0.0` for the status-page app. Runtime deps:
+`@growth-labs/notify`, `@growth-labs/analytics`, `drizzle-orm`, `zod`.
+
+## Modules
+
+| Subpath | Purpose |
+| --- | --- |
+| `@growth-labs/monitoring` | Umbrella exports for the main factories. |
+| `@growth-labs/monitoring/prober` | `createProber(config)` for Cron Workers that run GET, POST, and happy-path checks. |
+| `@growth-labs/monitoring/tail` | `createTailWorker(config)` for Cloudflare Tail Worker trace batches. |
+| `@growth-labs/monitoring/alerting` | Threshold, dedup, incident, escalation, and notify delegation helpers. |
+| `@growth-labs/monitoring/status-page` | Astro integration that injects the status page and JSON route. |
+| `@growth-labs/monitoring/schemas` | Drizzle schema matching the shipped D1 migrations. |
+
+Raw SQL migrations ship at:
+
+```text
+node_modules/@growth-labs/monitoring/src/schemas/migrations
+node_modules/@growth-labs/monitoring/dist/schemas/migrations
+```
+
+## Prober
+
+```ts
+import { createProber } from '@growth-labs/monitoring/prober'
+
+const prober = createProber({
+	realmId: 'fulcrum-labs',
+	d1Binding: 'MONITORING_DB',
+	notifyConfig: {
+		channels: ['slack', 'email'],
+		emailProvider: 'resend',
+	},
+	alertingConfig: { consecutiveFailuresToOpen: 2, minSeverity: 'warning' },
+	surfaces: [
+		{
+			name: 'fronts.co:login',
+			kind: 'get',
+			schedule: '*/5 * * * *',
+			url: 'https://fronts.co/login/',
+			assertions: { statusCode: 200, contentMarker: 'auth-eyebrow' },
+			timeoutMs: 10_000,
+		},
+	],
+})
+
+export default { scheduled: prober.scheduledHandler }
+```
+
+`auth-monitor` must use `emailProvider: 'resend'` when email alerts are enabled.
+The monitor exists partly to detect Cloudflare auth delivery failures, so alert
+email must not depend on Cloudflare Email.
+
+## Tail Worker
+
+```ts
+import { createTailWorker } from '@growth-labs/monitoring/tail'
+
+const tail = createTailWorker({
+	realmId: 'fulcrum-labs',
+	d1Binding: 'MONITORING_DB',
+	waeBinding: 'MONITORING_ERRORS',
+	notifyConfig: { channels: ['slack', 'email'], emailProvider: 'resend' },
+	alertingConfig: {
+		newErrorDedupWindowMs: 60 * 60 * 1000,
+		rateSpikeThreshold: 10,
+		rateSpikeWindowMs: 5 * 60 * 1000,
+	},
+	sampling: {
+		exceptionsPct: 1,
+		fivexxPct: 1,
+		consoleErrorPct: 1,
+		consoleWarnPct: 0.1,
+		slowRequestsPct: 0.01,
+		slowRequestThresholdMs: 1000,
+	},
+})
+
+export default { tail: tail.tailHandler }
+```
+
+Fingerprints are computed before redaction. Every persisted error is redacted
+and truncated before D1/WAE writes.
+
+## Status Page
+
+```ts
+import { createStatusPageApp } from '@growth-labs/monitoring/status-page'
+
+export default {
+	integrations: [
+		createStatusPageApp({
+			realm: 'fulcrum-labs',
+			d1Binding: 'MONITORING_DB',
+			surfaces: [{ name: 'fronts.co:login' }],
+		}),
+	],
+}
+```
+
+The status page is read-only. It injects `/` and `/api/status.json` by default
+and reads only the `gl_uptime_checks`, `gl_uptime_incidents`, and `gl_errors`
+tables.

package/SPEC.md

@@ -0,0 +1,19 @@
+# @growth-labs/monitoring v0.1.0 Spec
+
+This package implements the operational observability contract for
+`growth-labs/monitoring-platform`.
+
+Included modules:
+
+- Synthetic prober Cron Worker helpers for GET, POST, and code-signin happy paths.
+- Tail Worker error capture for exceptions, 5xx responses, console errors/warnings, and slow requests.
+- D1 schemas for `gl_uptime_checks`, `gl_uptime_incidents`, and `gl_errors`.
+- Alerting thresholds, dedup, incident lifecycle, and escalation actions.
+- Read-only Astro status page and JSON snapshot route.
+
+Out of scope:
+
+- Surface ownership. Consumers pass surface lists in config.
+- Scheduling ownership. Cloudflare Cron triggers invoke the exported handler.
+- Notification transport implementation. `@growth-labs/notify` sends alerts.
+- Active remediation or historical replay.

package/dist/alerting/dedup.d.ts

@@ -0,0 +1,6 @@
+import { type IdFactory, type UptimeIncident } from '../types.js';
+import type { AlertAction } from './index.js';
+export declare function isIncidentOpen(surface: string, db: D1Database): Promise<UptimeIncident | null>;
+export declare function openIncident(action: AlertAction, db: D1Database, idFactory?: IdFactory, now?: () => number): Promise<string>;
+export declare function closeIncident(incidentId: string, resolveCheckId: string, db: D1Database, now?: () => number): Promise<void>;
+//# sourceMappingURL=dedup.d.ts.map

package/dist/alerting/dedup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dedup.d.ts","sourceRoot":"","sources":["../../src/alerting/dedup.ts"],"names":[],"mappings":"AAAA,OAAO,EAA4B,KAAK,SAAS,EAAE,KAAK,cAAc,EAAE,MAAM,aAAa,CAAA;AAC3F,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAA;AAE7C,wBAAsB,cAAc,CACnC,OAAO,EAAE,MAAM,EACf,EAAE,EAAE,UAAU,GACZ,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC,CAWhC;AAED,wBAAsB,YAAY,CACjC,MAAM,EAAE,WAAW,EACnB,EAAE,EAAE,UAAU,EACd,SAAS,GAAE,SAAsB,EACjC,GAAG,eAAW,GACZ,OAAO,CAAC,MAAM,CAAC,CAyBjB;AAED,wBAAsB,aAAa,CAClC,UAAU,EAAE,MAAM,EAClB,cAAc,EAAE,MAAM,EACtB,EAAE,EAAE,UAAU,EACd,GAAG,eAAW,GACZ,OAAO,CAAC,IAAI,CAAC,CAaf"}

package/dist/alerting/dedup.js

@@ -0,0 +1,49 @@
+import { errorMessage, generateId } from '../types.js';
+export async function isIncidentOpen(surface, db) {
+    return db
+        .prepare(`
+			SELECT id, surface, opened_at, closed_at, trigger_check_id, resolve_check_id, severity, notes
+			FROM gl_uptime_incidents
+			WHERE surface = ? AND closed_at IS NULL
+			ORDER BY opened_at DESC
+			LIMIT 1
+		`)
+        .bind(surface)
+        .first();
+}
+export async function openIncident(action, db, idFactory = generateId, now = Date.now) {
+    const existing = await isIncidentOpen(action.surface, db);
+    if (existing)
+        return existing.id;
+    const id = idFactory();
+    try {
+        await db
+            .prepare(`
+				INSERT INTO gl_uptime_incidents
+					(id, surface, opened_at, trigger_check_id, severity, notes)
+				VALUES (?, ?, ?, ?, ?, ?)
+			`)
+            .bind(id, action.surface, Math.floor(now() / 1000), typeof action.payload?.triggerCheckId === 'string' ? action.payload.triggerCheckId : null, action.severity === 'critical' ? 'critical' : 'warning', typeof action.payload?.notes === 'string' ? action.payload.notes : null)
+            .run();
+    }
+    catch (error) {
+        console.error(`[monitoring] failed to open incident ${action.surface}: ${errorMessage(error)}`);
+    }
+    return id;
+}
+export async function closeIncident(incidentId, resolveCheckId, db, now = Date.now) {
+    try {
+        await db
+            .prepare(`
+				UPDATE gl_uptime_incidents
+				SET closed_at = ?, resolve_check_id = ?
+				WHERE id = ? AND closed_at IS NULL
+			`)
+            .bind(Math.floor(now() / 1000), resolveCheckId, incidentId)
+            .run();
+    }
+    catch (error) {
+        console.error(`[monitoring] failed to close incident ${incidentId}: ${errorMessage(error)}`);
+    }
+}
+//# sourceMappingURL=dedup.js.map

package/dist/alerting/dedup.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dedup.js","sourceRoot":"","sources":["../../src/alerting/dedup.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,UAAU,EAAuC,MAAM,aAAa,CAAA;AAG3F,MAAM,CAAC,KAAK,UAAU,cAAc,CACnC,OAAe,EACf,EAAc;IAEd,OAAO,EAAE;SACP,OAAO,CAAC;;;;;;GAMR,CAAC;SACD,IAAI,CAAC,OAAO,CAAC;SACb,KAAK,EAAkB,CAAA;AAC1B,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,YAAY,CACjC,MAAmB,EACnB,EAAc,EACd,YAAuB,UAAU,EACjC,GAAG,GAAG,IAAI,CAAC,GAAG;IAEd,MAAM,QAAQ,GAAG,MAAM,cAAc,CAAC,MAAM,CAAC,OAAO,EAAE,EAAE,CAAC,CAAA;IACzD,IAAI,QAAQ;QAAE,OAAO,QAAQ,CAAC,EAAE,CAAA;IAEhC,MAAM,EAAE,GAAG,SAAS,EAAE,CAAA;IACtB,IAAI,CAAC;QACJ,MAAM,EAAE;aACN,OAAO,CAAC;;;;IAIR,CAAC;aACD,IAAI,CACJ,EAAE,EACF,MAAM,CAAC,OAAO,EACd,IAAI,CAAC,KAAK,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,EACxB,OAAO,MAAM,CAAC,OAAO,EAAE,cAAc,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,cAAc,CAAC,CAAC,CAAC,IAAI,EACzF,MAAM,CAAC,QAAQ,KAAK,UAAU,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,SAAS,EACvD,OAAO,MAAM,CAAC,OAAO,EAAE,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CACvE;aACA,GAAG,EAAE,CAAA;IACR,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QAChB,OAAO,CAAC,KAAK,CAAC,wCAAwC,MAAM,CAAC,OAAO,KAAK,YAAY,CAAC,KAAK,CAAC,EAAE,CAAC,CAAA;IAChG,CAAC;IACD,OAAO,EAAE,CAAA;AACV,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,aAAa,CAClC,UAAkB,EAClB,cAAsB,EACtB,EAAc,EACd,GAAG,GAAG,IAAI,CAAC,GAAG;IAEd,IAAI,CAAC;QACJ,MAAM,EAAE;aACN,OAAO,CAAC;;;;IAIR,CAAC;aACD,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,EAAE,cAAc,EAAE,UAAU,CAAC;aAC1D,GAAG,EAAE,CAAA;IACR,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QAChB,OAAO,CAAC,KAAK,CAAC,yCAAyC,UAAU,KAAK,YAAY,CAAC,KAAK,CAAC,EAAE,CAAC,CAAA;IAC7F,CAAC;AACF,CAAC"}

package/dist/alerting/escalation.d.ts

@@ -0,0 +1,4 @@
+import type { UptimeIncident } from '../types.js';
+import type { AlertAction } from './index.js';
+export declare function evaluateEscalation(incident: UptimeIncident, nowSeconds?: number, alreadySent?: Set<string>): AlertAction | null;
+//# sourceMappingURL=escalation.d.ts.map

package/dist/alerting/escalation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"escalation.d.ts","sourceRoot":"","sources":["../../src/alerting/escalation.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAA;AACjD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAA;AAE7C,wBAAgB,kBAAkB,CACjC,QAAQ,EAAE,cAAc,EACxB,UAAU,SAAgC,EAC1C,WAAW,GAAE,GAAG,CAAC,MAAM,CAAa,GAClC,WAAW,GAAG,IAAI,CAqBpB"}

package/dist/alerting/escalation.js

@@ -0,0 +1,26 @@
+export function evaluateEscalation(incident, nowSeconds = Math.floor(Date.now() / 1000), alreadySent = new Set()) {
+    if (incident.closed_at !== null)
+        return null;
+    const ageSeconds = nowSeconds - incident.opened_at;
+    const checkpoints = [
+        { key: '24h', seconds: 24 * 60 * 60, severity: 'critical' },
+        { key: '4h', seconds: 4 * 60 * 60, severity: 'critical' },
+        { key: '30m', seconds: 30 * 60, severity: 'critical' },
+    ];
+    const checkpoint = checkpoints.find((item) => ageSeconds >= item.seconds);
+    if (!checkpoint)
+        return null;
+    const dedupKey = `escalation:${incident.id}:${checkpoint.key}`;
+    if (alreadySent.has(dedupKey))
+        return null;
+    return {
+        kind: 'escalation',
+        surface: incident.surface,
+        severity: checkpoint.severity,
+        title: `${incident.surface} incident still open`,
+        body: `Incident ${incident.id} has been open for ${checkpoint.key}.`,
+        dedupKey,
+        payload: { incidentId: incident.id, checkpoint: checkpoint.key },
+    };
+}
+//# sourceMappingURL=escalation.js.map

package/dist/alerting/escalation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"escalation.js","sourceRoot":"","sources":["../../src/alerting/escalation.ts"],"names":[],"mappings":"AAGA,MAAM,UAAU,kBAAkB,CACjC,QAAwB,EACxB,UAAU,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,EAC1C,cAA2B,IAAI,GAAG,EAAE;IAEpC,IAAI,QAAQ,CAAC,SAAS,KAAK,IAAI;QAAE,OAAO,IAAI,CAAA;IAC5C,MAAM,UAAU,GAAG,UAAU,GAAG,QAAQ,CAAC,SAAS,CAAA;IAClD,MAAM,WAAW,GAAG;QACnB,EAAE,GAAG,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE,GAAG,EAAE,GAAG,EAAE,EAAE,QAAQ,EAAE,UAAmB,EAAE;QACpE,EAAE,GAAG,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,GAAG,EAAE,GAAG,EAAE,EAAE,QAAQ,EAAE,UAAmB,EAAE;QAClE,EAAE,GAAG,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE,GAAG,EAAE,EAAE,QAAQ,EAAE,UAAmB,EAAE;KAC/D,CAAA;IACD,MAAM,UAAU,GAAG,WAAW,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,UAAU,IAAI,IAAI,CAAC,OAAO,CAAC,CAAA;IACzE,IAAI,CAAC,UAAU;QAAE,OAAO,IAAI,CAAA;IAC5B,MAAM,QAAQ,GAAG,cAAc,QAAQ,CAAC,EAAE,IAAI,UAAU,CAAC,GAAG,EAAE,CAAA;IAC9D,IAAI,WAAW,CAAC,GAAG,CAAC,QAAQ,CAAC;QAAE,OAAO,IAAI,CAAA;IAC1C,OAAO;QACN,IAAI,EAAE,YAAY;QAClB,OAAO,EAAE,QAAQ,CAAC,OAAO;QACzB,QAAQ,EAAE,UAAU,CAAC,QAAQ;QAC7B,KAAK,EAAE,GAAG,QAAQ,CAAC,OAAO,sBAAsB;QAChD,IAAI,EAAE,YAAY,QAAQ,CAAC,EAAE,sBAAsB,UAAU,CAAC,GAAG,GAAG;QACpE,QAAQ;QACR,OAAO,EAAE,EAAE,UAAU,EAAE,QAAQ,CAAC,EAAE,EAAE,UAAU,EAAE,UAAU,CAAC,GAAG,EAAE;KAChE,CAAA;AACF,CAAC"}

package/dist/alerting/index.d.ts

@@ -0,0 +1,31 @@
+import { type NotifyResult } from '@growth-labs/notify';
+import type { CategorizedEvent } from '../tail/categorize.js';
+import type { AlertSeverity, NotifyConfig, PersistedCheckResult, ThresholdConfig } from '../types.js';
+export type AlertKind = 'open-incident' | 'close-incident' | 'rate-spike' | 'new-error' | 'escalation';
+export interface AlertAction {
+    kind: AlertKind;
+    surface: string;
+    severity: AlertSeverity;
+    title: string;
+    body: string;
+    dedupKey: string;
+    payload?: Record<string, unknown>;
+}
+export interface AlertEngine {
+    activeIncidentSurfaces: Set<string>;
+    handleProbeResult(result: PersistedCheckResult, surfaceName: string, db: D1Database, env: Record<string, unknown>): Promise<AlertAction | null>;
+    handleErrorEvent(event: CategorizedEvent & {
+        fingerprint: string;
+    }, db: D1Database, env: Record<string, unknown>): Promise<AlertAction | null>;
+    send(env: Record<string, unknown>, action: AlertAction): Promise<NotifyResult>;
+}
+export interface AlerterConfig {
+    notifyConfig: NotifyConfig;
+    alertingConfig?: ThresholdConfig;
+    notifyFn?: (env: Record<string, unknown>, action: AlertAction) => Promise<NotifyResult>;
+}
+export declare function createAlerter(config: AlerterConfig): AlertEngine;
+export { closeIncident, isIncidentOpen, openIncident } from './dedup.js';
+export { evaluateEscalation } from './escalation.js';
+export { evaluateError, evaluateProbe } from './thresholds.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/alerting/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/alerting/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAkB,KAAK,YAAY,EAAU,MAAM,qBAAqB,CAAA;AAC/E,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAA;AAC7D,OAAO,KAAK,EACX,aAAa,EACb,YAAY,EACZ,oBAAoB,EACpB,eAAe,EACf,MAAM,aAAa,CAAA;AAIpB,MAAM,MAAM,SAAS,GAClB,eAAe,GACf,gBAAgB,GAChB,YAAY,GACZ,WAAW,GACX,YAAY,CAAA;AAEf,MAAM,WAAW,WAAW;IAC3B,IAAI,EAAE,SAAS,CAAA;IACf,OAAO,EAAE,MAAM,CAAA;IACf,QAAQ,EAAE,aAAa,CAAA;IACvB,KAAK,EAAE,MAAM,CAAA;IACb,IAAI,EAAE,MAAM,CAAA;IACZ,QAAQ,EAAE,MAAM,CAAA;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CACjC;AAED,MAAM,WAAW,WAAW;IAC3B,sBAAsB,EAAE,GAAG,CAAC,MAAM,CAAC,CAAA;IACnC,iBAAiB,CAChB,MAAM,EAAE,oBAAoB,EAC5B,WAAW,EAAE,MAAM,EACnB,EAAE,EAAE,UAAU,EACd,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC1B,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC,CAAA;IAC9B,gBAAgB,CACf,KAAK,EAAE,gBAAgB,GAAG;QAAE,WAAW,EAAE,MAAM,CAAA;KAAE,EACjD,EAAE,EAAE,UAAU,EACd,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC1B,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC,CAAA;IAC9B,IAAI,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,EAAE,WAAW,GAAG,OAAO,CAAC,YAAY,CAAC,CAAA;CAC9E;AAED,MAAM,WAAW,aAAa;IAC7B,YAAY,EAAE,YAAY,CAAA;IAC1B,cAAc,CAAC,EAAE,eAAe,CAAA;IAChC,QAAQ,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,EAAE,WAAW,KAAK,OAAO,CAAC,YAAY,CAAC,CAAA;CACvF;AAED,wBAAgB,aAAa,CAAC,MAAM,EAAE,aAAa,GAAG,WAAW,CAwChE;AAED,OAAO,EAAE,aAAa,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,YAAY,CAAA;AACxE,OAAO,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAA;AACpD,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAA"}

package/dist/alerting/index.js

@@ -0,0 +1,50 @@
+import { notify } from '@growth-labs/notify';
+import { closeIncident, openIncident } from './dedup.js';
+import { evaluateError, evaluateProbe } from './thresholds.js';
+export function createAlerter(config) {
+    const activeIncidentSurfaces = new Set();
+    const thresholds = config.alertingConfig ?? {};
+    async function send(env, action) {
+        if (config.notifyFn)
+            return config.notifyFn(env, action);
+        return notify(env, {
+            ...config.notifyConfig,
+            severity: action.severity,
+            title: action.title,
+            body: action.body,
+            dedupKey: action.dedupKey,
+        });
+    }
+    return {
+        activeIncidentSurfaces,
+        async handleProbeResult(result, surfaceName, db, env) {
+            const action = await evaluateProbe(result, surfaceName, db, thresholds);
+            if (!action)
+                return null;
+            if (action.kind === 'open-incident') {
+                await openIncident(action, db);
+                activeIncidentSurfaces.add(action.surface);
+            }
+            if (action.kind === 'close-incident' && typeof action.payload?.incidentId === 'string') {
+                await closeIncident(action.payload.incidentId, result.id, db);
+                activeIncidentSurfaces.delete(action.surface);
+            }
+            await send(env, action);
+            return action;
+        },
+        async handleErrorEvent(event, db, env) {
+            const action = await evaluateError(event, db, thresholds);
+            if (!action)
+                return null;
+            if (action.kind === 'rate-spike')
+                activeIncidentSurfaces.add(action.surface);
+            await send(env, action);
+            return action;
+        },
+        send,
+    };
+}
+export { closeIncident, isIncidentOpen, openIncident } from './dedup.js';
+export { evaluateEscalation } from './escalation.js';
+export { evaluateError, evaluateProbe } from './thresholds.js';
+//# sourceMappingURL=index.js.map

package/dist/alerting/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/alerting/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAqC,MAAM,EAAE,MAAM,qBAAqB,CAAA;AAQ/E,OAAO,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,YAAY,CAAA;AACxD,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAA;AAyC9D,MAAM,UAAU,aAAa,CAAC,MAAqB;IAClD,MAAM,sBAAsB,GAAG,IAAI,GAAG,EAAU,CAAA;IAChD,MAAM,UAAU,GAAG,MAAM,CAAC,cAAc,IAAI,EAAE,CAAA;IAE9C,KAAK,UAAU,IAAI,CAAC,GAA4B,EAAE,MAAmB;QACpE,IAAI,MAAM,CAAC,QAAQ;YAAE,OAAO,MAAM,CAAC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC,CAAA;QACxD,OAAO,MAAM,CAAC,GAAgB,EAAE;YAC/B,GAAG,MAAM,CAAC,YAAY;YACtB,QAAQ,EAAE,MAAM,CAAC,QAAQ;YACzB,KAAK,EAAE,MAAM,CAAC,KAAK;YACnB,IAAI,EAAE,MAAM,CAAC,IAAI;YACjB,QAAQ,EAAE,MAAM,CAAC,QAAQ;SACzB,CAAC,CAAA;IACH,CAAC;IAED,OAAO;QACN,sBAAsB;QACtB,KAAK,CAAC,iBAAiB,CAAC,MAAM,EAAE,WAAW,EAAE,EAAE,EAAE,GAAG;YACnD,MAAM,MAAM,GAAG,MAAM,aAAa,CAAC,MAAM,EAAE,WAAW,EAAE,EAAE,EAAE,UAAU,CAAC,CAAA;YACvE,IAAI,CAAC,MAAM;gBAAE,OAAO,IAAI,CAAA;YACxB,IAAI,MAAM,CAAC,IAAI,KAAK,eAAe,EAAE,CAAC;gBACrC,MAAM,YAAY,CAAC,MAAM,EAAE,EAAE,CAAC,CAAA;gBAC9B,sBAAsB,CAAC,GAAG,CAAC,MAAM,CAAC,OAAO,CAAC,CAAA;YAC3C,CAAC;YACD,IAAI,MAAM,CAAC,IAAI,KAAK,gBAAgB,IAAI,OAAO,MAAM,CAAC,OAAO,EAAE,UAAU,KAAK,QAAQ,EAAE,CAAC;gBACxF,MAAM,aAAa,CAAC,MAAM,CAAC,OAAO,CAAC,UAAU,EAAE,MAAM,CAAC,EAAE,EAAE,EAAE,CAAC,CAAA;gBAC7D,sBAAsB,CAAC,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAA;YAC9C,CAAC;YACD,MAAM,IAAI,CAAC,GAAG,EAAE,MAAM,CAAC,CAAA;YACvB,OAAO,MAAM,CAAA;QACd,CAAC;QACD,KAAK,CAAC,gBAAgB,CAAC,KAAK,EAAE,EAAE,EAAE,GAAG;YACpC,MAAM,MAAM,GAAG,MAAM,aAAa,CAAC,KAAK,EAAE,EAAE,EAAE,UAAU,CAAC,CAAA;YACzD,IAAI,CAAC,MAAM;gBAAE,OAAO,IAAI,CAAA;YACxB,IAAI,MAAM,CAAC,IAAI,KAAK,YAAY;gBAAE,sBAAsB,CAAC,GAAG,CAAC,MAAM,CAAC,OAAO,CAAC,CAAA;YAC5E,MAAM,IAAI,CAAC,GAAG,EAAE,MAAM,CAAC,CAAA;YACvB,OAAO,MAAM,CAAA;QACd,CAAC;QACD,IAAI;KACJ,CAAA;AACF,CAAC;AAED,OAAO,EAAE,aAAa,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,YAAY,CAAA;AACxE,OAAO,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAA;AACpD,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAA"}

package/dist/alerting/thresholds.d.ts

@@ -0,0 +1,8 @@
+import type { CategorizedEvent } from '../tail/categorize.js';
+import type { CheckResult, ThresholdConfig } from '../types.js';
+import type { AlertAction } from './index.js';
+export declare function evaluateProbe(result: CheckResult, surfaceName: string, db: D1Database, config?: ThresholdConfig): Promise<AlertAction | null>;
+export declare function evaluateError(event: CategorizedEvent & {
+    fingerprint: string;
+}, db: D1Database, config?: ThresholdConfig): Promise<AlertAction | null>;
+//# sourceMappingURL=thresholds.d.ts.map

package/dist/alerting/thresholds.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"thresholds.d.ts","sourceRoot":"","sources":["../../src/alerting/thresholds.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAA;AAC7D,OAAO,KAAK,EAAE,WAAW,EAAE,eAAe,EAAkB,MAAM,aAAa,CAAA;AAE/E,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAA;AAkB7C,wBAAsB,aAAa,CAClC,MAAM,EAAE,WAAW,EACnB,WAAW,EAAE,MAAM,EACnB,EAAE,EAAE,UAAU,EACd,MAAM,GAAE,eAAoB,GAC1B,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC,CA8B7B;AAED,wBAAsB,aAAa,CAClC,KAAK,EAAE,gBAAgB,GAAG;IAAE,WAAW,EAAE,MAAM,CAAA;CAAE,EACjD,EAAE,EAAE,UAAU,EACd,MAAM,GAAE,eAAoB,GAC1B,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC,CA2C7B"}

package/dist/alerting/thresholds.js

@@ -0,0 +1,105 @@
+import { isIncidentOpen } from './dedup.js';
+const DEFAULT_FAILURES_TO_OPEN = 2;
+const DEFAULT_SUCCESSES_TO_CLOSE = 1;
+const DEFAULT_DEDUP_WINDOW_MS = 60 * 60 * 1000;
+const DEFAULT_RATE_SPIKE_THRESHOLD = 10;
+const DEFAULT_RATE_SPIKE_WINDOW_MS = 5 * 60 * 1000;
+export async function evaluateProbe(result, surfaceName, db, config = {}) {
+    const open = await isIncidentOpen(surfaceName, db);
+    if (result.status === 'pass') {
+        if (!open)
+            return null;
+        const successesToClose = config.consecutiveSuccessesToClose ?? DEFAULT_SUCCESSES_TO_CLOSE;
+        const recent = await recentChecks(db, surfaceName, successesToClose);
+        if (recent.length >= successesToClose && recent.every((row) => row.status === 'pass')) {
+            return closeIncidentAction(open, result);
+        }
+        return null;
+    }
+    if (open)
+        return null;
+    const failuresToOpen = config.consecutiveFailuresToOpen ?? DEFAULT_FAILURES_TO_OPEN;
+    const recent = await recentChecks(db, surfaceName, failuresToOpen);
+    if (recent.length < failuresToOpen)
+        return null;
+    if (!recent.every((row) => row.status !== 'pass'))
+        return null;
+    const severity = config.minSeverity ?? 'warning';
+    return {
+        kind: 'open-incident',
+        surface: surfaceName,
+        severity,
+        title: `${surfaceName} synthetic check failing`,
+        body: `${failuresToOpen} consecutive synthetic checks failed. Latest status: ${result.status}${result.errorMessage ? ` (${result.errorMessage})` : ''}.`,
+        dedupKey: `incident:${surfaceName}`,
+        payload: { triggerCheckId: result.id },
+    };
+}
+export async function evaluateError(event, db, config = {}) {
+    const occurredAtSeconds = Math.floor(event.occurredAt / 1000);
+    const rateWindowMs = config.rateSpikeWindowMs ?? DEFAULT_RATE_SPIKE_WINDOW_MS;
+    const rateSpikeThreshold = config.rateSpikeThreshold ?? DEFAULT_RATE_SPIKE_THRESHOLD;
+    const rateCount = await countFingerprintSince(db, event.fingerprint, occurredAtSeconds - Math.floor(rateWindowMs / 1000));
+    if (rateCount >= rateSpikeThreshold) {
+        return {
+            kind: 'rate-spike',
+            surface: event.surface,
+            severity: 'critical',
+            title: `${event.surface} error rate spike`,
+            body: `${rateCount} events with fingerprint ${event.fingerprint} occurred in the last ${Math.round(rateWindowMs / 60_000)} minutes.`,
+            dedupKey: `rate-spike:${event.surface}:${event.fingerprint}`,
+            payload: { fingerprint: event.fingerprint, count: rateCount },
+        };
+    }
+    const dedupWindowMs = config.newErrorDedupWindowMs ?? DEFAULT_DEDUP_WINDOW_MS;
+    const dedupCount = await countFingerprintSince(db, event.fingerprint, occurredAtSeconds - Math.floor(dedupWindowMs / 1000));
+    if (dedupCount > 0)
+        return null;
+    return {
+        kind: 'new-error',
+        surface: event.surface,
+        severity: event.category === 'console-warn' || event.category === 'slow-request'
+            ? 'warning'
+            : 'critical',
+        title: `${event.surface} new error fingerprint`,
+        body: `${event.category} fingerprint ${event.fingerprint}: ${event.message}`,
+        dedupKey: `new-error:${event.fingerprint}`,
+        payload: { fingerprint: event.fingerprint, category: event.category },
+    };
+}
+async function recentChecks(db, surface, limit) {
+    const { results } = await db
+        .prepare(`
+			SELECT id, status, checked_at
+			FROM gl_uptime_checks
+			WHERE surface = ?
+			ORDER BY checked_at DESC
+			LIMIT ?
+		`)
+        .bind(surface, limit)
+        .all();
+    return results ?? [];
+}
+async function countFingerprintSince(db, fingerprint, since) {
+    const row = await db
+        .prepare(`
+			SELECT COUNT(*) AS count
+			FROM gl_errors
+			WHERE fingerprint = ? AND occurred_at >= ?
+		`)
+        .bind(fingerprint, since)
+        .first();
+    return Number(row?.count ?? 0);
+}
+function closeIncidentAction(open, result) {
+    return {
+        kind: 'close-incident',
+        surface: open.surface,
+        severity: 'info',
+        title: `${open.surface} recovered`,
+        body: `Synthetic check ${result.id ?? 'unknown'} passed and closed incident ${open.id}.`,
+        dedupKey: `incident-closed:${open.id}`,
+        payload: { incidentId: open.id, resolveCheckId: result.id },
+    };
+}
+//# sourceMappingURL=thresholds.js.map

package/dist/alerting/thresholds.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,10 @@
+export type { AlertAction, AlertEngine, AlertKind } from './alerting/index.js';
+export { createAlerter } from './alerting/index.js';
+export type { ProberConfig } from './prober/index.js';
+export { createProber } from './prober/index.js';
+export type { StatusPageAppConfig } from './status-page/app.js';
+export { createStatusPageApp } from './status-page/app.js';
+export type { TailWorkerConfig } from './tail/index.js';
+export { createTailWorker } from './tail/index.js';
+export type { AlertSeverity, CheckResult, CheckStatus, CheckType, ErrorRollup, ErrorSeverity, NotifyConfig, PersistedCheckResult, SamplingConfig, StatusPageConfig, SurfaceStatus, ThresholdConfig, UptimeIncident, } from './types.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,WAAW,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAA;AAC9E,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAA;AACnD,YAAY,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAA;AACrD,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAA;AAChD,YAAY,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAA;AAC/D,OAAO,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAA;AAC1D,YAAY,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAA;AACvD,OAAO,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAA;AAClD,YAAY,EACX,aAAa,EACb,WAAW,EACX,WAAW,EACX,SAAS,EACT,WAAW,EACX,aAAa,EACb,YAAY,EACZ,oBAAoB,EACpB,cAAc,EACd,gBAAgB,EAChB,aAAa,EACb,eAAe,EACf,cAAc,GACd,MAAM,YAAY,CAAA"}

package/dist/index.js

@@ -0,0 +1,5 @@
+export { createAlerter } from './alerting/index.js';
+export { createProber } from './prober/index.js';
+export { createStatusPageApp } from './status-page/app.js';
+export { createTailWorker } from './tail/index.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAA;AAEnD,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAA;AAEhD,OAAO,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAA;AAE1D,OAAO,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAA"}

package/dist/prober/index.d.ts

@@ -0,0 +1,19 @@
+import type { ExecutionContextLike, NotifyConfig, ProbeAlertingConfig, ScheduledEventLike } from '../types.js';
+import type { SurfaceConfig } from './surfaces.js';
+export interface ProberConfig {
+    realmId: string;
+    d1Binding: string;
+    notifyConfig: NotifyConfig;
+    alertingConfig?: ProbeAlertingConfig;
+    surfaces: SurfaceConfig[];
+}
+export declare function createProber(config: ProberConfig): {
+    scheduledHandler: (event: ScheduledEventLike, env: Record<string, unknown>, ctx: ExecutionContextLike) => Promise<void>;
+    checkSurface: (surface: SurfaceConfig, env: Record<string, unknown>) => Promise<void>;
+};
+export { persistCheckResult } from './persist.js';
+export { runGet } from './runners/get-runner.js';
+export { extractCodeFromMessage, runHappyPath } from './runners/happy-path-runner.js';
+export { runPost } from './runners/post-runner.js';
+export type { CodeSigninHappyPathConfig, GetSurface, GmailPollingConfig, HappyPathSurface, PostSurface, SurfaceConfig, } from './surfaces.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/prober/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/prober/index.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACX,oBAAoB,EACpB,YAAY,EACZ,mBAAmB,EACnB,kBAAkB,EAClB,MAAM,aAAa,CAAA;AAMpB,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,eAAe,CAAA;AAElD,MAAM,WAAW,YAAY;IAC5B,OAAO,EAAE,MAAM,CAAA;IACf,SAAS,EAAE,MAAM,CAAA;IACjB,YAAY,EAAE,YAAY,CAAA;IAC1B,cAAc,CAAC,EAAE,mBAAmB,CAAA;IACpC,QAAQ,EAAE,aAAa,EAAE,CAAA;CACzB;AAED,wBAAgB,YAAY,CAAC,MAAM,EAAE,YAAY;8BAwBxC,kBAAkB,OACpB,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,OACvB,oBAAoB,KACvB,OAAO,CAAC,IAAI,CAAC;4BArBqB,aAAa,OAAO,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAG,OAAO,CAAC,IAAI,CAAC;EA8BhG;AAaD,OAAO,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAA;AACjD,OAAO,EAAE,MAAM,EAAE,MAAM,yBAAyB,CAAA;AAChD,OAAO,EAAE,sBAAsB,EAAE,YAAY,EAAE,MAAM,gCAAgC,CAAA;AACrF,OAAO,EAAE,OAAO,EAAE,MAAM,0BAA0B,CAAA;AAClD,YAAY,EACX,yBAAyB,EACzB,UAAU,EACV,kBAAkB,EAClB,gBAAgB,EAChB,WAAW,EACX,aAAa,GACb,MAAM,eAAe,CAAA"}

package/dist/prober/index.js

@@ -0,0 +1,48 @@
+import { createAlerter } from '../alerting/index.js';
+import { errorMessage } from '../types.js';
+import { persistCheckResult } from './persist.js';
+import { runGet } from './runners/get-runner.js';
+import { runHappyPath } from './runners/happy-path-runner.js';
+import { runPost } from './runners/post-runner.js';
+export function createProber(config) {
+    const alerter = createAlerter({
+        notifyConfig: config.notifyConfig,
+        alertingConfig: config.alertingConfig,
+    });
+    async function checkSurface(surface, env) {
+        const db = env[config.d1Binding];
+        try {
+            const result = await runSurface(surface, env);
+            if (!db) {
+                console.error(`[monitoring] missing D1 binding env.${config.d1Binding}`);
+                return;
+            }
+            const persisted = await persistCheckResult(db, surface, result);
+            await alerter.handleProbeResult(persisted, surface.name, db, env);
+        }
+        catch (error) {
+            console.error(`[monitoring] synthetic check failed for ${surface.name}: ${errorMessage(error)}`);
+        }
+    }
+    async function scheduledHandler(event, env, ctx) {
+        for (const surface of config.surfaces.filter((candidate) => candidate.schedule === event.cron)) {
+            ctx.waitUntil(checkSurface(surface, env));
+        }
+    }
+    return { scheduledHandler, checkSurface };
+}
+async function runSurface(surface, env) {
+    switch (surface.kind) {
+        case 'get':
+            return runGet(surface);
+        case 'post':
+            return runPost(surface);
+        case 'happy_path':
+            return runHappyPath(surface, { env });
+    }
+}
+export { persistCheckResult } from './persist.js';
+export { runGet } from './runners/get-runner.js';
+export { extractCodeFromMessage, runHappyPath } from './runners/happy-path-runner.js';
+export { runPost } from './runners/post-runner.js';
+//# sourceMappingURL=index.js.map

package/dist/prober/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/prober/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAA;AAOpD,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AAC1C,OAAO,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAA;AACjD,OAAO,EAAE,MAAM,EAAE,MAAM,yBAAyB,CAAA;AAChD,OAAO,EAAyB,YAAY,EAAE,MAAM,gCAAgC,CAAA;AACpF,OAAO,EAAE,OAAO,EAAE,MAAM,0BAA0B,CAAA;AAWlD,MAAM,UAAU,YAAY,CAAC,MAAoB;IAChD,MAAM,OAAO,GAAG,aAAa,CAAC;QAC7B,YAAY,EAAE,MAAM,CAAC,YAAY;QACjC,cAAc,EAAE,MAAM,CAAC,cAAc;KACrC,CAAC,CAAA;IAEF,KAAK,UAAU,YAAY,CAAC,OAAsB,EAAE,GAA4B;QAC/E,MAAM,EAAE,GAAG,GAAG,CAAC,MAAM,CAAC,SAAS,CAA2B,CAAA;QAC1D,IAAI,CAAC;YACJ,MAAM,MAAM,GAAG,MAAM,UAAU,CAAC,OAAO,EAAE,GAAG,CAAC,CAAA;YAC7C,IAAI,CAAC,EAAE,EAAE,CAAC;gBACT,OAAO,CAAC,KAAK,CAAC,uCAAuC,MAAM,CAAC,SAAS,EAAE,CAAC,CAAA;gBACxE,OAAM;YACP,CAAC;YACD,MAAM,SAAS,GAAG,MAAM,kBAAkB,CAAC,EAAE,EAAE,OAAO,EAAE,MAAM,CAAC,CAAA;YAC/D,MAAM,OAAO,CAAC,iBAAiB,CAAC,SAAS,EAAE,OAAO,CAAC,IAAI,EAAE,EAAE,EAAE,GAAG,CAAC,CAAA;QAClE,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YAChB,OAAO,CAAC,KAAK,CACZ,2CAA2C,OAAO,CAAC,IAAI,KAAK,YAAY,CAAC,KAAK,CAAC,EAAE,CACjF,CAAA;QACF,CAAC;IACF,CAAC;IAED,KAAK,UAAU,gBAAgB,CAC9B,KAAyB,EACzB,GAA4B,EAC5B,GAAyB;QAEzB,KAAK,MAAM,OAAO,IAAI,MAAM,CAAC,QAAQ,CAAC,MAAM,CAC3C,CAAC,SAAS,EAAE,EAAE,CAAC,SAAS,CAAC,QAAQ,KAAK,KAAK,CAAC,IAAI,CAChD,EAAE,CAAC;YACH,GAAG,CAAC,SAAS,CAAC,YAAY,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC,CAAA;QAC1C,CAAC;IACF,CAAC;IAED,OAAO,EAAE,gBAAgB,EAAE,YAAY,EAAE,CAAA;AAC1C,CAAC;AAED,KAAK,UAAU,UAAU,CAAC,OAAsB,EAAE,GAA4B;IAC7E,QAAQ,OAAO,CAAC,IAAI,EAAE,CAAC;QACtB,KAAK,KAAK;YACT,OAAO,MAAM,CAAC,OAAO,CAAC,CAAA;QACvB,KAAK,MAAM;YACV,OAAO,OAAO,CAAC,OAAO,CAAC,CAAA;QACxB,KAAK,YAAY;YAChB,OAAO,YAAY,CAAC,OAAO,EAAE,EAAE,GAAG,EAA6B,CAAC,CAAA;IAClE,CAAC;AACF,CAAC;AAED,OAAO,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAA;AACjD,OAAO,EAAE,MAAM,EAAE,MAAM,yBAAyB,CAAA;AAChD,OAAO,EAAE,sBAAsB,EAAE,YAAY,EAAE,MAAM,gCAAgC,CAAA;AACrF,OAAO,EAAE,OAAO,EAAE,MAAM,0BAA0B,CAAA"}

package/dist/prober/persist.d.ts

@@ -0,0 +1,4 @@
+import { type CheckResult, type IdFactory, type PersistedCheckResult } from '../types.js';
+import type { SurfaceConfig } from './surfaces.js';
+export declare function persistCheckResult(db: D1Database, surface: SurfaceConfig, result: CheckResult, idFactory?: IdFactory, now?: () => number): Promise<PersistedCheckResult>;
+//# sourceMappingURL=persist.d.ts.map

package/dist/prober/persist.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"persist.d.ts","sourceRoot":"","sources":["../../src/prober/persist.ts"],"names":[],"mappings":"AAAA,OAAO,EACN,KAAK,WAAW,EAGhB,KAAK,SAAS,EACd,KAAK,oBAAoB,EACzB,MAAM,aAAa,CAAA;AACpB,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,eAAe,CAAA;AAElD,wBAAsB,kBAAkB,CACvC,EAAE,EAAE,UAAU,EACd,OAAO,EAAE,aAAa,EACtB,MAAM,EAAE,WAAW,EACnB,SAAS,GAAE,SAAsB,EACjC,GAAG,eAAW,GACZ,OAAO,CAAC,oBAAoB,CAAC,CA8B/B"}

package/dist/prober/persist.js

@@ -0,0 +1,21 @@
+import { errorMessage, generateId, } from '../types.js';
+export async function persistCheckResult(db, surface, result, idFactory = generateId, now = Date.now) {
+    const id = result.id ?? idFactory();
+    const checkedAt = result.checkedAt ?? Math.floor(now() / 1000);
+    const persisted = { ...result, id, checkedAt };
+    try {
+        await db
+            .prepare(`
+				INSERT INTO gl_uptime_checks
+					(id, surface, check_type, status, status_code, latency_ms, error_message, checked_at)
+				VALUES (?, ?, ?, ?, ?, ?, ?, ?)
+			`)
+            .bind(id, surface.name, surface.kind, result.status, result.statusCode ?? null, result.latencyMs, result.errorMessage ?? null, checkedAt)
+            .run();
+    }
+    catch (error) {
+        console.error(`[monitoring] failed to persist uptime check ${surface.name}: ${errorMessage(error)}`);
+    }
+    return persisted;
+}
+//# sourceMappingURL=persist.js.map

package/dist/prober/persist.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"persist.js","sourceRoot":"","sources":["../../src/prober/persist.ts"],"names":[],"mappings":"AAAA,OAAO,EAEN,YAAY,EACZ,UAAU,GAGV,MAAM,aAAa,CAAA;AAGpB,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACvC,EAAc,EACd,OAAsB,EACtB,MAAmB,EACnB,YAAuB,UAAU,EACjC,GAAG,GAAG,IAAI,CAAC,GAAG;IAEd,MAAM,EAAE,GAAG,MAAM,CAAC,EAAE,IAAI,SAAS,EAAE,CAAA;IACnC,MAAM,SAAS,GAAG,MAAM,CAAC,SAAS,IAAI,IAAI,CAAC,KAAK,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,CAAA;IAC9D,MAAM,SAAS,GAAyB,EAAE,GAAG,MAAM,EAAE,EAAE,EAAE,SAAS,EAAE,CAAA;IAEpE,IAAI,CAAC;QACJ,MAAM,EAAE;aACN,OAAO,CAAC;;;;IAIR,CAAC;aACD,IAAI,CACJ,EAAE,EACF,OAAO,CAAC,IAAI,EACZ,OAAO,CAAC,IAAI,EACZ,MAAM,CAAC,MAAM,EACb,MAAM,CAAC,UAAU,IAAI,IAAI,EACzB,MAAM,CAAC,SAAS,EAChB,MAAM,CAAC,YAAY,IAAI,IAAI,EAC3B,SAAS,CACT;aACA,GAAG,EAAE,CAAA;IACR,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QAChB,OAAO,CAAC,KAAK,CACZ,+CAA+C,OAAO,CAAC,IAAI,KAAK,YAAY,CAAC,KAAK,CAAC,EAAE,CACrF,CAAA;IACF,CAAC;IAED,OAAO,SAAS,CAAA;AACjB,CAAC"}

package/dist/prober/runners/get-runner.d.ts

@@ -0,0 +1,4 @@
+import { type CheckResult, type RuntimeFetch } from '../../types.js';
+import type { GetSurface } from '../surfaces.js';
+export declare function runGet(surface: GetSurface, runtime?: RuntimeFetch): Promise<CheckResult>;
+//# sourceMappingURL=get-runner.d.ts.map

package/dist/prober/runners/get-runner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-runner.d.ts","sourceRoot":"","sources":["../../../src/prober/runners/get-runner.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,WAAW,EAAkC,KAAK,YAAY,EAAE,MAAM,gBAAgB,CAAA;AACpG,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAA;AAEhD,wBAAsB,MAAM,CAC3B,OAAO,EAAE,UAAU,EACnB,OAAO,GAAE,YAAiB,GACxB,OAAO,CAAC,WAAW,CAAC,CA0CtB"}