@noverachat/sdk-web 0.5.1 → 0.5.2

package/dist/index.cjs

@@ -403,14 +403,26 @@ var ReconnectingWs = class _ReconnectingWs {
   // heartbeats and a stale typing event is worse than no event.
   outboundQueue = [];
   static OUTBOUND_QUEUE_CAP = 200;
+  /**
+   * 연결 시도의 세대 번호 — `connect()`/`close()` 마다 올린다.
+   *
+   * `openOnce()` 는 `urlBuilder()`(토큰 발급 왕복)를 await 하는 동안 아직
+   * 소켓이 없어서, 그 틈에 들어온 `close()` 는 닫을 대상을 찾지 못한다.
+   * 이어서 새 `connect()` 가 `explicitClose` 를 되돌리면, 뒤늦게 깨어난
+   * 앞선 시도가 **아무도 닫지 않는 소켓**을 하나 더 만든다(React StrictMode 의
+   * mount → cleanup → mount 에서 재현). 불리언 하나로는 "이미 취소됐다"를
+   * 알릴 수 없으므로 세대 번호로 판별한다.
+   */
+  gen = 0;
   get currentState() {
     return this.state;
   }
   async connect() {
     this.explicitClose = false;
-    await this.openOnce();
+    await this.openOnce(++this.gen);
   }
   close() {
+    this.gen++;
     this.explicitClose = true;
     this.setState("closed");
     if (this.pingTimer) clearInterval(this.pingTimer);
@@ -443,7 +455,8 @@ var ReconnectingWs = class _ReconnectingWs {
     );
     return true;
   }
-  async openOnce() {
+  async openOnce(gen) {
+    if (gen !== this.gen) return;
     this.setState(this.attempt === 0 ? "connecting" : "reconnecting");
     const WSImpl = this.opts.WebSocketImpl ?? globalThis.WebSocket;
     if (!WSImpl) throw new Error("No WebSocket implementation available");
@@ -452,7 +465,11 @@ var ReconnectingWs = class _ReconnectingWs {
       url = await this.opts.urlBuilder();
     } catch (err) {
       this.opts.logger?.("error", "url_builder_failed", err);
-      this.scheduleReconnect();
+      if (gen === this.gen) this.scheduleReconnect();
+      return;
+    }
+    if (gen !== this.gen) {
+      this.opts.logger?.("info", "ws_open_aborted_stale", { gen, current: this.gen });
       return;
     }
     const ws = new WSImpl(url);
@@ -517,8 +534,9 @@ var ReconnectingWs = class _ReconnectingWs {
     const delay = exp + jitter;
     this.opts.logger?.("info", "ws_reconnect_scheduled", { attempt: this.attempt, delay });
     this.setState("reconnecting");
+    const gen = this.gen;
     setTimeout(() => {
-      void this.openOnce();
+      void this.openOnce(gen);
     }, delay);
   }
   startPings() {

package/dist/index.d.cts

@@ -666,6 +666,17 @@ declare class ReconnectingWs {
     private explicitClose;
     private outboundQueue;
     private static readonly OUTBOUND_QUEUE_CAP;
+    /**
+     * 연결 시도의 세대 번호 — `connect()`/`close()` 마다 올린다.
+     *
+     * `openOnce()` 는 `urlBuilder()`(토큰 발급 왕복)를 await 하는 동안 아직
+     * 소켓이 없어서, 그 틈에 들어온 `close()` 는 닫을 대상을 찾지 못한다.
+     * 이어서 새 `connect()` 가 `explicitClose` 를 되돌리면, 뒤늦게 깨어난
+     * 앞선 시도가 **아무도 닫지 않는 소켓**을 하나 더 만든다(React StrictMode 의
+     * mount → cleanup → mount 에서 재현). 불리언 하나로는 "이미 취소됐다"를
+     * 알릴 수 없으므로 세대 번호로 판별한다.
+     */
+    private gen;
     constructor(opts: ReconnectingWsOptions);
     get currentState(): WsState;
     connect(): Promise<void>;

package/dist/index.d.ts

@@ -666,6 +666,17 @@ declare class ReconnectingWs {
     private explicitClose;
     private outboundQueue;
     private static readonly OUTBOUND_QUEUE_CAP;
+    /**
+     * 연결 시도의 세대 번호 — `connect()`/`close()` 마다 올린다.
+     *
+     * `openOnce()` 는 `urlBuilder()`(토큰 발급 왕복)를 await 하는 동안 아직
+     * 소켓이 없어서, 그 틈에 들어온 `close()` 는 닫을 대상을 찾지 못한다.
+     * 이어서 새 `connect()` 가 `explicitClose` 를 되돌리면, 뒤늦게 깨어난
+     * 앞선 시도가 **아무도 닫지 않는 소켓**을 하나 더 만든다(React StrictMode 의
+     * mount → cleanup → mount 에서 재현). 불리언 하나로는 "이미 취소됐다"를
+     * 알릴 수 없으므로 세대 번호로 판별한다.
+     */
+    private gen;
     constructor(opts: ReconnectingWsOptions);
     get currentState(): WsState;
     connect(): Promise<void>;

package/dist/index.js

@@ -368,14 +368,26 @@ var ReconnectingWs = class _ReconnectingWs {
   // heartbeats and a stale typing event is worse than no event.
   outboundQueue = [];
   static OUTBOUND_QUEUE_CAP = 200;
+  /**
+   * 연결 시도의 세대 번호 — `connect()`/`close()` 마다 올린다.
+   *
+   * `openOnce()` 는 `urlBuilder()`(토큰 발급 왕복)를 await 하는 동안 아직
+   * 소켓이 없어서, 그 틈에 들어온 `close()` 는 닫을 대상을 찾지 못한다.
+   * 이어서 새 `connect()` 가 `explicitClose` 를 되돌리면, 뒤늦게 깨어난
+   * 앞선 시도가 **아무도 닫지 않는 소켓**을 하나 더 만든다(React StrictMode 의
+   * mount → cleanup → mount 에서 재현). 불리언 하나로는 "이미 취소됐다"를
+   * 알릴 수 없으므로 세대 번호로 판별한다.
+   */
+  gen = 0;
   get currentState() {
     return this.state;
   }
   async connect() {
     this.explicitClose = false;
-    await this.openOnce();
+    await this.openOnce(++this.gen);
   }
   close() {
+    this.gen++;
     this.explicitClose = true;
     this.setState("closed");
     if (this.pingTimer) clearInterval(this.pingTimer);
@@ -408,7 +420,8 @@ var ReconnectingWs = class _ReconnectingWs {
     );
     return true;
   }
-  async openOnce() {
+  async openOnce(gen) {
+    if (gen !== this.gen) return;
     this.setState(this.attempt === 0 ? "connecting" : "reconnecting");
     const WSImpl = this.opts.WebSocketImpl ?? globalThis.WebSocket;
     if (!WSImpl) throw new Error("No WebSocket implementation available");
@@ -417,7 +430,11 @@ var ReconnectingWs = class _ReconnectingWs {
       url = await this.opts.urlBuilder();
     } catch (err) {
       this.opts.logger?.("error", "url_builder_failed", err);
-      this.scheduleReconnect();
+      if (gen === this.gen) this.scheduleReconnect();
+      return;
+    }
+    if (gen !== this.gen) {
+      this.opts.logger?.("info", "ws_open_aborted_stale", { gen, current: this.gen });
       return;
     }
     const ws = new WSImpl(url);
@@ -482,8 +499,9 @@ var ReconnectingWs = class _ReconnectingWs {
     const delay = exp + jitter;
     this.opts.logger?.("info", "ws_reconnect_scheduled", { attempt: this.attempt, delay });
     this.setState("reconnecting");
+    const gen = this.gen;
     setTimeout(() => {
-      void this.openOnce();
+      void this.openOnce(gen);
     }, delay);
   }
   startPings() {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@noverachat/sdk-web",
-  "version": "0.5.1",
+  "version": "0.5.2",
   "description": "NoveraChat browser/Node SDK — WebSocket + REST client with optimistic UI, reconnection and gap-fill",
   "license": "MIT",
   "type": "module",

package/src/transport/ws.ts

@@ -41,6 +41,17 @@ export class ReconnectingWs {
   // heartbeats and a stale typing event is worse than no event.
   private outboundQueue: WsOutbound[] = [];
   private static readonly OUTBOUND_QUEUE_CAP = 200;
+  /**
+   * 연결 시도의 세대 번호 — `connect()`/`close()` 마다 올린다.
+   *
+   * `openOnce()` 는 `urlBuilder()`(토큰 발급 왕복)를 await 하는 동안 아직
+   * 소켓이 없어서, 그 틈에 들어온 `close()` 는 닫을 대상을 찾지 못한다.
+   * 이어서 새 `connect()` 가 `explicitClose` 를 되돌리면, 뒤늦게 깨어난
+   * 앞선 시도가 **아무도 닫지 않는 소켓**을 하나 더 만든다(React StrictMode 의
+   * mount → cleanup → mount 에서 재현). 불리언 하나로는 "이미 취소됐다"를
+   * 알릴 수 없으므로 세대 번호로 판별한다.
+   */
+  private gen = 0;
 
   constructor(private opts: ReconnectingWsOptions) {}
 
@@ -50,10 +61,11 @@ export class ReconnectingWs {
 
   async connect(): Promise<void> {
     this.explicitClose = false;
-    await this.openOnce();
+    await this.openOnce(++this.gen);
   }
 
   close(): void {
+    this.gen++; // 진행 중인 연결 시도를 모두 무효화한다
     this.explicitClose = true;
     this.setState("closed");
     if (this.pingTimer) clearInterval(this.pingTimer);
@@ -91,7 +103,8 @@ export class ReconnectingWs {
     return true;
   }
 
-  private async openOnce(): Promise<void> {
+  private async openOnce(gen: number): Promise<void> {
+    if (gen !== this.gen) return;
     this.setState(this.attempt === 0 ? "connecting" : "reconnecting");
     const WSImpl = this.opts.WebSocketImpl ?? (globalThis.WebSocket as typeof WebSocket);
     if (!WSImpl) throw new Error("No WebSocket implementation available");
@@ -101,7 +114,14 @@ export class ReconnectingWs {
       url = await this.opts.urlBuilder();
     } catch (err) {
       this.opts.logger?.("error", "url_builder_failed", err);
-      this.scheduleReconnect();
+      if (gen === this.gen) this.scheduleReconnect();
+      return;
+    }
+
+    // await 사이에 close()/connect() 가 지나갔으면 이 시도는 이미 취소된
+    // 것이다 — 소켓을 만들지 않고 물러난다(누수 소켓 방지).
+    if (gen !== this.gen) {
+      this.opts.logger?.("info", "ws_open_aborted_stale", { gen, current: this.gen });
       return;
     }
 
@@ -175,8 +195,9 @@ export class ReconnectingWs {
     const delay = exp + jitter;
     this.opts.logger?.("info", "ws_reconnect_scheduled", { attempt: this.attempt, delay });
     this.setState("reconnecting");
+    const gen = this.gen; // 예약 시점의 세대 — 그사이 close/connect 가 오면 취소
     setTimeout(() => {
-      void this.openOnce();
+      void this.openOnce(gen);
     }, delay);
   }