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

package/dist/database/connection-manager.js

@@ -0,0 +1,362 @@
+/**
+ * Database Connection Manager for Coherent.js
+ *
+ * @fileoverview Manages database connections, connection pooling, and adapter selection
+ * with support for multiple database engines and automatic failover.
+ */
+import { EventEmitter } from 'events';
+/**
+ * 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 {
+    constructor(config) {
+        super();
+        this.config = this.validateConfig(config);
+        this.adapter = null;
+        this.pool = null;
+        this.isConnected = false;
+        this.connectionAttempts = 0;
+        this.maxRetries = 3;
+        // Health check interval
+        this.healthCheckInterval = null;
+        this.healthCheckFrequency = 30000; // 30 seconds
+        // Connection statistics
+        this.stats = {
+            totalConnections: 0,
+            activeConnections: 0,
+            failedConnections: 0,
+            queriesExecuted: 0,
+            averageQueryTime: 0,
+            lastHealthCheck: null
+        };
+    }
+    /**
+     * Validate database configuration
+     *
+     * @private
+     * @param {Object} config - Configuration to validate
+     * @returns {Object} Validated configuration
+     * @throws {Error} If configuration is invalid
+     */
+    validateConfig(config) {
+        if (!config || typeof config !== 'object') {
+            throw new Error('Database configuration is required');
+        }
+        // New adapter-based configuration
+        if (config.adapter) {
+            if (typeof config.adapter !== 'object' ||
+                typeof config.adapter.createPool !== 'function') {
+                throw new Error('Invalid adapter provided. Adapter must be an object with a createPool method');
+            }
+            // Set default store config if not provided
+            if (!config.store) {
+                config.store = { name: 'default' };
+            }
+            else if (typeof config.store === 'string') {
+                config.store = { name: config.store };
+            }
+            return config;
+        }
+        // Legacy type-based configuration
+        const { type, database } = config;
+        if (!type) {
+            throw new Error('Either database type or adapter is required');
+        }
+        const supportedTypes = ['postgresql', 'mysql', 'sqlite', 'mongodb'];
+        if (!supportedTypes.includes(type)) {
+            throw new Error(`Unsupported database type: ${type}. Supported types: ${supportedTypes.join(', ')}`);
+        }
+        if (!database) {
+            throw new Error('Database name is required for type-based configuration');
+        }
+        // Set default ports based on database type
+        const defaultPorts = {
+            postgresql: 5432,
+            mysql: 3306,
+            mongodb: 27017,
+            sqlite: null
+        };
+        return {
+            host: config.host || 'localhost',
+            port: config.port || defaultPorts[type],
+            ...config,
+            pool: {
+                min: 2,
+                max: 10,
+                acquireTimeoutMillis: 30000,
+                createTimeoutMillis: 30000,
+                destroyTimeoutMillis: 5000,
+                idleTimeoutMillis: 30000,
+                reapIntervalMillis: 1000,
+                createRetryIntervalMillis: 200,
+                ...config.pool
+            }
+        };
+    }
+    /**
+     * Connect to the database
+     *
+     * @returns {Promise<void>}
+     * @throws {Error} If connection fails after retries
+     *
+     * @example
+     * await db.connect();
+     * console.log('Database connected successfully');
+     */
+    async connect() {
+        if (this.isConnected) {
+            return;
+        }
+        try {
+            // Load appropriate adapter
+            this.adapter = await this.loadAdapter(this.config.type);
+            // Create connection pool
+            this.pool = await this.adapter.createPool(this.config);
+            // Test connection
+            await this.testConnection();
+            this.isConnected = true;
+            this.connectionAttempts = 0;
+            // Start health checks if supported by the adapter
+            if (this.adapter.startHealthChecks) {
+                this.startHealthChecks();
+            }
+            return this;
+        }
+        catch (_error) {
+            this.connectionAttempts++;
+            this.stats.failedConnections++;
+            this.emit('_error', _error);
+            if (this.connectionAttempts < this.maxRetries) {
+                console.warn(`Connection attempt ${this.connectionAttempts} failed. Retrying in 2 seconds...`);
+                await new Promise(resolve => setTimeout(resolve, 2000));
+                return this.connect();
+            }
+            throw new Error(`Failed to connect to database after ${this.connectionAttempts} attempts: ${_error.message}`);
+        }
+    }
+    /**
+     * Load database adapter
+     *
+     * @private
+     * @param {string} type - Database type
+     * @returns {Object} Database adapter
+     */
+    loadAdapter(type) {
+        // If using direct adapter instance (for custom adapters like MemoryAdapter)
+        if (this.config.adapter) {
+            return this.config.adapter;
+        }
+        // For built-in adapters
+        const adapterMap = {
+            postgresql: './adapters/postgresql.js',
+            mysql: './adapters/mysql.js',
+            sqlite: './adapters/sqlite.js',
+            mongodb: './adapters/mongodb.js',
+            memory: './adapters/memory.js'
+        };
+        const adapterPath = adapterMap[type];
+        if (!adapterPath) {
+            throw new Error(`No adapter found for database type: ${type}`);
+        }
+        // Use dynamic import for ESM compatibility
+        return import(adapterPath)
+            .then(adapterModule => {
+            // Try both the default export and the named export pattern
+            if (adapterModule.default) {
+                return new adapterModule.default();
+            }
+            const AdapterClass = adapterModule[`${type.charAt(0).toUpperCase() + type.slice(1)}Adapter`];
+            if (AdapterClass) {
+                return new AdapterClass();
+            }
+            throw new Error(`No valid adapter found in ${adapterPath}`);
+        })
+            .catch(_error => {
+            throw new Error(`Failed to load ${type} adapter: ${_error.message}`);
+        });
+    }
+    /**
+     * Test database connection
+     *
+     * @private
+     * @returns {Promise<void>}
+     */
+    async testConnection() {
+        const startTime = Date.now();
+        try {
+            if (typeof this.adapter.testConnection === 'function') {
+                await this.adapter.testConnection();
+            }
+            else if (this.adapter.ping) {
+                // Try ping if available
+                await this.adapter.ping();
+            }
+            // If no test method is available, we'll assume the connection is good
+            const duration = Date.now() - startTime;
+            this.stats.lastHealthCheck = new Date();
+            this.emit('connect:test', { duration });
+        }
+        catch (_error) {
+            this.emit('_error', _error);
+            throw new Error(`Database connection test failed: ${_error.message}`);
+        }
+    }
+    /**
+     * 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 });
+     */
+    async query(operation, params = {}) {
+        if (!this.isConnected) {
+            throw new Error('Database not connected. Call connect() first.');
+        }
+        const startTime = Date.now();
+        try {
+            let result;
+            // Handle MemoryAdapter's query method
+            if (typeof this.pool.query === 'function') {
+                result = await this.pool.query(operation, params);
+            }
+            // Handle SQL adapters
+            else if (typeof this.adapter.query === 'function') {
+                result = await this.adapter.query(this.pool, operation, params);
+            }
+            else {
+                throw new Error('No valid query method found on adapter or pool');
+            }
+            // Update statistics
+            const duration = Date.now() - startTime;
+            this.stats.queriesExecuted++;
+            this.stats.averageQueryTime = ((this.stats.averageQueryTime * (this.stats.queriesExecuted - 1) + duration) /
+                this.stats.queriesExecuted);
+            if (this.config.debug) {
+                console.log(`Query executed in ${duration}ms: ${operation}`, params);
+            }
+            this.emit('query', { operation, params, duration });
+            return result;
+        }
+        catch (_error) {
+            const duration = Date.now() - startTime;
+            this.emit('queryError', { operation, params, duration, _error: _error.message });
+            throw new Error(`Query failed: ${_error.message}`);
+        }
+    }
+    /**
+     * 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;
+     * }
+     */
+    async transaction() {
+        if (!this.isConnected) {
+            throw new Error('Database not connected. Call connect() first.');
+        }
+        return await this.adapter.transaction(this.pool);
+    }
+    /**
+     * Start health check monitoring
+     *
+     * @private
+     */
+    startHealthCheck() {
+        if (this.healthCheckInterval) {
+            return;
+        }
+        this.healthCheckInterval = setInterval(async () => {
+            try {
+                await this.testConnection();
+                this.emit('healthCheck', { status: 'healthy', timestamp: new Date() });
+            }
+            catch (_error) {
+                this.emit('healthCheck', { status: 'unhealthy', _error: _error.message, timestamp: new Date() });
+                if (this.config.debug) {
+                    console._error('Database health check failed:', _error.message);
+                }
+            }
+        }, this.healthCheckFrequency);
+    }
+    /**
+     * Get connection statistics
+     *
+     * @returns {Object} Connection statistics
+     */
+    getStats() {
+        return {
+            ...this.stats,
+            isConnected: this.isConnected,
+            poolStats: this.pool ? this.adapter.getPoolStats(this.pool) : null
+        };
+    }
+    /**
+     * Close database connection
+     *
+     * @returns {Promise<void>}
+     */
+    async close() {
+        if (!this.isConnected) {
+            return;
+        }
+        // Stop health checks
+        if (this.healthCheckInterval) {
+            clearInterval(this.healthCheckInterval);
+            this.healthCheckInterval = null;
+        }
+        // Close connection pool
+        if (this.pool && this.adapter) {
+            await this.adapter.closePool(this.pool);
+        }
+        this.isConnected = false;
+        this.pool = null;
+        this.adapter = null;
+        this.emit('disconnected');
+        if (this.config.debug) {
+            console.log('Database connection closed');
+        }
+    }
+}
+//# sourceMappingURL=connection-manager.js.map

package/dist/database/connection-manager.js.map

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

package/dist/database/index.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Quick setup function for common database configurations
+ *
+ * @param {Object} config - Database configuration
+ * @returns {DatabaseManager} Configured database manager
+ *
+ * @example
+ * import { setupDatabase } from '@coherent/database';
+ *
+ * const db = setupDatabase({
+ *   type: 'postgresql',
+ *   host: 'localhost',
+ *   database: 'myapp',
+ *   username: 'user',
+ *   password: 'pass'
+ * });
+ */
+export function setupDatabase(config?: Object): DatabaseManager;
+export { DatabaseManager } from "./connection-manager.js";
+export { createModel } from "./model.js";
+export { createMigration } from "./migration.js";
+export { withDatabase } from "./middleware.js";
+export { createPostgreSQLAdapter as PostgreSQLAdapter } from "./adapters/postgresql.js";
+export { createMySQLAdapter as MySQLAdapter } from "./adapters/mysql.js";
+export { createSQLiteAdapter as SQLiteAdapter } from "./adapters/sqlite.js";
+export { createMongoDBAdapter as MongoDBAdapter } from "./adapters/mongodb.js";
+export namespace DEFAULT_DB_CONFIG {
+    let type: string;
+    let database: string;
+    let synchronize: boolean;
+    let logging: boolean;
+    let entities: never[];
+    let migrations: never[];
+    let subscribers: never[];
+}
+export { createQuery, executeQuery, QueryBuilder } from "./query-builder.js";
+export { createConnection, runMigrations } from "./utils.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/database/index.js"],"names":[],"mappings":"AAsCA;;;;;;;;;;;;;;;;GAgBG;AACH,uCAdW,MAAM,GACJ,eAAe,CAuB3B"}

package/dist/database/index.js

@@ -0,0 +1,60 @@
+/**
+ * Database Integration Layer for Coherent.js
+ *
+ * @fileoverview Provides database connectivity, query building, and ORM functionality
+ * with support for multiple database engines (PostgreSQL, MySQL, SQLite, MongoDB).
+ *
+ * @author Coherent.js Team
+ * @version 1.0.0
+ */
+export { DatabaseManager } from './connection-manager.js';
+export { createQuery, executeQuery, QueryBuilder } from './query-builder.js';
+export { createModel } from './model.js';
+export { createMigration } from './migration.js';
+export { withDatabase } from './middleware.js';
+// Database adapters
+export { createPostgreSQLAdapter as PostgreSQLAdapter } from './adapters/postgresql.js';
+export { createMySQLAdapter as MySQLAdapter } from './adapters/mysql.js';
+export { createSQLiteAdapter as SQLiteAdapter } from './adapters/sqlite.js';
+export { createMongoDBAdapter as MongoDBAdapter } from './adapters/mongodb.js';
+// Utilities
+export { createConnection, runMigrations } from './utils.js';
+/**
+ * Default database configuration
+ */
+export const DEFAULT_DB_CONFIG = {
+    type: 'sqlite',
+    database: ':memory:',
+    synchronize: true,
+    logging: false,
+    entities: [],
+    migrations: [],
+    subscribers: []
+};
+/**
+ * Quick setup function for common database configurations
+ *
+ * @param {Object} config - Database configuration
+ * @returns {DatabaseManager} Configured database manager
+ *
+ * @example
+ * import { setupDatabase } from '@coherent/database';
+ *
+ * const db = setupDatabase({
+ *   type: 'postgresql',
+ *   host: 'localhost',
+ *   database: 'myapp',
+ *   username: 'user',
+ *   password: 'pass'
+ * });
+ */
+export function setupDatabase(config = {}) {
+    const mergedConfig = { ...DEFAULT_DB_CONFIG, ...config };
+    const dbManager = new DatabaseManager(mergedConfig);
+    // Auto-connect if autoConnect is not explicitly set to false
+    if (mergedConfig.autoConnect !== false) {
+        dbManager.connect().catch(console._error);
+    }
+    return dbManager;
+}
+//# sourceMappingURL=index.js.map

package/dist/database/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/database/index.js"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAC1D,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAC7E,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AACzC,OAAO,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AACjD,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAE/C,oBAAoB;AACpB,OAAO,EAAE,uBAAuB,IAAI,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AACxF,OAAO,EAAE,kBAAkB,IAAI,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACzE,OAAO,EAAE,mBAAmB,IAAI,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAC5E,OAAO,EAAE,oBAAoB,IAAI,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAE/E,YAAY;AACZ,OAAO,EAAE,gBAAgB,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAE7D;;GAEG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG;IAC/B,IAAI,EAAE,QAAQ;IACd,QAAQ,EAAE,UAAU;IACpB,WAAW,EAAE,IAAI;IACjB,OAAO,EAAE,KAAK;IACd,QAAQ,EAAE,EAAE;IACZ,UAAU,EAAE,EAAE;IACd,WAAW,EAAE,EAAE;CAChB,CAAC;AAEF;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,UAAU,aAAa,CAAC,MAAM,GAAG,EAAE;IACvC,MAAM,YAAY,GAAG,EAAE,GAAG,iBAAiB,EAAE,GAAG,MAAM,EAAE,CAAC;IACzD,MAAM,SAAS,GAAG,IAAI,eAAe,CAAC,YAAY,CAAC,CAAC;IAEpD,6DAA6D;IAC7D,IAAI,YAAY,CAAC,WAAW,KAAK,KAAK,EAAE,CAAC;QACvC,SAAS,CAAC,OAAO,EAAE,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;IAC3C,CAAC;IAED,OAAO,SAAS,CAAC;AACnB,CAAC"}

package/dist/database/middleware.d.ts

@@ -0,0 +1,122 @@
+/**
+ * Database Middleware for Coherent.js Router Integration
+ *
+ * @fileoverview Provides middleware for seamless database integration with the router,
+ * including connection management, transaction handling, and query helpers.
+ */
+/**
+ * Database middleware for router integration
+ *
+ * @param {DatabaseManager} db - Database manager instance
+ * @param {Object} [options={}] - Middleware options
+ * @returns {Function} Middleware function
+ *
+ * @example
+ * import { withDatabase } from '@coherent/database';
+ *
+ * const router = new SimpleRouter();
+ * router.use(withDatabase(db));
+ *
+ * router.get('/users', async (req, res) => {
+ *   const users = await req.db.query('SELECT * FROM users');
+ *   res.json(users.rows);
+ * });
+ */
+export function withDatabase(db: DatabaseManager, options?: Object): Function;
+/**
+ * Transaction middleware for automatic transaction management
+ *
+ * @param {DatabaseManager} db - Database manager instance
+ * @param {Object} [options={}] - Transaction options
+ * @returns {Function} Middleware function
+ *
+ * @example
+ * router.post('/transfer', withTransaction(db), async (req, res) => {
+ *   // All database operations in this handler will be wrapped in a transaction
+ *   await req.tx.query('UPDATE accounts SET balance = balance - ? WHERE id = ?', [amount, fromId]);
+ *   await req.tx.query('UPDATE accounts SET balance = balance + ? WHERE id = ?', [amount, toId]);
+ *   // Transaction is automatically committed on success or rolled back on error
+ * });
+ */
+export function withTransaction(db: DatabaseManager, options?: Object): Function;
+/**
+ * Model binding middleware
+ *
+ * @param {Function} ModelClass - Model class to bind
+ * @param {string} [paramName='id'] - Route parameter name
+ * @param {string} [requestKey] - Request key to attach model (defaults to model name)
+ * @returns {Function} Middleware function
+ *
+ * @example
+ * router.get('/users/:id', withModel(User), async (req, res) => {
+ *   // req.user contains the loaded User model
+ *   res.json(req.user.toJSON());
+ * });
+ *
+ * router.get('/posts/:postId', withModel(Post, 'postId', 'post'), async (req, res) => {
+ *   // req.post contains the loaded Post model
+ *   res.json(req.post.toJSON());
+ * });
+ */
+export function withModel(ModelClass: Function, paramName?: string, requestKey?: string): Function;
+/**
+ * Pagination middleware
+ *
+ * @param {Object} [options={}] - Pagination options
+ * @returns {Function} Middleware function
+ *
+ * @example
+ * router.get('/users', withPagination(), async (req, res) => {
+ *   const users = await User.query()
+ *     .limit(req.pagination.limit)
+ *     .offset(req.pagination.offset)
+ *     .execute();
+ *
+ *   res.json({
+ *     data: users.rows,
+ *     pagination: req.pagination
+ *   });
+ * });
+ */
+export function withPagination(options?: Object): Function;
+/**
+ * Query validation middleware
+ *
+ * @param {Object} schema - Validation schema
+ * @param {Object} [options={}] - Validation options
+ * @returns {Function} Middleware function
+ *
+ * @example
+ * router.get('/users', withQueryValidation({
+ *   status: { type: 'string', enum: ['active', 'inactive'] },
+ *   age: { type: 'number', min: 0, max: 120 }
+ * }), async (req, res) => {
+ *   // req.query is validated and sanitized
+ * });
+ */
+export function withQueryValidation(schema: Object, options?: Object): Function;
+/**
+ * Database health check middleware
+ *
+ * @param {DatabaseManager} db - Database manager instance
+ * @param {Object} [options={}] - Health check options
+ * @returns {Function} Middleware function
+ *
+ * @example
+ * router.get('/health', withHealthCheck(db), (req, res) => {
+ *   res.json({ status: 'healthy', database: req.dbHealth });
+ * });
+ */
+export function withHealthCheck(db: DatabaseManager, options?: Object): Function;
+/**
+ * Connection pooling middleware for request-scoped connections
+ *
+ * @param {DatabaseManager} db - Database manager instance
+ * @param {Object} [options={}] - Pool options
+ * @returns {Function} Middleware function
+ *
+ * @example
+ * router.use(withConnectionPool(db, { acquireTimeout: 10000 }));
+ */
+export function withConnectionPool(db: DatabaseManager, options?: Object): Function;
+//# sourceMappingURL=middleware.d.ts.map

package/dist/database/middleware.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"middleware.d.ts","sourceRoot":"","sources":["../../../../src/database/middleware.js"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;;;;;;;;;;;;;;;;GAiBG;AACH,iCAfW,eAAe,YACf,MAAM,YAsEhB;AAED;;;;;;;;;;;;;;GAcG;AACH,oCAZW,eAAe,YACf,MAAM,YAuChB;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,4DAfW,MAAM,eACN,MAAM,YA8ChB;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,yCAhBW,MAAM,YA6ChB;AAED;;;;;;;;;;;;;;GAcG;AACH,4CAZW,MAAM,YACN,MAAM,YA8FhB;AAED;;;;;;;;;;;GAWG;AACH,oCATW,eAAe,YACf,MAAM,YAmDhB;AAED;;;;;;;;;GASG;AACH,uCAPW,eAAe,YACf,MAAM,YAgDhB"}