@fuzionx/framework 0.1.43 → 0.1.45

package/lib/database/ConnectionManager.js

@@ -1,208 +1,208 @@
-/**
- * ConnectionManager — DB 연결 관리 싱글톤
- *
- * 드라이버별 연결 생성/캐싱/종료.
- * SQLite (기본), MariaDB, PostgreSQL, MongoDB 지원.
- *
- * @see docs/framework/02-database-orm.md
- * @see docs/framework/17-config.md
- */
-import { createRequire } from 'node:module';
-
-const _require = createRequire(import.meta.url);
-
-/**
- * optional dependency 안전 로드
- * @private
- */
-function tryRequire(name) {
-    try { return _require(name); } catch { return null; }
-}
-
-export default class ConnectionManager {
-    constructor() {
-        /** @type {Map<string, object>} name → connection */
-        this._connections = new Map();
-        /** @type {Map<string, object>} name → config */
-        this._configs = new Map();
-        /** @type {string} default connection name */
-        this._default = 'main';
-    }
-
-    /**
-     * 설정으로 초기화
-     * @param {object} dbConfig - fuzionx.yaml database 섹션
-     */
-    configure(dbConfig) {
-        this._default = dbConfig.default || 'main';
-        const connections = dbConfig.connections || {};
-        for (const [name, cfg] of Object.entries(connections)) {
-            this._configs.set(name, cfg);
-        }
-    }
-
-    /**
-     * 연결 가져오기 (lazy 생성)
-     * @param {string} [name] - connection name (default: _default)
-     * @returns {object} driver connection instance
-     */
-    get(name) {
-        const connName = name || this._default;
-        if (this._connections.has(connName)) {
-            return this._connections.get(connName);
-        }
-
-        const config = this._configs.get(connName);
-        if (!config) {
-            throw new Error(`DB connection '${connName}' not configured. Check fuzionx.yaml database.connections.`);
-        }
-
-        const conn = this._createConnection(connName, config);
-        this._connections.set(connName, conn);
-        return conn;
-    }
-
-    /**
-     * 드라이버 타입 조회
-     * @param {string} [name]
-     * @returns {string} 'sqlite' | 'mariadb' | 'postgres' | 'mongodb'
-     */
-    getDriver(name) {
-        const connName = name || this._default;
-        const config = this._configs.get(connName);
-        return config?.driver || 'sqlite';
-    }
-
-    /**
-     * 드라이버별 연결 생성
-     * @private
-     */
-    _createConnection(name, config) {
-        const driver = (config.driver || 'sqlite').toLowerCase();
-
-        switch (driver) {
-            case 'sqlite': {
-                const Database = tryRequire('better-sqlite3');
-                if (!Database) return this._createStub('sqlite', config);
-
-                const dbPath = config.database || config.path || ':memory:';
-                const db = new Database(dbPath, {
-                    verbose: config.verbose ? console.log : undefined,
-                });
-                db.pragma('journal_mode = WAL');
-                db.pragma('foreign_keys = ON');
-                return { type: 'sqlite', db, config };
-            }
-
-            case 'mariadb':
-            case 'mysql': {
-                const knex = tryRequire('knex');
-                if (!knex) return this._createStub('knex', config, 'mariadb');
-
-                const knexInit = typeof knex === 'function' ? knex : knex.default;
-                const db = knexInit({
-                    client: 'mysql2',
-                    connection: {
-                        host: config.host || '127.0.0.1',
-                        port: config.port || 3306,
-                        user: config.user || 'root',
-                        password: config.password || '',
-                        database: config.database || '',
-                        charset: config.charset || 'utf8mb4',
-                    },
-                    pool: config.pool || { min: 2, max: 10 },
-                });
-                return { type: 'knex', driver: 'mariadb', db, config };
-            }
-
-            case 'postgres':
-            case 'postgresql': {
-                const knex = tryRequire('knex');
-                if (!knex) return this._createStub('knex', config, 'postgres');
-
-                const knexInit = typeof knex === 'function' ? knex : knex.default;
-                const db = knexInit({
-                    client: 'pg',
-                    connection: {
-                        host: config.host || '127.0.0.1',
-                        port: config.port || 5432,
-                        user: config.user || 'postgres',
-                        password: config.password || '',
-                        database: config.database || '',
-                    },
-                    pool: config.pool || { min: 2, max: 10 },
-                });
-                return { type: 'knex', driver: 'postgres', db, config };
-            }
-
-            case 'mongodb':
-            case 'mongo': {
-                const mongoose = tryRequire('mongoose');
-                if (!mongoose) return this._createStub('mongo', config);
-                // Lazy connect — promise 캐싱으로 이중 연결 방지
-                const conn = { type: 'mongo', mongoose, config, _connected: false, _connectPromise: null };
-                conn.connect = () => {
-                    if (conn._connected) return Promise.resolve();
-                    if (conn._connectPromise) return conn._connectPromise;
-                    const uri = config.uri || config.url
-                        || `mongodb://${config.host || '127.0.0.1'}:${config.port || 27017}/${config.database || ''}`;
-                    conn._connectPromise = mongoose.connect(uri, config.options || {}).then(() => {
-                        conn._connected = true;
-                    });
-                    return conn._connectPromise;
-                };
-                // 즉시 연결 시작 (await 없이 — 백그라운드)
-                conn.connect().catch(err => {
-                    console.error(`[ConnectionManager] MongoDB 연결 실패: ${err.message}`);
-                });
-                return conn;
-            }
-
-            default:
-                throw new Error(`Unsupported DB driver: '${driver}'. Supported: sqlite, mariadb, postgres, mongodb.`);
-        }
-    }
-
-    /**
-     * 드라이버 미설치 stub
-     * @private
-     */
-    _createStub(type, config, driver) {
-        return { type, driver: driver || type, db: null, config, _stub: true };
-    }
-
-    /**
-     * 모든 연결 종료 (graceful shutdown)
-     */
-    async closeAll() {
-        for (const [name, conn] of this._connections) {
-            try {
-                if (conn.type === 'sqlite' && conn.db) {
-                    conn.db.close();
-                } else if (conn.type === 'knex' && conn.db) {
-                    await conn.db.destroy();
-                } else if (conn.type === 'mongo' && conn.mongoose) {
-                    await conn.mongoose.disconnect();
-                }
-            } catch (err) {
-                console.error(`[ConnectionManager] Error closing '${name}':`, err.message);
-            }
-        }
-        this._connections.clear();
-    }
-
-    /**
-     * 특정 연결 종료
-     * @param {string} name
-     */
-    async close(name) {
-        const conn = this._connections.get(name);
-        if (!conn) return;
-        try {
-            if (conn.type === 'sqlite' && conn.db) conn.db.close();
-            else if (conn.type === 'knex' && conn.db) await conn.db.destroy();
-            else if (conn.type === 'mongo' && conn.mongoose) await conn.mongoose.disconnect();
-        } catch {}
-        this._connections.delete(name);
-    }
-}
+/**
+ * ConnectionManager — DB 연결 관리 싱글톤
+ *
+ * 드라이버별 연결 생성/캐싱/종료.
+ * SQLite (기본), MariaDB, PostgreSQL, MongoDB 지원.
+ *
+ * @see docs/framework/02-database-orm.md
+ * @see docs/framework/17-config.md
+ */
+import { createRequire } from 'node:module';
+
+const _require = createRequire(import.meta.url);
+
+/**
+ * optional dependency 안전 로드
+ * @private
+ */
+function tryRequire(name) {
+    try { return _require(name); } catch { return null; }
+}
+
+export default class ConnectionManager {
+    constructor() {
+        /** @type {Map<string, object>} name → connection */
+        this._connections = new Map();
+        /** @type {Map<string, object>} name → config */
+        this._configs = new Map();
+        /** @type {string} default connection name */
+        this._default = 'main';
+    }
+
+    /**
+     * 설정으로 초기화
+     * @param {object} dbConfig - fuzionx.yaml database 섹션
+     */
+    configure(dbConfig) {
+        this._default = dbConfig.default || 'main';
+        const connections = dbConfig.connections || {};
+        for (const [name, cfg] of Object.entries(connections)) {
+            this._configs.set(name, cfg);
+        }
+    }
+
+    /**
+     * 연결 가져오기 (lazy 생성)
+     * @param {string} [name] - connection name (default: _default)
+     * @returns {object} driver connection instance
+     */
+    get(name) {
+        const connName = name || this._default;
+        if (this._connections.has(connName)) {
+            return this._connections.get(connName);
+        }
+
+        const config = this._configs.get(connName);
+        if (!config) {
+            throw new Error(`DB connection '${connName}' not configured. Check fuzionx.yaml database.connections.`);
+        }
+
+        const conn = this._createConnection(connName, config);
+        this._connections.set(connName, conn);
+        return conn;
+    }
+
+    /**
+     * 드라이버 타입 조회
+     * @param {string} [name]
+     * @returns {string} 'sqlite' | 'mariadb' | 'postgres' | 'mongodb'
+     */
+    getDriver(name) {
+        const connName = name || this._default;
+        const config = this._configs.get(connName);
+        return config?.driver || 'sqlite';
+    }
+
+    /**
+     * 드라이버별 연결 생성
+     * @private
+     */
+    _createConnection(name, config) {
+        const driver = (config.driver || 'sqlite').toLowerCase();
+
+        switch (driver) {
+            case 'sqlite': {
+                const Database = tryRequire('better-sqlite3');
+                if (!Database) return this._createStub('sqlite', config);
+
+                const dbPath = config.database || config.path || ':memory:';
+                const db = new Database(dbPath, {
+                    verbose: config.verbose ? console.log : undefined,
+                });
+                db.pragma('journal_mode = WAL');
+                db.pragma('foreign_keys = ON');
+                return { type: 'sqlite', db, config };
+            }
+
+            case 'mariadb':
+            case 'mysql': {
+                const knex = tryRequire('knex');
+                if (!knex) return this._createStub('knex', config, 'mariadb');
+
+                const knexInit = typeof knex === 'function' ? knex : knex.default;
+                const db = knexInit({
+                    client: 'mysql2',
+                    connection: {
+                        host: config.host || '127.0.0.1',
+                        port: config.port || 3306,
+                        user: config.user || 'root',
+                        password: config.password || '',
+                        database: config.database || '',
+                        charset: config.charset || 'utf8mb4',
+                    },
+                    pool: config.pool || { min: 2, max: 10 },
+                });
+                return { type: 'knex', driver: 'mariadb', db, config };
+            }
+
+            case 'postgres':
+            case 'postgresql': {
+                const knex = tryRequire('knex');
+                if (!knex) return this._createStub('knex', config, 'postgres');
+
+                const knexInit = typeof knex === 'function' ? knex : knex.default;
+                const db = knexInit({
+                    client: 'pg',
+                    connection: {
+                        host: config.host || '127.0.0.1',
+                        port: config.port || 5432,
+                        user: config.user || 'postgres',
+                        password: config.password || '',
+                        database: config.database || '',
+                    },
+                    pool: config.pool || { min: 2, max: 10 },
+                });
+                return { type: 'knex', driver: 'postgres', db, config };
+            }
+
+            case 'mongodb':
+            case 'mongo': {
+                const mongoose = tryRequire('mongoose');
+                if (!mongoose) return this._createStub('mongo', config);
+                // Lazy connect — promise 캐싱으로 이중 연결 방지
+                const conn = { type: 'mongo', mongoose, config, _connected: false, _connectPromise: null };
+                conn.connect = () => {
+                    if (conn._connected) return Promise.resolve();
+                    if (conn._connectPromise) return conn._connectPromise;
+                    const uri = config.uri || config.url
+                        || `mongodb://${config.host || '127.0.0.1'}:${config.port || 27017}/${config.database || ''}`;
+                    conn._connectPromise = mongoose.connect(uri, config.options || {}).then(() => {
+                        conn._connected = true;
+                    });
+                    return conn._connectPromise;
+                };
+                // 즉시 연결 시작 (await 없이 — 백그라운드)
+                conn.connect().catch(err => {
+                    console.error(`[ConnectionManager] MongoDB 연결 실패: ${err.message}`);
+                });
+                return conn;
+            }
+
+            default:
+                throw new Error(`Unsupported DB driver: '${driver}'. Supported: sqlite, mariadb, postgres, mongodb.`);
+        }
+    }
+
+    /**
+     * 드라이버 미설치 stub
+     * @private
+     */
+    _createStub(type, config, driver) {
+        return { type, driver: driver || type, db: null, config, _stub: true };
+    }
+
+    /**
+     * 모든 연결 종료 (graceful shutdown)
+     */
+    async closeAll() {
+        for (const [name, conn] of this._connections) {
+            try {
+                if (conn.type === 'sqlite' && conn.db) {
+                    conn.db.close();
+                } else if (conn.type === 'knex' && conn.db) {
+                    await conn.db.destroy();
+                } else if (conn.type === 'mongo' && conn.mongoose) {
+                    await conn.mongoose.disconnect();
+                }
+            } catch (err) {
+                console.error(`[ConnectionManager] Error closing '${name}':`, err.message);
+            }
+        }
+        this._connections.clear();
+    }
+
+    /**
+     * 특정 연결 종료
+     * @param {string} name
+     */
+    async close(name) {
+        const conn = this._connections.get(name);
+        if (!conn) return;
+        try {
+            if (conn.type === 'sqlite' && conn.db) conn.db.close();
+            else if (conn.type === 'knex' && conn.db) await conn.db.destroy();
+            else if (conn.type === 'mongo' && conn.mongoose) await conn.mongoose.disconnect();
+        } catch {}
+        this._connections.delete(name);
+    }
+}

package/lib/database/MariaModel.js

@@ -1,29 +1,29 @@
-/**
- * MariaModel — MariaDB/MySQL 모델 서브클래스
- *
- * Knex + mysql2 기반.
- * SqlModel의 공통 SQL 로직을 상속하며,
- * MariaDB 고유 기능(FULLTEXT, JSON 등)은 raw()로 접근.
- *
- * @see docs/framework/02-database-orm.md
- *
- * @example
- * import { MariaModel } from '@fuzionx/framework';
- *
- * export default class User extends MariaModel {
- *     static table = 'users';
- *     static connection = 'main';
- *     static timestamps = true;
- *     static columns = {
- *         id:    { type: 'increments' },
- *         name:  { type: 'string', length: 100 },
- *         email: { type: 'string', length: 150, unique: true },
- *     };
- * }
- */
-import SqlModel from './SqlModel.js';
-
-export default class MariaModel extends SqlModel {
-    static driver = 'mariadb';
-    static connection = 'main';
-}
+/**
+ * MariaModel — MariaDB/MySQL 모델 서브클래스
+ *
+ * Knex + mysql2 기반.
+ * SqlModel의 공통 SQL 로직을 상속하며,
+ * MariaDB 고유 기능(FULLTEXT, JSON 등)은 raw()로 접근.
+ *
+ * @see docs/framework/02-database-orm.md
+ *
+ * @example
+ * import { MariaModel } from '@fuzionx/framework';
+ *
+ * export default class User extends MariaModel {
+ *     static table = 'users';
+ *     static connection = 'main';
+ *     static timestamps = true;
+ *     static columns = {
+ *         id:    { type: 'increments' },
+ *         name:  { type: 'string', length: 100 },
+ *         email: { type: 'string', length: 150, unique: true },
+ *     };
+ * }
+ */
+import SqlModel from './SqlModel.js';
+
+export default class MariaModel extends SqlModel {
+    static driver = 'mariadb';
+    static connection = 'main';
+}