@fuzionx/framework 0.1.38 → 0.1.41

package/lib/database/QueryBuilder.js

@@ -1,172 +1,172 @@
-/**
- * QueryBuilder — SQL/MongoDB 쿼리 빌더 (체이닝)
- *
- * @see docs/framework/02-database-orm.md
- * @see docs/framework/class-design.mm.md (QueryBuilder)
- */
-export default class QueryBuilder {
-    constructor(model) {
-        this._model = model;
-        this._wheres = [];
-        this._orders = [];
-        this._limit = null;
-        this._offset = null;
-        this._selects = null;
-        this._withs = [];
-        // softDelete 자동 적용
-        this._softDelete = model?.softDelete || false;
-        this._withTrashed = false;
-        this._onlyTrashed = false;
-    }
-
-    // ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
-    //  체이닝 메서드
-    // ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
-
-    where(key, op, value) {
-        if (value === undefined) { value = op; op = '='; }
-        this._wheres.push({ key, op, value, type: 'and' });
-        return this;
-    }
-
-    /** OR 조건 */
-    orWhere(key, op, value) {
-        if (value === undefined) { value = op; op = '='; }
-        this._wheres.push({ key, op, value, type: 'or' });
-        return this;
-    }
-
-    /** IN 조건 */
-    whereIn(key, values) {
-        this._wheres.push({ key, op: 'IN', value: values, type: 'and' });
-        return this;
-    }
-
-    /** NOT NULL 조건 */
-    whereNotNull(key) {
-        this._wheres.push({ key, op: 'IS NOT NULL', value: null, type: 'and' });
-        return this;
-    }
-
-    /** NULL 조건 */
-    whereNull(key) {
-        this._wheres.push({ key, op: 'IS NULL', value: null, type: 'and' });
-        return this;
-    }
-
-    orderBy(column, direction = 'asc') {
-        this._orders.push({ column, direction });
-        return this;
-    }
-
-    limit(n) { this._limit = n; return this; }
-    offset(n) { this._offset = n; return this; }
-
-    select(...columns) {
-        this._selects = columns.flat();
-        return this;
-    }
-
-    with(...relations) {
-        this._withs.push(...relations.flat());
-        return this;
-    }
-
-    /** softDelete 포함 (삭제된 레코드도 조회) */
-    withTrashed() {
-        this._withTrashed = true;
-        return this;
-    }
-
-    /** softDelete만 조회 (삭제된 레코드만) */
-    onlyTrashed() {
-        this._onlyTrashed = true;
-        return this;
-    }
-
-    // ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
-    //  터미널 메서드
-    // ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
-
-    /**
-     * 페이지네이션
-     * @param {number} page
-     * @param {number} perPage
-     * @returns {Promise<Pagination>}
-     */
-    async paginate(page = 1, perPage = 20) {
-        // Model 서브클래스에서 오버라이드하여 실제 DB 쿼리 실행
-        return {
-            data: [],
-            page,
-            perPage,
-            total: 0,
-            lastPage: 0,
-            _query: this._buildQuery(),
-        };
-    }
-
-    /**
-     * 전체 결과 반환
-     * @returns {Promise<Array>}
-     */
-    async get() {
-        // 서브클래스에서 오버라이드
-        return [];
-    }
-
-    /**
-     * 단일 결과
-     * @returns {Promise<object|null>}
-     */
-    async first() {
-        this._limit = 1;
-        const results = await this.get();
-        return results[0] || null;
-    }
-
-    /**
-     * 결과 수
-     * @returns {Promise<number>}
-     */
-    async count() {
-        // 서브클래스에서 오버라이드
-        return 0;
-    }
-
-    /**
-     * 조건부 수정
-     * @param {object} data
-     * @returns {Promise<number>} 수정된 행 수
-     */
-    async update(data) {
-        // 서브클래스에서 오버라이드
-        return 0;
-    }
-
-    /**
-     * 조건부 삭제
-     * @returns {Promise<number>} 삭제된 행 수
-     */
-    async delete() {
-        // 서브클래스에서 오버라이드
-        return 0;
-    }
-
-    /**
-     * 빌드된 쿼리 파라미터 (디버깅/테스트용)
-     */
-    _buildQuery() {
-        return {
-            wheres: this._wheres,
-            orders: this._orders,
-            limit: this._limit,
-            offset: this._offset,
-            selects: this._selects,
-            withs: this._withs,
-            softDelete: this._softDelete,
-            withTrashed: this._withTrashed,
-            onlyTrashed: this._onlyTrashed,
-        };
-    }
-}
+/**
+ * QueryBuilder — SQL/MongoDB 쿼리 빌더 (체이닝)
+ *
+ * @see docs/framework/02-database-orm.md
+ * @see docs/framework/class-design.mm.md (QueryBuilder)
+ */
+export default class QueryBuilder {
+    constructor(model) {
+        this._model = model;
+        this._wheres = [];
+        this._orders = [];
+        this._limit = null;
+        this._offset = null;
+        this._selects = null;
+        this._withs = [];
+        // softDelete 자동 적용
+        this._softDelete = model?.softDelete || false;
+        this._withTrashed = false;
+        this._onlyTrashed = false;
+    }
+
+    // ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+    //  체이닝 메서드
+    // ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+    where(key, op, value) {
+        if (value === undefined) { value = op; op = '='; }
+        this._wheres.push({ key, op, value, type: 'and' });
+        return this;
+    }
+
+    /** OR 조건 */
+    orWhere(key, op, value) {
+        if (value === undefined) { value = op; op = '='; }
+        this._wheres.push({ key, op, value, type: 'or' });
+        return this;
+    }
+
+    /** IN 조건 */
+    whereIn(key, values) {
+        this._wheres.push({ key, op: 'IN', value: values, type: 'and' });
+        return this;
+    }
+
+    /** NOT NULL 조건 */
+    whereNotNull(key) {
+        this._wheres.push({ key, op: 'IS NOT NULL', value: null, type: 'and' });
+        return this;
+    }
+
+    /** NULL 조건 */
+    whereNull(key) {
+        this._wheres.push({ key, op: 'IS NULL', value: null, type: 'and' });
+        return this;
+    }
+
+    orderBy(column, direction = 'asc') {
+        this._orders.push({ column, direction });
+        return this;
+    }
+
+    limit(n) { this._limit = n; return this; }
+    offset(n) { this._offset = n; return this; }
+
+    select(...columns) {
+        this._selects = columns.flat();
+        return this;
+    }
+
+    with(...relations) {
+        this._withs.push(...relations.flat());
+        return this;
+    }
+
+    /** softDelete 포함 (삭제된 레코드도 조회) */
+    withTrashed() {
+        this._withTrashed = true;
+        return this;
+    }
+
+    /** softDelete만 조회 (삭제된 레코드만) */
+    onlyTrashed() {
+        this._onlyTrashed = true;
+        return this;
+    }
+
+    // ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+    //  터미널 메서드
+    // ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+    /**
+     * 페이지네이션
+     * @param {number} page
+     * @param {number} perPage
+     * @returns {Promise<Pagination>}
+     */
+    async paginate(page = 1, perPage = 20) {
+        // Model 서브클래스에서 오버라이드하여 실제 DB 쿼리 실행
+        return {
+            data: [],
+            page,
+            perPage,
+            total: 0,
+            lastPage: 0,
+            _query: this._buildQuery(),
+        };
+    }
+
+    /**
+     * 전체 결과 반환
+     * @returns {Promise<Array>}
+     */
+    async get() {
+        // 서브클래스에서 오버라이드
+        return [];
+    }
+
+    /**
+     * 단일 결과
+     * @returns {Promise<object|null>}
+     */
+    async first() {
+        this._limit = 1;
+        const results = await this.get();
+        return results[0] || null;
+    }
+
+    /**
+     * 결과 수
+     * @returns {Promise<number>}
+     */
+    async count() {
+        // 서브클래스에서 오버라이드
+        return 0;
+    }
+
+    /**
+     * 조건부 수정
+     * @param {object} data
+     * @returns {Promise<number>} 수정된 행 수
+     */
+    async update(data) {
+        // 서브클래스에서 오버라이드
+        return 0;
+    }
+
+    /**
+     * 조건부 삭제
+     * @returns {Promise<number>} 삭제된 행 수
+     */
+    async delete() {
+        // 서브클래스에서 오버라이드
+        return 0;
+    }
+
+    /**
+     * 빌드된 쿼리 파라미터 (디버깅/테스트용)
+     */
+    _buildQuery() {
+        return {
+            wheres: this._wheres,
+            orders: this._orders,
+            limit: this._limit,
+            offset: this._offset,
+            selects: this._selects,
+            withs: this._withs,
+            softDelete: this._softDelete,
+            withTrashed: this._withTrashed,
+            onlyTrashed: this._onlyTrashed,
+        };
+    }
+}

package/lib/database/SQLiteModel.js

@@ -1,27 +1,27 @@
-/**
- * SQLiteModel — SQLite 모델 서브클래스 (기본 드라이버)
- *
- * better-sqlite3 기반 동기 API.
- * 개발 환경에서 별도 DB 서버 없이 즉시 사용 가능.
- *
- * @see docs/framework/02-database-orm.md
- *
- * @example
- * import { SQLiteModel } from '@fuzionx/framework';
- *
- * export default class User extends SQLiteModel {
- *     static table = 'users';
- *     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 SQLiteModel extends SqlModel {
-    static driver = 'sqlite';
-    static connection = 'main';
-}
+/**
+ * SQLiteModel — SQLite 모델 서브클래스 (기본 드라이버)
+ *
+ * better-sqlite3 기반 동기 API.
+ * 개발 환경에서 별도 DB 서버 없이 즉시 사용 가능.
+ *
+ * @see docs/framework/02-database-orm.md
+ *
+ * @example
+ * import { SQLiteModel } from '@fuzionx/framework';
+ *
+ * export default class User extends SQLiteModel {
+ *     static table = 'users';
+ *     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 SQLiteModel extends SqlModel {
+    static driver = 'sqlite';
+    static connection = 'main';
+}