@mongrov/analytics 0.1.0-alpha.0 → 0.1.0-alpha.10

package/dist/rules/defaults/loader.js

@@ -0,0 +1,37 @@
+/**
+ * TOML catalog parser for brand default rules.
+ *
+ * A catalog is a TOML document with one or more `[[rule]]` array-of-tables
+ * entries; each entry is passed through `RuleSchema.safeParse` so bad
+ * catalogs fail at package load time with a precise message.
+ *
+ * The parser only wraps `@iarna/toml` — a TOML syntax error is rethrown as
+ * a `RuleValidationError` with a catalog-aware prefix so consumers can
+ * locate the offending brand file.
+ */
+import TOML from '@iarna/toml';
+import { RuleSchema, RuleValidationError } from '../schema';
+export function parseCatalog(toml, options) {
+    const label = options?.name ?? 'catalog';
+    let doc;
+    try {
+        doc = TOML.parse(toml);
+    }
+    catch (err) {
+        throw new RuleValidationError(`${label}: TOML parse error — ${err.message}`);
+    }
+    const raw = doc.rule;
+    if (!Array.isArray(raw)) {
+        throw new RuleValidationError(`${label}: missing [[rule]] entries`);
+    }
+    const rules = [];
+    for (let i = 0; i < raw.length; i++) {
+        const parsed = RuleSchema.safeParse(raw[i]);
+        if (!parsed.success) {
+            throw new RuleValidationError(`${label}: rule ${i} invalid — ${parsed.error.message}`);
+        }
+        rules.push(parsed.data);
+    }
+    return rules;
+}
+//# sourceMappingURL=loader.js.map

package/dist/rules/defaults/loader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"loader.js","sourceRoot":"","sources":["../../../src/rules/defaults/loader.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,IAAI,MAAM,aAAa,CAAA;AAC9B,OAAO,EAAE,UAAU,EAAE,mBAAmB,EAAa,MAAM,WAAW,CAAA;AAWtE,MAAM,UAAU,YAAY,CAC1B,IAAY,EACZ,OAA6B;IAE7B,MAAM,KAAK,GAAG,OAAO,EAAE,IAAI,IAAI,SAAS,CAAA;IACxC,IAAI,GAAe,CAAA;IACnB,IAAI,CAAC;QACH,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAe,CAAA;IACtC,CAAC;IACD,OAAO,GAAG,EAAE,CAAC;QACX,MAAM,IAAI,mBAAmB,CAC3B,GAAG,KAAK,wBAAyB,GAAa,CAAC,OAAO,EAAE,CACzD,CAAA;IACH,CAAC;IAED,MAAM,GAAG,GAAG,GAAG,CAAC,IAAI,CAAA;IACpB,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;QACxB,MAAM,IAAI,mBAAmB,CAC3B,GAAG,KAAK,4BAA4B,CACrC,CAAA;IACH,CAAC;IAED,MAAM,KAAK,GAAW,EAAE,CAAA;IACxB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,GAAG,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACpC,MAAM,MAAM,GAAG,UAAU,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAA;QAC3C,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;YACpB,MAAM,IAAI,mBAAmB,CAC3B,GAAG,KAAK,UAAU,CAAC,cAAc,MAAM,CAAC,KAAK,CAAC,OAAO,EAAE,CACxD,CAAA;QACH,CAAC;QACD,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,CAAA;IACzB,CAAC;IACD,OAAO,KAAK,CAAA;AACd,CAAC"}

package/dist/rules/defaults/luminx.d.ts

@@ -0,0 +1,6 @@
+/**
+ * LuminX brand default rules. Sidecar: `luminx.toml`.
+ */
+import type { Rule } from '../schema';
+export declare const luminxDefaults: Rule[];
+//# sourceMappingURL=luminx.d.ts.map

package/dist/rules/defaults/luminx.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"luminx.d.ts","sourceRoot":"","sources":["../../../src/rules/defaults/luminx.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,WAAW,CAAA;AA6DrC,eAAO,MAAM,cAAc,EAAE,IAAI,EAA2C,CAAA"}

package/dist/rules/defaults/luminx.js

@@ -0,0 +1,64 @@
+/**
+ * LuminX brand default rules. Sidecar: `luminx.toml`.
+ */
+import { parseCatalog } from './loader';
+const TOML = `
+[[rule]]
+id = "luminx.battery-low"
+brand = "luminx"
+name = "LuminX battery low"
+description = "Device battery below 15% in the past hour."
+metric = "device_battery"
+window = "1h"
+aggregation = "last"
+compare = "less_than"
+severity = "warn"
+
+[rule.target]
+type = "absolute"
+value = 15
+
+[rule.throttle]
+minGapMinutes = 240
+maxPerDay = 3
+
+[[rule]]
+id = "luminx.battery-critical"
+brand = "luminx"
+name = "LuminX battery critical"
+description = "Device battery below 5% — connectivity likely to drop."
+metric = "device_battery"
+window = "1h"
+aggregation = "last"
+compare = "less_than"
+severity = "critical"
+
+[rule.target]
+type = "absolute"
+value = 5
+
+[rule.throttle]
+minGapMinutes = 60
+maxPerDay = 4
+
+[[rule]]
+id = "luminx.disconnect-24h"
+brand = "luminx"
+name = "LuminX disconnected"
+description = "No device battery events observed in the past 24h."
+metric = "device_battery"
+window = "24h"
+aggregation = "count"
+compare = "equals"
+severity = "warn"
+
+[rule.target]
+type = "absolute"
+value = 0
+
+[rule.throttle]
+minGapMinutes = 720
+maxPerDay = 1
+`;
+export const luminxDefaults = parseCatalog(TOML, { name: 'luminx' });
+//# sourceMappingURL=luminx.js.map

package/dist/rules/defaults/luminx.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"luminx.js","sourceRoot":"","sources":["../../../src/rules/defaults/luminx.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,UAAU,CAAA;AAGvC,MAAM,IAAI,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAyDZ,CAAA;AAED,MAAM,CAAC,MAAM,cAAc,GAAW,YAAY,CAAC,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC,CAAA"}

package/dist/rules/defaults/viva.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Viva brand default rules. Sidecar: `viva.toml`.
+ */
+import type { Rule } from '../schema';
+export declare const vivaDefaults: Rule[];
+//# sourceMappingURL=viva.d.ts.map

package/dist/rules/defaults/viva.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"viva.d.ts","sourceRoot":"","sources":["../../../src/rules/defaults/viva.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,WAAW,CAAA;AA0CrC,eAAO,MAAM,YAAY,EAAE,IAAI,EAAyC,CAAA"}

package/dist/rules/defaults/viva.js

@@ -0,0 +1,45 @@
+/**
+ * Viva brand default rules. Sidecar: `viva.toml`.
+ */
+import { parseCatalog } from './loader';
+const TOML = `
+[[rule]]
+id = "viva.battery-low"
+brand = "viva"
+name = "Viva battery low"
+description = "Device battery below 20% in the past hour."
+metric = "device_battery"
+window = "1h"
+aggregation = "last"
+compare = "less_than"
+severity = "warn"
+
+[rule.target]
+type = "absolute"
+value = 20
+
+[rule.throttle]
+minGapMinutes = 360
+maxPerDay = 2
+
+[[rule]]
+id = "viva.disconnect-24h"
+brand = "viva"
+name = "Viva disconnected"
+description = "No device battery events observed in the past 24h."
+metric = "device_battery"
+window = "24h"
+aggregation = "count"
+compare = "equals"
+severity = "warn"
+
+[rule.target]
+type = "absolute"
+value = 0
+
+[rule.throttle]
+minGapMinutes = 720
+maxPerDay = 1
+`;
+export const vivaDefaults = parseCatalog(TOML, { name: 'viva' });
+//# sourceMappingURL=viva.js.map

package/dist/rules/defaults/viva.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"viva.js","sourceRoot":"","sources":["../../../src/rules/defaults/viva.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,UAAU,CAAA;AAGvC,MAAM,IAAI,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAsCZ,CAAA;AAED,MAAM,CAAC,MAAM,YAAY,GAAW,YAAY,CAAC,IAAI,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,CAAA"}

package/dist/rules/defaults/yogaring.d.ts

@@ -0,0 +1,6 @@
+/**
+ * YogaRing brand default rules. Sidecar: `yogaring.toml`.
+ */
+import type { Rule } from '../schema';
+export declare const yogaringDefaults: Rule[];
+//# sourceMappingURL=yogaring.d.ts.map

package/dist/rules/defaults/yogaring.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"yogaring.d.ts","sourceRoot":"","sources":["../../../src/rules/defaults/yogaring.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,WAAW,CAAA;AA0CrC,eAAO,MAAM,gBAAgB,EAAE,IAAI,EAA6C,CAAA"}

package/dist/rules/defaults/yogaring.js

@@ -0,0 +1,45 @@
+/**
+ * YogaRing brand default rules. Sidecar: `yogaring.toml`.
+ */
+import { parseCatalog } from './loader';
+const TOML = `
+[[rule]]
+id = "yogaring.stress-elevated"
+brand = "yogaring"
+name = "YogaRing stress nudge"
+description = "Average stress score over 6h rose above 65."
+metric = "stress"
+window = "6h"
+aggregation = "avg"
+compare = "greater_than"
+severity = "info"
+
+[rule.target]
+type = "absolute"
+value = 65
+
+[rule.throttle]
+minGapMinutes = 240
+maxPerDay = 2
+
+[[rule]]
+id = "yogaring.activity-low"
+brand = "yogaring"
+name = "YogaRing activity nudge"
+description = "Daily step count is below 2500."
+metric = "activity_steps"
+window = "24h"
+aggregation = "sum"
+compare = "less_than"
+severity = "info"
+
+[rule.target]
+type = "absolute"
+value = 2500
+
+[rule.throttle]
+minGapMinutes = 720
+maxPerDay = 1
+`;
+export const yogaringDefaults = parseCatalog(TOML, { name: 'yogaring' });
+//# sourceMappingURL=yogaring.js.map

package/dist/rules/defaults/yogaring.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"yogaring.js","sourceRoot":"","sources":["../../../src/rules/defaults/yogaring.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,UAAU,CAAA;AAGvC,MAAM,IAAI,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAsCZ,CAAA;AAED,MAAM,CAAC,MAAM,gBAAgB,GAAW,YAAY,CAAC,IAAI,EAAE,EAAE,IAAI,EAAE,UAAU,EAAE,CAAC,CAAA"}

package/dist/rules/defaults/ziva.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Ziva brand default rules.
+ *
+ * The template string below is a verbatim copy of `ziva.toml`. Edit the
+ * TOML sidecar, then either run `scripts/sync-toml.mjs` or copy-paste
+ * back into this literal. Metro/tsup do not read `.toml` files directly.
+ */
+import type { Rule } from '../schema';
+export declare const zivaDefaults: Rule[];
+//# sourceMappingURL=ziva.d.ts.map

package/dist/rules/defaults/ziva.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ziva.d.ts","sourceRoot":"","sources":["../../../src/rules/defaults/ziva.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,WAAW,CAAA;AAgFrC,eAAO,MAAM,YAAY,EAAE,IAAI,EAAyC,CAAA"}

package/dist/rules/defaults/ziva.js

@@ -0,0 +1,87 @@
+/**
+ * Ziva brand default rules.
+ *
+ * The template string below is a verbatim copy of `ziva.toml`. Edit the
+ * TOML sidecar, then either run `scripts/sync-toml.mjs` or copy-paste
+ * back into this literal. Metro/tsup do not read `.toml` files directly.
+ */
+import { parseCatalog } from './loader';
+const TOML = `
+[[rule]]
+id = "ziva.hrv-drop-30"
+brand = "ziva"
+name = "HRV drop below 30 ms"
+description = "Average HRV over the last 24h fell below 30 ms."
+metric = "hrv_ms"
+window = "24h"
+aggregation = "avg"
+compare = "less_than"
+severity = "warn"
+
+[rule.target]
+type = "absolute"
+value = 30
+
+[rule.throttle]
+minGapMinutes = 360
+maxPerDay = 2
+
+[[rule]]
+id = "ziva.sleep-deprivation-3d"
+brand = "ziva"
+name = "Sleep deprivation"
+description = "Average nightly sleep across 3 nights below 360 minutes."
+metric = "sleep_total_minutes"
+window = "3d"
+aggregation = "avg"
+compare = "less_than"
+severity = "warn"
+
+[rule.target]
+type = "absolute"
+value = 360
+
+[rule.throttle]
+minGapMinutes = 720
+maxPerDay = 1
+
+[[rule]]
+id = "ziva.stress-elevated"
+brand = "ziva"
+name = "Elevated stress"
+description = "Average stress score over 6h rose above 70."
+metric = "stress"
+window = "6h"
+aggregation = "avg"
+compare = "greater_than"
+severity = "info"
+
+[rule.target]
+type = "absolute"
+value = 70
+
+[rule.throttle]
+minGapMinutes = 120
+maxPerDay = 3
+
+[[rule]]
+id = "ziva.activity-low-24h"
+brand = "ziva"
+name = "Low activity"
+description = "Daily step count is below 3000."
+metric = "activity_steps"
+window = "24h"
+aggregation = "sum"
+compare = "less_than"
+severity = "info"
+
+[rule.target]
+type = "absolute"
+value = 3000
+
+[rule.throttle]
+minGapMinutes = 720
+maxPerDay = 1
+`;
+export const zivaDefaults = parseCatalog(TOML, { name: 'ziva' });
+//# sourceMappingURL=ziva.js.map

package/dist/rules/defaults/ziva.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ziva.js","sourceRoot":"","sources":["../../../src/rules/defaults/ziva.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,UAAU,CAAA;AAGvC,MAAM,IAAI,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA4EZ,CAAA;AAED,MAAM,CAAC,MAAM,YAAY,GAAW,YAAY,CAAC,IAAI,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,CAAA"}

package/dist/rules/emitter.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Minimal typed event emitter for the rules engine.
+ *
+ * Only the `'violation'` event is supported. Handler exceptions are
+ * caught and logged so a single subscriber can't take down evaluation.
+ * `on(...)` returns an `Unsubscribe` closure per spec's public surface.
+ */
+import type { Unsubscribe } from '../core/types';
+import type { RuleViolation, RulesLogger } from './types';
+type ViolationHandler = (v: RuleViolation) => void;
+export interface RulesEmitter {
+    on(event: 'violation', handler: ViolationHandler): Unsubscribe;
+    emit(event: 'violation', payload: RuleViolation): void;
+}
+export interface CreateEmitterConfig {
+    logger?: RulesLogger;
+}
+export declare function createEmitter({ logger }?: CreateEmitterConfig): RulesEmitter;
+export {};
+//# sourceMappingURL=emitter.d.ts.map

package/dist/rules/emitter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"emitter.d.ts","sourceRoot":"","sources":["../../src/rules/emitter.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,eAAe,CAAA;AAChD,OAAO,KAAK,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,SAAS,CAAA;AAEzD,KAAK,gBAAgB,GAAG,CAAC,CAAC,EAAE,aAAa,KAAK,IAAI,CAAA;AAElD,MAAM,WAAW,YAAY;IAC3B,EAAE,CAAC,KAAK,EAAE,WAAW,EAAE,OAAO,EAAE,gBAAgB,GAAG,WAAW,CAAA;IAC9D,IAAI,CAAC,KAAK,EAAE,WAAW,EAAE,OAAO,EAAE,aAAa,GAAG,IAAI,CAAA;CACvD;AAED,MAAM,WAAW,mBAAmB;IAClC,MAAM,CAAC,EAAE,WAAW,CAAA;CACrB;AAED,wBAAgB,aAAa,CAAC,EAAE,MAAM,EAAE,GAAE,mBAAwB,GAAG,YAAY,CAwBhF"}

package/dist/rules/emitter.js

@@ -0,0 +1,32 @@
+/**
+ * Minimal typed event emitter for the rules engine.
+ *
+ * Only the `'violation'` event is supported. Handler exceptions are
+ * caught and logged so a single subscriber can't take down evaluation.
+ * `on(...)` returns an `Unsubscribe` closure per spec's public surface.
+ */
+export function createEmitter({ logger } = {}) {
+    const handlers = new Set();
+    return {
+        on(_event, handler) {
+            handlers.add(handler);
+            return () => {
+                handlers.delete(handler);
+            };
+        },
+        emit(_event, payload) {
+            for (const h of handlers) {
+                try {
+                    h(payload);
+                }
+                catch (err) {
+                    logger?.error('rules.emitter: violation handler threw', {
+                        err: err.message,
+                        ruleId: payload.ruleId,
+                    });
+                }
+            }
+        },
+    };
+}
+//# sourceMappingURL=emitter.js.map

package/dist/rules/emitter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"emitter.js","sourceRoot":"","sources":["../../src/rules/emitter.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAgBH,MAAM,UAAU,aAAa,CAAC,EAAE,MAAM,KAA0B,EAAE;IAChE,MAAM,QAAQ,GAAG,IAAI,GAAG,EAAoB,CAAA;IAE5C,OAAO;QACL,EAAE,CAAC,MAAM,EAAE,OAAO;YAChB,QAAQ,CAAC,GAAG,CAAC,OAAO,CAAC,CAAA;YACrB,OAAO,GAAG,EAAE;gBACV,QAAQ,CAAC,MAAM,CAAC,OAAO,CAAC,CAAA;YAC1B,CAAC,CAAA;QACH,CAAC;QACD,IAAI,CAAC,MAAM,EAAE,OAAO;YAClB,KAAK,MAAM,CAAC,IAAI,QAAQ,EAAE,CAAC;gBACzB,IAAI,CAAC;oBACH,CAAC,CAAC,OAAO,CAAC,CAAA;gBACZ,CAAC;gBACD,OAAO,GAAG,EAAE,CAAC;oBACX,MAAM,EAAE,KAAK,CAAC,wCAAwC,EAAE;wBACtD,GAAG,EAAG,GAAa,CAAC,OAAO;wBAC3B,MAAM,EAAE,OAAO,CAAC,MAAM;qBACvB,CAAC,CAAA;gBACJ,CAAC;YACH,CAAC;QACH,CAAC;KACF,CAAA;AACH,CAAC"}

package/dist/rules/evaluator.d.ts

@@ -0,0 +1,44 @@
+/**
+ * Rule evaluator — glues registry + compiler cache + throttle + emitter to
+ * `analytics.execute`.
+ *
+ * Two entry points:
+ *   - `evaluateOnBatch(batch)` — called by sync after a successful flush.
+ *     Considers only rules whose metric table intersects `batch.affectedTables`.
+ *   - `evaluateScheduled()` — called by the sync scheduler cadence. Considers
+ *     every active brand-matching rule, fanned out over family members.
+ *
+ * Both funnel through `evaluateRule(rule, ctx)` which is the throttle-gated
+ * single-user check. A returned `RuleViolation` is emitted synchronously via
+ * the shared emitter and echoed to callers.
+ *
+ * `analytics.execute` throws are caught + logged; a failing rule never
+ * blocks the rest of the pass.
+ */
+import type { AnalyticsEngine } from '../core/types';
+import type { CompilerCache } from './compiler-cache';
+import type { createEmitter } from './emitter';
+import type { RulesRegistry } from './registry';
+import type { createThrottleStore } from './throttle';
+import type { Clock, RuleViolation, RulesLogger, FlushSummary } from './types';
+export interface EvaluatorConfig {
+    registry: RulesRegistry;
+    cache: CompilerCache;
+    throttle: ReturnType<typeof createThrottleStore>;
+    emitter: ReturnType<typeof createEmitter>;
+    analytics: AnalyticsEngine;
+    brand: string;
+    familyId: string;
+    familyMembersProvider: (ctx: {
+        brand: string;
+        familyId: string;
+    }) => Promise<string[]>;
+    clock: Clock;
+    logger?: RulesLogger;
+}
+export interface Evaluator {
+    evaluateOnBatch(batch: FlushSummary): Promise<RuleViolation[]>;
+    evaluateScheduled(): Promise<RuleViolation[]>;
+}
+export declare function createEvaluator(config: EvaluatorConfig): Evaluator;
+//# sourceMappingURL=evaluator.d.ts.map

package/dist/rules/evaluator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"evaluator.d.ts","sourceRoot":"","sources":["../../src/rules/evaluator.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAGH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,eAAe,CAAA;AACpD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAA;AACrD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,WAAW,CAAA;AAC9C,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAA;AAE/C,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAA;AACrD,OAAO,KAAK,EACV,KAAK,EACL,aAAa,EACb,WAAW,EACX,YAAY,EACb,MAAM,SAAS,CAAA;AAEhB,MAAM,WAAW,eAAe;IAC9B,QAAQ,EAAE,aAAa,CAAA;IACvB,KAAK,EAAE,aAAa,CAAA;IACpB,QAAQ,EAAE,UAAU,CAAC,OAAO,mBAAmB,CAAC,CAAA;IAChD,OAAO,EAAE,UAAU,CAAC,OAAO,aAAa,CAAC,CAAA;IACzC,SAAS,EAAE,eAAe,CAAA;IAC1B,KAAK,EAAE,MAAM,CAAA;IACb,QAAQ,EAAE,MAAM,CAAA;IAChB,qBAAqB,EAAE,CAAC,GAAG,EAAE;QAC3B,KAAK,EAAE,MAAM,CAAA;QACb,QAAQ,EAAE,MAAM,CAAA;KACjB,KAAK,OAAO,CAAC,MAAM,EAAE,CAAC,CAAA;IACvB,KAAK,EAAE,KAAK,CAAA;IACZ,MAAM,CAAC,EAAE,WAAW,CAAA;CACrB;AAOD,MAAM,WAAW,SAAS;IACxB,eAAe,CAAC,KAAK,EAAE,YAAY,GAAG,OAAO,CAAC,aAAa,EAAE,CAAC,CAAA;IAC9D,iBAAiB,IAAI,OAAO,CAAC,aAAa,EAAE,CAAC,CAAA;CAC9C;AAED,wBAAgB,eAAe,CAAC,MAAM,EAAE,eAAe,GAAG,SAAS,CAkIlE"}

package/dist/rules/evaluator.js

@@ -0,0 +1,127 @@
+/**
+ * Rule evaluator — glues registry + compiler cache + throttle + emitter to
+ * `analytics.execute`.
+ *
+ * Two entry points:
+ *   - `evaluateOnBatch(batch)` — called by sync after a successful flush.
+ *     Considers only rules whose metric table intersects `batch.affectedTables`.
+ *   - `evaluateScheduled()` — called by the sync scheduler cadence. Considers
+ *     every active brand-matching rule, fanned out over family members.
+ *
+ * Both funnel through `evaluateRule(rule, ctx)` which is the throttle-gated
+ * single-user check. A returned `RuleViolation` is emitted synchronously via
+ * the shared emitter and echoed to callers.
+ *
+ * `analytics.execute` throws are caught + logged; a failing rule never
+ * blocks the rest of the pass.
+ */
+import { METRIC_METADATA } from '../core/metric_metadata';
+export function createEvaluator(config) {
+    const { registry, cache, throttle, emitter, analytics, brand, familyId, familyMembersProvider, clock, logger, } = config;
+    async function evaluateRule(rule, ctx) {
+        const throttled = await throttle.isThrottled(rule.id, ctx.userId, rule.throttle);
+        if (throttled) {
+            logger?.debug('rules.evaluator: throttled', {
+                ruleId: rule.id,
+                userId: ctx.userId,
+            });
+            return null;
+        }
+        let rows;
+        try {
+            const compiled = cache.getCompiled(rule, registry.rev);
+            const params = {
+                userId: ctx.userId,
+                brand,
+                familyId: ctx.familyId,
+                ...compiled.params,
+            };
+            rows = await analytics.execute(compiled.sql, params);
+        }
+        catch (err) {
+            logger?.error('rules.evaluator: execute failed', {
+                ruleId: rule.id,
+                userId: ctx.userId,
+                err: err.message,
+            });
+            return null;
+        }
+        if (rows.length === 0) {
+            return null;
+        }
+        const row = rows[0];
+        const violation = {
+            ruleId: rule.id,
+            ruleName: rule.name,
+            severity: rule.severity,
+            userId: ctx.userId,
+            familyId: ctx.familyId,
+            brand: rule.brand ?? brand,
+            observedValue: Number(row.observed_value),
+            thresholdValue: Number(row.threshold_value),
+            observedAt: clock(),
+            evidence: {
+                metric: rule.metric,
+                window: rule.window,
+                aggregation: rule.aggregation,
+                compare: rule.compare,
+                target: rule.target,
+            },
+        };
+        await throttle.recordFire(rule.id, ctx.userId);
+        emitter.emit('violation', violation);
+        return violation;
+    }
+    function rulesForTables(rules, affectedTables) {
+        const tableSet = new Set(affectedTables);
+        return rules.filter((r) => {
+            const meta = METRIC_METADATA[r.metric];
+            return tableSet.has(meta.table);
+        });
+    }
+    return {
+        async evaluateOnBatch(batch) {
+            const active = registry.getByBrand(brand);
+            const relevant = rulesForTables(active, batch.affectedTables);
+            if (relevant.length === 0 || batch.affectedUserIds.length === 0) {
+                return [];
+            }
+            const violations = [];
+            for (const rule of relevant) {
+                for (const userId of batch.affectedUserIds) {
+                    const v = await evaluateRule(rule, { userId, familyId });
+                    if (v)
+                        violations.push(v);
+                }
+            }
+            return violations;
+        },
+        async evaluateScheduled() {
+            const active = registry.getByBrand(brand);
+            if (active.length === 0) {
+                return [];
+            }
+            let members;
+            try {
+                members = await familyMembersProvider({ brand, familyId });
+            }
+            catch (err) {
+                logger?.error('rules.evaluator: familyMembersProvider failed', {
+                    familyId,
+                    err: err.message,
+                });
+                return [];
+            }
+            const violations = [];
+            for (const rule of active) {
+                for (const userId of members) {
+                    const v = await evaluateRule(rule, { userId, familyId });
+                    if (v)
+                        violations.push(v);
+                }
+            }
+            return violations;
+        },
+    };
+}
+//# sourceMappingURL=evaluator.js.map

package/dist/rules/evaluator.js.map

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

package/dist/rules/factory.d.ts

@@ -0,0 +1,13 @@
+/**
+ * `createRulesEngine(config)` — assembles registry, compiler cache,
+ * throttle store, emitter, and evaluator into the public `RulesEngine`
+ * surface.
+ *
+ * The factory holds no persistent state of its own; all state lives on
+ * the sub-modules. Callers pass a `KVStore` for durable state (rule
+ * enable flags, throttle counters) and an `AnalyticsEngine` for SQL
+ * execution.
+ */
+import type { RulesEngine, RulesEngineConfig } from './types';
+export declare function createRulesEngine(config: RulesEngineConfig): RulesEngine;
+//# sourceMappingURL=factory.d.ts.map

package/dist/rules/factory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"factory.d.ts","sourceRoot":"","sources":["../../src/rules/factory.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAOH,OAAO,KAAK,EAAE,WAAW,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAA;AAE7D,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,iBAAiB,GAAG,WAAW,CAiDxE"}