@fuzionx/core 0.1.39 → 0.1.41

package/lib/router.js

@@ -1,55 +1,55 @@
-/**
- * Router — fuzionx-bridge의 registerRoute/buildRoutes를 래핑하는 라우트 매니저.
- * Express 스타일 path를 Rust 라우터 형식({param})으로 변환.
- */
-export class Router {
-    constructor(bridge) {
-        this._bridge = bridge;
-        this._routes = [];       // { method, path, handlers }
-        this._handlerMap = {};   // handlerId → handlers[]
-        this._nextId = 1;
-        this._built = false;
-    }
-
-    /**
-     * 라우트 추가
-     * @param {string} method - HTTP 메서드
-     * @param {string} routePath - Express 스타일 경로 (예: /api/users/:id)
-     * @param {Function[]} handlers - 핸들러 배열
-     */
-    add(method, routePath, handlers) {
-        if (this._built) {
-            throw new Error('라우트는 listen() 호출 전에 등록해야 합니다');
-        }
-
-        // Express :param → Rust {param} 변환
-        const rustPath = routePath.replace(/:([a-zA-Z_][a-zA-Z0-9_]*)/g, '{$1}');
-        const handlerId = this._nextId++;
-
-        this._routes.push({ method, path: rustPath, handlerId, handlers });
-        this._handlerMap[handlerId] = handlers;
-
-        return handlerId;
-    }
-
-    /** 모든 등록된 라우트를 fuzionx-bridge에 등록하고 빌드 */
-    build() {
-        if (this._built) return;
-
-        for (const route of this._routes) {
-            this._bridge.registerRoute(route.method, route.path, route.handlerId);
-        }
-        this._bridge.buildRoutes();
-        this._built = true;
-    }
-
-    /**
-     * handlerId로 핸들러 배열 조회
-     * @param {number} handlerId
-     * @returns {Function[]|null}
-     */
-    getHandler(handlerId) {
-        if (handlerId < 0) return null;
-        return this._handlerMap[handlerId] || null;
-    }
-}
+/**
+ * Router — fuzionx-bridge의 registerRoute/buildRoutes를 래핑하는 라우트 매니저.
+ * Express 스타일 path를 Rust 라우터 형식({param})으로 변환.
+ */
+export class Router {
+    constructor(bridge) {
+        this._bridge = bridge;
+        this._routes = [];       // { method, path, handlers }
+        this._handlerMap = {};   // handlerId → handlers[]
+        this._nextId = 1;
+        this._built = false;
+    }
+
+    /**
+     * 라우트 추가
+     * @param {string} method - HTTP 메서드
+     * @param {string} routePath - Express 스타일 경로 (예: /api/users/:id)
+     * @param {Function[]} handlers - 핸들러 배열
+     */
+    add(method, routePath, handlers) {
+        if (this._built) {
+            throw new Error('라우트는 listen() 호출 전에 등록해야 합니다');
+        }
+
+        // Express :param → Rust {param} 변환
+        const rustPath = routePath.replace(/:([a-zA-Z_][a-zA-Z0-9_]*)/g, '{$1}');
+        const handlerId = this._nextId++;
+
+        this._routes.push({ method, path: rustPath, handlerId, handlers });
+        this._handlerMap[handlerId] = handlers;
+
+        return handlerId;
+    }
+
+    /** 모든 등록된 라우트를 fuzionx-bridge에 등록하고 빌드 */
+    build() {
+        if (this._built) return;
+
+        for (const route of this._routes) {
+            this._bridge.registerRoute(route.method, route.path, route.handlerId);
+        }
+        this._bridge.buildRoutes();
+        this._built = true;
+    }
+
+    /**
+     * handlerId로 핸들러 배열 조회
+     * @param {number} handlerId
+     * @returns {Function[]|null}
+     */
+    getHandler(handlerId) {
+        if (handlerId < 0) return null;
+        return this._handlerMap[handlerId] || null;
+    }
+}

package/lib/session.js

@@ -1,18 +1,18 @@
-/**
- * Session — fuzionx-bridge 세션 N-API를 래핑하는 헬퍼.
- * context.js에서 req.session으로 사용됨.
- */
-
-export function createSession(bridge) {
-    return {
-        /** 세션 데이터 조회 (전체) */
-        get: (sessionId) => bridge.sessionGet(sessionId),
-        /** 세션 데이터 저장 (data: HashMap, ttl: optional) */
-        set: (sessionId, data, ttlSecs) => bridge.sessionSet(sessionId, data, ttlSecs),
-        destroy: (sessionId) => bridge.sessionDestroy(sessionId),
-        renew: (sessionId, ttlSecs) => bridge.sessionRenew(sessionId, ttlSecs),
-        exists: (sessionId) => bridge.sessionExists(sessionId),
-        load: (sessionId) => bridge.sessionLoad(sessionId),
-        cleanup: () => bridge.sessionCleanup(),
-    };
-}
+/**
+ * Session — fuzionx-bridge 세션 N-API를 래핑하는 헬퍼.
+ * context.js에서 req.session으로 사용됨.
+ */
+
+export function createSession(bridge) {
+    return {
+        /** 세션 데이터 조회 (전체) */
+        get: (sessionId) => bridge.sessionGet(sessionId),
+        /** 세션 데이터 저장 (data: HashMap, ttl: optional) */
+        set: (sessionId, data, ttlSecs) => bridge.sessionSet(sessionId, data, ttlSecs),
+        destroy: (sessionId) => bridge.sessionDestroy(sessionId),
+        renew: (sessionId, ttlSecs) => bridge.sessionRenew(sessionId, ttlSecs),
+        exists: (sessionId) => bridge.sessionExists(sessionId),
+        load: (sessionId) => bridge.sessionLoad(sessionId),
+        cleanup: () => bridge.sessionCleanup(),
+    };
+}

package/lib/ws.js

@@ -1,210 +1,210 @@
-/**
- * WebSocket — 네임스페이스 기반 WS 매니저.
- *
- * 사용법:
- *   app.ws('/chat').on('connect', (socket) => { ... });
- *   app.ws('/chat').on('message', (socket, data) => { ... });
- *   app.ws('/chat').on('disconnect', (socket) => { ... });
- *
- *   // 기본 네임스페이스 ("/")
- *   app.ws.on('message', (socket, data) => { ... });
- */
-
-/**
- * 개별 WebSocket 연결을 나타내는 래퍼.
- */
-class FuzionXSocket {
-    constructor(sessionId, bridge, namespace) {
-        this._bridge = bridge;
-        this._namespace = namespace || null;
-        this.sessionId = sessionId;
-    }
-
-    /** 이 소켓에 메시지 전송 */
-    send(data) {
-        const msg = typeof data === 'string' ? data : JSON.stringify(data);
-        this._bridge.wsSendTo(this.sessionId, msg, this._namespace);
-    }
-
-    /** 전체 연결에 브로드캐스트 (네임스페이스 범위) */
-    broadcast(data) {
-        const msg = typeof data === 'string' ? data : JSON.stringify(data);
-        this._bridge.wsBroadcast(msg, this._namespace);
-    }
-
-    /** 자신을 제외하고 브로드캐스트 (네임스페이스 범위) */
-    broadcastExcluding(data) {
-        const msg = typeof data === 'string' ? data : JSON.stringify(data);
-        this._bridge.wsBroadcastExcluding(msg, this.sessionId, this._namespace);
-    }
-
-    /** 여러 세션에 전송 (네임스페이스 범위) */
-    sendToMany(sessionIds, data) {
-        const msg = typeof data === 'string' ? data : JSON.stringify(data);
-        this._bridge.wsSendToMany(sessionIds, msg, this._namespace);
-    }
-
-    /** 메타데이터 매칭 세션에 전송 (네임스페이스 범위) */
-    sendToMatch(key, value, data) {
-        const msg = typeof data === 'string' ? data : JSON.stringify(data);
-        this._bridge.wsSendToMetadataMatch(key, value, msg, this._namespace);
-    }
-
-    /** 메타데이터 설정 */
-    setMetadata(key, value) {
-        this._bridge.wsSetMetadata(this.sessionId, key, value);
-    }
-
-    /** 메타데이터 조회 */
-    getMetadata(key) {
-        return this._bridge.wsGetMetadata(this.sessionId, key);
-    }
-
-    /** 임의 세션의 메타데이터 조회 (로컬 + 원격 자동 폴백) */
-    getMetadataFor(sessionId, key) {
-        return this._bridge.wsGetMetadata(sessionId, key) || null;
-    }
-
-    /** 네임스페이스별 접속자 수 */
-    get onlineCount() {
-        return this._namespace
-            ? this._bridge.wsGetOnlineCountNs(this._namespace)
-            : this._bridge.wsGetOnlineCount();
-    }
-
-    /** 네임스페이스별 세션 ID 목록 */
-    get sessionIds() {
-        return this._namespace
-            ? this._bridge.wsGetSessionIdsNs(this._namespace)
-            : this._bridge.wsGetSessionIds();
-    }
-
-    /** 연결 끊기 */
-    disconnect() {
-        this._bridge.wsDisconnect(this.sessionId);
-    }
-
-    /** JSON 직렬화 */
-    toJSON() {
-        return { sessionId: this.sessionId };
-    }
-}
-
-/**
- * 네임스페이스별 핸들러 레지스트리.
- */
-class WsNamespace {
-    constructor(path) {
-        this.path = path;
-        this._handlers = { connect: null, message: null, disconnect: null };
-    }
-
-    /**
-     * 이벤트 핸들러 등록.
-     * @param {'connect'|'message'|'disconnect'} event
-     * @param {Function} handler
-     * @returns {WsNamespace} 체이닝 지원
-     */
-    on(event, handler) {
-        if (!['connect', 'message', 'disconnect'].includes(event)) {
-            throw new Error(`Unknown WS event: ${event}`);
-        }
-        this._handlers[event] = handler;
-        return this;
-    }
-}
-
-export function createWs(bridge) {
-    /** @type {Map<string, WsNamespace>} */
-    const namespaces = new Map();
-    let _initialized = false;
-
-    /**
-     * 내부: TSFN 콜백을 bridge에 한 번만 등록.
-     * 모든 네임스페이스의 이벤트가 여기로 들어옴 → path로 dispatch.
-     */
-    function ensureInitialized() {
-        if (_initialized) return;
-        _initialized = true;
-
-        // connect 이벤트 디스패쳐
-        bridge.wsOnConnect((namespace, sessionId) => {
-            const ns = namespaces.get(namespace);
-            if (ns && ns._handlers.connect) {
-                ns._handlers.connect(new FuzionXSocket(sessionId, bridge, namespace));
-            }
-        });
-
-        // message 이벤트 디스패쳐
-        bridge.wsOnMessage((namespace, sessionId, message) => {
-            const ns = namespaces.get(namespace);
-            if (ns && ns._handlers.message) {
-                ns._handlers.message(new FuzionXSocket(sessionId, bridge, namespace), message);
-            }
-        });
-
-        // disconnect 이벤트 디스패쳐
-        bridge.wsOnDisconnect((namespace, sessionId) => {
-            const ns = namespaces.get(namespace);
-            if (ns && ns._handlers.disconnect) {
-                ns._handlers.disconnect(new FuzionXSocket(sessionId, bridge, namespace));
-            }
-        });
-    }
-
-    /**
-     * 네임스페이스를 가져오거나 생성.
-     * @param {string} path
-     * @returns {WsNamespace}
-     */
-    function getOrCreateNs(path) {
-        ensureInitialized();
-        if (!namespaces.has(path)) {
-            namespaces.set(path, new WsNamespace(path));
-        }
-        return namespaces.get(path);
-    }
-
-    // Proxy: ws('/chat') → 네임스페이스, ws.on() → 기본 "/" 네임스페이스
-    const wsProxy = new Proxy(function wsFunc(path) {
-        return getOrCreateNs(path);
-    }, {
-        get(target, prop) {
-            // ws.on('event', handler) → 기본 "/" 네임스페이스
-            if (prop === 'on') {
-                const defaultNs = getOrCreateNs('/');
-                return defaultNs.on.bind(defaultNs);
-            }
-
-            // ws.broadcast, ws.sendTo 등 글로벌 유틸
-            switch (prop) {
-                case 'broadcast':
-                    return (data) => bridge.wsBroadcast(typeof data === 'string' ? data : JSON.stringify(data));
-                case 'broadcastExcluding':
-                    return (data, excludeSessionId) => bridge.wsBroadcastExcluding(typeof data === 'string' ? data : JSON.stringify(data), excludeSessionId);
-                case 'broadcastLocal':
-                    return (data) => bridge.wsBroadcastLocal(typeof data === 'string' ? data : JSON.stringify(data));
-                case 'broadcastExcludingLocal':
-                    return (data, excludeSessionId) => bridge.wsBroadcastExcludingLocal(typeof data === 'string' ? data : JSON.stringify(data), excludeSessionId);
-                case 'sendTo':
-                    return (sessionId, data) => bridge.wsSendTo(sessionId, typeof data === 'string' ? data : JSON.stringify(data));
-                case 'sendToMany':
-                    return (sessionIds, data) => bridge.wsSendToMany(sessionIds, typeof data === 'string' ? data : JSON.stringify(data));
-                case 'onlineCount':
-                    return bridge.wsGetOnlineCount();
-                case 'sessionIds':
-                    return bridge.wsGetSessionIds();
-                case 'removeInactive':
-                    return (seconds) => bridge.wsRemoveInactive(seconds);
-                case 'disconnect':
-                    return (sessionId) => bridge.wsDisconnect(sessionId);
-                case 'namespaces':
-                    return namespaces;
-                default:
-                    return Reflect.get(target, prop);
-            }
-        },
-    });
-
-    return wsProxy;
-}
+/**
+ * WebSocket — 네임스페이스 기반 WS 매니저.
+ *
+ * 사용법:
+ *   app.ws('/chat').on('connect', (socket) => { ... });
+ *   app.ws('/chat').on('message', (socket, data) => { ... });
+ *   app.ws('/chat').on('disconnect', (socket) => { ... });
+ *
+ *   // 기본 네임스페이스 ("/")
+ *   app.ws.on('message', (socket, data) => { ... });
+ */
+
+/**
+ * 개별 WebSocket 연결을 나타내는 래퍼.
+ */
+class FuzionXSocket {
+    constructor(sessionId, bridge, namespace) {
+        this._bridge = bridge;
+        this._namespace = namespace || null;
+        this.sessionId = sessionId;
+    }
+
+    /** 이 소켓에 메시지 전송 */
+    send(data) {
+        const msg = typeof data === 'string' ? data : JSON.stringify(data);
+        this._bridge.wsSendTo(this.sessionId, msg, this._namespace);
+    }
+
+    /** 전체 연결에 브로드캐스트 (네임스페이스 범위) */
+    broadcast(data) {
+        const msg = typeof data === 'string' ? data : JSON.stringify(data);
+        this._bridge.wsBroadcast(msg, this._namespace);
+    }
+
+    /** 자신을 제외하고 브로드캐스트 (네임스페이스 범위) */
+    broadcastExcluding(data) {
+        const msg = typeof data === 'string' ? data : JSON.stringify(data);
+        this._bridge.wsBroadcastExcluding(msg, this.sessionId, this._namespace);
+    }
+
+    /** 여러 세션에 전송 (네임스페이스 범위) */
+    sendToMany(sessionIds, data) {
+        const msg = typeof data === 'string' ? data : JSON.stringify(data);
+        this._bridge.wsSendToMany(sessionIds, msg, this._namespace);
+    }
+
+    /** 메타데이터 매칭 세션에 전송 (네임스페이스 범위) */
+    sendToMatch(key, value, data) {
+        const msg = typeof data === 'string' ? data : JSON.stringify(data);
+        this._bridge.wsSendToMetadataMatch(key, value, msg, this._namespace);
+    }
+
+    /** 메타데이터 설정 */
+    setMetadata(key, value) {
+        this._bridge.wsSetMetadata(this.sessionId, key, value);
+    }
+
+    /** 메타데이터 조회 */
+    getMetadata(key) {
+        return this._bridge.wsGetMetadata(this.sessionId, key);
+    }
+
+    /** 임의 세션의 메타데이터 조회 (로컬 + 원격 자동 폴백) */
+    getMetadataFor(sessionId, key) {
+        return this._bridge.wsGetMetadata(sessionId, key) || null;
+    }
+
+    /** 네임스페이스별 접속자 수 */
+    get onlineCount() {
+        return this._namespace
+            ? this._bridge.wsGetOnlineCountNs(this._namespace)
+            : this._bridge.wsGetOnlineCount();
+    }
+
+    /** 네임스페이스별 세션 ID 목록 */
+    get sessionIds() {
+        return this._namespace
+            ? this._bridge.wsGetSessionIdsNs(this._namespace)
+            : this._bridge.wsGetSessionIds();
+    }
+
+    /** 연결 끊기 */
+    disconnect() {
+        this._bridge.wsDisconnect(this.sessionId);
+    }
+
+    /** JSON 직렬화 */
+    toJSON() {
+        return { sessionId: this.sessionId };
+    }
+}
+
+/**
+ * 네임스페이스별 핸들러 레지스트리.
+ */
+class WsNamespace {
+    constructor(path) {
+        this.path = path;
+        this._handlers = { connect: null, message: null, disconnect: null };
+    }
+
+    /**
+     * 이벤트 핸들러 등록.
+     * @param {'connect'|'message'|'disconnect'} event
+     * @param {Function} handler
+     * @returns {WsNamespace} 체이닝 지원
+     */
+    on(event, handler) {
+        if (!['connect', 'message', 'disconnect'].includes(event)) {
+            throw new Error(`Unknown WS event: ${event}`);
+        }
+        this._handlers[event] = handler;
+        return this;
+    }
+}
+
+export function createWs(bridge) {
+    /** @type {Map<string, WsNamespace>} */
+    const namespaces = new Map();
+    let _initialized = false;
+
+    /**
+     * 내부: TSFN 콜백을 bridge에 한 번만 등록.
+     * 모든 네임스페이스의 이벤트가 여기로 들어옴 → path로 dispatch.
+     */
+    function ensureInitialized() {
+        if (_initialized) return;
+        _initialized = true;
+
+        // connect 이벤트 디스패쳐
+        bridge.wsOnConnect((namespace, sessionId) => {
+            const ns = namespaces.get(namespace);
+            if (ns && ns._handlers.connect) {
+                ns._handlers.connect(new FuzionXSocket(sessionId, bridge, namespace));
+            }
+        });
+
+        // message 이벤트 디스패쳐
+        bridge.wsOnMessage((namespace, sessionId, message) => {
+            const ns = namespaces.get(namespace);
+            if (ns && ns._handlers.message) {
+                ns._handlers.message(new FuzionXSocket(sessionId, bridge, namespace), message);
+            }
+        });
+
+        // disconnect 이벤트 디스패쳐
+        bridge.wsOnDisconnect((namespace, sessionId) => {
+            const ns = namespaces.get(namespace);
+            if (ns && ns._handlers.disconnect) {
+                ns._handlers.disconnect(new FuzionXSocket(sessionId, bridge, namespace));
+            }
+        });
+    }
+
+    /**
+     * 네임스페이스를 가져오거나 생성.
+     * @param {string} path
+     * @returns {WsNamespace}
+     */
+    function getOrCreateNs(path) {
+        ensureInitialized();
+        if (!namespaces.has(path)) {
+            namespaces.set(path, new WsNamespace(path));
+        }
+        return namespaces.get(path);
+    }
+
+    // Proxy: ws('/chat') → 네임스페이스, ws.on() → 기본 "/" 네임스페이스
+    const wsProxy = new Proxy(function wsFunc(path) {
+        return getOrCreateNs(path);
+    }, {
+        get(target, prop) {
+            // ws.on('event', handler) → 기본 "/" 네임스페이스
+            if (prop === 'on') {
+                const defaultNs = getOrCreateNs('/');
+                return defaultNs.on.bind(defaultNs);
+            }
+
+            // ws.broadcast, ws.sendTo 등 글로벌 유틸
+            switch (prop) {
+                case 'broadcast':
+                    return (data) => bridge.wsBroadcast(typeof data === 'string' ? data : JSON.stringify(data));
+                case 'broadcastExcluding':
+                    return (data, excludeSessionId) => bridge.wsBroadcastExcluding(typeof data === 'string' ? data : JSON.stringify(data), excludeSessionId);
+                case 'broadcastLocal':
+                    return (data) => bridge.wsBroadcastLocal(typeof data === 'string' ? data : JSON.stringify(data));
+                case 'broadcastExcludingLocal':
+                    return (data, excludeSessionId) => bridge.wsBroadcastExcludingLocal(typeof data === 'string' ? data : JSON.stringify(data), excludeSessionId);
+                case 'sendTo':
+                    return (sessionId, data) => bridge.wsSendTo(sessionId, typeof data === 'string' ? data : JSON.stringify(data));
+                case 'sendToMany':
+                    return (sessionIds, data) => bridge.wsSendToMany(sessionIds, typeof data === 'string' ? data : JSON.stringify(data));
+                case 'onlineCount':
+                    return bridge.wsGetOnlineCount();
+                case 'sessionIds':
+                    return bridge.wsGetSessionIds();
+                case 'removeInactive':
+                    return (seconds) => bridge.wsRemoveInactive(seconds);
+                case 'disconnect':
+                    return (sessionId) => bridge.wsDisconnect(sessionId);
+                case 'namespaces':
+                    return namespaces;
+                default:
+                    return Reflect.get(target, prop);
+            }
+        },
+    });
+
+    return wsProxy;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fuzionx/core",
-  "version": "0.1.39",
+  "version": "0.1.41",
   "type": "module",
   "description": "Express-style Node.js framework powered by FuzionX native bridge — 167K RPS single process",
   "main": "index.js",
@@ -8,7 +8,16 @@
   "exports": {
     ".": "./index.js"
   },
-  "keywords": ["framework", "http", "server", "rust", "native", "high-performance", "fuzionx", "napi"],
+  "keywords": [
+    "framework",
+    "http",
+    "server",
+    "rust",
+    "native",
+    "high-performance",
+    "fuzionx",
+    "napi"
+  ],
   "license": "MIT",
   "engines": {
     "node": ">=18.0.0"
@@ -18,7 +27,7 @@
     "url": "https://github.com/saytohenry/fuzionx"
   },
   "dependencies": {
-    "@fuzionx/bridge": "^0.1.39"
+    "@fuzionx/bridge": "^0.1.41"
   },
   "files": [
     "index.js",