@better-state/server 0.1.0 → 0.2.0

package/dist/storage/adapter.d.ts

@@ -0,0 +1,102 @@
+/**
+ * StorageAdapter — the contract any persistence backend must implement.
+ *
+ * SQLite ships with the MVP. To add Postgres, Redis, or any other backend,
+ * implement this interface and pass it to the server at boot.
+ *
+ * All methods are synchronous today (SQLite is sync). When a Postgres adapter
+ * is added, this interface can be migrated to async — the surface is small
+ * enough that the change is mechanical.
+ */
+export interface NamespaceRecord {
+    id: string;
+    name: string;
+    api_key: string;
+    created_at: number;
+}
+export interface StateRecord {
+    id: string;
+    namespace: string;
+    key: string;
+    initial: string;
+    snapshot: string;
+    version: number;
+    created_at: number;
+    updated_at: number;
+}
+export interface EventRecord {
+    id: string;
+    state_id: string;
+    client_id: string;
+    client_ts: number;
+    server_ts: number;
+    seq: number;
+    mutation: string;
+    meta: string | null;
+    created_at: number;
+}
+export interface EventInput {
+    id: string;
+    stateId: string;
+    clientId: string;
+    clientTs: number;
+    serverTs: number;
+    seq: number;
+    mutation: string;
+    meta: string | null;
+}
+export interface StorageAdapter {
+    /** Run migrations / create tables. Called once at boot. */
+    init(): void;
+    /** Clean shutdown (close connections, etc.) */
+    close(): void;
+    /** List all namespaces (api_key excluded from result for safety). */
+    listNamespaces(): Pick<NamespaceRecord, "id" | "name" | "created_at">[];
+    /** Find a namespace by its hashed API key. Returns just the id, or null. */
+    findNamespaceByApiKey(apiKeyHash: string): {
+        id: string;
+    } | null;
+    /** Find a namespace by name. Returns the full record, or null. */
+    findNamespaceByName(name: string): NamespaceRecord | null;
+    /** Insert a new namespace. */
+    createNamespace(ns: NamespaceRecord): void;
+    /** Find a state by (namespace, key). */
+    findState(namespace: string, key: string): StateRecord | null;
+    /** Find a state by primary key. */
+    findStateById(id: string): StateRecord | null;
+    /** List states for a namespace (snapshot included). */
+    listStates(namespace: string): StateRecord[];
+    /** Insert a new state row. */
+    createState(state: StateRecord): void;
+    /** Update the snapshot, version, and updated_at for a state. */
+    updateSnapshot(stateId: string, snapshot: string, version: number, updatedAt: number): void;
+    /** Get the current max sequence number for a state. null if no events. */
+    getMaxSeq(stateId: string): number | null;
+    /** Insert a batch of events atomically (single transaction). */
+    insertEvents(events: EventInput[]): void;
+    /** Get all events for replay: just mutation + meta, ordered by (server_ts, seq). */
+    getEventsForReplay(stateId: string): {
+        mutation: string;
+        meta: string | null;
+    }[];
+    /** Get paginated event history (full records). */
+    getEventHistory(stateId: string, limit: number, cursor?: string): {
+        events: EventRecord[];
+        hasMore: boolean;
+    };
+    /** Counts for the studio overview. */
+    getStats(): {
+        namespaces: number;
+        states: number;
+        events: number;
+    };
+    /** All states with their namespace name, ordered by last updated. */
+    listAllStatesWithNamespace(): (StateRecord & {
+        namespace_name: string;
+    })[];
+    /** Recent events across all states, with state key attached. */
+    getRecentEvents(limit: number): (EventRecord & {
+        state_key: string;
+    })[];
+}
+//# sourceMappingURL=adapter.d.ts.map

package/dist/storage/adapter.d.ts.map

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

package/dist/storage/adapter.js

@@ -0,0 +1,12 @@
+/**
+ * StorageAdapter — the contract any persistence backend must implement.
+ *
+ * SQLite ships with the MVP. To add Postgres, Redis, or any other backend,
+ * implement this interface and pass it to the server at boot.
+ *
+ * All methods are synchronous today (SQLite is sync). When a Postgres adapter
+ * is added, this interface can be migrated to async — the surface is small
+ * enough that the change is mechanical.
+ */
+export {};
+//# sourceMappingURL=adapter.js.map

package/dist/storage/adapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapter.js","sourceRoot":"","sources":["../../src/storage/adapter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG"}

package/dist/storage/index.d.ts

@@ -0,0 +1,4 @@
+export type { StorageAdapter, NamespaceRecord, StateRecord, EventRecord, EventInput, } from "./adapter.js";
+export { SqliteAdapter } from "./sqlite.js";
+export type { SqliteOptions } from "./sqlite.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/storage/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/storage/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,cAAc,EACd,eAAe,EACf,WAAW,EACX,WAAW,EACX,UAAU,GACX,MAAM,cAAc,CAAC;AAEtB,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,YAAY,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC"}

package/dist/storage/index.js

@@ -0,0 +1,2 @@
+export { SqliteAdapter } from "./sqlite.js";
+//# sourceMappingURL=index.js.map

package/dist/storage/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/storage/index.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC"}

package/dist/storage/sqlite.d.ts

@@ -0,0 +1,49 @@
+import Database from "better-sqlite3";
+import type { StorageAdapter, NamespaceRecord, StateRecord, EventRecord, EventInput } from "./adapter.js";
+export interface SqliteOptions {
+    /** Path to the .db file. Defaults to process.env.DATABASE_PATH or ./data/state.db */
+    dbPath?: string;
+    /** If true, uses an in-memory database (useful for tests). */
+    memory?: boolean;
+}
+export declare class SqliteAdapter implements StorageAdapter {
+    private db;
+    constructor(opts?: SqliteOptions);
+    /** Expose the raw database for edge cases (tests, legacy code). */
+    get raw(): Database.Database;
+    init(): void;
+    close(): void;
+    listNamespaces(): Pick<NamespaceRecord, "id" | "name" | "created_at">[];
+    findNamespaceByApiKey(apiKeyHash: string): {
+        id: string;
+    } | null;
+    findNamespaceByName(name: string): NamespaceRecord | null;
+    createNamespace(ns: NamespaceRecord): void;
+    findState(namespace: string, key: string): StateRecord | null;
+    findStateById(id: string): StateRecord | null;
+    listStates(namespace: string): StateRecord[];
+    createState(state: StateRecord): void;
+    updateSnapshot(stateId: string, snapshot: string, version: number, updatedAt: number): void;
+    getMaxSeq(stateId: string): number | null;
+    insertEvents(events: EventInput[]): void;
+    getEventsForReplay(stateId: string): {
+        mutation: string;
+        meta: string | null;
+    }[];
+    getEventHistory(stateId: string, limit: number, cursor?: string): {
+        events: EventRecord[];
+        hasMore: boolean;
+    };
+    getStats(): {
+        namespaces: number;
+        states: number;
+        events: number;
+    };
+    listAllStatesWithNamespace(): (StateRecord & {
+        namespace_name: string;
+    })[];
+    getRecentEvents(limit: number): (EventRecord & {
+        state_key: string;
+    })[];
+}
+//# sourceMappingURL=sqlite.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"sqlite.d.ts","sourceRoot":"","sources":["../../src/storage/sqlite.ts"],"names":[],"mappings":"AAAA,OAAO,QAAQ,MAAM,gBAAgB,CAAC;AAGtC,OAAO,KAAK,EACV,cAAc,EACd,eAAe,EACf,WAAW,EACX,WAAW,EACX,UAAU,EACX,MAAM,cAAc,CAAC;AAEtB,MAAM,WAAW,aAAa;IAC5B,qFAAqF;IACrF,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,8DAA8D;IAC9D,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED,qBAAa,aAAc,YAAW,cAAc;IAClD,OAAO,CAAC,EAAE,CAAoB;gBAElB,IAAI,GAAE,aAAkB;IAepC,mEAAmE;IACnE,IAAI,GAAG,IAAI,QAAQ,CAAC,QAAQ,CAE3B;IAID,IAAI,IAAI,IAAI;IAyCZ,KAAK,IAAI,IAAI;IAMb,cAAc,IAAI,IAAI,CAAC,eAAe,EAAE,IAAI,GAAG,MAAM,GAAG,YAAY,CAAC,EAAE;IAMvE,qBAAqB,CAAC,UAAU,EAAE,MAAM,GAAG;QAAE,EAAE,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI;IAQhE,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,eAAe,GAAG,IAAI;IAQzD,eAAe,CAAC,EAAE,EAAE,eAAe,GAAG,IAAI;IAU1C,SAAS,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,WAAW,GAAG,IAAI;IAQ7D,aAAa,CAAC,EAAE,EAAE,MAAM,GAAG,WAAW,GAAG,IAAI;IAQ7C,UAAU,CAAC,SAAS,EAAE,MAAM,GAAG,WAAW,EAAE;IAQ5C,WAAW,CAAC,KAAK,EAAE,WAAW,GAAG,IAAI;IAkBrC,cAAc,CACZ,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,MAAM,GAChB,IAAI;IAUP,SAAS,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;IAOzC,YAAY,CAAC,MAAM,EAAE,UAAU,EAAE,GAAG,IAAI;IAyBxC,kBAAkB,CAChB,OAAO,EAAE,MAAM,GACd;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE,EAAE;IAQ9C,eAAe,CACb,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,MAAM,EACb,MAAM,CAAC,EAAE,MAAM,GACd;QAAE,MAAM,EAAE,WAAW,EAAE,CAAC;QAAC,OAAO,EAAE,OAAO,CAAA;KAAE;IA8B9C,QAAQ,IAAI;QAAE,UAAU,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE;IAalE,0BAA0B,IAAI,CAAC,WAAW,GAAG;QAAE,cAAc,EAAE,MAAM,CAAA;KAAE,CAAC,EAAE;IAW1E,eAAe,CACb,KAAK,EAAE,MAAM,GACZ,CAAC,WAAW,GAAG;QAAE,SAAS,EAAE,MAAM,CAAA;KAAE,CAAC,EAAE;CAY3C"}

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 ───────────────────────────────────────────────────────────
+    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);
+    `);
+    }
+    close() {
+        this.db.close();
+    }
+    // ── Namespaces ──────────────────────────────────────────────────────────
+    listNamespaces() {
+        return this.db
+            .prepare("SELECT id, name, created_at FROM namespaces")
+            .all();
+    }
+    findNamespaceByApiKey(apiKeyHash) {
+        return (this.db
+            .prepare("SELECT id FROM namespaces WHERE api_key = ?")
+            .get(apiKeyHash) ?? null);
+    }
+    findNamespaceByName(name) {
+        return (this.db
+            .prepare("SELECT * FROM namespaces WHERE name = ?")
+            .get(name) ?? null);
+    }
+    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 ──────────────────────────────────────────────────────────────
+    findState(namespace, key) {
+        return (this.db
+            .prepare("SELECT * FROM states WHERE namespace = ? AND key = ?")
+            .get(namespace, key) ?? null);
+    }
+    findStateById(id) {
+        return (this.db
+            .prepare("SELECT * FROM states WHERE id = ?")
+            .get(id) ?? null);
+    }
+    listStates(namespace) {
+        return this.db
+            .prepare("SELECT id, key, snapshot, version, created_at, updated_at FROM states WHERE namespace = ?")
+            .all(namespace);
+    }
+    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);
+    }
+    updateSnapshot(stateId, snapshot, version, updatedAt) {
+        this.db
+            .prepare("UPDATE states SET snapshot = ?, version = ?, updated_at = ? WHERE id = ?")
+            .run(snapshot, version, updatedAt, stateId);
+    }
+    // ── Event Log ───────────────────────────────────────────────────────────
+    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;
+    }
+    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();
+    }
+    getEventsForReplay(stateId) {
+        return this.db
+            .prepare("SELECT mutation, meta FROM event_log WHERE state_id = ? ORDER BY server_ts ASC, seq ASC")
+            .all(stateId);
+    }
+    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 ──────────────────────────────────────────────────────────────
+    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 };
+    }
+    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();
+    }
+    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.0",
+  "version": "0.2.0",
   "description": "Better-State server — shared state primitive for developers",
   "type": "module",
   "bin": {