@uptimizr/collector-server 0.1.0

package/dist/liveBus.js

@@ -0,0 +1,195 @@
+import { DEFAULT_SCENE_ID } from "@uptimizr/schema";
+const SUBKEY = "\u0000";
+const key = (projectId, sessionId) => `${projectId}${SUBKEY}${sessionId}`;
+class Subscriber {
+    queueLimit;
+    onClose;
+    queue = [];
+    waiting = null;
+    closed = false;
+    dropped = 0;
+    constructor(queueLimit, onClose) {
+        this.queueLimit = queueLimit;
+        this.onClose = onClose;
+    }
+    /** Internal: enqueue an event, dropping the oldest when full (ADR §6). */
+    push(event) {
+        if (this.closed)
+            return;
+        if (this.waiting) {
+            const resolve = this.waiting;
+            this.waiting = null;
+            resolve({ value: event, done: false });
+            return;
+        }
+        this.queue.push(event);
+        if (this.queue.length > this.queueLimit) {
+            this.queue.shift();
+            this.dropped += 1;
+        }
+    }
+    close() {
+        if (this.closed)
+            return;
+        this.closed = true;
+        if (this.waiting) {
+            const resolve = this.waiting;
+            this.waiting = null;
+            resolve({ value: undefined, done: true });
+        }
+        this.onClose(this);
+    }
+    [Symbol.asyncIterator]() {
+        return {
+            next: () => {
+                const next = this.queue.shift();
+                if (next !== undefined)
+                    return Promise.resolve({ value: next, done: false });
+                if (this.closed)
+                    return Promise.resolve({ value: undefined, done: true });
+                return new Promise((resolve) => {
+                    this.waiting = resolve;
+                });
+            },
+            return: () => {
+                this.close();
+                return Promise.resolve({ value: undefined, done: true });
+            },
+        };
+    }
+}
+/** Create the default in-process live bus (ADR 0032 §2). */
+export function createLiveBus(options = {}) {
+    const windowMs = options.windowMs ?? 30_000;
+    const backfillRingSize = options.backfillRingSize ?? 200;
+    const defaultQueueLimit = options.subscriberQueueLimit ?? 1_000;
+    const now = options.now ?? Date.now;
+    /** presenceKey -> entry */
+    const presence = new Map();
+    /** presenceKey -> bounded ring of recent events */
+    const rings = new Map();
+    const subscribers = new Set();
+    function isLive(entry, at) {
+        return at - entry.lastSeen <= windowMs;
+    }
+    function prune(at) {
+        for (const [k, entry] of presence) {
+            if (!isLive(entry, at)) {
+                presence.delete(k);
+                rings.delete(k);
+            }
+        }
+    }
+    function activityOf(lastSeen, at) {
+        const age = at - lastSeen;
+        if (age <= 3_000)
+            return "active";
+        if (age <= 15_000)
+            return "recent";
+        return "idle";
+    }
+    function track(event, at) {
+        const sessionId = event.sessionId;
+        const k = key(event.projectId, sessionId);
+        if (event.type === "session_end") {
+            presence.delete(k);
+            rings.delete(k);
+            return;
+        }
+        const existing = presence.get(k);
+        if (existing) {
+            existing.lastSeen = at;
+            if (event.sceneId)
+                existing.sceneId = event.sceneId;
+            if (event.visitorId)
+                existing.visitorId = event.visitorId;
+        }
+        else {
+            presence.set(k, {
+                projectId: event.projectId,
+                sessionId,
+                visitorId: event.visitorId ?? sessionId,
+                sceneId: event.sceneId ?? DEFAULT_SCENE_ID,
+                startedAt: at,
+                lastSeen: at,
+            });
+        }
+        const ring = rings.get(k);
+        if (ring) {
+            ring.push(event);
+            if (ring.length > backfillRingSize)
+                ring.shift();
+        }
+        else {
+            rings.set(k, [event]);
+        }
+    }
+    function matches(sub, event) {
+        if (event.projectId !== sub.projectId)
+            return false;
+        if (sub.sessionId && event.sessionId !== sub.sessionId)
+            return false;
+        if (sub.types && !sub.types.has(event.type))
+            return false;
+        return true;
+    }
+    const optionsBySub = new WeakMap();
+    return {
+        publish(events) {
+            if (events.length === 0)
+                return;
+            const at = now();
+            for (const event of events) {
+                track(event, at);
+                for (const sub of subscribers) {
+                    const opts = optionsBySub.get(sub);
+                    if (opts && matches(opts, event))
+                        sub.push(event);
+                }
+            }
+        },
+        presence(projectId) {
+            const at = now();
+            prune(at);
+            const visitors = new Set();
+            const sessions = [];
+            for (const entry of presence.values()) {
+                if (entry.projectId !== projectId)
+                    continue;
+                visitors.add(entry.visitorId);
+                sessions.push({
+                    sessionId: entry.sessionId,
+                    sceneId: entry.sceneId,
+                    startedAt: entry.startedAt,
+                    lastSeen: entry.lastSeen,
+                    activity: activityOf(entry.lastSeen, at),
+                });
+            }
+            sessions.sort((a, b) => b.lastSeen - a.lastSeen);
+            return { activeSessions: sessions.length, activeVisitors: visitors.size, sessions };
+        },
+        recentForSession(projectId, sessionId) {
+            const ring = rings.get(key(projectId, sessionId));
+            return ring ? [...ring] : [];
+        },
+        subscribe(subOptions) {
+            const sub = new Subscriber(subOptions.queueLimit ?? defaultQueueLimit, (s) => {
+                subscribers.delete(s);
+                optionsBySub.delete(s);
+            });
+            optionsBySub.set(sub, subOptions);
+            subscribers.add(sub);
+            return sub;
+        },
+        get subscriberCount() {
+            return subscribers.size;
+        },
+        stop() {
+            for (const sub of [...subscribers])
+                sub.close();
+            presence.clear();
+            rings.clear();
+        },
+    };
+}
+//# sourceMappingURL=liveBus.js.map

package/dist/liveBus.js.map

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

package/dist/liveToken.d.ts

@@ -0,0 +1,11 @@
+/** Mint a token authorizing `projectId` until `now + ttlMs`. */
+export declare function mintLiveToken(projectId: string, secret: string, ttlMs: number, now?: number): {
+    token: string;
+    expiresAt: number;
+};
+/**
+ * Verify a token and return its project id, or `null` if malformed, tampered,
+ * or expired. Uses a constant-time signature comparison.
+ */
+export declare function verifyLiveToken(token: string, secret: string, now?: number): string | null;
+//# sourceMappingURL=liveToken.d.ts.map

package/dist/liveToken.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"liveToken.d.ts","sourceRoot":"","sources":["../src/liveToken.ts"],"names":[],"mappings":"AA6BA,gEAAgE;AAChE,wBAAgB,aAAa,CAC3B,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,MAAM,EACb,GAAG,GAAE,MAAmB,GACvB;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,CAMtC;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAC7B,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,EACd,GAAG,GAAE,MAAmB,GACvB,MAAM,GAAG,IAAI,CAoBf"}

package/dist/liveToken.js

@@ -0,0 +1,44 @@
+import { createHmac, timingSafeEqual } from "node:crypto";
+function b64url(input) {
+    return Buffer.from(input).toString("base64url");
+}
+function sign(payloadB64, secret) {
+    return createHmac("sha256", secret).update(payloadB64).digest("base64url");
+}
+/** Mint a token authorizing `projectId` until `now + ttlMs`. */
+export function mintLiveToken(projectId, secret, ttlMs, now = Date.now()) {
+    const expiresAt = now + ttlMs;
+    const payload = { p: projectId, e: expiresAt };
+    const payloadB64 = b64url(JSON.stringify(payload));
+    const token = `${payloadB64}.${sign(payloadB64, secret)}`;
+    return { token, expiresAt };
+}
+/**
+ * Verify a token and return its project id, or `null` if malformed, tampered,
+ * or expired. Uses a constant-time signature comparison.
+ */
+export function verifyLiveToken(token, secret, now = Date.now()) {
+    const dot = token.indexOf(".");
+    if (dot <= 0 || dot === token.length - 1)
+        return null;
+    const payloadB64 = token.slice(0, dot);
+    const sig = token.slice(dot + 1);
+    const expected = sign(payloadB64, secret);
+    const sigBuf = Buffer.from(sig);
+    const expBuf = Buffer.from(expected);
+    if (sigBuf.length !== expBuf.length || !timingSafeEqual(sigBuf, expBuf))
+        return null;
+    let payload;
+    try {
+        payload = JSON.parse(Buffer.from(payloadB64, "base64url").toString("utf8"));
+    }
+    catch {
+        return null;
+    }
+    if (typeof payload.p !== "string" || typeof payload.e !== "number")
+        return null;
+    if (now >= payload.e)
+        return null;
+    return payload.p;
+}
+//# sourceMappingURL=liveToken.js.map

package/dist/liveToken.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"liveToken.js","sourceRoot":"","sources":["../src/liveToken.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAqB1D,SAAS,MAAM,CAAC,KAAsB;IACpC,OAAO,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAC;AAClD,CAAC;AAED,SAAS,IAAI,CAAC,UAAkB,EAAE,MAAc;IAC9C,OAAO,UAAU,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC;AAC7E,CAAC;AAED,gEAAgE;AAChE,MAAM,UAAU,aAAa,CAC3B,SAAiB,EACjB,MAAc,EACd,KAAa,EACb,MAAc,IAAI,CAAC,GAAG,EAAE;IAExB,MAAM,SAAS,GAAG,GAAG,GAAG,KAAK,CAAC;IAC9B,MAAM,OAAO,GAAiB,EAAE,CAAC,EAAE,SAAS,EAAE,CAAC,EAAE,SAAS,EAAE,CAAC;IAC7D,MAAM,UAAU,GAAG,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,CAAC;IACnD,MAAM,KAAK,GAAG,GAAG,UAAU,IAAI,IAAI,CAAC,UAAU,EAAE,MAAM,CAAC,EAAE,CAAC;IAC1D,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC;AAC9B,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,eAAe,CAC7B,KAAa,EACb,MAAc,EACd,MAAc,IAAI,CAAC,GAAG,EAAE;IAExB,MAAM,GAAG,GAAG,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IAC/B,IAAI,GAAG,IAAI,CAAC,IAAI,GAAG,KAAK,KAAK,CAAC,MAAM,GAAG,CAAC;QAAE,OAAO,IAAI,CAAC;IACtD,MAAM,UAAU,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;IACvC,MAAM,GAAG,GAAG,KAAK,CAAC,KAAK,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC;IAEjC,MAAM,QAAQ,GAAG,IAAI,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC;IAC1C,MAAM,MAAM,GAAG,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAChC,MAAM,MAAM,GAAG,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IACrC,IAAI,MAAM,CAAC,MAAM,KAAK,MAAM,CAAC,MAAM,IAAI,CAAC,eAAe,CAAC,MAAM,EAAE,MAAM,CAAC;QAAE,OAAO,IAAI,CAAC;IAErF,IAAI,OAAqB,CAAC;IAC1B,IAAI,CAAC;QACH,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,UAAU,EAAE,WAAW,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAiB,CAAC;IAC9F,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;IACD,IAAI,OAAO,OAAO,CAAC,CAAC,KAAK,QAAQ,IAAI,OAAO,OAAO,CAAC,CAAC,KAAK,QAAQ;QAAE,OAAO,IAAI,CAAC;IAChF,IAAI,GAAG,IAAI,OAAO,CAAC,CAAC;QAAE,OAAO,IAAI,CAAC;IAClC,OAAO,OAAO,CAAC,CAAC,CAAC;AACnB,CAAC"}

package/dist/memoryStore.d.ts

@@ -0,0 +1,22 @@
+import type { ApiKeyCapability } from "@uptimizr/db";
+import type { CollectorStore } from "./store.js";
+export interface MemoryStoreOptions {
+    /** The single project id this store serves. */
+    projectId: string;
+    /** The plaintext API key that resolves to {@link projectId}. */
+    apiKey: string;
+    /** Capability the {@link apiKey} resolves with. Defaults to `query` (reads). */
+    capability?: ApiKeyCapability;
+}
+/**
+ * In-memory {@link CollectorStore} for local development and end-to-end tests —
+ * it boots the collector without ClickHouse or Postgres. Events are kept in a
+ * plain array; the replay-relevant reads (session list, ordered timeline, coarse
+ * meta) and the lightweight aggregates (scenes, time-series, event-type counts)
+ * are served from it so the playground's filters and timeline work. The
+ * heavier spatial aggregates (heatmaps, perf, top meshes) are intentionally not
+ * implemented here and return empty results; use the ClickHouse-backed store for
+ * those. Never use this in production.
+ */
+export declare function createMemoryStore({ projectId, apiKey, capability, }: MemoryStoreOptions): CollectorStore;
+//# sourceMappingURL=memoryStore.d.ts.map

package/dist/memoryStore.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memoryStore.d.ts","sourceRoot":"","sources":["../src/memoryStore.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,gBAAgB,EAAoC,MAAM,cAAc,CAAC;AACvF,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAgBjD,MAAM,WAAW,kBAAkB;IACjC,+CAA+C;IAC/C,SAAS,EAAE,MAAM,CAAC;IAClB,gEAAgE;IAChE,MAAM,EAAE,MAAM,CAAC;IACf,gFAAgF;IAChF,UAAU,CAAC,EAAE,gBAAgB,CAAC;CAC/B;AAED;;;;;;;;;GASG;AACH,wBAAgB,iBAAiB,CAAC,EAChC,SAAS,EACT,MAAM,EACN,UAAoB,GACrB,EAAE,kBAAkB,GAAG,cAAc,CAgMrC"}

package/dist/memoryStore.js

@@ -0,0 +1,207 @@
+function isSessionStart(event) {
+    return event.type === "session_start";
+}
+/**
+ * In-memory {@link CollectorStore} for local development and end-to-end tests —
+ * it boots the collector without ClickHouse or Postgres. Events are kept in a
+ * plain array; the replay-relevant reads (session list, ordered timeline, coarse
+ * meta) and the lightweight aggregates (scenes, time-series, event-type counts)
+ * are served from it so the playground's filters and timeline work. The
+ * heavier spatial aggregates (heatmaps, perf, top meshes) are intentionally not
+ * implemented here and return empty results; use the ClickHouse-backed store for
+ * those. Never use this in production.
+ */
+export function createMemoryStore({ projectId, apiKey, capability = "query", }) {
+    const events = [];
+    const representations = new Map();
+    const forSession = (sid) => events
+        .filter((e) => e.projectId === projectId && e.sessionId === sid)
+        .sort((a, b) => a.ts - b.ts);
+    const forProject = () => events.filter((e) => e.projectId === projectId);
+    const sceneOf = (e) => {
+        const s = e.sceneId;
+        return typeof s === "string" && s.length > 0 ? s : "default";
+    };
+    const inRange = (e, opts) => (opts.since == null || e.ts >= opts.since) && (opts.until == null || e.ts < opts.until);
+    return {
+        resolveApiKey: async (key) => (key === apiKey ? { projectId, capability } : null),
+        projectExists: async (id) => id === projectId,
+        insertEvents: async (incoming) => {
+            events.push(...incoming);
+        },
+        listSessions: async () => {
+            const bySession = new Map();
+            for (const e of events) {
+                if (e.projectId !== projectId)
+                    continue;
+                const list = bySession.get(e.sessionId) ?? [];
+                list.push(e);
+                bySession.set(e.sessionId, list);
+            }
+            return [...bySession.entries()].map(([sessionId, list]) => {
+                const sorted = [...list].sort((a, b) => a.ts - b.ts);
+                const first = sorted[0];
+                const last = sorted[sorted.length - 1];
+                const visitor = sorted.find((e) => typeof e.visitorId === "string");
+                return {
+                    session_id: sessionId,
+                    visitor_id: visitor?.visitorId ?? "",
+                    events: sorted.length,
+                    started_at: new Date(first.ts).toISOString(),
+                    ended_at: new Date(last.ts).toISOString(),
+                };
+            });
+        },
+        pointerHeatmap: async () => [],
+        worldHeatmap: async () => [],
+        gazeHeatmap: async () => [],
+        cameraHeatmap: async () => [],
+        cameraPositionHeatmap: async () => [],
+        sessionTrajectory: async () => [],
+        clickGazeRays: async () => [],
+        flowHeatmap: async () => [],
+        topMeshes: async () => [],
+        meshDwell: async () => [],
+        deadClicks: async () => [],
+        rageClicks: async () => [],
+        hoverDwell: async () => [],
+        compileStalls: async () => [],
+        resourceSummary: async () => [],
+        capabilityChanges: async () => [],
+        cameraGestures: async () => [],
+        perfSummary: async () => [],
+        perfDistribution: async () => [],
+        fpsHistogram: async () => [],
+        frameTimePercentiles: async () => [],
+        jankRate: async () => [],
+        perfByDevice: async () => [],
+        perfByScene: async () => [],
+        resourcePercentiles: async () => [],
+        stabilityCounts: async () => [],
+        sceneCoverage: async () => [],
+        cameraDistance: async () => [],
+        navigationStats: async () => [],
+        xrRotationRate: async () => [],
+        xrSourceUsage: async () => [],
+        xrAbandonment: async () => [],
+        interactionsBySource: async () => [],
+        scenes: async (_projectId, opts = {}) => {
+            const map = new Map();
+            for (const e of forProject()) {
+                if (!inRange(e, opts))
+                    continue;
+                const sid = sceneOf(e);
+                const cur = map.get(sid) ?? { events: 0, last: 0 };
+                cur.events += 1;
+                cur.last = Math.max(cur.last, e.ts);
+                map.set(sid, cur);
+            }
+            return [...map.entries()]
+                .map(([scene_id, v]) => ({
+                scene_id,
+                events: v.events,
+                last_seen: new Date(v.last).toISOString(),
+            }))
+                .sort((a, b) => b.events - a.events)
+                .slice(0, opts.limit ?? 200);
+        },
+        timeseries: async (_projectId, opts = {}) => {
+            const interval = (opts.interval ?? 3600) * 1000;
+            const buckets = new Map();
+            for (const e of forProject()) {
+                if (!inRange(e, opts))
+                    continue;
+                if (opts.scene != null && opts.scene.length > 0 && sceneOf(e) !== opts.scene)
+                    continue;
+                if (opts.type != null && opts.type.length > 0 && e.type !== opts.type)
+                    continue;
+                const bucket = Math.floor(e.ts / interval) * interval;
+                const cur = buckets.get(bucket) ?? { events: 0, fpsSum: 0, fpsCount: 0 };
+                cur.events += 1;
+                if (e.type === "frame_perf") {
+                    const fps = e.fps;
+                    if (typeof fps === "number") {
+                        cur.fpsSum += fps;
+                        cur.fpsCount += 1;
+                    }
+                }
+                buckets.set(bucket, cur);
+            }
+            return [...buckets.entries()]
+                .map(([bucket, v]) => ({
+                bucket,
+                events: v.events,
+                avg_fps: v.fpsCount > 0 ? v.fpsSum / v.fpsCount : 0,
+            }))
+                .sort((a, b) => a.bucket - b.bucket);
+        },
+        eventTypeCounts: async (_projectId, opts = {}) => {
+            const map = new Map();
+            for (const e of forProject()) {
+                if (!inRange(e, opts))
+                    continue;
+                if (opts.scene != null && opts.scene.length > 0 && sceneOf(e) !== opts.scene)
+                    continue;
+                map.set(e.type, (map.get(e.type) ?? 0) + 1);
+            }
+            return [...map.entries()]
+                .map(([event_type, count]) => ({ event_type, count }))
+                .sort((a, b) => b.count - a.count);
+        },
+        getSessionEvents: async (_projectId, sessionId) => forSession(sessionId),
+        streamSessionEvents: async function* (_projectId, sessionId) {
+            for (const e of forSession(sessionId))
+                yield e;
+        },
+        getSessionMeta: async (_projectId, sessionId) => {
+            const start = forSession(sessionId).find(isSessionStart);
+            if (!start)
+                return null;
+            return {
+                sessionId,
+                startedAt: new Date(start.ts).toISOString(),
+                device: start.device,
+                scene: start.scene,
+                user: start.user,
+            };
+        },
+        putSceneProxy: async (_projectId, proxy, label) => {
+            const existing = representations.get(proxy.sceneId);
+            const now = new Date();
+            const representation = {
+                projectId,
+                sceneId: proxy.sceneId,
+                label: label ?? existing?.label ?? null,
+                kind: "proxy",
+                upAxis: proxy.upAxis,
+                unitScale: proxy.unitScale,
+                bounds: proxy.bounds,
+                proxy,
+                assetUrl: null,
+                contentHash: proxy.contentHash,
+                proxyVersion: proxy.version,
+                capturedAt: new Date(proxy.capturedAt),
+                updatedAt: now,
+            };
+            representations.set(proxy.sceneId, representation);
+            return representation;
+        },
+        getSceneRepresentation: async (_projectId, sceneId) => representations.get(sceneId) ?? null,
+        listSceneRepresentations: async () => [...representations.values()]
+            .sort((a, b) => b.updatedAt.getTime() - a.updatedAt.getTime())
+            .map((r) => ({
+            sceneId: r.sceneId,
+            label: r.label,
+            kind: r.kind,
+            bounds: r.bounds,
+            contentHash: r.contentHash,
+            capturedAt: r.capturedAt,
+            updatedAt: r.updatedAt,
+        })),
+        close: async () => {
+            events.length = 0;
+            representations.clear();
+        },
+    };
+}
+//# sourceMappingURL=memoryStore.js.map

package/dist/memoryStore.js.map

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

package/dist/routes/collect.d.ts

@@ -0,0 +1,25 @@
+import type { FastifyPluginAsync } from "fastify";
+import type { CollectorConfig } from "../config.js";
+import type { CollectorStore } from "../store.js";
+import type { LiveBus } from "../liveBus.js";
+interface Options {
+    store: CollectorStore;
+    config: CollectorConfig;
+    liveBus: LiveBus;
+}
+/**
+ * Ingestion route. Validates the batch against the schema, authorizes it against
+ * the (public) project id, enriches each event with the cookieless visitor id
+ * (raw IP never stored), publishes to the live bus (ADR 0032 §2), and inserts.
+ * Kept thin — all storage logic lives in the store.
+ *
+ * Browser beacons (`navigator.sendBeacon`) cannot carry a secret header, so the
+ * `projectId` in the envelope is the public ingest credential (like a GA
+ * measurement id). The route therefore (a) requires every event in a batch to
+ * share one `projectId` and (b) rejects batches for a project that does not
+ * exist, so events can never be written under an arbitrary/spoofed project. CORS
+ * origin allow-listing and a dedicated per-client rate limit bound the rest.
+ */
+export declare const collectRoutes: FastifyPluginAsync<Options>;
+export {};
+//# sourceMappingURL=collect.d.ts.map

package/dist/routes/collect.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"collect.d.ts","sourceRoot":"","sources":["../../src/routes/collect.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAgB,MAAM,SAAS,CAAC;AAGhE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AACpD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAClD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAI7C,UAAU,OAAO;IACf,KAAK,EAAE,cAAc,CAAC;IACtB,MAAM,EAAE,eAAe,CAAC;IACxB,OAAO,EAAE,OAAO,CAAC;CAClB;AAOD;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,aAAa,EAAE,kBAAkB,CAAC,OAAO,CA8CrD,CAAC"}

package/dist/routes/collect.js

@@ -0,0 +1,55 @@
+import { collectRequestSchema, collectResponseSchema } from "@uptimizr/schema";
+import { enrichEvents } from "../enrich.js";
+import { dailySalt, visitorHash } from "../visitor.js";
+/** Reject an ingest batch with a status + error message (plain reply, unconstrained by the 200 schema). */
+function rejectIngest(reply, code, error) {
+    return reply.code(code).send({ error });
+}
+/**
+ * Ingestion route. Validates the batch against the schema, authorizes it against
+ * the (public) project id, enriches each event with the cookieless visitor id
+ * (raw IP never stored), publishes to the live bus (ADR 0032 §2), and inserts.
+ * Kept thin — all storage logic lives in the store.
+ *
+ * Browser beacons (`navigator.sendBeacon`) cannot carry a secret header, so the
+ * `projectId` in the envelope is the public ingest credential (like a GA
+ * measurement id). The route therefore (a) requires every event in a batch to
+ * share one `projectId` and (b) rejects batches for a project that does not
+ * exist, so events can never be written under an arbitrary/spoofed project. CORS
+ * origin allow-listing and a dedicated per-client rate limit bound the rest.
+ */
+export const collectRoutes = async (app, { store, config, liveBus }) => {
+    const r = app.withTypeProvider();
+    r.post("/api/v1/collect", {
+        config: {
+            rateLimit: {
+                max: config.ingestRateLimitMax,
+                timeWindow: config.ingestRateLimitWindowMs,
+            },
+        },
+        schema: {
+            body: collectRequestSchema,
+            response: { 200: collectResponseSchema },
+        },
+    }, async (request, reply) => {
+        const { events } = request.body;
+        const projectId = events[0].projectId;
+        // A batch belongs to exactly one project; mixed ids are rejected outright.
+        if (events.some((event) => event.projectId !== projectId)) {
+            return rejectIngest(reply, 400, "all events in a batch must share one projectId");
+        }
+        // Reject events for an unknown project so data is never stored under a
+        // spoofed/non-existent id.
+        if (!(await store.projectExists(projectId))) {
+            return rejectIngest(reply, 401, "unknown project");
+        }
+        const ip = request.ip ?? "";
+        const ua = request.headers["user-agent"] ?? "";
+        const visitorId = visitorHash(ip, ua, dailySalt(config.visitorHashSecret));
+        const enriched = enrichEvents(events, visitorId);
+        liveBus.publish(enriched);
+        await store.insertEvents(enriched);
+        return { accepted: enriched.length, rejected: 0 };
+    });
+};
+//# sourceMappingURL=collect.js.map

package/dist/routes/collect.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"collect.js","sourceRoot":"","sources":["../../src/routes/collect.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,oBAAoB,EAAE,qBAAqB,EAAE,MAAM,kBAAkB,CAAC;AAI/E,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAC5C,OAAO,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAQvD,2GAA2G;AAC3G,SAAS,YAAY,CAAC,KAAmB,EAAE,IAAY,EAAE,KAAa;IACpE,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC;AAC1C,CAAC;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,CAAC,MAAM,aAAa,GAAgC,KAAK,EAC7D,GAAG,EACH,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,EAC1B,EAAE;IACF,MAAM,CAAC,GAAG,GAAG,CAAC,gBAAgB,EAAmB,CAAC;IAElD,CAAC,CAAC,IAAI,CACJ,iBAAiB,EACjB;QACE,MAAM,EAAE;YACN,SAAS,EAAE;gBACT,GAAG,EAAE,MAAM,CAAC,kBAAkB;gBAC9B,UAAU,EAAE,MAAM,CAAC,uBAAuB;aAC3C;SACF;QACD,MAAM,EAAE;YACN,IAAI,EAAE,oBAAoB;YAC1B,QAAQ,EAAE,EAAE,GAAG,EAAE,qBAAqB,EAAE;SACzC;KACF,EACD,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,EAAE;QACvB,MAAM,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;QAChC,MAAM,SAAS,GAAG,MAAM,CAAC,CAAC,CAAE,CAAC,SAAS,CAAC;QAEvC,2EAA2E;QAC3E,IAAI,MAAM,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,SAAS,KAAK,SAAS,CAAC,EAAE,CAAC;YAC1D,OAAO,YAAY,CAAC,KAAK,EAAE,GAAG,EAAE,gDAAgD,CAAC,CAAC;QACpF,CAAC;QAED,uEAAuE;QACvE,2BAA2B;QAC3B,IAAI,CAAC,CAAC,MAAM,KAAK,CAAC,aAAa,CAAC,SAAS,CAAC,CAAC,EAAE,CAAC;YAC5C,OAAO,YAAY,CAAC,KAAK,EAAE,GAAG,EAAE,iBAAiB,CAAC,CAAC;QACrD,CAAC;QAED,MAAM,EAAE,GAAG,OAAO,CAAC,EAAE,IAAI,EAAE,CAAC;QAC5B,MAAM,EAAE,GAAI,OAAO,CAAC,OAAO,CAAC,YAAY,CAAwB,IAAI,EAAE,CAAC;QACvE,MAAM,SAAS,GAAG,WAAW,CAAC,EAAE,EAAE,EAAE,EAAE,SAAS,CAAC,MAAM,CAAC,iBAAiB,CAAC,CAAC,CAAC;QAE3E,MAAM,QAAQ,GAAG,YAAY,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;QACjD,OAAO,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;QAC1B,MAAM,KAAK,CAAC,YAAY,CAAC,QAAQ,CAAC,CAAC;QAEnC,OAAO,EAAE,QAAQ,EAAE,QAAQ,CAAC,MAAM,EAAE,QAAQ,EAAE,CAAC,EAAE,CAAC;IACpD,CAAC,CACF,CAAC;AACJ,CAAC,CAAC"}

package/dist/routes/live.d.ts

@@ -0,0 +1,18 @@
+import type { FastifyPluginAsync } from "fastify";
+import type { CollectorConfig } from "../config.js";
+import type { CollectorStore } from "../store.js";
+import type { LiveBus } from "../liveBus.js";
+interface Options {
+    store: CollectorStore;
+    config: CollectorConfig;
+    liveBus: LiveBus;
+}
+/**
+ * Live SSE endpoints (ADR 0032 §3): presence (aggregate, always on), the
+ * project firehose (drives live dashboard updates), and the per-session
+ * live-follow tail (gated by raw-session retention, like replay). All fan out
+ * from the in-process bus and are bounded (ADR §6).
+ */
+export declare const liveRoutes: FastifyPluginAsync<Options>;
+export {};
+//# sourceMappingURL=live.d.ts.map

package/dist/routes/live.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"live.d.ts","sourceRoot":"","sources":["../../src/routes/live.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAgC,MAAM,SAAS,CAAC;AAGhF,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AACpD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAClD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAG7C,UAAU,OAAO;IACf,KAAK,EAAE,cAAc,CAAC;IACtB,MAAM,EAAE,eAAe,CAAC;IACxB,OAAO,EAAE,OAAO,CAAC;CAClB;AA2ED;;;;;GAKG;AACH,eAAO,MAAM,UAAU,EAAE,kBAAkB,CAAC,OAAO,CA2HlD,CAAC"}