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

package/dist/database/query-builder.d.ts

@@ -0,0 +1,111 @@
+/**
+ * Pure Object-based Query Builder for Coherent.js Database Layer
+ *
+ * @fileoverview Provides pure JavaScript object structure for building database queries
+ * with a declarative, object-based approach.
+ */
+/**
+ * Creates a database query configuration object
+ *
+ * @typedef {Object} QueryConfig
+ * @property {string} [table] - The table to query
+ * @property {string|string[]} [select] - Columns to select
+ * @property {Object} [where] - Query conditions
+ * @property {Object} [orderBy] - Sort configuration
+ * @property {number} [limit] - Maximum number of results
+ * @property {number} [offset] - Number of rows to skip
+ * @property {Object} [insert] - Data to insert
+ * @property {Object} [update] - Data to update
+ * @property {boolean} [delete] - Whether to delete
+ */
+/**
+ * Creates a query configuration object
+ *
+ * @param {QueryConfig} config - Query configuration
+ * @returns {QueryConfig} The query configuration object
+ *
+ * @example
+ * // Basic select
+ * const userQuery = createQuery({
+ *   table: 'users',
+ *   select: ['id', 'name', 'email'],
+ *   where: { active: true },
+ *   orderBy: { created_at: 'DESC' },
+ *   limit: 10
+ * });
+ *
+ * // Insert
+ * const insertQuery = createQuery({
+ *   table: 'users',
+ *   insert: { name: 'John', email: 'john@example.com' }
+ * });
+ *
+ * // Update
+ * const updateQuery = createQuery({
+ *   table: 'users',
+ *   update: { last_login: new Date() },
+ *   where: { id: 1 }
+ * });
+ *
+ * // Delete
+ * const deleteQuery = createQuery({
+ *   table: 'users',
+ *   where: { inactive_days: { '>': 365 } },
+ *   delete: true
+ * });
+ */
+export function createQuery(config: QueryConfig): QueryConfig;
+/**
+ * Executes a query using the provided configuration
+ *
+ * @param {Object} db - Database connection/manager
+ * @param {QueryConfig} query - Query configuration
+ * @returns {Promise<*>} Query result
+ */
+export function executeQuery(db: Object, query: QueryConfig): Promise<any>;
+export namespace QueryBuilder {
+    export { createQuery as create };
+    export { executeQuery as execute };
+}
+/**
+ * Creates a database query configuration object
+ */
+export type QueryConfig = {
+    /**
+     * - The table to query
+     */
+    table?: string | undefined;
+    /**
+     * - Columns to select
+     */
+    select?: string | string[] | undefined;
+    /**
+     * - Query conditions
+     */
+    where?: Object | undefined;
+    /**
+     * - Sort configuration
+     */
+    orderBy?: Object | undefined;
+    /**
+     * - Maximum number of results
+     */
+    limit?: number | undefined;
+    /**
+     * - Number of rows to skip
+     */
+    offset?: number | undefined;
+    /**
+     * - Data to insert
+     */
+    insert?: Object | undefined;
+    /**
+     * - Data to update
+     */
+    update?: Object | undefined;
+    /**
+     * - Whether to delete
+     */
+    delete?: boolean | undefined;
+};
+//# sourceMappingURL=query-builder.d.ts.map

package/dist/database/query-builder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"query-builder.d.ts","sourceRoot":"","sources":["../../../../src/database/query-builder.js"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;;;;;;;;;;;;GAaG;AAEH;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmCG;AACH,oCAjCW,WAAW,GACT,WAAW,CAkCvB;AAED;;;;;;GAMG;AACH,iCAJW,MAAM,SACN,WAAW,GACT,OAAO,CAAC,GAAC,CAAC,CAKtB"}

package/dist/database/query-builder.js

@@ -0,0 +1,187 @@
+/**
+ * Pure Object-based Query Builder for Coherent.js Database Layer
+ *
+ * @fileoverview Provides pure JavaScript object structure for building database queries
+ * with a declarative, object-based approach.
+ */
+/**
+ * Creates a database query configuration object
+ *
+ * @typedef {Object} QueryConfig
+ * @property {string} [table] - The table to query
+ * @property {string|string[]} [select] - Columns to select
+ * @property {Object} [where] - Query conditions
+ * @property {Object} [orderBy] - Sort configuration
+ * @property {number} [limit] - Maximum number of results
+ * @property {number} [offset] - Number of rows to skip
+ * @property {Object} [insert] - Data to insert
+ * @property {Object} [update] - Data to update
+ * @property {boolean} [delete] - Whether to delete
+ */
+/**
+ * Creates a query configuration object
+ *
+ * @param {QueryConfig} config - Query configuration
+ * @returns {QueryConfig} The query configuration object
+ *
+ * @example
+ * // Basic select
+ * const userQuery = createQuery({
+ *   table: 'users',
+ *   select: ['id', 'name', 'email'],
+ *   where: { active: true },
+ *   orderBy: { created_at: 'DESC' },
+ *   limit: 10
+ * });
+ *
+ * // Insert
+ * const insertQuery = createQuery({
+ *   table: 'users',
+ *   insert: { name: 'John', email: 'john@example.com' }
+ * });
+ *
+ * // Update
+ * const updateQuery = createQuery({
+ *   table: 'users',
+ *   update: { last_login: new Date() },
+ *   where: { id: 1 }
+ * });
+ *
+ * // Delete
+ * const deleteQuery = createQuery({
+ *   table: 'users',
+ *   where: { inactive_days: { '>': 365 } },
+ *   delete: true
+ * });
+ */
+export function createQuery(config) {
+    return { ...config };
+}
+/**
+ * Executes a query using the provided configuration
+ *
+ * @param {Object} db - Database connection/manager
+ * @param {QueryConfig} query - Query configuration
+ * @returns {Promise<*>} Query result
+ */
+export async function executeQuery(db, query) {
+    const { sql, params } = buildSQL(query);
+    return await db.query(sql, params);
+}
+// Internal SQL building functions
+function buildSQL(query) {
+    const params = [];
+    let sql = '';
+    if (query.insert) {
+        sql = buildInsertSQL(query, params);
+    }
+    else if (query.update) {
+        sql = buildUpdateSQL(query, params);
+    }
+    else if (query.delete) {
+        sql = buildDeleteSQL(query, params);
+    }
+    else {
+        sql = buildSelectSQL(query, params);
+    }
+    return { sql, params };
+}
+function buildSelectSQL(query, params) {
+    const columns = Array.isArray(query.select)
+        ? query.select.join(', ')
+        : (query.select || '*');
+    let sql = `SELECT ${columns} FROM ${query.table}`;
+    if (query.where) {
+        const whereClause = buildWhereClause(query.where, params);
+        if (whereClause)
+            sql += ` WHERE ${whereClause}`;
+    }
+    if (query.orderBy) {
+        sql += ' ORDER BY ' + Object.entries(query.orderBy)
+            .map(([col, dir]) => `${col} ${dir.toUpperCase()}`)
+            .join(', ');
+    }
+    if (query.limit)
+        sql += ` LIMIT ${query.limit}`;
+    if (query.offset)
+        sql += ` OFFSET ${query.offset}`;
+    return sql;
+}
+function buildInsertSQL(query, params) {
+    const columns = Object.keys(query.insert);
+    const placeholders = columns.map(() => '?').join(', ');
+    params.push(...Object.values(query.insert));
+    return `INSERT INTO ${query.table} (${columns.join(', ')}) VALUES (${placeholders})`;
+}
+function buildUpdateSQL(query, params) {
+    const setClause = Object.entries(query.update)
+        .map(([col]) => `${col} = ?`)
+        .join(', ');
+    params.push(...Object.values(query.update));
+    let sql = `UPDATE ${query.table} SET ${setClause}`;
+    if (query.where) {
+        const whereClause = buildWhereClause(query.where, params);
+        if (whereClause)
+            sql += ` WHERE ${whereClause}`;
+    }
+    return sql;
+}
+function buildDeleteSQL(query, params) {
+    let sql = `DELETE FROM ${query.table}`;
+    if (query.where) {
+        const whereClause = buildWhereClause(query.where, params);
+        if (whereClause)
+            sql += ` WHERE ${whereClause}`;
+    }
+    return sql;
+}
+function buildWhereClause(conditions, params, operator = 'AND') {
+    if (!conditions)
+        return '';
+    const clauses = [];
+    for (const [key, value] of Object.entries(conditions)) {
+        if (value === undefined)
+            continue;
+        // Handle logical operators at the top level
+        if (key === '$or' && Array.isArray(value)) {
+            const orClauses = value.map(c => `(${buildWhereClause(c, params)})`);
+            clauses.push(`(${orClauses.join(' OR ')})`);
+        }
+        else if (key === '$and' && Array.isArray(value)) {
+            const andClauses = value.map(c => `(${buildWhereClause(c, params)})`);
+            clauses.push(`(${andClauses.join(' AND ')})`);
+        }
+        else if (typeof value === 'object' && value !== null && !Array.isArray(value)) {
+            // Handle field operators like { '>': 10 } or { 'in': [1, 2, 3] }
+            for (const [op, val] of Object.entries(value)) {
+                if (op === 'in' && Array.isArray(val)) {
+                    const placeholders = val.map(() => '?').join(', ');
+                    clauses.push(`${key} IN (${placeholders})`);
+                    params.push(...val);
+                }
+                else if (op === 'between' && Array.isArray(val) && val.length === 2) {
+                    clauses.push(`${key} BETWEEN ? AND ?`);
+                    params.push(...val);
+                }
+                else if (['>', '>=', '<', '<=', '!=', '<>', 'LIKE'].includes(op)) {
+                    clauses.push(`${key} ${op} ?`);
+                    params.push(val);
+                }
+            }
+        }
+        else if (value === null) {
+            clauses.push(`${key} IS NULL`);
+        }
+        else {
+            clauses.push(`${key} = ?`);
+            params.push(value);
+        }
+    }
+    return clauses.join(` ${operator} `);
+}
+// For backwards compatibility
+export const QueryBuilder = {
+    create: createQuery,
+    execute: executeQuery
+};
+//# sourceMappingURL=query-builder.js.map

package/dist/database/query-builder.js.map

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

package/dist/database/utils.d.ts

@@ -0,0 +1,196 @@
+/**
+ * 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 function createConnection(config: Object): Promise<DatabaseManager>;
+/**
+
+  // 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: string, ModelClass: Function): void;
+/**
+ * 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: string): Function | null;
+/**
+ * Get all registered models
+ *
+ * @returns {Map<string, Function>} Map of model names to classes
+ */
+export function getAllModels(): Map<string, Function>;
+/**
+ * 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 function runMigrations(db: DatabaseManager, config?: Object): Promise<Array<string>>;
+/**
+ * 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 function rollbackMigrations(db: DatabaseManager, steps?: number, config?: Object): Promise<Array<string>>;
+/**
+ * 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 function createMigrationFile(name: string, config?: Object): Promise<string>;
+/**
+ * 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 function seedDatabase(db: DatabaseManager, seeders: Function | Array<Function>): Promise<void>;
+/**
+ * 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: Object): Object;
+/**
+ * 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 function createBackup(db: DatabaseManager, options?: Object): Promise<string>;
+/**
+ * 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 function restoreBackup(db: DatabaseManager, backupPath: string): Promise<void>;
+/**
+ * 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 function generateSchemaDocs(db: DatabaseManager): Promise<Object>;
+/**
+ * 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 function checkDatabaseHealth(db: DatabaseManager): Promise<Object>;
+/**
+ * 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 function batchOperations(db: DatabaseManager, operations: any[], options?: Object): Promise<any[]>;
+import { DatabaseManager } from './connection-manager.js';
+//# sourceMappingURL=utils.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../../../src/database/utils.js"],"names":[],"mappings":"AAcA;;;;;;;;;;;;;;GAcG;AACH,yCAZW,MAAM,GACJ,OAAO,CAAC,eAAe,CAAC,CAepC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,oCANW,MAAM,8BAahB;AAED;;;;;;;;GAQG;AACH,+BANW,MAAM,GACJ,WAAS,IAAI,CAOzB;AAED;;;;GAIG;AACH,gCAFa,GAAG,CAAC,MAAM,WAAW,CAIjC;AAED;;;;;;;;;;;GAWG;AACH,kCATW,eAAe,WACf,MAAM,GACJ,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAWlC;AAED;;;;;;;;;;GAUG;AACH,uCARW,eAAe,UACf,MAAM,WACN,MAAM,GACJ,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CASlC;AAED;;;;;;;;;GASG;AACH,0CAPW,MAAM,WACN,MAAM,GACJ,OAAO,CAAC,MAAM,CAAC,CAS3B;AAED;;;;;;;;;;;;;GAaG;AACH,iCAXW,eAAe,WACf,WAAS,KAAK,UAAU,GACtB,OAAO,CAAC,IAAI,CAAC,CAiBzB;AAED;;;;;;;;;;;GAWG;AACH,uCATW,MAAM,GACJ,MAAM,CA6ClB;AAED;;;;;;;;;;;;GAYG;AACH,iCAVW,eAAe,YACf,MAAM,GACJ,OAAO,CAAC,MAAM,CAAC,CAwB3B;AAED;;;;;;;;;;GAUG;AACH,kCARW,eAAe,cACf,MAAM,GAEJ,OAAO,CAAC,IAAI,CAAC,CAQzB;AAED;;;;;;;;;;;;GAYG;AACH,uCAVW,eAAe,GAEb,OAAO,CAAC,MAAM,CAAC,CA6B3B;AAED;;;;;;;;;GASG;AACH,wCAPW,eAAe,GACb,OAAO,CAAC,MAAM,CAAC,CA8B3B;AAED;;;;;;;;;;;;;GAaG;AACH,oCAXW,eAAe,+BAEf,MAAM,GACJ,OAAO,OAAO,CAyD1B;gCA/Y+B,yBAAyB"}