@noverachat/sdk-web 0.3.0 → 0.4.0

package/dist/index.d.ts

@@ -304,6 +304,25 @@ interface DeviceOut {
     lastActiveAt: string | null;
     createdAt: string;
 }
+interface RoomOut {
+    appId: string;
+    roomId: string;
+    roomType: RoomType;
+    customType: string | null;
+    name: string | null;
+    coverImageUrl: string | null;
+    isDistinct: boolean;
+    isPublic: boolean;
+    isFrozen: boolean;
+    joinPolicy: JoinPolicy;
+    timerSeconds: number | null;
+    memberCount: number;
+    lastMessageId?: string | null;
+    lastMessageAt: string | null;
+    lastMessagePreview?: string | null;
+    currentAnnouncement?: AnnouncementOut | null;
+    createdAt: string;
+}
 /** One row from ``user_blocks`` for the caller.  We DON'T echo ``blocker_user_id`` — it's always the caller, and including it in every list entry would just add noise. ``model_config`` lets the router return ORM instances directly via ``response_model``. */
 interface BlockOut {
     blockedUserId: string;
@@ -350,9 +369,74 @@ interface ReactionEntry {
     userIds: string[];
     updatedAt: number;
 }
+type RoomType = "ONE" | "GROUP" | "SUPER_GROUP";
+type JoinPolicy = "OPEN" | "APPROVAL_REQUIRED";
 type MemberRole = "OPERATOR" | "MEMBER" | "KICKED";
 type PushTrigger = "ALL" | "MENTION_ONLY" | "OFF";
 
+/**
+ * 스냅샷 캐시 — 콜드 스타트 스피너 제거용 렌더 힌트 계층.
+ * (noverachat_dart `lib/src/cache.dart`의 TS 미러 — 의미론 동일)
+ *
+ * 원칙:
+ *   1. 캐시 = 렌더 힌트, 서버가 항상 이긴다 — 시작 시 스냅샷 즉시 렌더,
+ *      API 도착 시 통째 교체(diff 병합 없음).
+ *   2. 저장소는 SDK가 정하지 않는다 — `CacheStore` 인터페이스만 정의,
+ *      구현은 앱이 주입(localStorage/IndexedDB 등).
+ *   3. 버전 스탬프 + 통째 폐기 — 키에 스키마 버전(`nc.v1.…`), 파싱 실패
+ *      시 해당 키를 드랍. 삭제 타이머 켜진 방은 캐시 대상에서 제외.
+ */
+/**
+ * 앱이 주입하는 key-value 스냅샷 저장소.
+ *
+ * SDK는 저장 방식에 관여하지 않는다 — 값은 불투명한 JSON 문자열이며,
+ * 앱이 localStorage·IndexedDB·파일 등 아무 곳에나 보관하면 된다.
+ * 모든 메서드는 실패해도 SDK 동작에 영향이 없다(캐시는 힌트일 뿐).
+ *
+ * ```ts
+ * const localStorageCache: CacheStore = {
+ *   async read(key) { return localStorage.getItem(key); },
+ *   async write(key, value) { localStorage.setItem(key, value); },
+ *   async remove(key) { localStorage.removeItem(key); },
+ * };
+ *
+ * const chat = new NoveraChat({
+ *   appId, endpoint, tokenProvider,
+ *   cacheStore: localStorageCache,
+ * });
+ * ```
+ */
+interface CacheStore {
+    /** `key`의 스냅샷을 돌려준다. 없으면 null. */
+    read(key: string): Promise<string | null>;
+    /** `key`에 스냅샷을 저장한다(덮어쓰기). */
+    write(key: string, value: string): Promise<void>;
+    /** `key`의 스냅샷을 지운다. 없어도 에러 없이 통과. */
+    remove(key: string): Promise<void>;
+}
+/**
+ * 캐시 스냅샷과 API 응답을 어떻게 합칠지.
+ *
+ * 현재는 `"replaceByApi"`만 구현되어 있다 — `"mergeDiff"`는 서버 측
+ * 무효화 규칙(삭제 타이머 만료 통지·재입장 컷오프 등)이 확정된 뒤
+ * 병합 함수가 채워질 진입점이다.
+ */
+type CachePolicy = "replaceByApi" | "mergeDiff";
+/**
+ * 캐시 키 규칙 — `nc.<스키마버전>.<대상>`.
+ *
+ * 스키마 버전이 키에 박혀 있으므로, 저장 포맷이 바뀌면 버전을 올리는
+ * 것만으로 구버전 스냅샷은 다시는 읽히지 않는다(자연 폐기).
+ */
+declare const CacheKeys: {
+    /** 저장 포맷 스키마 버전. 저장되는 JSON 모양이 바뀌면 올린다. */
+    readonly version: "v1";
+    /** 방 목록 스냅샷 (`GET /users/me/unread` 원문). */
+    readonly rooms: "nc.v1.rooms";
+    /** 방 히스토리 최신 페이지 스냅샷 (`GET /rooms/{id}/messages` 원문). */
+    readonly msgs: (roomId: string) => string;
+};
+
 /**
  * Shared wire types. Must stay in lock-step with:
  *   noverachat-backend/src/noverachat/ws/protocol.py
@@ -433,8 +517,7 @@ interface SendParams {
     forwardBlocked?: boolean;
     replyToId?: MessageIdStr;
     /** Set when this send is forwarding an existing message. The server
-     *  uses it to enforce the source file's ``forwardBlocked`` flag (Phase
-     *  C #7): if the source's file is no-forward AND the destination room
+     *  uses it to enforce the source file's ``forwardBlocked`` flag: if the source's file is no-forward AND the destination room
      *  differs from the source room, the send is rejected with
      *  ``NC-FILE-014``. Pass the ORIGINAL message's ``messageId``. */
     forwardOfMessageId?: MessageIdStr;
@@ -507,6 +590,15 @@ interface ClientOptions {
     endpoint: string;
     wsEndpoint?: string;
     tokenProvider: () => Promise<string>;
+    /**
+     * 스냅샷 캐시 저장소 — 생략(기본)하면 캐시 기능이 전부 꺼진다.
+     * 주입하면 방 목록·방 히스토리 최신 페이지가 REST 원문 그대로 저장되고,
+     * `cachedUnreadSummary()` / `room.cachedRecent()` 로 콜드 스타트 즉시
+     * 렌더에 쓸 수 있다. 자세한 건 `CacheStore` 문서 참조.
+     */
+    cacheStore?: CacheStore;
+    /** 캐시 스냅샷과 API 응답의 합성 방식. 현재 `"replaceByApi"`만 지원. */
+    cachePolicy?: CachePolicy;
     autoReconnect?: boolean;
     pingIntervalMs?: number;
     readWatermarkDebounceMs?: number;
@@ -582,6 +674,238 @@ declare class ReconnectingWs {
     private setState;
 }
 
+/**
+ * UI 지향 메시지 뷰모델 — sdk-react에서 코어로 이동.
+ * (`MessageCollection`이 이 모양으로 상태를 소유하고, 바인딩은 재수출만 한다.
+ *  noverachat_dart `lib/src/chat_message.dart`의 TS 대응물.)
+ */
+
+/** Delivery status of an outgoing (optimistic) message. */
+type ChatMessageStatus = "sending" | "sent" | "failed";
+/**
+ * A single message as the UI wants it — one uniform shape over the SDK's
+ * three sources: `MessageOut` (history/REST), `WsChatReceive` (live/WS), and
+ * an optimistic bubble we just sent.
+ *
+ * Treat instances as immutable — `MessageCollection` evolves them by
+ * replacement, never mutation.
+ */
+interface ChatMessage {
+    /** The server message id, or the `tempId` while still `sending`. */
+    id: string;
+    /** Author user id. `null` means the current user (an optimistic bubble). */
+    senderId: string | null;
+    content: string | null;
+    /** Creation time in unix milliseconds. */
+    createdAtMs: number | null;
+    status: ChatMessageStatus;
+    /** `TEXT | FILE | EMOTICON | ADMIN | SYSTEM` — UIs use this to render
+     *  system/admin lines (centered notices) differently from chat bubbles. */
+    messageType: string;
+    /** Sender identity (nickname / profile image) when the server included it.
+     *  Null for optimistic bubbles and live frames (which carry only
+     *  `senderId`) — UIs typically resolve the profile from their member list. */
+    sender: SenderMini | null;
+    /** App-defined subtype (e.g. a message-priority convention). */
+    customType: string | 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
+     *  without a round-trip. May be null even when `fileId` is set; fetch via
+     *  `chat.getFileMeta` then. */
+    file: FileInline | null;
+    /** Multi-file bundle (`file_group`). Null for single-file / text messages.
+     *  Check `files?.length` first and fall back to the `file` singleton. */
+    files: FileInline[] | null;
+    /** Id of the message this one replies to, if any. */
+    replyToId: string | null;
+    /** Emoji reactions grouped by key. Kept live by `MessageCollection` from
+     *  the reaction WS events. */
+    reactions: ReactionEntry[];
+    /** Sender-attached custom metadata (`data._customMeta`). */
+    customMeta: Record<string, unknown> | null;
+    /** How many times the message was edited. `> 0` → show an "edited" mark. */
+    editedCount: number;
+    /** Upload progress in [0, 1] while an optimistic FILE message's bytes are
+     *  still going up to S3. Null once committed (or for non-file messages). */
+    uploadProgress: number | null;
+    /** The optimistic temp id, kept for ack reconciliation. Null once confirmed. */
+    tempId: string | null;
+    isDeleted: boolean;
+}
+/** Build a `ChatMessage` from server history (REST). */
+declare function chatMessageFromHistory(m: MessageOut): ChatMessage;
+/** Build a `ChatMessage` from a live inbound frame (WS). */
+declare function chatMessageFromLive(f: WsChatReceive): ChatMessage;
+/** An optimistic bubble for a message we just sent, before the server acks. */
+declare function pendingChatMessage(p: {
+    tempId: string;
+    content: string;
+    replyToId?: string;
+    customType?: string;
+    customMeta?: Record<string, unknown>;
+}): ChatMessage;
+/** An optimistic bubble for a FILE message whose bytes are still uploading.
+ *  `uploadProgress` starts at 0 and is advanced by `MessageCollection`. */
+declare function pendingFileChatMessage(p: {
+    tempId: string;
+    name: string;
+    mime?: string;
+    size?: number;
+}): ChatMessage;
+
+/**
+ * 코어 소유 메시지 상태 — noverachat_dart `MessageCollection`의 TS 미러.
+ *
+ * RoomStore(sdk-react)에 있던 이벤트 반영·낙관적 전송·캐시 hydrate→교체
+ * 로직의 코어 이관본. 바인딩(React·Flutter)은 이 컬렉션을 감싸는 얇은
+ * 접착층이 되고, "캐시는 렌더 힌트, 서버가 항상 이긴다" 같은 불변식은
+ * 코어가 강제한다. 추후 diff 병합은 `applyFresh`의 mergeDiff 분기
+ * 하나로 들어온다.
+ */
+
+/**
+ * 컬렉션 상태가 바뀐 이유. 지금 소비자(얇은 래퍼)는 "바뀌었다"만 알면
+ * 되므로 kind만 담는다 — 세밀한 렌더 최적화가 필요해지면 필드를
+ * **추가**(비파괴)로 확장한다.
+ *
+ * - `hydrated`   캐시 스냅샷이 렌더됨 (콜드 스타트 힌트 — 곧 `replaced`가 따라온다)
+ * - `replaced`   API 응답이 스냅샷/기존 페이지를 통째로 대체함 (서버가 이겼다)
+ * - `inserted`   메시지가 추가됨 (라이브 수신·낙관적 버블·스크롤백 페이지)
+ * - `updated`    기존 메시지가 제자리 갱신됨 (수정·삭제 플래그·리액션·ack 플립)
+ * - `watermarks` 읽음 워터마크가 전진함
+ */
+type CollectionChangeKind = "hydrated" | "replaced" | "inserted" | "updated" | "watermarks";
+/** `MessageCollection`의 `change` 이벤트로 흐르는 변경 통지. */
+interface CollectionChange {
+    kind: CollectionChangeKind;
+}
+/**
+ * A `Room`'s message list as owned, live state — the core-side equivalent
+ * of Sendbird's `MessageCollection` (without a local DB).
+ *
+ * Applies the room's events into one `messages` list, drives optimistic
+ * sends, and runs the snapshot-cache contract (`load()` hydrates from cache
+ * instantly, then wholesale-replaces when the API answers). Subscribe with
+ * `on("change", ...)` and re-render `messages` on every event — all state
+ * mutations and change emits are synchronous with the WS dispatch.
+ *
+ * ```ts
+ * const col = chat.room("room_123").collection();
+ * const unsub = col.on("change", () => render(col.messages));
+ * await col.load();
+ * col.send("hello");
+ * col.markRead(col.messages.at(-1)!.id);
+ * // ...
+ * col.dispose(); unsub();
+ * ```
+ */
+declare class MessageCollection {
+    /** The room this collection is bound to. */
+    readonly room: Room;
+    private readonly policy;
+    private readonly bus;
+    private readonly unsubs;
+    private _messages;
+    private _readWatermarks;
+    private _hasMore;
+    private oldestCursor;
+    private loadingMore;
+    /**
+     * 캐시 스냅샷으로 렌더된 머리쪽 메시지 수 — API 도착 시 이만큼 걷어내고
+     * 통째 교체한다(replaceByApi). 라이브 수신은 리스트 꼬리에 붙으므로
+     * 머리 range 제거로 스냅샷만 정확히 걷힌다.
+     */
+    private hydratedCount;
+    constructor(
+    /** The room this collection is bound to. */
+    room: Room, policy?: CachePolicy);
+    /** The current messages, oldest first. Treat as read-only. */
+    get messages(): readonly ChatMessage[];
+    /** True when older history remains — fire `loadMore()` from the top of
+     *  the scroll view. */
+    get hasMore(): boolean;
+    /** Per-user read watermarks (`userId` → last read `messageId`), kept live
+     *  from `sync_tick` frames. Treat as read-only. */
+    get readWatermarks(): Readonly<Record<string, string>>;
+    /** State-change notifications. One event per mutation; re-read `messages`
+     *  (and friends) when it fires. Returns an unsubscribe fn. */
+    on(event: "change", fn: (c: CollectionChange) => void): () => void;
+    /** Whether `userId` has read `messageId` according to the latest watermark. */
+    isReadBy(userId: string, messageId: string): boolean;
+    /** How many of the given users have read `messageId`. Pass the room's
+     *  member ids (minus the sender) to get a KakaoTalk-style unread count:
+     *  `members.length - readCount(...)`. */
+    readCount(messageId: string, userIds: Iterable<string>): number;
+    /**
+     * Load the most recent page of history.
+     *
+     * `ClientOptions.cacheStore`가 주입돼 있으면 캐시 스냅샷을 먼저 렌더한
+     * 뒤(`hydrated`), API 응답 도착 시 스냅샷을 걷어내고 통째로 교체한다
+     * (`replaced`). 스냅샷 렌더 중에는 `hasMore`/스크롤백을 열지 않는다 —
+     * 커서는 API 응답의 것만 신뢰한다.
+     */
+    load(limit?: number): Promise<void>;
+    /** Scrollback: load the page of messages older than what's on screen and
+     *  prepend it. No-op while a previous call is in flight or when `hasMore`
+     *  is false. Returns the number of messages added. */
+    loadMore(limit?: number): Promise<number>;
+    /** 캐시 스냅샷 즉시 렌더 — 빈 리스트일 때만. 실패는 조용히 무시(캐시는
+     *  힌트일 뿐). */
+    private hydrateFromCache;
+    /**
+     * API 최신 페이지를 컬렉션에 반영한다 — **diff 병합 진입점**.
+     * replaceByApi(현재 유일 정책)는 스냅샷을 걷어내고 통째 교체하고,
+     * mergeDiff는 서버 무효화 규칙 확정 후 이 분기 안에 병합 함수가 채워진다.
+     */
+    private applyFresh;
+    /**
+     * Send `text` optimistically: a `sending` bubble appears immediately (one
+     * microtask later — `Room.send` is async), then flips to `sent` (with the
+     * real id) on ack, or `failed` on error. Fire-and-forget: a WS-not-open
+     * failure surfaces as a `failed` bubble rather than a rejected promise.
+     */
+    send(text: string, opts?: {
+        replyToId?: string;
+        customType?: string;
+        customMeta?: Record<string, unknown>;
+    }): void;
+    /** Send a file optimistically. A FILE bubble with `uploadProgress`
+     *  appears immediately; progress advances during the S3 upload, then the
+     *  bubble flips to `sent` on ack (or `failed`). Never throws — failures
+     *  surface as the bubble's status. */
+    sendFile(file: File, opts?: SendFileOptions): Promise<void>;
+    /** Edit a message's content (server-side; peers get `message_updated`).
+     *  The local copy updates optimistically. */
+    edit(messageId: string, content: string): Promise<void>;
+    /** Delete a message. `scope: "ALL"` (default) removes it for everyone;
+     *  `"MY"` hides it only for the caller. Local copy flips to deleted. */
+    delete(messageId: string, scope?: DeleteScope): Promise<void>;
+    /** Add/remove the caller's reaction. Pass `myUserId` so the toggle can
+     *  tell whether the caller already reacted with `key`. The authoritative
+     *  state arrives back via the reaction WS events. */
+    toggleReaction(messageId: string, key: string, myUserId: string): Promise<void>;
+    /** Mark `messageId` read (debounced inside the SDK). */
+    markRead(messageId: string): void;
+    /** Force-send the pending read watermark now (e.g. on unmount / tab
+     *  backgrounding). */
+    flushMarkRead(): void;
+    /** Unsubscribe from the room and flush the pending read watermark. The
+     *  collection must not be used afterwards. */
+    dispose(): void;
+    private onIncoming;
+    private onUpdated;
+    private onDeleted;
+    private onCleared;
+    private onReactionAdded;
+    private onReactionRemoved;
+    private onSyncTick;
+    private bindAck;
+    private mutateById;
+    private mutateByTempId;
+    private emit;
+}
+
 interface RoomEvents {
     message: WsChatReceive;
     messageUpdated: WsMessageUpdated;
@@ -619,7 +943,32 @@ declare class Room {
      * fine in practice (small strings, cleared on `chat.disconnect()`).
      */
     private mySentTempIds;
-    constructor(roomId: string, http: HttpClient, ws: ReconnectingWs, readDebounceMs: number);
+    private readonly cacheStore;
+    private readonly cachePolicy;
+    private readonly logger;
+    /** 삭제 타이머 여부 세션 메모 — null=미확인, 값=마지막 detail() 결과. */
+    private timerSeconds;
+    private timerKnown;
+    constructor(roomId: string, http: HttpClient, ws: ReconnectingWs, readDebounceMs: number, opts?: {
+        cacheStore?: CacheStore;
+        cachePolicy?: CachePolicy;
+        logger?: ClientOptions["logger"];
+    });
+    /**
+     * 이 방의 메시지 상태를 소유하는 `MessageCollection`을 만든다.
+     *
+     * 컬렉션이 이벤트 반영·낙관적 전송·캐시 hydrate→교체를 전부 담당하므로,
+     * 리스트 화면은 컬렉션 하나만 물면 된다. 여러 개 만들 수 있고 각자
+     * `dispose()`로 정리한다.
+     *
+     * ```ts
+     * const col = chat.room("room_123").collection();
+     * const unsub = col.on("change", () => render(col.messages));
+     * await col.load();
+     * col.send("hello");
+     * ```
+     */
+    collection(policy?: CachePolicy): MessageCollection;
     private _sendPendingMarkRead;
     send(params: string | SendParams): Promise<{
         tempId: string;
@@ -802,6 +1151,28 @@ declare class Room {
         nextCursor: MessageIdStr | null;
         hasMore: boolean;
     }>;
+    /** 이 방의 상세 정보 (`GET /rooms/{id}`) — 이름·멤버 수·삭제 타이머 등. */
+    detail(): Promise<RoomOut>;
+    /**
+     * 히스토리 최신 페이지의 캐시 스냅샷 — 마지막 `listRecent()` 성공 응답의
+     * 원문. 콜드 스타트 렌더 힌트 용도다: 있으면 즉시 그리고, `listRecent()`가
+     * 도착하면 통째로 교체할 것. 캐시가 없거나(`cacheStore` 미주입 포함)
+     * 파싱이 실패하면 `null`을 돌려주고, 깨진 스냅샷은 지운다.
+     *
+     * 스냅샷의 `nextCursor`/`hasMore`는 시점이 지난 값이므로 스크롤백
+     * 커서로 쓰지 말 것 — API 응답이 도착한 뒤의 값만 신뢰한다.
+     */
+    cachedRecent(): Promise<{
+        items: MessageOut[];
+        nextCursor: MessageIdStr | null;
+        hasMore: boolean;
+    } | null>;
+    /**
+     * 최신 페이지 스냅샷 저장. 삭제 타이머가 켜진 방은 저장하지 않고 기존
+     * 스냅샷도 지운다 — 타이머 만료로 서버에서 사라진 메시지가 로컬 캐시에
+     * 살아남는 보안 충돌을 원천 차단한다.
+     */
+    private cacheWriteRecent;
     /**
      * Scrollback. Fetches the page of `limit` messages immediately preceding
      * `beforeMessageId` (exclusive), in ASC order. The returned
@@ -813,7 +1184,7 @@ declare class Room {
         nextCursor: MessageIdStr | null;
         hasMore: boolean;
     }>;
-    /** Phase D #2 — 방 내 메시지 검색.
+    /** 방 내 메시지 검색.
      *
      * ``content`` 필드에 대한 대소문자 무시 부분 문자열 매칭 (ILIKE). 삭제된
      * 메시지는 제외. 결과는 최신순 (message_id DESC) 으로 반환되고, ``before``
@@ -1136,6 +1507,15 @@ declare class NoveraChat {
      */
     getFileMeta(fileId: MessageIdStr): Promise<FileMeta>;
     unreadSummary(): Promise<UnreadSummary>;
+    /**
+     * 방 목록의 캐시 스냅샷 — 마지막 `unreadSummary()` 성공 응답의 원문.
+     *
+     * 콜드 스타트 렌더 힌트 용도다: 있으면 즉시 그리고, `unreadSummary()`가
+     * 도착하면 통째로 교체할 것. 캐시가 없거나(`cacheStore` 미주입 포함)
+     * 파싱이 실패하면 `null`을 돌려주고, 깨진 스냅샷은 지운다.
+     */
+    cachedUnreadSummary(): Promise<UnreadSummary | null>;
+    private cacheWriteRooms;
     /**
      * Accept an invite link — call this in flows where you receive a
      * shareable URL (e.g. after parsing a deep link like
@@ -1191,4 +1571,4 @@ declare class NoveraChatError extends Error {
     static fromResponse(status: number, body: unknown): NoveraChatError;
 }
 
-export { type InviteAcceptResponse as AcceptInviteResult, type AnnouncementOut as Announcement, type AppPolicy, type BlockOut as Block, type ClientEvents, type ClientOptions, type DeleteScope, ErrorCode, type ErrorCodeValue, type FileInline, type FileKind, type FileMeta, type FileThumbnailStatus, type InviteTokenOut as InviteToken, type JoinRequestCreateResponse, type JoinRequestListResponse, type JoinRequestOut, type MemberPreview, type MemberRole, type MessageIdStr, type MessageOut, type MessageType, NoveraChat, NoveraChatError, type PushTrigger, type ReactionEntry, Room, type RoomEvents, type RoomMemberOut, type RoomUnread, type SendFileOptions, type SendParams, type SenderMini, type UnreadRoomItem, type UnreadSummary, type WsAnnouncementEvent, type WsChatReceive, type WsInbound, type WsMessageDeleted, type WsMessageUpdated, type WsMessagesCleared, type WsOutbound, type WsPresence, type WsReactionAdded, type WsReactionRemoved, type WsRoomEvent, type WsSyncTick, type WsTypingBroadcast };
+export { type InviteAcceptResponse as AcceptInviteResult, type AnnouncementOut as Announcement, type AppPolicy, type BlockOut as Block, CacheKeys, type CachePolicy, type CacheStore, type ChatMessage, type ChatMessageStatus, type ClientEvents, type ClientOptions, type CollectionChange, type CollectionChangeKind, type DeleteScope, ErrorCode, type ErrorCodeValue, type FileInline, type FileKind, type FileMeta, type FileThumbnailStatus, type InviteTokenOut as InviteToken, type JoinRequestCreateResponse, type JoinRequestListResponse, type JoinRequestOut, type MemberPreview, type MemberRole, MessageCollection, type MessageIdStr, type MessageOut, type MessageType, NoveraChat, NoveraChatError, type PushTrigger, type ReactionEntry, Room, type RoomEvents, type RoomMemberOut, type RoomOut, type RoomUnread, type SendFileOptions, type SendParams, type SenderMini, type UnreadRoomItem, type UnreadSummary, type WsAnnouncementEvent, type WsChatReceive, type WsInbound, type WsMessageDeleted, type WsMessageUpdated, type WsMessagesCleared, type WsOutbound, type WsPresence, type WsReactionAdded, type WsReactionRemoved, type WsRoomEvent, type WsSyncTick, type WsTypingBroadcast, chatMessageFromHistory, chatMessageFromLive, pendingChatMessage, pendingFileChatMessage };