@fuzionx/framework 0.1.66 → 0.1.67

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

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

package/index.js

@@ -65,4 +65,4 @@ export { default as OpenAPI } from './lib/view/OpenAPI.js';
 export { PaginationUtil, StrUtil, NumUtil, DateUtil, ArrUtil, FunctionUtil, ObjectUtil } from './lib/utilities/index.js';
 
 // ── Built-in Middleware ──
-export { bodyParser, cors, auth, apiAuth, csrf, session, theme, loadUser, roleGuard } from './lib/middleware/index.js';
+export { bodyParser, cors, auth, apiAuth, csrf, session, loadUser } from './lib/middleware/index.js';

package/lib/core/Application.js

@@ -103,6 +103,7 @@ export default class Application {
             fallback: this.config.get('app.i18n.fallback', 'en'),
             dir: this.config.get('app.i18n.dir', './locales'),
             bridge: this._bridge,
+            autoComplete: this.config.get('app.i18n.auto_complete', false),
         });
         this.storage = null;
         this._scheduler = null;

package/lib/helpers/I18nHelper.js

@@ -4,12 +4,18 @@
  * Bridge의 i18NTranslate(locale, key) 직접 호출.
  * Bridge 없으면 JS 파일 기반 폴백.
  *
+ * auto_complete 활성 시 fs.watch로 locale 파일 변경을 감지하여
+ * 디바운스 후 자동 동기화한다. (매 요청마다 파일 I/O 없음)
+ *
  * @see docs/framework/18-i18n.md
  * @see packages/fuzionx/lib/i18n.js (Core 래퍼 참조)
  */
-import { promises as fs } from 'node:fs';
+import { promises as fs, readFileSync, watch as fsWatch, existsSync } from 'node:fs';
 import path from 'node:path';
 
+/** 디바운스 기본 대기 시간 (ms) */
+const RELOAD_DEBOUNCE_MS = 500;
+
 export default class I18nHelper {
     /**
      * @param {object} [opts]
@@ -17,18 +23,24 @@ export default class I18nHelper {
      * @param {string} [opts.fallback='en']
      * @param {string} [opts.dir='./locales']
      * @param {object} [opts.bridge] - Bridge N-API 인스턴스
+     * @param {boolean} [opts.autoComplete=false] - auto_complete 활성 시 파일 감시
      */
     constructor(opts = {}) {
         this.defaultLocale = opts.defaultLocale || 'ko';
         this.fallback = opts.fallback || 'en';
         this.dir = opts.dir || './locales';
         this._bridge = opts.bridge || null;
-        this._messages = new Map(); // locale → { flat key: value }
+        this._autoComplete = !!opts.autoComplete;
+        this._messages = new Map();     // locale → { flat key: value }
         this._loaded = false;
+        this._watcher = null;           // fs.watch 인스턴스
+        this._reloadTimer = null;       // 디바운스 타이머
+        this._dirtyLocales = new Set(); // 변경된 locale 큐
     }
 
     /**
-     * 번역 파일 로드 (JS 폴백용)
+     * 번역 파일 로드 (JS 폴백용).
+     * auto_complete가 활성이면 locale 디렉토리 감시 시작.
      */
     async load() {
         if (this._loaded) return;
@@ -45,6 +57,11 @@ export default class I18nHelper {
             }
         } catch {} // locales/ 없으면 무시
         this._loaded = true;
+
+        // auto_complete 활성 시 파일 감시 시작
+        if (this._autoComplete) {
+            this._startWatcher();
+        }
     }
 
     /**
@@ -86,12 +103,30 @@ export default class I18nHelper {
     }
 
     /**
-     * 전체 locale 데이터 반환 (뷰 주입용)
+     * 전체 locale 데이터 반환 (뷰 주입용).
+     *
+     * Bridge가 있으면 i18NGetTranslations N-API로 최신 데이터를 직접 반환.
+     * Bridge 없으면 JS _messages 폴백.
+     *
      * @param {string} locale
-     * @returns {object}
+     * @returns {object} flat dot-notation 번역 데이터
      */
     all(locale) {
-        const messages = this._messages.get(locale) || this._messages.get(this.defaultLocale);
+        const target = locale || this.defaultLocale;
+
+        /** Bridge 우선 — 메모리에서 직접 최신 데이터 반환 */
+        if (this._bridge && typeof this._bridge.i18NGetTranslations === 'function') {
+            try {
+                const json = this._bridge.i18NGetTranslations(target);
+                if (json) {
+                    const data = JSON.parse(json);
+                    return this._flatten(data); // nested → flat dot-notation
+                }
+            } catch {} // Bridge 실패 시 JS 폴백
+        }
+
+        /** JS 폴백 — _messages 캐시 사용 */
+        const messages = this._messages.get(target) || this._messages.get(this.defaultLocale);
         if (!messages) return {};
         return { ...messages };
     }
@@ -121,6 +156,75 @@ export default class I18nHelper {
         }
     }
 
+    // ──────────────────────────────────────────
+    //  파일 감시 & 디바운스 동기화
+    // ──────────────────────────────────────────
+
+    /**
+     * locale 디렉토리를 fs.watch로 감시 시작.
+     * JSON 파일 변경 감지 시 해당 locale을 dirty 큐에 넣고
+     * 디바운스 타이머 후 일괄 동기화.
+     * @private
+     */
+    _startWatcher() {
+        if (!existsSync(this.dir)) return;
+        try {
+            this._watcher = fsWatch(this.dir, (eventType, filename) => {
+                // .json 파일 변경만 감시
+                if (!filename || !filename.endsWith('.json')) return;
+                const locale = path.basename(filename, '.json');
+                this._dirtyLocales.add(locale); // 큐에 추가
+
+                // 디바운스: 기존 타이머 취소 → 새로 시작
+                clearTimeout(this._reloadTimer);
+                this._reloadTimer = setTimeout(() => {
+                    this._flushDirty();
+                }, RELOAD_DEBOUNCE_MS);
+            });
+        } catch {} // 감시 실패 시 무시 (기존 동작 유지)
+    }
+
+    /**
+     * dirty 큐에 쌓인 locale 파일들을 일괄 동기 재로드.
+     * @private
+     */
+    _flushDirty() {
+        if (this._dirtyLocales.size === 0) return;
+        for (const locale of this._dirtyLocales) {
+            this._syncReload(locale);
+        }
+        this._dirtyLocales.clear();
+    }
+
+    /**
+     * 단일 locale 파일을 동기적으로 재로드.
+     * @param {string} locale - 로드할 locale (예: 'ko', 'en')
+     * @private
+     */
+    _syncReload(locale) {
+        try {
+            const jsonPath = path.join(this.dir, `${locale}.json`);
+            const content = readFileSync(jsonPath, 'utf-8');
+            const data = JSON.parse(content);
+            this._messages.set(locale, this._flatten(data));
+        } catch {} // 파일 없으면 무시
+    }
+
+    /**
+     * 감시자 정리 (graceful shutdown 용)
+     */
+    destroy() {
+        if (this._watcher) {
+            this._watcher.close();
+            this._watcher = null;
+        }
+        clearTimeout(this._reloadTimer);
+    }
+
+    // ──────────────────────────────────────────
+    //  파서 유틸리티
+    // ──────────────────────────────────────────
+
     /** {field} → value 치환 */
     _substitute(template, vars) {
         if (!vars || typeof template !== 'string') return template;

package/lib/middleware/index.js

@@ -1,5 +1,8 @@
 /**
- * 내장 미들웨어 — 배럴 re-export
+ * 내장 미들웨어 — 배럴 re-export (공용)
+ *
+ * 앱 전용 미들웨어(theme, roleGuard 등)는
+ * 각 앱의 middleware/ 폴더에서 직접 구현합니다.
  *
  * @see docs/framework/12-middleware.md
  * @see docs/framework/14-authentication.md
@@ -10,6 +13,4 @@ export { auth } from './auth.js';
 export { apiAuth } from './apiAuth.js';
 export { csrf } from './csrf.js';
 export { session } from './session.js';
-export { theme } from './theme.js';
 export { loadUser } from './loadUser.js';
-export { roleGuard } from './roleGuard.js';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fuzionx/framework",
-  "version": "0.1.66",
+  "version": "0.1.67",
   "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.66",
+    "@fuzionx/core": "^0.1.67",
     "better-sqlite3": "^12.8.0",
     "knex": "^3.2.5",
     "mongoose": "^9.3.2",