enpilink 1.0.2

package/dist/server/storage/postgres.js

@@ -0,0 +1,242 @@
+/**
+ * Resolve the connection string from the environment. Returns `undefined` when
+ * none of the enpilink/standard URL vars are set — in that case `pg` falls back
+ * to its own `PG*` env-var handling. NEVER returns a hardcoded default.
+ */
+export function resolvePostgresConnectionString() {
+    // Treat blank/whitespace-only values as unset so a blank var never shadows a
+    // real one (and never becomes a hardcoded-looking default).
+    const enpilink = process.env.ENPILINK_DB_URL?.trim();
+    if (enpilink) {
+        return enpilink;
+    }
+    const standard = process.env.DATABASE_URL?.trim();
+    return standard ? standard : undefined;
+}
+export class PostgresStorageAdapter {
+    injectedPool;
+    connectionString;
+    pool = null;
+    constructor(opts) {
+        this.injectedPool = opts?.pool;
+        this.connectionString =
+            opts?.connectionString ?? resolvePostgresConnectionString();
+    }
+    async init() {
+        if (this.pool) {
+            return;
+        }
+        if (this.injectedPool) {
+            this.pool = this.injectedPool;
+        }
+        else {
+            // Dynamic import keeps `pg` out of the load path until a postgres adapter
+            // is actually instantiated (memory/sqlite users pay nothing).
+            const mod = await import("pg");
+            const Pool = (mod.default?.Pool ??
+                mod
+                    .Pool);
+            // When no connectionString is resolved, pass none so `pg` reads PG* vars.
+            this.pool = this.connectionString
+                ? new Pool({ connectionString: this.connectionString })
+                : new Pool();
+        }
+        await this.pool.query(SCHEMA);
+    }
+    require() {
+        if (!this.pool) {
+            throw new Error("PostgresStorageAdapter: call init() before use");
+        }
+        return this.pool;
+    }
+    async recordEvent(e) {
+        const pool = this.require();
+        await pool.query("INSERT INTO events (ts, type, tool, method, ms, ok, error, meta) VALUES ($1, $2, $3, $4, $5, $6, $7, $8)", [
+            e.ts,
+            e.type,
+            e.tool ?? null,
+            e.method ?? null,
+            e.ms ?? null,
+            e.ok === undefined ? null : e.ok,
+            e.error ?? null,
+            e.meta === undefined ? null : JSON.stringify(e.meta),
+        ]);
+    }
+    async queryEvents(f = {}) {
+        const pool = this.require();
+        const where = [];
+        const params = [];
+        if (f.since !== undefined) {
+            params.push(f.since);
+            where.push(`ts >= $${params.length}`);
+        }
+        if (f.type !== undefined) {
+            params.push(f.type);
+            where.push(`type = $${params.length}`);
+        }
+        if (f.tool !== undefined) {
+            params.push(f.tool);
+            where.push(`tool = $${params.length}`);
+        }
+        const clause = where.length ? `WHERE ${where.join(" AND ")}` : "";
+        const limit = limitClause(f.limit, params);
+        const { rows } = await pool.query(`SELECT ts, type, tool, method, ms, ok, error, meta FROM events ${clause} ORDER BY id DESC ${limit}`, params);
+        return rows.map(rowToEvent);
+    }
+    async appendLog(l) {
+        const pool = this.require();
+        await pool.query("INSERT INTO logs (ts, level, msg, data) VALUES ($1, $2, $3, $4)", [
+            l.ts,
+            l.level,
+            l.msg,
+            l.data === undefined ? null : JSON.stringify(l.data),
+        ]);
+    }
+    async queryLogs(f = {}) {
+        const pool = this.require();
+        const where = [];
+        const params = [];
+        if (f.since !== undefined) {
+            params.push(f.since);
+            where.push(`ts >= $${params.length}`);
+        }
+        if (f.level !== undefined) {
+            params.push(f.level);
+            where.push(`level = $${params.length}`);
+        }
+        const clause = where.length ? `WHERE ${where.join(" AND ")}` : "";
+        const limit = limitClause(f.limit, params);
+        const { rows } = await pool.query(`SELECT ts, level, msg, data FROM logs ${clause} ORDER BY id DESC ${limit}`, params);
+        return rows.map(rowToLog);
+    }
+    async getConfig(key) {
+        const pool = this.require();
+        const { rows } = await pool.query("SELECT value FROM config WHERE key = $1", [key]);
+        const row = rows[0];
+        return row === undefined ? undefined : JSON.parse(row.value);
+    }
+    async setConfig(key, value, actor) {
+        const pool = this.require();
+        const serialized = JSON.stringify(value);
+        // Read-old → upsert-new → write-audit. pg-mem does not implement
+        // transactions identically across versions, so we read-then-write without a
+        // BEGIN/COMMIT wrapper; the audit row records the prior value either way.
+        const { rows } = await pool.query("SELECT value FROM config WHERE key = $1", [key]);
+        const oldSerialized = rows[0]?.value ?? null;
+        await pool.query("INSERT INTO config (key, value) VALUES ($1, $2) ON CONFLICT (key) DO UPDATE SET value = $2", [key, serialized]);
+        await pool.query("INSERT INTO config_audit (ts, key, old_value, new_value, actor) VALUES ($1, $2, $3, $4, $5)", [Date.now(), key, oldSerialized, serialized, actor ?? "system"]);
+    }
+    async allConfig() {
+        const pool = this.require();
+        const { rows } = await pool.query("SELECT key, value FROM config");
+        const out = {};
+        for (const r of rows) {
+            out[r.key] = JSON.parse(r.value);
+        }
+        return out;
+    }
+    async getConfigAudit() {
+        const pool = this.require();
+        const { rows } = await pool.query("SELECT ts, key, old_value, new_value, actor FROM config_audit ORDER BY id DESC");
+        return rows.map((r) => ({
+            ts: Number(r.ts),
+            key: r.key,
+            oldValue: r.old_value === null ? undefined : JSON.parse(r.old_value),
+            newValue: JSON.parse(r.new_value),
+            actor: r.actor,
+        }));
+    }
+    async close() {
+        if (this.pool) {
+            await this.pool.end();
+            this.pool = null;
+        }
+    }
+}
+function limitClause(limit, params) {
+    if (limit === undefined || limit < 0) {
+        return "";
+    }
+    params.push(limit);
+    return `LIMIT $${params.length}`;
+}
+function rowToEvent(r) {
+    const e = { ts: Number(r.ts), type: r.type };
+    if (r.tool !== null) {
+        e.tool = r.tool;
+    }
+    if (r.method !== null) {
+        e.method = r.method;
+    }
+    if (r.ms !== null) {
+        e.ms = Number(r.ms);
+    }
+    if (r.ok !== null) {
+        e.ok = r.ok;
+    }
+    if (r.error !== null) {
+        e.error = r.error;
+    }
+    if (r.meta !== null) {
+        e.meta = JSON.parse(r.meta);
+    }
+    return e;
+}
+function rowToLog(r) {
+    const l = {
+        ts: Number(r.ts),
+        level: r.level,
+        msg: r.msg,
+    };
+    if (r.data !== null) {
+        l.data = JSON.parse(r.data);
+    }
+    return l;
+}
+/**
+ * Schema. `BIGINT` for epoch-ms timestamps; `BIGSERIAL` ids give a stable
+ * insertion order for most-recent-first queries (`ORDER BY id DESC`). `meta` /
+ * `data` / config values are opaque JSON text.
+ */
+const SCHEMA = `
+CREATE TABLE IF NOT EXISTS events (
+  id BIGSERIAL PRIMARY KEY,
+  ts BIGINT NOT NULL,
+  type TEXT NOT NULL,
+  tool TEXT,
+  method TEXT,
+  ms BIGINT,
+  ok BOOLEAN,
+  error TEXT,
+  meta TEXT
+);
+CREATE INDEX IF NOT EXISTS idx_events_ts ON events (ts);
+CREATE INDEX IF NOT EXISTS idx_events_type ON events (type);
+CREATE INDEX IF NOT EXISTS idx_events_tool ON events (tool);
+
+CREATE TABLE IF NOT EXISTS logs (
+  id BIGSERIAL PRIMARY KEY,
+  ts BIGINT NOT NULL,
+  level TEXT NOT NULL,
+  msg TEXT NOT NULL,
+  data TEXT
+);
+CREATE INDEX IF NOT EXISTS idx_logs_ts ON logs (ts);
+CREATE INDEX IF NOT EXISTS idx_logs_level ON logs (level);
+
+CREATE TABLE IF NOT EXISTS config (
+  key TEXT PRIMARY KEY,
+  value TEXT NOT NULL
+);
+
+CREATE TABLE IF NOT EXISTS config_audit (
+  id BIGSERIAL PRIMARY KEY,
+  ts BIGINT NOT NULL,
+  key TEXT NOT NULL,
+  old_value TEXT,
+  new_value TEXT NOT NULL,
+  actor TEXT NOT NULL
+);
+CREATE INDEX IF NOT EXISTS idx_audit_key ON config_audit (key);
+`;
+//# sourceMappingURL=postgres.js.map

package/dist/server/storage/postgres.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"postgres.js","sourceRoot":"","sources":["../../../src/server/storage/postgres.ts"],"names":[],"mappings":"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","sourcesContent":["import type {\n  AnalyticsEvent,\n  ConfigAuditEntry,\n  EventQuery,\n  LogEntry,\n  LogQuery,\n  StorageAdapter,\n  StorageAdapterOptions,\n} from \"./types.js\";\n\n/**\n * PostgreSQL {@link StorageAdapter}, backed by `pg` (node-postgres).\n *\n * `pg` is pure-JS (no native build), so it installs cleanly in CI on both\n * macOS-arm64 and linux-x64. The connection is configured ENTIRELY from the\n * environment — never hardcoded:\n *\n * - `ENPILINK_DB_URL` (enpilink-specific) takes precedence, else\n * - `DATABASE_URL` (the de-facto standard), else\n * - the standard `PG*` vars (`PGHOST`/`PGPORT`/`PGUSER`/`PGPASSWORD`/`PGDATABASE`)\n *   which `pg` reads on its own when no `connectionString` is given.\n *\n * Tables `events`, `logs`, `config`, `config_audit` are created-if-not-exists in\n * {@link init}. Config values are stored as opaque JSON text — no special-casing\n * of keys. Writes use prepared/parameterized statements; `recordEvent` /\n * `appendLog` are single cheap inserts so the ~600-write mock seed stays fast.\n */\n\n/** Minimal structural type for a `pg` query result (avoids a hard type dep). */\ninterface PgQueryResult<R = Record<string, unknown>> {\n  rows: R[];\n}\n\n/** Minimal structural type for a `pg` Pool — enough for this adapter. */\nexport interface PgPoolLike {\n  query<R = Record<string, unknown>>(\n    text: string,\n    values?: unknown[],\n  ): Promise<PgQueryResult<R>>;\n  end(): Promise<void>;\n}\n\n/** Options specific to the postgres adapter. */\nexport interface PostgresStorageOptions extends StorageAdapterOptions {\n  /**\n   * Inject a `pg`-compatible Pool (used by tests with `pg-mem`). When omitted,\n   * a real `pg.Pool` is constructed lazily in {@link init} from the environment.\n   */\n  pool?: PgPoolLike;\n  /**\n   * Explicit connection string. Normally left undefined so the connection is\n   * resolved from `ENPILINK_DB_URL` / `DATABASE_URL` / `PG*` env vars. Never\n   * hardcode a connection string in source.\n   */\n  connectionString?: string;\n}\n\n/**\n * Resolve the connection string from the environment. Returns `undefined` when\n * none of the enpilink/standard URL vars are set — in that case `pg` falls back\n * to its own `PG*` env-var handling. NEVER returns a hardcoded default.\n */\nexport function resolvePostgresConnectionString(): string | undefined {\n  // Treat blank/whitespace-only values as unset so a blank var never shadows a\n  // real one (and never becomes a hardcoded-looking default).\n  const enpilink = process.env.ENPILINK_DB_URL?.trim();\n  if (enpilink) {\n    return enpilink;\n  }\n  const standard = process.env.DATABASE_URL?.trim();\n  return standard ? standard : undefined;\n}\n\nexport class PostgresStorageAdapter implements StorageAdapter {\n  private readonly injectedPool?: PgPoolLike;\n  private readonly connectionString?: string;\n  private pool: PgPoolLike | null = null;\n\n  constructor(opts?: PostgresStorageOptions) {\n    this.injectedPool = opts?.pool;\n    this.connectionString =\n      opts?.connectionString ?? resolvePostgresConnectionString();\n  }\n\n  async init(): Promise<void> {\n    if (this.pool) {\n      return;\n    }\n    if (this.injectedPool) {\n      this.pool = this.injectedPool;\n    } else {\n      // Dynamic import keeps `pg` out of the load path until a postgres adapter\n      // is actually instantiated (memory/sqlite users pay nothing).\n      const mod = await import(\"pg\");\n      const Pool = (mod.default?.Pool ??\n        (mod as unknown as { Pool: new (cfg?: unknown) => PgPoolLike })\n          .Pool) as new (\n        cfg?: unknown,\n      ) => PgPoolLike;\n      // When no connectionString is resolved, pass none so `pg` reads PG* vars.\n      this.pool = this.connectionString\n        ? new Pool({ connectionString: this.connectionString })\n        : new Pool();\n    }\n    await this.pool.query(SCHEMA);\n  }\n\n  private require(): PgPoolLike {\n    if (!this.pool) {\n      throw new Error(\"PostgresStorageAdapter: call init() before use\");\n    }\n    return this.pool;\n  }\n\n  async recordEvent(e: AnalyticsEvent): Promise<void> {\n    const pool = this.require();\n    await pool.query(\n      \"INSERT INTO events (ts, type, tool, method, ms, ok, error, meta) VALUES ($1, $2, $3, $4, $5, $6, $7, $8)\",\n      [\n        e.ts,\n        e.type,\n        e.tool ?? null,\n        e.method ?? null,\n        e.ms ?? null,\n        e.ok === undefined ? null : e.ok,\n        e.error ?? null,\n        e.meta === undefined ? null : JSON.stringify(e.meta),\n      ],\n    );\n  }\n\n  async queryEvents(f: EventQuery = {}): Promise<AnalyticsEvent[]> {\n    const pool = this.require();\n    const where: string[] = [];\n    const params: unknown[] = [];\n    if (f.since !== undefined) {\n      params.push(f.since);\n      where.push(`ts >= $${params.length}`);\n    }\n    if (f.type !== undefined) {\n      params.push(f.type);\n      where.push(`type = $${params.length}`);\n    }\n    if (f.tool !== undefined) {\n      params.push(f.tool);\n      where.push(`tool = $${params.length}`);\n    }\n    const clause = where.length ? `WHERE ${where.join(\" AND \")}` : \"\";\n    const limit = limitClause(f.limit, params);\n    const { rows } = await pool.query<EventRow>(\n      `SELECT ts, type, tool, method, ms, ok, error, meta FROM events ${clause} ORDER BY id DESC ${limit}`,\n      params,\n    );\n    return rows.map(rowToEvent);\n  }\n\n  async appendLog(l: LogEntry): Promise<void> {\n    const pool = this.require();\n    await pool.query(\n      \"INSERT INTO logs (ts, level, msg, data) VALUES ($1, $2, $3, $4)\",\n      [\n        l.ts,\n        l.level,\n        l.msg,\n        l.data === undefined ? null : JSON.stringify(l.data),\n      ],\n    );\n  }\n\n  async queryLogs(f: LogQuery = {}): Promise<LogEntry[]> {\n    const pool = this.require();\n    const where: string[] = [];\n    const params: unknown[] = [];\n    if (f.since !== undefined) {\n      params.push(f.since);\n      where.push(`ts >= $${params.length}`);\n    }\n    if (f.level !== undefined) {\n      params.push(f.level);\n      where.push(`level = $${params.length}`);\n    }\n    const clause = where.length ? `WHERE ${where.join(\" AND \")}` : \"\";\n    const limit = limitClause(f.limit, params);\n    const { rows } = await pool.query<LogRow>(\n      `SELECT ts, level, msg, data FROM logs ${clause} ORDER BY id DESC ${limit}`,\n      params,\n    );\n    return rows.map(rowToLog);\n  }\n\n  async getConfig(key: string): Promise<unknown> {\n    const pool = this.require();\n    const { rows } = await pool.query<{ value: string }>(\n      \"SELECT value FROM config WHERE key = $1\",\n      [key],\n    );\n    const row = rows[0];\n    return row === undefined ? undefined : JSON.parse(row.value);\n  }\n\n  async setConfig(key: string, value: unknown, actor?: string): Promise<void> {\n    const pool = this.require();\n    const serialized = JSON.stringify(value);\n    // Read-old → upsert-new → write-audit. pg-mem does not implement\n    // transactions identically across versions, so we read-then-write without a\n    // BEGIN/COMMIT wrapper; the audit row records the prior value either way.\n    const { rows } = await pool.query<{ value: string }>(\n      \"SELECT value FROM config WHERE key = $1\",\n      [key],\n    );\n    const oldSerialized = rows[0]?.value ?? null;\n    await pool.query(\n      \"INSERT INTO config (key, value) VALUES ($1, $2) ON CONFLICT (key) DO UPDATE SET value = $2\",\n      [key, serialized],\n    );\n    await pool.query(\n      \"INSERT INTO config_audit (ts, key, old_value, new_value, actor) VALUES ($1, $2, $3, $4, $5)\",\n      [Date.now(), key, oldSerialized, serialized, actor ?? \"system\"],\n    );\n  }\n\n  async allConfig(): Promise<Record<string, unknown>> {\n    const pool = this.require();\n    const { rows } = await pool.query<{ key: string; value: string }>(\n      \"SELECT key, value FROM config\",\n    );\n    const out: Record<string, unknown> = {};\n    for (const r of rows) {\n      out[r.key] = JSON.parse(r.value);\n    }\n    return out;\n  }\n\n  async getConfigAudit(): Promise<ConfigAuditEntry[]> {\n    const pool = this.require();\n    const { rows } = await pool.query<AuditRow>(\n      \"SELECT ts, key, old_value, new_value, actor FROM config_audit ORDER BY id DESC\",\n    );\n    return rows.map((r) => ({\n      ts: Number(r.ts),\n      key: r.key,\n      oldValue: r.old_value === null ? undefined : JSON.parse(r.old_value),\n      newValue: JSON.parse(r.new_value),\n      actor: r.actor,\n    }));\n  }\n\n  async close(): Promise<void> {\n    if (this.pool) {\n      await this.pool.end();\n      this.pool = null;\n    }\n  }\n}\n\nfunction limitClause(limit: number | undefined, params: unknown[]): string {\n  if (limit === undefined || limit < 0) {\n    return \"\";\n  }\n  params.push(limit);\n  return `LIMIT $${params.length}`;\n}\n\ninterface EventRow {\n  ts: number | string;\n  type: string;\n  tool: string | null;\n  method: string | null;\n  ms: number | string | null;\n  ok: boolean | null;\n  error: string | null;\n  meta: string | null;\n}\n\ninterface LogRow {\n  ts: number | string;\n  level: string;\n  msg: string;\n  data: string | null;\n}\n\ninterface AuditRow {\n  ts: number | string;\n  key: string;\n  old_value: string | null;\n  new_value: string;\n  actor: string;\n}\n\nfunction rowToEvent(r: EventRow): AnalyticsEvent {\n  const e: AnalyticsEvent = { ts: Number(r.ts), type: r.type };\n  if (r.tool !== null) {\n    e.tool = r.tool;\n  }\n  if (r.method !== null) {\n    e.method = r.method;\n  }\n  if (r.ms !== null) {\n    e.ms = Number(r.ms);\n  }\n  if (r.ok !== null) {\n    e.ok = r.ok;\n  }\n  if (r.error !== null) {\n    e.error = r.error;\n  }\n  if (r.meta !== null) {\n    e.meta = JSON.parse(r.meta);\n  }\n  return e;\n}\n\nfunction rowToLog(r: LogRow): LogEntry {\n  const l: LogEntry = {\n    ts: Number(r.ts),\n    level: r.level as LogEntry[\"level\"],\n    msg: r.msg,\n  };\n  if (r.data !== null) {\n    l.data = JSON.parse(r.data);\n  }\n  return l;\n}\n\n/**\n * Schema. `BIGINT` for epoch-ms timestamps; `BIGSERIAL` ids give a stable\n * insertion order for most-recent-first queries (`ORDER BY id DESC`). `meta` /\n * `data` / config values are opaque JSON text.\n */\nconst SCHEMA = `\nCREATE TABLE IF NOT EXISTS events (\n  id BIGSERIAL PRIMARY KEY,\n  ts BIGINT NOT NULL,\n  type TEXT NOT NULL,\n  tool TEXT,\n  method TEXT,\n  ms BIGINT,\n  ok BOOLEAN,\n  error TEXT,\n  meta TEXT\n);\nCREATE INDEX IF NOT EXISTS idx_events_ts ON events (ts);\nCREATE INDEX IF NOT EXISTS idx_events_type ON events (type);\nCREATE INDEX IF NOT EXISTS idx_events_tool ON events (tool);\n\nCREATE TABLE IF NOT EXISTS logs (\n  id BIGSERIAL PRIMARY KEY,\n  ts BIGINT NOT NULL,\n  level TEXT NOT NULL,\n  msg TEXT NOT NULL,\n  data TEXT\n);\nCREATE INDEX IF NOT EXISTS idx_logs_ts ON logs (ts);\nCREATE INDEX IF NOT EXISTS idx_logs_level ON logs (level);\n\nCREATE TABLE IF NOT EXISTS config (\n  key TEXT PRIMARY KEY,\n  value TEXT NOT NULL\n);\n\nCREATE TABLE IF NOT EXISTS config_audit (\n  id BIGSERIAL PRIMARY KEY,\n  ts BIGINT NOT NULL,\n  key TEXT NOT NULL,\n  old_value TEXT,\n  new_value TEXT NOT NULL,\n  actor TEXT NOT NULL\n);\nCREATE INDEX IF NOT EXISTS idx_audit_key ON config_audit (key);\n`;\n"]}

package/dist/server/storage/postgres.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/server/storage/postgres.test.js

@@ -0,0 +1,182 @@
+import { newDb } from "pg-mem";
+import { afterEach, beforeEach, describe, expect, it } from "vitest";
+import { PostgresStorageAdapter, resolvePostgresConnectionString, } from "./postgres.js";
+/**
+ * Tests run against `pg-mem` (pure-JS in-memory Postgres). pg-mem's
+ * `createPg().Pool` is a drop-in `pg.Pool`, so the adapter exercises the SAME
+ * code paths it would against a real Postgres — only the engine differs. We
+ * inject the pool via `opts.pool` so no real connection / env is touched.
+ *
+ * Each test gets a fresh `newDb()` so state is isolated and deterministic.
+ */
+function makePool() {
+    const db = newDb();
+    const { Pool } = db.adapters.createPg();
+    return new Pool();
+}
+describe("PostgresStorageAdapter (pg-mem)", () => {
+    let store;
+    beforeEach(async () => {
+        store = new PostgresStorageAdapter({ pool: makePool() });
+        await store.init();
+    });
+    afterEach(async () => {
+        await store.close();
+    });
+    describe("events", () => {
+        it("records and queries events with since/tool/type/limit filters", async () => {
+            await store.recordEvent({
+                ts: 1,
+                type: "tool_call",
+                tool: "a",
+                ms: 5,
+                ok: true,
+            });
+            await store.recordEvent({
+                ts: 5,
+                type: "tool_call",
+                tool: "a",
+                ms: 9,
+                ok: false,
+                error: "boom",
+            });
+            await store.recordEvent({ ts: 10, type: "ping", tool: "b" });
+            const all = await store.queryEvents({});
+            expect(all.map((e) => e.ts)).toEqual([10, 5, 1]);
+            expect(await store.queryEvents({ since: 5 })).toHaveLength(2);
+            expect(await store.queryEvents({ tool: "a" })).toHaveLength(2);
+            expect(await store.queryEvents({ type: "ping" })).toHaveLength(1);
+            expect(await store.queryEvents({ limit: 1 })).toHaveLength(1);
+            const errored = (await store.queryEvents({ since: 5, tool: "a" }))[0];
+            expect(errored).toMatchObject({ ok: false, error: "boom", ms: 9 });
+        });
+        it("round-trips the meta object", async () => {
+            await store.recordEvent({
+                ts: 1,
+                type: "tool_call",
+                meta: { user: "x", nested: { n: 1 } },
+            });
+            const [e] = await store.queryEvents({});
+            expect(e?.meta).toEqual({ user: "x", nested: { n: 1 } });
+        });
+    });
+    describe("logs", () => {
+        it("appends and queries logs with level/limit/since", async () => {
+            await store.appendLog({ ts: 1, level: "info", msg: "one" });
+            await store.appendLog({
+                ts: 2,
+                level: "error",
+                msg: "two",
+                data: { code: 42 },
+            });
+            await store.appendLog({ ts: 3, level: "info", msg: "three" });
+            const all = await store.queryLogs({});
+            expect(all.map((l) => l.msg)).toEqual(["three", "two", "one"]);
+            expect(await store.queryLogs({ level: "error" })).toHaveLength(1);
+            expect(await store.queryLogs({ since: 2 })).toHaveLength(2);
+            expect(await store.queryLogs({ limit: 1 })).toHaveLength(1);
+            expect((await store.queryLogs({ level: "error" }))[0]?.data).toEqual({
+                code: 42,
+            });
+        });
+    });
+    describe("config + audit", () => {
+        it("get/set/all round-trips opaque values", async () => {
+            expect(await store.getConfig("missing")).toBeUndefined();
+            await store.setConfig("analytics.enabled", true);
+            await store.setConfig("retention", { days: 7 });
+            expect(await store.getConfig("analytics.enabled")).toBe(true);
+            expect(await store.getConfig("retention")).toEqual({ days: 7 });
+            expect(await store.allConfig()).toEqual({
+                "analytics.enabled": true,
+                retention: { days: 7 },
+            });
+        });
+        it("upserts on repeated setConfig (no duplicate key)", async () => {
+            await store.setConfig("k", "v1");
+            await store.setConfig("k", "v2");
+            expect(await store.getConfig("k")).toBe("v2");
+            expect(Object.keys(await store.allConfig())).toEqual(["k"]);
+        });
+        it("writes a config_audit row on setConfig with old → new + actor (most recent first)", async () => {
+            await store.setConfig("k", "v1");
+            await store.setConfig("k", "v2", "alice");
+            const audit = await store.getConfigAudit();
+            expect(audit).toHaveLength(2);
+            expect(audit[0]).toMatchObject({
+                key: "k",
+                oldValue: "v1",
+                newValue: "v2",
+                actor: "alice",
+            });
+            expect(audit[1]).toMatchObject({
+                key: "k",
+                oldValue: undefined,
+                newValue: "v1",
+                actor: "system",
+            });
+        });
+    });
+    describe("persistence within a session", () => {
+        it("retains writes across queries on the same pool", async () => {
+            await store.recordEvent({ ts: 1, type: "tool_call", tool: "persisted" });
+            await store.appendLog({ ts: 1, level: "warning", msg: "stays" });
+            await store.setConfig("flag", { on: true }, "bob");
+            const events = await store.queryEvents({});
+            expect(events).toHaveLength(1);
+            expect(events[0]?.tool).toBe("persisted");
+            const logs = await store.queryLogs({});
+            expect(logs[0]?.msg).toBe("stays");
+            expect(await store.getConfig("flag")).toEqual({ on: true });
+            const audit = await store.getConfigAudit();
+            expect(audit).toHaveLength(1);
+            expect(audit[0]).toMatchObject({ actor: "bob" });
+        });
+    });
+    describe("init is idempotent", () => {
+        it("can be called twice without error", async () => {
+            await store.init();
+            await store.recordEvent({ ts: 1, type: "tool_call" });
+            expect(await store.queryEvents({})).toHaveLength(1);
+        });
+    });
+    describe("use-before-init guard", () => {
+        it("throws when querying before init", async () => {
+            const s = new PostgresStorageAdapter({ pool: makePool() });
+            await expect(s.queryEvents({})).rejects.toThrow(/init\(\) before use/);
+        });
+    });
+});
+describe("resolvePostgresConnectionString", () => {
+    const saved = {
+        url: process.env.ENPILINK_DB_URL,
+        db: process.env.DATABASE_URL,
+    };
+    afterEach(() => {
+        if (saved.url === undefined) {
+            delete process.env.ENPILINK_DB_URL;
+        }
+        else {
+            process.env.ENPILINK_DB_URL = saved.url;
+        }
+        if (saved.db === undefined) {
+            delete process.env.DATABASE_URL;
+        }
+        else {
+            process.env.DATABASE_URL = saved.db;
+        }
+    });
+    it("prefers ENPILINK_DB_URL, falls back to DATABASE_URL, else undefined", () => {
+        delete process.env.ENPILINK_DB_URL;
+        delete process.env.DATABASE_URL;
+        expect(resolvePostgresConnectionString()).toBeUndefined();
+        process.env.DATABASE_URL = "postgres://db/standard";
+        expect(resolvePostgresConnectionString()).toBe("postgres://db/standard");
+        process.env.ENPILINK_DB_URL = "postgres://db/enpilink";
+        expect(resolvePostgresConnectionString()).toBe("postgres://db/enpilink");
+        // Whitespace-only is treated as unset (no hardcoded default ever).
+        process.env.ENPILINK_DB_URL = "   ";
+        expect(resolvePostgresConnectionString()).toBe("postgres://db/standard");
+    });
+});
+//# sourceMappingURL=postgres.test.js.map

package/dist/server/storage/postgres.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"postgres.test.js","sourceRoot":"","sources":["../../../src/server/storage/postgres.test.ts"],"names":[],"mappings":"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","sourcesContent":["import { newDb } from \"pg-mem\";\nimport { afterEach, beforeEach, describe, expect, it } from \"vitest\";\nimport {\n  type PgPoolLike,\n  PostgresStorageAdapter,\n  resolvePostgresConnectionString,\n} from \"./postgres.js\";\n\n/**\n * Tests run against `pg-mem` (pure-JS in-memory Postgres). pg-mem's\n * `createPg().Pool` is a drop-in `pg.Pool`, so the adapter exercises the SAME\n * code paths it would against a real Postgres — only the engine differs. We\n * inject the pool via `opts.pool` so no real connection / env is touched.\n *\n * Each test gets a fresh `newDb()` so state is isolated and deterministic.\n */\nfunction makePool(): PgPoolLike {\n  const db = newDb();\n  const { Pool } = db.adapters.createPg();\n  return new Pool() as unknown as PgPoolLike;\n}\n\ndescribe(\"PostgresStorageAdapter (pg-mem)\", () => {\n  let store: PostgresStorageAdapter;\n\n  beforeEach(async () => {\n    store = new PostgresStorageAdapter({ pool: makePool() });\n    await store.init();\n  });\n\n  afterEach(async () => {\n    await store.close();\n  });\n\n  describe(\"events\", () => {\n    it(\"records and queries events with since/tool/type/limit filters\", async () => {\n      await store.recordEvent({\n        ts: 1,\n        type: \"tool_call\",\n        tool: \"a\",\n        ms: 5,\n        ok: true,\n      });\n      await store.recordEvent({\n        ts: 5,\n        type: \"tool_call\",\n        tool: \"a\",\n        ms: 9,\n        ok: false,\n        error: \"boom\",\n      });\n      await store.recordEvent({ ts: 10, type: \"ping\", tool: \"b\" });\n\n      const all = await store.queryEvents({});\n      expect(all.map((e) => e.ts)).toEqual([10, 5, 1]);\n      expect(await store.queryEvents({ since: 5 })).toHaveLength(2);\n      expect(await store.queryEvents({ tool: \"a\" })).toHaveLength(2);\n      expect(await store.queryEvents({ type: \"ping\" })).toHaveLength(1);\n      expect(await store.queryEvents({ limit: 1 })).toHaveLength(1);\n\n      const errored = (await store.queryEvents({ since: 5, tool: \"a\" }))[0];\n      expect(errored).toMatchObject({ ok: false, error: \"boom\", ms: 9 });\n    });\n\n    it(\"round-trips the meta object\", async () => {\n      await store.recordEvent({\n        ts: 1,\n        type: \"tool_call\",\n        meta: { user: \"x\", nested: { n: 1 } },\n      });\n      const [e] = await store.queryEvents({});\n      expect(e?.meta).toEqual({ user: \"x\", nested: { n: 1 } });\n    });\n  });\n\n  describe(\"logs\", () => {\n    it(\"appends and queries logs with level/limit/since\", async () => {\n      await store.appendLog({ ts: 1, level: \"info\", msg: \"one\" });\n      await store.appendLog({\n        ts: 2,\n        level: \"error\",\n        msg: \"two\",\n        data: { code: 42 },\n      });\n      await store.appendLog({ ts: 3, level: \"info\", msg: \"three\" });\n\n      const all = await store.queryLogs({});\n      expect(all.map((l) => l.msg)).toEqual([\"three\", \"two\", \"one\"]);\n      expect(await store.queryLogs({ level: \"error\" })).toHaveLength(1);\n      expect(await store.queryLogs({ since: 2 })).toHaveLength(2);\n      expect(await store.queryLogs({ limit: 1 })).toHaveLength(1);\n      expect((await store.queryLogs({ level: \"error\" }))[0]?.data).toEqual({\n        code: 42,\n      });\n    });\n  });\n\n  describe(\"config + audit\", () => {\n    it(\"get/set/all round-trips opaque values\", async () => {\n      expect(await store.getConfig(\"missing\")).toBeUndefined();\n      await store.setConfig(\"analytics.enabled\", true);\n      await store.setConfig(\"retention\", { days: 7 });\n      expect(await store.getConfig(\"analytics.enabled\")).toBe(true);\n      expect(await store.getConfig(\"retention\")).toEqual({ days: 7 });\n      expect(await store.allConfig()).toEqual({\n        \"analytics.enabled\": true,\n        retention: { days: 7 },\n      });\n    });\n\n    it(\"upserts on repeated setConfig (no duplicate key)\", async () => {\n      await store.setConfig(\"k\", \"v1\");\n      await store.setConfig(\"k\", \"v2\");\n      expect(await store.getConfig(\"k\")).toBe(\"v2\");\n      expect(Object.keys(await store.allConfig())).toEqual([\"k\"]);\n    });\n\n    it(\"writes a config_audit row on setConfig with old → new + actor (most recent first)\", async () => {\n      await store.setConfig(\"k\", \"v1\");\n      await store.setConfig(\"k\", \"v2\", \"alice\");\n      const audit = await store.getConfigAudit();\n      expect(audit).toHaveLength(2);\n      expect(audit[0]).toMatchObject({\n        key: \"k\",\n        oldValue: \"v1\",\n        newValue: \"v2\",\n        actor: \"alice\",\n      });\n      expect(audit[1]).toMatchObject({\n        key: \"k\",\n        oldValue: undefined,\n        newValue: \"v1\",\n        actor: \"system\",\n      });\n    });\n  });\n\n  describe(\"persistence within a session\", () => {\n    it(\"retains writes across queries on the same pool\", async () => {\n      await store.recordEvent({ ts: 1, type: \"tool_call\", tool: \"persisted\" });\n      await store.appendLog({ ts: 1, level: \"warning\", msg: \"stays\" });\n      await store.setConfig(\"flag\", { on: true }, \"bob\");\n\n      const events = await store.queryEvents({});\n      expect(events).toHaveLength(1);\n      expect(events[0]?.tool).toBe(\"persisted\");\n\n      const logs = await store.queryLogs({});\n      expect(logs[0]?.msg).toBe(\"stays\");\n\n      expect(await store.getConfig(\"flag\")).toEqual({ on: true });\n      const audit = await store.getConfigAudit();\n      expect(audit).toHaveLength(1);\n      expect(audit[0]).toMatchObject({ actor: \"bob\" });\n    });\n  });\n\n  describe(\"init is idempotent\", () => {\n    it(\"can be called twice without error\", async () => {\n      await store.init();\n      await store.recordEvent({ ts: 1, type: \"tool_call\" });\n      expect(await store.queryEvents({})).toHaveLength(1);\n    });\n  });\n\n  describe(\"use-before-init guard\", () => {\n    it(\"throws when querying before init\", async () => {\n      const s = new PostgresStorageAdapter({ pool: makePool() });\n      await expect(s.queryEvents({})).rejects.toThrow(/init\\(\\) before use/);\n    });\n  });\n});\n\ndescribe(\"resolvePostgresConnectionString\", () => {\n  const saved = {\n    url: process.env.ENPILINK_DB_URL,\n    db: process.env.DATABASE_URL,\n  };\n  afterEach(() => {\n    if (saved.url === undefined) {\n      delete process.env.ENPILINK_DB_URL;\n    } else {\n      process.env.ENPILINK_DB_URL = saved.url;\n    }\n    if (saved.db === undefined) {\n      delete process.env.DATABASE_URL;\n    } else {\n      process.env.DATABASE_URL = saved.db;\n    }\n  });\n\n  it(\"prefers ENPILINK_DB_URL, falls back to DATABASE_URL, else undefined\", () => {\n    delete process.env.ENPILINK_DB_URL;\n    delete process.env.DATABASE_URL;\n    expect(resolvePostgresConnectionString()).toBeUndefined();\n\n    process.env.DATABASE_URL = \"postgres://db/standard\";\n    expect(resolvePostgresConnectionString()).toBe(\"postgres://db/standard\");\n\n    process.env.ENPILINK_DB_URL = \"postgres://db/enpilink\";\n    expect(resolvePostgresConnectionString()).toBe(\"postgres://db/enpilink\");\n\n    // Whitespace-only is treated as unset (no hardcoded default ever).\n    process.env.ENPILINK_DB_URL = \"   \";\n    expect(resolvePostgresConnectionString()).toBe(\"postgres://db/standard\");\n  });\n});\n"]}

package/dist/server/storage/sqlite.d.ts

@@ -0,0 +1,33 @@
+import type { AnalyticsEvent, ConfigAuditEntry, EventQuery, LogEntry, LogQuery, StorageAdapter, StorageAdapterOptions } from "./types.js";
+/** Default on-disk database path. Overridable via `ENPILINK_DB_PATH`. */
+export declare const DEFAULT_DB_PATH = "./enpilink.db";
+/**
+ * Embedded-SQLite {@link StorageAdapter}, backed by `better-sqlite3`.
+ *
+ * `better-sqlite3` was chosen over `node:sqlite` (experimental, warns on every
+ * load) and `@libsql/client` (async, remote-oriented, heavier): it is mature,
+ * synchronous (simple adapter code), and ships prebuilt binaries for both
+ * macOS-arm64 and linux-x64, so `pnpm install` succeeds without node-gyp.
+ *
+ * Tables: `events`, `logs`, `config`, `config_audit`. Config values are stored
+ * as opaque JSON — no special-casing of keys. The DB path is gitignored.
+ */
+export declare class SqliteStorageAdapter implements StorageAdapter {
+    private readonly path;
+    private db;
+    private stmts;
+    constructor(opts?: StorageAdapterOptions);
+    init(): Promise<void>;
+    private require;
+    recordEvent(e: AnalyticsEvent): Promise<void>;
+    queryEvents(f?: EventQuery): Promise<AnalyticsEvent[]>;
+    appendLog(l: LogEntry): Promise<void>;
+    queryLogs(f?: LogQuery): Promise<LogEntry[]>;
+    getConfig(key: string): Promise<unknown>;
+    setConfig(key: string, value: unknown, actor?: string): Promise<void>;
+    allConfig(): Promise<Record<string, unknown>>;
+    getConfigAudit(): Promise<ConfigAuditEntry[]>;
+    close(): Promise<void>;
+    /** Audit trail of config writes (most recent first). Synchronous helper. */
+    getAuditLog(): ConfigAuditEntry[];
+}