@fuzionx/core 0.1.42 → 0.1.44

package/lib/i18n.js

@@ -1,37 +1,37 @@
-/**
- * I18n — fuzionx-bridge i18n N-API를 래핑하는 헬퍼.
- * app.i18n으로 접근, req.t()는 context.js에서 구현.
- */
-
-export function createI18n(bridge) {
-    return {
-        /** 번역 조회 */
-        translate: (locale, key) => bridge.i18NTranslate(locale, key),
-
-        /** 로케일 목록 */
-        get locales() {
-            return bridge.i18NGetLocales();
-        },
-
-        /** 현재 로케일 변경 */
-        setLocale: (locale) => bridge.i18NSetLocale(locale),
-
-        /** 누락 키 업데이트 (auto_complete) */
-        updateMissing: (key, value) => bridge.i18NUpdateMissingKey(key, value),
-
-        /** auto_complete 활성화 여부 */
-        get autoComplete() {
-            return bridge.i18NIsAutoComplete();
-        },
-
-        /**
-         * SSR 템플릿 렌더링
-         * @param {string} template - Tera 템플릿 문자열
-         * @param {object} context - 템플릿 변수
-         * @param {string} [locale='en'] - 로케일
-         */
-        render: (template, context = {}, locale = 'en') => {
-            return bridge.ssrRenderString(template, context, locale);
-        },
-    };
-}
+/**
+ * I18n — fuzionx-bridge i18n N-API를 래핑하는 헬퍼.
+ * app.i18n으로 접근, req.t()는 context.js에서 구현.
+ */
+
+export function createI18n(bridge) {
+    return {
+        /** 번역 조회 */
+        translate: (locale, key) => bridge.i18NTranslate(locale, key),
+
+        /** 로케일 목록 */
+        get locales() {
+            return bridge.i18NGetLocales();
+        },
+
+        /** 현재 로케일 변경 */
+        setLocale: (locale) => bridge.i18NSetLocale(locale),
+
+        /** 누락 키 업데이트 (auto_complete) */
+        updateMissing: (key, value) => bridge.i18NUpdateMissingKey(key, value),
+
+        /** auto_complete 활성화 여부 */
+        get autoComplete() {
+            return bridge.i18NIsAutoComplete();
+        },
+
+        /**
+         * SSR 템플릿 렌더링
+         * @param {string} template - Tera 템플릿 문자열
+         * @param {object} context - 템플릿 변수
+         * @param {string} [locale='en'] - 로케일
+         */
+        render: (template, context = {}, locale = 'en') => {
+            return bridge.ssrRenderString(template, context, locale);
+        },
+    };
+}

package/lib/logger.js

@@ -1,146 +1,146 @@
-/**
- * @fileoverview FuzionX Bridge 통합 로거.
- *
- * Rust tracing과 Node.js console을 일원화한다.
- * - createLogger(bridge): app.logger 객체 생성
- * - interceptConsole(bridge): console.* 가로채기
- *
- * @module logger
- */
-
-import { format } from 'node:util';
-
-/**
- * 스택 프레임 문자열에서 파일:라인을 추출한다.
- * @param {string} frameLine - 스택 프레임 한 줄
- * @returns {string} 파일:라인 또는 빈 문자열
- */
-function parseFrame(frameLine) {
-    const matchParen = frameLine.match(/\((.+):(\d+):\d+\)/);
-    if (matchParen) return `${matchParen[1]}:${matchParen[2]}`;
-    const matchDirect = frameLine.match(/at (.+):(\d+):\d+/);
-    if (matchDirect) return `${matchDirect[1]}:${matchDirect[2]}`;
-    return '';
-}
-
-/** 로거/프레임워크 내부 파일 — 호출 위치 추출 시 건너뜀 */
-const SKIP_PATTERNS = ['/logger.js:', '/Logger.js:', '/ErrorHandler.js:'];
-
-/**
- * 인자 목록에서 Error 객체를 찾아 throw 위치를 반환한다.
- * @param {any[]} args
- * @returns {string} 파일:라인 또는 빈 문자열
- */
-function findErrorOrigin(args) {
-    for (const arg of args) {
-        if (arg instanceof Error && arg.stack) {
-            return parseFrame(arg.stack.split('\n')[1] || '');
-        }
-    }
-    return '';
-}
-
-/**
- * 호출 스택에서 로거/프레임워크 내부 파일을 건너뛴 첫 외부 호출 위치를 반환한다.
- * depth 기반이 아니라 파일명 패턴 기반이므로 호출 체인 변경에 안전하다.
- *
- * @returns {string} 파일:라인 또는 빈 문자열
- */
-function getExternalCallSite() {
-    const stack = new Error().stack;
-    if (!stack) return '';
-    const lines = stack.split('\n');
-    for (let i = 1; i < lines.length; i++) {
-        const frame = lines[i];
-        // 로거/프레임워크 내부 프레임 스킵
-        if (SKIP_PATTERNS.some(p => frame.includes(p))) continue;
-        return parseFrame(frame);
-    }
-    return '';
-}
-
-/**
- * 에러/경고 로그의 위치를 결정한다.
- * 1. 인자에 Error 객체가 있으면 → err.stack에서 throw 위치
- * 2. 없으면 → 호출 스택에서 로거 파일을 건너뛴 외부 호출 위치
- *
- * @param {any[]} args
- * @returns {string}
- */
-function resolveLocation(args) {
-    return findErrorOrigin(args) || getExternalCallSite();
-}
-
-/**
- * Rust N-API bridge를 통한 로거 객체를 생성한다.
- *
- * @param {object} bridge - fuzionx-bridge N-API 모듈
- * @returns {{ info: Function, warn: Function, error: Function, debug: Function }}
- */
-export function createLogger(bridge) {
-    return {
-        info(...args) {
-            bridge.logInfo('app', format(...args));
-        },
-
-        warn(...args) {
-            const location = resolveLocation(args);
-            bridge.logWarn('app', format(...args), location || undefined);
-        },
-
-        error(...args) {
-            const location = resolveLocation(args);
-            bridge.logError('app', format(...args), location || undefined);
-        },
-
-        debug(...args) {
-            bridge.logDebug('app', format(...args));
-        },
-    };
-}
-
-/**
- * console.log/warn/error/debug를 가로채서 Rust tracing으로 전달한다.
- *
- * @param {object} bridge - fuzionx-bridge N-API 모듈
- * @returns {Function} 원래 console을 복원하는 함수
- */
-export function interceptConsole(bridge) {
-    const orig = {
-        log: console.log,
-        info: console.info,
-        warn: console.warn,
-        error: console.error,
-        debug: console.debug,
-    };
-
-    console.log = (...args) => {
-        bridge.logInfo('console', format(...args));
-    };
-
-    console.info = (...args) => {
-        bridge.logInfo('console', format(...args));
-    };
-
-    console.warn = (...args) => {
-        const location = resolveLocation(args);
-        bridge.logWarn('console', format(...args), location || undefined);
-    };
-
-    console.error = (...args) => {
-        const location = resolveLocation(args);
-        bridge.logError('console', format(...args), location || undefined);
-    };
-
-    console.debug = (...args) => {
-        bridge.logDebug('console', format(...args));
-    };
-
-    return function restoreConsole() {
-        console.log = orig.log;
-        console.info = orig.info;
-        console.warn = orig.warn;
-        console.error = orig.error;
-        console.debug = orig.debug;
-    };
-}
+/**
+ * @fileoverview FuzionX Bridge 통합 로거.
+ *
+ * Rust tracing과 Node.js console을 일원화한다.
+ * - createLogger(bridge): app.logger 객체 생성
+ * - interceptConsole(bridge): console.* 가로채기
+ *
+ * @module logger
+ */
+
+import { format } from 'node:util';
+
+/**
+ * 스택 프레임 문자열에서 파일:라인을 추출한다.
+ * @param {string} frameLine - 스택 프레임 한 줄
+ * @returns {string} 파일:라인 또는 빈 문자열
+ */
+function parseFrame(frameLine) {
+    const matchParen = frameLine.match(/\((.+):(\d+):\d+\)/);
+    if (matchParen) return `${matchParen[1]}:${matchParen[2]}`;
+    const matchDirect = frameLine.match(/at (.+):(\d+):\d+/);
+    if (matchDirect) return `${matchDirect[1]}:${matchDirect[2]}`;
+    return '';
+}
+
+/** 로거/프레임워크 내부 파일 — 호출 위치 추출 시 건너뜀 */
+const SKIP_PATTERNS = ['/logger.js:', '/Logger.js:', '/ErrorHandler.js:'];
+
+/**
+ * 인자 목록에서 Error 객체를 찾아 throw 위치를 반환한다.
+ * @param {any[]} args
+ * @returns {string} 파일:라인 또는 빈 문자열
+ */
+function findErrorOrigin(args) {
+    for (const arg of args) {
+        if (arg instanceof Error && arg.stack) {
+            return parseFrame(arg.stack.split('\n')[1] || '');
+        }
+    }
+    return '';
+}
+
+/**
+ * 호출 스택에서 로거/프레임워크 내부 파일을 건너뛴 첫 외부 호출 위치를 반환한다.
+ * depth 기반이 아니라 파일명 패턴 기반이므로 호출 체인 변경에 안전하다.
+ *
+ * @returns {string} 파일:라인 또는 빈 문자열
+ */
+function getExternalCallSite() {
+    const stack = new Error().stack;
+    if (!stack) return '';
+    const lines = stack.split('\n');
+    for (let i = 1; i < lines.length; i++) {
+        const frame = lines[i];
+        // 로거/프레임워크 내부 프레임 스킵
+        if (SKIP_PATTERNS.some(p => frame.includes(p))) continue;
+        return parseFrame(frame);
+    }
+    return '';
+}
+
+/**
+ * 에러/경고 로그의 위치를 결정한다.
+ * 1. 인자에 Error 객체가 있으면 → err.stack에서 throw 위치
+ * 2. 없으면 → 호출 스택에서 로거 파일을 건너뛴 외부 호출 위치
+ *
+ * @param {any[]} args
+ * @returns {string}
+ */
+function resolveLocation(args) {
+    return findErrorOrigin(args) || getExternalCallSite();
+}
+
+/**
+ * Rust N-API bridge를 통한 로거 객체를 생성한다.
+ *
+ * @param {object} bridge - fuzionx-bridge N-API 모듈
+ * @returns {{ info: Function, warn: Function, error: Function, debug: Function }}
+ */
+export function createLogger(bridge) {
+    return {
+        info(...args) {
+            bridge.logInfo('app', format(...args));
+        },
+
+        warn(...args) {
+            const location = resolveLocation(args);
+            bridge.logWarn('app', format(...args), location || undefined);
+        },
+
+        error(...args) {
+            const location = resolveLocation(args);
+            bridge.logError('app', format(...args), location || undefined);
+        },
+
+        debug(...args) {
+            bridge.logDebug('app', format(...args));
+        },
+    };
+}
+
+/**
+ * console.log/warn/error/debug를 가로채서 Rust tracing으로 전달한다.
+ *
+ * @param {object} bridge - fuzionx-bridge N-API 모듈
+ * @returns {Function} 원래 console을 복원하는 함수
+ */
+export function interceptConsole(bridge) {
+    const orig = {
+        log: console.log,
+        info: console.info,
+        warn: console.warn,
+        error: console.error,
+        debug: console.debug,
+    };
+
+    console.log = (...args) => {
+        bridge.logInfo('console', format(...args));
+    };
+
+    console.info = (...args) => {
+        bridge.logInfo('console', format(...args));
+    };
+
+    console.warn = (...args) => {
+        const location = resolveLocation(args);
+        bridge.logWarn('console', format(...args), location || undefined);
+    };
+
+    console.error = (...args) => {
+        const location = resolveLocation(args);
+        bridge.logError('console', format(...args), location || undefined);
+    };
+
+    console.debug = (...args) => {
+        bridge.logDebug('console', format(...args));
+    };
+
+    return function restoreConsole() {
+        console.log = orig.log;
+        console.info = orig.info;
+        console.warn = orig.warn;
+        console.error = orig.error;
+        console.debug = orig.debug;
+    };
+}

package/lib/media.js

@@ -1,75 +1,75 @@
-/**
- * MediaHelper — fuzionx-bridge 미디어(이미지+비디오) N-API 래핑.
- * app.media로 접근.
- *
- * 최적화:
- *   - 이미지 처리: Rust image+webp crate 직통 (Lanczos3 리사이즈)
- *   - 비디오: ffmpeg CLI 호출 (Rust std::process::Command)
- *   - JS 힙 메모리 무할당 — 파일-to-파일 처리
- */
-
-export function createMedia(bridge) {
-    return {
-        // ── 이미지 ──
-
-        /**
-         * 이미지 리사이즈 (종횡비 유지).
-         * @param {string} input - 입력 파일 경로
-         * @param {string} output - 출력 파일 경로
-         * @param {number} width - 최대 가로
-         * @param {number} height - 최대 세로
-         * @param {string} [format='webp'] - 출력 포맷
-         * @param {number} [quality=80] - 품질 (1-100)
-         * @returns {string} 출력 경로
-         */
-        resize: (input, output, width, height, format, quality) =>
-            bridge.mediaResize(input, output, width, height, format, quality),
-
-        /**
-         * 다중 사이즈 리사이즈 (한 번의 디코드로 여러 출력).
-         * @param {string} input - 입력 파일 경로
-         * @param {string} outputDir - 출력 디렉토리
-         * @param {string} baseName - 기본 파일명
-         * @param {Array<{width:number,height:number,format?:string,quality?:number,suffix:string}>} specs
-         * @returns {string[]} 출력 경로 배열
-         */
-        resizeMultiple: (input, outputDir, baseName, specs) =>
-            bridge.mediaResizeMultiple(input, outputDir, baseName, specs),
-
-        /**
-         * 이미지 정보 조회.
-         * @returns {{width:number, height:number, format:string}}
-         */
-        imageInfo: (filePath) => bridge.mediaGetImageInfo(filePath),
-
-        /**
-         * WebP 변환.
-         * @param {string} input - 입력 경로
-         * @param {string} output - 출력 경로
-         * @param {number} [quality=80] - 품질
-         * @returns {string} 출력 경로
-         */
-        toWebp: (input, output, quality) =>
-            bridge.mediaConvertToWebp(input, output, quality),
-
-        // ── 비디오 ──
-
-        /**
-         * 비디오 썸네일 추출 (ffmpeg).
-         * @param {string} input - 비디오 경로
-         * @param {string} output - 출력 이미지 경로
-         * @param {number} [atSeconds=3] - 캡처 시점 (초)
-         * @param {number} [width=0] - 출력 가로 (0=원본)
-         * @param {string} [format='jpeg'] - 출력 포맷
-         * @returns {string} 출력 경로
-         */
-        videoThumbnail: (input, output, atSeconds, width, format) =>
-            bridge.mediaVideoThumbnail(input, output, atSeconds, width, format),
-
-        /**
-         * 비디오 정보 조회 (ffprobe).
-         * @returns {{duration:number, width:number, height:number, codec:string, fps:number}}
-         */
-        videoInfo: (filePath) => bridge.mediaVideoInfo(filePath),
-    };
-}
+/**
+ * MediaHelper — fuzionx-bridge 미디어(이미지+비디오) N-API 래핑.
+ * app.media로 접근.
+ *
+ * 최적화:
+ *   - 이미지 처리: Rust image+webp crate 직통 (Lanczos3 리사이즈)
+ *   - 비디오: ffmpeg CLI 호출 (Rust std::process::Command)
+ *   - JS 힙 메모리 무할당 — 파일-to-파일 처리
+ */
+
+export function createMedia(bridge) {
+    return {
+        // ── 이미지 ──
+
+        /**
+         * 이미지 리사이즈 (종횡비 유지).
+         * @param {string} input - 입력 파일 경로
+         * @param {string} output - 출력 파일 경로
+         * @param {number} width - 최대 가로
+         * @param {number} height - 최대 세로
+         * @param {string} [format='webp'] - 출력 포맷
+         * @param {number} [quality=80] - 품질 (1-100)
+         * @returns {string} 출력 경로
+         */
+        resize: (input, output, width, height, format, quality) =>
+            bridge.mediaResize(input, output, width, height, format, quality),
+
+        /**
+         * 다중 사이즈 리사이즈 (한 번의 디코드로 여러 출력).
+         * @param {string} input - 입력 파일 경로
+         * @param {string} outputDir - 출력 디렉토리
+         * @param {string} baseName - 기본 파일명
+         * @param {Array<{width:number,height:number,format?:string,quality?:number,suffix:string}>} specs
+         * @returns {string[]} 출력 경로 배열
+         */
+        resizeMultiple: (input, outputDir, baseName, specs) =>
+            bridge.mediaResizeMultiple(input, outputDir, baseName, specs),
+
+        /**
+         * 이미지 정보 조회.
+         * @returns {{width:number, height:number, format:string}}
+         */
+        imageInfo: (filePath) => bridge.mediaGetImageInfo(filePath),
+
+        /**
+         * WebP 변환.
+         * @param {string} input - 입력 경로
+         * @param {string} output - 출력 경로
+         * @param {number} [quality=80] - 품질
+         * @returns {string} 출력 경로
+         */
+        toWebp: (input, output, quality) =>
+            bridge.mediaConvertToWebp(input, output, quality),
+
+        // ── 비디오 ──
+
+        /**
+         * 비디오 썸네일 추출 (ffmpeg).
+         * @param {string} input - 비디오 경로
+         * @param {string} output - 출력 이미지 경로
+         * @param {number} [atSeconds=3] - 캡처 시점 (초)
+         * @param {number} [width=0] - 출력 가로 (0=원본)
+         * @param {string} [format='jpeg'] - 출력 포맷
+         * @returns {string} 출력 경로
+         */
+        videoThumbnail: (input, output, atSeconds, width, format) =>
+            bridge.mediaVideoThumbnail(input, output, atSeconds, width, format),
+
+        /**
+         * 비디오 정보 조회 (ffprobe).
+         * @returns {{duration:number, width:number, height:number, codec:string, fps:number}}
+         */
+        videoInfo: (filePath) => bridge.mediaVideoInfo(filePath),
+    };
+}

package/lib/middleware.js

@@ -1,65 +1,65 @@
-/**
- * Middleware — 동기 + 비동기 미들웨어 체인 엔진.
- *
- * Express 호환: next()가 Promise를 반환하면 체인 전체가 async로 전파.
- * Fusion 콜백에서 Promise가 감지되면 bridge의 sendAsyncResponse로 처리.
- */
-
-/**
- * 미들웨어 체인 실행
- * @param {Function[]} handlers - (req, res, next) 핸들러 배열
- * @param {object} req
- * @param {object} res
- * @returns {undefined|Promise} 비동기 핸들러가 있으면 Promise 리턴
- */
-export function runMiddlewareChain(handlers, req, res) {
-    let index = 0;
-    const len = handlers.length;
-
-    function next(err) {
-        if (err) throw err;
-        if (res._sent || index >= len) return;
-
-        const handler = handlers[index++];
-        const result = handler(req, res, next);
-
-        // 핸들러가 Promise를 리턴하면 (async 함수) → 체인 완료까지 전파
-        // async 핸들러 내부에서 await next()를 호출하므로 후속 체인은 Promise 안에서 실행됨
-        if (result && typeof result.then === 'function') {
-            return result.catch((e) => {
-                // async 핸들러의 unhandled rejection 방지
-                if (!res._sent) throw e;
-            });
-        }
-        return result;
-    }
-
-    return next();
-}
-
-/**
- * 에러 핸들러 체인 실행
- * @param {Function[]} handlers - (err, req, res, next) 핸들러 배열
- * @param {Error} err
- * @param {object} req
- * @param {object} res
- */
-export function runErrorChain(handlers, err, req, res) {
-    let index = 0;
-    const len = handlers.length;
-
-    function next(nextErr) {
-        if (res._sent || index >= len) return;
-        const handler = handlers[index++];
-        try {
-            handler(nextErr || err, req, res, next);
-        } catch (e) {
-            // 에러 핸들러가 또 throw하면 다음 핸들러로
-            if (index < len) {
-                next(e);
-            }
-        }
-    }
-
-    next(err);
-}
+/**
+ * Middleware — 동기 + 비동기 미들웨어 체인 엔진.
+ *
+ * Express 호환: next()가 Promise를 반환하면 체인 전체가 async로 전파.
+ * Fusion 콜백에서 Promise가 감지되면 bridge의 sendAsyncResponse로 처리.
+ */
+
+/**
+ * 미들웨어 체인 실행
+ * @param {Function[]} handlers - (req, res, next) 핸들러 배열
+ * @param {object} req
+ * @param {object} res
+ * @returns {undefined|Promise} 비동기 핸들러가 있으면 Promise 리턴
+ */
+export function runMiddlewareChain(handlers, req, res) {
+    let index = 0;
+    const len = handlers.length;
+
+    function next(err) {
+        if (err) throw err;
+        if (res._sent || index >= len) return;
+
+        const handler = handlers[index++];
+        const result = handler(req, res, next);
+
+        // 핸들러가 Promise를 리턴하면 (async 함수) → 체인 완료까지 전파
+        // async 핸들러 내부에서 await next()를 호출하므로 후속 체인은 Promise 안에서 실행됨
+        if (result && typeof result.then === 'function') {
+            return result.catch((e) => {
+                // async 핸들러의 unhandled rejection 방지
+                if (!res._sent) throw e;
+            });
+        }
+        return result;
+    }
+
+    return next();
+}
+
+/**
+ * 에러 핸들러 체인 실행
+ * @param {Function[]} handlers - (err, req, res, next) 핸들러 배열
+ * @param {Error} err
+ * @param {object} req
+ * @param {object} res
+ */
+export function runErrorChain(handlers, err, req, res) {
+    let index = 0;
+    const len = handlers.length;
+
+    function next(nextErr) {
+        if (res._sent || index >= len) return;
+        const handler = handlers[index++];
+        try {
+            handler(nextErr || err, req, res, next);
+        } catch (e) {
+            // 에러 핸들러가 또 throw하면 다음 핸들러로
+            if (index < len) {
+                next(e);
+            }
+        }
+    }
+
+    next(err);
+}