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

package/dist/rules/schema.js

@@ -0,0 +1,80 @@
+/**
+ * Zod schema for structured threshold rules (spec §Rule schema).
+ *
+ * The `metric` enum is generated at module load from the frozen
+ * `METRIC_METADATA` registry — only metrics with `exposure: 'full'` are
+ * accepted. Rules referencing `collected_only` metrics can still ship
+ * via `rawSql` + `exposureOverride: true` (see validator.ts).
+ */
+import { z } from 'zod';
+import { getExposedMetricIds } from '../core/metric_metadata';
+/** Custom error class for rule-schema / validator failures. */
+export class RuleValidationError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = 'RuleValidationError';
+    }
+}
+const exposedMetricIds = getExposedMetricIds();
+export const WINDOWS = ['1h', '6h', '24h', '3d', '7d', '30d'];
+export const AGGREGATIONS = ['avg', 'min', 'max', 'sum', 'last', 'count'];
+export const COMPARES = [
+    'less_than',
+    'greater_than',
+    'equals',
+    'not_equals',
+    'between',
+];
+export const SEVERITIES = ['info', 'warn', 'critical'];
+const TargetAbsolute = z.object({
+    type: z.literal('absolute'),
+    value: z.number(),
+});
+const TargetBaselinePercent = z.object({
+    type: z.literal('baseline_percent'),
+    windowDays: z.number().int().positive(),
+    percent: z.number().positive(),
+});
+const TargetBaselineStddev = z.object({
+    type: z.literal('baseline_stddev'),
+    windowDays: z.number().int().positive(),
+    stddevs: z.number(),
+});
+const TargetRange = z.object({
+    type: z.literal('range'),
+    min: z.number(),
+    max: z.number(),
+});
+export const TargetSchema = z.discriminatedUnion('type', [
+    TargetAbsolute,
+    TargetBaselinePercent,
+    TargetBaselineStddev,
+    TargetRange,
+]);
+export const ThrottleSchema = z
+    .object({
+    minGapMinutes: z.number().nonnegative().default(60),
+    maxPerDay: z.number().int().positive().default(3),
+})
+    .default({});
+export const RuleSchema = z.object({
+    id: z.string().min(1),
+    brand: z.string().optional(),
+    name: z.string().min(1),
+    description: z.string().optional(),
+    metric: z.enum(exposedMetricIds),
+    window: z.enum(WINDOWS),
+    aggregation: z.enum(AGGREGATIONS).default('avg'),
+    compare: z.enum(COMPARES),
+    target: TargetSchema,
+    severity: z.enum(SEVERITIES),
+    throttle: ThrottleSchema,
+    rawSql: z.string().optional(),
+    rawSqlParams: z.array(z.string()).optional(),
+    /**
+     * Required-true when `rawSql` references `collected_only` columns
+     * (BP, vascular aging). Validator enforces.
+     */
+    exposureOverride: z.boolean().optional(),
+});
+//# sourceMappingURL=schema.js.map

package/dist/rules/schema.js.map

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

package/dist/rules/throttle.d.ts

@@ -0,0 +1,27 @@
+/**
+ * KV-backed throttle store for rule fires.
+ *
+ * Two keys per (rule, user):
+ *   - `analytics:rules:throttle:{ruleId}:{userId}:last` → ISO date string
+ *   - `analytics:rules:throttle:{ruleId}:{userId}:count:{yyyy-mm-dd}` → number
+ *
+ * Order of checks: min-gap first, then daily cap. Stale daily-count
+ * entries (from earlier days) are best-effort deleted on next-day reads.
+ *
+ * All time reads go through an injected `clock: () => Date` so tests can
+ * pin the wall clock. Production defaults to `() => new Date()`.
+ */
+import type { KVStore } from '../core/types';
+import type { Clock, RulesLogger } from './types';
+import type { Throttle } from './schema';
+export interface ThrottleStore {
+    isThrottled(ruleId: string, userId: string, throttle: Throttle): Promise<boolean>;
+    recordFire(ruleId: string, userId: string): Promise<void>;
+}
+export interface CreateThrottleConfig {
+    storage: KVStore;
+    clock?: Clock;
+    logger?: RulesLogger;
+}
+export declare function createThrottleStore({ storage, clock, logger, }: CreateThrottleConfig): ThrottleStore;
+//# sourceMappingURL=throttle.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"throttle.d.ts","sourceRoot":"","sources":["../../src/rules/throttle.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,eAAe,CAAA;AAC5C,OAAO,KAAK,EAAE,KAAK,EAAE,WAAW,EAAE,MAAM,SAAS,CAAA;AACjD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAA;AAoBxC,MAAM,WAAW,aAAa;IAC5B,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAAC,OAAO,CAAC,CAAA;IACjF,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;CAC1D;AAED,MAAM,WAAW,oBAAoB;IACnC,OAAO,EAAE,OAAO,CAAA;IAChB,KAAK,CAAC,EAAE,KAAK,CAAA;IACb,MAAM,CAAC,EAAE,WAAW,CAAA;CACrB;AAED,wBAAgB,mBAAmB,CAAC,EAClC,OAAO,EACP,KAAwB,EACxB,MAAM,GACP,EAAE,oBAAoB,GAAG,aAAa,CAmDtC"}

package/dist/rules/throttle.js

@@ -0,0 +1,76 @@
+/**
+ * KV-backed throttle store for rule fires.
+ *
+ * Two keys per (rule, user):
+ *   - `analytics:rules:throttle:{ruleId}:{userId}:last` → ISO date string
+ *   - `analytics:rules:throttle:{ruleId}:{userId}:count:{yyyy-mm-dd}` → number
+ *
+ * Order of checks: min-gap first, then daily cap. Stale daily-count
+ * entries (from earlier days) are best-effort deleted on next-day reads.
+ *
+ * All time reads go through an injected `clock: () => Date` so tests can
+ * pin the wall clock. Production defaults to `() => new Date()`.
+ */
+const KEY_PREFIX = 'analytics:rules:throttle:';
+function lastKey(ruleId, userId) {
+    return `${KEY_PREFIX}${ruleId}:${userId}:last`;
+}
+function countKey(ruleId, userId, ymd) {
+    return `${KEY_PREFIX}${ruleId}:${userId}:count:${ymd}`;
+}
+/** yyyy-mm-dd in UTC. */
+function ymdOf(d) {
+    const y = d.getUTCFullYear();
+    const m = String(d.getUTCMonth() + 1).padStart(2, '0');
+    const day = String(d.getUTCDate()).padStart(2, '0');
+    return `${y}-${m}-${day}`;
+}
+export function createThrottleStore({ storage, clock = () => new Date(), logger, }) {
+    return {
+        async isThrottled(ruleId, userId, throttle) {
+            const now = clock();
+            const ymd = ymdOf(now);
+            // Min-gap check.
+            const lastRaw = await storage.get(lastKey(ruleId, userId));
+            if (lastRaw) {
+                const last = new Date(lastRaw);
+                const gapMs = now.getTime() - last.getTime();
+                const minGapMs = throttle.minGapMinutes * 60 * 1000;
+                if (gapMs < minGapMs) {
+                    logger?.debug('rules.throttle: gap', {
+                        ruleId,
+                        userId,
+                        gapMs,
+                        minGapMs,
+                    });
+                    return true;
+                }
+                // Purge stale daily-count keys from prior days (best-effort).
+                const lastYmd = ymdOf(last);
+                if (lastYmd !== ymd) {
+                    await storage.delete(countKey(ruleId, userId, lastYmd));
+                }
+            }
+            // Daily cap check.
+            const count = (await storage.get(countKey(ruleId, userId, ymd))) ?? 0;
+            if (count >= throttle.maxPerDay) {
+                logger?.debug('rules.throttle: daily cap', {
+                    ruleId,
+                    userId,
+                    count,
+                    maxPerDay: throttle.maxPerDay,
+                });
+                return true;
+            }
+            return false;
+        },
+        async recordFire(ruleId, userId) {
+            const now = clock();
+            const ymd = ymdOf(now);
+            await storage.set(lastKey(ruleId, userId), now.toISOString());
+            const count = (await storage.get(countKey(ruleId, userId, ymd))) ?? 0;
+            await storage.set(countKey(ruleId, userId, ymd), count + 1);
+        },
+    };
+}
+//# sourceMappingURL=throttle.js.map

package/dist/rules/throttle.js.map

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

package/dist/rules/types.d.ts

@@ -0,0 +1,88 @@
+/**
+ * Public runtime types for @mongrov/analytics/rules.
+ *
+ * Kept structural (no z.infer imports at value level) so downstream
+ * consumers don't need to pull the Zod schema module unless they
+ * validate rules themselves.
+ */
+import type { AnalyticsEngine, FamilyMembersProvider, KVStore, Unsubscribe } from '../core/types';
+import type { MetricId } from '../core/metric_metadata';
+import type { TableName } from '../core/schemas';
+import type { Rule } from './schema';
+export type { Unsubscribe };
+/** Rule severity mirrors the `insight.severity` column. */
+export type RuleSeverity = 'info' | 'warn' | 'critical';
+/**
+ * Subset of a flushed batch that the rules engine reads to gate work.
+ * Sync produces this shape after a successful flush.
+ *
+ * Named `FlushSummary` to avoid collision with sync's own `SensorBatch`
+ * (which is the pre-flush push envelope, not the post-flush summary).
+ */
+export interface FlushSummary {
+    affectedUserIds: string[];
+    affectedTables: TableName[];
+}
+/**
+ * Compiled artifact for a rule. `sql` uses `$name` placeholders bound
+ * via `analytics.execute(sql, params)`; identifiers are already inlined
+ * as sanitized literals inside `sql`.
+ */
+export interface CompiledRule {
+    ruleId: string;
+    metric: MetricId;
+    sql: string;
+    /** Statically-known params. Runtime binds `$userId`/`$brand`/`$familyId` on top. */
+    params: Record<string, string | number>;
+    description: string;
+}
+/** Structured violation delivered to `on('violation', handler)` subscribers. */
+export interface RuleViolation {
+    ruleId: string;
+    ruleName: string;
+    severity: RuleSeverity;
+    userId: string;
+    familyId: string;
+    brand: string;
+    observedValue: number;
+    thresholdValue: number;
+    observedAt: Date;
+    evidence: Record<string, unknown>;
+}
+/** Structured logger (subset of AnalyticsLogger). */
+export interface RulesLogger {
+    debug(message: string, meta?: Record<string, unknown>): void;
+    info(message: string, meta?: Record<string, unknown>): void;
+    warn(message: string, meta?: Record<string, unknown>): void;
+    error(message: string, meta?: Record<string, unknown>): void;
+}
+/** Injected by tests; production defaults to `new Date()`. */
+export type Clock = () => Date;
+/** Config for `createRulesEngine`. */
+export interface RulesEngineConfig {
+    analytics: AnalyticsEngine;
+    storage: KVStore;
+    familyMembersProvider: FamilyMembersProvider;
+    brand: string;
+    /** Family id for `onSchedule` — v0.1.0 single-user apps pass the userId. */
+    familyId: string;
+    logger?: RulesLogger;
+    clock?: Clock;
+}
+/** Public rules engine surface. */
+export interface RulesEngine {
+    register(rules: Rule[]): Promise<void>;
+    enable(ruleId: string): Promise<void>;
+    disable(ruleId: string): Promise<void>;
+    list(): Rule[];
+    getActive(): Rule[];
+    evaluateOnBatch(batch: FlushSummary): Promise<RuleViolation[]>;
+    evaluateScheduled(): Promise<RuleViolation[]>;
+    on(event: 'violation', handler: (v: RuleViolation) => void): Unsubscribe;
+    /**
+     * Subscribe to registry mutations (register / enable / disable). Backs the
+     * `useRuleRegistry` hook via `useSyncExternalStore`.
+     */
+    subscribeRegistry(listener: () => void): Unsubscribe;
+}
+//# sourceMappingURL=types.d.ts.map

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

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

package/dist/rules/types.js

@@ -0,0 +1,9 @@
+/**
+ * Public runtime types for @mongrov/analytics/rules.
+ *
+ * Kept structural (no z.infer imports at value level) so downstream
+ * consumers don't need to pull the Zod schema module unless they
+ * validate rules themselves.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/rules/types.js.map

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

package/dist/rules/validator.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Static validation for rules — sampling-minimum + rawSql exposure check.
+ *
+ * Called at `register()` time (before compilation). Fails fast with a
+ * `RuleValidationError` whose message includes the metric's sampling
+ * cadence + the minimum viable window.
+ */
+import { type MetricId } from '../core/metric_metadata';
+import type { RulesLogger } from './types';
+import { type Rule, type Window } from './schema';
+/**
+ * Allow-list of windows compatible with `metric.sampling_minutes`.
+ * A window is compatible iff its duration ≥ (2 × sampling cadence),
+ * i.e. the query is guaranteed to see at least two samples worst-case.
+ * `per_session` metrics (sleep_score, sleep_total_minutes) require ≥ 3d.
+ */
+export declare function allowedWindowsFor(metric: MetricId): Window[];
+/**
+ * Validate a parsed rule. Throws `RuleValidationError` on any of:
+ *   - window smaller than the metric sampling cadence allows,
+ *   - rawSql references a `collected_only` column without `exposureOverride: true`.
+ * When rawSql is present with `exposureOverride: true`, emits a warn via `logger`.
+ */
+export declare function validateRule(rule: Rule, logger?: RulesLogger): void;
+/** Scan a rawSql body for whole-word references to collected-only columns. */
+export declare function referencedCollectedOnlyColumns(sql: string): string[];
+//# sourceMappingURL=validator.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"validator.d.ts","sourceRoot":"","sources":["../../src/rules/validator.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAmB,KAAK,QAAQ,EAAE,MAAM,yBAAyB,CAAA;AACxE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,SAAS,CAAA;AAC1C,OAAO,EAAE,KAAK,IAAI,EAAuB,KAAK,MAAM,EAAW,MAAM,UAAU,CAAA;AA4B/E;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,QAAQ,GAAG,MAAM,EAAE,CAS5D;AAgBD;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,IAAI,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,IAAI,CAwBnE;AAED,8EAA8E;AAC9E,wBAAgB,8BAA8B,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,EAAE,CAOpE"}

package/dist/rules/validator.js

@@ -0,0 +1,97 @@
+/**
+ * Static validation for rules — sampling-minimum + rawSql exposure check.
+ *
+ * Called at `register()` time (before compilation). Fails fast with a
+ * `RuleValidationError` whose message includes the metric's sampling
+ * cadence + the minimum viable window.
+ */
+import { METRIC_METADATA } from '../core/metric_metadata';
+import { RuleValidationError, WINDOWS } from './schema';
+/** Window durations in minutes. */
+const WINDOW_MINUTES = {
+    '1h': 60,
+    '6h': 6 * 60,
+    '24h': 24 * 60,
+    '3d': 3 * 24 * 60,
+    '7d': 7 * 24 * 60,
+    '30d': 30 * 24 * 60,
+};
+/**
+ * Explicit table per spec §Sampling-minimum validator. The remaining
+ * exposed metrics fall through to a derived allow-list built from
+ * `METRIC_METADATA[id].sampling_minutes` (see `allowedWindowsFor`).
+ */
+const EXPLICIT_SAMPLING_MINIMUMS = {
+    hrv_ms: ['24h', '3d', '7d', '30d'],
+    stress: ['6h', '24h', '3d', '7d', '30d'],
+    hr_bpm: ['1h', '6h', '24h', '3d', '7d', '30d'],
+    spo2: ['6h', '24h', '3d', '7d', '30d'],
+    temp_c: ['24h', '3d', '7d', '30d'],
+    activity_steps: ['1h', '6h', '24h', '3d', '7d', '30d'],
+    sleep_total_minutes: ['3d', '7d'],
+    device_battery: ['1h', '6h', '24h'],
+};
+/**
+ * Allow-list of windows compatible with `metric.sampling_minutes`.
+ * A window is compatible iff its duration ≥ (2 × sampling cadence),
+ * i.e. the query is guaranteed to see at least two samples worst-case.
+ * `per_session` metrics (sleep_score, sleep_total_minutes) require ≥ 3d.
+ */
+export function allowedWindowsFor(metric) {
+    const explicit = EXPLICIT_SAMPLING_MINIMUMS[metric];
+    if (explicit)
+        return explicit;
+    const cadence = METRIC_METADATA[metric].sampling_minutes;
+    if (cadence === 'per_session') {
+        return ['3d', '7d', '30d'];
+    }
+    const minWindow = cadence * 2;
+    return WINDOWS.filter(w => WINDOW_MINUTES[w] >= minWindow);
+}
+/** Columns whose metric is marked `collected_only`. */
+const COLLECTED_ONLY_COLUMNS = new Set(Object.values(METRIC_METADATA)
+    .filter(entry => entry.exposure === 'collected_only')
+    .map(entry => entry.column));
+function samplingLabel(metric) {
+    const cadence = METRIC_METADATA[metric].sampling_minutes;
+    return cadence === 'per_session'
+        ? 'once per sleep session'
+        : `every ${cadence}min`;
+}
+/**
+ * Validate a parsed rule. Throws `RuleValidationError` on any of:
+ *   - window smaller than the metric sampling cadence allows,
+ *   - rawSql references a `collected_only` column without `exposureOverride: true`.
+ * When rawSql is present with `exposureOverride: true`, emits a warn via `logger`.
+ */
+export function validateRule(rule, logger) {
+    const allowed = allowedWindowsFor(rule.metric);
+    if (!allowed.includes(rule.window)) {
+        throw new RuleValidationError(`Rule ${rule.id}: metric ${rule.metric} sampled ${samplingLabel(rule.metric)}. `
+            + `Window ${rule.window} too small. Minimum viable: ${allowed[0]}.`);
+    }
+    if (rule.rawSql) {
+        const references = referencedCollectedOnlyColumns(rule.rawSql);
+        if (references.length > 0 && !rule.exposureOverride) {
+            throw new RuleValidationError(`Rule ${rule.id}: rawSql references collected_only column(s) [${references.join(', ')}]. `
+                + `Set exposureOverride: true to acknowledge.`);
+        }
+        if (rule.exposureOverride && logger) {
+            logger.warn('rules.validator: rawSql exposureOverride active', {
+                ruleId: rule.id,
+                columns: references,
+            });
+        }
+    }
+}
+/** Scan a rawSql body for whole-word references to collected-only columns. */
+export function referencedCollectedOnlyColumns(sql) {
+    const hits = new Set();
+    for (const col of COLLECTED_ONLY_COLUMNS) {
+        const pattern = new RegExp(`\\b${col}\\b`);
+        if (pattern.test(sql))
+            hits.add(col);
+    }
+    return Array.from(hits);
+}
+//# sourceMappingURL=validator.js.map

package/dist/rules/validator.js.map

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

package/dist/sync/buffer.d.ts

@@ -0,0 +1,51 @@
+/**
+ * Sensor buffer (T-10 + T-12).
+ *
+ * In-memory ring per table with byte-budget accounting and pluggable overflow
+ * policies. All ops are synchronous except `push` (which may await overflow
+ * writes when the ring exceeds its byte budget).
+ *
+ * Byte accounting: we estimate a row's contribution as
+ * `JSON.stringify(rows).length` at push time. This is a rough proxy for the
+ * DuckDB Appender's actual memory footprint but is stable and cheap. The
+ * budget is a soft limit — one push at a time can exceed it before overflow
+ * fires.
+ *
+ * Overflow policies (T-12):
+ *   - `drop-oldest`: when the ring is full, spill the oldest ring entries to
+ *     `OverflowStore` until the incoming push fits in memory. Overflow is
+ *     durable (MMKV via KVStore) so nothing is actually dropped.
+ *   - `drop-newest`: reject the incoming push and increment a dropped
+ *     counter. Warning event is emitted via the injected `onDrop` callback.
+ *     Data is lost — used only when the app opts in for battery-only sync.
+ *   - `block`: `push` awaits an external drain. Implemented via a
+ *     `Promise`-based backpressure signal.
+ */
+import type { OverflowStore } from './overflow';
+import type { BufferEntry, BufferSize, OverflowPolicy, SensorBatch } from './types';
+export interface SensorBufferConfig {
+    overflow: OverflowStore;
+    maxBufferBytes?: number;
+    policy?: OverflowPolicy;
+    /** Fired when a `drop-newest` policy discards an incoming push. */
+    onDrop?: (entry: {
+        table: string;
+        droppedRowCount: number;
+        reason: 'drop-newest';
+    }) => void;
+    /** Optional clock injection for deterministic tests. */
+    now?: () => number;
+}
+export declare class SensorBuffer {
+    #private;
+    constructor(config: SensorBufferConfig);
+    push(batch: SensorBatch): Promise<void>;
+    /**
+     * Drain the buffer for a single table. Overflow entries are drained first
+     * so FIFO order across in-memory + overflow is preserved.
+     */
+    drain(table: string): Promise<BufferEntry[]>;
+    size(table?: string): Promise<BufferSize>;
+    clear(table?: string): Promise<void>;
+}
+//# sourceMappingURL=buffer.d.ts.map

package/dist/sync/buffer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"buffer.d.ts","sourceRoot":"","sources":["../../src/sync/buffer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAA;AAC/C,OAAO,KAAK,EACV,WAAW,EACX,UAAU,EACV,cAAc,EACd,WAAW,EACZ,MAAM,SAAS,CAAA;AAIhB,MAAM,WAAW,kBAAkB;IACjC,QAAQ,EAAE,aAAa,CAAA;IACvB,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB,MAAM,CAAC,EAAE,cAAc,CAAA;IACvB,mEAAmE;IACnE,MAAM,CAAC,EAAE,CAAC,KAAK,EAAE;QACf,KAAK,EAAE,MAAM,CAAA;QACb,eAAe,EAAE,MAAM,CAAA;QACvB,MAAM,EAAE,aAAa,CAAA;KACtB,KAAK,IAAI,CAAA;IACV,wDAAwD;IACxD,GAAG,CAAC,EAAE,MAAM,MAAM,CAAA;CACnB;AAED,qBAAa,YAAY;;gBAWX,MAAM,EAAE,kBAAkB;IAQhC,IAAI,CAAC,KAAK,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC;IAa7C;;;OAGG;IACG,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;IAU5C,IAAI,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC;IAkBzC,KAAK,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAqG3C"}