boundlessdb 0.1.0

package/dist/storage/sqlite.js

@@ -0,0 +1,249 @@
+/**
+ * SQLite Storage implementation using better-sqlite3
+ */
+import Database from 'better-sqlite3';
+import { isConstrainedCondition } from '../types.js';
+const SCHEMA = `
+-- Events (Append-Only Log)
+CREATE TABLE IF NOT EXISTS events (
+  position INTEGER PRIMARY KEY AUTOINCREMENT,
+  event_id TEXT NOT NULL UNIQUE,
+  event_type TEXT NOT NULL,
+  data TEXT NOT NULL,
+  metadata TEXT,
+  timestamp TEXT NOT NULL,
+  created_at TEXT DEFAULT CURRENT_TIMESTAMP
+);
+
+-- Consistency Key Index (populated by store on write)
+CREATE TABLE IF NOT EXISTS event_keys (
+  position INTEGER NOT NULL REFERENCES events(position),
+  key_name TEXT NOT NULL,
+  key_value TEXT NOT NULL,
+  PRIMARY KEY (position, key_name, key_value)
+);
+
+-- Metadata (for config hash, etc.)
+CREATE TABLE IF NOT EXISTS metadata (
+  key TEXT PRIMARY KEY,
+  value TEXT NOT NULL
+);
+
+-- Indices for fast queries
+CREATE INDEX IF NOT EXISTS idx_event_type ON events(event_type);
+CREATE INDEX IF NOT EXISTS idx_key ON event_keys(key_name, key_value);
+CREATE INDEX IF NOT EXISTS idx_key_position ON event_keys(key_name, key_value, position);
+`;
+/**
+ * SQLite-backed event storage
+ */
+export class SqliteStorage {
+    db;
+    constructor(path = ':memory:') {
+        this.db = new Database(path);
+        this.db.pragma('journal_mode = WAL');
+        this.db.pragma('foreign_keys = ON');
+        this.db.exec(SCHEMA);
+    }
+    async append(eventsToStore, keys) {
+        if (eventsToStore.length !== keys.length) {
+            throw new Error('Events and keys arrays must have the same length');
+        }
+        if (eventsToStore.length === 0) {
+            return this.getLatestPosition();
+        }
+        const insertEvent = this.db.prepare(`
+      INSERT INTO events (event_id, event_type, data, metadata, timestamp)
+      VALUES (?, ?, ?, ?, ?)
+    `);
+        const insertKey = this.db.prepare(`
+      INSERT INTO event_keys (position, key_name, key_value)
+      VALUES (?, ?, ?)
+    `);
+        let lastPosition = 0n;
+        // Everything in one transaction for atomicity
+        const transaction = this.db.transaction(() => {
+            for (let i = 0; i < eventsToStore.length; i++) {
+                const event = eventsToStore[i];
+                const eventKeys = keys[i];
+                // Insert event
+                const result = insertEvent.run(event.id, event.type, JSON.stringify(event.data), event.metadata ? JSON.stringify(event.metadata) : null, event.timestamp.toISOString());
+                const position = BigInt(result.lastInsertRowid);
+                lastPosition = position;
+                // Insert keys
+                for (const key of eventKeys) {
+                    insertKey.run(Number(position), key.name, key.value);
+                }
+            }
+        });
+        transaction();
+        return lastPosition;
+    }
+    async query(conditions, fromPosition, limit) {
+        if (conditions.length === 0) {
+            // No conditions = return all events
+            let sql = `
+        SELECT position, event_id, event_type, data, metadata, timestamp
+        FROM events
+      `;
+            const params = [];
+            if (fromPosition !== undefined) {
+                sql += ' WHERE position > ?';
+                params.push(Number(fromPosition));
+            }
+            sql += ' ORDER BY position';
+            if (limit !== undefined) {
+                sql += ' LIMIT ?';
+                params.push(limit);
+            }
+            const rows = this.db.prepare(sql).all(...params);
+            return rows.map(row => this.rowToEvent(row));
+        }
+        // Separate conditions: constrained (with key/value) vs unconstrained (type only)
+        const constrained = conditions.filter(isConstrainedCondition);
+        const unconstrained = conditions.filter(c => !isConstrainedCondition(c));
+        const whereClauses = [];
+        const whereParams = [];
+        // Unconstrained: match by type only (no join needed)
+        if (unconstrained.length > 0) {
+            const typePlaceholders = unconstrained.map(() => '?').join(', ');
+            whereClauses.push(`e.event_type IN (${typePlaceholders})`);
+            whereParams.push(...unconstrained.map(c => c.type));
+        }
+        // Constrained: match by type + key + value
+        if (constrained.length > 0) {
+            const constrainedClauses = constrained.map(() => '(e.event_type = ? AND k.key_name = ? AND k.key_value = ?)');
+            whereClauses.push(`(${constrainedClauses.join(' OR ')})`);
+            whereParams.push(...constrained.flatMap(c => [c.type, c.key, c.value]));
+        }
+        // Build SQL
+        let sql;
+        if (constrained.length > 0) {
+            // Need JOIN for constrained conditions
+            sql = `
+        SELECT DISTINCT
+          e.position,
+          e.event_id,
+          e.event_type,
+          e.data,
+          e.metadata,
+          e.timestamp
+        FROM events e
+        LEFT JOIN event_keys k ON e.position = k.position
+        WHERE (${whereClauses.join(' OR ')})
+      `;
+        }
+        else {
+            // No constrained conditions, no JOIN needed
+            sql = `
+        SELECT
+          position,
+          event_id,
+          event_type,
+          data,
+          metadata,
+          timestamp
+        FROM events e
+        WHERE (${whereClauses.join(' OR ')})
+      `;
+        }
+        const params = [...whereParams];
+        if (fromPosition !== undefined) {
+            sql += ' AND e.position > ?';
+            params.push(Number(fromPosition));
+        }
+        sql += ' ORDER BY e.position';
+        if (limit !== undefined) {
+            sql += ' LIMIT ?';
+            params.push(limit);
+        }
+        const stmt = this.db.prepare(sql);
+        const rows = stmt.all(...params);
+        return rows.map(row => this.rowToEvent(row));
+    }
+    async getEventsSince(conditions, sincePosition) {
+        return this.query(conditions, sincePosition);
+    }
+    async getLatestPosition() {
+        const row = this.db.prepare('SELECT MAX(position) as pos FROM events').get();
+        return row.pos ? BigInt(row.pos) : 0n;
+    }
+    async close() {
+        this.db.close();
+    }
+    // --- UI Helper Methods (not part of core DCB API) ---
+    /**
+     * Get all events (for debugging/UI)
+     */
+    getAllEvents() {
+        const rows = this.db.prepare(`
+      SELECT position, event_id, event_type, data, metadata, timestamp
+      FROM events
+      ORDER BY position ASC
+    `).all();
+        return rows.map(row => this.rowToEvent(row));
+    }
+    /**
+     * Get all keys (for debugging/UI)
+     */
+    getAllKeys() {
+        return this.db.prepare(`
+      SELECT position, key_name, key_value
+      FROM event_keys
+      ORDER BY position ASC
+    `).all();
+    }
+    /**
+     * Clear all data (for testing)
+     */
+    clear() {
+        this.db.exec('DELETE FROM event_keys');
+        this.db.exec('DELETE FROM events');
+        this.db.exec("DELETE FROM sqlite_sequence WHERE name IN ('events', 'event_keys')");
+    }
+    // --- Metadata Methods ---
+    /**
+     * Get stored config hash
+     */
+    getConfigHash() {
+        const row = this.db.prepare("SELECT value FROM metadata WHERE key = 'config_hash'").get();
+        return row?.value ?? null;
+    }
+    /**
+     * Set config hash
+     */
+    setConfigHash(hash) {
+        this.db.prepare("INSERT OR REPLACE INTO metadata (key, value) VALUES ('config_hash', ?)").run(hash);
+    }
+    /**
+     * Reindex all events with new keys
+     */
+    reindex(extractKeys) {
+        const events = this.getAllEvents();
+        const deleteKeys = this.db.prepare('DELETE FROM event_keys');
+        const insertKey = this.db.prepare('INSERT INTO event_keys (position, key_name, key_value) VALUES (?, ?, ?)');
+        const transaction = this.db.transaction(() => {
+            // Clear all keys
+            deleteKeys.run();
+            // Re-extract and insert keys for all events
+            for (const event of events) {
+                const keys = extractKeys(event);
+                for (const key of keys) {
+                    insertKey.run(Number(event.position), key.name, key.value);
+                }
+            }
+        });
+        transaction();
+    }
+    rowToEvent(row) {
+        return {
+            id: row.event_id,
+            type: row.event_type,
+            data: JSON.parse(row.data),
+            metadata: row.metadata ? JSON.parse(row.metadata) : undefined,
+            timestamp: new Date(row.timestamp),
+            position: BigInt(row.position),
+        };
+    }
+}
+//# 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/dist/storage/sqljs.d.ts

@@ -0,0 +1,60 @@
+/**
+ * sql.js Storage implementation for browser environments
+ */
+import { type ExtractedKey, type QueryCondition, type StoredEvent } from '../types.js';
+import type { EventStorage, EventToStore } from './interface.js';
+export interface SqlJsStorageOptions {
+    /** URL to load sql.js WASM from (optional, uses CDN by default) */
+    wasmUrl?: string;
+    /** Existing database bytes to restore from */
+    data?: ArrayLike<number>;
+}
+/**
+ * sql.js-backed event storage for browser environments
+ */
+export declare class SqlJsStorage implements EventStorage {
+    private db;
+    private initPromise;
+    constructor(options?: SqlJsStorageOptions);
+    private initialize;
+    private ensureInitialized;
+    append(eventsToStore: EventToStore[], keys: ExtractedKey[][]): Promise<bigint>;
+    query(conditions: QueryCondition[], fromPosition?: bigint, limit?: number): Promise<StoredEvent[]>;
+    getEventsSince(conditions: QueryCondition[], sincePosition: bigint): Promise<StoredEvent[]>;
+    getLatestPosition(): Promise<bigint>;
+    close(): Promise<void>;
+    /**
+     * Get all events (for debugging/UI)
+     */
+    getAllEvents(): Promise<StoredEvent[]>;
+    /**
+     * Get all keys (for debugging/UI)
+     */
+    getAllKeys(): Promise<Array<{
+        position: number;
+        key_name: string;
+        key_value: string;
+    }>>;
+    /**
+     * Clear all data (for testing)
+     */
+    clear(): Promise<void>;
+    /**
+     * Export database as Uint8Array for persistence
+     */
+    export(): Promise<Uint8Array>;
+    /**
+     * Get stored config hash
+     */
+    getConfigHash(): Promise<string | null>;
+    /**
+     * Set config hash
+     */
+    setConfigHash(hash: string): Promise<void>;
+    /**
+     * Reindex all events with new keys
+     */
+    reindex(extractKeys: (event: StoredEvent) => ExtractedKey[]): Promise<void>;
+    private rowToEvent;
+}
+//# sourceMappingURL=sqljs.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"sqljs.d.ts","sourceRoot":"","sources":["../../src/storage/sqljs.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,EAA0B,KAAK,YAAY,EAAE,KAAK,cAAc,EAAE,KAAK,WAAW,EAAE,MAAM,aAAa,CAAC;AAC/G,OAAO,KAAK,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AA4CjE,MAAM,WAAW,mBAAmB;IAClC,mEAAmE;IACnE,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,8CAA8C;IAC9C,IAAI,CAAC,EAAE,SAAS,CAAC,MAAM,CAAC,CAAC;CAC1B;AAED;;GAEG;AACH,qBAAa,YAAa,YAAW,YAAY;IAC/C,OAAO,CAAC,EAAE,CAA8B;IACxC,OAAO,CAAC,WAAW,CAAgB;gBAEvB,OAAO,GAAE,mBAAwB;YAI/B,UAAU;YAkBV,iBAAiB;IAQzB,MAAM,CAAC,aAAa,EAAE,YAAY,EAAE,EAAE,IAAI,EAAE,YAAY,EAAE,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC;IAgE9E,KAAK,CACT,UAAU,EAAE,cAAc,EAAE,EAC5B,YAAY,CAAC,EAAE,MAAM,EACrB,KAAK,CAAC,EAAE,MAAM,GACb,OAAO,CAAC,WAAW,EAAE,CAAC;IAmHnB,cAAc,CAClB,UAAU,EAAE,cAAc,EAAE,EAC5B,aAAa,EAAE,MAAM,GACpB,OAAO,CAAC,WAAW,EAAE,CAAC;IAInB,iBAAiB,IAAI,OAAO,CAAC,MAAM,CAAC;IASpC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAQ5B;;OAEG;IACG,YAAY,IAAI,OAAO,CAAC,WAAW,EAAE,CAAC;IAyB5C;;OAEG;IACG,UAAU,IAAI,OAAO,CAAC,KAAK,CAAC;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAiB7F;;OAEG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAO5B;;OAEG;IACG,MAAM,IAAI,OAAO,CAAC,UAAU,CAAC;IAOnC;;OAEG;IACG,aAAa,IAAI,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAS7C;;OAEG;IACG,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAahD;;OAEG;IACG,OAAO,CAAC,WAAW,EAAE,CAAC,KAAK,EAAE,WAAW,KAAK,YAAY,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IA4BjF,OAAO,CAAC,UAAU;CAUnB"}

package/dist/storage/sqljs.js

@@ -0,0 +1,354 @@
+/**
+ * sql.js Storage implementation for browser environments
+ */
+import initSqlJs from 'sql.js';
+import { isConstrainedCondition } from '../types.js';
+const SCHEMA = `
+-- Events (Append-Only Log)
+CREATE TABLE IF NOT EXISTS events (
+  position INTEGER PRIMARY KEY AUTOINCREMENT,
+  event_id TEXT NOT NULL UNIQUE,
+  event_type TEXT NOT NULL,
+  data TEXT NOT NULL,
+  metadata TEXT,
+  timestamp TEXT NOT NULL,
+  created_at TEXT DEFAULT CURRENT_TIMESTAMP
+);
+
+-- Consistency Key Index (populated by store on write)
+CREATE TABLE IF NOT EXISTS event_keys (
+  position INTEGER NOT NULL,
+  key_name TEXT NOT NULL,
+  key_value TEXT NOT NULL,
+  PRIMARY KEY (position, key_name, key_value),
+  FOREIGN KEY (position) REFERENCES events(position)
+);
+
+-- Metadata (for config hash, etc.)
+CREATE TABLE IF NOT EXISTS metadata (
+  key TEXT PRIMARY KEY,
+  value TEXT NOT NULL
+);
+
+-- Indices for fast queries
+CREATE INDEX IF NOT EXISTS idx_event_type ON events(event_type);
+CREATE INDEX IF NOT EXISTS idx_key ON event_keys(key_name, key_value);
+CREATE INDEX IF NOT EXISTS idx_key_position ON event_keys(key_name, key_value, position);
+`;
+/**
+ * sql.js-backed event storage for browser environments
+ */
+export class SqlJsStorage {
+    db = null;
+    initPromise;
+    constructor(options = {}) {
+        this.initPromise = this.initialize(options);
+    }
+    async initialize(options) {
+        const SQL = await initSqlJs({
+            locateFile: (file) => {
+                if (options.wasmUrl)
+                    return options.wasmUrl;
+                // Use CDN by default
+                return `https://sql.js.org/dist/${file}`;
+            }
+        });
+        if (options.data) {
+            this.db = new SQL.Database(new Uint8Array(options.data));
+        }
+        else {
+            this.db = new SQL.Database();
+        }
+        this.db.run(SCHEMA);
+    }
+    async ensureInitialized() {
+        await this.initPromise;
+        if (!this.db) {
+            throw new Error('Database not initialized');
+        }
+        return this.db;
+    }
+    async append(eventsToStore, keys) {
+        const db = await this.ensureInitialized();
+        if (eventsToStore.length !== keys.length) {
+            throw new Error('Events and keys arrays must have the same length');
+        }
+        if (eventsToStore.length === 0) {
+            return this.getLatestPosition();
+        }
+        let lastPosition = 0n;
+        // sql.js doesn't have built-in transactions, but we can use BEGIN/COMMIT
+        db.run('BEGIN TRANSACTION');
+        try {
+            // sql.js db.run() doesn't support params properly - use escaped SQL
+            const escapeSql = (s) => {
+                if (s === null)
+                    return 'NULL';
+                return "'" + s.replace(/'/g, "''") + "'";
+            };
+            for (let i = 0; i < eventsToStore.length; i++) {
+                const event = eventsToStore[i];
+                const eventKeys = keys[i];
+                // Insert event
+                const eventId = String(event.id);
+                const eventType = String(event.type);
+                const eventData = JSON.stringify(event.data);
+                const eventMeta = event.metadata ? JSON.stringify(event.metadata) : null;
+                const eventTime = event.timestamp.toISOString();
+                if (!eventId || eventId === 'undefined' || eventId === 'null') {
+                    throw new Error(`[SqlJsStorage] Invalid event ID: "${eventId}"`);
+                }
+                const sql = `INSERT INTO events (event_id, event_type, data, metadata, timestamp)
+           VALUES (${escapeSql(eventId)}, ${escapeSql(eventType)}, ${escapeSql(eventData)}, ${eventMeta === null ? 'NULL' : escapeSql(eventMeta)}, ${escapeSql(eventTime)})`;
+                db.run(sql);
+                // Get the last inserted position
+                const result = db.exec('SELECT last_insert_rowid() as position');
+                const position = BigInt(result[0].values[0][0]);
+                lastPosition = position;
+                // Insert keys
+                for (const key of eventKeys) {
+                    const keySql = `INSERT INTO event_keys (position, key_name, key_value) VALUES (${Number(position)}, ${escapeSql(key.name)}, ${escapeSql(key.value)})`;
+                    db.run(keySql);
+                }
+            }
+            db.run('COMMIT');
+        }
+        catch (error) {
+            db.run('ROLLBACK');
+            throw error;
+        }
+        return lastPosition;
+    }
+    async query(conditions, fromPosition, limit) {
+        const db = await this.ensureInitialized();
+        // sql.js doesn't support params properly - use escaped SQL
+        const escapeSql = (s) => "'" + s.replace(/'/g, "''") + "'";
+        if (conditions.length === 0) {
+            // No conditions = return all events
+            let sql = `
+        SELECT position, event_id, event_type, data, metadata, timestamp
+        FROM events
+      `;
+            if (fromPosition !== undefined) {
+                sql += ` WHERE position > ${Number(fromPosition)}`;
+            }
+            sql += ' ORDER BY position';
+            if (limit !== undefined) {
+                sql += ` LIMIT ${Number(limit)}`;
+            }
+            const result = db.exec(sql);
+            if (result.length === 0)
+                return [];
+            const columns = result[0].columns || result[0].lc;
+            const rows = result[0].values;
+            return rows.map((row) => {
+                const obj = {};
+                columns.forEach((col, i) => {
+                    obj[col] = row[i];
+                });
+                return this.rowToEvent(obj);
+            });
+        }
+        // Separate conditions: constrained (with key/value) vs unconstrained (type only)
+        const constrained = conditions.filter(isConstrainedCondition);
+        const unconstrained = conditions.filter(c => !isConstrainedCondition(c));
+        const whereClauses = [];
+        // Unconstrained: match by type only
+        if (unconstrained.length > 0) {
+            const typeList = unconstrained.map(c => escapeSql(c.type)).join(', ');
+            whereClauses.push(`e.event_type IN (${typeList})`);
+        }
+        // Constrained: match by type + key + value
+        if (constrained.length > 0) {
+            const constrainedClauses = constrained.map(c => `(e.event_type = ${escapeSql(c.type)} AND k.key_name = ${escapeSql(c.key)} AND k.key_value = ${escapeSql(c.value)})`);
+            whereClauses.push(`(${constrainedClauses.join(' OR ')})`);
+        }
+        // Build SQL
+        let sql;
+        if (constrained.length > 0) {
+            // Need JOIN for constrained conditions
+            sql = `
+        SELECT DISTINCT
+          e.position,
+          e.event_id,
+          e.event_type,
+          e.data,
+          e.metadata,
+          e.timestamp
+        FROM events e
+        LEFT JOIN event_keys k ON e.position = k.position
+        WHERE (${whereClauses.join(' OR ')})
+      `;
+        }
+        else {
+            // No constrained conditions, no JOIN needed
+            sql = `
+        SELECT
+          position,
+          event_id,
+          event_type,
+          data,
+          metadata,
+          timestamp
+        FROM events e
+        WHERE (${whereClauses.join(' OR ')})
+      `;
+        }
+        if (fromPosition !== undefined) {
+            sql += ` AND e.position > ${Number(fromPosition)}`;
+        }
+        sql += ' ORDER BY e.position';
+        if (limit !== undefined) {
+            sql += ` LIMIT ${Number(limit)}`;
+        }
+        const result = db.exec(sql);
+        if (result.length === 0)
+            return [];
+        // sql.js uses 'columns' or 'lc' depending on version
+        const columns = result[0].columns || result[0].lc;
+        const rows = result[0].values;
+        return rows.map((row) => {
+            const obj = {};
+            columns.forEach((col, i) => {
+                obj[col] = row[i];
+            });
+            return this.rowToEvent(obj);
+        });
+    }
+    async getEventsSince(conditions, sincePosition) {
+        return this.query(conditions, sincePosition);
+    }
+    async getLatestPosition() {
+        const db = await this.ensureInitialized();
+        const result = db.exec('SELECT MAX(position) as pos FROM events');
+        if (result.length === 0 || result[0].values[0][0] === null) {
+            return 0n;
+        }
+        return BigInt(result[0].values[0][0]);
+    }
+    async close() {
+        const db = await this.ensureInitialized();
+        db.close();
+        this.db = null;
+    }
+    // --- UI Helper Methods (not part of core DCB API) ---
+    /**
+     * Get all events (for debugging/UI)
+     */
+    async getAllEvents() {
+        const db = await this.ensureInitialized();
+        const result = db.exec(`
+      SELECT position, event_id, event_type, data, metadata, timestamp
+      FROM events
+      ORDER BY position ASC
+    `);
+        if (result.length === 0) {
+            return [];
+        }
+        // sql.js uses 'columns' or 'lc' depending on version
+        const columns = result[0].columns || result[0].lc;
+        const rows = result[0].values;
+        return rows.map((row) => {
+            const obj = {};
+            columns.forEach((col, i) => {
+                obj[col] = row[i];
+            });
+            return this.rowToEvent(obj);
+        });
+    }
+    /**
+     * Get all keys (for debugging/UI)
+     */
+    async getAllKeys() {
+        const db = await this.ensureInitialized();
+        const result = db.exec(`
+      SELECT position, key_name, key_value
+      FROM event_keys
+      ORDER BY position ASC
+    `);
+        if (result.length === 0)
+            return [];
+        return result[0].values.map((row) => ({
+            position: row[0],
+            key_name: row[1],
+            key_value: row[2]
+        }));
+    }
+    /**
+     * Clear all data (for testing)
+     */
+    async clear() {
+        const db = await this.ensureInitialized();
+        db.run('DELETE FROM event_keys');
+        db.run('DELETE FROM events');
+        db.run("DELETE FROM sqlite_sequence WHERE name IN ('events', 'event_keys')");
+    }
+    /**
+     * Export database as Uint8Array for persistence
+     */
+    async export() {
+        const db = await this.ensureInitialized();
+        return db.export();
+    }
+    // --- Metadata Methods ---
+    /**
+     * Get stored config hash
+     */
+    async getConfigHash() {
+        const db = await this.ensureInitialized();
+        const result = db.exec("SELECT value FROM metadata WHERE key = 'config_hash'");
+        if (result.length === 0 || result[0].values.length === 0) {
+            return null;
+        }
+        return result[0].values[0][0];
+    }
+    /**
+     * Set config hash
+     */
+    async setConfigHash(hash) {
+        if (!hash) {
+            console.warn('[SqlJsStorage] setConfigHash called with empty hash, skipping');
+            return;
+        }
+        const db = await this.ensureInitialized();
+        // sql.js ignores params - use escaped SQL
+        const escapedHash = hash.replace(/'/g, "''");
+        db.run(`INSERT OR REPLACE INTO metadata (key, value) VALUES ('config_hash', '${escapedHash}')`);
+    }
+    /**
+     * Reindex all events with new keys
+     */
+    async reindex(extractKeys) {
+        const db = await this.ensureInitialized();
+        const events = await this.getAllEvents();
+        db.run('BEGIN TRANSACTION');
+        try {
+            // Clear all keys
+            db.run('DELETE FROM event_keys');
+            // Re-extract and insert keys for all events
+            const escapeSql = (s) => "'" + s.replace(/'/g, "''") + "'";
+            for (const event of events) {
+                const keys = extractKeys(event);
+                for (const key of keys) {
+                    db.run(`INSERT INTO event_keys (position, key_name, key_value) VALUES (${Number(event.position)}, ${escapeSql(key.name)}, ${escapeSql(key.value)})`);
+                }
+            }
+            db.run('COMMIT');
+        }
+        catch (error) {
+            db.run('ROLLBACK');
+            throw error;
+        }
+    }
+    rowToEvent(row) {
+        return {
+            id: row.event_id,
+            type: row.event_type,
+            data: JSON.parse(row.data),
+            metadata: row.metadata ? JSON.parse(row.metadata) : undefined,
+            timestamp: new Date(row.timestamp),
+            position: BigInt(row.position),
+        };
+    }
+}
+//# sourceMappingURL=sqljs.js.map