@uptimizr/collector-server 0.1.0 → 0.2.0

package/README.md

@@ -148,8 +148,14 @@ The storage backend is chosen with `COLLECTOR_STORE`:
   instance per file; back up by copying the file.
 - `memory` — a dependency-free in-memory store for local dev / E2E only (seed its
   project/key via `COLLECTOR_MEMORY_PROJECT_ID` / `COLLECTOR_MEMORY_API_KEY`).
+- `clickhouse` — a **single-tenant ClickHouse store** for the scale tier: events **and**
+  metadata (projects, API keys, scene representations) live in one ClickHouse database
+  (`CLICKHOUSE_URL` / `CLICKHOUSE_DATABASE` / `CLICKHOUSE_USER` / `CLICKHOUSE_PASSWORD`), created
+  on first boot. Use it for concurrent writers / horizontal scale and high-volume ingestion. The
+  full analytics surface returns results identical to DuckDB (cross-engine parity suite).
 
-The two-store ClickHouse + Postgres path is an optional scale tier and is not required to self-host the OSS collector.
+For multi-writer / horizontal scale, choose the `clickhouse` store; spin up a local ClickHouse
+with `infra/docker` (`pnpm stack:up`). The default DuckDB store needs no external service.
 
 ## Develop
 
@@ -161,8 +167,8 @@ pnpm --filter @uptimizr/collector-server build
 
 The data layer is abstracted by `CollectorStore`, so tests run against a fake store
 with `app.inject()` — no live database required. Local end-to-end runs use the
-default DuckDB store (a single file, no service to start); the ClickHouse + Postgres
-stack in `infra/docker` backs the optional scale tier only.
+default DuckDB store (a single file, no service to start); the `clickhouse` store in
+`infra/docker` backs the optional scale tier.
 
 ## License
 

package/dist/clickhouseStore.d.ts

@@ -0,0 +1,17 @@
+import type { CollectorStore } from "./store.js";
+/**
+ * Optional single-tenant ClickHouse store (ADR 0020): the scale path for
+ * self-hosters who outgrow DuckDB's single read-write process. It carries the
+ * **full** analytics surface — no stubbed aggregates — by rendering the same
+ * dialect-agnostic builders with {@link clickhouseDialect} and executing them
+ * over a ClickHouse server. Events live in the wide `events` table (plus the
+ * dedicated `node_samples`); metadata (projects, API keys, scene registry) is
+ * re-homed into the same database.
+ *
+ * The schema is migrated on creation (migrations are idempotent and forward-only),
+ * so the store is usable out of the box once a ClickHouse server is reachable.
+ * Connection settings come from `readDbSettings().clickhouse` (the `CLICKHOUSE_*`
+ * env vars).
+ */
+export declare function createClickhouseStore(): Promise<CollectorStore>;
+//# sourceMappingURL=clickhouseStore.d.ts.map

package/dist/clickhouseStore.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"clickhouseStore.d.ts","sourceRoot":"","sources":["../src/clickhouseStore.ts"],"names":[],"mappings":"AA4FA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAEjD;;;;;;;;;;;;;GAaG;AACH,wBAAsB,qBAAqB,IAAI,OAAO,CAAC,cAAc,CAAC,CAkGrE"}

package/dist/clickhouseStore.js

@@ -0,0 +1,74 @@
+import { buildCameraDirectionHeatmap, buildCameraDistance, buildCameraPositionHeatmap, buildClickGazeRay, buildDeadClicks, buildRageClicks, buildHoverDwell, buildCompileStalls, buildResourceSummary, buildCapabilityChanges, buildCameraGestures, buildDistinctScenes, buildEventTypeCounts, buildFlowHeatmap, buildListSessions, buildNavigationStats, buildXrRotationRate, buildXrSourceUsage, buildXrAbandonment, buildInteractionsBySource, buildMeshDwell, buildPerfSummary, buildPerfDistribution, buildFpsHistogram, buildFrameTimePercentiles, buildJankRate, buildPerfByDevice, buildPerfByScene, buildResourcePercentiles, buildStabilityCounts, buildPointerHeatmap, buildSceneCoverage, buildSessionTrajectory, buildTimeseries, buildTopMeshes, buildWorldHeatmap, buildGazeHeatmap, clickhouseDialect, readDbSettings, } from "@uptimizr/db";
+import { createClickhouseClient, migrateClickhouse, runClickhouseQuery, insertEvents as chInsertEvents, getSessionEvents as chGetSessionEvents, streamSessionEvents as chStreamSessionEvents, getSessionMeta as chGetSessionMeta, getProject as chGetProject, resolveApiKey as chResolveApiKey, upsertSceneProxy as chUpsertSceneProxy, getSceneRepresentation as chGetSceneRepresentation, listSceneRepresentations as chListSceneRepresentations, } from "@uptimizr/db-clickhouse";
+/**
+ * Optional single-tenant ClickHouse store (ADR 0020): the scale path for
+ * self-hosters who outgrow DuckDB's single read-write process. It carries the
+ * **full** analytics surface — no stubbed aggregates — by rendering the same
+ * dialect-agnostic builders with {@link clickhouseDialect} and executing them
+ * over a ClickHouse server. Events live in the wide `events` table (plus the
+ * dedicated `node_samples`); metadata (projects, API keys, scene registry) is
+ * re-homed into the same database.
+ *
+ * The schema is migrated on creation (migrations are idempotent and forward-only),
+ * so the store is usable out of the box once a ClickHouse server is reachable.
+ * Connection settings come from `readDbSettings().clickhouse` (the `CLICKHOUSE_*`
+ * env vars).
+ */
+export async function createClickhouseStore() {
+    const settings = readDbSettings().clickhouse;
+    const ch = createClickhouseClient(settings);
+    await migrateClickhouse(ch, settings);
+    const d = clickhouseDialect;
+    return {
+        resolveApiKey: (key) => chResolveApiKey(ch, key),
+        projectExists: async (projectId) => (await chGetProject(ch, projectId)) !== null,
+        insertEvents: (events) => chInsertEvents(ch, [...events]),
+        listSessions: (projectId, opts = {}) => runClickhouseQuery(ch, buildListSessions(projectId, opts, d)),
+        pointerHeatmap: (projectId, opts = {}) => runClickhouseQuery(ch, buildPointerHeatmap(projectId, opts, d)),
+        worldHeatmap: (projectId, opts = {}) => runClickhouseQuery(ch, buildWorldHeatmap(projectId, opts, d)),
+        gazeHeatmap: (projectId, opts = {}) => runClickhouseQuery(ch, buildGazeHeatmap(projectId, opts, d)),
+        cameraHeatmap: (projectId, opts = {}) => runClickhouseQuery(ch, buildCameraDirectionHeatmap(projectId, opts, d)),
+        cameraPositionHeatmap: (projectId, opts = {}) => runClickhouseQuery(ch, buildCameraPositionHeatmap(projectId, opts, d)),
+        sessionTrajectory: (projectId, sessionId, opts = {}) => runClickhouseQuery(ch, buildSessionTrajectory(projectId, { ...opts, session: sessionId }, d)),
+        clickGazeRays: (projectId, opts = {}) => runClickhouseQuery(ch, buildClickGazeRay(projectId, opts, d)),
+        flowHeatmap: (projectId, opts = {}) => runClickhouseQuery(ch, buildFlowHeatmap(projectId, opts, d)),
+        topMeshes: (projectId, opts = {}) => runClickhouseQuery(ch, buildTopMeshes(projectId, opts, d)),
+        meshDwell: (projectId, opts = {}) => runClickhouseQuery(ch, buildMeshDwell(projectId, opts, d)),
+        deadClicks: (projectId, opts = {}) => runClickhouseQuery(ch, buildDeadClicks(projectId, opts, d)),
+        rageClicks: (projectId, opts = {}) => runClickhouseQuery(ch, buildRageClicks(projectId, opts, d)),
+        hoverDwell: (projectId, opts = {}) => runClickhouseQuery(ch, buildHoverDwell(projectId, opts, d)),
+        compileStalls: (projectId, opts = {}) => runClickhouseQuery(ch, buildCompileStalls(projectId, opts, d)),
+        resourceSummary: (projectId, opts = {}) => runClickhouseQuery(ch, buildResourceSummary(projectId, opts, d)),
+        capabilityChanges: (projectId, opts = {}) => runClickhouseQuery(ch, buildCapabilityChanges(projectId, opts, d)),
+        cameraGestures: (projectId, opts = {}) => runClickhouseQuery(ch, buildCameraGestures(projectId, opts, d)),
+        perfSummary: (projectId, opts = {}) => runClickhouseQuery(ch, buildPerfSummary(projectId, opts, d)),
+        perfDistribution: (projectId, opts = {}) => runClickhouseQuery(ch, buildPerfDistribution(projectId, opts, d)),
+        fpsHistogram: (projectId, opts = {}) => runClickhouseQuery(ch, buildFpsHistogram(projectId, opts, d)),
+        frameTimePercentiles: (projectId, opts = {}) => runClickhouseQuery(ch, buildFrameTimePercentiles(projectId, opts, d)),
+        jankRate: (projectId, opts = {}) => runClickhouseQuery(ch, buildJankRate(projectId, opts, d)),
+        perfByDevice: (projectId, opts = {}) => runClickhouseQuery(ch, buildPerfByDevice(projectId, opts, d)),
+        perfByScene: (projectId, opts = {}) => runClickhouseQuery(ch, buildPerfByScene(projectId, opts, d)),
+        resourcePercentiles: (projectId, opts = {}) => runClickhouseQuery(ch, buildResourcePercentiles(projectId, opts, d)),
+        stabilityCounts: (projectId, opts = {}) => runClickhouseQuery(ch, buildStabilityCounts(projectId, opts, d)),
+        sceneCoverage: (projectId, opts = {}) => runClickhouseQuery(ch, buildSceneCoverage(projectId, opts, d)),
+        cameraDistance: (projectId, opts = {}) => runClickhouseQuery(ch, buildCameraDistance(projectId, opts, d)),
+        navigationStats: (projectId, opts = {}) => runClickhouseQuery(ch, buildNavigationStats(projectId, opts, d)),
+        xrRotationRate: (projectId, opts = {}) => runClickhouseQuery(ch, buildXrRotationRate(projectId, opts, d)),
+        xrSourceUsage: (projectId, opts = {}) => runClickhouseQuery(ch, buildXrSourceUsage(projectId, opts, d)),
+        xrAbandonment: (projectId, opts = {}) => runClickhouseQuery(ch, buildXrAbandonment(projectId, opts, d)),
+        interactionsBySource: (projectId, opts = {}) => runClickhouseQuery(ch, buildInteractionsBySource(projectId, opts, d)),
+        scenes: (projectId, opts = {}) => runClickhouseQuery(ch, buildDistinctScenes(projectId, opts, d)),
+        timeseries: (projectId, opts = {}) => runClickhouseQuery(ch, buildTimeseries(projectId, opts, d)),
+        eventTypeCounts: (projectId, opts = {}) => runClickhouseQuery(ch, buildEventTypeCounts(projectId, opts, d)),
+        getSessionEvents: (projectId, sessionId) => chGetSessionEvents(ch, projectId, sessionId),
+        streamSessionEvents: (projectId, sessionId) => chStreamSessionEvents(ch, projectId, sessionId),
+        getSessionMeta: (projectId, sessionId) => chGetSessionMeta(ch, projectId, sessionId),
+        putSceneProxy: (projectId, proxy, label) => chUpsertSceneProxy(ch, projectId, proxy, label),
+        getSceneRepresentation: (projectId, sceneId) => chGetSceneRepresentation(ch, projectId, sceneId),
+        listSceneRepresentations: (projectId) => chListSceneRepresentations(ch, projectId),
+        async close() {
+            await ch.close();
+        },
+    };
+}
+//# sourceMappingURL=clickhouseStore.js.map

package/dist/clickhouseStore.js.map

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

package/dist/serve.d.ts

@@ -4,6 +4,9 @@ import type { CollectorStore } from "./store.js";
  * - `duckdb` (default) — the OSS single-file DuckDB store (events + metadata in
  *   one file, full analytics, zero external services; ADR 0020). Path from
  *   `DUCKDB_PATH`.
+ * - `clickhouse` — the optional single-tenant ClickHouse store for scale
+ *   (concurrent, high-volume ingestion; ADR 0020). Connection from the
+ *   `CLICKHOUSE_*` env vars. Requires a reachable ClickHouse server.
  * - `memory` — a dependency-free in-memory store for local dev / E2E tests
  *   (seed its project/key via `COLLECTOR_MEMORY_PROJECT_ID` /
  *   `COLLECTOR_MEMORY_API_KEY`).

package/dist/serve.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"serve.d.ts","sourceRoot":"","sources":["../src/serve.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAEjD;;;;;;;;GAQG;AACH,wBAAgB,WAAW,CAAC,GAAG,GAAE,MAAM,CAAC,UAAwB,GAAG,OAAO,CAAC,cAAc,CAAC,CAazF;AAED;;;;GAIG;AACH,wBAAsB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAqB3C"}
+{"version":3,"file":"serve.d.ts","sourceRoot":"","sources":["../src/serve.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAEjD;;;;;;;;;;;GAWG;AACH,wBAAgB,WAAW,CAAC,GAAG,GAAE,MAAM,CAAC,UAAwB,GAAG,OAAO,CAAC,cAAc,CAAC,CAezF;AAED;;;;GAIG;AACH,wBAAsB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAqB3C"}

package/dist/serve.js

@@ -1,5 +1,6 @@
 import { buildApp } from "./app.js";
 import { loadConfig } from "./config.js";
+import { createClickhouseStore } from "./clickhouseStore.js";
 import { createDuckdbStore } from "./duckdbStore.js";
 import { createMemoryStore } from "./memoryStore.js";
 /**
@@ -7,6 +8,9 @@ import { createMemoryStore } from "./memoryStore.js";
  * - `duckdb` (default) — the OSS single-file DuckDB store (events + metadata in
  *   one file, full analytics, zero external services; ADR 0020). Path from
  *   `DUCKDB_PATH`.
+ * - `clickhouse` — the optional single-tenant ClickHouse store for scale
+ *   (concurrent, high-volume ingestion; ADR 0020). Connection from the
+ *   `CLICKHOUSE_*` env vars. Requires a reachable ClickHouse server.
  * - `memory` — a dependency-free in-memory store for local dev / E2E tests
  *   (seed its project/key via `COLLECTOR_MEMORY_PROJECT_ID` /
  *   `COLLECTOR_MEMORY_API_KEY`).
@@ -18,6 +22,8 @@ export function createStore(env = process.env) {
                 projectId: env.COLLECTOR_MEMORY_PROJECT_ID ?? "demo",
                 apiKey: env.COLLECTOR_MEMORY_API_KEY ?? "utk_memory_dev",
             }));
+        case "clickhouse":
+            return createClickhouseStore();
         case "duckdb":
         default:
             return createDuckdbStore();

package/dist/serve.js.map

@@ -1 +1 @@
-{"version":3,"file":"serve.js","sourceRoot":"","sources":["../src/serve.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAC;AACpC,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAGrD;;;;;;;;GAQG;AACH,MAAM,UAAU,WAAW,CAAC,MAAyB,OAAO,CAAC,GAAG;IAC9D,QAAQ,GAAG,CAAC,eAAe,EAAE,CAAC;QAC5B,KAAK,QAAQ;YACX,OAAO,OAAO,CAAC,OAAO,CACpB,iBAAiB,CAAC;gBAChB,SAAS,EAAE,GAAG,CAAC,2BAA2B,IAAI,MAAM;gBACpD,MAAM,EAAE,GAAG,CAAC,wBAAwB,IAAI,gBAAgB;aACzD,CAAC,CACH,CAAC;QACJ,KAAK,QAAQ,CAAC;QACd;YACE,OAAO,iBAAiB,EAAE,CAAC;IAC/B,CAAC;AACH,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,KAAK;IACzB,MAAM,MAAM,GAAG,UAAU,EAAE,CAAC;IAC5B,MAAM,KAAK,GAAG,MAAM,WAAW,EAAE,CAAC;IAClC,MAAM,GAAG,GAAG,MAAM,QAAQ,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;IAE5D,IAAI,CAAC,MAAM,CAAC,0BAA0B,EAAE,CAAC;QACvC,GAAG,CAAC,GAAG,CAAC,IAAI,CACV,yFAAyF;YACvF,qFAAqF,CACxF,CAAC;IACJ,CAAC;IAED,MAAM,KAAK,GAAG,KAAK,IAAI,EAAE;QACvB,MAAM,GAAG,CAAC,KAAK,EAAE,CAAC;QAClB,MAAM,KAAK,CAAC,KAAK,EAAE,CAAC;QACpB,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC,CAAC;IACF,OAAO,CAAC,EAAE,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;IAC5B,OAAO,CAAC,EAAE,CAAC,SAAS,EAAE,KAAK,CAAC,CAAC;IAE7B,MAAM,GAAG,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC;AAC7D,CAAC"}
+{"version":3,"file":"serve.js","sourceRoot":"","sources":["../src/serve.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAC;AACpC,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAC7D,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAGrD;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,WAAW,CAAC,MAAyB,OAAO,CAAC,GAAG;IAC9D,QAAQ,GAAG,CAAC,eAAe,EAAE,CAAC;QAC5B,KAAK,QAAQ;YACX,OAAO,OAAO,CAAC,OAAO,CACpB,iBAAiB,CAAC;gBAChB,SAAS,EAAE,GAAG,CAAC,2BAA2B,IAAI,MAAM;gBACpD,MAAM,EAAE,GAAG,CAAC,wBAAwB,IAAI,gBAAgB;aACzD,CAAC,CACH,CAAC;QACJ,KAAK,YAAY;YACf,OAAO,qBAAqB,EAAE,CAAC;QACjC,KAAK,QAAQ,CAAC;QACd;YACE,OAAO,iBAAiB,EAAE,CAAC;IAC/B,CAAC;AACH,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,KAAK;IACzB,MAAM,MAAM,GAAG,UAAU,EAAE,CAAC;IAC5B,MAAM,KAAK,GAAG,MAAM,WAAW,EAAE,CAAC;IAClC,MAAM,GAAG,GAAG,MAAM,QAAQ,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;IAE5D,IAAI,CAAC,MAAM,CAAC,0BAA0B,EAAE,CAAC;QACvC,GAAG,CAAC,GAAG,CAAC,IAAI,CACV,yFAAyF;YACvF,qFAAqF,CACxF,CAAC;IACJ,CAAC;IAED,MAAM,KAAK,GAAG,KAAK,IAAI,EAAE;QACvB,MAAM,GAAG,CAAC,KAAK,EAAE,CAAC;QAClB,MAAM,KAAK,CAAC,KAAK,EAAE,CAAC;QACpB,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC,CAAC;IACF,OAAO,CAAC,EAAE,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;IAC5B,OAAO,CAAC,EAAE,CAAC,SAAS,EAAE,KAAK,CAAC,CAAC;IAE7B,MAAM,GAAG,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC;AAC7D,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@uptimizr/collector-server",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "description": "Uptimizr ingestion + query API (Fastify). Self-hostable collector for the OSS data-collector.",
   "keywords": [
     "uptimizr",
@@ -44,8 +44,9 @@
     "fastify": "^5.8.5",
     "fastify-type-provider-zod": "^6.1.0",
     "zod": "^4.1.5",
-    "@uptimizr/db": "0.1.0",
-    "@uptimizr/schema": "0.1.0"
+    "@uptimizr/db-clickhouse": "0.2.0",
+    "@uptimizr/schema": "0.1.0",
+    "@uptimizr/db": "0.2.0"
   },
   "devDependencies": {
     "@types/node": "^22.19.21",