@gencow/core 0.1.24 → 0.1.25

package/src/__tests__/ws-scale.test.ts

@@ -15,33 +15,32 @@
  */
 
 import { describe, it, expect, afterAll } from "bun:test";
-import {
-    buildRealtimeCtx,
-    handleWsMessage,
-    registerClient,
-    deregisterClient,
-} from "../reactive";
+import { buildRealtimeCtx, handleWsMessage, registerClient, deregisterClient } from "../reactive.js";
 
 // ─── WebSocket 서버 ──────────────────────────────────────────────────────────
 
 const PORT = 57891;
 
 const server = Bun.serve({
-    port: PORT,
-    fetch(req: Request, server: any) {
-        if (req.headers.get("upgrade") === "websocket") {
-            server.upgrade(req);
-            return undefined;
-        }
-        return new Response("OK");
+  port: PORT,
+  fetch(req: Request, server: any) {
+    if (req.headers.get("upgrade") === "websocket") {
+      server.upgrade(req);
+      return undefined;
+    }
+    return new Response("OK");
+  },
+  websocket: {
+    open(ws: any) {
+      registerClient(ws);
+    },
+    message(ws: any, data: string | Buffer) {
+      handleWsMessage(ws, typeof data === "string" ? data : data.toString());
     },
-    websocket: {
-        open(ws: any) { registerClient(ws); },
-        message(ws: any, data: string | Buffer) {
-            handleWsMessage(ws, typeof data === "string" ? data : data.toString());
-        },
-        close(ws: any) { deregisterClient(ws); },
+    close(ws: any) {
+      deregisterClient(ws);
     },
+  },
 });
 
 afterAll(() => server.stop(true));
@@ -49,64 +48,72 @@ afterAll(() => server.stop(true));
 // ─── 헬퍼 ────────────────────────────────────────────────────────────────────
 
 interface ScaleClient {
-    ws: WebSocket;
-    receivedAt: number | null;
+  ws: WebSocket;
+  receivedAt: number | null;
 }
 
-const wait = (ms: number) => new Promise(r => setTimeout(r, ms));
+const wait = (ms: number) => new Promise((r) => setTimeout(r, ms));
 
 /**
  * 단일 WebSocket 연결 + subscribe + ready 대기.
  * 연결 실패 시 retry (최대 3회, 100ms 간격).
  */
 function connectOne(queryKey: string, maxRetries = 3): Promise<ScaleClient> {
-    return new Promise(async (resolveOuter) => {
-        const entry: ScaleClient = { ws: null as any, receivedAt: null };
-
-        for (let attempt = 0; attempt <= maxRetries; attempt++) {
-            try {
-                await new Promise<void>((resolve, reject) => {
-                    const ws = new WebSocket(`ws://localhost:${PORT}`);
-                    let settled = false;
-
-                    const timeout = setTimeout(() => {
-                        if (!settled) { settled = true; ws.close(); reject(new Error("timeout")); }
-                    }, 5000);
-
-                    ws.onopen = () => {
-                        ws.send(JSON.stringify({ type: "subscribe", query: queryKey }));
-                    };
-
-                    ws.onmessage = (e: MessageEvent) => {
-                        const msg = JSON.parse(e.data);
-                        if (msg.type === "subscribed" && !settled) {
-                            settled = true;
-                            clearTimeout(timeout);
-                            entry.ws = ws;
-                            // 이후 query:updated 수신 시 기록
-                            ws.onmessage = (e2: MessageEvent) => {
-                                const m = JSON.parse(e2.data);
-                                if (m.type === "query:updated" && m.query === queryKey) {
-                                    entry.receivedAt = performance.now();
-                                }
-                            };
-                            resolve();
-                        }
-                    };
-
-                    ws.onerror = (e) => {
-                        if (!settled) { settled = true; clearTimeout(timeout); reject(e); }
-                    };
-                });
-                resolveOuter(entry);
-                return;
-            } catch {
-                if (attempt < maxRetries) await wait(100 * (attempt + 1));
+  return new Promise(async (resolveOuter) => {
+    const entry: ScaleClient = { ws: null as any, receivedAt: null };
+
+    for (let attempt = 0; attempt <= maxRetries; attempt++) {
+      try {
+        await new Promise<void>((resolve, reject) => {
+          const ws = new WebSocket(`ws://localhost:${PORT}`);
+          let settled = false;
+
+          const timeout = setTimeout(() => {
+            if (!settled) {
+              settled = true;
+              ws.close();
+              reject(new Error("timeout"));
+            }
+          }, 5000);
+
+          ws.onopen = () => {
+            ws.send(JSON.stringify({ type: "subscribe", query: queryKey }));
+          };
+
+          ws.onmessage = (e: MessageEvent) => {
+            const msg = JSON.parse(e.data);
+            if (msg.type === "subscribed" && !settled) {
+              settled = true;
+              clearTimeout(timeout);
+              entry.ws = ws;
+              // 이후 query:updated 수신 시 기록
+              ws.onmessage = (e2: MessageEvent) => {
+                const m = JSON.parse(e2.data);
+                if (m.type === "query:updated" && m.query === queryKey) {
+                  entry.receivedAt = performance.now();
+                }
+              };
+              resolve();
+            }
+          };
+
+          ws.onerror = (e) => {
+            if (!settled) {
+              settled = true;
+              clearTimeout(timeout);
+              reject(e);
             }
-        }
-        // 모든 retry 실패 시에도 반환 (receivedAt=null으로 실패 추적)
+          };
+        });
         resolveOuter(entry);
-    });
+        return;
+      } catch {
+        if (attempt < maxRetries) await wait(100 * (attempt + 1));
+      }
+    }
+    // 모든 retry 실패 시에도 반환 (receivedAt=null으로 실패 추적)
+    resolveOuter(entry);
+  });
 }
 
 /**
@@ -114,119 +121,121 @@ function connectOne(queryKey: string, maxRetries = 3): Promise<ScaleClient> {
  * OS listen backlog 포화를 방지.
  */
 async function connectBatch(n: number, queryKey: string, batchSize = 500): Promise<ScaleClient[]> {
-    const all: ScaleClient[] = [];
-    for (let i = 0; i < n; i += batchSize) {
-        const chunk = Math.min(batchSize, n - i);
-        const batch = await Promise.all(
-            Array.from({ length: chunk }, () => connectOne(queryKey))
-        );
-        all.push(...batch);
-        // 배치 사이 짧은 대기 — 서버가 accept queue를 비울 시간
-        if (i + batchSize < n) await wait(50);
-    }
-    return all;
+  const all: ScaleClient[] = [];
+  for (let i = 0; i < n; i += batchSize) {
+    const chunk = Math.min(batchSize, n - i);
+    const batch = await Promise.all(Array.from({ length: chunk }, () => connectOne(queryKey)));
+    all.push(...batch);
+    // 배치 사이 짧은 대기 — 서버가 accept queue를 비울 시간
+    if (i + batchSize < n) await wait(50);
+  }
+  return all;
 }
 
 function disconnectAll(clients: ScaleClient[]) {
-    for (const c of clients) {
-        try { c.ws?.close(); } catch { }
-    }
+  for (const c of clients) {
+    try {
+      c.ws?.close();
+    } catch {}
+  }
 }
 
 function percentile(sorted: number[], p: number): number {
-    if (sorted.length === 0) return 0;
-    const idx = Math.ceil((p / 100) * sorted.length) - 1;
-    return sorted[Math.max(0, idx)];
+  if (sorted.length === 0) return 0;
+  const idx = Math.ceil((p / 100) * sorted.length) - 1;
+  return sorted[Math.max(0, idx)];
 }
 
 // ─── 공통 테스트 로직 ────────────────────────────────────────────────────────
 
 async function runScaleTest(n: number, label: string, waitMs: number) {
-    const key = `scale.${n}.${Date.now()}`;
+  const key = `scale.${n}.${Date.now()}`;
 
-    const t0 = performance.now();
-    const clients = await connectBatch(n, key);
-    const connectTime = performance.now() - t0;
-    const connected = clients.filter(c => c.ws !== null).length;
+  const t0 = performance.now();
+  const clients = await connectBatch(n, key);
+  const connectTime = performance.now() - t0;
+  const connected = clients.filter((c) => c.ws !== null).length;
 
-    const emitTime = performance.now();
-    buildRealtimeCtx().emit(key, [{ id: 1, title: "Scale Test" }]);
-    await wait(waitMs);
+  const emitTime = performance.now();
+  buildRealtimeCtx().emit(key, [{ id: 1, title: "Scale Test" }]);
+  await wait(waitMs);
 
-    const latencies = clients
-        .filter(c => c.receivedAt !== null)
-        .map(c => c.receivedAt! - emitTime)
-        .sort((a, b) => a - b);
+  const latencies = clients
+    .filter((c) => c.receivedAt !== null)
+    .map((c) => c.receivedAt! - emitTime)
+    .sort((a, b) => a - b);
 
-    const rate = (latencies.length / n) * 100;
-    const p50 = percentile(latencies, 50);
-    const p99 = percentile(latencies, 99);
-    const max = latencies[latencies.length - 1] ?? 0;
+  const rate = (latencies.length / n) * 100;
+  const p50 = percentile(latencies, 50);
+  const p99 = percentile(latencies, 99);
+  const max = latencies[latencies.length - 1] ?? 0;
 
-    console.log(`[${label}]  connect=${connectTime.toFixed(0)}ms (${connected}/${n})  deliver: ${latencies.length}/${n} (${rate.toFixed(1)}%)  P50=${p50.toFixed(1)}ms  P99=${p99.toFixed(1)}ms  Max=${max.toFixed(1)}ms`);
+  console.log(
+    `[${label}]  connect=${connectTime.toFixed(0)}ms (${connected}/${n})  deliver: ${latencies.length}/${n} (${rate.toFixed(1)}%)  P50=${p50.toFixed(1)}ms  P99=${p99.toFixed(1)}ms  Max=${max.toFixed(1)}ms`,
+  );
 
-    disconnectAll(clients);
-    await wait(200);
+  disconnectAll(clients);
+  await wait(200);
 
-    return { n, connectMs: connectTime, connected, delivered: latencies.length, rate, p50, p99, max };
+  return { n, connectMs: connectTime, connected, delivered: latencies.length, rate, p50, p99, max };
 }
 
 // ─── 테스트 ──────────────────────────────────────────────────────────────────
 
 describe("[WS Scale] 실제 TCP WebSocket 대규모 동시 연결", () => {
-    const results: Awaited<ReturnType<typeof runScaleTest>>[] = [];
-
-    it("100 동시 연결 — baseline", async () => {
-        const r = await runScaleTest(100, "WS/100  ", 200);
-        results.push(r);
-        expect(r.rate).toBe(100);
-    });
-
-    it("500 동시 연결", async () => {
-        const r = await runScaleTest(500, "WS/500  ", 300);
-        results.push(r);
-        expect(r.rate).toBe(100);
-    });
-
-    it("1,000 동시 연결", async () => {
-        const r = await runScaleTest(1_000, "WS/1k   ", 500);
-        results.push(r);
-        expect(r.rate).toBe(100);
-    });
-
-    it("2,000 동시 연결", async () => {
-        const r = await runScaleTest(2_000, "WS/2k   ", 1000);
-        results.push(r);
-        expect(r.rate).toBe(100);
-    });
-
-    it("5,000 동시 연결", async () => {
-        const r = await runScaleTest(5_000, "WS/5k   ", 2000);
-        results.push(r);
-        expect(r.rate).toBe(100);
-    });
-
-    it("10,000 동시 연결", async () => {
-        const r = await runScaleTest(10_000, "WS/10k  ", 3000);
-        results.push(r);
-        expect(r.rate).toBe(100);
-    });
-
-    it("결과 요약 테이블 출력", () => {
-        console.log("\n┌──────────┬────────────┬──────────┬──────────┬──────────┬──────────┐");
-        console.log("│ 구독자   │ 연결 시간  │ 수신률   │   P50    │   P99    │   Max    │");
-        console.log("├──────────┼────────────┼──────────┼──────────┼──────────┼──────────┤");
-        for (const r of results) {
-            const n = String(r.n).padStart(7);
-            const conn = `${r.connectMs.toFixed(0)}ms`.padStart(8);
-            const rate = `${r.rate.toFixed(1)}%`.padStart(6);
-            const p50 = `${r.p50.toFixed(1)}ms`.padStart(7);
-            const p99 = `${r.p99.toFixed(1)}ms`.padStart(7);
-            const max = `${r.max.toFixed(1)}ms`.padStart(7);
-            console.log(`│ ${n}  │ ${conn}   │ ${rate}   │ ${p50}  │ ${p99}  │ ${max}  │`);
-        }
-        console.log("└──────────┴────────────┴──────────┴──────────┴──────────┴──────────┘\n");
-
-        expect(results.length).toBeGreaterThanOrEqual(6);
-    });
+  const results: Awaited<ReturnType<typeof runScaleTest>>[] = [];
+
+  it("100 동시 연결 — baseline", async () => {
+    const r = await runScaleTest(100, "WS/100  ", 200);
+    results.push(r);
+    expect(r.rate).toBe(100);
+  });
+
+  it("500 동시 연결", async () => {
+    const r = await runScaleTest(500, "WS/500  ", 300);
+    results.push(r);
+    expect(r.rate).toBe(100);
+  });
+
+  it("1,000 동시 연결", async () => {
+    const r = await runScaleTest(1_000, "WS/1k   ", 500);
+    results.push(r);
+    expect(r.rate).toBe(100);
+  });
+
+  it("2,000 동시 연결", async () => {
+    const r = await runScaleTest(2_000, "WS/2k   ", 1000);
+    results.push(r);
+    expect(r.rate).toBe(100);
+  });
+
+  it("5,000 동시 연결", async () => {
+    const r = await runScaleTest(5_000, "WS/5k   ", 2000);
+    results.push(r);
+    expect(r.rate).toBe(100);
+  });
+
+  it("10,000 동시 연결", async () => {
+    const r = await runScaleTest(10_000, "WS/10k  ", 3000);
+    results.push(r);
+    expect(r.rate).toBe(100);
+  });
+
+  it("결과 요약 테이블 출력", () => {
+    console.log("\n┌──────────┬────────────┬──────────┬──────────┬──────────┬──────────┐");
+    console.log("│ 구독자   │ 연결 시간  │ 수신률   │   P50    │   P99    │   Max    │");
+    console.log("├──────────┼────────────┼──────────┼──────────┼──────────┼──────────┤");
+    for (const r of results) {
+      const n = String(r.n).padStart(7);
+      const conn = `${r.connectMs.toFixed(0)}ms`.padStart(8);
+      const rate = `${r.rate.toFixed(1)}%`.padStart(6);
+      const p50 = `${r.p50.toFixed(1)}ms`.padStart(7);
+      const p99 = `${r.p99.toFixed(1)}ms`.padStart(7);
+      const max = `${r.max.toFixed(1)}ms`.padStart(7);
+      console.log(`│ ${n}  │ ${conn}   │ ${rate}   │ ${p50}  │ ${p99}  │ ${max}  │`);
+    }
+    console.log("└──────────┴────────────┴──────────┴──────────┴──────────┴──────────┘\n");
+
+    expect(results.length).toBeGreaterThanOrEqual(6);
+  });
 });

package/src/auth-config.ts

@@ -11,28 +11,28 @@
 // ─── Email Verification ──────────────────────────────────
 
 export interface AuthEmailVerification {
-    /** 가입 시 인증 메일 자동 발송 (default: true) */
-    sendOnSignUp?: boolean;
-    /** 이메일 미인증 시 로그인 차단 (default: true) */
-    requireEmailVerification?: boolean;
-    /** 인증 완료 후 자동 로그인 (default: true) */
-    autoSignInAfterVerification?: boolean;
-    /** 인증 메일 발송 함수 — 사용자가 직접 구현 */
-    sendVerificationEmail: (data: {
-        user: { email: string; name: string };
-        url: string;
-        token: string;
-    }) => Promise<void>;
+  /** 가입 시 인증 메일 자동 발송 (default: true) */
+  sendOnSignUp?: boolean;
+  /** 이메일 미인증 시 로그인 차단 (default: true) */
+  requireEmailVerification?: boolean;
+  /** 인증 완료 후 자동 로그인 (default: true) */
+  autoSignInAfterVerification?: boolean;
+  /** 인증 메일 발송 함수 — 사용자가 직접 구현 */
+  sendVerificationEmail: (data: {
+    user: { email: string; name: string };
+    url: string;
+    token: string;
+  }) => Promise<void>;
 }
 
 // ─── Auth Config ─────────────────────────────────────────
 
 export interface GencowAuthConfig {
-    emailVerification?: AuthEmailVerification;
-    // 확장 예정:
-    // socialProviders?: { ... }
-    // passwordPolicy?: { ... }
-    // sessionExpiry?: number
+  emailVerification?: AuthEmailVerification;
+  // 확장 예정:
+  // socialProviders?: { ... }
+  // passwordPolicy?: { ... }
+  // sessionExpiry?: number
 }
 
 // ─── defineAuth() ────────────────────────────────────────
@@ -55,5 +55,5 @@ export interface GencowAuthConfig {
  * ```
  */
 export function defineAuth(config: GencowAuthConfig): GencowAuthConfig {
-    return config;
+  return config;
 }