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

package/dist/database/utils.js

@@ -0,0 +1,372 @@
+/**
+ * Database Utilities for Coherent.js
+ *
+ * @fileoverview Utility functions for database operations, model registration, and migrations.
+ */
+import { DatabaseManager } from './connection-manager.js';
+// Migration utilities are handled by the createMigration factory function
+/**
+ * Model registry for managing model classes
+ */
+const modelRegistry = new Map();
+/**
+ * Create database connection with configuration
+ *
+ * @param {Object} config - Database configuration
+ * @returns {Promise<DatabaseManager>} Database manager instance
+ *
+ * @example
+ * const db = await createConnection({
+ *   type: 'postgresql',
+ *   host: 'localhost',
+ *   database: 'myapp',
+ *   username: 'user',
+ *   password: 'pass'
+ * });
+ */
+export async function createConnection(config) {
+    const db = new DatabaseManager(config);
+    await db.connect();
+    return db;
+}
+/**
+
+  // Add custom methods if provided
+  if (definition.methods) {
+    Object.entries(definition.methods).forEach(([methodName, method]) => {
+      DynamicModel.prototype[methodName] = method;
+    });
+  }
+
+  // Add custom static methods if provided
+  if (definition.staticMethods) {
+    Object.entries(definition.staticMethods).forEach(([methodName, method]) => {
+      DynamicModel[methodName] = method;
+    });
+  }
+
+  // Register the model
+  registerModel(name, DynamicModel);
+
+  return DynamicModel;
+}
+
+/**
+ * Register a model class
+ *
+ * @param {string} name - Model name
+ * @param {Function} ModelClass - Model class
+ *
+ * @example
+ * registerModel('User', UserModel);
+ */
+export function registerModel(name, ModelClass) {
+    modelRegistry.set(name, ModelClass);
+    // Make model globally available for relationships
+    if (typeof global !== 'undefined') {
+        global[name] = ModelClass;
+    }
+}
+/**
+ * Get registered model by name
+ *
+ * @param {string} name - Model name
+ * @returns {Function|null} Model class or null if not found
+ *
+ * @example
+ * const User = getModel('User');
+ */
+export function getModel(name) {
+    return modelRegistry.get(name) || null;
+}
+/**
+ * Get all registered models
+ *
+ * @returns {Map<string, Function>} Map of model names to classes
+ */
+export function getAllModels() {
+    return new Map(modelRegistry);
+}
+/**
+ * Run database migrations
+ *
+ * @param {DatabaseManager} db - Database manager instance
+ * @param {Object} [config={}] - Migration configuration
+ * @returns {Promise<Array<string>>} Applied migration names
+ *
+ * @example
+ * const applied = await runMigrations(db, {
+ *   directory: './migrations'
+ * });
+ */
+export async function runMigrations(db, config = {}) {
+    const { createMigration } = await import('./migration.js');
+    const migration = createMigration(db, config);
+    return await migration.run();
+}
+/**
+ * Rollback database migrations
+ *
+ * @param {DatabaseManager} db - Database manager instance
+ * @param {number} [steps=1] - Number of batches to rollback
+ * @param {Object} [config={}] - Migration configuration
+ * @returns {Promise<Array<string>>} Rolled back migration names
+ *
+ * @example
+ * const rolledBack = await rollbackMigrations(db, 2);
+ */
+export async function rollbackMigrations(db, steps = 1, config = {}) {
+    const { createMigration } = await import('./migration.js');
+    const migration = createMigration(db, config);
+    return await migration.rollback(steps);
+}
+/**
+ * Create a new migration file
+ *
+ * @param {string} name - Migration name
+ * @param {Object} [config={}] - Migration configuration
+ * @returns {Promise<string>} Created file path
+ *
+ * @example
+ * const filePath = await createMigration('create_users_table');
+ */
+export async function createMigrationFile(name, config = {}) {
+    const { createMigration } = await import('./migration.js');
+    const migration = createMigration(null, config);
+    return await migration.create(name);
+}
+/**
+ * Seed database with initial data
+ *
+ * @param {DatabaseManager} db - Database manager instance
+ * @param {Function|Array<Function>} seeders - Seeder functions
+ * @returns {Promise<void>}
+ *
+ * @example
+ * await seedDatabase(db, [
+ *   async (db) => {
+ *     await User.create({ name: 'Admin', email: 'admin@example.com' });
+ *   }
+ * ]);
+ */
+export async function seedDatabase(db, seeders) {
+    const seederArray = Array.isArray(seeders) ? seeders : [seeders];
+    for (const seeder of seederArray) {
+        if (typeof seeder === 'function') {
+            await seeder(db);
+        }
+    }
+}
+/**
+ * Validate database configuration
+ *
+ * @param {Object} config - Database configuration
+ * @returns {Object} Validation result
+ *
+ * @example
+ * const validation = validateConfig(config);
+ * if (!validation.valid) {
+ *   console._error('Config errors:', validation.errors);
+ * }
+ */
+export function validateConfig(config) {
+    const errors = [];
+    if (!config || typeof config !== 'object') {
+        errors.push('Configuration must be an object');
+        return { valid: false, errors };
+    }
+    if (!config.type) {
+        errors.push('Database type is required');
+    }
+    else {
+        const supportedTypes = ['postgresql', 'mysql', 'sqlite', 'mongodb'];
+        if (!supportedTypes.includes(config.type)) {
+            errors.push(`Unsupported database type: ${config.type}`);
+        }
+    }
+    if (!config.database) {
+        errors.push('Database name is required');
+    }
+    if (config.type !== 'sqlite') {
+        if (!config.host) {
+            errors.push('Host is required for non-SQLite databases');
+        }
+    }
+    if (config.pool) {
+        if (config.pool.min && config.pool.max && config.pool.min > config.pool.max) {
+            errors.push('Pool min size cannot be greater than max size');
+        }
+    }
+    return {
+        valid: errors.length === 0,
+        errors
+    };
+}
+/**
+ * Create database backup
+ *
+ * @param {DatabaseManager} db - Database manager instance
+ * @param {Object} [options={}] - Backup options
+ * @returns {Promise<string>} Backup file path or data
+ *
+ * @example
+ * const backupPath = await createBackup(db, {
+ *   format: 'sql',
+ *   outputPath: './backups'
+ * });
+ */
+export async function createBackup(db, options = {}) {
+    const backupConfig = {
+        format: 'sql',
+        outputPath: './backups',
+        timestamp: true,
+        ...options
+    };
+    const timestamp = backupConfig.timestamp ? new Date().toISOString().replace(/[:.]/g, '-') : '';
+    const fileName = `backup${timestamp ? '_' + timestamp : ''}.${backupConfig.format}`;
+    const filePath = `${backupConfig.outputPath}/${fileName}`;
+    // This would be adapter-specific implementation
+    // For now, return a placeholder
+    console.log(`Backup would be created at: ${filePath}`);
+    return filePath;
+}
+/**
+ * Restore database from backup
+ *
+ * @param {DatabaseManager} db - Database manager instance
+ * @param {string} backupPath - Path to backup file
+ * @param {Object} [options={}] - Restore options
+ * @returns {Promise<void>}
+ *
+ * @example
+ * await restoreBackup(db, './backups/backup_2023-12-01.sql');
+ */
+export async function restoreBackup(db, backupPath) {
+    // This would be adapter-specific implementation
+    console.log(`Restore would be performed from: ${backupPath}`);
+}
+/**
+ * Generate database schema documentation
+ *
+ * @param {DatabaseManager} db - Database manager instance
+ * @param {Object} [options={}] - Documentation options
+ * @returns {Promise<Object>} Schema documentation
+ *
+ * @example
+ * const docs = await generateSchemaDocs(db, {
+ *   includeIndexes: true,
+ *   includeRelationships: true
+ * });
+ */
+export async function generateSchemaDocs(db) {
+    const schema = {
+        database: db.config.database,
+        type: db.config.type,
+        tables: [],
+        models: []
+    };
+    // Add registered models to documentation
+    for (const [name, ModelClass] of modelRegistry) {
+        schema.models.push({
+            name,
+            tableName: ModelClass.tableName,
+            primaryKey: ModelClass.primaryKey,
+            fillable: ModelClass.fillable,
+            relationships: ModelClass.relationships,
+            validationRules: ModelClass.validationRules
+        });
+    }
+    return schema;
+}
+/**
+ * Database health check utility
+ *
+ * @param {DatabaseManager} db - Database manager instance
+ * @returns {Promise<Object>} Health check result
+ *
+ * @example
+ * const health = await checkDatabaseHealth(db);
+ * console.log(`Database is ${health.status}`);
+ */
+export async function checkDatabaseHealth(db) {
+    const startTime = Date.now();
+    try {
+        await db.query('SELECT 1');
+        const responseTime = Date.now() - startTime;
+        const stats = db.getStats();
+        return {
+            status: 'healthy',
+            responseTime,
+            connected: db.isConnected,
+            stats
+        };
+    }
+    catch (_error) {
+        return {
+            status: 'unhealthy',
+            _error: _error.message,
+            connected: db.isConnected,
+            responseTime: Date.now() - startTime
+        };
+    }
+}
+/**
+ * Batch operation utility
+ *
+ * @param {DatabaseManager} db - Database manager instance
+ * @param {Array} operations - Array of operations to execute
+ * @param {Object} [options={}] - Batch options
+ * @returns {Promise<Array>} Results array
+ *
+ * @example
+ * const results = await batchOperations(db, [
+ *   { sql: 'INSERT INTO users (name) VALUES (?)', params: ['John'] },
+ *   { sql: 'INSERT INTO users (name) VALUES (?)', params: ['Jane'] }
+ * ]);
+ */
+export async function batchOperations(db, operations, options = {}) {
+    const config = {
+        useTransaction: true,
+        continueOnError: false,
+        ...options
+    };
+    const results = [];
+    if (config.useTransaction) {
+        const tx = await db.transaction();
+        try {
+            for (const operation of operations) {
+                try {
+                    const result = await tx.query(operation.sql, operation.params);
+                    results.push({ success: true, result });
+                }
+                catch (_error) {
+                    results.push({ success: false, _error: _error.message });
+                    if (!config.continueOnError) {
+                        throw _error;
+                    }
+                }
+            }
+            await tx.commit();
+        }
+        catch (_error) {
+            await tx.rollback();
+            throw _error;
+        }
+    }
+    else {
+        for (const operation of operations) {
+            try {
+                const result = await db.query(operation.sql, operation.params);
+                results.push({ success: true, result });
+            }
+            catch (_error) {
+                results.push({ success: false, _error: _error.message });
+                if (!config.continueOnError) {
+                    throw _error;
+                }
+            }
+        }
+    }
+    return results;
+}
+//# sourceMappingURL=utils.js.map

package/dist/database/utils.js.map

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

package/dist/dev/dev-tools.d.ts

@@ -77,7 +77,7 @@ export class DevTools {
     /**
      * Get component type
      */
-    getComponentType(component: any): "text" | "function" | "array" | "element" | "unknown";
+    getComponentType(component: any): "function" | "text" | "array" | "element" | "unknown";
     /**
      * Visualize component structure
      */

package/dist/dev/dev-tools.js

@@ -107,9 +107,9 @@ export class DevTools {
                 this.postRenderAnalysis(component, result, renderTime, renderId);
                 return result;
             }
-            catch (error) {
-                this.handleRenderError(error, component, context, renderId);
-                throw error;
+            catch (_error) {
+                this.handleRenderError(_error, component, context, renderId);
+                throw _error;
             }
         };
     }
@@ -187,10 +187,10 @@ export class DevTools {
         try {
             validateComponent(component);
         }
-        catch (error) {
+        catch (_error) {
             return {
                 isValid: false,
-                message: `Invalid component at ${path}: ${error.message}`
+                message: `Invalid component at ${path}: ${_error.message}`
             };
         }
         // Recursive validation for objects and arrays
@@ -247,7 +247,7 @@ export class DevTools {
      */
     analyzeContext(context, renderId) {
         // Large context warning
-        const contextSize = JSON.stringify(_context).length;
+        const contextSize = JSON.stringify(context).length;
         if (contextSize > 10000) {
             this.warnings.push({
                 type: 'context',
@@ -258,10 +258,10 @@ export class DevTools {
         }
         // Circular reference check
         try {
-            JSON.stringify(_context);
+            JSON.stringify(context);
         }
-        catch (error) {
-            if (error.message.includes('circular')) {
+        catch (_error) {
+            if (_error.message.includes('circular')) {
                 this.warnings.push({
                     type: 'context',
                     message: 'Circular reference detected in context',
@@ -383,12 +383,12 @@ export class DevTools {
         return string.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
     }
     /**
-     * Setup error handling
+     * Setup _error handling
      */
     setupErrorHandling() {
-        // Global error handler
-        const originalConsoleError = console.error;
-        console.error = (...args) => {
+        // Global _error handler
+        const originalConsoleError = console._error;
+        console._error = (...args) => {
             // Log to dev tools
             this.errors.push({
                 type: 'console',
@@ -410,11 +410,11 @@ export class DevTools {
                 });
             });
         }
-        // Browser error handler
+        // Browser _error handler
         if (typeof window !== 'undefined') {
-            window.addEventListener('error', (event) => {
+            window.addEventListener('_error', (event) => {
                 this.errors.push({
-                    type: 'browser-error',
+                    type: 'browser-_error',
                     message: event.message,
                     filename: event.filename,
                     lineno: event.lineno,
@@ -427,18 +427,18 @@ export class DevTools {
     /**
      * Handle render errors specifically
      */
-    handleRenderError(error, component, context, renderId) {
+    handleRenderError(_error, component, context, renderId) {
         this.errors.push({
-            type: 'render-error',
-            message: error.message,
-            stack: error.stack,
+            type: 'render-_error',
+            message: _error.message,
+            stack: _error.stack,
             component: this.serializeComponent(component),
-            context: Object.keys(_context),
+            context: Object.keys(context),
             renderId,
             timestamp: Date.now()
         });
-        console.error(`🚨 Render Error in ${renderId}:`, error.message);
-        console.error('Component:', this.serializeComponent(component));
+        console._error(`🚨 Render Error in ${renderId}:`, _error.message);
+        console._error('Component:', this.serializeComponent(component));
     }
     /**
      * Setup hot reload capability
@@ -736,8 +736,8 @@ export class DevTools {
             }
             return component;
         }
-        catch (error) {
-            return `[Serialization Error: ${error.message}]`;
+        catch (_error) {
+            return `[Serialization Error: ${_error.message}]`;
         }
     }
     clearDevData() {
@@ -812,7 +812,7 @@ export const devUtils = {
             for (const tag of tags) {
                 const props = component[tag];
                 if (props && typeof props === 'object') {
-                    console.log(`${tag} props:`, Object.keys(_props));
+                    console.log(`${tag} props:`, Object.keys(props));
                 }
             }
         }
@@ -826,8 +826,8 @@ export const devUtils = {
             console.log('✅ Component is valid');
             return true;
         }
-        catch (error) {
-            console.error('❌ Component validation failed:', error.message);
+        catch (_error) {
+            console._error('❌ Component validation failed:', _error.message);
             return false;
         }
     },

package/dist/index.cjs

@@ -106,6 +106,7 @@ function createPerformanceMonitor(options = {}) {
     },
     alerts: {
       enabled: true,
+      debounceMs: 5e3,
       rules: []
     },
     resources: {
@@ -267,7 +268,7 @@ function createPerformanceMonitor(options = {}) {
         const alertKey = `${rule.metric}-${rule.condition}-${rule.threshold}`;
         const lastTriggered = alertState.triggered.get(alertKey);
         const now = Date.now();
-        if (!lastTriggered || now - lastTriggered > 5e3) {
+        if (!lastTriggered || now - lastTriggered > opts.alerts.debounceMs) {
           alertState.triggered.set(alertKey, now);
           alertState.history.push({
             rule,