@fuzionx/core 0.1.28 → 0.1.30

package/lib/logger.js

@@ -11,74 +11,88 @@
 import { format } from 'node:util';
 
 /**
- * JS 호출 스택에서 실제 호출 위치(파일:라인)를 추출한다.
- * error/warn 레벨에서만 사용 (new Error().stack 비용 고려).
+ * 스택 프레임 문자열에서 파일:라인을 추출한다.
+ * @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 기반이 아니라 파일명 패턴 기반이므로 호출 체인 변경에 안전하다.
  *
- * @param {number} depth - 스택 프레임 깊이 (기본 3: Error → getCallSite → logWarn → 실제 호출)
- * @returns {string} 파일:라인 문자열 (예: "server.js:42") 또는 빈 문자열
+ * @returns {string} 파일:라인 또는 빈 문자열
  */
-function getCallSite(depth = 3) {
+function getExternalCallSite() {
     const stack = new Error().stack;
     if (!stack) return '';
-
     const lines = stack.split('\n');
-    // depth번째 라인이 실제 호출자
-    const line = lines[depth] || '';
-
-    // "    at Object.<anonymous> (/app/server.js:42:5)" 패턴
-    const matchParen = line.match(/\((.+):(\d+):\d+\)/);
-    if (matchParen) return `${matchParen[1]}:${matchParen[2]}`;
-
-    // "    at /app/server.js:42:5" 패턴 (익명 호출)
-    const matchDirect = line.match(/at (.+):(\d+):\d+/);
-    if (matchDirect) return `${matchDirect[1]}:${matchDirect[2]}`;
-
+    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 }}
- *
- * @example
- * const logger = createLogger(bridge);
- * logger.info('서버 시작');
- * logger.error('DB 연결 실패');  // → [server.js:42] DB 연결 실패
  */
 export function createLogger(bridge) {
     return {
-        /**
-         * INFO 레벨 로그.
-         * @param {...any} args - 로그 메시지 (util.format 지원)
-         */
         info(...args) {
             bridge.logInfo('app', format(...args));
         },
 
-        /**
-         * WARN 레벨 로그 (호출 위치 자동 추출).
-         * @param {...any} args - 로그 메시지
-         */
         warn(...args) {
-            const location = getCallSite(2); // Error → warn → 호출자
+            const location = resolveLocation(args);
             bridge.logWarn('app', format(...args), location || undefined);
         },
 
-        /**
-         * ERROR 레벨 로그 (호출 위치 자동 추출).
-         * @param {...any} args - 로그 메시지
-         */
         error(...args) {
-            const location = getCallSite(2); // Error → error → 호출자
+            const location = resolveLocation(args);
             bridge.logError('app', format(...args), location || undefined);
         },
 
-        /**
-         * DEBUG 레벨 로그.
-         * @param {...any} args - 로그 메시지
-         */
         debug(...args) {
             bridge.logDebug('app', format(...args));
         },
@@ -90,14 +104,8 @@ export function createLogger(bridge) {
  *
  * @param {object} bridge - fuzionx-bridge N-API 모듈
  * @returns {Function} 원래 console을 복원하는 함수
- *
- * @example
- * const restore = interceptConsole(bridge);
- * console.log('hello');  // → tracing::info [console] hello
- * restore();             // 원래 console 복원
  */
 export function interceptConsole(bridge) {
-    // 원본 보존
     const orig = {
         log: console.log,
         info: console.info,
@@ -115,12 +123,12 @@ export function interceptConsole(bridge) {
     };
 
     console.warn = (...args) => {
-        const location = getCallSite(2);
+        const location = resolveLocation(args);
         bridge.logWarn('console', format(...args), location || undefined);
     };
 
     console.error = (...args) => {
-        const location = getCallSite(2);
+        const location = resolveLocation(args);
         bridge.logError('console', format(...args), location || undefined);
     };
 
@@ -128,9 +136,6 @@ export function interceptConsole(bridge) {
         bridge.logDebug('console', format(...args));
     };
 
-    /**
-     * 원래 console 함수를 복원한다.
-     */
     return function restoreConsole() {
         console.log = orig.log;
         console.info = orig.info;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fuzionx/core",
-  "version": "0.1.28",
+  "version": "0.1.30",
   "type": "module",
   "description": "Express-style Node.js framework powered by FuzionX native bridge — 167K RPS single process",
   "main": "index.js",
@@ -18,7 +18,7 @@
     "url": "https://github.com/saytohenry/fuzionx"
   },
   "dependencies": {
-    "@fuzionx/bridge": "^0.1.28"
+    "@fuzionx/bridge": "^0.1.30"
   },
   "files": [
     "index.js",