@growth-labs/monitoring 0.1.0

package/dist/tail/sample.d.ts

@@ -0,0 +1,9 @@
+import type { SamplingConfig } from '../types.js';
+import type { ErrorCategory } from './categorize.js';
+interface SamplingOptions {
+    surface?: string;
+    activeIncidentSurfaces?: Set<string>;
+}
+export declare function shouldKeep(category: ErrorCategory, config: SamplingConfig, options?: SamplingOptions): boolean;
+export {};
+//# sourceMappingURL=sample.d.ts.map

package/dist/tail/sample.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sample.d.ts","sourceRoot":"","sources":["../../src/tail/sample.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAA;AACjD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAA;AAEpD,UAAU,eAAe;IACxB,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,sBAAsB,CAAC,EAAE,GAAG,CAAC,MAAM,CAAC,CAAA;CACpC;AAED,wBAAgB,UAAU,CACzB,QAAQ,EAAE,aAAa,EACvB,MAAM,EAAE,cAAc,EACtB,OAAO,GAAE,eAAoB,GAC3B,OAAO,CAMT"}

package/dist/tail/sample.js

@@ -0,0 +1,25 @@
+export function shouldKeep(category, config, options = {}) {
+    if (options.surface && options.activeIncidentSurfaces?.has(options.surface))
+        return true;
+    const pct = pctForCategory(category, config);
+    if (pct >= 1)
+        return true;
+    if (pct <= 0)
+        return false;
+    return Math.random() < pct;
+}
+function pctForCategory(category, config) {
+    switch (category) {
+        case 'exception':
+            return config.exceptionsPct;
+        case 'fivexx':
+            return config.fivexxPct;
+        case 'console-error':
+            return config.consoleErrorPct;
+        case 'console-warn':
+            return config.consoleWarnPct;
+        case 'slow-request':
+            return config.slowRequestsPct;
+    }
+}
+//# sourceMappingURL=sample.js.map

package/dist/tail/sample.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sample.js","sourceRoot":"","sources":["../../src/tail/sample.ts"],"names":[],"mappings":"AAQA,MAAM,UAAU,UAAU,CACzB,QAAuB,EACvB,MAAsB,EACtB,UAA2B,EAAE;IAE7B,IAAI,OAAO,CAAC,OAAO,IAAI,OAAO,CAAC,sBAAsB,EAAE,GAAG,CAAC,OAAO,CAAC,OAAO,CAAC;QAAE,OAAO,IAAI,CAAA;IACxF,MAAM,GAAG,GAAG,cAAc,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAA;IAC5C,IAAI,GAAG,IAAI,CAAC;QAAE,OAAO,IAAI,CAAA;IACzB,IAAI,GAAG,IAAI,CAAC;QAAE,OAAO,KAAK,CAAA;IAC1B,OAAO,IAAI,CAAC,MAAM,EAAE,GAAG,GAAG,CAAA;AAC3B,CAAC;AAED,SAAS,cAAc,CAAC,QAAuB,EAAE,MAAsB;IACtE,QAAQ,QAAQ,EAAE,CAAC;QAClB,KAAK,WAAW;YACf,OAAO,MAAM,CAAC,aAAa,CAAA;QAC5B,KAAK,QAAQ;YACZ,OAAO,MAAM,CAAC,SAAS,CAAA;QACxB,KAAK,eAAe;YACnB,OAAO,MAAM,CAAC,eAAe,CAAA;QAC9B,KAAK,cAAc;YAClB,OAAO,MAAM,CAAC,cAAc,CAAA;QAC7B,KAAK,cAAc;YAClB,OAAO,MAAM,CAAC,eAAe,CAAA;IAC/B,CAAC;AACF,CAAC"}

package/dist/types.d.ts

@@ -0,0 +1,87 @@
+export type CheckType = 'get' | 'post' | 'happy_path';
+export type CheckStatus = 'pass' | 'fail' | 'timeout';
+export type AlertSeverity = 'info' | 'warning' | 'critical';
+export type ErrorSeverity = 'error' | 'warning' | 'exception';
+export interface CheckResult {
+    id?: string;
+    status: CheckStatus;
+    statusCode?: number;
+    latencyMs: number;
+    errorMessage?: string;
+    checkedAt?: number;
+}
+export interface PersistedCheckResult extends CheckResult {
+    id: string;
+    checkedAt: number;
+}
+export interface NotifyConfig {
+    channels: Array<'slack' | 'email'>;
+    emailProvider?: 'cloudflare' | 'resend';
+}
+export interface ProbeAlertingConfig {
+    consecutiveFailuresToOpen?: number;
+    consecutiveSuccessesToClose?: number;
+    minSeverity?: 'warning' | 'critical';
+}
+export interface TailAlertingConfig {
+    newErrorDedupWindowMs?: number;
+    rateSpikeThreshold?: number;
+    rateSpikeWindowMs?: number;
+    surfaceDownThresholdPct?: number;
+    surfaceDownWindowMs?: number;
+}
+export interface ThresholdConfig extends ProbeAlertingConfig, TailAlertingConfig {
+}
+export interface SamplingConfig {
+    exceptionsPct: number;
+    fivexxPct: number;
+    consoleErrorPct: number;
+    consoleWarnPct: number;
+    slowRequestsPct: number;
+    slowRequestThresholdMs: number;
+}
+export interface RuntimeFetch {
+    fetcher?: typeof fetch;
+}
+export interface UptimeIncident {
+    id: string;
+    surface: string;
+    opened_at: number;
+    closed_at: number | null;
+    trigger_check_id: string | null;
+    resolve_check_id: string | null;
+    severity: 'warning' | 'critical';
+    notes: string | null;
+}
+export interface SurfaceStatus {
+    name: string;
+    status: 'green' | 'yellow' | 'red';
+    lastCheckedAt: number | null;
+    uptime7d: number;
+}
+export interface ErrorRollup {
+    fingerprint: string;
+    surface: string;
+    message: string;
+    count: number;
+    lastOccurredAt: number;
+}
+export interface StatusPageSurfaceConfig {
+    name: string;
+}
+export interface StatusPageConfig {
+    realm: string;
+    d1Binding?: string;
+    surfaces: StatusPageSurfaceConfig[];
+}
+export interface ScheduledEventLike {
+    cron: string;
+}
+export interface ExecutionContextLike {
+    waitUntil(promise: Promise<unknown>): void;
+}
+export type IdFactory = () => string;
+export declare function generateId(): string;
+export declare function errorMessage(error: unknown): string;
+export declare function isTimeoutMessage(message: string): boolean;
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

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

package/dist/types.js

@@ -0,0 +1,11 @@
+export function generateId() {
+    return crypto.randomUUID();
+}
+export function errorMessage(error) {
+    return error instanceof Error ? error.message : String(error);
+}
+export function isTimeoutMessage(message) {
+    const lower = message.toLowerCase();
+    return lower.includes('timed out') || lower.includes('timeout') || lower.includes('aborted');
+}
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAmGA,MAAM,UAAU,UAAU;IACzB,OAAO,MAAM,CAAC,UAAU,EAAE,CAAA;AAC3B,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,KAAc;IAC1C,OAAO,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAA;AAC9D,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,OAAe;IAC/C,MAAM,KAAK,GAAG,OAAO,CAAC,WAAW,EAAE,CAAA;IACnC,OAAO,KAAK,CAAC,QAAQ,CAAC,WAAW,CAAC,IAAI,KAAK,CAAC,QAAQ,CAAC,SAAS,CAAC,IAAI,KAAK,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAA;AAC7F,CAAC"}

package/package.json

@@ -0,0 +1,85 @@
+{
+  "name": "@growth-labs/monitoring",
+  "version": "0.1.0",
+  "description": "Operational observability primitives for Growth Labs Cloudflare Workers: synthetic probes, Tail Worker capture, alerting, D1 schemas, and a status page.",
+  "type": "module",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./prober": {
+      "types": "./dist/prober/index.d.ts",
+      "import": "./dist/prober/index.js"
+    },
+    "./tail": {
+      "types": "./dist/tail/index.d.ts",
+      "import": "./dist/tail/index.js"
+    },
+    "./alerting": {
+      "types": "./dist/alerting/index.d.ts",
+      "import": "./dist/alerting/index.js"
+    },
+    "./status-page": {
+      "types": "./dist/status-page/app.d.ts",
+      "import": "./dist/status-page/app.js"
+    },
+    "./status-page/queries": {
+      "types": "./dist/status-page/lib/queries.d.ts",
+      "import": "./dist/status-page/lib/queries.js"
+    },
+    "./status-page/components/*": {
+      "types": "./src/status-page/components/*.astro",
+      "import": "./src/status-page/components/*.astro"
+    },
+    "./status-page/pages/*": {
+      "types": "./src/status-page/pages/*.astro",
+      "import": "./src/status-page/pages/*.astro",
+      "default": "./src/status-page/pages/*.astro"
+    },
+    "./status-page/pages/api/status.json": {
+      "types": "./dist/status-page/pages/api/status.json.d.ts",
+      "import": "./dist/status-page/pages/api/status.json.js",
+      "default": "./dist/status-page/pages/api/status.json.js"
+    },
+    "./schemas": {
+      "types": "./dist/schemas/index.d.ts",
+      "import": "./dist/schemas/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "src/status-page",
+    "src/schemas/migrations",
+    "README.md",
+    "CHANGELOG.md",
+    "SPEC.md"
+  ],
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  },
+  "peerDependencies": {
+    "astro": "^6.1.10"
+  },
+  "dependencies": {
+    "@growth-labs/analytics": "^0.3.0",
+    "@growth-labs/notify": "^0.1.0",
+    "drizzle-orm": "^0.45.2",
+    "zod": "^3.24.0"
+  },
+  "devDependencies": {
+    "@cloudflare/workers-types": "^4.20260402.1",
+    "astro": "^6.1.10",
+    "typescript": "^5.7.0",
+    "vitest": "^3.0.0"
+  },
+  "scripts": {
+    "build": "tsc && node -e \"require('node:fs').cpSync('src/schemas/migrations','dist/schemas/migrations',{recursive:true})\"",
+    "dev": "tsc --watch",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "check": "biome check src/ __tests__ package.json README.md CHANGELOG.md SPEC.md"
+  }
+}

package/src/schemas/migrations/0001_uptime_checks.sql

@@ -0,0 +1,12 @@
+CREATE TABLE gl_uptime_checks (
+  id            TEXT PRIMARY KEY,
+  surface       TEXT NOT NULL,
+  check_type    TEXT NOT NULL,
+  status        TEXT NOT NULL,
+  status_code   INTEGER,
+  latency_ms    INTEGER,
+  error_message TEXT,
+  checked_at    INTEGER NOT NULL
+);
+CREATE INDEX idx_uptime_surface_time ON gl_uptime_checks (surface, checked_at DESC);
+CREATE INDEX idx_uptime_status_time  ON gl_uptime_checks (status, checked_at DESC);

package/src/schemas/migrations/0002_uptime_incidents.sql

@@ -0,0 +1,12 @@
+CREATE TABLE gl_uptime_incidents (
+  id                TEXT PRIMARY KEY,
+  surface           TEXT NOT NULL,
+  opened_at         INTEGER NOT NULL,
+  closed_at         INTEGER,
+  trigger_check_id  TEXT,
+  resolve_check_id  TEXT,
+  severity          TEXT NOT NULL,
+  notes             TEXT
+);
+CREATE INDEX idx_incidents_surface_open ON gl_uptime_incidents (surface, opened_at DESC);
+CREATE INDEX idx_incidents_open         ON gl_uptime_incidents (closed_at) WHERE closed_at IS NULL;

package/src/schemas/migrations/0003_errors.sql

@@ -0,0 +1,16 @@
+CREATE TABLE gl_errors (
+  id              TEXT PRIMARY KEY,
+  realm_key       TEXT NOT NULL,
+  surface         TEXT NOT NULL,
+  severity        TEXT NOT NULL,
+  message         TEXT NOT NULL,
+  stack           TEXT,
+  request_id      TEXT,
+  status_code     INTEGER,
+  duration_ms     INTEGER,
+  occurred_at     INTEGER NOT NULL,
+  fingerprint     TEXT NOT NULL
+);
+CREATE INDEX idx_errors_realm_time       ON gl_errors (realm_key, occurred_at DESC);
+CREATE INDEX idx_errors_fingerprint_time ON gl_errors (fingerprint, occurred_at DESC);
+CREATE INDEX idx_errors_surface_time     ON gl_errors (surface, occurred_at DESC);

package/src/schemas/migrations/README.md

@@ -0,0 +1,15 @@
+# @growth-labs/monitoring D1 Migrations
+
+Apply these migrations to the consumer's monitoring D1 database before mounting
+the prober, tail worker, or status page.
+
+Wrangler example:
+
+```toml
+[[d1_databases]]
+binding = "MONITORING_DB"
+database_name = "monitoring"
+migrations_dir = "node_modules/@growth-labs/monitoring/src/schemas/migrations"
+```
+
+Tables are prefixed with `gl_` per Growth Labs package convention.

package/src/status-page/README.md

@@ -0,0 +1,14 @@
+# Monitoring Status Page
+
+`createStatusPageApp(config)` is an Astro integration for a read-only status
+Worker.
+
+Defaults:
+
+- HTML status route: `/`
+- JSON snapshot route: `/api/status.json`
+- D1 binding: `MONITORING_DB`
+
+The page reads current surface status, open incidents, and top 24-hour error
+fingerprints from the monitoring D1 tables. It performs no mutations and has no
+auth dependency.

package/src/status-page/app.ts

@@ -0,0 +1,58 @@
+import type { AstroIntegration } from 'astro'
+import type { StatusPageConfig } from '../types.js'
+
+export interface StatusPageAppConfig extends StatusPageConfig {
+	routePath?: string
+	jsonRoutePath?: string
+}
+
+export function createStatusPageApp(config: StatusPageAppConfig): AstroIntegration {
+	const routePath = config.routePath ?? '/'
+	const jsonRoutePath = config.jsonRoutePath ?? '/api/status.json'
+	const serializable = {
+		realm: config.realm,
+		d1Binding: config.d1Binding ?? 'MONITORING_DB',
+		surfaces: config.surfaces,
+	}
+
+	return {
+		name: '@growth-labs/monitoring/status-page',
+		hooks: {
+			'astro:config:setup': ({ injectRoute, updateConfig }) => {
+				updateConfig({
+					vite: {
+						plugins: [
+							{
+								name: '@growth-labs/monitoring:status-page-config',
+								resolveId(id: string) {
+									if (id === 'virtual:growth-labs/monitoring/status-page/config') return id
+								},
+								load(id: string) {
+									if (id === 'virtual:growth-labs/monitoring/status-page/config') {
+										return `export const config = ${JSON.stringify(serializable)}`
+									}
+								},
+							},
+						],
+					},
+				})
+				injectRoute({
+					pattern: routePath,
+					entrypoint: '@growth-labs/monitoring/status-page/pages/index',
+				})
+				injectRoute({
+					pattern: jsonRoutePath,
+					entrypoint: '@growth-labs/monitoring/status-page/pages/api/status.json',
+				})
+			},
+		},
+	}
+}
+
+export type { ErrorRollup, StatusPageConfig, SurfaceStatus, UptimeIncident } from '../types.js'
+export {
+	getCurrentSurfaceStatuses,
+	getOpenIncidents,
+	getSurfaceUptime,
+	getTopErrors,
+} from './lib/queries.js'

package/src/status-page/components/ErrorRollup.astro

@@ -0,0 +1,26 @@
+---
+import type { ErrorRollup as ErrorRollupItem } from '../../types.js'
+
+interface Props {
+	errors: ErrorRollupItem[]
+}
+
+const { errors } = Astro.props
+---
+
+<section class="grid content-start gap-3">
+	<h2 class="font-semibold text-lg">Top errors</h2>
+	{errors.length === 0 ? (
+		<p class="text-sm text-zinc-400">No recent errors</p>
+	) : (
+		<ul class="grid gap-2">
+			{errors.map((error) => (
+				<li class="border-zinc-800 border-b py-2">
+					<p class="font-medium text-sm">{error.surface}</p>
+					<p class="truncate text-sm text-zinc-400">{error.message}</p>
+					<p class="text-xs text-zinc-500">{error.count} · {error.fingerprint}</p>
+				</li>
+			))}
+		</ul>
+	)}
+</section>

package/src/status-page/components/IncidentList.astro

@@ -0,0 +1,25 @@
+---
+import type { UptimeIncident } from '../../types.js'
+
+interface Props {
+	incidents: UptimeIncident[]
+}
+
+const { incidents } = Astro.props
+---
+
+<section class="grid content-start gap-3">
+	<h2 class="font-semibold text-lg">Recent incidents</h2>
+	{incidents.length === 0 ? (
+		<p class="text-sm text-zinc-400">No open incidents</p>
+	) : (
+		<ul class="grid gap-2">
+			{incidents.map((incident) => (
+				<li class="border-zinc-800 border-b py-2">
+					<p class="font-medium text-sm">{incident.surface}</p>
+					<p class="text-sm text-zinc-400">{incident.severity} · opened {new Date(incident.opened_at * 1000).toUTCString()}</p>
+				</li>
+			))}
+		</ul>
+	)}
+</section>

package/src/status-page/components/SurfaceRow.astro

@@ -0,0 +1,24 @@
+---
+import type { SurfaceStatus } from '../../types.js'
+import { formatUptime, relativeTime } from '../shell.js'
+
+interface Props {
+	surface: SurfaceStatus
+}
+
+const { surface } = Astro.props
+const pillClass = {
+	green: 'bg-emerald-400/15 text-emerald-200 ring-emerald-400/30',
+	yellow: 'bg-amber-400/15 text-amber-200 ring-amber-400/30',
+	red: 'bg-red-400/15 text-red-200 ring-red-400/30',
+}[surface.status]
+---
+
+<article class="grid grid-cols-[auto_1fr_auto] items-center gap-4 border-zinc-800 border-b py-3" data-surface={surface.name}>
+	<span class:list={['rounded px-2 py-1 text-xs ring-1', pillClass]}>{surface.status}</span>
+	<h2 class="truncate font-medium text-base">{surface.name}</h2>
+	<div class="text-right text-sm text-zinc-400">
+		<p>{relativeTime(surface.lastCheckedAt)}</p>
+		<p>{formatUptime(surface.uptime7d)} 7d</p>
+	</div>
+</article>

package/src/status-page/lib/queries.ts

@@ -0,0 +1,114 @@
+import type {
+	ErrorRollup,
+	StatusPageSurfaceConfig,
+	SurfaceStatus,
+	UptimeIncident,
+} from '../../types.js'
+
+interface CheckRow {
+	id: string
+	surface: string
+	status: string
+	checked_at: number
+}
+
+interface ErrorRollupRow {
+	fingerprint: string
+	surface: string
+	message: string
+	count: number
+	occurred_at: number
+}
+
+export async function getCurrentSurfaceStatuses(
+	db: D1Database,
+	surfaces: StatusPageSurfaceConfig[],
+): Promise<SurfaceStatus[]> {
+	const openIncidents = await getOpenIncidents(db)
+	return Promise.all(
+		surfaces.map(async (surface) => {
+			const lastCheck = await db
+				.prepare(`
+					SELECT id, surface, status, checked_at
+					FROM gl_uptime_checks
+					WHERE surface = ?
+					ORDER BY checked_at DESC
+					LIMIT 1
+				`)
+				.bind(surface.name)
+				.first<CheckRow>()
+			const incident = openIncidents.find((row) => row.surface === surface.name)
+			const uptime7d = await getSurfaceUptime(db, surface.name, 7)
+			return {
+				name: surface.name,
+				status: statusFor(lastCheck ?? null, incident),
+				lastCheckedAt: lastCheck?.checked_at ?? null,
+				uptime7d,
+			}
+		}),
+	)
+}
+
+export async function getOpenIncidents(db: D1Database): Promise<UptimeIncident[]> {
+	const { results } = await db
+		.prepare(`
+			SELECT id, surface, opened_at, closed_at, trigger_check_id, resolve_check_id, severity, notes
+			FROM gl_uptime_incidents
+			WHERE closed_at IS NULL
+			ORDER BY opened_at DESC
+		`)
+		.all<UptimeIncident>()
+	return results ?? []
+}
+
+export async function getTopErrors(db: D1Database, hoursBack: number): Promise<ErrorRollup[]> {
+	const since = Math.floor(Date.now() / 1000) - hoursBack * 60 * 60
+	const { results } = await db
+		.prepare(`
+			SELECT fingerprint, surface, message, COUNT(*) AS count, MAX(occurred_at) AS occurred_at
+			FROM gl_errors
+			WHERE occurred_at >= ?
+			GROUP BY fingerprint
+			ORDER BY count DESC, occurred_at DESC
+			LIMIT 5
+		`)
+		.bind(since)
+		.all<ErrorRollupRow>()
+	return (results ?? []).map((row) => ({
+		fingerprint: row.fingerprint,
+		surface: row.surface,
+		message: row.message,
+		count: Number(row.count),
+		lastOccurredAt: Number(row.occurred_at),
+	}))
+}
+
+export async function getSurfaceUptime(
+	db: D1Database,
+	surface: string,
+	daysBack: number,
+): Promise<number> {
+	const since = Math.floor(Date.now() / 1000) - daysBack * 24 * 60 * 60
+	const { results } = await db
+		.prepare(`
+			SELECT id, surface, status, checked_at
+			FROM gl_uptime_checks
+			WHERE surface = ? AND checked_at >= ?
+			ORDER BY checked_at DESC
+		`)
+		.bind(surface, since)
+		.all<CheckRow>()
+	const rows = results ?? []
+	if (rows.length === 0) return 1
+	return rows.filter((row) => row.status === 'pass').length / rows.length
+}
+
+function statusFor(
+	check: CheckRow | null,
+	incident: UptimeIncident | undefined,
+): SurfaceStatus['status'] {
+	if (incident?.severity === 'critical') return 'red'
+	if (incident?.severity === 'warning') return 'yellow'
+	if (!check) return 'yellow'
+	return check.status === 'pass' ? 'green' : 'yellow'
+}

package/src/status-page/pages/api/status.json.ts

@@ -0,0 +1,24 @@
+import { config } from 'virtual:growth-labs/monitoring/status-page/config'
+import type { APIRoute } from 'astro'
+import { getCurrentSurfaceStatuses, getOpenIncidents, getTopErrors } from '../../lib/queries.js'
+
+export const GET: APIRoute = async ({ locals }) => {
+	const env = (locals as { runtime?: { env?: Record<string, unknown> } }).runtime?.env ?? {}
+	const db = env[config.d1Binding] as D1Database
+	const [surfaces, openIncidents, topErrors] = await Promise.all([
+		getCurrentSurfaceStatuses(db, config.surfaces),
+		getOpenIncidents(db),
+		getTopErrors(db, 24),
+	])
+
+	return new Response(
+		JSON.stringify({
+			realm: config.realm,
+			generatedAt: Math.floor(Date.now() / 1000),
+			surfaces,
+			openIncidents,
+			topErrors,
+		}),
+		{ headers: { 'Content-Type': 'application/json' } },
+	)
+}

package/src/status-page/pages/index.astro

@@ -0,0 +1,45 @@
+---
+import { config } from 'virtual:growth-labs/monitoring/status-page/config'
+import IncidentList from '../components/IncidentList.astro'
+import SurfaceRow from '../components/SurfaceRow.astro'
+import ErrorRollup from '../components/ErrorRollup.astro'
+import { getCurrentSurfaceStatuses, getOpenIncidents, getTopErrors } from '../lib/queries.js'
+
+const env = Astro.locals.runtime?.env ?? {}
+const db = env[config.d1Binding] as D1Database
+const [surfaces, incidents, topErrors] = await Promise.all([
+	getCurrentSurfaceStatuses(db, config.surfaces),
+	getOpenIncidents(db),
+	getTopErrors(db, 24),
+])
+const generatedAt = Math.floor(Date.now() / 1000)
+---
+
+<!doctype html>
+<html lang="en">
+	<head>
+		<meta charset="utf-8" />
+		<meta name="viewport" content="width=device-width, initial-scale=1" />
+		<title>{config.realm} status</title>
+	</head>
+	<body class="min-h-screen bg-zinc-950 text-zinc-100">
+		<main class="mx-auto flex max-w-4xl flex-col gap-8 px-4 py-8">
+			<header class="flex flex-wrap items-end justify-between gap-4 border-zinc-800 border-b pb-4">
+				<div>
+					<p class="text-sm text-zinc-400">Status</p>
+					<h1 class="font-semibold text-3xl tracking-normal">{config.realm}</h1>
+				</div>
+				<p class="text-sm text-zinc-400">Updated <time datetime={new Date(generatedAt * 1000).toISOString()}>{new Date(generatedAt * 1000).toUTCString()}</time></p>
+			</header>
+
+			<section class="grid gap-2" data-monitoring-status-surfaces>
+				{surfaces.map((surface) => <SurfaceRow surface={surface} />)}
+			</section>
+
+			<section class="grid gap-4 md:grid-cols-2">
+				<IncidentList incidents={incidents.slice(0, 5)} />
+				<ErrorRollup errors={topErrors.slice(0, 5)} />
+			</section>
+		</main>
+	</body>
+</html>

package/src/status-page/shell.ts

@@ -0,0 +1,17 @@
+export function relativeTime(
+	timestampSeconds: number | null,
+	nowSeconds = Math.floor(Date.now() / 1000),
+): string {
+	if (!timestampSeconds) return 'never'
+	const diff = Math.max(0, nowSeconds - timestampSeconds)
+	if (diff < 60) return `${diff}s ago`
+	const minutes = Math.floor(diff / 60)
+	if (minutes < 60) return `${minutes}m ago`
+	const hours = Math.floor(minutes / 60)
+	if (hours < 24) return `${hours}h ago`
+	return `${Math.floor(hours / 24)}d ago`
+}
+
+export function formatUptime(value: number): string {
+	return `${(value * 100).toFixed(2)}%`
+}