@noverachat/sdk-web 0.5.0 → 0.5.1

package/dist/index.cjs

@@ -826,7 +826,15 @@ var MessageCollection = class {
       this._messages.splice(0, this.hydratedCount);
       this.hydratedCount = 0;
     }
-    this._messages.unshift(...page.items.map(chatMessageFromHistory));
+    const indexById = /* @__PURE__ */ new Map();
+    this._messages.forEach((m, i) => indexById.set(m.id, i));
+    const fresh = [];
+    for (const item of page.items.map(chatMessageFromHistory)) {
+      const at = indexById.get(item.id);
+      if (at === void 0) fresh.push(item);
+      else this._messages[at] = item;
+    }
+    this._messages.unshift(...fresh);
     this.oldestCursor = page.nextCursor;
     this._hasMore = page.hasMore;
     this.emit("replaced");
@@ -997,8 +1005,26 @@ var MessageCollection = class {
     this.bus.removeAll();
   }
   // ── event handlers ──────────────────────────────────────────────
+  /**
+   * 수신 프레임을 컬렉션에 넣는다.
+   *
+   * 두 가지를 방어한다 — backfill(`chat.backfill()`)은 재연결 시 앵커
+   * 이후를 **다시** 실어오므로, 이미 들고 있는 메시지가 섞여 오고 화면보다
+   * 오래된 메시지도 함께 온다:
+   * - **중복**: 같은 id가 이미 있으면 무시한다.
+   * - **순서**: 뒤에서부터 자리를 찾아 꽂는다. 실시간 프레임은 항상 마지막
+   *   메시지보다 새로우므로 비교 1번으로 끝나고(빠른 경로), 옛 메시지가
+   *   섞여 올 때만 탐색이 일어난다.
+   */
   onIncoming(f) {
-    this._messages.push(chatMessageFromLive(f));
+    const msg = chatMessageFromLive(f);
+    let i = this._messages.length - 1;
+    for (; i >= 0; i--) {
+      const cur = this._messages[i];
+      if (cur.id === msg.id) return;
+      if (!idGreater(cur.id, msg.id)) break;
+    }
+    this._messages.splice(i + 1, 0, msg);
     this.emit("inserted");
   }
   onUpdated(f) {
@@ -2163,6 +2189,16 @@ var NoveraChat = class {
   readDebounceMs;
   logger;
   connectedOnce = false;
+  /**
+   * 방별 "실시간 파이프라인으로 본 최대 message_id" — 재연결 핸드셰이크의
+   * `?since=`와 backfill 시작점.
+   *
+   * **의도적으로 낮게 유지한다.** 히스토리 로드(REST)는 이 값을 올리지
+   * 않는다 — 앵커가 낮으면 backfill이 이미 가진 것까지 다시 주는 쪽으로
+   * (안전), 높으면 못 받은 것을 영영 건너뛰는 쪽으로(치명) 실패하기
+   * 때문이다. 중복은 수신 측(`MessageCollection.onIncoming`)의 id dedupe가
+   * 흡수하므로, "빠뜨린 갱신"으로 보고 올리지 말 것.
+   */
   lastMessageIdByRoom = /* @__PURE__ */ new Map();
   /** Most recently dispatched presence event key, `${userId}:${at}:${online}`.
    *  Used to drop the N-1 shared-room copies of a single online/offline

package/dist/index.d.cts

@@ -912,6 +912,17 @@ declare class MessageCollection {
     /** Unsubscribe from the room and flush the pending read watermark. The
      *  collection must not be used afterwards. */
     dispose(): void;
+    /**
+     * 수신 프레임을 컬렉션에 넣는다.
+     *
+     * 두 가지를 방어한다 — backfill(`chat.backfill()`)은 재연결 시 앵커
+     * 이후를 **다시** 실어오므로, 이미 들고 있는 메시지가 섞여 오고 화면보다
+     * 오래된 메시지도 함께 온다:
+     * - **중복**: 같은 id가 이미 있으면 무시한다.
+     * - **순서**: 뒤에서부터 자리를 찾아 꽂는다. 실시간 프레임은 항상 마지막
+     *   메시지보다 새로우므로 비교 1번으로 끝나고(빠른 경로), 옛 메시지가
+     *   섞여 올 때만 탐색이 일어난다.
+     */
     private onIncoming;
     private onUpdated;
     private onDeleted;
@@ -1386,6 +1397,16 @@ declare class NoveraChat {
     private readDebounceMs;
     private logger;
     private connectedOnce;
+    /**
+     * 방별 "실시간 파이프라인으로 본 최대 message_id" — 재연결 핸드셰이크의
+     * `?since=`와 backfill 시작점.
+     *
+     * **의도적으로 낮게 유지한다.** 히스토리 로드(REST)는 이 값을 올리지
+     * 않는다 — 앵커가 낮으면 backfill이 이미 가진 것까지 다시 주는 쪽으로
+     * (안전), 높으면 못 받은 것을 영영 건너뛰는 쪽으로(치명) 실패하기
+     * 때문이다. 중복은 수신 측(`MessageCollection.onIncoming`)의 id dedupe가
+     * 흡수하므로, "빠뜨린 갱신"으로 보고 올리지 말 것.
+     */
     private lastMessageIdByRoom;
     /** Most recently dispatched presence event key, `${userId}:${at}:${online}`.
      *  Used to drop the N-1 shared-room copies of a single online/offline

package/dist/index.d.ts

@@ -912,6 +912,17 @@ declare class MessageCollection {
     /** Unsubscribe from the room and flush the pending read watermark. The
      *  collection must not be used afterwards. */
     dispose(): void;
+    /**
+     * 수신 프레임을 컬렉션에 넣는다.
+     *
+     * 두 가지를 방어한다 — backfill(`chat.backfill()`)은 재연결 시 앵커
+     * 이후를 **다시** 실어오므로, 이미 들고 있는 메시지가 섞여 오고 화면보다
+     * 오래된 메시지도 함께 온다:
+     * - **중복**: 같은 id가 이미 있으면 무시한다.
+     * - **순서**: 뒤에서부터 자리를 찾아 꽂는다. 실시간 프레임은 항상 마지막
+     *   메시지보다 새로우므로 비교 1번으로 끝나고(빠른 경로), 옛 메시지가
+     *   섞여 올 때만 탐색이 일어난다.
+     */
     private onIncoming;
     private onUpdated;
     private onDeleted;
@@ -1386,6 +1397,16 @@ declare class NoveraChat {
     private readDebounceMs;
     private logger;
     private connectedOnce;
+    /**
+     * 방별 "실시간 파이프라인으로 본 최대 message_id" — 재연결 핸드셰이크의
+     * `?since=`와 backfill 시작점.
+     *
+     * **의도적으로 낮게 유지한다.** 히스토리 로드(REST)는 이 값을 올리지
+     * 않는다 — 앵커가 낮으면 backfill이 이미 가진 것까지 다시 주는 쪽으로
+     * (안전), 높으면 못 받은 것을 영영 건너뛰는 쪽으로(치명) 실패하기
+     * 때문이다. 중복은 수신 측(`MessageCollection.onIncoming`)의 id dedupe가
+     * 흡수하므로, "빠뜨린 갱신"으로 보고 올리지 말 것.
+     */
     private lastMessageIdByRoom;
     /** Most recently dispatched presence event key, `${userId}:${at}:${online}`.
      *  Used to drop the N-1 shared-room copies of a single online/offline

package/dist/index.js

@@ -791,7 +791,15 @@ var MessageCollection = class {
       this._messages.splice(0, this.hydratedCount);
       this.hydratedCount = 0;
     }
-    this._messages.unshift(...page.items.map(chatMessageFromHistory));
+    const indexById = /* @__PURE__ */ new Map();
+    this._messages.forEach((m, i) => indexById.set(m.id, i));
+    const fresh = [];
+    for (const item of page.items.map(chatMessageFromHistory)) {
+      const at = indexById.get(item.id);
+      if (at === void 0) fresh.push(item);
+      else this._messages[at] = item;
+    }
+    this._messages.unshift(...fresh);
     this.oldestCursor = page.nextCursor;
     this._hasMore = page.hasMore;
     this.emit("replaced");
@@ -962,8 +970,26 @@ var MessageCollection = class {
     this.bus.removeAll();
   }
   // ── event handlers ──────────────────────────────────────────────
+  /**
+   * 수신 프레임을 컬렉션에 넣는다.
+   *
+   * 두 가지를 방어한다 — backfill(`chat.backfill()`)은 재연결 시 앵커
+   * 이후를 **다시** 실어오므로, 이미 들고 있는 메시지가 섞여 오고 화면보다
+   * 오래된 메시지도 함께 온다:
+   * - **중복**: 같은 id가 이미 있으면 무시한다.
+   * - **순서**: 뒤에서부터 자리를 찾아 꽂는다. 실시간 프레임은 항상 마지막
+   *   메시지보다 새로우므로 비교 1번으로 끝나고(빠른 경로), 옛 메시지가
+   *   섞여 올 때만 탐색이 일어난다.
+   */
   onIncoming(f) {
-    this._messages.push(chatMessageFromLive(f));
+    const msg = chatMessageFromLive(f);
+    let i = this._messages.length - 1;
+    for (; i >= 0; i--) {
+      const cur = this._messages[i];
+      if (cur.id === msg.id) return;
+      if (!idGreater(cur.id, msg.id)) break;
+    }
+    this._messages.splice(i + 1, 0, msg);
     this.emit("inserted");
   }
   onUpdated(f) {
@@ -2128,6 +2154,16 @@ var NoveraChat = class {
   readDebounceMs;
   logger;
   connectedOnce = false;
+  /**
+   * 방별 "실시간 파이프라인으로 본 최대 message_id" — 재연결 핸드셰이크의
+   * `?since=`와 backfill 시작점.
+   *
+   * **의도적으로 낮게 유지한다.** 히스토리 로드(REST)는 이 값을 올리지
+   * 않는다 — 앵커가 낮으면 backfill이 이미 가진 것까지 다시 주는 쪽으로
+   * (안전), 높으면 못 받은 것을 영영 건너뛰는 쪽으로(치명) 실패하기
+   * 때문이다. 중복은 수신 측(`MessageCollection.onIncoming`)의 id dedupe가
+   * 흡수하므로, "빠뜨린 갱신"으로 보고 올리지 말 것.
+   */
   lastMessageIdByRoom = /* @__PURE__ */ new Map();
   /** Most recently dispatched presence event key, `${userId}:${at}:${online}`.
    *  Used to drop the N-1 shared-room copies of a single online/offline

package/package.json

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

package/src/client.ts

@@ -57,6 +57,16 @@ export class NoveraChat {
   private readDebounceMs: number;
   private logger: ClientOptions["logger"];
   private connectedOnce = false;
+  /**
+   * 방별 "실시간 파이프라인으로 본 최대 message_id" — 재연결 핸드셰이크의
+   * `?since=`와 backfill 시작점.
+   *
+   * **의도적으로 낮게 유지한다.** 히스토리 로드(REST)는 이 값을 올리지
+   * 않는다 — 앵커가 낮으면 backfill이 이미 가진 것까지 다시 주는 쪽으로
+   * (안전), 높으면 못 받은 것을 영영 건너뛰는 쪽으로(치명) 실패하기
+   * 때문이다. 중복은 수신 측(`MessageCollection.onIncoming`)의 id dedupe가
+   * 흡수하므로, "빠뜨린 갱신"으로 보고 올리지 말 것.
+   */
   private lastMessageIdByRoom = new Map<string, MessageIdStr>();
   /** Most recently dispatched presence event key, `${userId}:${at}:${online}`.
    *  Used to drop the N-1 shared-room copies of a single online/offline

package/src/features/message-collection.ts

@@ -223,7 +223,18 @@ export class MessageCollection {
       this._messages.splice(0, this.hydratedCount); // 스냅샷 통째 폐기 → 서버가 이긴다
       this.hydratedCount = 0;
     }
-    this._messages.unshift(...page.items.map(chatMessageFromHistory));
+    // id 기준 upsert — 이미 들고 있는 메시지는 서버 버전으로 교체하고, 없는
+    // 것만 앞에 잇는다. `load()`가 두 번 불려도(React StrictMode의 mount →
+    // cleanup → mount 사이클처럼) 같은 페이지가 겹쳐 쌓이지 않는다.
+    const indexById = new Map<string, number>();
+    this._messages.forEach((m, i) => indexById.set(m.id, i));
+    const fresh: ChatMessage[] = [];
+    for (const item of page.items.map(chatMessageFromHistory)) {
+      const at = indexById.get(item.id);
+      if (at === undefined) fresh.push(item);
+      else this._messages[at] = item; // 겹치는 구간은 서버가 이긴다
+    }
+    this._messages.unshift(...fresh);
     this.oldestCursor = page.nextCursor;
     this._hasMore = page.hasMore;
     this.emit("replaced");
@@ -439,8 +450,26 @@ export class MessageCollection {
 
   // ── event handlers ──────────────────────────────────────────────
 
+  /**
+   * 수신 프레임을 컬렉션에 넣는다.
+   *
+   * 두 가지를 방어한다 — backfill(`chat.backfill()`)은 재연결 시 앵커
+   * 이후를 **다시** 실어오므로, 이미 들고 있는 메시지가 섞여 오고 화면보다
+   * 오래된 메시지도 함께 온다:
+   * - **중복**: 같은 id가 이미 있으면 무시한다.
+   * - **순서**: 뒤에서부터 자리를 찾아 꽂는다. 실시간 프레임은 항상 마지막
+   *   메시지보다 새로우므로 비교 1번으로 끝나고(빠른 경로), 옛 메시지가
+   *   섞여 올 때만 탐색이 일어난다.
+   */
   private onIncoming(f: WsChatReceive): void {
-    this._messages.push(chatMessageFromLive(f));
+    const msg = chatMessageFromLive(f);
+    let i = this._messages.length - 1;
+    for (; i >= 0; i--) {
+      const cur = this._messages[i]!;
+      if (cur.id === msg.id) return; // 이미 있음 — 재전송분
+      if (!idGreater(cur.id, msg.id)) break; // 여기가 삽입 자리
+    }
+    this._messages.splice(i + 1, 0, msg);
     this.emit("inserted");
   }