@noverachat/sdk-web 0.5.2 → 0.6.0

package/dist/index.cjs

@@ -620,6 +620,7 @@ function chatMessageFromHistory(m) {
     messageType: m.messageType,
     sender: m.sender ?? null,
     customType: m.customType ?? null,
+    data: m.data ?? null,
     fileId: m.fileId ?? null,
     file: m.file ?? null,
     files: m.files ?? null,
@@ -644,6 +645,7 @@ function chatMessageFromLive(f) {
     messageType: f.message_type,
     sender: null,
     customType: f.custom_type ?? null,
+    data,
     fileId: f.file_id ?? null,
     file: f.file ? fileInlineFromWire(f.file) : null,
     files: f.files ? f.files.map(fileInlineFromWire) : null,
@@ -666,6 +668,7 @@ function pendingChatMessage(p) {
     messageType: "TEXT",
     sender: null,
     customType: p.customType ?? null,
+    data: p.data ?? null,
     fileId: null,
     file: null,
     files: null,
@@ -689,6 +692,7 @@ function pendingFileChatMessage(p) {
     messageType: "FILE",
     sender: null,
     customType: null,
+    data: null,
     fileId: null,
     file: {
       id: "",
@@ -912,6 +916,7 @@ var MessageCollection = class {
           content: text,
           ...opts?.replyToId ? { replyToId: opts.replyToId } : {},
           ...opts?.customType ? { customType: opts.customType } : {},
+          ...opts?.data ? { data: opts.data } : {},
           ...opts?.customMeta ? { customMeta: opts.customMeta } : {}
         });
         tempId2 = sent.tempId;
@@ -2066,6 +2071,16 @@ var Room = class _Room {
     this.pendingAcks.delete(tempId2);
     this.mySentTempIds.delete(tempId2);
   }
+  /**
+   * ack 를 기다리던 전송을 전부 실패 처리한다 — `chat.disconnect()` 처럼
+   * 응답이 올 길이 사라졌을 때. 메시지 컬렉션은 건드리지 않는다(낙관적
+   * 버블은 `failed` 로 바뀌어 재전송 UI 를 띄울 수 있다).
+   */
+  _failPendingSends(reason) {
+    for (const tempId2 of [...this.pendingAcks.keys()]) {
+      this._rejectPending(tempId2, new Error(reason));
+    }
+  }
   /**
    * Try to re-send a pending frame after a transient server reject
    * (currently only NC-RATE-001 — the tenant's per-second token bucket
@@ -2226,9 +2241,22 @@ var NoveraChat = class {
   async connect() {
     await this.ws.connect();
   }
+  /**
+   * 소켓을 닫는다. **Room 파사드와 그 메시지 상태는 유지한다** — `connect()`
+   * 로 다시 붙으면 같은 파사드가 그대로 이어서 프레임을 받는다.
+   *
+   * 예전엔 여기서 `rooms.clear()` 를 했는데, 그러면 UI 가 들고 있던 컬렉션이
+   * 다음 접근 때 빈 컬렉션으로 교체돼 이미 로드한 히스토리가 사라졌다
+   * (React StrictMode 의 connect → disconnect → connect 에서 채팅방이 빈
+   * 화면으로 뜨는 증상). 소켓은 재사용되는 `ReconnectingWs` 인스턴스라
+   * 파사드가 참조를 유지해도 문제가 없다.
+   *
+   * 다만 ack 를 기다리던 전송은 응답 받을 길이 없으므로 여기서 실패로
+   * 정리한다(낙관적 버블이 영원히 `sending` 으로 남지 않도록).
+   */
   disconnect() {
     this.ws.close();
-    this.rooms.clear();
+    for (const room of this.rooms.values()) room._failPendingSends("disconnected");
   }
   room(roomId) {
     let r = this.rooms.get(roomId);

package/dist/index.d.cts

@@ -723,6 +723,15 @@ interface ChatMessage {
     sender: SenderMini | null;
     /** App-defined subtype (e.g. a message-priority convention). */
     customType: string | null;
+    /**
+     * 서버가 그대로 통과시키는 앱 정의 페이로드 원문.
+     *
+     * 테넌트가 `customType` 과 짝지어 쓰는 규약이 여기 담긴다 — 예: 이미지
+     * 메시지를 `customType: "IMAGE"` + `data: { kind, fileId, url, thumbUrl }`
+     * 로 표현하는 식. SDK 는 내용을 해석하지 않고 원문을 넘긴다.
+     * ([customMeta] 는 이 안의 예약 키 `_customMeta` 를 꺼낸 편의 필드다.)
+     */
+    data: Record<string, unknown> | null;
     /** Snowflake id (string) of the attached file, when this is a file message. */
     fileId: string | null;
     /** Inline metadata of the attached file — enough to render a placeholder
@@ -758,6 +767,7 @@ declare function pendingChatMessage(p: {
     content: string;
     replyToId?: string;
     customType?: string;
+    data?: Record<string, unknown>;
     customMeta?: Record<string, unknown>;
 }): ChatMessage;
 /** An optimistic bubble for a FILE message whose bytes are still uploading.
@@ -898,6 +908,10 @@ declare class MessageCollection {
     send(text: string, opts?: {
         replyToId?: string;
         customType?: string;
+        /** 앱 정의 페이로드 원문 — `customType` 과 짝지어 쓰는 테넌트 규약용
+         *  (예: `customType:"IMAGE"` + `data:{kind,fileId,url,thumbUrl}`).
+         *  낙관적 버블에도 그대로 실려 전송 즉시 렌더할 수 있다. */
+        data?: Record<string, unknown>;
         customMeta?: Record<string, unknown>;
     }): void;
     /** Send a file optimistically. A FILE bubble with `uploadProgress`
@@ -1348,6 +1362,12 @@ declare class Room {
      *  fail the matching outbound promise immediately instead of waiting
      *  for the 15s ack timeout. */
     _rejectPending(tempId: string, err: Error): void;
+    /**
+     * ack 를 기다리던 전송을 전부 실패 처리한다 — `chat.disconnect()` 처럼
+     * 응답이 올 길이 사라졌을 때. 메시지 컬렉션은 건드리지 않는다(낙관적
+     * 버블은 `failed` 로 바뀌어 재전송 UI 를 띄울 수 있다).
+     */
+    _failPendingSends(reason: string): void;
     /**
      * Try to re-send a pending frame after a transient server reject
      * (currently only NC-RATE-001 — the tenant's per-second token bucket
@@ -1426,6 +1446,19 @@ declare class NoveraChat {
     private lastPresenceKey;
     constructor(opts: ClientOptions);
     connect(): Promise<void>;
+    /**
+     * 소켓을 닫는다. **Room 파사드와 그 메시지 상태는 유지한다** — `connect()`
+     * 로 다시 붙으면 같은 파사드가 그대로 이어서 프레임을 받는다.
+     *
+     * 예전엔 여기서 `rooms.clear()` 를 했는데, 그러면 UI 가 들고 있던 컬렉션이
+     * 다음 접근 때 빈 컬렉션으로 교체돼 이미 로드한 히스토리가 사라졌다
+     * (React StrictMode 의 connect → disconnect → connect 에서 채팅방이 빈
+     * 화면으로 뜨는 증상). 소켓은 재사용되는 `ReconnectingWs` 인스턴스라
+     * 파사드가 참조를 유지해도 문제가 없다.
+     *
+     * 다만 ack 를 기다리던 전송은 응답 받을 길이 없으므로 여기서 실패로
+     * 정리한다(낙관적 버블이 영원히 `sending` 으로 남지 않도록).
+     */
     disconnect(): void;
     room(roomId: string): Room;
     /** Subscribe to client-level events. Currently `roomEvent` — membership /

package/dist/index.d.ts

@@ -723,6 +723,15 @@ interface ChatMessage {
     sender: SenderMini | null;
     /** App-defined subtype (e.g. a message-priority convention). */
     customType: string | null;
+    /**
+     * 서버가 그대로 통과시키는 앱 정의 페이로드 원문.
+     *
+     * 테넌트가 `customType` 과 짝지어 쓰는 규약이 여기 담긴다 — 예: 이미지
+     * 메시지를 `customType: "IMAGE"` + `data: { kind, fileId, url, thumbUrl }`
+     * 로 표현하는 식. SDK 는 내용을 해석하지 않고 원문을 넘긴다.
+     * ([customMeta] 는 이 안의 예약 키 `_customMeta` 를 꺼낸 편의 필드다.)
+     */
+    data: Record<string, unknown> | null;
     /** Snowflake id (string) of the attached file, when this is a file message. */
     fileId: string | null;
     /** Inline metadata of the attached file — enough to render a placeholder
@@ -758,6 +767,7 @@ declare function pendingChatMessage(p: {
     content: string;
     replyToId?: string;
     customType?: string;
+    data?: Record<string, unknown>;
     customMeta?: Record<string, unknown>;
 }): ChatMessage;
 /** An optimistic bubble for a FILE message whose bytes are still uploading.
@@ -898,6 +908,10 @@ declare class MessageCollection {
     send(text: string, opts?: {
         replyToId?: string;
         customType?: string;
+        /** 앱 정의 페이로드 원문 — `customType` 과 짝지어 쓰는 테넌트 규약용
+         *  (예: `customType:"IMAGE"` + `data:{kind,fileId,url,thumbUrl}`).
+         *  낙관적 버블에도 그대로 실려 전송 즉시 렌더할 수 있다. */
+        data?: Record<string, unknown>;
         customMeta?: Record<string, unknown>;
     }): void;
     /** Send a file optimistically. A FILE bubble with `uploadProgress`
@@ -1348,6 +1362,12 @@ declare class Room {
      *  fail the matching outbound promise immediately instead of waiting
      *  for the 15s ack timeout. */
     _rejectPending(tempId: string, err: Error): void;
+    /**
+     * ack 를 기다리던 전송을 전부 실패 처리한다 — `chat.disconnect()` 처럼
+     * 응답이 올 길이 사라졌을 때. 메시지 컬렉션은 건드리지 않는다(낙관적
+     * 버블은 `failed` 로 바뀌어 재전송 UI 를 띄울 수 있다).
+     */
+    _failPendingSends(reason: string): void;
     /**
      * Try to re-send a pending frame after a transient server reject
      * (currently only NC-RATE-001 — the tenant's per-second token bucket
@@ -1426,6 +1446,19 @@ declare class NoveraChat {
     private lastPresenceKey;
     constructor(opts: ClientOptions);
     connect(): Promise<void>;
+    /**
+     * 소켓을 닫는다. **Room 파사드와 그 메시지 상태는 유지한다** — `connect()`
+     * 로 다시 붙으면 같은 파사드가 그대로 이어서 프레임을 받는다.
+     *
+     * 예전엔 여기서 `rooms.clear()` 를 했는데, 그러면 UI 가 들고 있던 컬렉션이
+     * 다음 접근 때 빈 컬렉션으로 교체돼 이미 로드한 히스토리가 사라졌다
+     * (React StrictMode 의 connect → disconnect → connect 에서 채팅방이 빈
+     * 화면으로 뜨는 증상). 소켓은 재사용되는 `ReconnectingWs` 인스턴스라
+     * 파사드가 참조를 유지해도 문제가 없다.
+     *
+     * 다만 ack 를 기다리던 전송은 응답 받을 길이 없으므로 여기서 실패로
+     * 정리한다(낙관적 버블이 영원히 `sending` 으로 남지 않도록).
+     */
     disconnect(): void;
     room(roomId: string): Room;
     /** Subscribe to client-level events. Currently `roomEvent` — membership /

package/dist/index.js

@@ -585,6 +585,7 @@ function chatMessageFromHistory(m) {
     messageType: m.messageType,
     sender: m.sender ?? null,
     customType: m.customType ?? null,
+    data: m.data ?? null,
     fileId: m.fileId ?? null,
     file: m.file ?? null,
     files: m.files ?? null,
@@ -609,6 +610,7 @@ function chatMessageFromLive(f) {
     messageType: f.message_type,
     sender: null,
     customType: f.custom_type ?? null,
+    data,
     fileId: f.file_id ?? null,
     file: f.file ? fileInlineFromWire(f.file) : null,
     files: f.files ? f.files.map(fileInlineFromWire) : null,
@@ -631,6 +633,7 @@ function pendingChatMessage(p) {
     messageType: "TEXT",
     sender: null,
     customType: p.customType ?? null,
+    data: p.data ?? null,
     fileId: null,
     file: null,
     files: null,
@@ -654,6 +657,7 @@ function pendingFileChatMessage(p) {
     messageType: "FILE",
     sender: null,
     customType: null,
+    data: null,
     fileId: null,
     file: {
       id: "",
@@ -877,6 +881,7 @@ var MessageCollection = class {
           content: text,
           ...opts?.replyToId ? { replyToId: opts.replyToId } : {},
           ...opts?.customType ? { customType: opts.customType } : {},
+          ...opts?.data ? { data: opts.data } : {},
           ...opts?.customMeta ? { customMeta: opts.customMeta } : {}
         });
         tempId2 = sent.tempId;
@@ -2031,6 +2036,16 @@ var Room = class _Room {
     this.pendingAcks.delete(tempId2);
     this.mySentTempIds.delete(tempId2);
   }
+  /**
+   * ack 를 기다리던 전송을 전부 실패 처리한다 — `chat.disconnect()` 처럼
+   * 응답이 올 길이 사라졌을 때. 메시지 컬렉션은 건드리지 않는다(낙관적
+   * 버블은 `failed` 로 바뀌어 재전송 UI 를 띄울 수 있다).
+   */
+  _failPendingSends(reason) {
+    for (const tempId2 of [...this.pendingAcks.keys()]) {
+      this._rejectPending(tempId2, new Error(reason));
+    }
+  }
   /**
    * Try to re-send a pending frame after a transient server reject
    * (currently only NC-RATE-001 — the tenant's per-second token bucket
@@ -2191,9 +2206,22 @@ var NoveraChat = class {
   async connect() {
     await this.ws.connect();
   }
+  /**
+   * 소켓을 닫는다. **Room 파사드와 그 메시지 상태는 유지한다** — `connect()`
+   * 로 다시 붙으면 같은 파사드가 그대로 이어서 프레임을 받는다.
+   *
+   * 예전엔 여기서 `rooms.clear()` 를 했는데, 그러면 UI 가 들고 있던 컬렉션이
+   * 다음 접근 때 빈 컬렉션으로 교체돼 이미 로드한 히스토리가 사라졌다
+   * (React StrictMode 의 connect → disconnect → connect 에서 채팅방이 빈
+   * 화면으로 뜨는 증상). 소켓은 재사용되는 `ReconnectingWs` 인스턴스라
+   * 파사드가 참조를 유지해도 문제가 없다.
+   *
+   * 다만 ack 를 기다리던 전송은 응답 받을 길이 없으므로 여기서 실패로
+   * 정리한다(낙관적 버블이 영원히 `sending` 으로 남지 않도록).
+   */
   disconnect() {
     this.ws.close();
-    this.rooms.clear();
+    for (const room of this.rooms.values()) room._failPendingSends("disconnected");
   }
   room(roomId) {
     let r = this.rooms.get(roomId);

package/package.json

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

package/src/chat-message.ts

@@ -44,6 +44,15 @@ export interface ChatMessage {
   sender: SenderMini | null;
   /** App-defined subtype (e.g. a message-priority convention). */
   customType: string | null;
+  /**
+   * 서버가 그대로 통과시키는 앱 정의 페이로드 원문.
+   *
+   * 테넌트가 `customType` 과 짝지어 쓰는 규약이 여기 담긴다 — 예: 이미지
+   * 메시지를 `customType: "IMAGE"` + `data: { kind, fileId, url, thumbUrl }`
+   * 로 표현하는 식. SDK 는 내용을 해석하지 않고 원문을 넘긴다.
+   * ([customMeta] 는 이 안의 예약 키 `_customMeta` 를 꺼낸 편의 필드다.)
+   */
+  data: Record<string, unknown> | null;
   /** Snowflake id (string) of the attached file, when this is a file message. */
   fileId: string | null;
   /** Inline metadata of the attached file — enough to render a placeholder
@@ -96,6 +105,7 @@ export function chatMessageFromHistory(m: MessageOut): ChatMessage {
     messageType: m.messageType,
     sender: m.sender ?? null,
     customType: m.customType ?? null,
+    data: m.data ?? null,
     fileId: m.fileId ?? null,
     file: m.file ?? null,
     files: m.files ?? null,
@@ -127,6 +137,7 @@ export function chatMessageFromLive(f: WsChatReceive): ChatMessage {
     messageType: f.message_type,
     sender: null,
     customType: f.custom_type ?? null,
+    data,
     fileId: f.file_id ?? null,
     file: f.file ? fileInlineFromWire(f.file) : null,
     files: f.files ? f.files.map(fileInlineFromWire) : null,
@@ -146,6 +157,7 @@ export function pendingChatMessage(p: {
   content: string;
   replyToId?: string;
   customType?: string;
+  data?: Record<string, unknown>;
   customMeta?: Record<string, unknown>;
 }): ChatMessage {
   return {
@@ -157,6 +169,7 @@ export function pendingChatMessage(p: {
     messageType: "TEXT",
     sender: null,
     customType: p.customType ?? null,
+    data: p.data ?? null,
     fileId: null,
     file: null,
     files: null,
@@ -188,6 +201,7 @@ export function pendingFileChatMessage(p: {
     messageType: "FILE",
     sender: null,
     customType: null,
+    data: null,
     fileId: null,
     file: {
       id: "",

package/src/client.ts

@@ -149,9 +149,22 @@ export class NoveraChat {
     await this.ws.connect();
   }
 
+  /**
+   * 소켓을 닫는다. **Room 파사드와 그 메시지 상태는 유지한다** — `connect()`
+   * 로 다시 붙으면 같은 파사드가 그대로 이어서 프레임을 받는다.
+   *
+   * 예전엔 여기서 `rooms.clear()` 를 했는데, 그러면 UI 가 들고 있던 컬렉션이
+   * 다음 접근 때 빈 컬렉션으로 교체돼 이미 로드한 히스토리가 사라졌다
+   * (React StrictMode 의 connect → disconnect → connect 에서 채팅방이 빈
+   * 화면으로 뜨는 증상). 소켓은 재사용되는 `ReconnectingWs` 인스턴스라
+   * 파사드가 참조를 유지해도 문제가 없다.
+   *
+   * 다만 ack 를 기다리던 전송은 응답 받을 길이 없으므로 여기서 실패로
+   * 정리한다(낙관적 버블이 영원히 `sending` 으로 남지 않도록).
+   */
   disconnect(): void {
     this.ws.close();
-    this.rooms.clear();
+    for (const room of this.rooms.values()) room._failPendingSends("disconnected");
   }
 
   room(roomId: string): Room {

package/src/features/message-collection.ts

@@ -308,6 +308,10 @@ export class MessageCollection {
     opts?: {
       replyToId?: string;
       customType?: string;
+      /** 앱 정의 페이로드 원문 — `customType` 과 짝지어 쓰는 테넌트 규약용
+       *  (예: `customType:"IMAGE"` + `data:{kind,fileId,url,thumbUrl}`).
+       *  낙관적 버블에도 그대로 실려 전송 즉시 렌더할 수 있다. */
+      data?: Record<string, unknown>;
       customMeta?: Record<string, unknown>;
     },
   ): void {
@@ -319,6 +323,7 @@ export class MessageCollection {
           content: text,
           ...(opts?.replyToId ? { replyToId: opts.replyToId } : {}),
           ...(opts?.customType ? { customType: opts.customType } : {}),
+          ...(opts?.data ? { data: opts.data } : {}),
           ...(opts?.customMeta ? { customMeta: opts.customMeta } : {}),
         });
         tempId = sent.tempId;

package/src/features/room.ts

@@ -1246,6 +1246,17 @@ export class Room {
     this.mySentTempIds.delete(tempId);
   }
 
+  /**
+   * ack 를 기다리던 전송을 전부 실패 처리한다 — `chat.disconnect()` 처럼
+   * 응답이 올 길이 사라졌을 때. 메시지 컬렉션은 건드리지 않는다(낙관적
+   * 버블은 `failed` 로 바뀌어 재전송 UI 를 띄울 수 있다).
+   */
+  _failPendingSends(reason: string): void {
+    for (const tempId of [...this.pendingAcks.keys()]) {
+      this._rejectPending(tempId, new Error(reason));
+    }
+  }
+
   /**
    * Try to re-send a pending frame after a transient server reject
    * (currently only NC-RATE-001 — the tenant's per-second token bucket