@growth-labs/ops-digest 0.1.0

package/CHANGELOG.md

@@ -0,0 +1,7 @@
+# @growth-labs/ops-digest Changelog
+
+## 0.1.0 - 2026-05-18
+
+- Initial release.
+- Adds the `opsDigest()` Worker-runtime digest engine with exact-cron scheduled dispatch and manual `runDigest()` execution.
+- Adds D1 metric handlers, WAE metric handlers, `composite.ratio`, IQR anomaly detection, Slack-friendly standard rendering, and KV idempotency markers.

package/README.md

@@ -0,0 +1,129 @@
+# @growth-labs/ops-digest
+
+Worker-runtime digest engine for operational metrics. It reads D1 and Workers
+Analytics Engine data, computes baselines and anomaly callouts, renders a
+plain-text digest, sends it through `@growth-labs/notify`, and stores a KV
+idempotency marker so reruns do not double-post.
+
+It does not own schemas, write analytics, deliver notifications directly, or
+schedule Workers. Consumers own D1 tables, WAE datasets, notify bindings, and
+`[triggers]` cron configuration.
+
+## Install
+
+```bash
+pnpm add @growth-labs/ops-digest @growth-labs/analytics @growth-labs/notify
+```
+
+## Basic Usage
+
+```ts
+import { opsDigest } from '@growth-labs/ops-digest'
+
+const digest = opsDigest({
+	realmId: 'fulcrum-labs',
+	d1Binding: 'SITE_DB',
+	authWae: {
+		accountId: 'b8fd8daf73edd8fe6b6bd18eeaacf2bb',
+		dataset: 'auth_events',
+		apiTokenSecret: 'WAE_QUERY_TOKEN',
+		realmFilter: 'fulcrum-labs',
+	},
+	idempotencyKv: 'DIGEST_KV',
+	notifyConfig: { channels: ['slack'], severity: 'info' },
+	digests: [
+		{
+			name: 'fronts-daily',
+			brandLabel: 'Fronts',
+			schedule: '0 9 * * *',
+			window: 'previous-day-utc',
+			metrics: [
+				{
+					handler: 'wae.event-count',
+					name: 'signins',
+					source: 'authWae',
+					eventName: 'auth.signin.success',
+				},
+				{
+					handler: 'd1.row-count',
+					name: 'new-subscribers',
+					table: 'subscriptions',
+					timeColumn: 'created_at',
+				},
+			],
+			anomaly: { method: 'iqr', medianFloor: 5 },
+			render: 'standard',
+			channels: ['slack'],
+		},
+	],
+})
+
+export default {
+	scheduled: digest.scheduledHandler,
+}
+```
+
+For manual ops debugging:
+
+```ts
+await digest.runDigest('fronts-daily', env, ctx)
+```
+
+## Handlers
+
+| Handler | Description |
+| --- | --- |
+| `d1.row-count` | Counts rows in a D1 table bounded by a timestamp column. Defaults to `created_at` seconds; set `timeColumnUnit: 'ms'` for millisecond columns. |
+| `d1.row-count-by-event` | Counts D1 rows whose event column matches configured names. Defaults to `event_name` and `processed_at`. |
+| `wae.event-count` | Counts WAE rows for one `blob1` event name and optional source realm/site filter. |
+| `wae.event-count-by-blob` | Counts one WAE event grouped by a blob field and returns a record keyed by group. |
+| `wae.unique-count` | Counts distinct values in a WAE blob field, optionally filtered by event name. |
+| `wae.avg-double` | Averages a WAE double field, optionally filtered by event name. |
+| `wae.top-n-by-blob` | Returns ordered `{ group, count }` rows for the top N values of a blob field. |
+| `composite.ratio` | Computes nested numerator and denominator metrics and returns `numerator / denominator`. |
+
+All WAE handlers validate dataset identifiers before query execution and read
+the API token from the configured secret name on `env`.
+
+## Anomaly Tuning
+
+`method: 'iqr'` compares today against thirty trailing daily windows. It skips
+callouts when history has fewer than fourteen values or when the historical
+median is below `medianFloor`.
+
+```ts
+anomaly: {
+	method: 'iqr',
+	medianFloor: 5,
+	iqrMultiplier: 1.5,
+	overrides: {
+		'write-for-us': { medianFloor: 1 },
+	},
+}
+```
+
+Use `method: 'none'` to disable anomaly callouts for a digest.
+
+## Multiple Digests
+
+Mount one handler and list every cron in the Worker trigger config. Dispatch is
+an exact string match on `event.cron`.
+
+```ts
+digests: [
+	{ name: 'fronts-daily', schedule: '0 9 * * *', /* ... */ },
+	{ name: 'fronts-weekly', schedule: '0 9 * * 1', /* ... */ },
+]
+```
+
+## Idempotency
+
+Markers are written to the configured KV binding with this shape:
+
+```txt
+digest:<digest-name>:<YYYY-MM-DD window start>
+```
+
+The marker value is `sha256(renderedDigest)`. Duplicate reruns skip delivery.
+Changed reruns also skip delivery and log a warning; the first digest for a
+window remains canonical.

package/SPEC.md

@@ -0,0 +1,25 @@
+# @growth-labs/ops-digest v0.1.0 Spec
+
+`@growth-labs/ops-digest` is an operational digest engine for Cloudflare Workers.
+
+It accepts one or more digest definitions. Each definition declares a cron schedule, closed UTC window, metric handlers, anomaly detection settings, a render template, and notify channels. The engine computes current metrics, computes seven trailing baseline windows, computes a thirty-day anomaly history, renders a Slack-friendly digest, posts through `@growth-labs/notify`, and writes a KV idempotency marker keyed by digest name and window start.
+
+## Scope
+
+In scope for v0.1.0:
+
+- D1 read-only aggregate handlers.
+- Workers Analytics Engine read-only aggregate handlers through `@growth-labs/analytics` query utilities.
+- IQR anomaly detection with a median volume floor.
+- Built-in `standard` text renderer.
+- KV idempotency with seven-day TTL.
+- Exact cron dispatch through `scheduledHandler`.
+
+Out of scope for v0.1.0:
+
+- Package-owned D1 schema or writes.
+- Notification delivery internals.
+- Worker scheduling beyond exporting `scheduledHandler`.
+- Custom render templates.
+- Historical digest backfills.
+- WAE query batching optimizations.

package/dist/anomaly.d.ts

@@ -0,0 +1,3 @@
+import type { AnomalyConfig, AnomalyHit } from './types.js';
+export declare function detectAnomaly(current: number, history: number[], config: AnomalyConfig, metricName?: string): AnomalyHit | null;
+//# sourceMappingURL=anomaly.d.ts.map

package/dist/anomaly.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"anomaly.d.ts","sourceRoot":"","sources":["../src/anomaly.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,YAAY,CAAA;AAE3D,wBAAgB,aAAa,CAC5B,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,MAAM,EAAE,EACjB,MAAM,EAAE,aAAa,EACrB,UAAU,SAAK,GACb,UAAU,GAAG,IAAI,CA2CnB"}

package/dist/anomaly.js

@@ -0,0 +1,50 @@
+export function detectAnomaly(current, history, config, metricName = '') {
+    const override = metricName ? config.overrides?.[metricName] : undefined;
+    const effective = { ...config, ...override };
+    if (effective.method === 'none')
+        return null;
+    if (history.length < 14)
+        return null;
+    const sorted = [...history].sort((a, b) => a - b);
+    const medianValue = median(sorted);
+    if (medianValue < effective.medianFloor)
+        return null;
+    const q1 = median(sorted.slice(0, Math.floor(sorted.length / 2)));
+    const q3 = median(sorted.slice(Math.ceil(sorted.length / 2)));
+    const iqr = q3 - q1;
+    const multiplier = effective.iqrMultiplier ?? 1.5;
+    const lowerBand = medianValue - multiplier * iqr;
+    const upperBand = medianValue + multiplier * iqr;
+    if (current < lowerBand) {
+        return {
+            metric: metricName,
+            current,
+            median: medianValue,
+            iqr,
+            lowerBand,
+            upperBand,
+            direction: 'below',
+        };
+    }
+    if (current > upperBand) {
+        return {
+            metric: metricName,
+            current,
+            median: medianValue,
+            iqr,
+            lowerBand,
+            upperBand,
+            direction: 'above',
+        };
+    }
+    return null;
+}
+function median(sorted) {
+    if (sorted.length === 0)
+        return 0;
+    const middle = Math.floor(sorted.length / 2);
+    if (sorted.length % 2 === 1)
+        return sorted[middle];
+    return (sorted[middle - 1] + sorted[middle]) / 2;
+}
+//# sourceMappingURL=anomaly.js.map

package/dist/anomaly.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"anomaly.js","sourceRoot":"","sources":["../src/anomaly.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,aAAa,CAC5B,OAAe,EACf,OAAiB,EACjB,MAAqB,EACrB,UAAU,GAAG,EAAE;IAEf,MAAM,QAAQ,GAAG,UAAU,CAAC,CAAC,CAAC,MAAM,CAAC,SAAS,EAAE,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,SAAS,CAAA;IACxE,MAAM,SAAS,GAAG,EAAE,GAAG,MAAM,EAAE,GAAG,QAAQ,EAAE,CAAA;IAE5C,IAAI,SAAS,CAAC,MAAM,KAAK,MAAM;QAAE,OAAO,IAAI,CAAA;IAC5C,IAAI,OAAO,CAAC,MAAM,GAAG,EAAE;QAAE,OAAO,IAAI,CAAA;IAEpC,MAAM,MAAM,GAAG,CAAC,GAAG,OAAO,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAA;IACjD,MAAM,WAAW,GAAG,MAAM,CAAC,MAAM,CAAC,CAAA;IAClC,IAAI,WAAW,GAAG,SAAS,CAAC,WAAW;QAAE,OAAO,IAAI,CAAA;IAEpD,MAAM,EAAE,GAAG,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,CAAA;IACjE,MAAM,EAAE,GAAG,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,CAAA;IAC7D,MAAM,GAAG,GAAG,EAAE,GAAG,EAAE,CAAA;IACnB,MAAM,UAAU,GAAG,SAAS,CAAC,aAAa,IAAI,GAAG,CAAA;IACjD,MAAM,SAAS,GAAG,WAAW,GAAG,UAAU,GAAG,GAAG,CAAA;IAChD,MAAM,SAAS,GAAG,WAAW,GAAG,UAAU,GAAG,GAAG,CAAA;IAEhD,IAAI,OAAO,GAAG,SAAS,EAAE,CAAC;QACzB,OAAO;YACN,MAAM,EAAE,UAAU;YAClB,OAAO;YACP,MAAM,EAAE,WAAW;YACnB,GAAG;YACH,SAAS;YACT,SAAS;YACT,SAAS,EAAE,OAAO;SAClB,CAAA;IACF,CAAC;IAED,IAAI,OAAO,GAAG,SAAS,EAAE,CAAC;QACzB,OAAO;YACN,MAAM,EAAE,UAAU;YAClB,OAAO;YACP,MAAM,EAAE,WAAW;YACnB,GAAG;YACH,SAAS;YACT,SAAS;YACT,SAAS,EAAE,OAAO;SAClB,CAAA;IACF,CAAC;IAED,OAAO,IAAI,CAAA;AACZ,CAAC;AAED,SAAS,MAAM,CAAC,MAAgB;IAC/B,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,CAAC,CAAA;IACjC,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,CAAA;IAC5C,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,KAAK,CAAC;QAAE,OAAO,MAAM,CAAC,MAAM,CAAC,CAAA;IAClD,OAAO,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,CAAA;AACjD,CAAC"}

package/dist/engine.d.ts

@@ -0,0 +1,4 @@
+import type { DigestDefinition, DigestRunResult, MetricValue, OpsDigestConfig, OpsDigestEnv } from './types.js';
+export declare function runDigest(definition: DigestDefinition, config: OpsDigestConfig, env: OpsDigestEnv, _ctx: ExecutionContext): Promise<DigestRunResult>;
+export declare function metricValueForEngine(value: MetricValue): number;
+//# sourceMappingURL=engine.d.ts.map

package/dist/engine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"engine.d.ts","sourceRoot":"","sources":["../src/engine.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,EACX,gBAAgB,EAChB,eAAe,EAIf,WAAW,EACX,eAAe,EACf,YAAY,EAIZ,MAAM,YAAY,CAAA;AAGnB,wBAAsB,SAAS,CAC9B,UAAU,EAAE,gBAAgB,EAC5B,MAAM,EAAE,eAAe,EACvB,GAAG,EAAE,YAAY,EACjB,IAAI,EAAE,gBAAgB,GACpB,OAAO,CAAC,eAAe,CAAC,CAiD1B;AAyHD,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,WAAW,GAAG,MAAM,CAE/D"}

package/dist/engine.js

@@ -0,0 +1,149 @@
+import { notify } from '@growth-labs/notify';
+import { detectAnomaly } from './anomaly.js';
+import { metricValueToNumber } from './handlers/common.js';
+import { computeMetric } from './handlers/index.js';
+import { checkIdempotency, formatIdempotencyKey, hashRenderedDigest, writeIdempotencyMarker, } from './idempotency.js';
+import { renderDigest } from './render.js';
+import { resolveDigestWindow, shiftWindowDays, splitTrailingDays } from './window.js';
+export async function runDigest(definition, config, env, _ctx) {
+    const window = resolveDigestWindow(definition.window);
+    const idempotencyKey = formatIdempotencyKey(definition.name, window.startMs);
+    const errors = [];
+    const context = {
+        d1: resolveBinding(env, config.d1Binding),
+        sources: buildSources(config),
+        env,
+    };
+    const metrics = [];
+    for (const metric of definition.metrics) {
+        const result = await computeMetricResult(metric, definition, window, context, errors);
+        if (result)
+            metrics.push(result);
+    }
+    const rendered = renderDigest(definition.render, metrics, definition.brandLabel, window);
+    const renderedHash = await hashRenderedDigest(rendered);
+    const kv = resolveBinding(env, config.idempotencyKv);
+    const state = await checkIdempotency(kv, definition.name, window.startMs, renderedHash);
+    if (state === 'duplicate') {
+        return buildResult(definition.name, window, rendered, idempotencyKey, false, metrics, errors);
+    }
+    if (state === 'changed') {
+        console.warn('ops-digest: idempotency marker changed; skipping rerun', {
+            key: idempotencyKey,
+        });
+        return buildResult(definition.name, window, rendered, idempotencyKey, false, metrics, errors);
+    }
+    const severity = metrics.some((metric) => metric.anomaly) ? 'warning' : 'info';
+    const notifyResult = await notify(env, {
+        ...config.notifyConfig,
+        channels: definition.channels,
+        severity,
+        title: `${definition.brandLabel} Ops Digest`,
+        body: rendered,
+        dedupKey: idempotencyKey,
+    });
+    const posted = notifyResult.sent.length > 0;
+    if (posted) {
+        await writeIdempotencyMarker(kv, definition.name, window.startMs, renderedHash);
+    }
+    else {
+        errors.push(`notify: no channels sent (${notifyResult.failed.map((f) => f.error).join('; ')})`);
+    }
+    return buildResult(definition.name, window, rendered, idempotencyKey, posted, metrics, errors);
+}
+async function computeMetricResult(metric, definition, window, context, errors) {
+    try {
+        const current = await computeMetric(metric, window, context);
+        const currentNumber = metricValueToNumber(current);
+        const baseline = await computeBaseline(metric, window, context, errors);
+        const history = await computeHistory(metric, window, context, errors);
+        const delta = formatPercentChange(currentNumber, baseline);
+        const anomaly = detectAnomaly(currentNumber, history, definition.anomaly, metric.name) ?? undefined;
+        if (anomaly)
+            anomaly.metric = metric.name;
+        return {
+            name: metric.name,
+            current,
+            baseline,
+            delta,
+            anomaly,
+        };
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        errors.push(`${metric.name}: ${message}`);
+        console.error('ops-digest: metric failed', { metric: metric.name, err });
+        return null;
+    }
+}
+async function computeBaseline(metric, window, context, errors) {
+    const values = [];
+    for (let offset = 1; offset <= 7; offset += 1) {
+        try {
+            values.push(metricValueToNumber(await computeMetric(metric, shiftWindowDays(window, offset), context)));
+        }
+        catch (err) {
+            const message = err instanceof Error ? err.message : String(err);
+            errors.push(`${metric.name} baseline-${offset}: ${message}`);
+        }
+    }
+    if (values.length === 0)
+        return 0;
+    return values.reduce((sum, value) => sum + value, 0) / values.length;
+}
+async function computeHistory(metric, window, context, errors) {
+    const values = [];
+    for (const [index, historyWindow] of splitTrailingDays(window, 30).entries()) {
+        try {
+            values.push(metricValueToNumber(await computeMetric(metric, historyWindow, context)));
+        }
+        catch (err) {
+            const message = err instanceof Error ? err.message : String(err);
+            errors.push(`${metric.name} history-${index + 1}: ${message}`);
+        }
+    }
+    return values;
+}
+function buildResult(digestName, window, rendered, idempotencyKey, posted, metrics, errors) {
+    return {
+        digestName,
+        windowStart: window.startMs,
+        windowEnd: window.endMs,
+        rendered,
+        idempotencyKey,
+        posted,
+        metrics,
+        errors,
+    };
+}
+function buildSources(config) {
+    return {
+        ...(config.authWae ? { authWae: config.authWae } : {}),
+        ...(config.contentWae ? { contentWae: config.contentWae } : {}),
+        ...(config.extraWae ?? {}),
+    };
+}
+function resolveBinding(env, name) {
+    const binding = env[name];
+    if (!binding)
+        throw new Error(`ops-digest: env binding "${name}" is missing`);
+    return binding;
+}
+function formatPercentChange(current, previous) {
+    if (previous === 0) {
+        if (current === 0)
+            return { value: '0%', direction: 'flat' };
+        return { value: '—', direction: current > 0 ? 'up' : 'down' };
+    }
+    const pct = ((current - previous) / previous) * 100;
+    if (pct === 0)
+        return { value: '0%', direction: 'flat' };
+    return {
+        value: `${Math.abs(pct).toFixed(1)}%`,
+        direction: pct > 0 ? 'up' : 'down',
+    };
+}
+export function metricValueForEngine(value) {
+    return metricValueToNumber(value);
+}
+//# sourceMappingURL=engine.js.map

package/dist/engine.js.map

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

package/dist/handlers/common.d.ts

@@ -0,0 +1,12 @@
+import type { HandlerContext, MetricValue, ResolvedDigestWindow, WaeSourceConfig } from '../types.js';
+export declare function quoteIdentifier(identifier: string): string;
+export declare function assertSqlIdentifier(identifier: string): void;
+export declare function numericResult(row: Record<string, unknown> | null | undefined): number;
+export declare function metricValueToNumber(value: MetricValue): number;
+export declare function resolveD1(context: HandlerContext): D1Database;
+export declare function d1TimeBounds(window: ResolvedDigestWindow, unit: 's' | 'ms' | undefined): [number, number];
+export declare function resolveWaeSource(context: HandlerContext, sourceName: string): WaeSourceConfig;
+export declare function queryWaeRows<T extends Record<string, unknown>>(source: WaeSourceConfig, context: HandlerContext, sql: string): Promise<T[]>;
+export declare function waeConditions(source: WaeSourceConfig, window: ResolvedDigestWindow, eventName?: string): string[];
+export declare function sqlString(value: string): string;
+//# sourceMappingURL=common.d.ts.map

package/dist/handlers/common.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"common.d.ts","sourceRoot":"","sources":["../../src/handlers/common.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACX,cAAc,EACd,WAAW,EACX,oBAAoB,EACpB,eAAe,EACf,MAAM,aAAa,CAAA;AAKpB,wBAAgB,eAAe,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAG1D;AAED,wBAAgB,mBAAmB,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI,CAI5D;AAED,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,GAAG,SAAS,GAAG,MAAM,CAKrF;AAED,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,WAAW,GAAG,MAAM,CAI9D;AAED,wBAAgB,SAAS,CAAC,OAAO,EAAE,cAAc,GAAG,UAAU,CAG7D;AAED,wBAAgB,YAAY,CAC3B,MAAM,EAAE,oBAAoB,EAC5B,IAAI,EAAE,GAAG,GAAG,IAAI,GAAG,SAAS,GAC1B,CAAC,MAAM,EAAE,MAAM,CAAC,CAGlB;AAED,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,GAAG,eAAe,CAI7F;AAED,wBAAsB,YAAY,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACnE,MAAM,EAAE,eAAe,EACvB,OAAO,EAAE,cAAc,EACvB,GAAG,EAAE,MAAM,GACT,OAAO,CAAC,CAAC,EAAE,CAAC,CASd;AAED,wBAAgB,aAAa,CAC5B,MAAM,EAAE,eAAe,EACvB,MAAM,EAAE,oBAAoB,EAC5B,SAAS,CAAC,EAAE,MAAM,GAChB,MAAM,EAAE,CAOV;AAED,wBAAgB,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAE/C"}

package/dist/handlers/common.js

@@ -0,0 +1,68 @@
+import { queryWAE } from '@growth-labs/analytics/utils/wae-query';
+import { assertValidWaeDataset } from '@growth-labs/analytics/utils/wae-validate';
+import { waeWindowSql } from '../window.js';
+const IDENTIFIER_PATTERN = /^[A-Za-z_][A-Za-z0-9_]*$/;
+export function quoteIdentifier(identifier) {
+    assertSqlIdentifier(identifier);
+    return `"${identifier}"`;
+}
+export function assertSqlIdentifier(identifier) {
+    if (!IDENTIFIER_PATTERN.test(identifier)) {
+        throw new Error(`ops-digest: invalid SQL identifier "${identifier}"`);
+    }
+}
+export function numericResult(row) {
+    const value = row?.c;
+    if (typeof value === 'number')
+        return value;
+    if (typeof value === 'string')
+        return Number(value);
+    return 0;
+}
+export function metricValueToNumber(value) {
+    if (typeof value === 'number')
+        return value;
+    if (Array.isArray(value))
+        return value.reduce((sum, item) => sum + item.count, 0);
+    return Object.values(value).reduce((sum, count) => sum + count, 0);
+}
+export function resolveD1(context) {
+    if (!context.d1)
+        throw new Error('ops-digest: D1 binding is missing');
+    return context.d1;
+}
+export function d1TimeBounds(window, unit) {
+    if (unit === 'ms')
+        return [window.startMs, window.endMs];
+    return [Math.floor(window.startMs / 1000), Math.floor(window.endMs / 1000)];
+}
+export function resolveWaeSource(context, sourceName) {
+    const source = context.sources?.[sourceName];
+    if (!source)
+        throw new Error(`ops-digest: WAE source "${sourceName}" is not configured`);
+    return source;
+}
+export async function queryWaeRows(source, context, sql) {
+    assertValidWaeDataset(source.dataset, source.realmFilter ?? source.siteFilter ?? '');
+    const token = context.env?.[source.apiTokenSecret];
+    if (typeof token !== 'string' || token.trim() === '') {
+        throw new Error(`ops-digest: WAE token secret "${source.apiTokenSecret}" is missing`);
+    }
+    const fetchFn = context.env?.fetch ?? fetch;
+    const result = await queryWAE(source.accountId, source.dataset, sql, token, fetchFn);
+    return result.data;
+}
+export function waeConditions(source, window, eventName) {
+    const conditions = [];
+    if (eventName)
+        conditions.push(`blob1 = ${sqlString(eventName)}`);
+    const filter = source.realmFilter ?? source.siteFilter;
+    if (filter)
+        conditions.push(`blob2 = ${sqlString(filter)}`);
+    conditions.push(waeWindowSql(window));
+    return conditions;
+}
+export function sqlString(value) {
+    return `'${value.replaceAll("'", "''")}'`;
+}
+//# sourceMappingURL=common.js.map

package/dist/handlers/common.js.map

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

package/dist/handlers/composite-ratio.d.ts

@@ -0,0 +1,7 @@
+import type { HandlerContext, MetricDefinition, ResolvedDigestWindow } from '../types.js';
+type CompositeRatioMetric = Extract<MetricDefinition, {
+    handler: 'composite.ratio';
+}>;
+export declare function computeCompositeRatio(metric: CompositeRatioMetric, window: ResolvedDigestWindow, context: HandlerContext, compute: (metric: MetricDefinition, window: ResolvedDigestWindow, context: HandlerContext) => Promise<unknown>): Promise<number>;
+export {};
+//# sourceMappingURL=composite-ratio.d.ts.map

package/dist/handlers/composite-ratio.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"composite-ratio.d.ts","sourceRoot":"","sources":["../../src/handlers/composite-ratio.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,gBAAgB,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAA;AAGzF,KAAK,oBAAoB,GAAG,OAAO,CAAC,gBAAgB,EAAE;IAAE,OAAO,EAAE,iBAAiB,CAAA;CAAE,CAAC,CAAA;AAErF,wBAAsB,qBAAqB,CAC1C,MAAM,EAAE,oBAAoB,EAC5B,MAAM,EAAE,oBAAoB,EAC5B,OAAO,EAAE,cAAc,EACvB,OAAO,EAAE,CACR,MAAM,EAAE,gBAAgB,EACxB,MAAM,EAAE,oBAAoB,EAC5B,OAAO,EAAE,cAAc,KACnB,OAAO,CAAC,OAAO,CAAC,GACnB,OAAO,CAAC,MAAM,CAAC,CAWjB"}

package/dist/handlers/composite-ratio.js

@@ -0,0 +1,9 @@
+import { metricValueToNumber } from './common.js';
+export async function computeCompositeRatio(metric, window, context, compute) {
+    const numerator = metricValueToNumber((await compute(metric.numerator, window, context)));
+    const denominator = metricValueToNumber((await compute(metric.denominator, window, context)));
+    if (denominator === 0)
+        return 0;
+    return numerator / denominator;
+}
+//# sourceMappingURL=composite-ratio.js.map

package/dist/handlers/composite-ratio.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"composite-ratio.js","sourceRoot":"","sources":["../../src/handlers/composite-ratio.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAA;AAIjD,MAAM,CAAC,KAAK,UAAU,qBAAqB,CAC1C,MAA4B,EAC5B,MAA4B,EAC5B,OAAuB,EACvB,OAIqB;IAErB,MAAM,SAAS,GAAG,mBAAmB,CACpC,CAAC,MAAM,OAAO,CAAC,MAAM,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,CAAC,CAA8C,CAC/F,CAAA;IACD,MAAM,WAAW,GAAG,mBAAmB,CACtC,CAAC,MAAM,OAAO,CAAC,MAAM,CAAC,WAAW,EAAE,MAAM,EAAE,OAAO,CAAC,CAE/C,CACJ,CAAA;IACD,IAAI,WAAW,KAAK,CAAC;QAAE,OAAO,CAAC,CAAA;IAC/B,OAAO,SAAS,GAAG,WAAW,CAAA;AAC/B,CAAC"}

package/dist/handlers/d1-row-count-by-event.d.ts

@@ -0,0 +1,7 @@
+import type { HandlerContext, MetricDefinition, ResolvedDigestWindow } from '../types.js';
+type D1RowCountByEventMetric = Extract<MetricDefinition, {
+    handler: 'd1.row-count-by-event';
+}>;
+export declare function computeD1RowCountByEvent(metric: D1RowCountByEventMetric, window: ResolvedDigestWindow, context: HandlerContext): Promise<number>;
+export {};
+//# sourceMappingURL=d1-row-count-by-event.d.ts.map

package/dist/handlers/d1-row-count-by-event.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"d1-row-count-by-event.d.ts","sourceRoot":"","sources":["../../src/handlers/d1-row-count-by-event.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,gBAAgB,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAA;AAGzF,KAAK,uBAAuB,GAAG,OAAO,CAAC,gBAAgB,EAAE;IAAE,OAAO,EAAE,uBAAuB,CAAA;CAAE,CAAC,CAAA;AAE9F,wBAAsB,wBAAwB,CAC7C,MAAM,EAAE,uBAAuB,EAC/B,MAAM,EAAE,oBAAoB,EAC5B,OAAO,EAAE,cAAc,GACrB,OAAO,CAAC,MAAM,CAAC,CAmBjB"}

package/dist/handlers/d1-row-count-by-event.js

@@ -0,0 +1,21 @@
+import { d1TimeBounds, numericResult, quoteIdentifier, resolveD1 } from './common.js';
+export async function computeD1RowCountByEvent(metric, window, context) {
+    if (metric.eventNames.length === 0)
+        return 0;
+    const d1 = resolveD1(context);
+    const eventColumn = metric.eventColumn ?? 'event_name';
+    const timeColumn = metric.timeColumn ?? 'processed_at';
+    const placeholders = metric.eventNames.map(() => '?').join(', ');
+    const [start, end] = d1TimeBounds(window, metric.timeColumnUnit);
+    const row = await d1
+        .prepare([
+        `SELECT COUNT(*) AS c FROM ${quoteIdentifier(metric.table)}`,
+        `WHERE ${quoteIdentifier(eventColumn)} IN (${placeholders})`,
+        `AND ${quoteIdentifier(timeColumn)} >= ?`,
+        `AND ${quoteIdentifier(timeColumn)} < ?`,
+    ].join(' '))
+        .bind(...metric.eventNames, start, end)
+        .first();
+    return numericResult(row);
+}
+//# sourceMappingURL=d1-row-count-by-event.js.map

package/dist/handlers/d1-row-count-by-event.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"d1-row-count-by-event.js","sourceRoot":"","sources":["../../src/handlers/d1-row-count-by-event.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,eAAe,EAAE,SAAS,EAAE,MAAM,aAAa,CAAA;AAIrF,MAAM,CAAC,KAAK,UAAU,wBAAwB,CAC7C,MAA+B,EAC/B,MAA4B,EAC5B,OAAuB;IAEvB,IAAI,MAAM,CAAC,UAAU,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,CAAC,CAAA;IAC5C,MAAM,EAAE,GAAG,SAAS,CAAC,OAAO,CAAC,CAAA;IAC7B,MAAM,WAAW,GAAG,MAAM,CAAC,WAAW,IAAI,YAAY,CAAA;IACtD,MAAM,UAAU,GAAG,MAAM,CAAC,UAAU,IAAI,cAAc,CAAA;IACtD,MAAM,YAAY,GAAG,MAAM,CAAC,UAAU,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;IAChE,MAAM,CAAC,KAAK,EAAE,GAAG,CAAC,GAAG,YAAY,CAAC,MAAM,EAAE,MAAM,CAAC,cAAc,CAAC,CAAA;IAChE,MAAM,GAAG,GAAG,MAAM,EAAE;SAClB,OAAO,CACP;QACC,6BAA6B,eAAe,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE;QAC5D,SAAS,eAAe,CAAC,WAAW,CAAC,QAAQ,YAAY,GAAG;QAC5D,OAAO,eAAe,CAAC,UAAU,CAAC,OAAO;QACzC,OAAO,eAAe,CAAC,UAAU,CAAC,MAAM;KACxC,CAAC,IAAI,CAAC,GAAG,CAAC,CACX;SACA,IAAI,CAAC,GAAG,MAAM,CAAC,UAAU,EAAE,KAAK,EAAE,GAAG,CAAC;SACtC,KAAK,EAA2B,CAAA;IAClC,OAAO,aAAa,CAAC,GAAG,CAAC,CAAA;AAC1B,CAAC"}

package/dist/handlers/d1-row-count.d.ts

@@ -0,0 +1,7 @@
+import type { HandlerContext, MetricDefinition, ResolvedDigestWindow } from '../types.js';
+type D1RowCountMetric = Extract<MetricDefinition, {
+    handler: 'd1.row-count';
+}>;
+export declare function computeD1RowCount(metric: D1RowCountMetric, window: ResolvedDigestWindow, context: HandlerContext): Promise<number>;
+export {};
+//# sourceMappingURL=d1-row-count.d.ts.map

package/dist/handlers/d1-row-count.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"d1-row-count.d.ts","sourceRoot":"","sources":["../../src/handlers/d1-row-count.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,gBAAgB,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAA;AAGzF,KAAK,gBAAgB,GAAG,OAAO,CAAC,gBAAgB,EAAE;IAAE,OAAO,EAAE,cAAc,CAAA;CAAE,CAAC,CAAA;AAE9E,wBAAsB,iBAAiB,CACtC,MAAM,EAAE,gBAAgB,EACxB,MAAM,EAAE,oBAAoB,EAC5B,OAAO,EAAE,cAAc,GACrB,OAAO,CAAC,MAAM,CAAC,CAWjB"}

package/dist/handlers/d1-row-count.js

@@ -0,0 +1,12 @@
+import { d1TimeBounds, numericResult, quoteIdentifier, resolveD1 } from './common.js';
+export async function computeD1RowCount(metric, window, context) {
+    const d1 = resolveD1(context);
+    const timeColumn = metric.timeColumn ?? 'created_at';
+    const [start, end] = d1TimeBounds(window, metric.timeColumnUnit);
+    const row = await d1
+        .prepare(`SELECT COUNT(*) AS c FROM ${quoteIdentifier(metric.table)} WHERE ${quoteIdentifier(timeColumn)} >= ? AND ${quoteIdentifier(timeColumn)} < ?`)
+        .bind(start, end)
+        .first();
+    return numericResult(row);
+}
+//# sourceMappingURL=d1-row-count.js.map

package/dist/handlers/d1-row-count.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"d1-row-count.js","sourceRoot":"","sources":["../../src/handlers/d1-row-count.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,eAAe,EAAE,SAAS,EAAE,MAAM,aAAa,CAAA;AAIrF,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACtC,MAAwB,EACxB,MAA4B,EAC5B,OAAuB;IAEvB,MAAM,EAAE,GAAG,SAAS,CAAC,OAAO,CAAC,CAAA;IAC7B,MAAM,UAAU,GAAG,MAAM,CAAC,UAAU,IAAI,YAAY,CAAA;IACpD,MAAM,CAAC,KAAK,EAAE,GAAG,CAAC,GAAG,YAAY,CAAC,MAAM,EAAE,MAAM,CAAC,cAAc,CAAC,CAAA;IAChE,MAAM,GAAG,GAAG,MAAM,EAAE;SAClB,OAAO,CACP,6BAA6B,eAAe,CAAC,MAAM,CAAC,KAAK,CAAC,UAAU,eAAe,CAAC,UAAU,CAAC,aAAa,eAAe,CAAC,UAAU,CAAC,MAAM,CAC7I;SACA,IAAI,CAAC,KAAK,EAAE,GAAG,CAAC;SAChB,KAAK,EAA2B,CAAA;IAClC,OAAO,aAAa,CAAC,GAAG,CAAC,CAAA;AAC1B,CAAC"}

package/dist/handlers/index.d.ts

@@ -0,0 +1,29 @@
+import type { HandlerContext, MetricDefinition, MetricValue, ResolvedDigestWindow } from '../types.js';
+export declare const handlerRegistry: {
+    readonly 'd1.row-count': {
+        readonly description: "Counts D1 rows in the digest window using a created/processed timestamp column.";
+    };
+    readonly 'd1.row-count-by-event': {
+        readonly description: "Counts D1 rows whose event column matches one of the configured event names.";
+    };
+    readonly 'wae.event-count': {
+        readonly description: "Counts WAE rows for one event name and optional realm/site filter.";
+    };
+    readonly 'wae.event-count-by-blob': {
+        readonly description: "Counts one WAE event grouped by a blob field.";
+    };
+    readonly 'wae.unique-count': {
+        readonly description: "Counts distinct values in a WAE blob field.";
+    };
+    readonly 'wae.avg-double': {
+        readonly description: "Averages a WAE double field.";
+    };
+    readonly 'wae.top-n-by-blob': {
+        readonly description: "Returns the top N WAE blob values by event count.";
+    };
+    readonly 'composite.ratio': {
+        readonly description: "Computes numerator / denominator using nested metric definitions.";
+    };
+};
+export declare function computeMetric(metric: MetricDefinition, window: ResolvedDigestWindow, context: HandlerContext): Promise<MetricValue>;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/handlers/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACX,cAAc,EACd,gBAAgB,EAChB,WAAW,EACX,oBAAoB,EACpB,MAAM,aAAa,CAAA;AAUpB,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;CAyBlB,CAAA;AAEV,wBAAsB,aAAa,CAClC,MAAM,EAAE,gBAAgB,EACxB,MAAM,EAAE,oBAAoB,EAC5B,OAAO,EAAE,cAAc,GACrB,OAAO,CAAC,WAAW,CAAC,CAqBtB"}