@fuzionx/framework 0.1.77 → 0.1.78

package/cli/templates/make/app-spa/views/default/spa/package.json

@@ -9,7 +9,7 @@
     "preview": "vite preview"
   },
   "dependencies": {
-    "@fuzionx/player": "^0.1.77",
+    "@fuzionx/player": "^0.1.78",
     "pinia": "^3.0.4",
     "vue": "^3.5.0",
     "vue-router": "^4.5.0"

package/lib/database/MongoModel.js

@@ -110,63 +110,60 @@ export default class MongoModel extends Model {
 
     /**
      * 레코드 생성
+     *
+     * 실패 시 예외 throw — silent stub 반환 X.
+     * 응용이 "INSERT 성공한 줄 알고" 진행하는 디버깅 지옥 차단.
      * @param {object} data
      * @returns {Promise<MongoModel>}
+     * @throws {Error} mongoose 미설치 / 연결 실패 / 검증 실패 / 키 충돌 등
      */
     static async create(data) {
-        try {
-            const MongooseModel = this._getMongooseModel();
-            const doc = await MongooseModel.create(data);
-            return new this(doc.toObject());
-        } catch {
-            // Mongoose 미설치 → stub
-            return new this({ ...data, _id: Date.now().toString(36) });
-        }
+        const MongooseModel = this._getMongooseModel();
+        const doc = await MongooseModel.create(data);
+        return new this(doc.toObject());
     }
 
     /**
      * ID로 조회
+     *
+     * 레코드가 실제로 없으면 null 반환. 연결/쿼리 오류는 throw — silent null 반환 X.
+     * "USER_NOT_FOUND" 가 실제로 미존재인지 연결 장애인지 구분 가능.
      * @param {*} id
      * @returns {Promise<MongoModel|null>}
+     * @throws {Error} mongoose 미설치 / 연결 실패 / 쿼리 오류 등
      */
     static async find(id) {
-        try {
-            const MongooseModel = this._getMongooseModel();
-            const doc = await MongooseModel.findById(id);
-            return doc ? new this(doc.toObject()) : null;
-        } catch {
-            return null;
-        }
+        const MongooseModel = this._getMongooseModel();
+        const doc = await MongooseModel.findById(id);
+        return doc ? new this(doc.toObject()) : null;
     }
 
     /**
      * 전체 조회
+     *
+     * 결과 없으면 빈 배열 반환. 연결/쿼리 오류는 throw — silent [] 반환 X.
      * @returns {Promise<Array>}
+     * @throws {Error} mongoose 미설치 / 연결 실패 / 쿼리 오류 등
      */
     static async all() {
-        try {
-            const MongooseModel = this._getMongooseModel();
-            const docs = await MongooseModel.find({});
-            return docs.map(d => new this(d.toObject()));
-        } catch {
-            return [];
-        }
+        const MongooseModel = this._getMongooseModel();
+        const docs = await MongooseModel.find({});
+        return docs.map(d => new this(d.toObject()));
     }
 
     static async findAll() { return this.all(); }
 
     /**
      * Raw aggregation pipeline
+     *
+     * 파이프라인 실행 결과 반환. 오류 시 throw — silent [] 반환 X.
      * @param {Array} pipeline
      * @returns {Promise<Array>}
+     * @throws {Error} mongoose 미설치 / 연결 실패 / 파이프라인 오류 등
      */
     static async raw(pipeline) {
-        try {
-            const MongooseModel = this._getMongooseModel();
-            return MongooseModel.aggregate(pipeline);
-        } catch {
-            return [];
-        }
+        const MongooseModel = this._getMongooseModel();
+        return MongooseModel.aggregate(pipeline);
     }
 
     /**
@@ -185,8 +182,13 @@ export default class MongoModel extends Model {
 
     /**
      * 인스턴스 수정
+     *
+     * `_id` 가 없으면 no-op (메모리만 갱신). DB 수정 실패 시 throw —
+     * silent swallow 안 함. 응용이 "DB 저장됐다고 착각하는" 케이스 차단.
+     *
      * @param {object} data
      * @returns {Promise<this>}
+     * @throws {Error} mongoose 미설치 / 연결 실패 / 검증 실패 등
      */
     async update(data) {
         Object.assign(this._attributes, data);
@@ -195,16 +197,13 @@ export default class MongoModel extends Model {
         const id = this._attributes._id || this._attributes[this.constructor.primaryKey];
         if (!id) return this;
 
-        try {
-            const MongooseModel = this.constructor._getMongooseModel();
-            await MongooseModel.updateOne({ _id: id }, { $set: data });
-        } catch {}
-
+        const MongooseModel = this.constructor._getMongooseModel();
+        await MongooseModel.updateOne({ _id: id }, { $set: data });
         return this;
     }
 
     /**
-     * 삭제
+     * 삭제 (soft delete 지원)
      */
     async delete() {
         if (this.constructor.softDelete) {
@@ -219,14 +218,16 @@ export default class MongoModel extends Model {
 
     /**
      * 실제 삭제
+     *
+     * `_id` 없으면 no-op. DB 삭제 오류 시 throw — silent swallow X.
+     *
+     * @throws {Error} mongoose 미설치 / 연결 실패 / 권한 오류 등
      */
     async forceDelete() {
         const id = this._attributes._id || this._attributes[this.constructor.primaryKey];
         if (!id) return;
 
-        try {
-            const MongooseModel = this.constructor._getMongooseModel();
-            await MongooseModel.deleteOne({ _id: id });
-        } catch {}
+        const MongooseModel = this.constructor._getMongooseModel();
+        await MongooseModel.deleteOne({ _id: id });
     }
 }

package/lib/database/SqlQueryBuilder.js

@@ -29,7 +29,12 @@ export default class SqlQueryBuilder extends QueryBuilder {
 
     /**
      * 결과 조회 — SQL SELECT 실행
+     *
+     * 지원 driver (sqlite/knex) 매칭 안 되거나 conn.db 비어 있으면 throw —
+     * silent [] 반환 X. driver 미지원/연결 미수립을 빈 결과로 착각하지 않게.
+     *
      * @returns {Promise<Array<import('./Model.js').default>>}
+     * @throws {Error} 지원 driver 없음 / 연결 미수립
      */
     async get() {
         const conn = this._model.getConnection();
@@ -40,7 +45,9 @@ export default class SqlQueryBuilder extends QueryBuilder {
         } else if (conn.type === 'knex' && conn.db) {
             results = await this._executeKnex(conn.db, 'select');
         } else {
-            results = [];
+            throw new Error(
+                `[SqlQueryBuilder.get] '${this._model.table}' — unsupported driver or no connection (conn.type=${conn?.type}, conn.db=${!!conn?.db})`,
+            );
         }
 
         // eager-loading — with()로 지정된 관계 로드
@@ -63,7 +70,11 @@ export default class SqlQueryBuilder extends QueryBuilder {
 
     /**
      * 카운트
+     *
+     * 지원 driver 매칭 안 되면 throw — silent 0 반환 X.
+     *
      * @returns {Promise<number>}
+     * @throws {Error} 지원 driver 없음 / 연결 미수립
      */
     async count() {
         const conn = this._model.getConnection();
@@ -83,7 +94,9 @@ export default class SqlQueryBuilder extends QueryBuilder {
             return Number(cnt);
         }
 
-        return 0;
+        throw new Error(
+            `[SqlQueryBuilder.count] '${this._model.table}' — unsupported driver or no connection (conn.type=${conn?.type}, conn.db=${!!conn?.db})`,
+        );
     }
 
     /**
@@ -115,12 +128,18 @@ export default class SqlQueryBuilder extends QueryBuilder {
             return query.update(data);
         }
 
-        return 0;
+        throw new Error(
+            `[SqlQueryBuilder.update] '${this._model.table}' — unsupported driver or no connection (conn.type=${conn?.type}, conn.db=${!!conn?.db})`,
+        );
     }
 
     /**
      * 조건부 삭제
+     *
+     * 지원 driver 매칭 안 되면 throw — silent 0 반환 X.
+     *
      * @returns {Promise<number>}
+     * @throws {Error} 지원 driver 없음 / 연결 미수립
      */
     async delete() {
         const conn = this._model.getConnection();
@@ -148,7 +167,9 @@ export default class SqlQueryBuilder extends QueryBuilder {
             return query.delete();
         }
 
-        return 0;
+        throw new Error(
+            `[SqlQueryBuilder.delete] '${this._model.table}' — unsupported driver or no connection (conn.type=${conn?.type}, conn.db=${!!conn?.db})`,
+        );
     }
 
     /**

package/lib/helpers/FileHelper.js

@@ -39,9 +39,25 @@ export default class FileHelper {
         return stat.size;
     }
 
+    /**
+     * 파일 존재 여부.
+     *
+     * ENOENT (파일 없음) 만 false 반환. 권한 오류(EACCES) / 심볼 무한 루프(ELOOP) /
+     * IO 오류 등은 throw — silent false 로 가리지 않음.
+     *
+     * @param {string} filePath
+     * @returns {Promise<boolean>}
+     * @throws {Error} ENOENT 외의 fs 오류
+     */
     async exists(filePath) {
         if (this._bridge?.fileExists) return this._bridge.fileExists(filePath);
-        try { await fs.access(filePath); return true; } catch { return false; }
+        try {
+            await fs.access(filePath);
+            return true;
+        } catch (err) {
+            if (err && err.code === 'ENOENT') return false;
+            throw err;
+        }
     }
 
     async remove(filePath) {

package/lib/schedule/drivers/MemoryQueueDriver.js

@@ -104,7 +104,16 @@ export default class MemoryQueueDriver {
                         if (!this._processing) this._process();
                     }, delay);
                 } else {
-                    try { await task.failed(job.data, err); } catch {}
+                    // Task.failed 콜백 자체가 실패해도 워커 루프는 멈추면 안 됨 (fire-and-forget).
+                    // 단 silent 하지 않게 logger.warn 으로 노출 — 디버깅 가능.
+                    try { await task.failed(job.data, err); }
+                    catch (failedErr) {
+                        const log = this.app?.logger || console;
+                        log.warn?.(
+                            `[MemoryQueueDriver] ${TaskClass.name || 'Task'}.failed() callback threw — ` +
+                            `original error: ${err?.message || err}; failed-callback error: ${failedErr?.message || failedErr}`,
+                        );
+                    }
                 }
             }
         }

package/lib/schedule/drivers/RedisQueueDriver.js

@@ -191,7 +191,16 @@ export default class RedisQueueDriver {
                     job.dead_at = Date.now();
                     await this._client.lpush(deadKey, JSON.stringify(job))
                         .catch(e => this.app?.logger?.error?.(`[Queue:Redis] dead push failed: ${e.message}`));
-                    try { await task.failed(job.data, err); } catch {}
+                    // Task.failed 콜백 자체가 실패해도 워커 루프 유지 (fire-and-forget),
+                    // 단 silent 하지 않게 logger.warn 으로 노출.
+                    try { await task.failed(job.data, err); }
+                    catch (failedErr) {
+                        const log = this.app?.logger || console;
+                        log.warn?.(
+                            `[RedisQueueDriver] ${TaskClass.name || 'Task'}.failed() callback threw — ` +
+                            `original error: ${err?.message || err}; failed-callback error: ${failedErr?.message || failedErr}`,
+                        );
+                    }
                 }
             }
         }

package/lib/services/Storage.js

@@ -117,19 +117,25 @@ export default class Storage {
     }
 
     /**
-     * 파일 존재 여부
+     * 파일 존재 여부.
+     *
+     * ENOENT (파일 없음) 만 false 반환. 권한 오류 / IO 오류 / S3 인증 오류 등은
+     * throw — silent false 로 가리지 않음.
+     *
      * @param {string} filePath
      * @returns {Promise<boolean>}
+     * @throws {Error} ENOENT 외의 fs/S3 오류
      */
     async exists(filePath) {
+        if (this.driver === 's3') {
+            return this._s3Exists(filePath);
+        }
         try {
-            if (this.driver === 's3') {
-                return this._s3Exists(filePath);
-            }
             await fs.access(path.join(this.basePath, filePath));
             return true;
-        } catch {
-            return false;
+        } catch (err) {
+            if (err && err.code === 'ENOENT') return false;
+            throw err;
         }
     }
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fuzionx/framework",
-  "version": "0.1.77",
+  "version": "0.1.78",
   "type": "module",
   "description": "Full-stack MVC framework built on @fuzionx/core — Controller, Service, Model, Middleware, DI, EventBus",
   "main": "index.js",
@@ -35,7 +35,7 @@
   },
   "dependencies": {
     "@aws-sdk/client-s3": "^3.1028.0",
-    "@fuzionx/core": "^0.1.77",
+    "@fuzionx/core": "^0.1.78",
     "better-sqlite3": "^12.8.0",
     "knex": "^3.2.5",
     "mongoose": "^9.3.2",