@uptimizr/db 0.1.0

package/dist/duckdb/migrations.js

@@ -0,0 +1,323 @@
+/**
+ * Ordered, forward-only DuckDB migrations for the OSS single-file store
+ * (ADR 0020 / ADR 0007). Append new statements; never edit a shipped one. All
+ * statements are idempotent (`IF NOT EXISTS` / `CREATE OR REPLACE VIEW`), so
+ * {@link migrateDuckdb} is safe to run on every boot.
+ *
+ * This store is **single-tenant**: there is no `org_id` and no tenant isolation
+ * (those live only in the proprietary scale layer). Events and metadata share
+ * one file so a self-hosted collector needs no external services.
+ */
+export const DUCKDB_MIGRATIONS = [
+    // --- Events ---------------------------------------------------------------
+    // Hot, queryable fields are promoted to columns (mirroring the ClickHouse
+    // `events` table); the full validated event is preserved in `payload` (JSON)
+    // so reads stay replay-complete. Vectors are `DOUBLE[]`; `ts` is a naive-UTC
+    // TIMESTAMP (epoch handling matches the ClickHouse store).
+    {
+        id: "0001_events",
+        sql: /* sql */ `
+      CREATE TABLE IF NOT EXISTS events (
+        project_id    VARCHAR NOT NULL,
+        session_id    VARCHAR NOT NULL,
+        visitor_id    VARCHAR NOT NULL DEFAULT '',
+        event_type    VARCHAR NOT NULL,
+        ts            TIMESTAMP NOT NULL,
+        sdk_version   VARCHAR NOT NULL DEFAULT '',
+        url           VARCHAR NOT NULL DEFAULT '',
+        scene_id      VARCHAR NOT NULL DEFAULT 'default',
+        source        VARCHAR NOT NULL DEFAULT 'mouse',
+        handedness    VARCHAR NOT NULL DEFAULT '',
+        source_id     VARCHAR NOT NULL DEFAULT '',
+        ray_origin    DOUBLE[],
+        ray_direction DOUBLE[],
+        position      DOUBLE[],
+        direction     DOUBLE[],
+        hit_point     DOUBLE[],
+        screen        DOUBLE[],
+        mesh          VARCHAR NOT NULL DEFAULT '',
+        fps           DOUBLE NOT NULL DEFAULT 0,
+        name          VARCHAR NOT NULL DEFAULT '',
+        payload       VARCHAR NOT NULL,
+        inserted_at   TIMESTAMP NOT NULL DEFAULT now()
+      );
+    `,
+    },
+    {
+        id: "0002_events_idx",
+        sql: /* sql */ `
+      CREATE INDEX IF NOT EXISTS events_project_type_ts_idx
+        ON events (project_id, event_type, ts);
+    `,
+    },
+    // --- Metadata (re-homed from Postgres for the single-file store) -----------
+    // Single-tenant: `projects` has no `org_id`. API keys are stored as SHA-256
+    // hashes (never plaintext), consistent with the Postgres store.
+    {
+        id: "0003_projects",
+        sql: /* sql */ `
+      CREATE TABLE IF NOT EXISTS projects (
+        id          VARCHAR PRIMARY KEY,
+        name        VARCHAR NOT NULL,
+        created_at  TIMESTAMP NOT NULL DEFAULT now()
+      );
+    `,
+    },
+    {
+        id: "0004_api_keys",
+        sql: /* sql */ `
+      CREATE TABLE IF NOT EXISTS api_keys (
+        id          VARCHAR PRIMARY KEY,
+        project_id  VARCHAR NOT NULL,
+        key_hash    VARCHAR NOT NULL UNIQUE,
+        key_prefix  VARCHAR NOT NULL,
+        created_at  TIMESTAMP NOT NULL DEFAULT now(),
+        revoked_at  TIMESTAMP
+      );
+    `,
+    },
+    // One representation per (project, scene): a developer-supplied label plus an
+    // optional engine-agnostic proxy (ADR 0010/0014). `bounds`/`proxy` are stored
+    // as JSON text (parsed by the row mapper).
+    {
+        id: "0005_scene_representations",
+        sql: /* sql */ `
+      CREATE TABLE IF NOT EXISTS scene_representations (
+        project_id     VARCHAR NOT NULL,
+        scene_id       VARCHAR NOT NULL,
+        label          VARCHAR,
+        kind           VARCHAR NOT NULL DEFAULT 'none',
+        up_axis        VARCHAR NOT NULL DEFAULT 'y',
+        unit_scale     DOUBLE NOT NULL DEFAULT 1,
+        bounds         VARCHAR,
+        proxy          VARCHAR,
+        asset_url      VARCHAR,
+        content_hash   VARCHAR,
+        proxy_version  INTEGER,
+        captured_at    TIMESTAMP,
+        updated_at     TIMESTAMP NOT NULL DEFAULT now(),
+        PRIMARY KEY (project_id, scene_id)
+      );
+    `,
+    },
+    // --- Rollup views ---------------------------------------------------------
+    // DuckDB has no incremental materialized views, so the daily rollups read by
+    // `buildPerfDaily`/`buildEventsDaily` are plain views that pre-group by
+    // `(project_id, …, day)`. Column names match the ClickHouse rollup tables so
+    // the shared read queries work unchanged; each read GROUP BY then sees exactly
+    // one source row per group (its `-Merge` combinators pass the value through).
+    {
+        id: "0006_perf_daily_view",
+        sql: /* sql */ `
+      CREATE OR REPLACE VIEW perf_daily AS
+      SELECT
+        project_id,
+        CAST(ts AS DATE) AS day,
+        count(*) AS samples_state,
+        avg(fps) AS avg_fps_state,
+        min(fps) AS min_fps,
+        quantile_cont(fps, 0.5) AS p50_fps_state
+      FROM events
+      WHERE event_type = 'frame_perf'
+      GROUP BY project_id, day;
+    `,
+    },
+    {
+        id: "0007_events_daily_view",
+        sql: /* sql */ `
+      CREATE OR REPLACE VIEW events_daily AS
+      SELECT
+        project_id,
+        event_type,
+        CAST(ts AS DATE) AS day,
+        count(*) AS events
+      FROM events
+      GROUP BY project_id, event_type, day;
+    `,
+    },
+    // --- mesh_visibility dwell metrics (#37) ----------------------------------
+    // Promote the per-object attention fields to columns for the dwell
+    // aggregation (mirroring `fps` for `frame_perf`). The appender always writes a
+    // value (0 on non-visibility events); the full event stays in `payload`.
+    // Forward-only, additive, idempotent. No DEFAULT/NOT NULL: DuckDB's ALTER ADD
+    // COLUMN rejects NOT NULL and a stored DEFAULT trips a reopen crash, so the
+    // columns are plain nullable DOUBLE (SUM/MAX ignore the NULLs on old rows).
+    {
+        id: "0008_events_visible_ms",
+        sql: /* sql */ `
+      ALTER TABLE events ADD COLUMN IF NOT EXISTS visible_ms DOUBLE;
+    `,
+    },
+    {
+        id: "0009_events_centered_ms",
+        sql: /* sql */ `
+      ALTER TABLE events ADD COLUMN IF NOT EXISTS centered_ms DOUBLE;
+    `,
+    },
+    {
+        id: "0010_events_screen_fraction",
+        sql: /* sql */ `
+      ALTER TABLE events ADD COLUMN IF NOT EXISTS screen_fraction DOUBLE;
+    `,
+    },
+    // resource_sample (#44) GPU / memory footprint metrics. Same additive,
+    // nullable-DOUBLE pattern: old rows read NULL, which SUM/AVG/MAX ignore.
+    {
+        id: "0011_events_texture_bytes",
+        sql: /* sql */ `
+      ALTER TABLE events ADD COLUMN IF NOT EXISTS texture_bytes DOUBLE;
+    `,
+    },
+    {
+        id: "0012_events_geometry_bytes",
+        sql: /* sql */ `
+      ALTER TABLE events ADD COLUMN IF NOT EXISTS geometry_bytes DOUBLE;
+    `,
+    },
+    {
+        id: "0013_events_triangles",
+        sql: /* sql */ `
+      ALTER TABLE events ADD COLUMN IF NOT EXISTS triangles DOUBLE;
+    `,
+    },
+    {
+        id: "0014_events_vertices",
+        sql: /* sql */ `
+      ALTER TABLE events ADD COLUMN IF NOT EXISTS vertices DOUBLE;
+    `,
+    },
+    {
+        id: "0015_events_js_heap_bytes",
+        sql: /* sql */ `
+      ALTER TABLE events ADD COLUMN IF NOT EXISTS js_heap_bytes DOUBLE;
+    `,
+    },
+    // capability_change (#49) fallback/recovery transition. `kind` reuses the
+    // shared `name` column (same precedent as compile_stall's phase); the
+    // from/to capability tokens get their own additive, nullable VARCHAR columns.
+    // `reason` stays in the JSON payload only (free-form, not a group key).
+    {
+        id: "0016_events_cap_from",
+        sql: /* sql */ `
+      ALTER TABLE events ADD COLUMN IF NOT EXISTS cap_from VARCHAR;
+    `,
+    },
+    {
+        id: "0017_events_cap_to",
+        sql: /* sql */ `
+      ALTER TABLE events ADD COLUMN IF NOT EXISTS cap_to VARCHAR;
+    `,
+    },
+    // --- Scene-actor transforms (node_transform, ADR 0027) --------------------
+    // `node_transform` is the highest-cardinality signal (actors × rate, × bones
+    // for Tier 2), so it gets its own transform-shaped table instead of bloating
+    // the wide `events` table with quaternion/bone columns that are null for every
+    // other type. Rows are reconstructed back into replay-complete `node_transform`
+    // events on read and merged with the `events` stream by `ts` (ADR 0027 §8/§9).
+    // Ordered by (project, session, node_id, ts) to mirror the ClickHouse scale-tier
+    // sort key and give cheap per-actor reads. `bone_id` is '' for the Tier-1
+    // node/root tier; `scale` is empty when it never left identity.
+    {
+        id: "0018_node_samples",
+        sql: /* sql */ `
+      CREATE TABLE IF NOT EXISTS node_samples (
+        project_id   VARCHAR NOT NULL,
+        session_id   VARCHAR NOT NULL,
+        ts           TIMESTAMP NOT NULL,
+        sdk_version  VARCHAR NOT NULL DEFAULT '',
+        scene_id     VARCHAR NOT NULL DEFAULT 'default',
+        node_id      VARCHAR NOT NULL,
+        bone_id      VARCHAR NOT NULL DEFAULT '',
+        position     DOUBLE[],
+        rotation     DOUBLE[],
+        scale        DOUBLE[],
+        inserted_at  TIMESTAMP NOT NULL DEFAULT now()
+      );
+    `,
+    },
+    {
+        id: "0019_node_samples_idx",
+        sql: /* sql */ `
+      CREATE INDEX IF NOT EXISTS node_samples_session_node_ts_idx
+        ON node_samples (project_id, session_id, node_id, ts);
+    `,
+    },
+    // --- frame_perf percentile / jank / resolution detail (#80) ---------------
+    // Promote the percentile, jank, and resolution fields so the per-session perf
+    // aggregations (ADR 0028) read columns instead of JSON. Same additive,
+    // nullable-DOUBLE pattern as the resource columns: old rows read NULL (ignored
+    // by SUM/AVG/MAX); new non-frame_perf rows read 0 (filtered out by event_type).
+    {
+        id: "0020_events_frame_time_ms",
+        sql: /* sql */ `
+      ALTER TABLE events ADD COLUMN IF NOT EXISTS frame_time_ms DOUBLE;
+    `,
+    },
+    {
+        id: "0021_events_frame_time_p95_ms",
+        sql: /* sql */ `
+      ALTER TABLE events ADD COLUMN IF NOT EXISTS frame_time_p95_ms DOUBLE;
+    `,
+    },
+    {
+        id: "0022_events_long_frames",
+        sql: /* sql */ `
+      ALTER TABLE events ADD COLUMN IF NOT EXISTS long_frames DOUBLE;
+    `,
+    },
+    {
+        id: "0023_events_dpr",
+        sql: /* sql */ `
+      ALTER TABLE events ADD COLUMN IF NOT EXISTS dpr DOUBLE;
+    `,
+    },
+    {
+        id: "0024_events_render_scale",
+        sql: /* sql */ `
+      ALTER TABLE events ADD COLUMN IF NOT EXISTS render_scale DOUBLE;
+    `,
+    },
+    // --- node_transform Tier-1 subtree children (ADR 0033) --------------------
+    // `child_path` is the descendant's engine node path relative to `node_id`
+    // (e.g. 'Body/Arm_L/Hand'); '' for the declared root and for Tier-2 bone rows.
+    // Added after `inserted_at` (physically last), so the appender binds it last.
+    // DuckDB's `ALTER TABLE ADD COLUMN` rejects NOT NULL/DEFAULT constraints, so
+    // the column is plain nullable VARCHAR; the appender always writes '' (never
+    // null) for new rows and the reader treats any falsy value as "no childPath".
+    {
+        id: "0025_node_samples_child_path",
+        sql: /* sql */ `
+      ALTER TABLE node_samples ADD COLUMN IF NOT EXISTS child_path VARCHAR;
+    `,
+    },
+    {
+        id: "0026_node_samples_child_idx",
+        sql: /* sql */ `
+      CREATE INDEX IF NOT EXISTS node_samples_session_node_child_ts_idx
+        ON node_samples (project_id, session_id, node_id, child_path, ts);
+    `,
+    },
+    // API-key capability scope (`ingest` | `query`). Public ingestion is keyless,
+    // so issued keys are for reads — existing keys are grandfathered to `query`
+    // and the column default is `query`. Enforced at the read boundaries
+    // (query + live token exchange).
+    {
+        id: "0027_api_keys_capability",
+        sql: /* sql */ `
+      ALTER TABLE api_keys ADD COLUMN IF NOT EXISTS capability VARCHAR DEFAULT 'query';
+    `,
+    },
+];
+/**
+ * Apply all DuckDB migrations in order. Idempotent — safe to run on every boot.
+ */
+export async function migrateDuckdb(client) {
+    for (const migration of DUCKDB_MIGRATIONS) {
+        await client.run(migration.sql);
+    }
+    // Flush the WAL into the main file. `ALTER TABLE ... ADD COLUMN` entries crash
+    // DuckDB's WAL replay on the next open, so checkpointing here keeps a
+    // file-backed store reopenable after a schema change. No-op for `:memory:`.
+    await client.run("CHECKPOINT;");
+}
+//# sourceMappingURL=migrations.js.map

package/dist/duckdb/migrations.js.map

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

package/dist/duckdb/projects.d.ts

@@ -0,0 +1,23 @@
+import { apiKeyPrefix, generateApiKey, hashApiKey, type ApiKeyCapability, type ApiKeyRecord, type Project, type ResolvedApiKey } from "../metadata.js";
+import type { DuckdbClient } from "./client.js";
+export type { Project, ApiKeyRecord };
+export { hashApiKey, apiKeyPrefix, generateApiKey };
+/** Create a project and return it. */
+export declare function createProject(client: DuckdbClient, name: string): Promise<Project>;
+/** Fetch a project by id, or `null` if it does not exist. */
+export declare function getProject(client: DuckdbClient, id: string): Promise<Project | null>;
+/**
+ * Issue a new API key for a project. Returns both the record and the plaintext
+ * key — the plaintext is shown to the caller exactly once and never stored.
+ */
+export declare function createApiKey(client: DuckdbClient, projectId: string, capability?: ApiKeyCapability): Promise<{
+    key: string;
+    record: ApiKeyRecord;
+}>;
+/**
+ * Resolve a plaintext API key to its (non-revoked) project id and capability, or
+ * `null` when the key is unknown or revoked. The collector uses this to
+ * authenticate and scope read requests at the boundary.
+ */
+export declare function resolveApiKey(client: DuckdbClient, plaintext: string): Promise<ResolvedApiKey | null>;
+//# sourceMappingURL=projects.d.ts.map

package/dist/duckdb/projects.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"projects.d.ts","sourceRoot":"","sources":["../../src/duckdb/projects.ts"],"names":[],"mappings":"AACA,OAAO,EACL,YAAY,EACZ,cAAc,EACd,UAAU,EACV,KAAK,gBAAgB,EACrB,KAAK,YAAY,EACjB,KAAK,OAAO,EACZ,KAAK,cAAc,EACpB,MAAM,gBAAgB,CAAC;AACxB,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAEhD,YAAY,EAAE,OAAO,EAAE,YAAY,EAAE,CAAC;AACtC,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,cAAc,EAAE,CAAC;AAiBpD,sCAAsC;AACtC,wBAAsB,aAAa,CAAC,MAAM,EAAE,YAAY,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CASxF;AAED,6DAA6D;AAC7D,wBAAsB,UAAU,CAAC,MAAM,EAAE,YAAY,EAAE,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC,CAS1F;AAED;;;GAGG;AACH,wBAAsB,YAAY,CAChC,MAAM,EAAE,YAAY,EACpB,SAAS,EAAE,MAAM,EACjB,UAAU,GAAE,gBAA0B,GACrC,OAAO,CAAC;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,YAAY,CAAA;CAAE,CAAC,CAiChD;AAED;;;;GAIG;AACH,wBAAsB,aAAa,CACjC,MAAM,EAAE,YAAY,EACpB,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC,CAOhC"}

package/dist/duckdb/projects.js

@@ -0,0 +1,55 @@
+import { randomUUID } from "node:crypto";
+import { apiKeyPrefix, generateApiKey, hashApiKey, } from "../metadata.js";
+export { hashApiKey, apiKeyPrefix, generateApiKey };
+/** Create a project and return it. */
+export async function createProject(client, name) {
+    const id = randomUUID();
+    await client.run(`INSERT INTO projects (id, name) VALUES ($id, $name)`, { id, name });
+    const rows = await client.all(`SELECT id, name, epoch_ms(created_at) AS created_at_ms FROM projects WHERE id = $id`, { id });
+    const row = rows[0];
+    return { id: row.id, name: row.name, orgId: null, createdAt: new Date(row.created_at_ms) };
+}
+/** Fetch a project by id, or `null` if it does not exist. */
+export async function getProject(client, id) {
+    const rows = await client.all(`SELECT id, name, epoch_ms(created_at) AS created_at_ms FROM projects WHERE id = $id`, { id });
+    const row = rows[0];
+    return row
+        ? { id: row.id, name: row.name, orgId: null, createdAt: new Date(row.created_at_ms) }
+        : null;
+}
+/**
+ * Issue a new API key for a project. Returns both the record and the plaintext
+ * key — the plaintext is shown to the caller exactly once and never stored.
+ */
+export async function createApiKey(client, projectId, capability = "query") {
+    const key = generateApiKey();
+    const id = randomUUID();
+    await client.run(`INSERT INTO api_keys (id, project_id, key_hash, key_prefix, capability)
+     VALUES ($id, $projectId, $keyHash, $keyPrefix, $capability)`, { id, projectId, keyHash: hashApiKey(key), keyPrefix: apiKeyPrefix(key), capability });
+    const rows = await client.all(`SELECT id, project_id, key_prefix, epoch_ms(created_at) AS created_at_ms,
+            epoch_ms(revoked_at) AS revoked_at_ms, capability
+     FROM api_keys WHERE id = $id`, { id });
+    const row = rows[0];
+    return {
+        key,
+        record: {
+            id: row.id,
+            projectId: row.project_id,
+            keyPrefix: row.key_prefix,
+            createdAt: new Date(row.created_at_ms),
+            revokedAt: row.revoked_at_ms === null ? null : new Date(row.revoked_at_ms),
+            capability: row.capability,
+        },
+    };
+}
+/**
+ * Resolve a plaintext API key to its (non-revoked) project id and capability, or
+ * `null` when the key is unknown or revoked. The collector uses this to
+ * authenticate and scope read requests at the boundary.
+ */
+export async function resolveApiKey(client, plaintext) {
+    const rows = await client.all(`SELECT project_id, capability FROM api_keys WHERE key_hash = $keyHash AND revoked_at IS NULL`, { keyHash: hashApiKey(plaintext) });
+    const row = rows[0];
+    return row ? { projectId: row.project_id, capability: row.capability } : null;
+}
+//# sourceMappingURL=projects.js.map

package/dist/duckdb/projects.js.map

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

package/dist/duckdb/queries.d.ts

@@ -0,0 +1,10 @@
+import type { QuerySpec } from "../query/types.js";
+import type { DuckdbClient } from "./client.js";
+/**
+ * Execute a dialect-agnostic {@link QuerySpec} (rendered with `duckdbDialect`)
+ * against the DuckDB store and return typed rows. Values are already converted to
+ * plain JS by the client (bigint→number, list→array, timestamp→string), so rows
+ * match the shapes produced by the ClickHouse `runQuery`.
+ */
+export declare function runDuckdbQuery<T>(client: DuckdbClient, spec: QuerySpec): Promise<T[]>;
+//# sourceMappingURL=queries.d.ts.map

package/dist/duckdb/queries.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"queries.d.ts","sourceRoot":"","sources":["../../src/duckdb/queries.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AACnD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAEhD;;;;;GAKG;AACH,wBAAsB,cAAc,CAAC,CAAC,EAAE,MAAM,EAAE,YAAY,EAAE,IAAI,EAAE,SAAS,GAAG,OAAO,CAAC,CAAC,EAAE,CAAC,CAE3F"}

package/dist/duckdb/queries.js

@@ -0,0 +1,10 @@
+/**
+ * Execute a dialect-agnostic {@link QuerySpec} (rendered with `duckdbDialect`)
+ * against the DuckDB store and return typed rows. Values are already converted to
+ * plain JS by the client (bigint→number, list→array, timestamp→string), so rows
+ * match the shapes produced by the ClickHouse `runQuery`.
+ */
+export async function runDuckdbQuery(client, spec) {
+    return client.all(spec.query, spec.query_params);
+}
+//# sourceMappingURL=queries.js.map

package/dist/duckdb/queries.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"queries.js","sourceRoot":"","sources":["../../src/duckdb/queries.ts"],"names":[],"mappings":"AAGA;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAAI,MAAoB,EAAE,IAAe;IAC3E,OAAO,MAAM,CAAC,GAAG,CAAI,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,YAAuC,CAAC,CAAC;AACjF,CAAC"}

package/dist/duckdb/sceneRegistry.d.ts

@@ -0,0 +1,15 @@
+import type { SceneProxy } from "@uptimizr/schema";
+import type { SceneRepresentation, SceneRepresentationKind, SceneRepresentationSummary } from "../metadata.js";
+import type { DuckdbClient } from "./client.js";
+export type { SceneRepresentation, SceneRepresentationKind, SceneRepresentationSummary };
+/**
+ * Insert or replace the scene proxy for `(projectId, proxy.sceneId)`. Stores the
+ * full proxy as JSON text and promotes bounds/hash/version/captured-at to columns
+ * for cheap listing. An optional `label` is merged in (kept if not provided).
+ */
+export declare function upsertSceneProxy(client: DuckdbClient, projectId: string, proxy: SceneProxy, label?: string): Promise<SceneRepresentation>;
+/** Fetch one scene representation (including the proxy blob), or `null`. */
+export declare function getSceneRepresentation(client: DuckdbClient, projectId: string, sceneId: string): Promise<SceneRepresentation | null>;
+/** List a project's scene representations (without proxy blobs), newest first. */
+export declare function listSceneRepresentations(client: DuckdbClient, projectId: string): Promise<SceneRepresentationSummary[]>;
+//# sourceMappingURL=sceneRegistry.d.ts.map

package/dist/duckdb/sceneRegistry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sceneRegistry.d.ts","sourceRoot":"","sources":["../../src/duckdb/sceneRegistry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAQ,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAEzD,OAAO,KAAK,EACV,mBAAmB,EACnB,uBAAuB,EACvB,0BAA0B,EAC3B,MAAM,gBAAgB,CAAC;AACxB,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAEhD,YAAY,EAAE,mBAAmB,EAAE,uBAAuB,EAAE,0BAA0B,EAAE,CAAC;AA4DzF;;;;GAIG;AACH,wBAAsB,gBAAgB,CACpC,MAAM,EAAE,YAAY,EACpB,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,UAAU,EACjB,KAAK,CAAC,EAAE,MAAM,GACb,OAAO,CAAC,mBAAmB,CAAC,CAkC9B;AAED,4EAA4E;AAC5E,wBAAsB,sBAAsB,CAC1C,MAAM,EAAE,YAAY,EACpB,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,mBAAmB,GAAG,IAAI,CAAC,CAWrC;AAED,kFAAkF;AAClF,wBAAsB,wBAAwB,CAC5C,MAAM,EAAE,YAAY,EACpB,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,0BAA0B,EAAE,CAAC,CAmBvC"}

package/dist/duckdb/sceneRegistry.js

@@ -0,0 +1,98 @@
+import { toDuckdbTimestamp } from "../query/duckdbDialect.js";
+function toKind(value) {
+    return value === "proxy" || value === "asset" ? value : "none";
+}
+function toUpAxis(value) {
+    return value === "z" ? "z" : "y";
+}
+function parseJson(value) {
+    if (value == null)
+        return null;
+    return JSON.parse(value);
+}
+function rowToRepresentation(row) {
+    return {
+        projectId: row.project_id,
+        sceneId: row.scene_id,
+        label: row.label,
+        kind: toKind(row.kind),
+        upAxis: toUpAxis(row.up_axis),
+        unitScale: Number(row.unit_scale),
+        bounds: parseJson(row.bounds),
+        proxy: parseJson(row.proxy),
+        assetUrl: row.asset_url,
+        contentHash: row.content_hash,
+        proxyVersion: row.proxy_version === null ? null : Number(row.proxy_version),
+        capturedAt: row.captured_at_ms === null ? null : new Date(row.captured_at_ms),
+        updatedAt: new Date(row.updated_at_ms),
+    };
+}
+const RETURNING = `RETURNING project_id, scene_id, label, kind, up_axis, unit_scale, bounds, proxy,
+            asset_url, content_hash, proxy_version,
+            epoch_ms(captured_at) AS captured_at_ms, epoch_ms(updated_at) AS updated_at_ms`;
+/**
+ * Insert or replace the scene proxy for `(projectId, proxy.sceneId)`. Stores the
+ * full proxy as JSON text and promotes bounds/hash/version/captured-at to columns
+ * for cheap listing. An optional `label` is merged in (kept if not provided).
+ */
+export async function upsertSceneProxy(client, projectId, proxy, label) {
+    const rows = await client.all(`INSERT INTO scene_representations
+       (project_id, scene_id, label, kind, up_axis, unit_scale, bounds, proxy,
+        asset_url, content_hash, proxy_version, captured_at, updated_at)
+     VALUES ($projectId, $sceneId, $label, 'proxy', $upAxis, $unitScale, $bounds, $proxy,
+             NULL, $contentHash, $proxyVersion, $capturedAt::TIMESTAMP, now())
+     ON CONFLICT (project_id, scene_id) DO UPDATE SET
+       label         = COALESCE(EXCLUDED.label, scene_representations.label),
+       kind          = 'proxy',
+       up_axis       = EXCLUDED.up_axis,
+       unit_scale    = EXCLUDED.unit_scale,
+       bounds        = EXCLUDED.bounds,
+       proxy         = EXCLUDED.proxy,
+       asset_url     = NULL,
+       content_hash  = EXCLUDED.content_hash,
+       proxy_version = EXCLUDED.proxy_version,
+       captured_at   = EXCLUDED.captured_at,
+       updated_at    = now()
+     ${RETURNING}`, {
+        projectId,
+        sceneId: proxy.sceneId,
+        label: label ?? null,
+        upAxis: proxy.upAxis,
+        unitScale: proxy.unitScale,
+        bounds: JSON.stringify(proxy.bounds),
+        proxy: JSON.stringify(proxy),
+        contentHash: proxy.contentHash,
+        proxyVersion: proxy.version,
+        capturedAt: toDuckdbTimestamp(proxy.capturedAt),
+    });
+    return rowToRepresentation(rows[0]);
+}
+/** Fetch one scene representation (including the proxy blob), or `null`. */
+export async function getSceneRepresentation(client, projectId, sceneId) {
+    const rows = await client.all(`SELECT project_id, scene_id, label, kind, up_axis, unit_scale, bounds, proxy,
+            asset_url, content_hash, proxy_version,
+            epoch_ms(captured_at) AS captured_at_ms, epoch_ms(updated_at) AS updated_at_ms
+     FROM scene_representations
+     WHERE project_id = $projectId AND scene_id = $sceneId`, { projectId, sceneId });
+    const row = rows[0];
+    return row ? rowToRepresentation(row) : null;
+}
+/** List a project's scene representations (without proxy blobs), newest first. */
+export async function listSceneRepresentations(client, projectId) {
+    const rows = await client.all(`SELECT scene_id, label, kind, up_axis, unit_scale, bounds, asset_url,
+            content_hash, proxy_version,
+            epoch_ms(captured_at) AS captured_at_ms, epoch_ms(updated_at) AS updated_at_ms
+     FROM scene_representations
+     WHERE project_id = $projectId
+     ORDER BY updated_at DESC`, { projectId });
+    return rows.map((row) => ({
+        sceneId: row.scene_id,
+        label: row.label,
+        kind: toKind(row.kind),
+        bounds: parseJson(row.bounds),
+        contentHash: row.content_hash,
+        capturedAt: row.captured_at_ms === null ? null : new Date(row.captured_at_ms),
+        updatedAt: new Date(row.updated_at_ms),
+    }));
+}
+//# sourceMappingURL=sceneRegistry.js.map

package/dist/duckdb/sceneRegistry.js.map

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

package/dist/env.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Connection settings for the OSS DuckDB store, read from the environment
+ * (ADR 0020).
+ *
+ * Names mirror `.env.example`. Everything has a local-dev default so the package
+ * is usable out of the box (a single persisted `.duckdb` file).
+ */
+/** DuckDB (OSS single-file store, ADR 0020) connection settings. */
+export interface DuckdbSettings {
+    /** Path to the persisted `.duckdb` file, or `:memory:` for an ephemeral store. */
+    path: string;
+}
+export interface DbSettings {
+    duckdb: DuckdbSettings;
+    /** Opt-in raw per-session retention for replay (ADR 0003). */
+    enableRawSessionRetention: boolean;
+}
+type Env = Record<string, string | undefined>;
+/**
+ * Build {@link DbSettings} from an env-like record (defaults to `process.env`).
+ * Passing an explicit record keeps this pure and testable.
+ */
+export declare function readDbSettings(env?: Env): DbSettings;
+export {};
+//# sourceMappingURL=env.d.ts.map

package/dist/env.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"env.d.ts","sourceRoot":"","sources":["../src/env.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAKH,oEAAoE;AACpE,MAAM,WAAW,cAAc;IAC7B,kFAAkF;IAClF,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,UAAU;IACzB,MAAM,EAAE,cAAc,CAAC;IACvB,8DAA8D;IAC9D,yBAAyB,EAAE,OAAO,CAAC;CACpC;AAED,KAAK,GAAG,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC;AAmC9C;;;GAGG;AACH,wBAAgB,cAAc,CAAC,GAAG,GAAE,GAAiB,GAAG,UAAU,CAOjE"}