@fuzionx/framework 0.1.43 → 0.1.44

package/lib/view/OpenAPI.js

@@ -1,231 +1,231 @@
-/**
- * OpenAPI — OpenAPI 3.0 spec 빌더 + Swagger UI
- *
- * 라우트 정의 + Joi 스키마에서 OpenAPI spec 자동 생성.
- *
- * @see docs/framework/21-openapi.md
- */
-
-/**
- * Joi 스키마를 JSON Schema로 변환 (간단 버전)
- * @param {object} joiSchema
- * @returns {object}
- */
-function joiToJsonSchema(joiSchema) {
-    if (!joiSchema) return {};
-
-    // Joi는 describe()로 메타 추출 가능
-    if (typeof joiSchema.describe === 'function') {
-        return convertJoiDescribe(joiSchema.describe());
-    }
-
-    // 이미 plain object면 그대로
-    return joiSchema;
-}
-
-function convertJoiDescribe(desc) {
-    if (!desc) return {};
-
-    if (desc.type === 'object') {
-        const properties = {};
-        const required = [];
-
-        if (desc.keys) {
-            for (const [key, child] of Object.entries(desc.keys)) {
-                properties[key] = convertJoiDescribe(child);
-                if (child.flags?.presence === 'required') {
-                    required.push(key);
-                }
-            }
-        }
-
-        return {
-            type: 'object',
-            properties,
-            ...(required.length ? { required } : {}),
-        };
-    }
-
-    const result = { type: desc.type || 'string' };
-
-    if (desc.flags?.description) result.description = desc.flags.description;
-    if (desc.rules) {
-        for (const rule of desc.rules) {
-            if (rule.name === 'min') result.minLength = rule.args.limit;
-            if (rule.name === 'max') result.maxLength = rule.args.limit;
-        }
-    }
-    if (desc.allow) result.enum = desc.allow;
-    if (desc.flags?.default !== undefined) result.default = desc.flags.default;
-
-    return result;
-}
-
-export default class OpenAPI {
-    /**
-     * @param {object} opts
-     * @param {string} [opts.title='FuzionX API']
-     * @param {string} [opts.version='1.0.0']
-     * @param {string} [opts.description]
-     * @param {Array} [opts.servers]
-     */
-    constructor(opts = {}) {
-        this.title = opts.title || 'FuzionX API';
-        this.version = opts.version || '1.0.0';
-        this.description = opts.description || '';
-        this.servers = opts.servers || [];
-        this._spec = null;
-    }
-
-    /**
-     * 라우트 목록에서 OpenAPI spec 빌드
-     * @param {Array} routes - Router.getRoutes() 결과
-     * @returns {object} - OpenAPI 3.0 spec
-     */
-    build(routes) {
-        const paths = {};
-
-        for (const route of routes) {
-            if (!route.docs) continue;
-
-            const openApiPath = route.path.replace(/:(\w+)/g, '{$1}');
-
-            if (!paths[openApiPath]) paths[openApiPath] = {};
-
-            const method = route.method.toLowerCase();
-            const operation = {
-                summary: route.docs.summary || '',
-                tags: route.docs.tags || [],
-            };
-
-            if (route.docs.description) {
-                operation.description = route.docs.description;
-            }
-            if (route.docs.deprecated) {
-                operation.deprecated = true;
-            }
-
-            // parameters (query + params)
-            const parameters = [];
-
-            if (route.validate?.params) {
-                const schema = joiToJsonSchema(route.validate.params);
-                if (schema.properties) {
-                    for (const [name, prop] of Object.entries(schema.properties)) {
-                        parameters.push({
-                            name,
-                            in: 'path',
-                            required: true,
-                            schema: prop,
-                        });
-                    }
-                }
-            }
-
-            if (route.validate?.query) {
-                const schema = joiToJsonSchema(route.validate.query);
-                if (schema.properties) {
-                    for (const [name, prop] of Object.entries(schema.properties)) {
-                        parameters.push({
-                            name,
-                            in: 'query',
-                            required: schema.required?.includes(name) || false,
-                            schema: prop,
-                        });
-                    }
-                }
-            }
-
-            if (parameters.length) operation.parameters = parameters;
-
-            // requestBody (body)
-            if (route.validate?.body) {
-                const schema = joiToJsonSchema(route.validate.body);
-                operation.requestBody = {
-                    content: {
-                        'application/json': { schema },
-                    },
-                };
-            }
-
-            // responses
-            operation.responses = route.docs.responses || { '200': { description: 'OK' } };
-
-            // security
-            if (route.middleware?.includes('auth') || route.middleware?.includes('apiAuth')) {
-                const scheme = route.middleware.includes('apiAuth') ? 'bearer' : 'session';
-                operation.security = [{ [scheme]: [] }];
-            }
-
-            paths[openApiPath][method] = operation;
-        }
-
-        this._spec = {
-            openapi: '3.0.3',
-            info: {
-                title: this.title,
-                version: this.version,
-                ...(this.description ? { description: this.description } : {}),
-            },
-            ...(this.servers.length ? { servers: this.servers } : {}),
-            paths,
-            components: {
-                securitySchemes: {
-                    bearer: {
-                        type: 'http',
-                        scheme: 'bearer',
-                        bearerFormat: 'JWT',
-                    },
-                    session: {
-                        type: 'apiKey',
-                        in: 'cookie',
-                        name: 'sid',
-                    },
-                },
-            },
-        };
-
-        return this._spec;
-    }
-
-    /**
-     * 캐시된 spec 반환 (JSON)
-     */
-    toJSON() {
-        return this._spec;
-    }
-
-    /**
-     * YAML 포맷 (간단 변환)
-     */
-    toYAML() {
-        return jsonToSimpleYaml(this._spec);
-    }
-}
-
-function jsonToSimpleYaml(obj, indent = 0) {
-    const spaces = ' '.repeat(indent);
-    let result = '';
-
-    for (const [key, value] of Object.entries(obj)) {
-        if (value === null || value === undefined) continue;
-
-        if (Array.isArray(value)) {
-            result += `${spaces}${key}:\n`;
-            for (const item of value) {
-                if (typeof item === 'object') {
-                    result += `${spaces}  -\n${jsonToSimpleYaml(item, indent + 4)}`;
-                } else {
-                    result += `${spaces}  - ${item}\n`;
-                }
-            }
-        } else if (typeof value === 'object') {
-            result += `${spaces}${key}:\n${jsonToSimpleYaml(value, indent + 2)}`;
-        } else {
-            const v = typeof value === 'string' ? `'${value}'` : value;
-            result += `${spaces}${key}: ${v}\n`;
-        }
-    }
-
-    return result;
-}
+/**
+ * OpenAPI — OpenAPI 3.0 spec 빌더 + Swagger UI
+ *
+ * 라우트 정의 + Joi 스키마에서 OpenAPI spec 자동 생성.
+ *
+ * @see docs/framework/21-openapi.md
+ */
+
+/**
+ * Joi 스키마를 JSON Schema로 변환 (간단 버전)
+ * @param {object} joiSchema
+ * @returns {object}
+ */
+function joiToJsonSchema(joiSchema) {
+    if (!joiSchema) return {};
+
+    // Joi는 describe()로 메타 추출 가능
+    if (typeof joiSchema.describe === 'function') {
+        return convertJoiDescribe(joiSchema.describe());
+    }
+
+    // 이미 plain object면 그대로
+    return joiSchema;
+}
+
+function convertJoiDescribe(desc) {
+    if (!desc) return {};
+
+    if (desc.type === 'object') {
+        const properties = {};
+        const required = [];
+
+        if (desc.keys) {
+            for (const [key, child] of Object.entries(desc.keys)) {
+                properties[key] = convertJoiDescribe(child);
+                if (child.flags?.presence === 'required') {
+                    required.push(key);
+                }
+            }
+        }
+
+        return {
+            type: 'object',
+            properties,
+            ...(required.length ? { required } : {}),
+        };
+    }
+
+    const result = { type: desc.type || 'string' };
+
+    if (desc.flags?.description) result.description = desc.flags.description;
+    if (desc.rules) {
+        for (const rule of desc.rules) {
+            if (rule.name === 'min') result.minLength = rule.args.limit;
+            if (rule.name === 'max') result.maxLength = rule.args.limit;
+        }
+    }
+    if (desc.allow) result.enum = desc.allow;
+    if (desc.flags?.default !== undefined) result.default = desc.flags.default;
+
+    return result;
+}
+
+export default class OpenAPI {
+    /**
+     * @param {object} opts
+     * @param {string} [opts.title='FuzionX API']
+     * @param {string} [opts.version='1.0.0']
+     * @param {string} [opts.description]
+     * @param {Array} [opts.servers]
+     */
+    constructor(opts = {}) {
+        this.title = opts.title || 'FuzionX API';
+        this.version = opts.version || '1.0.0';
+        this.description = opts.description || '';
+        this.servers = opts.servers || [];
+        this._spec = null;
+    }
+
+    /**
+     * 라우트 목록에서 OpenAPI spec 빌드
+     * @param {Array} routes - Router.getRoutes() 결과
+     * @returns {object} - OpenAPI 3.0 spec
+     */
+    build(routes) {
+        const paths = {};
+
+        for (const route of routes) {
+            if (!route.docs) continue;
+
+            const openApiPath = route.path.replace(/:(\w+)/g, '{$1}');
+
+            if (!paths[openApiPath]) paths[openApiPath] = {};
+
+            const method = route.method.toLowerCase();
+            const operation = {
+                summary: route.docs.summary || '',
+                tags: route.docs.tags || [],
+            };
+
+            if (route.docs.description) {
+                operation.description = route.docs.description;
+            }
+            if (route.docs.deprecated) {
+                operation.deprecated = true;
+            }
+
+            // parameters (query + params)
+            const parameters = [];
+
+            if (route.validate?.params) {
+                const schema = joiToJsonSchema(route.validate.params);
+                if (schema.properties) {
+                    for (const [name, prop] of Object.entries(schema.properties)) {
+                        parameters.push({
+                            name,
+                            in: 'path',
+                            required: true,
+                            schema: prop,
+                        });
+                    }
+                }
+            }
+
+            if (route.validate?.query) {
+                const schema = joiToJsonSchema(route.validate.query);
+                if (schema.properties) {
+                    for (const [name, prop] of Object.entries(schema.properties)) {
+                        parameters.push({
+                            name,
+                            in: 'query',
+                            required: schema.required?.includes(name) || false,
+                            schema: prop,
+                        });
+                    }
+                }
+            }
+
+            if (parameters.length) operation.parameters = parameters;
+
+            // requestBody (body)
+            if (route.validate?.body) {
+                const schema = joiToJsonSchema(route.validate.body);
+                operation.requestBody = {
+                    content: {
+                        'application/json': { schema },
+                    },
+                };
+            }
+
+            // responses
+            operation.responses = route.docs.responses || { '200': { description: 'OK' } };
+
+            // security
+            if (route.middleware?.includes('auth') || route.middleware?.includes('apiAuth')) {
+                const scheme = route.middleware.includes('apiAuth') ? 'bearer' : 'session';
+                operation.security = [{ [scheme]: [] }];
+            }
+
+            paths[openApiPath][method] = operation;
+        }
+
+        this._spec = {
+            openapi: '3.0.3',
+            info: {
+                title: this.title,
+                version: this.version,
+                ...(this.description ? { description: this.description } : {}),
+            },
+            ...(this.servers.length ? { servers: this.servers } : {}),
+            paths,
+            components: {
+                securitySchemes: {
+                    bearer: {
+                        type: 'http',
+                        scheme: 'bearer',
+                        bearerFormat: 'JWT',
+                    },
+                    session: {
+                        type: 'apiKey',
+                        in: 'cookie',
+                        name: 'sid',
+                    },
+                },
+            },
+        };
+
+        return this._spec;
+    }
+
+    /**
+     * 캐시된 spec 반환 (JSON)
+     */
+    toJSON() {
+        return this._spec;
+    }
+
+    /**
+     * YAML 포맷 (간단 변환)
+     */
+    toYAML() {
+        return jsonToSimpleYaml(this._spec);
+    }
+}
+
+function jsonToSimpleYaml(obj, indent = 0) {
+    const spaces = ' '.repeat(indent);
+    let result = '';
+
+    for (const [key, value] of Object.entries(obj)) {
+        if (value === null || value === undefined) continue;
+
+        if (Array.isArray(value)) {
+            result += `${spaces}${key}:\n`;
+            for (const item of value) {
+                if (typeof item === 'object') {
+                    result += `${spaces}  -\n${jsonToSimpleYaml(item, indent + 4)}`;
+                } else {
+                    result += `${spaces}  - ${item}\n`;
+                }
+            }
+        } else if (typeof value === 'object') {
+            result += `${spaces}${key}:\n${jsonToSimpleYaml(value, indent + 2)}`;
+        } else {
+            const v = typeof value === 'string' ? `'${value}'` : value;
+            result += `${spaces}${key}: ${v}\n`;
+        }
+    }
+
+    return result;
+}

package/lib/view/View.js

@@ -1,83 +1,83 @@
-/**
- * View — 뷰 렌더링 (Bridge Tera SSR)
- *
- * Bridge의 ssrRenderFile N-API로 Tera 파일 기반 렌더링.
- * {% extends %}, {% block %}, {% include %}, {{ t(key="...") }} 완전 지원.
- *
- * Bridge 없으면 반드시 에러 — 폴백 없음.
- *
- * @see docs/framework/03-views-templates.md
- */
-import { join } from 'node:path';
-
-export default class View {
-    /**
-     * @param {object} opts
-     * @param {string} opts.viewsPath - 뷰 파일 루트 경로
-     * @param {string} [opts.theme='default'] - 기본 테마
-     * @param {object} [opts.bridge] - Bridge N-API 인스턴스
-     */
-    constructor(opts = {}) {
-        this.viewsPath = opts.viewsPath || '';
-        this.theme = opts.theme || 'default';
-        this._bridge = opts.bridge || null;
-    }
-
-    /**
-     * 전역 변수 추가
-     * @param {string} key
-     * @param {*} value
-     */
-    share(key, value) {
-        this._globals = this._globals || {};
-        this._globals[key] = value;
-    }
-
-    /**
-     * 템플릿 렌더링 — Bridge ssrRenderFile N-API 사용
-     *
-     * 테마 경로 해석 (03-views-templates.md):
-     * 'home' → ssrRenderFile(viewsPath/{theme}, 'pages/home.html', context, locale)
-     *
-     * @param {string} template - 'home', 'users/index' 등
-     * @param {object} [data] - 템플릿 변수
-     * @param {string} [theme] - 테마 오버라이드
-     * @returns {string} - 렌더링된 HTML
-     */
-    render(template, data = {}, theme) {
-        if (!this._bridge) {
-            throw new Error('Bridge not available — cannot render view');
-        }
-
-        if (typeof this._bridge.ssrRenderFile !== 'function') {
-            throw new Error('Bridge ssrRenderFile not available — rebuild with ssr feature');
-        }
-
-        const activeTheme = theme || data.theme || this.theme;
-        const mergedData = { ...this._globals, ...data, theme: activeTheme };
-        const locale = data.locale || 'ko';
-
-        // Tera glob 루트: views/{theme}/
-        const templateDir = join(this.viewsPath, activeTheme);
-        const contextJson = JSON.stringify(mergedData);
-
-        // 후보 이름: pages/{template}.html → {template}.html
-        const candidates = [
-            `pages/${template}.html`,
-            `${template}.html`,
-        ];
-
-        for (const templateName of candidates) {
-            try {
-                return this._bridge.ssrRenderFile(templateDir, templateName, contextJson, locale);
-            } catch (err) {
-                // 파일 없음 → 다음 후보 (Tera init 에러는 파일 미존재)
-                if (!err.message?.includes('not found') && !err.message?.includes('init failed')) {
-                    throw err; // 렌더링 에러는 그대로 전파
-                }
-            }
-        }
-
-        throw new Error(`View '${template}' not found in theme '${activeTheme}'. Searched: ${candidates.join(', ')}`);
-    }
-}
+/**
+ * View — 뷰 렌더링 (Bridge Tera SSR)
+ *
+ * Bridge의 ssrRenderFile N-API로 Tera 파일 기반 렌더링.
+ * {% extends %}, {% block %}, {% include %}, {{ t(key="...") }} 완전 지원.
+ *
+ * Bridge 없으면 반드시 에러 — 폴백 없음.
+ *
+ * @see docs/framework/03-views-templates.md
+ */
+import { join } from 'node:path';
+
+export default class View {
+    /**
+     * @param {object} opts
+     * @param {string} opts.viewsPath - 뷰 파일 루트 경로
+     * @param {string} [opts.theme='default'] - 기본 테마
+     * @param {object} [opts.bridge] - Bridge N-API 인스턴스
+     */
+    constructor(opts = {}) {
+        this.viewsPath = opts.viewsPath || '';
+        this.theme = opts.theme || 'default';
+        this._bridge = opts.bridge || null;
+    }
+
+    /**
+     * 전역 변수 추가
+     * @param {string} key
+     * @param {*} value
+     */
+    share(key, value) {
+        this._globals = this._globals || {};
+        this._globals[key] = value;
+    }
+
+    /**
+     * 템플릿 렌더링 — Bridge ssrRenderFile N-API 사용
+     *
+     * 테마 경로 해석 (03-views-templates.md):
+     * 'home' → ssrRenderFile(viewsPath/{theme}, 'pages/home.html', context, locale)
+     *
+     * @param {string} template - 'home', 'users/index' 등
+     * @param {object} [data] - 템플릿 변수
+     * @param {string} [theme] - 테마 오버라이드
+     * @returns {string} - 렌더링된 HTML
+     */
+    render(template, data = {}, theme) {
+        if (!this._bridge) {
+            throw new Error('Bridge not available — cannot render view');
+        }
+
+        if (typeof this._bridge.ssrRenderFile !== 'function') {
+            throw new Error('Bridge ssrRenderFile not available — rebuild with ssr feature');
+        }
+
+        const activeTheme = theme || data.theme || this.theme;
+        const mergedData = { ...this._globals, ...data, theme: activeTheme };
+        const locale = data.locale || 'ko';
+
+        // Tera glob 루트: views/{theme}/
+        const templateDir = join(this.viewsPath, activeTheme);
+        const contextJson = JSON.stringify(mergedData);
+
+        // 후보 이름: pages/{template}.html → {template}.html
+        const candidates = [
+            `pages/${template}.html`,
+            `${template}.html`,
+        ];
+
+        for (const templateName of candidates) {
+            try {
+                return this._bridge.ssrRenderFile(templateDir, templateName, contextJson, locale);
+            } catch (err) {
+                // 파일 없음 → 다음 후보 (Tera init 에러는 파일 미존재)
+                if (!err.message?.includes('not found') && !err.message?.includes('init failed')) {
+                    throw err; // 렌더링 에러는 그대로 전파
+                }
+            }
+        }
+
+        throw new Error(`View '${template}' not found in theme '${activeTheme}'. Searched: ${candidates.join(', ')}`);
+    }
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fuzionx/framework",
-  "version": "0.1.43",
+  "version": "0.1.44",
   "type": "module",
   "description": "Full-stack MVC framework built on @fuzionx/core — Controller, Service, Model, Middleware, DI, EventBus",
   "main": "index.js",
@@ -34,7 +34,7 @@
     "url": "https://github.com/saytohenry/fuzionx"
   },
   "dependencies": {
-    "@fuzionx/core": "^0.1.43",
+    "@fuzionx/core": "^0.1.44",
     "better-sqlite3": "^12.8.0",
     "knex": "^3.2.5",
     "mongoose": "^9.3.2",