@gaonjs/web 0.1.3 → 0.2.1

package/dist/websocket.js

@@ -0,0 +1,103 @@
+// @gaonjs/web · WebSocket 전송 계층 (§7 실시간 · M6)
+//
+// 채널의 전송을 @fastify/websocket 으로 붙인다. 채널 정의(@gaonjs/async 의
+// channel())는 전송을 모르고, 여기서 raw WebSocket 을 SocketAdapter 로 감싸
+// ChannelRuntime 에 넘긴다. 라우트는 앱 캡슐화 스코프 안에 등록되므로
+// 세션(M5)이 그대로 살아 있어 연결을 인증할 수 있다.
+//
+// 경로 관례: `<앱 프리픽스>/gaon/ws/:channel`. 채널명은 apps/*/channels/
+// 파일명이다(파일=등록). 알 수 없는 채널은 4404 로 닫는다.
+import websocketPlugin from '@fastify/websocket';
+import { randomUUID } from 'node:crypto';
+/**
+ * @fastify/websocket 을 등록한다. 전역 upgrade 훅을 걸므로 서버당 **한 번만**
+ * (루트에서) 호출해야 한다. 라우트(registerChannels)는 이후 어느 스코프에서든
+ * 정의할 수 있다.
+ */
+export async function registerWebSocketSupport(app) {
+    await app.register(websocketPlugin);
+}
+/** 세션 userId 로 멤버를 정한다. 비로그인은 익명 연결 id. */
+async function defaultResolveMember(request) {
+    const sess = request.session;
+    const uid = sess?.userId;
+    if (uid != null)
+        return { member: `user:${String(uid)}`, user: { id: uid } };
+    return { member: `conn:${randomUUID()}`, user: null };
+}
+function queryOf(request) {
+    const q = request.query;
+    const out = {};
+    if (q)
+        for (const [k, v] of Object.entries(q))
+            if (typeof v === 'string')
+                out[k] = v;
+    return out;
+}
+/**
+ * 앱 스코프에 채널 ws 라우트를 등록한다. 연결마다 멤버를 해석하고 런타임에
+ * join 을 위임하며, 소켓 메시지를 채널 정의의 onMessage 로 흘린다.
+ */
+export function registerChannels(scope, opts) {
+    // @fastify/websocket 은 registerWebSocketSupport 로 루트에서 이미 등록됐다고
+    // 가정한다(전역 upgrade 훅 중복 방지). 여기서는 채널 라우트만 정의한다.
+    const resolve = opts.resolveMember ?? defaultResolveMember;
+    const routePath = opts.path ?? '/gaon/ws/:channel';
+    scope.get(routePath, { websocket: true }, (socket, request) => {
+        const name = request.params.channel ?? '';
+        const def = opts.channels[name];
+        if (!def) {
+            socket.close(4404, 'unknown channel');
+            return;
+        }
+        const adapter = {
+            send: (text) => {
+                if (socket.readyState === socket.OPEN)
+                    socket.send(text);
+            },
+            close: (code, reason) => socket.close(code, reason),
+        };
+        // join 은 비동기(허브 왕복). 그 사이 도착한 메시지는 버퍼링했다가 재생한다.
+        const pending = [];
+        let conn = null;
+        let ready = false;
+        let closed = false;
+        socket.on('message', (raw) => {
+            const text = typeof raw === 'string' ? raw : String(raw);
+            if (ready && conn)
+                void conn.receive(text);
+            else
+                pending.push(text);
+        });
+        socket.on('close', () => {
+            closed = true;
+            if (conn)
+                void conn.leave();
+        });
+        void (async () => {
+            const { member, user } = await resolve(request);
+            const c = await opts.runtime.join({
+                channel: name,
+                def,
+                member,
+                user,
+                query: queryOf(request),
+                socket: adapter,
+            });
+            if (!c)
+                return; // 인가 거부 — 런타임이 소켓을 닫았다.
+            conn = c;
+            if (closed) {
+                void c.leave(); // join 도중 이미 끊겼으면 즉시 정리.
+                return;
+            }
+            ready = true;
+            for (const t of pending)
+                void c.receive(t);
+            pending.length = 0;
+        })().catch((err) => {
+            adapter.send(JSON.stringify({ t: 'error', message: err instanceof Error ? err.message : String(err) }));
+            socket.close(1011, 'join failed');
+        });
+    });
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@gaonjs/web",
-  "version": "0.1.3",
+  "version": "0.2.1",
   "description": "Gaon 웹 레이어: Fastify 통합·파일 기반 라우팅·보안 기본값 (구현 예정)",
   "type": "module",
   "license": "MIT",
@@ -24,7 +24,18 @@
     "README.md"
   ],
   "dependencies": {
-    "@gaonjs/core": "0.1.2"
+    "@fastify/cookie": "^11.1.2",
+    "@fastify/cors": "^11.3.0",
+    "@fastify/csrf-protection": "^8.0.0",
+    "@fastify/rate-limit": "^11.1.0",
+    "@fastify/session": "^11.1.2",
+    "@fastify/websocket": "^11.0.2",
+    "bcryptjs": "^3.0.3",
+    "fastify": "^5.10.0",
+    "ioredis": "^5.11.1",
+    "jose": "^6.2.4",
+    "@gaonjs/core": "0.1.3",
+    "@gaonjs/async": "0.2.0"
   },
   "scripts": {
     "build": "node ../../node_modules/typescript/bin/tsc -p tsconfig.json"