@coherent.js/database 1.0.0-beta.2

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Thomas Drouvin
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,74 @@
+# @coherent.js/database
+
+[![npm version](https://img.shields.io/npm/v/@coherent.js/database.svg)](https://www.npmjs.com/package/@coherent.js/database)
+[![license: MIT](https://img.shields.io/badge/license-MIT-blue.svg)](../../LICENSE)
+[![Node >= 20](https://img.shields.io/badge/node-%3E%3D20-brightgreen)](https://nodejs.org)
+
+Database utilities and adapters for Coherent.js.
+
+- ESM-only, Node 20+
+- Optional adapters for popular databases
+- Designed to pair with `@coherent.js/core` and server frameworks
+
+For a high-level overview and repository-wide instructions, see the root README: ../../README.md
+
+## Installation
+
+```bash
+pnpm add @coherent.js/database
+```
+
+Optional peer dependencies (install as needed):
+- `sqlite3` (optional)
+
+## Quick start
+
+JavaScript (ESM):
+```js
+// Import utilities from the package's public entry once you enable a specific adapter
+import db from '@coherent.js/database';
+
+// Example sketch: connect and query (adapter-specific APIs vary)
+async function example() {
+  // const conn = await db.connect({ url: process.env.DATABASE_URL });
+  // const rows = await conn.query('select 1');
+}
+```
+
+TypeScript:
+```ts
+import db from '@coherent.js/database';
+
+async function example(): Promise<void> {
+  // const conn = await db.connect({ url: process.env.DATABASE_URL! });
+  // const rows = await conn.query('select 1');
+}
+```
+
+Note: This package exposes a set of adapters and helpers. Refer to the repository docs and examples for concrete adapter APIs.
+
+## Development
+
+Run tests for this package:
+```bash
+pnpm --filter @coherent.js/database run test
+```
+
+Watch mode:
+```bash
+pnpm --filter @coherent.js/database run test:watch
+```
+
+Type check:
+```bash
+pnpm --filter @coherent.js/database run typecheck
+```
+
+Build:
+```bash
+pnpm --filter @coherent.js/database run build
+```
+
+## License
+
+MIT © Coherent.js Team

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

@@ -0,0 +1,48 @@
+/**
+ * In-Memory Database Adapter for Coherent.js
+ *
+ * @fileoverview In-memory adapter for development and testing purposes.
+ * Provides a simple, non-persistent storage solution.
+ */
+/**
+ * In-Memory Database Adapter
+ *
+ * @class MemoryAdapter
+ * @description Provides in-memory database operations with a simple key-value store.
+ */
+export class MemoryAdapter {
+    stores: Map<any, any>;
+    /**
+     * Create a new in-memory store
+     *
+     * @param {Object} config - Store configuration
+     * @returns {Promise<Object>} Store instance
+     */
+    createPool(config: Object): Promise<Object>;
+    /**
+     * Get a store by name
+     *
+     * @param {string} name - Store name
+     * @returns {Object|undefined} Store instance or undefined if not found
+     */
+    getStore(name?: string): Object | undefined;
+    /**
+     * Close all stores and clean up
+     *
+     * @returns {Promise<void>}
+     */
+    close(): Promise<void>;
+    /**
+     * Close the connection pool
+     * @param {Object} pool - The connection pool to close
+     * @returns {Promise<void>}
+     */
+    closePool(pool: Object): Promise<void>;
+    /**
+     * Execute a transaction
+     * @param {Function} callback - Transaction callback
+     * @returns {Promise<*>} Result of the transaction
+     */
+    transaction(callback: Function): Promise<any>;
+}
+//# sourceMappingURL=memory.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"memory.d.ts","sourceRoot":"","sources":["../../../../../src/database/adapters/memory.js"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;;;;GAKG;AACH;IAEI,sBAAuB;IAGzB;;;;;OAKG;IACH,mBAHW,MAAM,GACJ,OAAO,CAAC,MAAM,CAAC,CAgM3B;IAED;;;;;OAKG;IACH,gBAHW,MAAM,GACJ,MAAM,GAAC,SAAS,CAI5B;IAED;;;;OAIG;IACH,SAFa,OAAO,CAAC,IAAI,CAAC,CAIzB;IAED;;;;OAIG;IACH,gBAHW,MAAM,GACJ,OAAO,CAAC,IAAI,CAAC,CAezB;IAED;;;;OAIG;IACH,iCAFa,OAAO,CAAC,GAAC,CAAC,CActB;CACF"}

package/dist/database/adapters/memory.js

@@ -0,0 +1,250 @@
+/**
+ * In-Memory Database Adapter for Coherent.js
+ *
+ * @fileoverview In-memory adapter for development and testing purposes.
+ * Provides a simple, non-persistent storage solution.
+ */
+/**
+ * In-Memory Database Adapter
+ *
+ * @class MemoryAdapter
+ * @description Provides in-memory database operations with a simple key-value store.
+ */
+export class MemoryAdapter {
+    constructor() {
+        this.stores = new Map();
+    }
+    /**
+     * Create a new in-memory store
+     *
+     * @param {Object} config - Store configuration
+     * @returns {Promise<Object>} Store instance
+     */
+    async createPool(config) {
+        const collections = new Map();
+        const schemas = new Map();
+        const store = {
+            config,
+            stats: {
+                created: Date.now(),
+                operations: 0,
+                collections: 0,
+                queries: 0
+            },
+            /**
+             * Get a collection by name
+             * @private
+             */
+            _getCollection(name) {
+                if (!collections.has(name)) {
+                    collections.set(name, new Map());
+                }
+                return collections.get(name);
+            },
+            /**
+             * Get schema for a collection
+             * @private
+             */
+            _getSchema(collectionName) {
+                return schemas.get(collectionName) || {};
+            },
+            /**
+             * Execute a query
+             * @param {string} operation - Operation type
+             * @param {Object} params - Query parameters
+             * @returns {Promise<*>} Query result
+             */
+            async query(operation, params = {}) {
+                this.stats.operations++;
+                this.stats.queries++;
+                const { table, where = {}, data, limit, offset, orderBy } = params;
+                const collection = this._getCollection(table);
+                switch (operation.toUpperCase()) {
+                    case 'FIND': {
+                        let results = Array.from(collection.values());
+                        // Apply WHERE conditions
+                        if (Object.keys(where).length > 0) {
+                            results = results.filter(item => Object.entries(where).every(([key, value]) => {
+                                if (value === undefined)
+                                    return true;
+                                if (value === null)
+                                    return item[key] === null;
+                                return JSON.stringify(item[key]) === JSON.stringify(value);
+                            }));
+                        }
+                        // Apply ORDER BY
+                        if (orderBy) {
+                            let field, direction;
+                            if (Array.isArray(orderBy)) {
+                                [field, direction = 'ASC'] = orderBy;
+                            }
+                            else if (typeof orderBy === 'object') {
+                                const entries = Object.entries(orderBy);
+                                if (entries.length > 0) {
+                                    [field, direction] = entries[0];
+                                }
+                            }
+                            else {
+                                field = orderBy;
+                                direction = 'ASC';
+                            }
+                            if (field) {
+                                const _dir = direction.toLowerCase();
+                                results.sort((a, b) => {
+                                    if (a[field] < b[field])
+                                        return dir === 'asc' ? -1 : 1;
+                                    if (a[field] > b[field])
+                                        return dir === 'asc' ? 1 : -1;
+                                    return 0;
+                                });
+                            }
+                        }
+                        // Apply OFFSET and LIMIT
+                        if (offset)
+                            results = results.slice(offset);
+                        if (limit)
+                            results = results.slice(0, limit);
+                        return results;
+                    }
+                    case 'INSERT': {
+                        if (!data)
+                            throw new Error('No data provided for insert');
+                        const id = data.id || Date.now().toString(36) + Math.random().toString(36).substr(2);
+                        const record = { ...data, id };
+                        collection.set(id, record);
+                        this.stats.collections = collections.size;
+                        return { id };
+                    }
+                    case 'UPDATE': {
+                        if (!data)
+                            throw new Error('No data provided for update');
+                        const records = await this.query('FIND', { table, where });
+                        const updated = [];
+                        for (const record of records) {
+                            const updatedRecord = { ...record, ...data };
+                            collection.set(record.id, updatedRecord);
+                            updated.push(updatedRecord);
+                        }
+                        return { affectedRows: updated.length };
+                    }
+                    case 'DELETE': {
+                        const records = await this.query('FIND', { table, where });
+                        const deleted = [];
+                        for (const record of records) {
+                            if (collection.delete(record.id)) {
+                                deleted.push(record);
+                            }
+                        }
+                        return { affectedRows: deleted.length };
+                    }
+                    case 'COUNT': {
+                        const results = await this.query('FIND', { table, where });
+                        return { count: results.length };
+                    }
+                    case 'CREATE_COLLECTION': {
+                        const { name, schema } = params;
+                        schemas.set(name, schema || {});
+                        return { success: true };
+                    }
+                    case 'SET_SCHEMA': {
+                        const { model, schema } = params;
+                        schemas.set(model, schema);
+                        return { success: true };
+                    }
+                    default:
+                        throw new Error(`Unsupported operation: ${operation}`);
+                }
+            },
+            /**
+             * Get store statistics
+             * @returns {Object}
+             */
+            getStats() {
+                return {
+                    ...this.stats,
+                    uptime: Date.now() - this.stats.created,
+                    collections: collections.size,
+                    operations: this.stats.operations,
+                    queries: this.stats.queries
+                };
+            },
+            /**
+             * Execute a transaction
+             * @param {Function} callback - Transaction callback
+             * @returns {Promise<*>} Result of the transaction
+             */
+            async transaction(callback) {
+                // In a real implementation, this would track changes and rollback on error
+                // For this simple implementation, we'll just execute the callback
+                try {
+                    const result = await callback({
+                        query: (operation, params) => this.query(operation, params)
+                    });
+                    return result;
+                }
+                catch (error) {
+                    // In a real implementation, we would rollback changes here
+                    throw error;
+                }
+            }
+        };
+        this.stores.set(config.name || 'default', store);
+        return store;
+    }
+    /**
+     * Get a store by name
+     *
+     * @param {string} name - Store name
+     * @returns {Object|undefined} Store instance or undefined if not found
+     */
+    getStore(name = 'default') {
+        return this.stores.get(name);
+    }
+    /**
+     * Close all stores and clean up
+     *
+     * @returns {Promise<void>}
+     */
+    async close() {
+        this.stores.clear();
+    }
+    /**
+     * Close the connection pool
+     * @param {Object} pool - The connection pool to close
+     * @returns {Promise<void>}
+     */
+    async closePool(pool) {
+        // For in-memory adapter, we don't need to do anything special to close the pool
+        // Just clear any references to allow garbage collection
+        if (pool) {
+            // Clear any collections or other resources if needed
+            if (pool.collections) {
+                pool.collections.clear();
+            }
+            if (pool.schemas) {
+                pool.schemas.clear();
+            }
+        }
+        return Promise.resolve();
+    }
+    /**
+     * Execute a transaction
+     * @param {Function} callback - Transaction callback
+     * @returns {Promise<*>} Result of the transaction
+     */
+    async transaction(callback) {
+        // In a real implementation, this would track changes and rollback on error
+        // For this simple implementation, we'll just execute the callback
+        try {
+            const result = await callback({
+                query: (operation, params) => this.query(operation, params)
+            });
+            return result;
+        }
+        catch (error) {
+            // In a real implementation, we would rollback changes here
+            throw error;
+        }
+    }
+}
+//# sourceMappingURL=memory.js.map

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

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

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

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

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

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

package/dist/database/adapters/mongodb.js

@@ -0,0 +1,216 @@
+/**
+ * MongoDB Database Adapter for Coherent.js
+ *
+ * @fileoverview MongoDB adapter implementation with connection pooling and document operations.
+ */
+/**
+ * Create a new MongoDB adapter instance
+ *
+ * @returns {Object} MongoDB adapter instance with database operations
+ */
+export function createMongoDBAdapter() {
+    let mongodb = null;
+    let client = null;
+    let db = null;
+    /**
+     * Initialize MongoDB module
+     *
+     * @private
+     * @returns {Promise<void>}
+     */
+    async function initializeMongoDB() {
+        if (!mongodb) {
+            try {
+                const mongoModule = await import('mongodb');
+                mongodb = mongoModule;
+            }
+            catch {
+                throw new Error('Failed to load mongodb module. Make sure to install it: npm install mongodb');
+            }
+        }
+    }
+    /**
+     * Connect to the database
+     *
+     * @param {Object} config - Database configuration
+     * @param {string} config.url - MongoDB connection URL
+     * @param {string} config.database - Database name
+     * @param {Object} [config.options] - MongoDB client options
+     * @returns {Promise<Object>} The database adapter instance
+     */
+    async function connect(config) {
+        await initializeMongoDB();
+        try {
+            client = new mongodb.MongoClient(config.url, config.options || {});
+            await client.connect();
+            db = client.db(config.database);
+            return instance;
+        }
+        catch (error) {
+            throw new Error(`Failed to connect to MongoDB: ${error.message}`);
+        }
+    }
+    /**
+     * Execute a query on a collection
+     *
+     * @param {string} collectionName - Name of the collection
+     * @param {Object} query - Query object
+     * @param {Object} [options] - Query options
+     * @returns {Promise<Array<Object>>} Query results
+     */
+    async function query(collectionName, query = {}, options = {}) {
+        if (!db) {
+            throw new Error('Database connection not established. Call connect() first.');
+        }
+        try {
+            const collection = db.collection(collectionName);
+            const cursor = collection.find(query, options);
+            if (options.sort) {
+                cursor.sort(options.sort);
+            }
+            if (options.limit) {
+                cursor.limit(options.limit);
+            }
+            if (options.skip) {
+                cursor.skip(options.skip);
+            }
+            if (options.projection) {
+                cursor.project(options.projection);
+            }
+            return cursor.toArray();
+        }
+        catch (error) {
+            throw new Error(`MongoDB query error: ${error.message}`);
+        }
+    }
+    /**
+     * Execute a database command
+     *
+     * @param {Object} command - Database command
+     * @returns {Promise<Object>} Command result
+     */
+    async function execute(command) {
+        if (!db) {
+            throw new Error('Database connection not established. Call connect() first.');
+        }
+        try {
+            return await db.command(command);
+        }
+        catch (error) {
+            throw new Error(`MongoDB command error: ${error.message}`);
+        }
+    }
+    /**
+     * Begin a transaction
+     *
+     * @returns {Promise<Object>} Session object for the transaction
+     */
+    async function beginTransaction() {
+        if (!client) {
+            throw new Error('Database connection not established. Call connect() first.');
+        }
+        const session = client.startSession();
+        session.startTransaction();
+        return session;
+    }
+    /**
+     * Commit a transaction
+     *
+     * @param {Object} session - The session object from beginTransaction
+     * @returns {Promise<void>}
+     */
+    async function commit(session) {
+        if (!session) {
+            throw new Error('No active transaction session');
+        }
+        try {
+            await session.commitTransaction();
+        }
+        finally {
+            await session.endSession();
+        }
+    }
+    /**
+     * Rollback a transaction
+     *
+     * @param {Object} session - The session object from beginTransaction
+     * @returns {Promise<void>}
+     */
+    async function rollback(session) {
+        if (!session) {
+            throw new Error('No active transaction session');
+        }
+        try {
+            await session.abortTransaction();
+        }
+        finally {
+            await session.endSession();
+        }
+    }
+    /**
+     * Disconnect from the database
+     *
+     * @returns {Promise<void>}
+     */
+    async function disconnect() {
+        if (client) {
+            await client.close();
+            client = null;
+            db = null;
+        }
+    }
+    /**
+     * 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 db.command({ ping: 1 });
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+    /**
+     * Escape a value for MongoDB queries
+     *
+     * @param {*} value - Value to escape
+     * @returns {*} Escaped value
+     */
+    function escape(value) {
+        // MongoDB driver handles escaping internally
+        return value;
+    }
+    // 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 MongoDBAdapter = { create: createMongoDBAdapter };
+//# sourceMappingURL=mongodb.js.map

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

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

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

@@ -0,0 +1,12 @@
+/**
+ * MySQL Database Adapter for Coherent.js
+ *
+ * @fileoverview MySQL adapter implementation with connection pooling and transaction support.
+ */
+/**
+ * Create MySQL adapter instance
+ *
+ * @returns {Object} MySQL adapter instance
+ */
+export function createMySQLAdapter(): Object;
+//# sourceMappingURL=mysql.d.ts.map

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

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