npm - @fuzionx/framework - Versions diffs - 0.1.42 → 0.1.44 - Mend

@fuzionx/framework 0.1.42 → 0.1.44

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (80) hide show

package/README.md +501 -501
package/bin/fx.js +12 -12
package/cli/db-sync.js +100 -100
package/cli/index.js +494 -494
package/cli/templates/make/app/controllers/HomeController.js +14 -14
package/cli/templates/make/app/routes/api.js +7 -7
package/cli/templates/make/app/routes/web.js +5 -5
package/cli/templates/make/app/views/default/errors/404.html +11 -11
package/cli/templates/make/app/views/default/errors/500.html +14 -14
package/cli/templates/make/app/views/default/layouts/main.html +22 -22
package/cli/templates/make/app/views/default/pages/home.html +11 -11
package/cli/templates/make/controller.js.tpl +40 -40
package/cli/templates/make/event.js.tpl +8 -8
package/cli/templates/make/job.js.tpl +10 -10
package/cli/templates/make/middleware.js.tpl +10 -10
package/cli/templates/make/model.js.tpl +15 -15
package/cli/templates/make/service.js.tpl +15 -15
package/cli/templates/make/task.js.tpl +15 -15
package/cli/templates/make/test.js.tpl +7 -7
package/cli/templates/make/worker.js.tpl +14 -14
package/cli/templates/make/ws.js.tpl +18 -18
package/index.js +67 -67
package/lib/core/AppError.js +46 -46
package/lib/core/Application.js +1006 -1006
package/lib/core/AutoLoader.js +227 -227
package/lib/core/Base.js +64 -64
package/lib/core/Config.js +331 -228
package/lib/core/Context.js +484 -484
package/lib/database/ConnectionManager.js +208 -208
package/lib/database/MariaModel.js +29 -29
package/lib/database/Model.js +247 -247
package/lib/database/ModelRegistry.js +72 -72
package/lib/database/MongoModel.js +232 -232
package/lib/database/Pagination.js +37 -37
package/lib/database/PostgreModel.js +29 -29
package/lib/database/QueryBuilder.js +172 -172
package/lib/database/SQLiteModel.js +27 -27
package/lib/database/SqlModel.js +257 -257
package/lib/database/SqlQueryBuilder.js +332 -332
package/lib/helpers/CryptoHelper.js +48 -48
package/lib/helpers/FileHelper.js +61 -61
package/lib/helpers/HashHelper.js +39 -39
package/lib/helpers/I18nHelper.js +174 -174
package/lib/helpers/Logger.js +108 -108
package/lib/helpers/MediaHelper.js +84 -84
package/lib/http/Controller.js +34 -34
package/lib/http/ErrorHandler.js +136 -136
package/lib/http/Middleware.js +43 -43
package/lib/http/Router.js +109 -109
package/lib/http/Validation.js +125 -125
package/lib/middleware/apiAuth.js +79 -79
package/lib/middleware/auth.js +42 -42
package/lib/middleware/bodyParser.js +19 -19
package/lib/middleware/cors.js +47 -47
package/lib/middleware/csrf.js +32 -32
package/lib/middleware/index.js +13 -13
package/lib/middleware/session.js +27 -27
package/lib/middleware/theme.js +20 -20
package/lib/realtime/RoomManager.js +85 -85
package/lib/realtime/WsHandler.js +107 -107
package/lib/schedule/Job.js +38 -38
package/lib/schedule/Queue.js +103 -103
package/lib/schedule/Scheduler.js +171 -171
package/lib/schedule/Task.js +39 -39
package/lib/schedule/WorkerPool.js +225 -225
package/lib/services/EventBus.js +94 -94
package/lib/services/Service.js +261 -261
package/lib/services/Storage.js +112 -112
package/lib/utilities/ArrUtil.js +112 -112
package/lib/utilities/DateUtil.js +98 -98
package/lib/utilities/FunctionUtil.js +119 -119
package/lib/utilities/NumUtil.js +75 -75
package/lib/utilities/ObjectUtil.js +170 -170
package/lib/utilities/PaginationUtil.js +81 -81
package/lib/utilities/StrUtil.js +105 -105
package/lib/utilities/index.js +18 -18
package/lib/view/OpenAPI.js +231 -231
package/lib/view/View.js +83 -83
package/package.json +2 -2
package/testing/index.js +232 -232

package/lib/http/ErrorHandler.js CHANGED Viewed

@@ -1,136 +1,136 @@
-/**
- * ErrorHandler — 기본 에러 핸들러 (JSON/HTML 분기 + 테마 에러 페이지)
- *
- * @see docs/framework/08-error-handling.md
- * @see docs/framework/03-views-templates.md (에러 페이지)
- */
-import AppError, { ValidationError } from '../core/AppError.js';
-export default class ErrorHandler {
-    /**
-     * @param {object} opts
-     * @param {boolean} [opts.isDev=false] - dev 모드에서 스택 노출
-     * @param {Function} [opts.logger] - 에러 로깅 함수
-     * @param {import('./View.js').default} [opts.view] - 뷰 렌더러 (테마 에러 페이지용)
-     */
-    constructor(opts = {}) {
-        this.isDev = opts.isDev ?? false;
-        this.logger = opts.logger || console.error;
-        this._view = opts.view || null;
-    }
-    /**
-     * 에러 처리 — ctx에 응답 세팅
-     * @param {Error} err
-     * @param {import('./Context.js').default} ctx
-     */
-    handle(err, ctx) {
-        const status = err.status || 500;
-        // 500 에러는 로깅
-        if (status >= 500) {
-            this.logger(err);
-        }
-        // JSON 응답 요청이면 JSON으로
-        const wantsJson = ctx.get('accept')?.includes('application/json')
-            || ctx.is('json')
-            || ctx.path?.startsWith('/api');
-        if (wantsJson) {
-            return this._jsonResponse(err, ctx, status);
-        }
-        return this._htmlResponse(err, ctx, status);
-    }
-    /** @private */
-    _jsonResponse(err, ctx, status) {
-        const body = {
-            error: {
-                message: err.message,
-                status,
-            },
-        };
-        // ValidationError → 필드 에러 포함
-        if (err instanceof ValidationError) {
-            body.error.fields = err.fields;
-        }
-        // dev 모드에서 스택 노출
-        if (this.isDev && status >= 500) {
-            body.error.stack = err.stack;
-        }
-        // 추가 데이터
-        if (err.data && !(err instanceof ValidationError)) {
-            body.error.data = err.data;
-        }
-        ctx.status(status).json(body);
-    }
-    /**
-     * HTML 에러 응답 — 테마 에러 페이지 지원
-     *
-     * 검색 순서 (03-views-templates.md):
-     * 1. views/{theme}/errors/{code}.html
-     * 2. views/{theme}/errors/default.html
-     * 3. 프레임워크 내장 에러 페이지
-     *
-     * @private
-     */
-    _htmlResponse(err, ctx, status) {
-        const errorData = {
-            error: {
-                code: status,
-                message: err.message,
-                stack: this.isDev ? err.stack : null,
-            },
-            request: { url: ctx.url, method: ctx.method },
-            config: { debug: this.isDev },
-        };
-        // 테마 에러 페이지 시도 (View 렌더러가 있을 때)
-        const appEntry = ctx.app?._appRegistry?.get(ctx.appName);
-        const view = this._view || appEntry?.view;
-        if (view) {
-            const theme = ctx.theme || ctx.app?.config?.get('themes.default', 'default') || 'default';
-            // 1. views/{theme}/errors/{code}.html
-            try {
-                const html = view.render(`errors/${status}`, errorData);
-                if (html && !html.startsWith('<!-- template:')) {
-                    ctx.status(status).html(html);
-                    return;
-                }
-            } catch {}
-            // 2. views/{theme}/errors/default.html
-            try {
-                const html = view.render('errors/default', errorData);
-                if (html && !html.startsWith('<!-- template:')) {
-                    ctx.status(status).html(html);
-                    return;
-                }
-            } catch {}
-        }
-        // 3. 프레임워크 내장 에러 페이지 (XSS 방지)
-        const esc = (s) => String(s)
-            .replace(/&/g, '&amp;').replace(/</g, '&lt;')
-            .replace(/>/g, '&gt;').replace(/"/g, '&quot;');
-        const title = status >= 500 ? 'Server Error' : esc(err.message);
-        ctx.status(status).html(
-            `<!DOCTYPE html><html><head><meta charset="utf-8"><title>${status}</title>` +
-            `<style>body{font-family:system-ui,-apple-system,sans-serif;max-width:600px;margin:80px auto;` +
-            `padding:0 20px;color:#333}h1{color:#e74c3c;}pre{background:#f5f5f5;padding:16px;border-radius:8px;` +
-            `overflow-x:auto;font-size:13px;}</style></head>` +
-            `<body><h1>${status} — ${title}</h1>` +
-            `<p>요청: ${esc(ctx.method)} ${esc(ctx.url)}</p>` +
-            `${this.isDev && err.stack ? `<pre>${esc(err.stack)}</pre>` : ''}` +
-            `</body></html>`
-        );
-    }
-}
+/**
+ * ErrorHandler — 기본 에러 핸들러 (JSON/HTML 분기 + 테마 에러 페이지)
+ *
+ * @see docs/framework/08-error-handling.md
+ * @see docs/framework/03-views-templates.md (에러 페이지)
+ */
+import AppError, { ValidationError } from '../core/AppError.js';
+export default class ErrorHandler {
+    /**
+     * @param {object} opts
+     * @param {boolean} [opts.isDev=false] - dev 모드에서 스택 노출
+     * @param {Function} [opts.logger] - 에러 로깅 함수
+     * @param {import('./View.js').default} [opts.view] - 뷰 렌더러 (테마 에러 페이지용)
+     */
+    constructor(opts = {}) {
+        this.isDev = opts.isDev ?? false;
+        this.logger = opts.logger || console.error;
+        this._view = opts.view || null;
+    }
+    /**
+     * 에러 처리 — ctx에 응답 세팅
+     * @param {Error} err
+     * @param {import('./Context.js').default} ctx
+     */
+    handle(err, ctx) {
+        const status = err.status || 500;
+        // 500 에러는 로깅
+        if (status >= 500) {
+            this.logger(err);
+        }
+        // JSON 응답 요청이면 JSON으로
+        const wantsJson = ctx.get('accept')?.includes('application/json')
+            || ctx.is('json')
+            || ctx.path?.startsWith('/api');
+        if (wantsJson) {
+            return this._jsonResponse(err, ctx, status);
+        }
+        return this._htmlResponse(err, ctx, status);
+    }
+    /** @private */
+    _jsonResponse(err, ctx, status) {
+        const body = {
+            error: {
+                message: err.message,
+                status,
+            },
+        };
+        // ValidationError → 필드 에러 포함
+        if (err instanceof ValidationError) {
+            body.error.fields = err.fields;
+        }
+        // dev 모드에서 스택 노출
+        if (this.isDev && status >= 500) {
+            body.error.stack = err.stack;
+        }
+        // 추가 데이터
+        if (err.data && !(err instanceof ValidationError)) {
+            body.error.data = err.data;
+        }
+        ctx.status(status).json(body);
+    }
+    /**
+     * HTML 에러 응답 — 테마 에러 페이지 지원
+     *
+     * 검색 순서 (03-views-templates.md):
+     * 1. views/{theme}/errors/{code}.html
+     * 2. views/{theme}/errors/default.html
+     * 3. 프레임워크 내장 에러 페이지
+     *
+     * @private
+     */
+    _htmlResponse(err, ctx, status) {
+        const errorData = {
+            error: {
+                code: status,
+                message: err.message,
+                stack: this.isDev ? err.stack : null,
+            },
+            request: { url: ctx.url, method: ctx.method },
+            config: { debug: this.isDev },
+        };
+        // 테마 에러 페이지 시도 (View 렌더러가 있을 때)
+        const appEntry = ctx.app?._appRegistry?.get(ctx.appName);
+        const view = this._view || appEntry?.view;
+        if (view) {
+            const theme = ctx.theme || ctx.app?.config?.get('themes.default', 'default') || 'default';
+            // 1. views/{theme}/errors/{code}.html
+            try {
+                const html = view.render(`errors/${status}`, errorData);
+                if (html && !html.startsWith('<!-- template:')) {
+                    ctx.status(status).html(html);
+                    return;
+                }
+            } catch {}
+            // 2. views/{theme}/errors/default.html
+            try {
+                const html = view.render('errors/default', errorData);
+                if (html && !html.startsWith('<!-- template:')) {
+                    ctx.status(status).html(html);
+                    return;
+                }
+            } catch {}
+        }
+        // 3. 프레임워크 내장 에러 페이지 (XSS 방지)
+        const esc = (s) => String(s)
+            .replace(/&/g, '&amp;').replace(/</g, '&lt;')
+            .replace(/>/g, '&gt;').replace(/"/g, '&quot;');
+        const title = status >= 500 ? 'Server Error' : esc(err.message);
+        ctx.status(status).html(
+            `<!DOCTYPE html><html><head><meta charset="utf-8"><title>${status}</title>` +
+            `<style>body{font-family:system-ui,-apple-system,sans-serif;max-width:600px;margin:80px auto;` +
+            `padding:0 20px;color:#333}h1{color:#e74c3c;}pre{background:#f5f5f5;padding:16px;border-radius:8px;` +
+            `overflow-x:auto;font-size:13px;}</style></head>` +
+            `<body><h1>${status} — ${title}</h1>` +
+            `<p>요청: ${esc(ctx.method)} ${esc(ctx.url)}</p>` +
+            `${this.isDev && err.stack ? `<pre>${esc(err.stack)}</pre>` : ''}` +
+            `</body></html>`
+        );
+    }
+}

package/lib/http/Middleware.js CHANGED Viewed

@@ -1,43 +1,43 @@
-/**
- * Middleware — 기본 미들웨어 클래스
- *
- * @see docs/framework/12-middleware.md
- * @see docs/framework/class-design.mm.md (Middleware)
- */
-import Base from '../core/Base.js';
-export default class Middleware extends Base {
-    /** @type {string} 미들웨어 등록 이름 (라우트에서 참조) */
-    static alias = '';
-    /**
-     * 미들웨어 핸들러 (서브클래스에서 오버라이드)
-     * @param {import('./Context.js').default} ctx
-     * @param {Function} next
-     * @param {...*} params - 파라미터화 미들웨어 인자 ('name:param1:param2')
-     */
-    async handle(ctx, next, ...params) {
-        await next();
-    }
-}
-/**
- * 미들웨어 체인 실행기
- *
- * @param {Array<Function>} middlewares - [(ctx, next) => ...] 배열
- * @param {import('./Context.js').default} ctx
- * @returns {Promise<void>}
- */
-export async function runMiddlewareChain(middlewares, ctx) {
-    let idx = 0;
-    async function next(err) {
-        if (err) throw err;
-        if (idx >= middlewares.length) return;
-        const fn = middlewares[idx++];
-        await fn(ctx, next);
-    }
-    await next();
-}
+/**
+ * Middleware — 기본 미들웨어 클래스
+ *
+ * @see docs/framework/12-middleware.md
+ * @see docs/framework/class-design.mm.md (Middleware)
+ */
+import Base from '../core/Base.js';
+export default class Middleware extends Base {
+    /** @type {string} 미들웨어 등록 이름 (라우트에서 참조) */
+    static alias = '';
+    /**
+     * 미들웨어 핸들러 (서브클래스에서 오버라이드)
+     * @param {import('./Context.js').default} ctx
+     * @param {Function} next
+     * @param {...*} params - 파라미터화 미들웨어 인자 ('name:param1:param2')
+     */
+    async handle(ctx, next, ...params) {
+        await next();
+    }
+}
+/**
+ * 미들웨어 체인 실행기
+ *
+ * @param {Array<Function>} middlewares - [(ctx, next) => ...] 배열
+ * @param {import('./Context.js').default} ctx
+ * @returns {Promise<void>}
+ */
+export async function runMiddlewareChain(middlewares, ctx) {
+    let idx = 0;
+    async function next(err) {
+        if (err) throw err;
+        if (idx >= middlewares.length) return;
+        const fn = middlewares[idx++];
+        await fn(ctx, next);
+    }
+    await next();
+}

package/lib/http/Router.js CHANGED Viewed

@@ -1,109 +1,109 @@
-/**
- * Router / RouteGroup — 라우트 등록 DSL
- *
- * @see docs/framework/01-routing-controllers.md
- * @see docs/framework/class-design.mm.md (Router/RouteGroup)
- */
-export class RouteGroup {
-    /**
-     * @param {string} prefix - 그룹 접두사 ('', '/api')
-     * @param {object} [groupOpts] - 그룹 옵션 { middleware }
-     */
-    constructor(prefix = '', groupOpts = {}) {
-        this._prefix = prefix;
-        this._groupMiddleware = groupOpts.middleware || [];
-        this._routes = [];
-    }
-    /**
-     * @param {string} method
-     * @param {string} path
-     * @param {Function|object} handler
-     * @param {object} [opts]
-     */
-    _addRoute(method, path, handler, opts = {}) {
-        const fullPath = this._prefix + path;
-        this._routes.push({
-            method,
-            path: fullPath,
-            handler,
-            middleware: [...this._groupMiddleware, ...(opts.middleware || [])],
-            validate: opts.validate || null,
-            upload: opts.upload || null,
-            docs: opts.docs || null,
-        });
-    }
-    get(path, handler, opts) { this._addRoute('GET', path, handler, opts); }
-    post(path, handler, opts) { this._addRoute('POST', path, handler, opts); }
-    put(path, handler, opts) { this._addRoute('PUT', path, handler, opts); }
-    patch(path, handler, opts) { this._addRoute('PATCH', path, handler, opts); }
-    delete(path, handler, opts) { this._addRoute('DELETE', path, handler, opts); }
-    /**
-     * 그룹 — 중첩 라우트
-     * 인자 순서: (prefix, opts, callback) 또는 (prefix, callback, opts)
-     * @param {string} prefix
-     * @param {object|Function} optsOrCallback
-     * @param {Function|object} [callbackOrOpts]
-     */
-    group(prefix, optsOrCallback, callbackOrOpts) {
-        let opts, callback;
-        if (typeof optsOrCallback === 'function') {
-            // group('/api', (r) => {}, opts?)
-            callback = optsOrCallback;
-            opts = callbackOrOpts || {};
-        } else {
-            // group('/api', { middleware: [...] }, (r) => {})
-            opts = optsOrCallback || {};
-            callback = callbackOrOpts;
-        }
-        const subGroup = new RouteGroup(this._prefix + prefix, {
-            middleware: [...this._groupMiddleware, ...(opts.middleware || [])],
-        });
-        callback(subGroup);
-        this._routes.push(...subGroup._routes);
-    }
-    /**
-     * RESTful resource 자동 등록
-     * @param {string} name - 리소스 이름 (복수형, e.g. 'users')
-     * @param {object} controller - Controller 클래스 (메서드 레퍼런스)
-     * @param {object} [opts]
-     */
-    resource(name, controller, opts = {}) {
-        const basePath = `/${name}`;
-        const middleware = opts.middleware || [];
-        const base = { middleware };
-        if (controller.index) this.get(basePath, controller.index, base);
-        if (controller.store) this.post(basePath, controller.store, base);
-        if (controller.show) this.get(`${basePath}/:id`, controller.show, base);
-        if (controller.update) this.put(`${basePath}/:id`, controller.update, base);
-        if (controller.destroy) this.delete(`${basePath}/:id`, controller.destroy, base);
-    }
-}
-export default class Router extends RouteGroup {
-    constructor() {
-        super('');
-    }
-    /**
-     * 모든 등록된 라우트 반환
-     * @returns {Array<{method, path, handler, middleware, validate, upload, docs}>}
-     */
-    getRoutes() {
-        return this._routes;
-    }
-    /**
-     * 라우트 파일 로드 (routes/ callback 등록)
-     * @param {Function} routeCallback - (r: RouteGroup) => void
-     */
-    load(routeCallback) {
-        routeCallback(this);
-    }
-}
+/**
+ * Router / RouteGroup — 라우트 등록 DSL
+ *
+ * @see docs/framework/01-routing-controllers.md
+ * @see docs/framework/class-design.mm.md (Router/RouteGroup)
+ */
+export class RouteGroup {
+    /**
+     * @param {string} prefix - 그룹 접두사 ('', '/api')
+     * @param {object} [groupOpts] - 그룹 옵션 { middleware }
+     */
+    constructor(prefix = '', groupOpts = {}) {
+        this._prefix = prefix;
+        this._groupMiddleware = groupOpts.middleware || [];
+        this._routes = [];
+    }
+    /**
+     * @param {string} method
+     * @param {string} path
+     * @param {Function|object} handler
+     * @param {object} [opts]
+     */
+    _addRoute(method, path, handler, opts = {}) {
+        const fullPath = this._prefix + path;
+        this._routes.push({
+            method,
+            path: fullPath,
+            handler,
+            middleware: [...this._groupMiddleware, ...(opts.middleware || [])],
+            validate: opts.validate || null,
+            upload: opts.upload || null,
+            docs: opts.docs || null,
+        });
+    }
+    get(path, handler, opts) { this._addRoute('GET', path, handler, opts); }
+    post(path, handler, opts) { this._addRoute('POST', path, handler, opts); }
+    put(path, handler, opts) { this._addRoute('PUT', path, handler, opts); }
+    patch(path, handler, opts) { this._addRoute('PATCH', path, handler, opts); }
+    delete(path, handler, opts) { this._addRoute('DELETE', path, handler, opts); }
+    /**
+     * 그룹 — 중첩 라우트
+     * 인자 순서: (prefix, opts, callback) 또는 (prefix, callback, opts)
+     * @param {string} prefix
+     * @param {object|Function} optsOrCallback
+     * @param {Function|object} [callbackOrOpts]
+     */
+    group(prefix, optsOrCallback, callbackOrOpts) {
+        let opts, callback;
+        if (typeof optsOrCallback === 'function') {
+            // group('/api', (r) => {}, opts?)
+            callback = optsOrCallback;
+            opts = callbackOrOpts || {};
+        } else {
+            // group('/api', { middleware: [...] }, (r) => {})
+            opts = optsOrCallback || {};
+            callback = callbackOrOpts;
+        }
+        const subGroup = new RouteGroup(this._prefix + prefix, {
+            middleware: [...this._groupMiddleware, ...(opts.middleware || [])],
+        });
+        callback(subGroup);
+        this._routes.push(...subGroup._routes);
+    }
+    /**
+     * RESTful resource 자동 등록
+     * @param {string} name - 리소스 이름 (복수형, e.g. 'users')
+     * @param {object} controller - Controller 클래스 (메서드 레퍼런스)
+     * @param {object} [opts]
+     */
+    resource(name, controller, opts = {}) {
+        const basePath = `/${name}`;
+        const middleware = opts.middleware || [];
+        const base = { middleware };
+        if (controller.index) this.get(basePath, controller.index, base);
+        if (controller.store) this.post(basePath, controller.store, base);
+        if (controller.show) this.get(`${basePath}/:id`, controller.show, base);
+        if (controller.update) this.put(`${basePath}/:id`, controller.update, base);
+        if (controller.destroy) this.delete(`${basePath}/:id`, controller.destroy, base);
+    }
+}
+export default class Router extends RouteGroup {
+    constructor() {
+        super('');
+    }
+    /**
+     * 모든 등록된 라우트 반환
+     * @returns {Array<{method, path, handler, middleware, validate, upload, docs}>}
+     */
+    getRoutes() {
+        return this._routes;
+    }
+    /**
+     * 라우트 파일 로드 (routes/ callback 등록)
+     * @param {Function} routeCallback - (r: RouteGroup) => void
+     */
+    load(routeCallback) {
+        routeCallback(this);
+    }
+}