enpilink 1.0.2

package/dist/server/storage/sqlite.js

@@ -0,0 +1,250 @@
+/** Default on-disk database path. Overridable via `ENPILINK_DB_PATH`. */
+export 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 class SqliteStorageAdapter {
+    path;
+    db = null;
+    stmts = null;
+    constructor(opts) {
+        this.path = opts?.path ?? DEFAULT_DB_PATH;
+    }
+    async init() {
+        if (this.db) {
+            return;
+        }
+        // Dynamic import keeps the native module out of the load path until a
+        // sqlite adapter is actually instantiated (memory-only users pay nothing).
+        const mod = await import("better-sqlite3");
+        const Database = (mod.default ??
+            mod);
+        const db = new Database(this.path);
+        db.pragma("journal_mode = WAL");
+        db.exec(SCHEMA);
+        this.db = db;
+        this.stmts = {
+            insertEvent: db.prepare("INSERT INTO events (ts, type, tool, method, ms, ok, error, meta) VALUES (@ts, @type, @tool, @method, @ms, @ok, @error, @meta)"),
+            insertLog: db.prepare("INSERT INTO logs (ts, level, msg, data) VALUES (@ts, @level, @msg, @data)"),
+            getConfig: db.prepare("SELECT value FROM config WHERE key = ?"),
+            upsertConfig: db.prepare("INSERT INTO config (key, value) VALUES (@key, @value) ON CONFLICT(key) DO UPDATE SET value = @value"),
+            insertAudit: db.prepare("INSERT INTO config_audit (ts, key, old_value, new_value, actor) VALUES (@ts, @key, @old_value, @new_value, @actor)"),
+            allConfig: db.prepare("SELECT key, value FROM config"),
+        };
+    }
+    require() {
+        if (!this.db || !this.stmts) {
+            throw new Error("SqliteStorageAdapter: call init() before use");
+        }
+        return { db: this.db, stmts: this.stmts };
+    }
+    async recordEvent(e) {
+        const { stmts } = this.require();
+        stmts.insertEvent.run({
+            ts: e.ts,
+            type: e.type,
+            tool: e.tool ?? null,
+            method: e.method ?? null,
+            ms: e.ms ?? null,
+            ok: e.ok === undefined ? null : e.ok ? 1 : 0,
+            error: e.error ?? null,
+            meta: e.meta === undefined ? null : JSON.stringify(e.meta),
+        });
+    }
+    async queryEvents(f = {}) {
+        const { db } = this.require();
+        const where = [];
+        const params = {};
+        if (f.since !== undefined) {
+            where.push("ts >= @since");
+            params.since = f.since;
+        }
+        if (f.type !== undefined) {
+            where.push("type = @type");
+            params.type = f.type;
+        }
+        if (f.tool !== undefined) {
+            where.push("tool = @tool");
+            params.tool = f.tool;
+        }
+        const clause = where.length ? `WHERE ${where.join(" AND ")}` : "";
+        const limit = limitClause(f.limit, params);
+        const rows = db
+            .prepare(`SELECT ts, type, tool, method, ms, ok, error, meta FROM events ${clause} ORDER BY id DESC ${limit}`)
+            .all(params);
+        return rows.map(rowToEvent);
+    }
+    async appendLog(l) {
+        const { stmts } = this.require();
+        stmts.insertLog.run({
+            ts: l.ts,
+            level: l.level,
+            msg: l.msg,
+            data: l.data === undefined ? null : JSON.stringify(l.data),
+        });
+    }
+    async queryLogs(f = {}) {
+        const { db } = this.require();
+        const where = [];
+        const params = {};
+        if (f.since !== undefined) {
+            where.push("ts >= @since");
+            params.since = f.since;
+        }
+        if (f.level !== undefined) {
+            where.push("level = @level");
+            params.level = f.level;
+        }
+        const clause = where.length ? `WHERE ${where.join(" AND ")}` : "";
+        const limit = limitClause(f.limit, params);
+        const rows = db
+            .prepare(`SELECT ts, level, msg, data FROM logs ${clause} ORDER BY id DESC ${limit}`)
+            .all(params);
+        return rows.map(rowToLog);
+    }
+    async getConfig(key) {
+        const { stmts } = this.require();
+        const row = stmts.getConfig.get(key);
+        return row === undefined ? undefined : JSON.parse(row.value);
+    }
+    async setConfig(key, value, actor) {
+        const { db, stmts } = this.require();
+        const serialized = JSON.stringify(value);
+        // Atomically read-old → write-new → write-audit.
+        const tx = db.transaction(() => {
+            const existing = stmts.getConfig.get(key);
+            stmts.upsertConfig.run({ key, value: serialized });
+            stmts.insertAudit.run({
+                ts: Date.now(),
+                key,
+                old_value: existing === undefined ? null : existing.value,
+                new_value: serialized,
+                actor: actor ?? "system",
+            });
+        });
+        tx();
+    }
+    async allConfig() {
+        const { stmts } = this.require();
+        const rows = stmts.allConfig.all();
+        const out = {};
+        for (const r of rows) {
+            out[r.key] = JSON.parse(r.value);
+        }
+        return out;
+    }
+    async getConfigAudit() {
+        return this.getAuditLog();
+    }
+    async close() {
+        if (this.db) {
+            this.db.close();
+            this.db = null;
+            this.stmts = null;
+        }
+    }
+    /** Audit trail of config writes (most recent first). Synchronous helper. */
+    getAuditLog() {
+        const { db } = this.require();
+        const rows = db
+            .prepare("SELECT ts, key, old_value, new_value, actor FROM config_audit ORDER BY id DESC")
+            .all();
+        return rows.map((r) => ({
+            ts: 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,
+        }));
+    }
+}
+function limitClause(limit, params) {
+    if (limit === undefined || limit < 0) {
+        return "";
+    }
+    params.limit = limit;
+    return "LIMIT @limit";
+}
+function rowToEvent(r) {
+    const e = { ts: 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 = r.ms;
+    }
+    if (r.ok !== null) {
+        e.ok = r.ok === 1;
+    }
+    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: r.ts,
+        level: r.level,
+        msg: r.msg,
+    };
+    if (r.data !== null) {
+        l.data = JSON.parse(r.data);
+    }
+    return l;
+}
+const SCHEMA = `
+CREATE TABLE IF NOT EXISTS events (
+  id INTEGER PRIMARY KEY AUTOINCREMENT,
+  ts INTEGER NOT NULL,
+  type TEXT NOT NULL,
+  tool TEXT,
+  method TEXT,
+  ms INTEGER,
+  ok INTEGER,
+  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 INTEGER PRIMARY KEY AUTOINCREMENT,
+  ts INTEGER 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 INTEGER PRIMARY KEY AUTOINCREMENT,
+  ts INTEGER 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=sqlite.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"sqlite.js","sourceRoot":"","sources":["../../../src/server/storage/sqlite.ts"],"names":[],"mappings":"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","sourcesContent":["import type DatabaseConstructor from \"better-sqlite3\";\nimport type { Database, Statement } from \"better-sqlite3\";\nimport type {\n  AnalyticsEvent,\n  ConfigAuditEntry,\n  EventQuery,\n  LogEntry,\n  LogQuery,\n  StorageAdapter,\n  StorageAdapterOptions,\n} from \"./types.js\";\n\n/** Default on-disk database path. Overridable via `ENPILINK_DB_PATH`. */\nexport const DEFAULT_DB_PATH = \"./enpilink.db\";\n\n/**\n * Embedded-SQLite {@link StorageAdapter}, backed by `better-sqlite3`.\n *\n * `better-sqlite3` was chosen over `node:sqlite` (experimental, warns on every\n * load) and `@libsql/client` (async, remote-oriented, heavier): it is mature,\n * synchronous (simple adapter code), and ships prebuilt binaries for both\n * macOS-arm64 and linux-x64, so `pnpm install` succeeds without node-gyp.\n *\n * Tables: `events`, `logs`, `config`, `config_audit`. Config values are stored\n * as opaque JSON — no special-casing of keys. The DB path is gitignored.\n */\nexport class SqliteStorageAdapter implements StorageAdapter {\n  private readonly path: string;\n  private db: Database | null = null;\n  private stmts: {\n    insertEvent: Statement;\n    insertLog: Statement;\n    getConfig: Statement;\n    upsertConfig: Statement;\n    insertAudit: Statement;\n    allConfig: Statement;\n  } | null = null;\n\n  constructor(opts?: StorageAdapterOptions) {\n    this.path = opts?.path ?? DEFAULT_DB_PATH;\n  }\n\n  async init(): Promise<void> {\n    if (this.db) {\n      return;\n    }\n    // Dynamic import keeps the native module out of the load path until a\n    // sqlite adapter is actually instantiated (memory-only users pay nothing).\n    const mod = await import(\"better-sqlite3\");\n    const Database = (mod.default ??\n      mod) as unknown as typeof DatabaseConstructor;\n    const db = new Database(this.path);\n    db.pragma(\"journal_mode = WAL\");\n    db.exec(SCHEMA);\n    this.db = db;\n    this.stmts = {\n      insertEvent: db.prepare(\n        \"INSERT INTO events (ts, type, tool, method, ms, ok, error, meta) VALUES (@ts, @type, @tool, @method, @ms, @ok, @error, @meta)\",\n      ),\n      insertLog: db.prepare(\n        \"INSERT INTO logs (ts, level, msg, data) VALUES (@ts, @level, @msg, @data)\",\n      ),\n      getConfig: db.prepare(\"SELECT value FROM config WHERE key = ?\"),\n      upsertConfig: db.prepare(\n        \"INSERT INTO config (key, value) VALUES (@key, @value) ON CONFLICT(key) DO UPDATE SET value = @value\",\n      ),\n      insertAudit: db.prepare(\n        \"INSERT INTO config_audit (ts, key, old_value, new_value, actor) VALUES (@ts, @key, @old_value, @new_value, @actor)\",\n      ),\n      allConfig: db.prepare(\"SELECT key, value FROM config\"),\n    };\n  }\n\n  private require() {\n    if (!this.db || !this.stmts) {\n      throw new Error(\"SqliteStorageAdapter: call init() before use\");\n    }\n    return { db: this.db, stmts: this.stmts };\n  }\n\n  async recordEvent(e: AnalyticsEvent): Promise<void> {\n    const { stmts } = this.require();\n    stmts.insertEvent.run({\n      ts: e.ts,\n      type: e.type,\n      tool: e.tool ?? null,\n      method: e.method ?? null,\n      ms: e.ms ?? null,\n      ok: e.ok === undefined ? null : e.ok ? 1 : 0,\n      error: e.error ?? null,\n      meta: e.meta === undefined ? null : JSON.stringify(e.meta),\n    });\n  }\n\n  async queryEvents(f: EventQuery = {}): Promise<AnalyticsEvent[]> {\n    const { db } = this.require();\n    const where: string[] = [];\n    const params: Record<string, unknown> = {};\n    if (f.since !== undefined) {\n      where.push(\"ts >= @since\");\n      params.since = f.since;\n    }\n    if (f.type !== undefined) {\n      where.push(\"type = @type\");\n      params.type = f.type;\n    }\n    if (f.tool !== undefined) {\n      where.push(\"tool = @tool\");\n      params.tool = f.tool;\n    }\n    const clause = where.length ? `WHERE ${where.join(\" AND \")}` : \"\";\n    const limit = limitClause(f.limit, params);\n    const rows = db\n      .prepare(\n        `SELECT ts, type, tool, method, ms, ok, error, meta FROM events ${clause} ORDER BY id DESC ${limit}`,\n      )\n      .all(params) as EventRow[];\n    return rows.map(rowToEvent);\n  }\n\n  async appendLog(l: LogEntry): Promise<void> {\n    const { stmts } = this.require();\n    stmts.insertLog.run({\n      ts: l.ts,\n      level: l.level,\n      msg: l.msg,\n      data: l.data === undefined ? null : JSON.stringify(l.data),\n    });\n  }\n\n  async queryLogs(f: LogQuery = {}): Promise<LogEntry[]> {\n    const { db } = this.require();\n    const where: string[] = [];\n    const params: Record<string, unknown> = {};\n    if (f.since !== undefined) {\n      where.push(\"ts >= @since\");\n      params.since = f.since;\n    }\n    if (f.level !== undefined) {\n      where.push(\"level = @level\");\n      params.level = f.level;\n    }\n    const clause = where.length ? `WHERE ${where.join(\" AND \")}` : \"\";\n    const limit = limitClause(f.limit, params);\n    const rows = db\n      .prepare(\n        `SELECT ts, level, msg, data FROM logs ${clause} ORDER BY id DESC ${limit}`,\n      )\n      .all(params) as LogRow[];\n    return rows.map(rowToLog);\n  }\n\n  async getConfig(key: string): Promise<unknown> {\n    const { stmts } = this.require();\n    const row = stmts.getConfig.get(key) as { value: string } | undefined;\n    return row === undefined ? undefined : JSON.parse(row.value);\n  }\n\n  async setConfig(key: string, value: unknown, actor?: string): Promise<void> {\n    const { db, stmts } = this.require();\n    const serialized = JSON.stringify(value);\n    // Atomically read-old → write-new → write-audit.\n    const tx = db.transaction(() => {\n      const existing = stmts.getConfig.get(key) as\n        | { value: string }\n        | undefined;\n      stmts.upsertConfig.run({ key, value: serialized });\n      stmts.insertAudit.run({\n        ts: Date.now(),\n        key,\n        old_value: existing === undefined ? null : existing.value,\n        new_value: serialized,\n        actor: actor ?? \"system\",\n      });\n    });\n    tx();\n  }\n\n  async allConfig(): Promise<Record<string, unknown>> {\n    const { stmts } = this.require();\n    const rows = stmts.allConfig.all() as { key: string; value: string }[];\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    return this.getAuditLog();\n  }\n\n  async close(): Promise<void> {\n    if (this.db) {\n      this.db.close();\n      this.db = null;\n      this.stmts = null;\n    }\n  }\n\n  /** Audit trail of config writes (most recent first). Synchronous helper. */\n  getAuditLog(): ConfigAuditEntry[] {\n    const { db } = this.require();\n    const rows = db\n      .prepare(\n        \"SELECT ts, key, old_value, new_value, actor FROM config_audit ORDER BY id DESC\",\n      )\n      .all() as AuditRow[];\n    return rows.map((r) => ({\n      ts: 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\nfunction limitClause(\n  limit: number | undefined,\n  params: Record<string, unknown>,\n): string {\n  if (limit === undefined || limit < 0) {\n    return \"\";\n  }\n  params.limit = limit;\n  return \"LIMIT @limit\";\n}\n\ninterface EventRow {\n  ts: number;\n  type: string;\n  tool: string | null;\n  method: string | null;\n  ms: number | null;\n  ok: number | null;\n  error: string | null;\n  meta: string | null;\n}\n\ninterface LogRow {\n  ts: number;\n  level: string;\n  msg: string;\n  data: string | null;\n}\n\ninterface AuditRow {\n  ts: number;\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: 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 = r.ms;\n  }\n  if (r.ok !== null) {\n    e.ok = r.ok === 1;\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: 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\nconst SCHEMA = `\nCREATE TABLE IF NOT EXISTS events (\n  id INTEGER PRIMARY KEY AUTOINCREMENT,\n  ts INTEGER NOT NULL,\n  type TEXT NOT NULL,\n  tool TEXT,\n  method TEXT,\n  ms INTEGER,\n  ok INTEGER,\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 INTEGER PRIMARY KEY AUTOINCREMENT,\n  ts INTEGER 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 INTEGER PRIMARY KEY AUTOINCREMENT,\n  ts INTEGER 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/sqlite.test.d.ts

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

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

@@ -0,0 +1,133 @@
+import { mkdtempSync, rmSync } from "node:fs";
+import { tmpdir } from "node:os";
+import { join } from "node:path";
+import { afterEach, beforeEach, describe, expect, it } from "vitest";
+import { SqliteStorageAdapter } from "./sqlite.js";
+describe("SqliteStorageAdapter", () => {
+    let dir;
+    let dbPath;
+    let store;
+    beforeEach(async () => {
+        dir = mkdtempSync(join(tmpdir(), "enpilink-sqlite-"));
+        dbPath = join(dir, "test.db");
+        store = new SqliteStorageAdapter({ path: dbPath });
+        await store.init();
+    });
+    afterEach(async () => {
+        await store.close();
+        rmSync(dir, { recursive: true, force: true });
+    });
+    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("writes a config_audit row on setConfig with old → new + actor", async () => {
+            await store.setConfig("k", "v1");
+            await store.setConfig("k", "v2", "alice");
+            const audit = store.getAuditLog();
+            expect(audit).toHaveLength(2);
+            // Most recent first.
+            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", () => {
+        it("retains data across close + reopen on the same path", 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");
+            await store.close();
+            const reopened = new SqliteStorageAdapter({ path: dbPath });
+            await reopened.init();
+            try {
+                const events = await reopened.queryEvents({});
+                expect(events).toHaveLength(1);
+                expect(events[0]?.tool).toBe("persisted");
+                const logs = await reopened.queryLogs({});
+                expect(logs[0]?.msg).toBe("stays");
+                expect(await reopened.getConfig("flag")).toEqual({ on: true });
+                expect(reopened.getAuditLog()).toHaveLength(1);
+                expect(reopened.getAuditLog()[0]).toMatchObject({ actor: "bob" });
+            }
+            finally {
+                await reopened.close();
+            }
+        });
+    });
+});
+//# sourceMappingURL=sqlite.test.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"sqlite.test.js","sourceRoot":"","sources":["../../../src/server/storage/sqlite.test.ts"],"names":[],"mappings":"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","sourcesContent":["import { mkdtempSync, rmSync } from \"node:fs\";\nimport { tmpdir } from \"node:os\";\nimport { join } from \"node:path\";\nimport { afterEach, beforeEach, describe, expect, it } from \"vitest\";\nimport { SqliteStorageAdapter } from \"./sqlite.js\";\n\ndescribe(\"SqliteStorageAdapter\", () => {\n  let dir: string;\n  let dbPath: string;\n  let store: SqliteStorageAdapter;\n\n  beforeEach(async () => {\n    dir = mkdtempSync(join(tmpdir(), \"enpilink-sqlite-\"));\n    dbPath = join(dir, \"test.db\");\n    store = new SqliteStorageAdapter({ path: dbPath });\n    await store.init();\n  });\n\n  afterEach(async () => {\n    await store.close();\n    rmSync(dir, { recursive: true, force: true });\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(\"writes a config_audit row on setConfig with old → new + actor\", async () => {\n      await store.setConfig(\"k\", \"v1\");\n      await store.setConfig(\"k\", \"v2\", \"alice\");\n      const audit = store.getAuditLog();\n      expect(audit).toHaveLength(2);\n      // Most recent first.\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\", () => {\n    it(\"retains data across close + reopen on the same path\", 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      await store.close();\n\n      const reopened = new SqliteStorageAdapter({ path: dbPath });\n      await reopened.init();\n      try {\n        const events = await reopened.queryEvents({});\n        expect(events).toHaveLength(1);\n        expect(events[0]?.tool).toBe(\"persisted\");\n\n        const logs = await reopened.queryLogs({});\n        expect(logs[0]?.msg).toBe(\"stays\");\n\n        expect(await reopened.getConfig(\"flag\")).toEqual({ on: true });\n        expect(reopened.getAuditLog()).toHaveLength(1);\n        expect(reopened.getAuditLog()[0]).toMatchObject({ actor: \"bob\" });\n      } finally {\n        await reopened.close();\n      }\n    });\n  });\n});\n"]}

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

@@ -0,0 +1,119 @@
+/**
+ * Storage layer types for enpilink's admin / observability / config plane.
+ *
+ * The {@link StorageAdapter} is the single pluggable persistence surface used by
+ * analytics (events), log capture (logs), and the config/admin layer (config +
+ * audit). Built-in adapters: `memory` (dev default, zero deps) and `sqlite`
+ * (prod default, embedded). Custom adapters register via
+ * `registerStorageAdapter`.
+ */
+/**
+ * A single analytics event. Emitted (in M2) by the analytics middleware for
+ * each MCP request — most commonly a `tool_call`. `type` is open-ended so other
+ * event kinds can be recorded without a schema change.
+ */
+export interface AnalyticsEvent {
+    /** Unix epoch milliseconds when the event occurred. */
+    ts: number;
+    /** Event kind. `"tool_call"` is the built-in, but any string is allowed. */
+    type: "tool_call" | string;
+    /** Tool name (for `tools/call`), from `params.name`. */
+    tool?: string;
+    /** MCP method, e.g. `"tools/call"`. */
+    method?: string;
+    /** Duration of the call in milliseconds. */
+    ms?: number;
+    /** Whether the call succeeded (false when the result was an error). */
+    ok?: boolean;
+    /** Error message, when the call failed. */
+    error?: string;
+    /** Arbitrary extra structured data. */
+    meta?: Record<string, unknown>;
+}
+/** A captured server log line. */
+export interface LogEntry {
+    /** Unix epoch milliseconds. */
+    ts: number;
+    /** Log severity. */
+    level: "debug" | "info" | "warning" | "error";
+    /** The log message. */
+    msg: string;
+    /** Optional structured payload. */
+    data?: unknown;
+}
+/** Filter for {@link StorageAdapter.queryEvents}. */
+export interface EventQuery {
+    /** Only events with `ts >= since` (epoch ms). */
+    since?: number;
+    /** Only events whose `type` matches. */
+    type?: string;
+    /** Only events whose `tool` matches. */
+    tool?: string;
+    /** Maximum number of events returned (most recent first). */
+    limit?: number;
+}
+/** Filter for {@link StorageAdapter.queryLogs}. */
+export interface LogQuery {
+    /** Only logs with `ts >= since` (epoch ms). */
+    since?: number;
+    /** Only logs whose `level` matches. */
+    level?: string;
+    /** Maximum number of logs returned (most recent first). */
+    limit?: number;
+}
+/**
+ * Pluggable persistence interface backing the observability + config plane.
+ *
+ * Implementations MUST:
+ * - treat config values as opaque (no special-casing of keys/secrets);
+ * - write a `config_audit` entry on every {@link setConfig} call;
+ * - return query results most-recent-first.
+ */
+export interface StorageAdapter {
+    /** Open connections / create schema. Safe to call once before use. */
+    init(): Promise<void>;
+    /** Record an analytics event. Must never throw into the caller's hot path. */
+    recordEvent(e: AnalyticsEvent): Promise<void>;
+    /** Query events, most recent first. */
+    queryEvents(f: EventQuery): Promise<AnalyticsEvent[]>;
+    /** Append a captured log line. */
+    appendLog(l: LogEntry): Promise<void>;
+    /** Query logs, most recent first. */
+    queryLogs(f: LogQuery): Promise<LogEntry[]>;
+    /** Read a single config value (or `undefined` if unset). */
+    getConfig(key: string): Promise<unknown>;
+    /** Write a config value AND append a `config_audit` row (old → new). */
+    setConfig(key: string, value: unknown, actor?: string): Promise<void>;
+    /** Read all config as a plain object. */
+    allConfig(): Promise<Record<string, unknown>>;
+    /**
+     * Read the config-change audit trail, most recent first. Surfaces the
+     * `config_audit` rows that {@link setConfig} writes, for the admin UI's
+     * change history.
+     */
+    getConfigAudit(): Promise<ConfigAuditEntry[]>;
+    /** Release resources / close connections. */
+    close(): Promise<void>;
+}
+/** A single config-change audit record. */
+export interface ConfigAuditEntry {
+    /** Unix epoch milliseconds. */
+    ts: number;
+    /** Config key that changed. */
+    key: string;
+    /** Previous value (JSON-serializable), or `undefined` if newly set. */
+    oldValue: unknown;
+    /** New value (JSON-serializable). */
+    newValue: unknown;
+    /** Who made the change (defaults to `"system"`). */
+    actor: string;
+}
+/** Options passed to a storage adapter factory. */
+export interface StorageAdapterOptions {
+    /** Ring-buffer capacity (memory) — max events/logs retained. */
+    cap?: number;
+    /** Database path (sqlite). */
+    path?: string;
+}
+/** Factory signature for {@link registerStorageAdapter}. */
+export type StorageAdapterFactory = (opts?: StorageAdapterOptions) => StorageAdapter;

package/dist/server/storage/types.js

@@ -0,0 +1,11 @@
+/**
+ * Storage layer types for enpilink's admin / observability / config plane.
+ *
+ * The {@link StorageAdapter} is the single pluggable persistence surface used by
+ * analytics (events), log capture (logs), and the config/admin layer (config +
+ * audit). Built-in adapters: `memory` (dev default, zero deps) and `sqlite`
+ * (prod default, embedded). Custom adapters register via
+ * `registerStorageAdapter`.
+ */
+export {};
+//# sourceMappingURL=types.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/server/storage/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG","sourcesContent":["/**\n * Storage layer types for enpilink's admin / observability / config plane.\n *\n * The {@link StorageAdapter} is the single pluggable persistence surface used by\n * analytics (events), log capture (logs), and the config/admin layer (config +\n * audit). Built-in adapters: `memory` (dev default, zero deps) and `sqlite`\n * (prod default, embedded). Custom adapters register via\n * `registerStorageAdapter`.\n */\n\n/**\n * A single analytics event. Emitted (in M2) by the analytics middleware for\n * each MCP request — most commonly a `tool_call`. `type` is open-ended so other\n * event kinds can be recorded without a schema change.\n */\nexport interface AnalyticsEvent {\n  /** Unix epoch milliseconds when the event occurred. */\n  ts: number;\n  /** Event kind. `\"tool_call\"` is the built-in, but any string is allowed. */\n  type: \"tool_call\" | string;\n  /** Tool name (for `tools/call`), from `params.name`. */\n  tool?: string;\n  /** MCP method, e.g. `\"tools/call\"`. */\n  method?: string;\n  /** Duration of the call in milliseconds. */\n  ms?: number;\n  /** Whether the call succeeded (false when the result was an error). */\n  ok?: boolean;\n  /** Error message, when the call failed. */\n  error?: string;\n  /** Arbitrary extra structured data. */\n  meta?: Record<string, unknown>;\n}\n\n/** A captured server log line. */\nexport interface LogEntry {\n  /** Unix epoch milliseconds. */\n  ts: number;\n  /** Log severity. */\n  level: \"debug\" | \"info\" | \"warning\" | \"error\";\n  /** The log message. */\n  msg: string;\n  /** Optional structured payload. */\n  data?: unknown;\n}\n\n/** Filter for {@link StorageAdapter.queryEvents}. */\nexport interface EventQuery {\n  /** Only events with `ts >= since` (epoch ms). */\n  since?: number;\n  /** Only events whose `type` matches. */\n  type?: string;\n  /** Only events whose `tool` matches. */\n  tool?: string;\n  /** Maximum number of events returned (most recent first). */\n  limit?: number;\n}\n\n/** Filter for {@link StorageAdapter.queryLogs}. */\nexport interface LogQuery {\n  /** Only logs with `ts >= since` (epoch ms). */\n  since?: number;\n  /** Only logs whose `level` matches. */\n  level?: string;\n  /** Maximum number of logs returned (most recent first). */\n  limit?: number;\n}\n\n/**\n * Pluggable persistence interface backing the observability + config plane.\n *\n * Implementations MUST:\n * - treat config values as opaque (no special-casing of keys/secrets);\n * - write a `config_audit` entry on every {@link setConfig} call;\n * - return query results most-recent-first.\n */\nexport interface StorageAdapter {\n  /** Open connections / create schema. Safe to call once before use. */\n  init(): Promise<void>;\n  /** Record an analytics event. Must never throw into the caller's hot path. */\n  recordEvent(e: AnalyticsEvent): Promise<void>;\n  /** Query events, most recent first. */\n  queryEvents(f: EventQuery): Promise<AnalyticsEvent[]>;\n  /** Append a captured log line. */\n  appendLog(l: LogEntry): Promise<void>;\n  /** Query logs, most recent first. */\n  queryLogs(f: LogQuery): Promise<LogEntry[]>;\n  /** Read a single config value (or `undefined` if unset). */\n  getConfig(key: string): Promise<unknown>;\n  /** Write a config value AND append a `config_audit` row (old → new). */\n  setConfig(key: string, value: unknown, actor?: string): Promise<void>;\n  /** Read all config as a plain object. */\n  allConfig(): Promise<Record<string, unknown>>;\n  /**\n   * Read the config-change audit trail, most recent first. Surfaces the\n   * `config_audit` rows that {@link setConfig} writes, for the admin UI's\n   * change history.\n   */\n  getConfigAudit(): Promise<ConfigAuditEntry[]>;\n  /** Release resources / close connections. */\n  close(): Promise<void>;\n}\n\n/** A single config-change audit record. */\nexport interface ConfigAuditEntry {\n  /** Unix epoch milliseconds. */\n  ts: number;\n  /** Config key that changed. */\n  key: string;\n  /** Previous value (JSON-serializable), or `undefined` if newly set. */\n  oldValue: unknown;\n  /** New value (JSON-serializable). */\n  newValue: unknown;\n  /** Who made the change (defaults to `\"system\"`). */\n  actor: string;\n}\n\n/** Options passed to a storage adapter factory. */\nexport interface StorageAdapterOptions {\n  /** Ring-buffer capacity (memory) — max events/logs retained. */\n  cap?: number;\n  /** Database path (sqlite). */\n  path?: string;\n}\n\n/** Factory signature for {@link registerStorageAdapter}. */\nexport type StorageAdapterFactory = (\n  opts?: StorageAdapterOptions,\n) => StorageAdapter;\n"]}

package/dist/server/templateHelper.d.ts

@@ -0,0 +1,16 @@
+import type { ViewHostType } from "./server.js";
+declare class TemplateHelper {
+    renderProduction(data: {
+        hostType: ViewHostType;
+        serverUrl: string;
+        viewFile: string;
+        styleFile: string;
+    }): string;
+    renderDevelopment(data: {
+        hostType: ViewHostType;
+        serverUrl: string;
+        viewName: string;
+    }): string;
+}
+export declare const templateHelper: TemplateHelper;
+export {};

package/dist/server/templateHelper.js

@@ -0,0 +1,11 @@
+import { developmentTemplate, productionTemplate, } from "./templates.generated.js";
+class TemplateHelper {
+    renderProduction(data) {
+        return productionTemplate(data);
+    }
+    renderDevelopment(data) {
+        return developmentTemplate(data);
+    }
+}
+export const templateHelper = new TemplateHelper();
+//# sourceMappingURL=templateHelper.js.map

package/dist/server/templateHelper.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"templateHelper.js","sourceRoot":"","sources":["../../src/server/templateHelper.ts"],"names":[],"mappings":"AACA,OAAO,EACL,mBAAmB,EACnB,kBAAkB,GACnB,MAAM,0BAA0B,CAAC;AAElC,MAAM,cAAc;IAClB,gBAAgB,CAAC,IAKhB;QACC,OAAO,kBAAkB,CAAC,IAAI,CAAC,CAAC;IAClC,CAAC;IAED,iBAAiB,CAAC,IAIjB;QACC,OAAO,mBAAmB,CAAC,IAAI,CAAC,CAAC;IACnC,CAAC;CACF;AAED,MAAM,CAAC,MAAM,cAAc,GAAG,IAAI,cAAc,EAAE,CAAC","sourcesContent":["import type { ViewHostType } from \"./server.js\";\nimport {\n  developmentTemplate,\n  productionTemplate,\n} from \"./templates.generated.js\";\n\nclass TemplateHelper {\n  renderProduction(data: {\n    hostType: ViewHostType;\n    serverUrl: string;\n    viewFile: string;\n    styleFile: string;\n  }): string {\n    return productionTemplate(data);\n  }\n\n  renderDevelopment(data: {\n    hostType: ViewHostType;\n    serverUrl: string;\n    viewName: string;\n  }): string {\n    return developmentTemplate(data);\n  }\n}\n\nexport const templateHelper = new TemplateHelper();\n"]}

package/dist/server/templates.generated.d.ts

@@ -0,0 +1,4 @@
+/** @type {HandlebarsTemplateDelegate} */
+export const developmentTemplate: HandlebarsTemplateDelegate;
+/** @type {HandlebarsTemplateDelegate} */
+export const productionTemplate: HandlebarsTemplateDelegate;