@coherent.js/core 1.0.0-beta.2 → 1.0.0-beta.5

package/dist/database/adapters/postgresql.js

@@ -0,0 +1,177 @@
+/**
+ * PostgreSQL Database Adapter for Coherent.js
+ *
+ * @fileoverview PostgreSQL adapter implementation with connection pooling and advanced features.
+ */
+/**
+ * Create PostgreSQL adapter instance
+ *
+ * @returns {Object} PostgreSQL adapter instance
+ */
+export function createPostgreSQLAdapter() {
+    let pg = null;
+    async function initializePostgreSQL() {
+        if (!pg) {
+            try {
+                const pgModule = await import('pg');
+                pg = pgModule.default || pgModule;
+            }
+            catch {
+                throw new Error('pg package is required for PostgreSQL adapter. Install with: npm install pg');
+            }
+        }
+    }
+    function convertPlaceholders(sql) {
+        let index = 1;
+        return sql.replace(/\?/g, () => `$${index++}`);
+    }
+    function extractInsertId(result) {
+        if (result.rows && result.rows.length > 0) {
+            const row = result.rows[0];
+            return row.id || row.insertId || row.lastval || null;
+        }
+        return null;
+    }
+    return {
+        /**
+         * Create connection pool
+         */
+        async createPool(config) {
+            await initializePostgreSQL();
+            const poolConfig = {
+                host: config.host,
+                port: config.port,
+                database: config.database,
+                user: config.username,
+                password: config.password,
+                min: config.pool.min,
+                max: config.pool.max,
+                acquireTimeoutMillis: config.pool.acquireTimeoutMillis,
+                createTimeoutMillis: config.pool.createTimeoutMillis,
+                destroyTimeoutMillis: config.pool.destroyTimeoutMillis,
+                idleTimeoutMillis: config.pool.idleTimeoutMillis,
+                reapIntervalMillis: config.pool.reapIntervalMillis,
+                createRetryIntervalMillis: config.pool.createRetryIntervalMillis,
+                ssl: config.ssl || false
+            };
+            const pool = new pg.Pool(poolConfig);
+            pool.on('_error', (err) => {
+                console._error('PostgreSQL pool _error:', err);
+            });
+            return pool;
+        },
+        /**
+         * Test database connection
+         */
+        async testConnection(pool) {
+            const client = await pool.connect();
+            try {
+                await client.query('SELECT 1');
+            }
+            finally {
+                client.release();
+            }
+        },
+        /**
+         * Execute database query
+         */
+        async query(pool, sql, params = [], options = {}) {
+            const client = await pool.connect();
+            try {
+                const pgSql = convertPlaceholders(sql);
+                const result = await client.query(pgSql, params);
+                if (options.single) {
+                    return result.rows[0] || null;
+                }
+                return {
+                    rows: result.rows,
+                    rowCount: result.rowCount,
+                    affectedRows: result.rowCount,
+                    insertId: extractInsertId(result)
+                };
+            }
+            finally {
+                client.release();
+            }
+        },
+        /**
+         * Start database transaction
+         */
+        async transaction(pool, options = {}) {
+            const client = await pool.connect();
+            let beginSql = 'BEGIN';
+            if (options.isolationLevel) {
+                beginSql += ` ISOLATION LEVEL ${options.isolationLevel}`;
+            }
+            if (options.readOnly) {
+                beginSql += ' READ ONLY';
+            }
+            await client.query(beginSql);
+            const transaction = {
+                client,
+                pool,
+                isCommitted: false,
+                isRolledBack: false,
+                query: async (sql, params, queryOptions) => {
+                    if (transaction.isCommitted || transaction.isRolledBack) {
+                        throw new Error('Cannot execute query on completed transaction');
+                    }
+                    const pgSql = convertPlaceholders(sql);
+                    const result = await client.query(pgSql, params);
+                    if (queryOptions && queryOptions.single) {
+                        return result.rows[0] || null;
+                    }
+                    return {
+                        rows: result.rows,
+                        rowCount: result.rowCount,
+                        affectedRows: result.rowCount,
+                        insertId: extractInsertId(result)
+                    };
+                },
+                commit: async () => {
+                    if (transaction.isCommitted || transaction.isRolledBack) {
+                        throw new Error('Transaction already completed');
+                    }
+                    try {
+                        await client.query('COMMIT');
+                        transaction.isCommitted = true;
+                    }
+                    finally {
+                        client.release();
+                    }
+                },
+                rollback: async () => {
+                    if (transaction.isCommitted || transaction.isRolledBack) {
+                        throw new Error('Transaction already completed');
+                    }
+                    try {
+                        await client.query('ROLLBACK');
+                        transaction.isRolledBack = true;
+                    }
+                    finally {
+                        client.release();
+                    }
+                }
+            };
+            return transaction;
+        },
+        /**
+         * Get pool statistics
+         */
+        getPoolStats(pool) {
+            return {
+                total: pool.totalCount,
+                available: pool.idleCount,
+                acquired: pool.totalCount - pool.idleCount,
+                waiting: pool.waitingCount
+            };
+        },
+        /**
+         * Close connection pool
+         */
+        async closePool(pool) {
+            await pool.end();
+        }
+    };
+}
+//# sourceMappingURL=postgresql.js.map

package/dist/database/adapters/postgresql.js.map

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

package/dist/database/adapters/sqlite.d.ts

@@ -0,0 +1,15 @@
+/**
+ * SQLite Database Adapter for Coherent.js
+ *
+ * @fileoverview SQLite adapter implementation with connection pooling and transaction support.
+ */
+/**
+ * Create a new SQLite adapter instance
+ *
+ * @returns {Object} SQLite adapter instance with database operations
+ */
+export function createSQLiteAdapter(): Object;
+export namespace SQLiteAdapter {
+    export { createSQLiteAdapter as create };
+}
+//# sourceMappingURL=sqlite.d.ts.map

package/dist/database/adapters/sqlite.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sqlite.d.ts","sourceRoot":"","sources":["../../../../../src/database/adapters/sqlite.js"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;;;GAIG;AACH,uCAFa,MAAM,CAmQlB"}

package/dist/database/adapters/sqlite.js

@@ -0,0 +1,241 @@
+/**
+ * SQLite Database Adapter for Coherent.js
+ *
+ * @fileoverview SQLite adapter implementation with connection pooling and transaction support.
+ */
+/**
+ * Create a new SQLite adapter instance
+ *
+ * @returns {Object} SQLite adapter instance with database operations
+ */
+export function createSQLiteAdapter() {
+    let sqlite3 = null;
+    let db = null;
+    /**
+     * Initialize SQLite module
+     *
+     * @private
+     * @returns {Promise<void>}
+     */
+    async function initializeSQLite() {
+        if (!sqlite3) {
+            try {
+                // Try to import sqlite3 (peer dependency)
+                const sqlite3Module = await import('sqlite3');
+                sqlite3 = sqlite3Module.default || sqlite3Module;
+            }
+            catch {
+                throw new Error('Failed to load sqlite3 module. Make sure to install it: npm install sqlite3');
+            }
+        }
+    }
+    /**
+     * Connect to the database
+     *
+     * @param {Object} config - Database configuration
+     * @param {string} config.database - Path to the SQLite database file
+     * @param {boolean} [config.readonly=false] - Open the database in read-only mode
+     * @returns {Promise<Object>} The database adapter instance
+     */
+    async function connect(config) {
+        await initializeSQLite();
+        return new Promise((resolve, reject) => {
+            try {
+                db = new sqlite3.Database(config.database, config.readonly ? sqlite3.OPEN_READONLY : sqlite3.OPEN_READWRITE | sqlite3.OPEN_CREATE, (err) => {
+                    if (err) {
+                        return reject(new Error(`Failed to connect to SQLite database: ${err.message}`));
+                    }
+                    // Enable foreign keys by default
+                    db.run('PRAGMA foreign_keys = ON');
+                    // Enable WAL mode for better concurrency
+                    db.run('PRAGMA journal_mode = WAL');
+                    // Set busy timeout to handle concurrent write operations
+                    db.run('PRAGMA busy_timeout = 5000');
+                    resolve(instance);
+                });
+            }
+            catch (_error) {
+                reject(new Error(`Failed to connect to SQLite database: ${_error.message}`));
+            }
+        });
+    }
+    /**
+     * Execute a SQL query
+     *
+     * @param {string} sql - SQL query string
+     * @param {Array} [params=[]] - Query parameters
+     * @returns {Promise<{rows: Array<Object>}>} Query result
+     */
+    function query(sql, params = []) {
+        return new Promise((resolve, reject) => {
+            if (!db) {
+                return reject(new Error('Database connection not established. Call connect() first.'));
+            }
+            db.all(sql, params, (err, rows) => {
+                if (err) {
+                    return reject(new Error(`SQLite query _error: ${err.message}`));
+                }
+                resolve({ rows });
+            });
+        });
+    }
+    /**
+     * Execute a SQL statement
+     *
+     * @param {string} sql - SQL statement
+     * @param {Array} [params=[]] - Statement parameters
+     * @returns {Promise<{affectedRows: number, insertId: number}>} Execution result
+     */
+    function execute(sql, params = []) {
+        return new Promise((resolve, reject) => {
+            if (!db) {
+                return reject(new Error('Database connection not established. Call connect() first.'));
+            }
+            db.run(sql, params, function (err) {
+                if (err) {
+                    return reject(new Error(`SQLite execute _error: ${err.message}`));
+                }
+                resolve({
+                    affectedRows: this.changes,
+                    insertId: this.lastID
+                });
+            });
+        });
+    }
+    /**
+     * Begin a transaction
+     *
+     * @returns {Promise<void>}
+     */
+    function beginTransaction() {
+        return new Promise((resolve, reject) => {
+            if (!db) {
+                return reject(new Error('Database connection not established. Call connect() first.'));
+            }
+            db.run('BEGIN TRANSACTION', (err) => {
+                if (err) {
+                    return reject(new Error(`Failed to begin transaction: ${err.message}`));
+                }
+                resolve();
+            });
+        });
+    }
+    /**
+     * Commit a transaction
+     *
+     * @returns {Promise<void>}
+     */
+    function commit() {
+        return new Promise((resolve, reject) => {
+            if (!db) {
+                return reject(new Error('Database connection not established. Call connect() first.'));
+            }
+            db.run('COMMIT', (err) => {
+                if (err) {
+                    return reject(new Error(`Failed to commit transaction: ${err.message}`));
+                }
+                resolve();
+            });
+        });
+    }
+    /**
+     * Rollback a transaction
+     *
+     * @returns {Promise<void>}
+     */
+    function rollback() {
+        return new Promise((resolve, reject) => {
+            if (!db) {
+                return reject(new Error('Database connection not established. Call connect() first.'));
+            }
+            db.run('ROLLBACK', (err) => {
+                if (err) {
+                    return reject(new Error(`Failed to rollback transaction: ${err.message}`));
+                }
+                resolve();
+            });
+        });
+    }
+    /**
+     * Disconnect from the database
+     *
+     * @returns {Promise<void>}
+     */
+    function disconnect() {
+        return new Promise((resolve, reject) => {
+            if (!db) {
+                return resolve();
+            }
+            db.close((err) => {
+                if (err) {
+                    return reject(new Error(`Failed to close database connection: ${err.message}`));
+                }
+                db = null;
+                resolve();
+            });
+        });
+    }
+    /**
+     * Get the underlying database connection
+     *
+     * @returns {Object} The database connection
+     */
+    function getConnection() {
+        if (!db) {
+            throw new Error('Database connection not established. Call connect() first.');
+        }
+        return db;
+    }
+    /**
+     * Ping the database to check if connection is alive
+     *
+     * @returns {Promise<boolean>} True if connection is alive
+     */
+    async function ping() {
+        try {
+            await query('SELECT 1');
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+    /**
+     * Escape a value for SQL queries
+     *
+     * @param {*} value - Value to escape
+     * @returns {string} Escaped value
+     */
+    function escape(value) {
+        if (value === null || value === undefined) {
+            return 'NULL';
+        }
+        if (typeof value === 'boolean') {
+            return value ? '1' : '0';
+        }
+        if (typeof value === 'number') {
+            return String(value);
+        }
+        // Escape single quotes by doubling them
+        return `'${String(value).replace(/'/g, "''")}'`;
+    }
+    // Public API
+    const instance = {
+        connect,
+        query,
+        execute,
+        beginTransaction,
+        commit,
+        rollback,
+        disconnect,
+        getConnection,
+        ping,
+        escape,
+        // Alias for backward compatibility
+        run: execute
+    };
+    return instance;
+}
+// For backward compatibility
+export const SQLiteAdapter = { create: createSQLiteAdapter };
+//# sourceMappingURL=sqlite.js.map

package/dist/database/adapters/sqlite.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sqlite.js","sourceRoot":"","sources":["../../../../../src/database/adapters/sqlite.js"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;;;GAIG;AACH,MAAM,UAAU,mBAAmB;IACjC,IAAI,OAAO,GAAG,IAAI,CAAC;IACnB,IAAI,EAAE,GAAG,IAAI,CAAC;IAEd;;;;;OAKG;IACH,KAAK,UAAU,gBAAgB;QAC7B,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,IAAI,CAAC;gBACH,0CAA0C;gBAC1C,MAAM,aAAa,GAAG,MAAM,MAAM,CAAC,SAAS,CAAC,CAAC;gBAC9C,OAAO,GAAG,aAAa,CAAC,OAAO,IAAI,aAAa,CAAC;YACnD,CAAC;YAAC,MAAM,CAAC;gBACP,MAAM,IAAI,KAAK,CAAC,6EAA6E,CAAC,CAAC;YACjG,CAAC;QACH,CAAC;IACH,CAAC;IAED;;;;;;;OAOG;IACH,KAAK,UAAU,OAAO,CAAC,MAAM;QAC3B,MAAM,gBAAgB,EAAE,CAAC;QAEzB,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;YACrC,IAAI,CAAC;gBACH,EAAE,GAAG,IAAI,OAAO,CAAC,QAAQ,CACvB,MAAM,CAAC,QAAQ,EACf,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,aAAa,CAAC,CAAC,CAAC,OAAO,CAAC,cAAc,GAAG,OAAO,CAAC,WAAW,EACtF,CAAC,GAAG,EAAE,EAAE;oBACN,IAAI,GAAG,EAAE,CAAC;wBACR,OAAO,MAAM,CAAC,IAAI,KAAK,CAAC,yCAAyC,GAAG,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC;oBACnF,CAAC;oBAED,iCAAiC;oBACjC,EAAE,CAAC,GAAG,CAAC,0BAA0B,CAAC,CAAC;oBAEnC,yCAAyC;oBACzC,EAAE,CAAC,GAAG,CAAC,2BAA2B,CAAC,CAAC;oBAEpC,yDAAyD;oBACzD,EAAE,CAAC,GAAG,CAAC,4BAA4B,CAAC,CAAC;oBAErC,OAAO,CAAC,QAAQ,CAAC,CAAC;gBACpB,CAAC,CACF,CAAC;YACJ,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,MAAM,CAAC,IAAI,KAAK,CAAC,yCAAyC,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC;YAC9E,CAAC;QACH,CAAC,CAAC,CAAC;IACL,CAAC;IAED;;;;;;OAMG;IACH,SAAS,KAAK,CAAC,GAAG,EAAE,MAAM,GAAG,EAAE;QAC7B,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;YACrC,IAAI,CAAC,EAAE,EAAE,CAAC;gBACR,OAAO,MAAM,CAAC,IAAI,KAAK,CAAC,4DAA4D,CAAC,CAAC,CAAC;YACzF,CAAC;YAED,EAAE,CAAC,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,CAAC,GAAG,EAAE,IAAI,EAAE,EAAE;gBAChC,IAAI,GAAG,EAAE,CAAC;oBACR,OAAO,MAAM,CAAC,IAAI,KAAK,CAAC,uBAAuB,GAAG,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC;gBACjE,CAAC;gBACD,OAAO,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC;YACpB,CAAC,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;IACL,CAAC;IAED;;;;;;OAMG;IACH,SAAS,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,EAAE;QAC/B,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;YACrC,IAAI,CAAC,EAAE,EAAE,CAAC;gBACR,OAAO,MAAM,CAAC,IAAI,KAAK,CAAC,4DAA4D,CAAC,CAAC,CAAC;YACzF,CAAC;YAED,EAAE,CAAC,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,UAAS,GAAG;gBAC9B,IAAI,GAAG,EAAE,CAAC;oBACR,OAAO,MAAM,CAAC,IAAI,KAAK,CAAC,yBAAyB,GAAG,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC;gBACnE,CAAC;gBAED,OAAO,CAAC;oBACN,YAAY,EAAE,IAAI,CAAC,OAAO;oBAC1B,QAAQ,EAAE,IAAI,CAAC,MAAM;iBACtB,CAAC,CAAC;YACL,CAAC,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;IACL,CAAC;IAED;;;;OAIG;IACH,SAAS,gBAAgB;QACvB,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;YACrC,IAAI,CAAC,EAAE,EAAE,CAAC;gBACR,OAAO,MAAM,CAAC,IAAI,KAAK,CAAC,4DAA4D,CAAC,CAAC,CAAC;YACzF,CAAC;YAED,EAAE,CAAC,GAAG,CAAC,mBAAmB,EAAE,CAAC,GAAG,EAAE,EAAE;gBAClC,IAAI,GAAG,EAAE,CAAC;oBACR,OAAO,MAAM,CAAC,IAAI,KAAK,CAAC,gCAAgC,GAAG,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC;gBAC1E,CAAC;gBACD,OAAO,EAAE,CAAC;YACZ,CAAC,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;IACL,CAAC;IAED;;;;OAIG;IACH,SAAS,MAAM;QACb,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;YACrC,IAAI,CAAC,EAAE,EAAE,CAAC;gBACR,OAAO,MAAM,CAAC,IAAI,KAAK,CAAC,4DAA4D,CAAC,CAAC,CAAC;YACzF,CAAC;YAED,EAAE,CAAC,GAAG,CAAC,QAAQ,EAAE,CAAC,GAAG,EAAE,EAAE;gBACvB,IAAI,GAAG,EAAE,CAAC;oBACR,OAAO,MAAM,CAAC,IAAI,KAAK,CAAC,iCAAiC,GAAG,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC;gBAC3E,CAAC;gBACD,OAAO,EAAE,CAAC;YACZ,CAAC,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;IACL,CAAC;IAED;;;;OAIG;IACH,SAAS,QAAQ;QACf,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;YACrC,IAAI,CAAC,EAAE,EAAE,CAAC;gBACR,OAAO,MAAM,CAAC,IAAI,KAAK,CAAC,4DAA4D,CAAC,CAAC,CAAC;YACzF,CAAC;YAED,EAAE,CAAC,GAAG,CAAC,UAAU,EAAE,CAAC,GAAG,EAAE,EAAE;gBACzB,IAAI,GAAG,EAAE,CAAC;oBACR,OAAO,MAAM,CAAC,IAAI,KAAK,CAAC,mCAAmC,GAAG,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC;gBAC7E,CAAC;gBACD,OAAO,EAAE,CAAC;YACZ,CAAC,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;IACL,CAAC;IAED;;;;OAIG;IACH,SAAS,UAAU;QACjB,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;YACrC,IAAI,CAAC,EAAE,EAAE,CAAC;gBACR,OAAO,OAAO,EAAE,CAAC;YACnB,CAAC;YAED,EAAE,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE;gBACf,IAAI,GAAG,EAAE,CAAC;oBACR,OAAO,MAAM,CAAC,IAAI,KAAK,CAAC,wCAAwC,GAAG,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC;gBAClF,CAAC;gBACD,EAAE,GAAG,IAAI,CAAC;gBACV,OAAO,EAAE,CAAC;YACZ,CAAC,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;IACL,CAAC;IAED;;;;OAIG;IACH,SAAS,aAAa;QACpB,IAAI,CAAC,EAAE,EAAE,CAAC;YACR,MAAM,IAAI,KAAK,CAAC,4DAA4D,CAAC,CAAC;QAChF,CAAC;QACD,OAAO,EAAE,CAAC;IACZ,CAAC;IAED;;;;OAIG;IACH,KAAK,UAAU,IAAI;QACjB,IAAI,CAAC;YACH,MAAM,KAAK,CAAC,UAAU,CAAC,CAAC;YACxB,OAAO,IAAI,CAAC;QACd,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,KAAK,CAAC;QACf,CAAC;IACH,CAAC;IAED;;;;;OAKG;IACH,SAAS,MAAM,CAAC,KAAK;QACnB,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;YAC1C,OAAO,MAAM,CAAC;QAChB,CAAC;QAED,IAAI,OAAO,KAAK,KAAK,SAAS,EAAE,CAAC;YAC/B,OAAO,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC;QAC3B,CAAC;QAED,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;YAC9B,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC;QACvB,CAAC;QAED,wCAAwC;QACxC,OAAO,IAAI,MAAM,CAAC,KAAK,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,IAAI,CAAC,GAAG,CAAC;IAClD,CAAC;IAED,aAAa;IACb,MAAM,QAAQ,GAAG;QACf,OAAO;QACP,KAAK;QACL,OAAO;QACP,gBAAgB;QAChB,MAAM;QACN,QAAQ;QACR,UAAU;QACV,aAAa;QACb,IAAI;QACJ,MAAM;QAEN,mCAAmC;QACnC,GAAG,EAAE,OAAO;KACb,CAAC;IAEF,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED,6BAA6B;AAC7B,MAAM,CAAC,MAAM,aAAa,GAAG,EAAE,MAAM,EAAE,mBAAmB,EAAE,CAAC"}

package/dist/database/connection-manager.d.ts

@@ -0,0 +1,135 @@
+/**
+ * Database Connection Manager
+ *
+ * @class DatabaseManager
+ * @extends EventEmitter
+ * @description Manages database connections with pooling, health checks, and adapter abstraction.
+ * Provides a unified interface for different database engines.
+ *
+ * @param {Object} config - Database configuration
+ * @param {string} config.type - Database type ('postgresql', 'mysql', 'sqlite', 'mongodb')
+ * @param {string} [config.host='localhost'] - Database host
+ * @param {number} [config.port] - Database port (auto-detected by type)
+ * @param {string} config.database - Database name
+ * @param {string} [config.username] - Database username
+ * @param {string} [config.password] - Database password
+ * @param {Object} [config.pool] - Connection pool configuration
+ * @param {boolean} [config.debug=false] - Enable debug logging
+ *
+ * @example
+ * const db = new DatabaseManager({
+ *   type: 'postgresql',
+ *   host: 'localhost',
+ *   database: 'myapp',
+ *   username: 'user',
+ *   password: 'pass',
+ *   pool: { min: 2, max: 10 }
+ * });
+ *
+ * await db.connect();
+ * const users = await db.query('SELECT * FROM users WHERE active = ?', [true]);
+ */
+export class DatabaseManager extends EventEmitter<[never]> {
+    constructor(config: any);
+    config: Object;
+    adapter: Object | null;
+    pool: any;
+    isConnected: boolean;
+    connectionAttempts: number;
+    maxRetries: number;
+    healthCheckInterval: NodeJS.Timeout | null;
+    healthCheckFrequency: number;
+    stats: {
+        totalConnections: number;
+        activeConnections: number;
+        failedConnections: number;
+        queriesExecuted: number;
+        averageQueryTime: number;
+        lastHealthCheck: null;
+    };
+    /**
+     * Validate database configuration
+     *
+     * @private
+     * @param {Object} config - Configuration to validate
+     * @returns {Object} Validated configuration
+     * @throws {Error} If configuration is invalid
+     */
+    private validateConfig;
+    /**
+     * Connect to the database
+     *
+     * @returns {Promise<void>}
+     * @throws {Error} If connection fails after retries
+     *
+     * @example
+     * await db.connect();
+     * console.log('Database connected successfully');
+     */
+    connect(): Promise<void>;
+    /**
+     * Load database adapter
+     *
+     * @private
+     * @param {string} type - Database type
+     * @returns {Object} Database adapter
+     */
+    private loadAdapter;
+    /**
+     * Test database connection
+     *
+     * @private
+     * @returns {Promise<void>}
+     */
+    private testConnection;
+    /**
+     * Execute a database query
+     *
+     * @param {string} sql - SQL query string
+     * @param {Array} [params=[]] - Query parameters
+     * @param {Object} [options={}] - Query options
+     * @returns {Promise<Object>} Query result
+     *
+     * @example
+     * const users = await db.query('SELECT * FROM users WHERE age > ?', [18]);
+     * const user = await db.query('SELECT * FROM users WHERE id = ?', [123], { single: true });
+     */
+    query(operation: any, params?: any[]): Promise<Object>;
+    /**
+     * Start a database transaction
+     *
+     * @returns {Promise<Object>} Transaction object
+     *
+     * @example
+     * const tx = await db.transaction();
+     * try {
+     *   await tx.query('INSERT INTO users (name) VALUES (?)', ['John']);
+     *   await tx.query('INSERT INTO profiles (user_id) VALUES (?)', [userId]);
+     *   await tx.commit();
+     * } catch (error) {
+     *   await tx.rollback();
+     *   throw error;
+     * }
+     */
+    transaction(): Promise<Object>;
+    /**
+     * Start health check monitoring
+     *
+     * @private
+     */
+    private startHealthCheck;
+    /**
+     * Get connection statistics
+     *
+     * @returns {Object} Connection statistics
+     */
+    getStats(): Object;
+    /**
+     * Close database connection
+     *
+     * @returns {Promise<void>}
+     */
+    close(): Promise<void>;
+}
+import { EventEmitter } from 'events';
+//# sourceMappingURL=connection-manager.d.ts.map

package/dist/database/connection-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"connection-manager.d.ts","sourceRoot":"","sources":["../../../../src/database/connection-manager.js"],"names":[],"mappings":"AASA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH;IACE,yBAuBC;IApBC,eAAyC;IACzC,uBAAmB;IACnB,UAAgB;IAChB,qBAAwB;IACxB,2BAA2B;IAC3B,mBAAmB;IAGnB,2CAA+B;IAC/B,6BAAiC;IAGjC;;;;;;;MAOC;IAGH;;;;;;;OAOG;IACH,uBA8DC;IAED;;;;;;;;;OASG;IACH,WAPa,OAAO,CAAC,IAAI,CAAC,CA4CzB;IAED;;;;;;OAMG;IACH,oBAsCC;IAED;;;;;OAKG;IACH,uBAoBC;IAED;;;;;;;;;;;OAWG;IACH,uCANa,OAAO,CAAC,MAAM,CAAC,CAiD3B;IAED;;;;;;;;;;;;;;;OAeG;IACH,eAba,OAAO,CAAC,MAAM,CAAC,CAmB3B;IAED;;;;OAIG;IACH,yBAiBC;IAED;;;;OAIG;IACH,YAFa,MAAM,CAQlB;IAED;;;;OAIG;IACH,SAFa,OAAO,CAAC,IAAI,CAAC,CA2BzB;CACF;6BApZ4B,QAAQ"}