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

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 Mongrov
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/rules/__fakes__/fakeClock.d.ts

@@ -0,0 +1,7 @@
+import type { Clock } from '../types';
+/** Pinnable clock for throttle tests. Advance via `set(date)`. */
+export declare function createFakeClock(initial: Date | string): Clock & {
+    set(t: Date | string): void;
+    advance(ms: number): void;
+};
+//# sourceMappingURL=fakeClock.d.ts.map

package/dist/rules/__fakes__/fakeClock.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fakeClock.d.ts","sourceRoot":"","sources":["../../../src/rules/__fakes__/fakeClock.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,UAAU,CAAA;AAErC,kEAAkE;AAClE,wBAAgB,eAAe,CAAC,OAAO,EAAE,IAAI,GAAG,MAAM,GAAG,KAAK,GAAG;IAC/D,GAAG,CAAC,CAAC,EAAE,IAAI,GAAG,MAAM,GAAG,IAAI,CAAA;IAC3B,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,CAAA;CAC1B,CAaA"}

package/dist/rules/__fakes__/fakeClock.js

@@ -0,0 +1,13 @@
+/** Pinnable clock for throttle tests. Advance via `set(date)`. */
+export function createFakeClock(initial) {
+    let now = new Date(initial);
+    const clock = (() => new Date(now));
+    clock.set = (t) => {
+        now = new Date(t);
+    };
+    clock.advance = (ms) => {
+        now = new Date(now.getTime() + ms);
+    };
+    return clock;
+}
+//# sourceMappingURL=fakeClock.js.map

package/dist/rules/__fakes__/fakeClock.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fakeClock.js","sourceRoot":"","sources":["../../../src/rules/__fakes__/fakeClock.ts"],"names":[],"mappings":"AAEA,kEAAkE;AAClE,MAAM,UAAU,eAAe,CAAC,OAAsB;IAIpD,IAAI,GAAG,GAAG,IAAI,IAAI,CAAC,OAAO,CAAC,CAAA;IAC3B,MAAM,KAAK,GAAG,CAAC,GAAG,EAAE,CAAC,IAAI,IAAI,CAAC,GAAG,CAAC,CAGjC,CAAA;IACD,KAAK,CAAC,GAAG,GAAG,CAAC,CAAC,EAAE,EAAE;QAChB,GAAG,GAAG,IAAI,IAAI,CAAC,CAAC,CAAC,CAAA;IACnB,CAAC,CAAA;IACD,KAAK,CAAC,OAAO,GAAG,CAAC,EAAE,EAAE,EAAE;QACrB,GAAG,GAAG,IAAI,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,GAAG,EAAE,CAAC,CAAA;IACpC,CAAC,CAAA;IACD,OAAO,KAAK,CAAA;AACd,CAAC"}

package/dist/rules/__fakes__/fakeEngine.d.ts

@@ -0,0 +1,12 @@
+import type { AnalyticsEngine } from '../../core/types';
+/** Minimal AnalyticsEngine stub for evaluator tests. */
+export interface FakeEngine extends AnalyticsEngine {
+    __calls: {
+        sql: string;
+        params: Record<string, unknown>;
+    }[];
+    __setResult(rows: unknown[]): void;
+    __setError(err: Error | null): void;
+}
+export declare function createFakeEngine(): FakeEngine;
+//# sourceMappingURL=fakeEngine.d.ts.map

package/dist/rules/__fakes__/fakeEngine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fakeEngine.d.ts","sourceRoot":"","sources":["../../../src/rules/__fakes__/fakeEngine.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAA;AAEvD,wDAAwD;AACxD,MAAM,WAAW,UAAW,SAAQ,eAAe;IACjD,OAAO,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;KAAE,EAAE,CAAA;IAC3D,WAAW,CAAC,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAAA;IAClC,UAAU,CAAC,GAAG,EAAE,KAAK,GAAG,IAAI,GAAG,IAAI,CAAA;CACpC;AAED,wBAAgB,gBAAgB,IAAI,UAAU,CA+B7C"}

package/dist/rules/__fakes__/fakeEngine.js

@@ -0,0 +1,33 @@
+export function createFakeEngine() {
+    let queued = [];
+    let queuedErr = null;
+    const calls = [];
+    const engine = {
+        async attach() { },
+        async detach() { },
+        async execute(sql, params) {
+            calls.push({ sql, params: params ?? {} });
+            if (queuedErr)
+                throw queuedErr;
+            return queued;
+        },
+        stream() {
+            throw new Error('stream not implemented in fake');
+        },
+        createAppender() {
+            throw new Error('createAppender not implemented in fake');
+        },
+        state: 'attached',
+        lastError: null,
+        catalog: 'fake',
+        subscribe: () => () => { },
+        async setRetention() { },
+        async getLastAttach() { return null; },
+        async close() { },
+        __calls: calls,
+        __setResult(rows) { queued = rows; queuedErr = null; },
+        __setError(err) { queuedErr = err; },
+    };
+    return engine;
+}
+//# sourceMappingURL=fakeEngine.js.map

package/dist/rules/__fakes__/fakeEngine.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fakeEngine.js","sourceRoot":"","sources":["../../../src/rules/__fakes__/fakeEngine.ts"],"names":[],"mappings":"AASA,MAAM,UAAU,gBAAgB;IAC9B,IAAI,MAAM,GAAc,EAAE,CAAA;IAC1B,IAAI,SAAS,GAAiB,IAAI,CAAA;IAClC,MAAM,KAAK,GAAuD,EAAE,CAAA;IAEpE,MAAM,MAAM,GAAe;QACzB,KAAK,CAAC,MAAM,KAAI,CAAC;QACjB,KAAK,CAAC,MAAM,KAAI,CAAC;QACjB,KAAK,CAAC,OAAO,CAAI,GAAW,EAAE,MAAgC;YAC5D,KAAK,CAAC,IAAI,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,IAAI,EAAE,EAAE,CAAC,CAAA;YACzC,IAAI,SAAS;gBAAE,MAAM,SAAS,CAAA;YAC9B,OAAO,MAAa,CAAA;QACtB,CAAC;QACD,MAAM;YACJ,MAAM,IAAI,KAAK,CAAC,gCAAgC,CAAC,CAAA;QACnD,CAAC;QACD,cAAc;YACZ,MAAM,IAAI,KAAK,CAAC,wCAAwC,CAAC,CAAA;QAC3D,CAAC;QACD,KAAK,EAAE,UAAU;QACjB,SAAS,EAAE,IAAI;QACf,OAAO,EAAE,MAAM;QACf,SAAS,EAAE,GAAG,EAAE,CAAC,GAAG,EAAE,GAAE,CAAC;QACzB,KAAK,CAAC,YAAY,KAAI,CAAC;QACvB,KAAK,CAAC,aAAa,KAAK,OAAO,IAAI,CAAA,CAAC,CAAC;QACrC,KAAK,CAAC,KAAK,KAAI,CAAC;QAChB,OAAO,EAAE,KAAK;QACd,WAAW,CAAC,IAAI,IAAI,MAAM,GAAG,IAAI,CAAC,CAAC,SAAS,GAAG,IAAI,CAAA,CAAC,CAAC;QACrD,UAAU,CAAC,GAAG,IAAI,SAAS,GAAG,GAAG,CAAA,CAAC,CAAC;KACpC,CAAA;IACD,OAAO,MAAM,CAAA;AACf,CAAC"}

package/dist/rules/__fakes__/fakeStorage.d.ts

@@ -0,0 +1,7 @@
+import type { KVStore } from '../../core/types';
+/** In-memory KVStore for rules tests. */
+export declare function createFakeStorage(): KVStore & {
+    __dump: () => Record<string, unknown>;
+    __clear: () => void;
+};
+//# sourceMappingURL=fakeStorage.d.ts.map

package/dist/rules/__fakes__/fakeStorage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fakeStorage.d.ts","sourceRoot":"","sources":["../../../src/rules/__fakes__/fakeStorage.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAA;AAE/C,yCAAyC;AACzC,wBAAgB,iBAAiB,IAAI,OAAO,GAAG;IAC7C,MAAM,EAAE,MAAM,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IACrC,OAAO,EAAE,MAAM,IAAI,CAAA;CACpB,CAmBA"}

package/dist/rules/__fakes__/fakeStorage.js

@@ -0,0 +1,22 @@
+/** In-memory KVStore for rules tests. */
+export function createFakeStorage() {
+    const store = new Map();
+    return {
+        async get(key) {
+            return store.get(key);
+        },
+        async set(key, value) {
+            store.set(key, value);
+        },
+        async delete(key) {
+            store.delete(key);
+        },
+        __dump() {
+            return Object.fromEntries(store.entries());
+        },
+        __clear() {
+            store.clear();
+        },
+    };
+}
+//# sourceMappingURL=fakeStorage.js.map

package/dist/rules/__fakes__/fakeStorage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fakeStorage.js","sourceRoot":"","sources":["../../../src/rules/__fakes__/fakeStorage.ts"],"names":[],"mappings":"AAEA,yCAAyC;AACzC,MAAM,UAAU,iBAAiB;IAI/B,MAAM,KAAK,GAAG,IAAI,GAAG,EAAmB,CAAA;IACxC,OAAO;QACL,KAAK,CAAC,GAAG,CAAI,GAAW;YACtB,OAAO,KAAK,CAAC,GAAG,CAAC,GAAG,CAAkB,CAAA;QACxC,CAAC;QACD,KAAK,CAAC,GAAG,CAAI,GAAW,EAAE,KAAQ;YAChC,KAAK,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CAAA;QACvB,CAAC;QACD,KAAK,CAAC,MAAM,CAAC,GAAW;YACtB,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAA;QACnB,CAAC;QACD,MAAM;YACJ,OAAO,MAAM,CAAC,WAAW,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC,CAAA;QAC5C,CAAC;QACD,OAAO;YACL,KAAK,CAAC,KAAK,EAAE,CAAA;QACf,CAAC;KACF,CAAA;AACH,CAAC"}

package/dist/rules/compiler-cache.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Memoization layer around `compileRule`.
+ *
+ * Keyed by `ruleId + registry revision`. Registry bumps `rev` on every
+ * register/enable/disable, so a rule mutation transparently invalidates
+ * its cached compilation on the next `getCompiled(rule, rev)` call.
+ */
+import type { Rule } from './schema';
+import type { CompiledRule } from './types';
+export interface CompilerCache {
+    getCompiled(rule: Rule, rev: number): CompiledRule;
+    invalidate(ruleId: string): void;
+    size(): number;
+}
+export declare function createCompilerCache(): CompilerCache;
+//# sourceMappingURL=compiler-cache.d.ts.map

package/dist/rules/compiler-cache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"compiler-cache.d.ts","sourceRoot":"","sources":["../../src/rules/compiler-cache.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,UAAU,CAAA;AACpC,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,SAAS,CAAA;AAE3C,MAAM,WAAW,aAAa;IAC5B,WAAW,CAAC,IAAI,EAAE,IAAI,EAAE,GAAG,EAAE,MAAM,GAAG,YAAY,CAAA;IAClD,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAA;IAChC,IAAI,IAAI,MAAM,CAAA;CACf;AAED,wBAAgB,mBAAmB,IAAI,aAAa,CAoBnD"}

package/dist/rules/compiler-cache.js

@@ -0,0 +1,29 @@
+/**
+ * Memoization layer around `compileRule`.
+ *
+ * Keyed by `ruleId + registry revision`. Registry bumps `rev` on every
+ * register/enable/disable, so a rule mutation transparently invalidates
+ * its cached compilation on the next `getCompiled(rule, rev)` call.
+ */
+import { compileRule } from './compiler';
+export function createCompilerCache() {
+    const entries = new Map();
+    return {
+        getCompiled(rule, rev) {
+            const cached = entries.get(rule.id);
+            if (cached && cached.rev === rev) {
+                return cached.compiled;
+            }
+            const compiled = compileRule(rule);
+            entries.set(rule.id, { rev, compiled });
+            return compiled;
+        },
+        invalidate(ruleId) {
+            entries.delete(ruleId);
+        },
+        size() {
+            return entries.size;
+        },
+    };
+}
+//# sourceMappingURL=compiler-cache.js.map

package/dist/rules/compiler-cache.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"compiler-cache.js","sourceRoot":"","sources":["../../src/rules/compiler-cache.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAA;AAUxC,MAAM,UAAU,mBAAmB;IACjC,MAAM,OAAO,GAAG,IAAI,GAAG,EAAmD,CAAA;IAE1E,OAAO;QACL,WAAW,CAAC,IAAI,EAAE,GAAG;YACnB,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAA;YACnC,IAAI,MAAM,IAAI,MAAM,CAAC,GAAG,KAAK,GAAG,EAAE,CAAC;gBACjC,OAAO,MAAM,CAAC,QAAQ,CAAA;YACxB,CAAC;YACD,MAAM,QAAQ,GAAG,WAAW,CAAC,IAAI,CAAC,CAAA;YAClC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,GAAG,EAAE,QAAQ,EAAE,CAAC,CAAA;YACvC,OAAO,QAAQ,CAAA;QACjB,CAAC;QACD,UAAU,CAAC,MAAM;YACf,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,CAAA;QACxB,CAAC;QACD,IAAI;YACF,OAAO,OAAO,CAAC,IAAI,CAAA;QACrB,CAAC;KACF,CAAA;AACH,CAAC"}

package/dist/rules/compiler.d.ts

@@ -0,0 +1,27 @@
+/**
+ * SQL compiler — rule → parameterized DuckDB query.
+ *
+ * Design principles:
+ *   - `$userId`, `$brand`, `$familyId` are always bound via
+ *     `analytics.execute(sql, params)`. Never string-concatenated.
+ *   - Static rule params (thresholds, window edges) are also bound as
+ *     `$<name>`. Never concatenated.
+ *   - Table + column identifiers are looked up in `METRIC_METADATA`,
+ *     sanitized with `[^A-Za-z0-9_]/g → _`, then inlined as literals.
+ *     DuckDB has no parameter binding for identifiers.
+ *   - `rawSql` bypasses codegen; the compiler only allow-lists
+ *     placeholders declared in `rule.rawSqlParams` (plus the three
+ *     runtime-bound ones).
+ *
+ * The result rowshape is uniform: every SELECT projects
+ *   observed_value NUMERIC, threshold_value NUMERIC
+ * so the evaluator can build `RuleViolation` without dispatching per
+ * target type.
+ */
+import type { CompiledRule } from './types';
+import { type Rule } from './schema';
+/** Sanitize an identifier for direct interpolation. */
+export declare function sanitizeIdent(raw: string): string;
+/** Compile a validated rule to a `CompiledRule`. */
+export declare function compileRule(rule: Rule): CompiledRule;
+//# sourceMappingURL=compiler.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"compiler.d.ts","sourceRoot":"","sources":["../../src/rules/compiler.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAIH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,SAAS,CAAA;AAC3C,OAAO,EAGL,KAAK,IAAI,EAIV,MAAM,UAAU,CAAA;AAEjB,uDAAuD;AACvD,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAEjD;AA4DD,oDAAoD;AACpD,wBAAgB,WAAW,CAAC,IAAI,EAAE,IAAI,GAAG,YAAY,CA0CpD"}

package/dist/rules/compiler.js

@@ -0,0 +1,210 @@
+/**
+ * SQL compiler — rule → parameterized DuckDB query.
+ *
+ * Design principles:
+ *   - `$userId`, `$brand`, `$familyId` are always bound via
+ *     `analytics.execute(sql, params)`. Never string-concatenated.
+ *   - Static rule params (thresholds, window edges) are also bound as
+ *     `$<name>`. Never concatenated.
+ *   - Table + column identifiers are looked up in `METRIC_METADATA`,
+ *     sanitized with `[^A-Za-z0-9_]/g → _`, then inlined as literals.
+ *     DuckDB has no parameter binding for identifiers.
+ *   - `rawSql` bypasses codegen; the compiler only allow-lists
+ *     placeholders declared in `rule.rawSqlParams` (plus the three
+ *     runtime-bound ones).
+ *
+ * The result rowshape is uniform: every SELECT projects
+ *   observed_value NUMERIC, threshold_value NUMERIC
+ * so the evaluator can build `RuleViolation` without dispatching per
+ * target type.
+ */
+import { METRIC_METADATA } from '../core/metric_metadata';
+import { RuleValidationError, } from './schema';
+/** Sanitize an identifier for direct interpolation. */
+export function sanitizeIdent(raw) {
+    return raw.replace(/[^A-Za-z0-9_]/g, '_');
+}
+/** Timestamp column per table — `sleep_session` uses `ts_start`. */
+function tsColumn(table) {
+    return table === 'sleep_session' ? 'ts_start' : 'ts';
+}
+/**
+ * DuckDB duration literal for `NOW() - INTERVAL '<window>'`. Encodes
+ * hours or days explicitly rather than relying on TZ-aware helpers.
+ */
+function windowInterval(window) {
+    switch (window) {
+        case '1h': return `INTERVAL '1 hour'`;
+        case '6h': return `INTERVAL '6 hours'`;
+        case '24h': return `INTERVAL '24 hours'`;
+        case '3d': return `INTERVAL '3 days'`;
+        case '7d': return `INTERVAL '7 days'`;
+        case '30d': return `INTERVAL '30 days'`;
+    }
+}
+/** SQL fragment mapping an aggregation to its call over `<column>`. */
+function aggExpr(agg, column, ts) {
+    switch (agg) {
+        case 'avg': return `AVG(${column})`;
+        case 'min': return `MIN(${column})`;
+        case 'max': return `MAX(${column})`;
+        case 'sum': return `SUM(${column})`;
+        case 'count': return `COUNT(${column})`;
+        case 'last': return `arg_max(${column}, ${ts})`;
+    }
+}
+/** `HAVING`-style clause for a compare operator. */
+function compareClause(compare, lhs, rhs) {
+    switch (compare) {
+        case 'less_than': return `${lhs} < ${rhs}`;
+        case 'greater_than': return `${lhs} > ${rhs}`;
+        case 'equals': return `${lhs} = ${rhs}`;
+        case 'not_equals': return `${lhs} <> ${rhs}`;
+        case 'between': throw new Error('between handled per-target');
+    }
+}
+const ALLOWED_RAW_PLACEHOLDERS = new Set(['userId', 'brand', 'familyId']);
+/** Extract every `$name` placeholder from a SQL string. */
+function placeholdersOf(sql) {
+    const out = [];
+    const re = /\$([A-Za-z_][A-Za-z0-9_]*)/g;
+    let match;
+    match = re.exec(sql);
+    while (match !== null) {
+        out.push(match[1]);
+        match = re.exec(sql);
+    }
+    return out;
+}
+/** Compile a validated rule to a `CompiledRule`. */
+export function compileRule(rule) {
+    const meta = METRIC_METADATA[rule.metric];
+    const rawTable = meta.table;
+    const rawColumn = meta.column;
+    const table = sanitizeIdent(rawTable);
+    const column = sanitizeIdent(rawColumn);
+    if (rule.rawSql) {
+        return compileRawSql(rule, rule.rawSql);
+    }
+    const ts = tsColumn(rawTable);
+    const interval = windowInterval(rule.window);
+    const filter = `WHERE user_id = $userId AND brand = $brand AND family_id = $familyId `
+        + `AND ${ts} > NOW() - ${interval}`;
+    const agg = aggExpr(rule.aggregation, column, ts);
+    const params = {};
+    const description = `${rule.metric} ${rule.aggregation} over ${rule.window} ${rule.compare} ${describeTarget(rule.target)}`;
+    const { sql, params: extraParams } = buildForTarget({
+        table,
+        ts,
+        interval,
+        column,
+        agg,
+        filter,
+        target: rule.target,
+        compare: rule.compare,
+    });
+    Object.assign(params, extraParams);
+    return {
+        ruleId: rule.id,
+        metric: rule.metric,
+        sql,
+        params,
+        description,
+    };
+}
+function describeTarget(target) {
+    switch (target.type) {
+        case 'absolute': return `${target.value}`;
+        case 'baseline_percent': return `${target.percent}% of ${target.windowDays}d baseline`;
+        case 'baseline_stddev': return `${target.stddevs} stddev over ${target.windowDays}d baseline`;
+        case 'range': return `[${target.min}, ${target.max}]`;
+    }
+}
+function buildForTarget(args) {
+    const { table, ts, column, agg, filter, target, compare } = args;
+    if (target.type === 'absolute') {
+        const params = { threshold_absolute: target.value };
+        const sql = `SELECT ${agg} AS observed_value, $threshold_absolute AS threshold_value
+FROM ${table}
+${filter}
+HAVING ${compareClause(compare, 'observed_value', '$threshold_absolute')};`;
+        return { sql, params };
+    }
+    if (target.type === 'range') {
+        const params = { range_min: target.min, range_max: target.max };
+        // For range, `between` violates on values OUTSIDE the range; other
+        // compares treat range as a threshold-with-tolerance and use the min
+        // bound as threshold_value for reporting.
+        const outside = compare === 'between'
+            ? `NOT (observed_value BETWEEN $range_min AND $range_max)`
+            : compareClause(compare, 'observed_value', '$range_min');
+        const sql = `SELECT ${agg} AS observed_value, $range_min AS threshold_value
+FROM ${table}
+${filter}
+HAVING ${outside};`;
+        return { sql, params };
+    }
+    // Baselines use a CTE for the user's historical mean over windowDays.
+    // DuckDB can't parametrize inside an INTERVAL literal, but it can
+    // multiply a static unit interval by a bound integer.
+    const baselineDaysBind = `(INTERVAL 1 DAY) * $baselineDays`;
+    if (target.type === 'baseline_percent') {
+        const params = {
+            baselineDays: target.windowDays,
+            pct: target.percent,
+        };
+        const sql = `WITH baseline AS (
+  SELECT AVG(${column}) AS mean
+  FROM ${table}
+  WHERE user_id = $userId AND brand = $brand AND family_id = $familyId
+    AND ${ts} > NOW() - ${baselineDaysBind}
+)
+SELECT ${agg} AS observed_value,
+       (SELECT mean FROM baseline) * ($pct / 100.0) AS threshold_value
+FROM ${table}
+${filter}
+HAVING ${compareClause(compare, 'observed_value', 'threshold_value')};`;
+        return { sql, params };
+    }
+    // baseline_stddev
+    const params = {
+        baselineDays: target.windowDays,
+        stddevs: target.stddevs,
+    };
+    const sql = `WITH baseline AS (
+  SELECT AVG(${column}) AS mean, stddev_pop(${column}) AS sd
+  FROM ${table}
+  WHERE user_id = $userId AND brand = $brand AND family_id = $familyId
+    AND ${ts} > NOW() - ${baselineDaysBind}
+)
+SELECT ${agg} AS observed_value,
+       (SELECT mean + $stddevs * sd FROM baseline) AS threshold_value
+FROM ${table}
+${filter}
+HAVING ${compareClause(compare, 'observed_value', 'threshold_value')};`;
+    return { sql, params };
+}
+/**
+ * Pass-through path with allow-list check. Placeholders must be one of
+ * {userId, brand, familyId} or declared in `rule.rawSqlParams`.
+ */
+function compileRawSql(rule, rawSql) {
+    const placeholders = placeholdersOf(rawSql);
+    const allowed = new Set(ALLOWED_RAW_PLACEHOLDERS);
+    for (const p of rule.rawSqlParams ?? []) {
+        allowed.add(p);
+    }
+    for (const p of placeholders) {
+        if (!allowed.has(p)) {
+            throw new RuleValidationError(`Rule ${rule.id}: rawSql placeholder $${p} not declared in rawSqlParams.`);
+        }
+    }
+    return {
+        ruleId: rule.id,
+        metric: rule.metric,
+        sql: rawSql,
+        params: {},
+        description: `rawSql:${rule.metric}`,
+    };
+}
+//# sourceMappingURL=compiler.js.map

package/dist/rules/compiler.js.map

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

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

@@ -0,0 +1,13 @@
+/**
+ * Brand default rule catalogs.
+ *
+ * Each brand exports a fully-validated `Rule[]` parsed from its inlined
+ * TOML source at package-load time; a malformed default therefore fails
+ * fast rather than at first evaluate.
+ */
+export { zivaDefaults } from './ziva';
+export { luminxDefaults } from './luminx';
+export { vivaDefaults } from './viva';
+export { yogaringDefaults } from './yogaring';
+export { parseCatalog, type ParseCatalogOptions } from './loader';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/rules/defaults/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAA;AACrC,OAAO,EAAE,cAAc,EAAE,MAAM,UAAU,CAAA;AACzC,OAAO,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAA;AACrC,OAAO,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAA;AAC7C,OAAO,EAAE,YAAY,EAAE,KAAK,mBAAmB,EAAE,MAAM,UAAU,CAAA"}

package/dist/rules/defaults/index.js

@@ -0,0 +1,13 @@
+/**
+ * Brand default rule catalogs.
+ *
+ * Each brand exports a fully-validated `Rule[]` parsed from its inlined
+ * TOML source at package-load time; a malformed default therefore fails
+ * fast rather than at first evaluate.
+ */
+export { zivaDefaults } from './ziva';
+export { luminxDefaults } from './luminx';
+export { vivaDefaults } from './viva';
+export { yogaringDefaults } from './yogaring';
+export { parseCatalog } from './loader';
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/rules/defaults/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAA;AACrC,OAAO,EAAE,cAAc,EAAE,MAAM,UAAU,CAAA;AACzC,OAAO,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAA;AACrC,OAAO,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAA;AAC7C,OAAO,EAAE,YAAY,EAA4B,MAAM,UAAU,CAAA"}

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

@@ -0,0 +1,18 @@
+/**
+ * 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 { type Rule } from '../schema';
+export interface ParseCatalogOptions {
+    /** Human-readable catalog name for error messages (e.g. `'ziva'`). */
+    name?: string;
+}
+export declare function parseCatalog(toml: string, options?: ParseCatalogOptions): Rule[];
+//# sourceMappingURL=loader.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"loader.d.ts","sourceRoot":"","sources":["../../../src/rules/defaults/loader.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAGH,OAAO,EAAmC,KAAK,IAAI,EAAE,MAAM,WAAW,CAAA;AAMtE,MAAM,WAAW,mBAAmB;IAClC,sEAAsE;IACtE,IAAI,CAAC,EAAE,MAAM,CAAA;CACd;AAED,wBAAgB,YAAY,CAC1B,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE,mBAAmB,GAC5B,IAAI,EAAE,CA8BR"}

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