@mongrov/analytics 0.1.0-alpha.7 → 0.1.0-alpha.9

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"}

package/dist/rules/factory.js

@@ -0,0 +1,56 @@
+/**
+ * `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 { createCompilerCache } from './compiler-cache';
+import { createEmitter } from './emitter';
+import { createEvaluator } from './evaluator';
+import { createRulesRegistry } from './registry';
+import { createThrottleStore } from './throttle';
+export function createRulesEngine(config) {
+    const { analytics, storage, familyMembersProvider, brand, familyId, logger, clock = () => new Date(), } = config;
+    const emitter = createEmitter({ logger });
+    const throttle = createThrottleStore({ storage, clock, logger });
+    const cache = createCompilerCache();
+    const registry = createRulesRegistry({
+        storage,
+        logger,
+        defaultBrand: brand,
+    });
+    const evaluator = createEvaluator({
+        registry,
+        cache,
+        throttle,
+        emitter,
+        analytics,
+        brand,
+        familyId,
+        familyMembersProvider,
+        clock,
+        logger,
+    });
+    return {
+        register: (rules) => registry.register(rules),
+        enable: (ruleId) => {
+            cache.invalidate(ruleId);
+            return registry.enable(ruleId);
+        },
+        disable: (ruleId) => {
+            cache.invalidate(ruleId);
+            return registry.disable(ruleId);
+        },
+        list: () => registry.list(),
+        getActive: () => registry.getActive(),
+        evaluateOnBatch: (batch) => evaluator.evaluateOnBatch(batch),
+        evaluateScheduled: () => evaluator.evaluateScheduled(),
+        on: (event, handler) => emitter.on(event, handler),
+        subscribeRegistry: (listener) => registry.subscribe(listener),
+    };
+}
+//# sourceMappingURL=factory.js.map

package/dist/rules/factory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"factory.js","sourceRoot":"","sources":["../../src/rules/factory.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAA;AACtD,OAAO,EAAE,aAAa,EAAE,MAAM,WAAW,CAAA;AACzC,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAA;AAC7C,OAAO,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAA;AAChD,OAAO,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAA;AAGhD,MAAM,UAAU,iBAAiB,CAAC,MAAyB;IACzD,MAAM,EACJ,SAAS,EACT,OAAO,EACP,qBAAqB,EACrB,KAAK,EACL,QAAQ,EACR,MAAM,EACN,KAAK,GAAG,GAAG,EAAE,CAAC,IAAI,IAAI,EAAE,GACzB,GAAG,MAAM,CAAA;IAEV,MAAM,OAAO,GAAG,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC,CAAA;IACzC,MAAM,QAAQ,GAAG,mBAAmB,CAAC,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC,CAAA;IAChE,MAAM,KAAK,GAAG,mBAAmB,EAAE,CAAA;IACnC,MAAM,QAAQ,GAAG,mBAAmB,CAAC;QACnC,OAAO;QACP,MAAM;QACN,YAAY,EAAE,KAAK;KACpB,CAAC,CAAA;IACF,MAAM,SAAS,GAAG,eAAe,CAAC;QAChC,QAAQ;QACR,KAAK;QACL,QAAQ;QACR,OAAO;QACP,SAAS;QACT,KAAK;QACL,QAAQ;QACR,qBAAqB;QACrB,KAAK;QACL,MAAM;KACP,CAAC,CAAA;IAEF,OAAO;QACL,QAAQ,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,QAAQ,CAAC,QAAQ,CAAC,KAAK,CAAC;QAC7C,MAAM,EAAE,CAAC,MAAM,EAAE,EAAE;YACjB,KAAK,CAAC,UAAU,CAAC,MAAM,CAAC,CAAA;YACxB,OAAO,QAAQ,CAAC,MAAM,CAAC,MAAM,CAAC,CAAA;QAChC,CAAC;QACD,OAAO,EAAE,CAAC,MAAM,EAAE,EAAE;YAClB,KAAK,CAAC,UAAU,CAAC,MAAM,CAAC,CAAA;YACxB,OAAO,QAAQ,CAAC,OAAO,CAAC,MAAM,CAAC,CAAA;QACjC,CAAC;QACD,IAAI,EAAE,GAAG,EAAE,CAAC,QAAQ,CAAC,IAAI,EAAE;QAC3B,SAAS,EAAE,GAAG,EAAE,CAAC,QAAQ,CAAC,SAAS,EAAE;QACrC,eAAe,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,SAAS,CAAC,eAAe,CAAC,KAAK,CAAC;QAC5D,iBAAiB,EAAE,GAAG,EAAE,CAAC,SAAS,CAAC,iBAAiB,EAAE;QACtD,EAAE,EAAE,CAAC,KAAK,EAAE,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,CAAC;QAClD,iBAAiB,EAAE,CAAC,QAAQ,EAAE,EAAE,CAAC,QAAQ,CAAC,SAAS,CAAC,QAAQ,CAAC;KAC9D,CAAA;AACH,CAAC"}

package/dist/rules/hooks/useRuleRegistry.d.ts

@@ -0,0 +1,16 @@
+/**
+ * `useRuleRegistry(engine)` — live registry state.
+ *
+ * Uses `useSyncExternalStore` bound to `engine.subscribeRegistry` so the
+ * component re-renders on register / enable / disable. `enable` + `disable`
+ * are stable references passed through from the engine.
+ */
+import type { Rule } from '../schema';
+import type { RulesEngine } from '../types';
+export interface UseRuleRegistryResult {
+    rules: Rule[];
+    enable(ruleId: string): Promise<void>;
+    disable(ruleId: string): Promise<void>;
+}
+export declare function useRuleRegistry(engine: RulesEngine): UseRuleRegistryResult;
+//# sourceMappingURL=useRuleRegistry.d.ts.map

package/dist/rules/hooks/useRuleRegistry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useRuleRegistry.d.ts","sourceRoot":"","sources":["../../../src/rules/hooks/useRuleRegistry.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,WAAW,CAAA;AACrC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,UAAU,CAAA;AAE3C,MAAM,WAAW,qBAAqB;IACpC,KAAK,EAAE,IAAI,EAAE,CAAA;IACb,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IACrC,OAAO,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;CACvC;AAkBD,wBAAgB,eAAe,CAAC,MAAM,EAAE,WAAW,GAAG,qBAAqB,CAQ1E"}

package/dist/rules/hooks/useRuleRegistry.js

@@ -0,0 +1,26 @@
+/**
+ * `useRuleRegistry(engine)` — live registry state.
+ *
+ * Uses `useSyncExternalStore` bound to `engine.subscribeRegistry` so the
+ * component re-renders on register / enable / disable. `enable` + `disable`
+ * are stable references passed through from the engine.
+ */
+import { useMemo, useSyncExternalStore, useCallback } from 'react';
+function makeCache(engine) {
+    let snapshot = engine.list();
+    return {
+        subscribe: (onStoreChange) => engine.subscribeRegistry(() => {
+            snapshot = engine.list();
+            onStoreChange();
+        }),
+        get: () => snapshot,
+    };
+}
+export function useRuleRegistry(engine) {
+    const cache = useMemo(() => makeCache(engine), [engine]);
+    const rules = useSyncExternalStore(cache.subscribe, cache.get, cache.get);
+    const enable = useCallback((ruleId) => engine.enable(ruleId), [engine]);
+    const disable = useCallback((ruleId) => engine.disable(ruleId), [engine]);
+    return { rules, enable, disable };
+}
+//# sourceMappingURL=useRuleRegistry.js.map

package/dist/rules/hooks/useRuleRegistry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useRuleRegistry.js","sourceRoot":"","sources":["../../../src/rules/hooks/useRuleRegistry.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,OAAO,EAAE,oBAAoB,EAAE,WAAW,EAAE,MAAM,OAAO,CAAA;AAelE,SAAS,SAAS,CAAC,MAAmB;IACpC,IAAI,QAAQ,GAAG,MAAM,CAAC,IAAI,EAAE,CAAA;IAC5B,OAAO;QACL,SAAS,EAAE,CAAC,aAAa,EAAE,EAAE,CAAC,MAAM,CAAC,iBAAiB,CAAC,GAAG,EAAE;YAC1D,QAAQ,GAAG,MAAM,CAAC,IAAI,EAAE,CAAA;YACxB,aAAa,EAAE,CAAA;QACjB,CAAC,CAAC;QACF,GAAG,EAAE,GAAG,EAAE,CAAC,QAAQ;KACpB,CAAA;AACH,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,MAAmB;IACjD,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,MAAM,CAAC,EAAE,CAAC,MAAM,CAAC,CAAC,CAAA;IACxD,MAAM,KAAK,GAAG,oBAAoB,CAAC,KAAK,CAAC,SAAS,EAAE,KAAK,CAAC,GAAG,EAAE,KAAK,CAAC,GAAG,CAAC,CAAA;IAEzE,MAAM,MAAM,GAAG,WAAW,CAAC,CAAC,MAAc,EAAE,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC,MAAM,CAAC,CAAC,CAAA;IAC/E,MAAM,OAAO,GAAG,WAAW,CAAC,CAAC,MAAc,EAAE,EAAE,CAAC,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC,MAAM,CAAC,CAAC,CAAA;IAEjF,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,CAAA;AACnC,CAAC"}

package/dist/rules/hooks/useRuleViolations.d.ts

@@ -0,0 +1,21 @@
+/**
+ * `useRuleViolations(engine, options?)` — session-scoped violation feed.
+ *
+ * Subscribes to `engine.on('violation', ...)` for the lifetime of the
+ * component and buffers the most-recent `limit` violations in state. On
+ * unmount the subscription tears down.
+ *
+ * React is an optional peer of `@mongrov/analytics`; this file is only
+ * imported when the app pulls the `/rules` subpath.
+ */
+import type { RuleViolation, RulesEngine } from '../types';
+export interface UseRuleViolationsOptions {
+    /** Maximum number of retained violations. Default `50`. */
+    limit?: number;
+}
+export interface UseRuleViolationsResult {
+    violations: RuleViolation[];
+    clear(): void;
+}
+export declare function useRuleViolations(engine: RulesEngine, options?: UseRuleViolationsOptions): UseRuleViolationsResult;
+//# sourceMappingURL=useRuleViolations.d.ts.map

package/dist/rules/hooks/useRuleViolations.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useRuleViolations.d.ts","sourceRoot":"","sources":["../../../src/rules/hooks/useRuleViolations.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAGH,OAAO,KAAK,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,UAAU,CAAA;AAI1D,MAAM,WAAW,wBAAwB;IACvC,2DAA2D;IAC3D,KAAK,CAAC,EAAE,MAAM,CAAA;CACf;AAED,MAAM,WAAW,uBAAuB;IACtC,UAAU,EAAE,aAAa,EAAE,CAAA;IAC3B,KAAK,IAAI,IAAI,CAAA;CACd;AAED,wBAAgB,iBAAiB,CAC/B,MAAM,EAAE,WAAW,EACnB,OAAO,CAAC,EAAE,wBAAwB,GACjC,uBAAuB,CAoBzB"}

package/dist/rules/hooks/useRuleViolations.js

@@ -0,0 +1,32 @@
+/**
+ * `useRuleViolations(engine, options?)` — session-scoped violation feed.
+ *
+ * Subscribes to `engine.on('violation', ...)` for the lifetime of the
+ * component and buffers the most-recent `limit` violations in state. On
+ * unmount the subscription tears down.
+ *
+ * React is an optional peer of `@mongrov/analytics`; this file is only
+ * imported when the app pulls the `/rules` subpath.
+ */
+import { useEffect, useState, useCallback } from 'react';
+const DEFAULT_LIMIT = 50;
+export function useRuleViolations(engine, options) {
+    const limit = options?.limit ?? DEFAULT_LIMIT;
+    const [violations, setViolations] = useState([]);
+    useEffect(() => {
+        const unsub = engine.on('violation', (v) => {
+            setViolations((prev) => {
+                const next = [v, ...prev];
+                if (next.length > limit)
+                    next.length = limit;
+                return next;
+            });
+        });
+        return unsub;
+    }, [engine, limit]);
+    const clear = useCallback(() => {
+        setViolations([]);
+    }, []);
+    return { violations, clear };
+}
+//# sourceMappingURL=useRuleViolations.js.map