@better-state/server 0.1.1 → 0.3.0

package/dist/storage/sqlite.js

@@ -0,0 +1,192 @@
+import Database from "better-sqlite3";
+import { mkdirSync } from "node:fs";
+import path from "node:path";
+export class SqliteAdapter {
+    db;
+    constructor(opts = {}) {
+        if (opts.memory) {
+            this.db = new Database(":memory:");
+        }
+        else {
+            const dbPath = opts.dbPath ||
+                process.env.DATABASE_PATH ||
+                path.join(process.cwd(), "data", "state.db");
+            mkdirSync(path.dirname(dbPath), { recursive: true });
+            this.db = new Database(dbPath);
+        }
+        this.db.pragma("journal_mode = WAL");
+        this.db.pragma("foreign_keys = ON");
+    }
+    /** Expose the raw database for edge cases (tests, legacy code). */
+    get raw() {
+        return this.db;
+    }
+    // ── Lifecycle ───────────────────────────────────────────────────────────
+    async init() {
+        this.db.exec(`
+      CREATE TABLE IF NOT EXISTS namespaces (
+        id          TEXT PRIMARY KEY,
+        name        TEXT NOT NULL,
+        api_key     TEXT NOT NULL UNIQUE,
+        created_at  INTEGER NOT NULL
+      );
+
+      CREATE TABLE IF NOT EXISTS states (
+        id          TEXT PRIMARY KEY,
+        namespace   TEXT NOT NULL REFERENCES namespaces(id),
+        key         TEXT NOT NULL,
+        initial     TEXT NOT NULL,
+        snapshot    TEXT NOT NULL,
+        version     INTEGER NOT NULL DEFAULT 0,
+        created_at  INTEGER NOT NULL,
+        updated_at  INTEGER NOT NULL,
+        UNIQUE(namespace, key)
+      );
+
+      CREATE TABLE IF NOT EXISTS event_log (
+        id          TEXT PRIMARY KEY,
+        state_id    TEXT NOT NULL REFERENCES states(id),
+        client_id   TEXT NOT NULL,
+        client_ts   INTEGER NOT NULL,
+        server_ts   INTEGER NOT NULL,
+        seq         INTEGER NOT NULL,
+        mutation    TEXT NOT NULL,
+        meta        TEXT,
+        created_at  INTEGER NOT NULL
+      );
+
+      CREATE INDEX IF NOT EXISTS idx_event_log_state_ts
+        ON event_log(state_id, server_ts, seq);
+
+      CREATE INDEX IF NOT EXISTS idx_states_namespace_key
+        ON states(namespace, key);
+    `);
+    }
+    async close() {
+        this.db.close();
+    }
+    // ── Namespaces ──────────────────────────────────────────────────────────
+    async listNamespaces() {
+        return this.db
+            .prepare("SELECT id, name, created_at FROM namespaces")
+            .all();
+    }
+    async findNamespaceByApiKey(apiKeyHash) {
+        return (this.db
+            .prepare("SELECT id FROM namespaces WHERE api_key = ?")
+            .get(apiKeyHash) ?? null);
+    }
+    async findNamespaceByName(name) {
+        return (this.db
+            .prepare("SELECT * FROM namespaces WHERE name = ?")
+            .get(name) ?? null);
+    }
+    async createNamespace(ns) {
+        this.db
+            .prepare("INSERT INTO namespaces (id, name, api_key, created_at) VALUES (?, ?, ?, ?)")
+            .run(ns.id, ns.name, ns.api_key, ns.created_at);
+    }
+    // ── States ──────────────────────────────────────────────────────────────
+    async findState(namespace, key) {
+        return (this.db
+            .prepare("SELECT * FROM states WHERE namespace = ? AND key = ?")
+            .get(namespace, key) ?? null);
+    }
+    async findStateById(id) {
+        return (this.db
+            .prepare("SELECT * FROM states WHERE id = ?")
+            .get(id) ?? null);
+    }
+    async listStates(namespace) {
+        return this.db
+            .prepare("SELECT id, key, snapshot, version, created_at, updated_at FROM states WHERE namespace = ?")
+            .all(namespace);
+    }
+    async createState(state) {
+        this.db
+            .prepare(`INSERT INTO states (id, namespace, key, initial, snapshot, version, created_at, updated_at)
+         VALUES (?, ?, ?, ?, ?, ?, ?, ?)`)
+            .run(state.id, state.namespace, state.key, state.initial, state.snapshot, state.version, state.created_at, state.updated_at);
+    }
+    async updateSnapshot(stateId, snapshot, version, updatedAt) {
+        this.db
+            .prepare("UPDATE states SET snapshot = ?, version = ?, updated_at = ? WHERE id = ?")
+            .run(snapshot, version, updatedAt, stateId);
+    }
+    // ── Event Log ───────────────────────────────────────────────────────────
+    async getMaxSeq(stateId) {
+        const row = this.db
+            .prepare("SELECT MAX(seq) as max_seq FROM event_log WHERE state_id = ?")
+            .get(stateId);
+        return row.max_seq;
+    }
+    async insertEvents(events) {
+        const insert = this.db.prepare(`INSERT INTO event_log (id, state_id, client_id, client_ts, server_ts, seq, mutation, meta, created_at)
+       VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?)`);
+        const batch = this.db.transaction(() => {
+            for (const e of events) {
+                insert.run(e.id, e.stateId, e.clientId, e.clientTs, e.serverTs, e.seq, e.mutation, e.meta, e.serverTs);
+            }
+        });
+        batch();
+    }
+    async getEventsForReplay(stateId) {
+        return this.db
+            .prepare("SELECT mutation, meta FROM event_log WHERE state_id = ? ORDER BY server_ts ASC, seq ASC")
+            .all(stateId);
+    }
+    async getEventHistory(stateId, limit, cursor) {
+        let events;
+        if (cursor) {
+            events = this.db
+                .prepare(`SELECT * FROM event_log
+           WHERE state_id = ? AND (server_ts, seq) > (
+             SELECT server_ts, seq FROM event_log WHERE id = ?
+           )
+           ORDER BY server_ts ASC, seq ASC
+           LIMIT ?`)
+                .all(stateId, cursor, limit + 1);
+        }
+        else {
+            events = this.db
+                .prepare("SELECT * FROM event_log WHERE state_id = ? ORDER BY server_ts ASC, seq ASC LIMIT ?")
+                .all(stateId, limit + 1);
+        }
+        const hasMore = events.length > limit;
+        if (hasMore)
+            events.pop();
+        return { events, hasMore };
+    }
+    // ── Studio ──────────────────────────────────────────────────────────────
+    async getStats() {
+        const ns = this.db
+            .prepare("SELECT COUNT(*) as count FROM namespaces")
+            .get();
+        const st = this.db
+            .prepare("SELECT COUNT(*) as count FROM states")
+            .get();
+        const ev = this.db
+            .prepare("SELECT COUNT(*) as count FROM event_log")
+            .get();
+        return { namespaces: ns.count, states: st.count, events: ev.count };
+    }
+    async listAllStatesWithNamespace() {
+        return this.db
+            .prepare(`SELECT s.id, s.namespace, s.key, s.snapshot, s.version, s.created_at, s.updated_at, n.name as namespace_name
+         FROM states s
+         JOIN namespaces n ON s.namespace = n.id
+         ORDER BY s.updated_at DESC`)
+            .all();
+    }
+    async getRecentEvents(limit) {
+        const rows = this.db
+            .prepare(`SELECT e.id, e.state_id, e.client_id, e.client_ts, e.server_ts, e.mutation, e.meta, s.key as state_key
+         FROM event_log e
+         JOIN states s ON e.state_id = s.id
+         ORDER BY e.server_ts DESC, e.seq DESC
+         LIMIT ?`)
+            .all(limit);
+        return rows.reverse();
+    }
+}
+//# sourceMappingURL=sqlite.js.map

package/dist/storage/sqlite.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@better-state/server",
-  "version": "0.1.1",
+  "version": "0.3.0",
   "description": "Better-State server — shared state primitive for developers",
   "type": "module",
   "bin": {
@@ -46,6 +46,7 @@
     "@types/better-sqlite3": "^7.6.0",
     "@types/cors": "^2.8.0",
     "@types/express": "^5.0.0",
+    "@types/pg": "^8.16.0",
     "@types/uuid": "^10.0.0",
     "socket.io-client": "^4.8.3",
     "tsx": "^4.19.0",