@growth-labs/ops-digest 0.1.0

package/dist/schema.d.ts

@@ -0,0 +1,264 @@
+import { z } from 'zod';
+import type { OpsDigestConfig } from './types.js';
+type MetricSchema = z.ZodType<OpsDigestConfig['digests'][number]['metrics'][number]>;
+export declare const opsDigestConfigSchema: z.ZodObject<{
+    realmId: z.ZodString;
+    d1Binding: z.ZodString;
+    authWae: z.ZodOptional<z.ZodEffects<z.ZodObject<{
+        accountId: z.ZodString;
+        dataset: z.ZodString;
+        apiTokenSecret: z.ZodString;
+        realmFilter: z.ZodOptional<z.ZodString>;
+        siteFilter: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        accountId: string;
+        dataset: string;
+        apiTokenSecret: string;
+        realmFilter?: string | undefined;
+        siteFilter?: string | undefined;
+    }, {
+        accountId: string;
+        dataset: string;
+        apiTokenSecret: string;
+        realmFilter?: string | undefined;
+        siteFilter?: string | undefined;
+    }>, {
+        accountId: string;
+        dataset: string;
+        apiTokenSecret: string;
+        realmFilter?: string | undefined;
+        siteFilter?: string | undefined;
+    }, {
+        accountId: string;
+        dataset: string;
+        apiTokenSecret: string;
+        realmFilter?: string | undefined;
+        siteFilter?: string | undefined;
+    }>>;
+    contentWae: z.ZodOptional<z.ZodEffects<z.ZodObject<{
+        accountId: z.ZodString;
+        dataset: z.ZodString;
+        apiTokenSecret: z.ZodString;
+        realmFilter: z.ZodOptional<z.ZodString>;
+        siteFilter: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        accountId: string;
+        dataset: string;
+        apiTokenSecret: string;
+        realmFilter?: string | undefined;
+        siteFilter?: string | undefined;
+    }, {
+        accountId: string;
+        dataset: string;
+        apiTokenSecret: string;
+        realmFilter?: string | undefined;
+        siteFilter?: string | undefined;
+    }>, {
+        accountId: string;
+        dataset: string;
+        apiTokenSecret: string;
+        realmFilter?: string | undefined;
+        siteFilter?: string | undefined;
+    }, {
+        accountId: string;
+        dataset: string;
+        apiTokenSecret: string;
+        realmFilter?: string | undefined;
+        siteFilter?: string | undefined;
+    }>>;
+    extraWae: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodEffects<z.ZodObject<{
+        accountId: z.ZodString;
+        dataset: z.ZodString;
+        apiTokenSecret: z.ZodString;
+        realmFilter: z.ZodOptional<z.ZodString>;
+        siteFilter: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        accountId: string;
+        dataset: string;
+        apiTokenSecret: string;
+        realmFilter?: string | undefined;
+        siteFilter?: string | undefined;
+    }, {
+        accountId: string;
+        dataset: string;
+        apiTokenSecret: string;
+        realmFilter?: string | undefined;
+        siteFilter?: string | undefined;
+    }>, {
+        accountId: string;
+        dataset: string;
+        apiTokenSecret: string;
+        realmFilter?: string | undefined;
+        siteFilter?: string | undefined;
+    }, {
+        accountId: string;
+        dataset: string;
+        apiTokenSecret: string;
+        realmFilter?: string | undefined;
+        siteFilter?: string | undefined;
+    }>>>;
+    idempotencyKv: z.ZodString;
+    notifyConfig: z.ZodObject<{}, "passthrough", z.ZodTypeAny, z.objectOutputType<{}, z.ZodTypeAny, "passthrough">, z.objectInputType<{}, z.ZodTypeAny, "passthrough">>;
+    digests: z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        brandLabel: z.ZodString;
+        schedule: z.ZodString;
+        window: z.ZodUnion<[z.ZodLiteral<"previous-day-utc">, z.ZodLiteral<"previous-week-utc">, z.ZodLiteral<"previous-month-utc">, z.ZodObject<{
+            days: z.ZodNumber;
+            anchorTo: z.ZodLiteral<"utc-midnight">;
+        }, "strip", z.ZodTypeAny, {
+            days: number;
+            anchorTo: "utc-midnight";
+        }, {
+            days: number;
+            anchorTo: "utc-midnight";
+        }>]>;
+        metrics: z.ZodArray<MetricSchema, "many">;
+        anomaly: z.ZodObject<{
+            method: z.ZodEnum<["iqr", "none"]>;
+            medianFloor: z.ZodNumber;
+            iqrMultiplier: z.ZodOptional<z.ZodNumber>;
+            overrides: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{}, "passthrough", z.ZodTypeAny, z.objectOutputType<{}, z.ZodTypeAny, "passthrough">, z.objectInputType<{}, z.ZodTypeAny, "passthrough">>>>;
+        }, "strip", z.ZodTypeAny, {
+            method: "iqr" | "none";
+            medianFloor: number;
+            iqrMultiplier?: number | undefined;
+            overrides?: Record<string, z.objectOutputType<{}, z.ZodTypeAny, "passthrough">> | undefined;
+        }, {
+            method: "iqr" | "none";
+            medianFloor: number;
+            iqrMultiplier?: number | undefined;
+            overrides?: Record<string, z.objectInputType<{}, z.ZodTypeAny, "passthrough">> | undefined;
+        }>;
+        render: z.ZodString;
+        channels: z.ZodArray<z.ZodEnum<["slack", "email"]>, "many">;
+    }, "strip", z.ZodTypeAny, {
+        channels: ("slack" | "email")[];
+        name: string;
+        anomaly: {
+            method: "iqr" | "none";
+            medianFloor: number;
+            iqrMultiplier?: number | undefined;
+            overrides?: Record<string, z.objectOutputType<{}, z.ZodTypeAny, "passthrough">> | undefined;
+        };
+        metrics: import("./types.js").MetricDefinition[];
+        brandLabel: string;
+        schedule: string;
+        window: "previous-day-utc" | "previous-week-utc" | "previous-month-utc" | {
+            days: number;
+            anchorTo: "utc-midnight";
+        };
+        render: string;
+    }, {
+        channels: ("slack" | "email")[];
+        name: string;
+        anomaly: {
+            method: "iqr" | "none";
+            medianFloor: number;
+            iqrMultiplier?: number | undefined;
+            overrides?: Record<string, z.objectInputType<{}, z.ZodTypeAny, "passthrough">> | undefined;
+        };
+        metrics: import("./types.js").MetricDefinition[];
+        brandLabel: string;
+        schedule: string;
+        window: "previous-day-utc" | "previous-week-utc" | "previous-month-utc" | {
+            days: number;
+            anchorTo: "utc-midnight";
+        };
+        render: string;
+    }>, "many">;
+}, "strip", z.ZodTypeAny, {
+    digests: {
+        channels: ("slack" | "email")[];
+        name: string;
+        anomaly: {
+            method: "iqr" | "none";
+            medianFloor: number;
+            iqrMultiplier?: number | undefined;
+            overrides?: Record<string, z.objectOutputType<{}, z.ZodTypeAny, "passthrough">> | undefined;
+        };
+        metrics: import("./types.js").MetricDefinition[];
+        brandLabel: string;
+        schedule: string;
+        window: "previous-day-utc" | "previous-week-utc" | "previous-month-utc" | {
+            days: number;
+            anchorTo: "utc-midnight";
+        };
+        render: string;
+    }[];
+    realmId: string;
+    d1Binding: string;
+    idempotencyKv: string;
+    notifyConfig: {} & {
+        [k: string]: unknown;
+    };
+    authWae?: {
+        accountId: string;
+        dataset: string;
+        apiTokenSecret: string;
+        realmFilter?: string | undefined;
+        siteFilter?: string | undefined;
+    } | undefined;
+    contentWae?: {
+        accountId: string;
+        dataset: string;
+        apiTokenSecret: string;
+        realmFilter?: string | undefined;
+        siteFilter?: string | undefined;
+    } | undefined;
+    extraWae?: Record<string, {
+        accountId: string;
+        dataset: string;
+        apiTokenSecret: string;
+        realmFilter?: string | undefined;
+        siteFilter?: string | undefined;
+    }> | undefined;
+}, {
+    digests: {
+        channels: ("slack" | "email")[];
+        name: string;
+        anomaly: {
+            method: "iqr" | "none";
+            medianFloor: number;
+            iqrMultiplier?: number | undefined;
+            overrides?: Record<string, z.objectInputType<{}, z.ZodTypeAny, "passthrough">> | undefined;
+        };
+        metrics: import("./types.js").MetricDefinition[];
+        brandLabel: string;
+        schedule: string;
+        window: "previous-day-utc" | "previous-week-utc" | "previous-month-utc" | {
+            days: number;
+            anchorTo: "utc-midnight";
+        };
+        render: string;
+    }[];
+    realmId: string;
+    d1Binding: string;
+    idempotencyKv: string;
+    notifyConfig: {} & {
+        [k: string]: unknown;
+    };
+    authWae?: {
+        accountId: string;
+        dataset: string;
+        apiTokenSecret: string;
+        realmFilter?: string | undefined;
+        siteFilter?: string | undefined;
+    } | undefined;
+    contentWae?: {
+        accountId: string;
+        dataset: string;
+        apiTokenSecret: string;
+        realmFilter?: string | undefined;
+        siteFilter?: string | undefined;
+    } | undefined;
+    extraWae?: Record<string, {
+        accountId: string;
+        dataset: string;
+        apiTokenSecret: string;
+        realmFilter?: string | undefined;
+        siteFilter?: string | undefined;
+    }> | undefined;
+}>;
+export {};
+//# sourceMappingURL=schema.d.ts.map

package/dist/schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../src/schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AACvB,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAA;AAmCjD,KAAK,YAAY,GAAG,CAAC,CAAC,OAAO,CAAC,eAAe,CAAC,SAAS,CAAC,CAAC,MAAM,CAAC,CAAC,SAAS,CAAC,CAAC,MAAM,CAAC,CAAC,CAAA;AAoEpF,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAShC,CAAA"}

package/dist/schema.js

@@ -0,0 +1,102 @@
+import { z } from 'zod';
+const waeSourceSchema = z
+    .object({
+    accountId: z.string().min(1),
+    dataset: z.string().min(1),
+    apiTokenSecret: z.string().min(1),
+    realmFilter: z.string().min(1).optional(),
+    siteFilter: z.string().min(1).optional(),
+})
+    .refine((source) => !(source.realmFilter && source.siteFilter), {
+    message: 'Configure either realmFilter or siteFilter, not both',
+});
+const windowSpecSchema = z.union([
+    z.literal('previous-day-utc'),
+    z.literal('previous-week-utc'),
+    z.literal('previous-month-utc'),
+    z.object({ days: z.number().int().positive(), anchorTo: z.literal('utc-midnight') }),
+]);
+const d1RowCountSchema = z.object({
+    handler: z.literal('d1.row-count'),
+    name: z.string().min(1),
+    table: z.string().min(1),
+    timeColumn: z.string().min(1).optional(),
+    timeColumnUnit: z.enum(['s', 'ms']).optional(),
+});
+const d1RowCountByEventSchema = d1RowCountSchema.extend({
+    handler: z.literal('d1.row-count-by-event'),
+    eventNames: z.array(z.string().min(1)).min(1),
+    eventColumn: z.string().min(1).optional(),
+});
+const metricSchema = z.lazy(() => z.discriminatedUnion('handler', [
+    d1RowCountSchema,
+    d1RowCountByEventSchema,
+    z.object({
+        handler: z.literal('wae.event-count'),
+        name: z.string().min(1),
+        source: z.string().min(1),
+        eventName: z.string().min(1),
+    }),
+    z.object({
+        handler: z.literal('wae.event-count-by-blob'),
+        name: z.string().min(1),
+        source: z.string().min(1),
+        eventName: z.string().min(1),
+        groupBy: z.string().min(1),
+    }),
+    z.object({
+        handler: z.literal('wae.unique-count'),
+        name: z.string().min(1),
+        source: z.string().min(1),
+        eventName: z.string().min(1).optional(),
+        uniqueBlob: z.string().min(1),
+    }),
+    z.object({
+        handler: z.literal('wae.avg-double'),
+        name: z.string().min(1),
+        source: z.string().min(1),
+        eventName: z.string().min(1).optional(),
+        doubleField: z.string().min(1),
+    }),
+    z.object({
+        handler: z.literal('wae.top-n-by-blob'),
+        name: z.string().min(1),
+        source: z.string().min(1),
+        eventName: z.string().min(1).optional(),
+        groupBy: z.string().min(1),
+        limit: z.number().int().positive(),
+    }),
+    z.object({
+        handler: z.literal('composite.ratio'),
+        name: z.string().min(1),
+        numerator: metricSchema,
+        denominator: metricSchema,
+    }),
+]));
+const anomalySchema = z.object({
+    method: z.enum(['iqr', 'none']),
+    medianFloor: z.number().min(0),
+    iqrMultiplier: z.number().positive().optional(),
+    overrides: z.record(z.string(), z.object({}).passthrough()).optional(),
+});
+const digestSchema = z.object({
+    name: z.string().min(1),
+    brandLabel: z.string().min(1),
+    schedule: z.string().min(1),
+    window: windowSpecSchema,
+    metrics: z.array(metricSchema),
+    anomaly: anomalySchema,
+    render: z.string().min(1),
+    channels: z.array(z.enum(['slack', 'email'])).min(1),
+});
+export const opsDigestConfigSchema = z.object({
+    realmId: z.string().min(1),
+    d1Binding: z.string().min(1),
+    authWae: waeSourceSchema.optional(),
+    contentWae: waeSourceSchema.optional(),
+    extraWae: z.record(z.string(), waeSourceSchema).optional(),
+    idempotencyKv: z.string().min(1),
+    notifyConfig: z.object({}).passthrough(),
+    digests: z.array(digestSchema).min(1),
+});
+//# sourceMappingURL=schema.js.map

package/dist/schema.js.map

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

package/dist/types.d.ts

@@ -0,0 +1,146 @@
+import type { WindowSpec } from '@growth-labs/analytics/utils/time-windows';
+import type { Channel, EmailProvider, NotifyEnv, NotifyInput, Severity } from '@growth-labs/notify';
+export type { Channel, Severity, WindowSpec };
+export type NotifyConfig = Partial<Pick<NotifyInput, 'blocks' | 'dedupFn' | 'onSent' | 'emailProvider'>> & {
+    channels?: Channel[];
+    severity?: Severity;
+    emailProvider?: EmailProvider;
+};
+export interface OpsDigestConfig {
+    realmId: string;
+    d1Binding: string;
+    authWae?: WaeSourceConfig;
+    contentWae?: WaeSourceConfig;
+    extraWae?: Record<string, WaeSourceConfig>;
+    idempotencyKv: string;
+    notifyConfig: NotifyConfig;
+    digests: DigestDefinition[];
+}
+export interface WaeSourceConfig {
+    accountId: string;
+    dataset: string;
+    apiTokenSecret: string;
+    realmFilter?: string;
+    siteFilter?: string;
+}
+export interface DigestDefinition {
+    name: string;
+    brandLabel: string;
+    schedule: string;
+    window: WindowSpec;
+    metrics: MetricDefinition[];
+    anomaly: AnomalyConfig;
+    render: 'standard' | string;
+    channels: Channel[];
+}
+interface D1MetricBase {
+    name: string;
+    table: string;
+    timeColumn?: string;
+    timeColumnUnit?: 's' | 'ms';
+}
+export type MetricDefinition = ({
+    handler: 'd1.row-count';
+} & D1MetricBase) | ({
+    handler: 'd1.row-count-by-event';
+    eventNames: string[];
+    eventColumn?: string;
+} & D1MetricBase) | {
+    handler: 'wae.event-count';
+    name: string;
+    source: string;
+    eventName: string;
+} | {
+    handler: 'wae.event-count-by-blob';
+    name: string;
+    source: string;
+    eventName: string;
+    groupBy: string;
+} | {
+    handler: 'wae.unique-count';
+    name: string;
+    source: string;
+    eventName?: string;
+    uniqueBlob: string;
+} | {
+    handler: 'wae.avg-double';
+    name: string;
+    source: string;
+    eventName?: string;
+    doubleField: string;
+} | {
+    handler: 'wae.top-n-by-blob';
+    name: string;
+    source: string;
+    eventName?: string;
+    groupBy: string;
+    limit: number;
+} | {
+    handler: 'composite.ratio';
+    name: string;
+    numerator: MetricDefinition;
+    denominator: MetricDefinition;
+};
+export interface AnomalyConfig {
+    method: 'iqr' | 'none';
+    medianFloor: number;
+    iqrMultiplier?: number;
+    overrides?: Record<string, Partial<AnomalyConfig>>;
+}
+export interface AnomalyHit {
+    metric: string;
+    current: number;
+    median: number;
+    iqr: number;
+    lowerBand: number;
+    upperBand: number;
+    direction: 'above' | 'below';
+}
+export interface OpsDigestHandle {
+    scheduledHandler: (event: ScheduledEvent, env: OpsDigestEnv, ctx: ExecutionContext) => Promise<void>;
+    runDigest: (digestName: string, env: OpsDigestEnv, ctx: ExecutionContext) => Promise<DigestRunResult>;
+}
+export interface DigestRunResult {
+    digestName: string;
+    windowStart: number;
+    windowEnd: number;
+    rendered: string;
+    idempotencyKey: string;
+    posted: boolean;
+    metrics: MetricResult[];
+    errors: string[];
+}
+export interface PercentChange {
+    value: string;
+    direction: 'up' | 'down' | 'flat';
+}
+export type GroupedMetricResult = Record<string, number>;
+export type TopNResult = {
+    group: string;
+    count: number;
+}[];
+export type MetricValue = number | GroupedMetricResult | TopNResult;
+export interface MetricResult {
+    name: string;
+    current: MetricValue;
+    baseline: number;
+    delta: PercentChange;
+    anomaly?: AnomalyHit;
+}
+export interface ResolvedDigestWindow {
+    startMs: number;
+    endMs: number;
+    sqlStart: string;
+    sqlEnd: string;
+}
+export interface HandlerContext {
+    d1?: D1Database;
+    sources?: Record<string, WaeSourceConfig>;
+    env?: OpsDigestEnv;
+}
+export type MetricHandler<T extends MetricDefinition = MetricDefinition> = (metric: T, window: ResolvedDigestWindow, context: HandlerContext) => Promise<MetricValue>;
+export interface OpsDigestEnv extends NotifyEnv {
+    fetch?: typeof fetch;
+    [key: string]: unknown;
+}
+//# 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,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}

package/dist/window.d.ts

@@ -0,0 +1,7 @@
+import { type WindowSpec } from '@growth-labs/analytics/utils/time-windows';
+import type { ResolvedDigestWindow } from './types.js';
+export declare function resolveDigestWindow(spec: WindowSpec, now?: number): ResolvedDigestWindow;
+export declare function shiftWindowDays(window: ResolvedDigestWindow, daysBack: number): ResolvedDigestWindow;
+export declare function splitTrailingDays(window: ResolvedDigestWindow, days: number): ResolvedDigestWindow[];
+export declare function waeWindowSql(window: ResolvedDigestWindow, timestampColumn?: string): string;
+//# sourceMappingURL=window.d.ts.map

package/dist/window.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"window.d.ts","sourceRoot":"","sources":["../src/window.ts"],"names":[],"mappings":"AAAA,OAAO,EAAiB,KAAK,UAAU,EAAE,MAAM,2CAA2C,CAAA;AAC1F,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAA;AAItD,wBAAgB,mBAAmB,CAClC,IAAI,EAAE,UAAU,EAChB,GAAG,GAAE,MAAmB,GACtB,oBAAoB,CAEtB;AAED,wBAAgB,eAAe,CAC9B,MAAM,EAAE,oBAAoB,EAC5B,QAAQ,EAAE,MAAM,GACd,oBAAoB,CAGtB;AAED,wBAAgB,iBAAiB,CAChC,MAAM,EAAE,oBAAoB,EAC5B,IAAI,EAAE,MAAM,GACV,oBAAoB,EAAE,CAExB;AAED,wBAAgB,YAAY,CAAC,MAAM,EAAE,oBAAoB,EAAE,eAAe,SAAc,GAAG,MAAM,CAEhG"}

package/dist/window.js

@@ -0,0 +1,28 @@
+import { resolveWindow } from '@growth-labs/analytics/utils/time-windows';
+const DAY_MS = 24 * 60 * 60 * 1000;
+export function resolveDigestWindow(spec, now = Date.now()) {
+    return resolveWindow(spec, now);
+}
+export function shiftWindowDays(window, daysBack) {
+    const delta = daysBack * DAY_MS;
+    return literalWindow(window.startMs - delta, window.endMs - delta);
+}
+export function splitTrailingDays(window, days) {
+    return Array.from({ length: days }, (_, index) => shiftWindowDays(window, index + 1));
+}
+export function waeWindowSql(window, timestampColumn = 'timestamp') {
+    return `${timestampColumn} >= ${window.sqlStart} AND ${timestampColumn} < ${window.sqlEnd}`;
+}
+function literalWindow(startMs, endMs) {
+    return {
+        startMs,
+        endMs,
+        sqlStart: `toDateTime('${formatSqlDateTime(startMs)}')`,
+        sqlEnd: `toDateTime('${formatSqlDateTime(endMs)}')`,
+    };
+}
+function formatSqlDateTime(ms) {
+    const iso = new Date(ms).toISOString();
+    return iso.slice(0, 19).replace('T', ' ');
+}
+//# sourceMappingURL=window.js.map

package/dist/window.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"window.js","sourceRoot":"","sources":["../src/window.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAmB,MAAM,2CAA2C,CAAA;AAG1F,MAAM,MAAM,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAAA;AAElC,MAAM,UAAU,mBAAmB,CAClC,IAAgB,EAChB,MAAc,IAAI,CAAC,GAAG,EAAE;IAExB,OAAO,aAAa,CAAC,IAAI,EAAE,GAAG,CAAC,CAAA;AAChC,CAAC;AAED,MAAM,UAAU,eAAe,CAC9B,MAA4B,EAC5B,QAAgB;IAEhB,MAAM,KAAK,GAAG,QAAQ,GAAG,MAAM,CAAA;IAC/B,OAAO,aAAa,CAAC,MAAM,CAAC,OAAO,GAAG,KAAK,EAAE,MAAM,CAAC,KAAK,GAAG,KAAK,CAAC,CAAA;AACnE,CAAC;AAED,MAAM,UAAU,iBAAiB,CAChC,MAA4B,EAC5B,IAAY;IAEZ,OAAO,KAAK,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,EAAE,CAAC,CAAC,EAAE,KAAK,EAAE,EAAE,CAAC,eAAe,CAAC,MAAM,EAAE,KAAK,GAAG,CAAC,CAAC,CAAC,CAAA;AACtF,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,MAA4B,EAAE,eAAe,GAAG,WAAW;IACvF,OAAO,GAAG,eAAe,OAAO,MAAM,CAAC,QAAQ,QAAQ,eAAe,MAAM,MAAM,CAAC,MAAM,EAAE,CAAA;AAC5F,CAAC;AAED,SAAS,aAAa,CAAC,OAAe,EAAE,KAAa;IACpD,OAAO;QACN,OAAO;QACP,KAAK;QACL,QAAQ,EAAE,eAAe,iBAAiB,CAAC,OAAO,CAAC,IAAI;QACvD,MAAM,EAAE,eAAe,iBAAiB,CAAC,KAAK,CAAC,IAAI;KACnD,CAAA;AACF,CAAC;AAED,SAAS,iBAAiB,CAAC,EAAU;IACpC,MAAM,GAAG,GAAG,IAAI,IAAI,CAAC,EAAE,CAAC,CAAC,WAAW,EAAE,CAAA;IACtC,OAAO,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,GAAG,EAAE,GAAG,CAAC,CAAA;AAC1C,CAAC"}

package/package.json

@@ -0,0 +1,40 @@
+{
+  "name": "@growth-labs/ops-digest",
+  "version": "0.1.0",
+  "description": "Worker-runtime digest engine for D1/WAE operational metrics, anomaly callouts, notify delivery, and KV idempotency.",
+  "type": "module",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "SPEC.md",
+    "CHANGELOG.md"
+  ],
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  },
+  "dependencies": {
+    "@growth-labs/analytics": "^0.3.0",
+    "@growth-labs/notify": "^0.1.0",
+    "zod": "^3.23.0"
+  },
+  "devDependencies": {
+    "@cloudflare/workers-types": "^4.0.0",
+    "typescript": "^5.7.0",
+    "vitest": "^3.0.0"
+  },
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "test": "tsc --noEmit -p tsconfig.test.json && vitest run",
+    "test:watch": "vitest",
+    "check": "biome check src/ __tests__"
+  }
+}