@uptimizr/db 0.1.0

package/dist/parity/compare.js

@@ -0,0 +1,90 @@
+/**
+ * Tolerance-aware row comparison for cross-engine parity (Phase C, ADR 0020).
+ *
+ * Two SQL engines (DuckDB for OSS, ClickHouse for the scale tier)
+ * implement the same dialect-agnostic aggregations. Their numeric output can
+ * differ in the last bits of floating-point arithmetic and their row order is
+ * only as stable as the query's `ORDER BY`. This module encodes the tolerance
+ * rules that let "equal analytics" be asserted despite those differences.
+ *
+ * ## Tolerance rules
+ *
+ * 1. **Order-insensitive.** Rows are compared as a multiset: both sides are
+ *    sorted by the case's `sortKeys` before comparison. SQL guarantees no row
+ *    order beyond an explicit `ORDER BY`, and ties under `ORDER BY count` are
+ *    unstable across engines.
+ * 2. **Float tolerance.** Numeric columns (averages, quantiles, ASOF ray
+ *    origins/hits) match when their absolute difference is within
+ *    {@link PARITY_ABS_TOLERANCE} or their relative difference is within
+ *    {@link PARITY_REL_TOLERANCE}. Counts and bin indices are integers and so
+ *    compare exactly under the same rule (difference 0).
+ * 3. **Bin indices are integer-exact.** Heatmap bin columns come from
+ *    `floor(...)` and are deterministic within an engine; they are integers and
+ *    compared exactly. Inputs are chosen to avoid landing exactly on a bin
+ *    boundary, where a sub-ulp difference could flip the floor across engines.
+ * 4. **Temporal projections are excluded.** Wall-clock `TIMESTAMP` columns
+ *    (e.g. `started_at`, `ended_at`, `last_seen`) are presentation metadata, not
+ *    analytics, and their string rendering differs by engine; list them in a
+ *    case's `ignoreColumns`. Date-granular `day` strings (`YYYY-MM-DD`) render
+ *    identically in both engines and are compared.
+ */
+/** Absolute tolerance for floating-point column comparison. */
+export const PARITY_ABS_TOLERANCE = 1e-6;
+/** Relative tolerance for floating-point column comparison. */
+export const PARITY_REL_TOLERANCE = 1e-9;
+function numbersClose(a, b) {
+    const diff = Math.abs(a - b);
+    if (diff <= PARITY_ABS_TOLERANCE)
+        return true;
+    const scale = Math.max(Math.abs(a), Math.abs(b));
+    return diff <= scale * PARITY_REL_TOLERANCE;
+}
+function sortKey(row, keys) {
+    return JSON.stringify(keys.map((k) => row[k] ?? null));
+}
+function sortRows(rows, keys) {
+    return [...rows].sort((a, b) => {
+        const ka = sortKey(a, keys);
+        const kb = sortKey(b, keys);
+        return ka < kb ? -1 : ka > kb ? 1 : 0;
+    });
+}
+function cellsEqual(actual, expected) {
+    if (typeof expected === "number" && typeof actual === "number") {
+        return numbersClose(actual, expected);
+    }
+    // DuckDB returns numerics as JS numbers; guard against string/number drift.
+    if (typeof expected === "number" && typeof actual === "string") {
+        const n = Number(actual);
+        return !Number.isNaN(n) && numbersClose(n, expected);
+    }
+    return Object.is(actual, expected);
+}
+/**
+ * Compare engine output against golden rows under the tolerance rules above.
+ * Returns a list of human-readable differences; an empty list means parity.
+ */
+export function diffParity(actual, golden, options) {
+    const errors = [];
+    const ignore = new Set(options.ignoreColumns ?? []);
+    if (actual.length !== golden.length) {
+        errors.push(`row count: expected ${golden.length}, got ${actual.length}`);
+        return errors;
+    }
+    const sortedActual = sortRows(actual, options.sortKeys);
+    const sortedGolden = sortRows(golden, options.sortKeys);
+    for (let i = 0; i < sortedGolden.length; i++) {
+        const exp = sortedGolden[i];
+        const act = sortedActual[i];
+        for (const col of Object.keys(exp)) {
+            if (ignore.has(col))
+                continue;
+            if (!cellsEqual(act[col], exp[col])) {
+                errors.push(`row ${i} column "${col}": expected ${JSON.stringify(exp[col])}, ` +
+                    `got ${JSON.stringify(act[col])}`);
+            }
+        }
+    }
+    return errors;
+}
+//# sourceMappingURL=compare.js.map

package/dist/parity/compare.js.map

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

package/dist/parity/fixtures.d.ts

@@ -0,0 +1,45 @@
+/**
+ * Shared cross-engine parity fixtures (Phase C, ADR 0020).
+ *
+ * A single deterministic event set that exercises every analytics aggregation —
+ * 2D/3D heatmaps, the camera-direction (gaze) heatmap, the ASOF click↔gaze ray
+ * and flow joins, quantile-based perf, the daily rollups, and the scene/session
+ * dimensions. The same fixtures and golden outputs are reused by:
+ *
+ * - the OSS DuckDB-vs-golden suite (`src/__tests__/duckdbParity.test.ts`), and
+ * - the DuckDB-vs-ClickHouse cross-engine suite (per ADR 0020, the
+ *   cross-engine half lives in the separately-licensed scale tier).
+ *
+ * Values are chosen so each aggregation produces more than one group and the
+ * arithmetic is hand-verifiable (see the golden in `cases.ts`).
+ */
+import type { AnyEvent } from "@uptimizr/schema";
+/** Project all parity fixtures belong to. */
+export declare const PARITY_PROJECT_ID = "parity-project";
+/** Base timestamp: a whole-minute boundary so the 60 s time bucket is exact. */
+export declare const PARITY_T0: number;
+/** Tight window covering every fixture event (spans T0 .. T0 + 14 s). */
+export declare const PARITY_RANGE: {
+    since: number;
+    until: number;
+};
+/**
+ * Day-granular window for the daily rollups. The upper bound is exclusive at
+ * date granularity in both engines, so span a full day on either side.
+ */
+export declare const PARITY_DAY_RANGE: {
+    since: number;
+    until: number;
+};
+/** The calendar day every fixture event lands on (UTC). */
+export declare const PARITY_DAY = "2024-06-16";
+/**
+ * Two sessions across two scenes.
+ *
+ * Session `s1` (scene `lobby`): two camera samples and two clicks that ASOF-join
+ * to distinct preceding samples, plus two perf samples.
+ * Session `s2` (scene `arena`): one camera sample, a move + click on the same
+ * mesh, and one perf sample.
+ */
+export declare const PARITY_EVENTS: AnyEvent[];
+//# sourceMappingURL=fixtures.d.ts.map

package/dist/parity/fixtures.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fixtures.d.ts","sourceRoot":"","sources":["../../src/parity/fixtures.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAEjD,6CAA6C;AAC7C,eAAO,MAAM,iBAAiB,mBAAmB,CAAC;AAElD,gFAAgF;AAChF,eAAO,MAAM,SAAS,QAAkC,CAAC;AAEzD,yEAAyE;AACzE,eAAO,MAAM,YAAY;;;CAGxB,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,gBAAgB;;;CAG5B,CAAC;AAEF,2DAA2D;AAC3D,eAAO,MAAM,UAAU,eAAe,CAAC;AAcvC;;;;;;;GAOG;AACH,eAAO,MAAM,aAAa,EAAE,QAAQ,EAuGnC,CAAC"}

package/dist/parity/fixtures.js

@@ -0,0 +1,157 @@
+/**
+ * Shared cross-engine parity fixtures (Phase C, ADR 0020).
+ *
+ * A single deterministic event set that exercises every analytics aggregation —
+ * 2D/3D heatmaps, the camera-direction (gaze) heatmap, the ASOF click↔gaze ray
+ * and flow joins, quantile-based perf, the daily rollups, and the scene/session
+ * dimensions. The same fixtures and golden outputs are reused by:
+ *
+ * - the OSS DuckDB-vs-golden suite (`src/__tests__/duckdbParity.test.ts`), and
+ * - the DuckDB-vs-ClickHouse cross-engine suite (per ADR 0020, the
+ *   cross-engine half lives in the separately-licensed scale tier).
+ *
+ * Values are chosen so each aggregation produces more than one group and the
+ * arithmetic is hand-verifiable (see the golden in `cases.ts`).
+ */
+/** Project all parity fixtures belong to. */
+export const PARITY_PROJECT_ID = "parity-project";
+/** Base timestamp: a whole-minute boundary so the 60 s time bucket is exact. */
+export const PARITY_T0 = Date.UTC(2024, 5, 16, 10, 0, 0);
+/** Tight window covering every fixture event (spans T0 .. T0 + 14 s). */
+export const PARITY_RANGE = {
+    since: PARITY_T0 - 60_000,
+    until: PARITY_T0 + 60_000,
+};
+/**
+ * Day-granular window for the daily rollups. The upper bound is exclusive at
+ * date granularity in both engines, so span a full day on either side.
+ */
+export const PARITY_DAY_RANGE = {
+    since: PARITY_T0 - 86_400_000,
+    until: PARITY_T0 + 86_400_000,
+};
+/** The calendar day every fixture event lands on (UTC). */
+export const PARITY_DAY = "2024-06-16";
+function ev(type, ts, extra = {}) {
+    return {
+        type,
+        projectId: PARITY_PROJECT_ID,
+        sessionId: "s1",
+        ts,
+        sdkVersion: "0.1.0",
+        sceneId: "lobby",
+        ...extra,
+    };
+}
+/**
+ * Two sessions across two scenes.
+ *
+ * Session `s1` (scene `lobby`): two camera samples and two clicks that ASOF-join
+ * to distinct preceding samples, plus two perf samples.
+ * Session `s2` (scene `arena`): one camera sample, a move + click on the same
+ * mesh, and one perf sample.
+ */
+export const PARITY_EVENTS = [
+    // --- session s1 / scene lobby ---
+    ev("session_start", PARITY_T0, {
+        scene: { cameraType: "arc-rotate", cameraName: "cam", meshCount: 3 },
+        user: { id: "anon-1" },
+        device: { engine: "webgpu" },
+    }),
+    ev("camera_sample", PARITY_T0 + 1_000, {
+        position: [0, 0, 0],
+        direction: [2, 1, 2],
+        hitPoint: [0.2, 0.2, 0.2],
+    }),
+    ev("pointer_click", PARITY_T0 + 2_000, {
+        screen: [0.15, 0.15],
+        hitPoint: [0.2, 0.2, 0.2],
+        hitMesh: "box",
+        button: 0,
+        source: "mouse",
+    }),
+    ev("camera_sample", PARITY_T0 + 3_000, {
+        position: [10, 0, 0],
+        direction: [1, 3, -2],
+        hitPoint: [5, 5, 5],
+    }),
+    ev("pointer_click", PARITY_T0 + 4_000, {
+        screen: [0.95, 0.95],
+        hitPoint: [5, 5, 5],
+        hitMesh: "sphere",
+        button: 0,
+        source: "mouse",
+    }),
+    ev("frame_perf", PARITY_T0 + 5_000, {
+        fps: 60,
+        frameTimeMs: 16,
+        frameTimeP95Ms: 20,
+        longFrames: 1,
+        dpr: 2,
+        renderScale: 1,
+    }),
+    ev("frame_perf", PARITY_T0 + 6_000, {
+        fps: 30,
+        frameTimeMs: 33,
+        frameTimeP95Ms: 40,
+        longFrames: 5,
+        dpr: 2,
+        renderScale: 0.8,
+    }),
+    // Two bucketed mesh_visibility summaries (#37): dwell on "box" and "sphere".
+    ev("mesh_visibility", PARITY_T0 + 7_000, {
+        mesh: "box",
+        visibleMs: 4000,
+        centeredMs: 1500,
+        maxScreenFraction: 0.4,
+    }),
+    ev("mesh_visibility", PARITY_T0 + 8_000, {
+        mesh: "sphere",
+        visibleMs: 2000,
+        centeredMs: 800,
+        maxScreenFraction: 0.7,
+    }),
+    // --- session s2 / scene arena ---
+    ev("session_start", PARITY_T0 + 10_000, {
+        sessionId: "s2",
+        sceneId: "arena",
+        scene: { cameraType: "free", cameraName: "cam2", meshCount: 5 },
+        user: { id: "anon-2" },
+        device: { engine: "webgl2" },
+    }),
+    ev("camera_sample", PARITY_T0 + 11_000, {
+        sessionId: "s2",
+        sceneId: "arena",
+        position: [0, 0, 0],
+        direction: [-2, -1, 1],
+        hitPoint: [1, 1, 1],
+    }),
+    ev("pointer_move", PARITY_T0 + 12_000, {
+        sessionId: "s2",
+        sceneId: "arena",
+        screen: [0.55, 0.55],
+        hitPoint: [1, 1, 1],
+        hitMesh: "floor",
+        source: "mouse",
+    }),
+    ev("pointer_click", PARITY_T0 + 13_000, {
+        sessionId: "s2",
+        sceneId: "arena",
+        screen: [0.55, 0.55],
+        hitPoint: [1, 1, 1],
+        hitMesh: "floor",
+        button: 2,
+        source: "mouse",
+    }),
+    ev("frame_perf", PARITY_T0 + 14_000, {
+        sessionId: "s2",
+        sceneId: "arena",
+        fps: 45,
+        frameTimeMs: 22,
+        frameTimeP95Ms: 28,
+        longFrames: 2,
+        dpr: 1,
+        renderScale: 1,
+    }),
+];
+//# sourceMappingURL=fixtures.js.map

package/dist/parity/fixtures.js.map

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

package/dist/parity/index.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Cross-engine analytics parity harness (Phase C, ADR 0020).
+ *
+ * Shared fixtures, golden expectations, and a tolerance-aware comparator so the
+ * same aggregation builders can be proven equal across SQL engines. The OSS
+ * package ships the DuckDB-vs-golden suite; the scale-tier side reuses these exports
+ * to run DuckDB-vs-ClickHouse.
+ */
+export * from "./fixtures.js";
+export * from "./compare.js";
+export * from "./cases.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/parity/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/parity/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,cAAc,eAAe,CAAC;AAC9B,cAAc,cAAc,CAAC;AAC7B,cAAc,YAAY,CAAC"}

package/dist/parity/index.js

@@ -0,0 +1,12 @@
+/**
+ * Cross-engine analytics parity harness (Phase C, ADR 0020).
+ *
+ * Shared fixtures, golden expectations, and a tolerance-aware comparator so the
+ * same aggregation builders can be proven equal across SQL engines. The OSS
+ * package ships the DuckDB-vs-golden suite; the scale-tier side reuses these exports
+ * to run DuckDB-vs-ClickHouse.
+ */
+export * from "./fixtures.js";
+export * from "./compare.js";
+export * from "./cases.js";
+//# sourceMappingURL=index.js.map

package/dist/parity/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/parity/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,cAAc,eAAe,CAAC;AAC9B,cAAc,cAAc,CAAC;AAC7B,cAAc,YAAY,CAAC"}