@fuzionx/framework 0.1.39 → 0.1.41

package/lib/core/Config.js

@@ -1,228 +1,228 @@
-/**
- * Config — 통합 설정 접근
- *
- * fuzionx.yaml의 3개 섹션(bridge, database, app)을 통합 관리.
- * dot-notation으로 접근: config.get('app.auth.secret')
- *
- * .env 자동 로드 + ${VAR:default} 환경변수 치환.
- * YAML 파일 직접 파싱 지원 (외부 의존 없이 내장 파서 사용).
- *
- * @see docs/framework/17-config.md
- */
-import { readFileSync, existsSync } from 'node:fs';
-import path from 'node:path';
-
-export default class Config {
-    /**
-     * @param {object} raw - 파싱된 YAML 객체 전체
-     *   raw.bridge  — Bridge(Rust)가 파싱한 bridge: 섹션
-     *   raw.database — JS가 파싱한 database: 섹션
-     *   raw.app      — JS가 파싱한 app: 섹션
-     */
-    constructor(raw = {}) {
-        this.bridge = raw.bridge || {};
-        this.database = raw.database || {};
-        this.app = raw.app || {};
-        this._raw = raw;
-        this._cache = new Map();
-    }
-
-    /**
-     * YAML 파일에서 설정 로드.
-     * configPath가 지정된 경우 Application 생성자에서 호출.
-     * bridge 섹션은 Rust에서 파싱하므로 JS 쪽은 database/app/themes 등을 로드.
-     * @param {string} configPath - 절대 경로
-     */
-    loadYaml(configPath) {
-        if (!existsSync(configPath)) return;
-
-        try {
-            const content = readFileSync(configPath, 'utf-8');
-            const raw = Config.parseYaml(content);
-            const parsed = Config.resolveEnvVars(raw);
-
-            // _raw에 병합 (기존 opts.config 우선)
-            for (const [key, value] of Object.entries(parsed)) {
-                if (this._raw[key] === undefined) {
-                    this._raw[key] = value;
-                }
-            }
-
-            // 섹션 별칭 갱신
-            if (!Object.keys(this.bridge).length && parsed.bridge) this.bridge = parsed.bridge;
-            if (!Object.keys(this.database).length && parsed.database) this.database = parsed.database;
-            if (!Object.keys(this.app).length && parsed.app) this.app = parsed.app;
-
-            // 캐시 초기화
-            this._cache.clear();
-        } catch (err) {
-            console.error(`[Config] YAML 파일 로드 실패 (${configPath}):`, err.message);
-        }
-    }
-
-    /**
-     * 간이 YAML 파서 — 외부 의존 없이 fuzionx.yaml 구조 파싱.
-     * 지원: 중첩 객체, 문자열, 숫자, boolean, 배열(인라인), 인용 문자열.
-     * @param {string} content
-     * @returns {object}
-     */
-    static parseYaml(content) {
-        const result = {};
-        const lines = content.split('\n');
-        const stack = [{ indent: -1, obj: result }];
-
-        for (const rawLine of lines) {
-            // 주석/빈 줄 무시
-            const line = rawLine.replace(/#.*$/, '');
-            if (!line.trim()) continue;
-
-            const indent = line.search(/\S/);
-            // 키: unquoted ([-\w.]+) 또는 quoted ("..." / '...')
-            const match = line.match(/^(\s*)(?:(["'])([^"']+)\2|([-\w.]+))\s*:\s*(.*)$/);
-            if (!match) continue;
-
-            const key = match[3] || match[4]; // quoted key (그룹3) 또는 unquoted key (그룹4)
-            const rawValue = match[5];
-
-            // 스택에서 현재 indent보다 깊거나 같은 레벨 제거
-            while (stack.length > 1 && stack[stack.length - 1].indent >= indent) {
-                stack.pop();
-            }
-
-            const parent = stack[stack.length - 1].obj;
-            const value = rawValue.trim();
-
-            if (!value) {
-                // 하위 객체 시작
-                parent[key] = {};
-                stack.push({ indent, obj: parent[key] });
-            } else {
-                // 값 파싱
-                parent[key] = Config._parseYamlValue(value);
-            }
-        }
-
-        return result;
-    }
-
-    /**
-     * YAML 값 파싱 (문자열, 숫자, boolean, 배열)
-     * @private
-     */
-    static _parseYamlValue(raw) {
-        // 인용 문자열
-        const quoted = raw.match(/^(['"])(.*)\1$/);
-        if (quoted) return quoted[2];
-
-        // boolean
-        if (raw === 'true') return true;
-        if (raw === 'false') return false;
-        if (raw === 'null' || raw === '~') return null;
-
-        // 인라인 배열 [a, b, c]
-        if (raw.startsWith('[') && raw.endsWith(']')) {
-            return raw.slice(1, -1).split(',').map(s => Config._parseYamlValue(s.trim()));
-        }
-
-        // 숫자
-        const num = Number(raw);
-        if (!isNaN(num) && raw !== '') return num;
-
-        // 기본: 문자열
-        return raw;
-    }
-
-    /**
-     * .env 파일 로드 (17-config.md)
-     * 부트 시 자동 호출. 이미 설정된 환경변수는 덮어쓰지 않음.
-     * @param {string} [baseDir='.']
-     */
-    loadEnv(baseDir = '.') {
-        const envPath = path.resolve(baseDir, '.env');
-        if (!existsSync(envPath)) return;
-
-        try {
-            const content = readFileSync(envPath, 'utf-8');
-            for (const line of content.split('\n')) {
-                const trimmed = line.trim();
-                if (!trimmed || trimmed.startsWith('#')) continue;
-                const eqIdx = trimmed.indexOf('=');
-                if (eqIdx === -1) continue;
-                const key = trimmed.slice(0, eqIdx).trim();
-                let value = trimmed.slice(eqIdx + 1).trim();
-                // .env 인용부호 제거 ("value" → value, 'value' → value)
-                value = value.replace(/^(['"])(.*)\1$/, '$2');
-                // 시스템 환경변수 우선 (17-config.md)
-                if (!(key in process.env)) {
-                    process.env[key] = value;
-                }
-            }
-        } catch {} // .env 읽기 실패 시 무시
-    }
-
-    /**
-     * YAML 객체의 ${VAR} / ${VAR:default} 패턴 치환 (17-config.md)
-     * @param {object} obj
-     * @returns {object}
-     */
-    static resolveEnvVars(obj) {
-        if (typeof obj === 'string') {
-            return obj.replace(/\$\{(\w+)(?::([^}]*))?\}/g, (_, varName, defaultVal) => {
-                const envVal = process.env[varName];
-                if (envVal !== undefined) return envVal;
-                if (defaultVal !== undefined) return defaultVal;
-                throw new Error(`Required environment variable '${varName}' is not set`);
-            });
-        }
-        if (Array.isArray(obj)) return obj.map(item => Config.resolveEnvVars(item));
-        if (obj !== null && typeof obj === 'object') {
-            const result = {};
-            for (const [key, value] of Object.entries(obj)) {
-                result[key] = Config.resolveEnvVars(value);
-            }
-            return result;
-        }
-        return obj;
-    }
-
-    /**
-     * dot-notation으로 설정값 접근
-     * @param {string} path - 'app.auth.secret', 'database.main.host' 등
-     * @param {*} [defaultValue] - 키가 없을 때 반환값
-     * @returns {*}
-     */
-    get(path, defaultValue = undefined) {
-        if (this._cache.has(path)) return this._cache.get(path);
-
-        const parts = path.split('.');
-        let current = this._raw;
-
-        for (const part of parts) {
-            if (current == null || typeof current !== 'object') {
-                return defaultValue;
-            }
-            current = current[part];
-        }
-
-        if (current === undefined) return defaultValue;
-        this._cache.set(path, current);
-        return current;
-    }
-
-    /**
-     * 설정값 존재 여부
-     * @param {string} path
-     * @returns {boolean}
-     */
-    has(path) {
-        return this.get(path) !== undefined;
-    }
-
-    /**
-     * 전체 설정 반환 (읽기 전용)
-     * @returns {object}
-     */
-    all() {
-        return this._raw;
-    }
-}
+/**
+ * Config — 통합 설정 접근
+ *
+ * fuzionx.yaml의 3개 섹션(bridge, database, app)을 통합 관리.
+ * dot-notation으로 접근: config.get('app.auth.secret')
+ *
+ * .env 자동 로드 + ${VAR:default} 환경변수 치환.
+ * YAML 파일 직접 파싱 지원 (외부 의존 없이 내장 파서 사용).
+ *
+ * @see docs/framework/17-config.md
+ */
+import { readFileSync, existsSync } from 'node:fs';
+import path from 'node:path';
+
+export default class Config {
+    /**
+     * @param {object} raw - 파싱된 YAML 객체 전체
+     *   raw.bridge  — Bridge(Rust)가 파싱한 bridge: 섹션
+     *   raw.database — JS가 파싱한 database: 섹션
+     *   raw.app      — JS가 파싱한 app: 섹션
+     */
+    constructor(raw = {}) {
+        this.bridge = raw.bridge || {};
+        this.database = raw.database || {};
+        this.app = raw.app || {};
+        this._raw = raw;
+        this._cache = new Map();
+    }
+
+    /**
+     * YAML 파일에서 설정 로드.
+     * configPath가 지정된 경우 Application 생성자에서 호출.
+     * bridge 섹션은 Rust에서 파싱하므로 JS 쪽은 database/app/themes 등을 로드.
+     * @param {string} configPath - 절대 경로
+     */
+    loadYaml(configPath) {
+        if (!existsSync(configPath)) return;
+
+        try {
+            const content = readFileSync(configPath, 'utf-8');
+            const raw = Config.parseYaml(content);
+            const parsed = Config.resolveEnvVars(raw);
+
+            // _raw에 병합 (기존 opts.config 우선)
+            for (const [key, value] of Object.entries(parsed)) {
+                if (this._raw[key] === undefined) {
+                    this._raw[key] = value;
+                }
+            }
+
+            // 섹션 별칭 갱신
+            if (!Object.keys(this.bridge).length && parsed.bridge) this.bridge = parsed.bridge;
+            if (!Object.keys(this.database).length && parsed.database) this.database = parsed.database;
+            if (!Object.keys(this.app).length && parsed.app) this.app = parsed.app;
+
+            // 캐시 초기화
+            this._cache.clear();
+        } catch (err) {
+            console.error(`[Config] YAML 파일 로드 실패 (${configPath}):`, err.message);
+        }
+    }
+
+    /**
+     * 간이 YAML 파서 — 외부 의존 없이 fuzionx.yaml 구조 파싱.
+     * 지원: 중첩 객체, 문자열, 숫자, boolean, 배열(인라인), 인용 문자열.
+     * @param {string} content
+     * @returns {object}
+     */
+    static parseYaml(content) {
+        const result = {};
+        const lines = content.split('\n');
+        const stack = [{ indent: -1, obj: result }];
+
+        for (const rawLine of lines) {
+            // 주석/빈 줄 무시
+            const line = rawLine.replace(/#.*$/, '');
+            if (!line.trim()) continue;
+
+            const indent = line.search(/\S/);
+            // 키: unquoted ([-\w.]+) 또는 quoted ("..." / '...')
+            const match = line.match(/^(\s*)(?:(["'])([^"']+)\2|([-\w.]+))\s*:\s*(.*)$/);
+            if (!match) continue;
+
+            const key = match[3] || match[4]; // quoted key (그룹3) 또는 unquoted key (그룹4)
+            const rawValue = match[5];
+
+            // 스택에서 현재 indent보다 깊거나 같은 레벨 제거
+            while (stack.length > 1 && stack[stack.length - 1].indent >= indent) {
+                stack.pop();
+            }
+
+            const parent = stack[stack.length - 1].obj;
+            const value = rawValue.trim();
+
+            if (!value) {
+                // 하위 객체 시작
+                parent[key] = {};
+                stack.push({ indent, obj: parent[key] });
+            } else {
+                // 값 파싱
+                parent[key] = Config._parseYamlValue(value);
+            }
+        }
+
+        return result;
+    }
+
+    /**
+     * YAML 값 파싱 (문자열, 숫자, boolean, 배열)
+     * @private
+     */
+    static _parseYamlValue(raw) {
+        // 인용 문자열
+        const quoted = raw.match(/^(['"])(.*)\1$/);
+        if (quoted) return quoted[2];
+
+        // boolean
+        if (raw === 'true') return true;
+        if (raw === 'false') return false;
+        if (raw === 'null' || raw === '~') return null;
+
+        // 인라인 배열 [a, b, c]
+        if (raw.startsWith('[') && raw.endsWith(']')) {
+            return raw.slice(1, -1).split(',').map(s => Config._parseYamlValue(s.trim()));
+        }
+
+        // 숫자
+        const num = Number(raw);
+        if (!isNaN(num) && raw !== '') return num;
+
+        // 기본: 문자열
+        return raw;
+    }
+
+    /**
+     * .env 파일 로드 (17-config.md)
+     * 부트 시 자동 호출. 이미 설정된 환경변수는 덮어쓰지 않음.
+     * @param {string} [baseDir='.']
+     */
+    loadEnv(baseDir = '.') {
+        const envPath = path.resolve(baseDir, '.env');
+        if (!existsSync(envPath)) return;
+
+        try {
+            const content = readFileSync(envPath, 'utf-8');
+            for (const line of content.split('\n')) {
+                const trimmed = line.trim();
+                if (!trimmed || trimmed.startsWith('#')) continue;
+                const eqIdx = trimmed.indexOf('=');
+                if (eqIdx === -1) continue;
+                const key = trimmed.slice(0, eqIdx).trim();
+                let value = trimmed.slice(eqIdx + 1).trim();
+                // .env 인용부호 제거 ("value" → value, 'value' → value)
+                value = value.replace(/^(['"])(.*)\1$/, '$2');
+                // 시스템 환경변수 우선 (17-config.md)
+                if (!(key in process.env)) {
+                    process.env[key] = value;
+                }
+            }
+        } catch {} // .env 읽기 실패 시 무시
+    }
+
+    /**
+     * YAML 객체의 ${VAR} / ${VAR:default} 패턴 치환 (17-config.md)
+     * @param {object} obj
+     * @returns {object}
+     */
+    static resolveEnvVars(obj) {
+        if (typeof obj === 'string') {
+            return obj.replace(/\$\{(\w+)(?::([^}]*))?\}/g, (_, varName, defaultVal) => {
+                const envVal = process.env[varName];
+                if (envVal !== undefined) return envVal;
+                if (defaultVal !== undefined) return defaultVal;
+                throw new Error(`Required environment variable '${varName}' is not set`);
+            });
+        }
+        if (Array.isArray(obj)) return obj.map(item => Config.resolveEnvVars(item));
+        if (obj !== null && typeof obj === 'object') {
+            const result = {};
+            for (const [key, value] of Object.entries(obj)) {
+                result[key] = Config.resolveEnvVars(value);
+            }
+            return result;
+        }
+        return obj;
+    }
+
+    /**
+     * dot-notation으로 설정값 접근
+     * @param {string} path - 'app.auth.secret', 'database.main.host' 등
+     * @param {*} [defaultValue] - 키가 없을 때 반환값
+     * @returns {*}
+     */
+    get(path, defaultValue = undefined) {
+        if (this._cache.has(path)) return this._cache.get(path);
+
+        const parts = path.split('.');
+        let current = this._raw;
+
+        for (const part of parts) {
+            if (current == null || typeof current !== 'object') {
+                return defaultValue;
+            }
+            current = current[part];
+        }
+
+        if (current === undefined) return defaultValue;
+        this._cache.set(path, current);
+        return current;
+    }
+
+    /**
+     * 설정값 존재 여부
+     * @param {string} path
+     * @returns {boolean}
+     */
+    has(path) {
+        return this.get(path) !== undefined;
+    }
+
+    /**
+     * 전체 설정 반환 (읽기 전용)
+     * @returns {object}
+     */
+    all() {
+        return this._raw;
+    }
+}