boundlessdb 0.1.0

package/dist/storage/postgres.d.ts

@@ -0,0 +1,76 @@
+/**
+ * PostgreSQL Storage implementation using pg
+ */
+import { type PoolConfig } from 'pg';
+import { type ExtractedKey, type QueryCondition, type StoredEvent } from '../types.js';
+import type { EventStorage, EventToStore } from './interface.js';
+/**
+ * PostgreSQL-backed event storage
+ *
+ * Uses connection pooling for efficient database access.
+ * Supports both connection strings and pool configuration objects.
+ *
+ * @example
+ * ```typescript
+ * // Using connection string
+ * const storage = new PostgresStorage('postgresql://user:pass@localhost/db');
+ * await storage.init();
+ *
+ * // Using pool config
+ * const storage = new PostgresStorage({
+ *   host: 'localhost',
+ *   port: 5432,
+ *   database: 'mydb',
+ *   user: 'myuser',
+ *   password: 'mypass',
+ *   max: 20, // max pool size
+ * });
+ * await storage.init();
+ * ```
+ */
+export declare class PostgresStorage implements EventStorage {
+    private pool;
+    private initialized;
+    constructor(connectionStringOrConfig: string | PoolConfig);
+    /**
+     * Initialize the database schema.
+     * Must be called before any other operations.
+     */
+    init(): Promise<void>;
+    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: bigint;
+        key_name: string;
+        key_value: string;
+    }>>;
+    /**
+     * Clear all data (for testing)
+     */
+    clear(): Promise<void>;
+    /**
+     * 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=postgres.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"postgres.d.ts","sourceRoot":"","sources":["../../src/storage/postgres.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAoB,KAAK,UAAU,EAAE,MAAM,IAAI,CAAC;AACvD,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;AA2CjE;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,qBAAa,eAAgB,YAAW,YAAY;IAClD,OAAO,CAAC,IAAI,CAAO;IACnB,OAAO,CAAC,WAAW,CAAS;gBAEhB,wBAAwB,EAAE,MAAM,GAAG,UAAU;IAQzD;;;OAGG;IACG,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAY3B,OAAO,CAAC,iBAAiB;IAMnB,MAAM,CAAC,aAAa,EAAE,YAAY,EAAE,EAAE,IAAI,EAAE,YAAY,EAAE,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC;IA0D9E,KAAK,CACT,UAAU,EAAE,cAAc,EAAE,EAC5B,YAAY,CAAC,EAAE,MAAM,EACrB,KAAK,CAAC,EAAE,MAAM,GACb,OAAO,CAAC,WAAW,EAAE,CAAC;IA0GnB,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;IAM5B;;OAEG;IACG,YAAY,IAAI,OAAO,CAAC,WAAW,EAAE,CAAC;IAY5C;;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;IAgB7F;;OAEG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAqB5B;;OAEG;IACG,aAAa,IAAI,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAS7C;;OAEG;IACG,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAUhD;;OAEG;IACG,OAAO,CAAC,WAAW,EAAE,CAAC,KAAK,EAAE,WAAW,KAAK,YAAY,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAgCjF,OAAO,CAAC,UAAU;CAUnB"}

package/dist/storage/postgres.js

@@ -0,0 +1,346 @@
+/**
+ * PostgreSQL Storage implementation using pg
+ */
+import { Pool } from 'pg';
+import { isConstrainedCondition } from '../types.js';
+const SCHEMA = `
+-- Events (Append-Only Log)
+CREATE TABLE IF NOT EXISTS events (
+  position BIGSERIAL PRIMARY KEY,
+  event_id TEXT NOT NULL UNIQUE,
+  event_type TEXT NOT NULL,
+  data JSONB NOT NULL,
+  metadata JSONB,
+  timestamp TIMESTAMPTZ NOT NULL,
+  created_at TIMESTAMPTZ DEFAULT NOW()
+);
+
+-- Consistency Key Index (populated by store on write)
+CREATE TABLE IF NOT EXISTS event_keys (
+  position BIGINT NOT NULL REFERENCES events(position) ON DELETE CASCADE,
+  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);
+`;
+/**
+ * PostgreSQL-backed event storage
+ *
+ * Uses connection pooling for efficient database access.
+ * Supports both connection strings and pool configuration objects.
+ *
+ * @example
+ * ```typescript
+ * // Using connection string
+ * const storage = new PostgresStorage('postgresql://user:pass@localhost/db');
+ * await storage.init();
+ *
+ * // Using pool config
+ * const storage = new PostgresStorage({
+ *   host: 'localhost',
+ *   port: 5432,
+ *   database: 'mydb',
+ *   user: 'myuser',
+ *   password: 'mypass',
+ *   max: 20, // max pool size
+ * });
+ * await storage.init();
+ * ```
+ */
+export class PostgresStorage {
+    pool;
+    initialized = false;
+    constructor(connectionStringOrConfig) {
+        if (typeof connectionStringOrConfig === 'string') {
+            this.pool = new Pool({ connectionString: connectionStringOrConfig });
+        }
+        else {
+            this.pool = new Pool(connectionStringOrConfig);
+        }
+    }
+    /**
+     * Initialize the database schema.
+     * Must be called before any other operations.
+     */
+    async init() {
+        if (this.initialized)
+            return;
+        const client = await this.pool.connect();
+        try {
+            await client.query(SCHEMA);
+            this.initialized = true;
+        }
+        finally {
+            client.release();
+        }
+    }
+    ensureInitialized() {
+        if (!this.initialized) {
+            throw new Error('PostgresStorage not initialized. Call init() first.');
+        }
+    }
+    async append(eventsToStore, keys) {
+        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();
+        }
+        const client = await this.pool.connect();
+        try {
+            await client.query('BEGIN');
+            let lastPosition = 0n;
+            for (let i = 0; i < eventsToStore.length; i++) {
+                const event = eventsToStore[i];
+                const eventKeys = keys[i];
+                // Insert event
+                const result = await client.query(`INSERT INTO events (event_id, event_type, data, metadata, timestamp)
+           VALUES ($1, $2, $3, $4, $5)
+           RETURNING position`, [
+                    event.id,
+                    event.type,
+                    JSON.stringify(event.data),
+                    event.metadata ? JSON.stringify(event.metadata) : null,
+                    event.timestamp.toISOString(),
+                ]);
+                const position = BigInt(result.rows[0].position);
+                lastPosition = position;
+                // Insert keys
+                for (const key of eventKeys) {
+                    await client.query(`INSERT INTO event_keys (position, key_name, key_value)
+             VALUES ($1, $2, $3)`, [position.toString(), key.name, key.value]);
+                }
+            }
+            await client.query('COMMIT');
+            return lastPosition;
+        }
+        catch (error) {
+            await client.query('ROLLBACK');
+            throw error;
+        }
+        finally {
+            client.release();
+        }
+    }
+    async query(conditions, fromPosition, limit) {
+        this.ensureInitialized();
+        const params = [];
+        let paramIndex = 1;
+        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 > $${paramIndex}`;
+                params.push(fromPosition.toString());
+                paramIndex++;
+            }
+            sql += ' ORDER BY position';
+            if (limit !== undefined) {
+                sql += ` LIMIT $${paramIndex}`;
+                params.push(limit);
+            }
+            const result = await this.pool.query(sql, params);
+            return result.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 = [];
+        // Unconstrained: match by type only
+        if (unconstrained.length > 0) {
+            const typePlaceholders = unconstrained.map(() => {
+                const ph = `$${paramIndex}`;
+                paramIndex++;
+                return ph;
+            });
+            whereClauses.push(`e.event_type IN (${typePlaceholders.join(', ')})`);
+            params.push(...unconstrained.map(c => c.type));
+        }
+        // Constrained: match by type + key + value
+        if (constrained.length > 0) {
+            const constrainedClauses = constrained.map(c => {
+                const clause = `(e.event_type = $${paramIndex} AND k.key_name = $${paramIndex + 1} AND k.key_value = $${paramIndex + 2})`;
+                params.push(c.type, c.key, c.value);
+                paramIndex += 3;
+                return clause;
+            });
+            whereClauses.push(`(${constrainedClauses.join(' OR ')})`);
+        }
+        // Build SQL
+        let sql;
+        if (constrained.length > 0) {
+            // Need JOIN for constrained conditions
+            sql = `
+        SELECT DISTINCT ON (e.position)
+          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 > $${paramIndex}`;
+            params.push(fromPosition.toString());
+            paramIndex++;
+        }
+        sql += ' ORDER BY e.position';
+        if (limit !== undefined) {
+            sql += ` LIMIT $${paramIndex}`;
+            params.push(limit);
+        }
+        const result = await this.pool.query(sql, params);
+        return result.rows.map(row => this.rowToEvent(row));
+    }
+    async getEventsSince(conditions, sincePosition) {
+        return this.query(conditions, sincePosition);
+    }
+    async getLatestPosition() {
+        this.ensureInitialized();
+        const result = await this.pool.query('SELECT MAX(position) as pos FROM events');
+        return result.rows[0].pos ? BigInt(result.rows[0].pos) : 0n;
+    }
+    async close() {
+        await this.pool.end();
+    }
+    // --- UI Helper Methods (not part of core DCB API) ---
+    /**
+     * Get all events (for debugging/UI)
+     */
+    async getAllEvents() {
+        this.ensureInitialized();
+        const result = await this.pool.query(`
+      SELECT position, event_id, event_type, data, metadata, timestamp
+      FROM events
+      ORDER BY position ASC
+    `);
+        return result.rows.map(row => this.rowToEvent(row));
+    }
+    /**
+     * Get all keys (for debugging/UI)
+     */
+    async getAllKeys() {
+        this.ensureInitialized();
+        const result = await this.pool.query(`
+      SELECT position, key_name, key_value
+      FROM event_keys
+      ORDER BY position ASC
+    `);
+        return result.rows.map(row => ({
+            position: BigInt(row.position),
+            key_name: row.key_name,
+            key_value: row.key_value,
+        }));
+    }
+    /**
+     * Clear all data (for testing)
+     */
+    async clear() {
+        this.ensureInitialized();
+        const client = await this.pool.connect();
+        try {
+            await client.query('BEGIN');
+            await client.query('DELETE FROM event_keys');
+            await client.query('DELETE FROM events');
+            // Reset the sequence
+            await client.query('ALTER SEQUENCE events_position_seq RESTART WITH 1');
+            await client.query('COMMIT');
+        }
+        catch (error) {
+            await client.query('ROLLBACK');
+            throw error;
+        }
+        finally {
+            client.release();
+        }
+    }
+    // --- Metadata Methods ---
+    /**
+     * Get stored config hash
+     */
+    async getConfigHash() {
+        this.ensureInitialized();
+        const result = await this.pool.query("SELECT value FROM metadata WHERE key = 'config_hash'");
+        return result.rows[0]?.value ?? null;
+    }
+    /**
+     * Set config hash
+     */
+    async setConfigHash(hash) {
+        this.ensureInitialized();
+        await this.pool.query(`INSERT INTO metadata (key, value) VALUES ('config_hash', $1)
+       ON CONFLICT (key) DO UPDATE SET value = $1`, [hash]);
+    }
+    /**
+     * Reindex all events with new keys
+     */
+    async reindex(extractKeys) {
+        this.ensureInitialized();
+        const events = await this.getAllEvents();
+        const client = await this.pool.connect();
+        try {
+            await client.query('BEGIN');
+            // Clear all keys
+            await client.query('DELETE FROM event_keys');
+            // Re-extract and insert keys for all events
+            for (const event of events) {
+                const keys = extractKeys(event);
+                for (const key of keys) {
+                    await client.query('INSERT INTO event_keys (position, key_name, key_value) VALUES ($1, $2, $3)', [event.position.toString(), key.name, key.value]);
+                }
+            }
+            await client.query('COMMIT');
+        }
+        catch (error) {
+            await client.query('ROLLBACK');
+            throw error;
+        }
+        finally {
+            client.release();
+        }
+    }
+    rowToEvent(row) {
+        return {
+            id: row.event_id,
+            type: row.event_type,
+            data: row.data,
+            metadata: row.metadata,
+            timestamp: new Date(row.timestamp),
+            position: BigInt(row.position),
+        };
+    }
+}
+//# sourceMappingURL=postgres.js.map

package/dist/storage/postgres.js.map

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

package/dist/storage/sqlite.d.ts

@@ -0,0 +1,47 @@
+/**
+ * SQLite Storage implementation using better-sqlite3
+ */
+import { type ExtractedKey, type QueryCondition, type StoredEvent } from '../types.js';
+import type { EventStorage, EventToStore } from './interface.js';
+/**
+ * SQLite-backed event storage
+ */
+export declare class SqliteStorage implements EventStorage {
+    private db;
+    constructor(path?: string);
+    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(): StoredEvent[];
+    /**
+     * Get all keys (for debugging/UI)
+     */
+    getAllKeys(): Array<{
+        position: number;
+        key_name: string;
+        key_value: string;
+    }>;
+    /**
+     * Clear all data (for testing)
+     */
+    clear(): void;
+    /**
+     * Get stored config hash
+     */
+    getConfigHash(): string | null;
+    /**
+     * Set config hash
+     */
+    setConfigHash(hash: string): void;
+    /**
+     * Reindex all events with new keys
+     */
+    reindex(extractKeys: (event: StoredEvent) => ExtractedKey[]): void;
+    private rowToEvent;
+}
+//# 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;;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;AA2CjE;;GAEG;AACH,qBAAa,aAAc,YAAW,YAAY;IAChD,OAAO,CAAC,EAAE,CAAoB;gBAElB,IAAI,GAAE,MAAmB;IAO/B,MAAM,CAAC,aAAa,EAAE,YAAY,EAAE,EAAE,IAAI,EAAE,YAAY,EAAE,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC;IAmD9E,KAAK,CACT,UAAU,EAAE,cAAc,EAAE,EAC5B,YAAY,CAAC,EAAE,MAAM,EACrB,KAAK,CAAC,EAAE,MAAM,GACb,OAAO,CAAC,WAAW,EAAE,CAAC;IAmGnB,cAAc,CAClB,UAAU,EAAE,cAAc,EAAE,EAC5B,aAAa,EAAE,MAAM,GACpB,OAAO,CAAC,WAAW,EAAE,CAAC;IAInB,iBAAiB,IAAI,OAAO,CAAC,MAAM,CAAC;IAKpC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAM5B;;OAEG;IACH,YAAY,IAAI,WAAW,EAAE;IAU7B;;OAEG;IACH,UAAU,IAAI,KAAK,CAAC;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,CAAC;IAQ9E;;OAEG;IACH,KAAK,IAAI,IAAI;IAQb;;OAEG;IACH,aAAa,IAAI,MAAM,GAAG,IAAI;IAO9B;;OAEG;IACH,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAMjC;;OAEG;IACH,OAAO,CAAC,WAAW,EAAE,CAAC,KAAK,EAAE,WAAW,KAAK,YAAY,EAAE,GAAG,IAAI;IAwBlE,OAAO,CAAC,UAAU;CAUnB"}