@noverachat/sdk-react 0.3.0 → 0.4.0

package/dist/index.d.cts

@@ -1,65 +1,8 @@
-import { SenderMini, FileInline, ReactionEntry, MessageOut, WsChatReceive, ClientOptions, NoveraChat, RoomMemberOut, FileMeta, MemberPreview, InviteToken, JoinRequestOut, PushTrigger, SendFileOptions, DeleteScope, Room, UnreadSummary } from '@noverachat/sdk-web';
+import { ClientOptions, NoveraChat, RoomMemberOut, FileMeta, MemberPreview, WsChatReceive, InviteToken, JoinRequestOut, PushTrigger, ChatMessage, SendFileOptions, DeleteScope, Room, UnreadSummary } from '@noverachat/sdk-web';
 export * from '@noverachat/sdk-web';
+export { ChatMessage, ChatMessageStatus, chatMessageFromHistory, chatMessageFromLive } from '@noverachat/sdk-web';
 import { ReactNode } from 'react';
 
-/** 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 — `RoomStore` 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 `RoomStore` 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;
-
 interface NoveraChatProviderProps {
     /** Options for the `NoveraChat` this provider creates. Read **once**, when
      *  the provider first mounts — to connect with different options, give the
@@ -380,19 +323,20 @@ interface RoomSnapshot {
     readWatermarks: Readonly<Record<string, string>>;
 }
 /**
- * Turns a `Room`'s events into an externally-subscribable message list and
- * drives optimistic sends. Framework-agnostic on purpose so it can also be
- * used outside hooks (tests, non-React glue).
+ * React-side glue over the core `MessageCollection` — the message state
+ * (event folding, optimistic sends, cache hydrate→replace) is owned by the
+ * core; this store bridges the collection's change events into
+ * `useSyncExternalStore`-shaped immutable snapshots. Framework-agnostic on
+ * purpose so it can also be used outside hooks (tests, non-React glue).
  *
- * Lifecycle: construct → `attach()` (subscribe WS events; idempotent) →
- * `dispose()` (flush read watermark + unsubscribe). `useMessages` does all
- * three for you.
+ * Lifecycle: construct → `attach()` (idempotent) → `dispose()` (flush read
+ * watermark + detach page listeners). `useMessages` does all three for you.
  *
  * Holds `(chat, roomId)` rather than a `Room` instance and re-resolves the
  * live facade on every use — `chat.disconnect()` drops its Room facades, so
  * a remounted provider (React StrictMode simulates this) would otherwise
- * leave the store subscribed to an orphaned Room that no longer receives
- * dispatches.
+ * leave the store bound to an orphaned Room that no longer receives
+ * dispatches. The backing collection is recreated when the facade changes.
  *
  * ```ts
  * const store = new RoomStore(chat, "room_123");
@@ -406,12 +350,8 @@ declare class RoomStore {
     private readonly chat;
     readonly roomId: string;
     private readonly listeners;
-    private readonly unsubs;
-    private messages;
-    private readWatermarks;
-    private hasMore;
-    private oldestCursor;
-    private loadingMore;
+    private col;
+    private colUnsub;
     private historyRequested;
     private snapshot;
     private attached;
@@ -420,26 +360,32 @@ declare class RoomStore {
     /** The live `Room` facade — resolved from the client on every access
      *  (get-or-create in a map, cheap) so we never act on an orphan. */
     private get room();
-    /** Subscribe to WS events + page lifecycle. Safe to call repeatedly
-     *  (no-op while attached) — matches React 18/19 StrictMode's
+    /** The backing collection, bound to the CURRENT facade. Recreated when
+     *  the facade was dropped (post-`chat.disconnect()`) — the old one would
+     *  never receive dispatches again. */
+    private collection;
+    /** Subscribe page lifecycle + ensure the collection is live. Safe to call
+     *  repeatedly (no-op while attached) — matches React 18/19 StrictMode's
      *  mount → cleanup → mount effect cycle. */
     attach(): void;
-    /** Unsubscribe everything and flush the pending read watermark. The store
-     *  keeps its message state, so a later `attach()` resumes cleanly. */
+    /** Detach page listeners and flush the pending read watermark. The
+     *  collection (and its state) survives, so a later `attach()` resumes
+     *  cleanly — StrictMode's mount → cleanup → mount cycle keeps messages. */
     dispose(): void;
     /** `useSyncExternalStore`-compatible subscribe. Returns an unsubscribe fn. */
     readonly subscribe: (fn: () => void) => (() => void);
     readonly getSnapshot: () => RoomSnapshot;
-    private emit;
+    private rebuild;
     /** 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 and prepend it. No-op after the
-     *  first call (StrictMode double-mount safe) — use `loadMore` for
-     *  scrollback. */
+    /** Load the most recent page of history. No-op after the first call
+     *  (StrictMode double-mount safe) — use `loadMore` for scrollback.
+     *  캐시(`ClientOptions.cacheStore`)가 켜져 있으면 스냅샷 즉시 렌더 →
+     *  API 도착 시 통째 교체가 컬렉션 안에서 일어난다. */
     loadHistory(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`
@@ -474,17 +420,7 @@ declare class RoomStore {
     search(q: string, limit?: number): Promise<ChatMessage[]>;
     /** Mark `messageId` read (debounced inside the SDK). */
     markRead(messageId: string): void;
-    private onIncoming;
-    private onUpdated;
-    private onDeleted;
-    private onCleared;
-    private onReactionAdded;
-    private onReactionRemoved;
-    private onSyncTick;
     private onVisibilityChange;
-    private bindAck;
-    private mutateById;
-    private mutateByTempId;
 }
 
 interface UseMessagesOptions {
@@ -672,4 +608,4 @@ interface UseUnreadResult {
  */
 declare function useUnread(opts?: UseUnreadOptions): UseUnreadResult;
 
-export { type ChatMessage, type ChatMessageStatus, type MemberListSnapshot, MemberListStore, NoveraChatProvider, type NoveraChatProviderProps, type RoomFileItem, type RoomFilesSnapshot, RoomFilesStore, type RoomListItem, type RoomListSnapshot, RoomListStore, type RoomListStoreOptions, type RoomSettingsSnapshot, RoomSettingsStore, type RoomSnapshot, RoomStore, type UseMemberListResult, type UseMessagesOptions, type UseMessagesResult, type UseRoomFilesOptions, type UseRoomFilesResult, type UseRoomListResult, type UseRoomSettingsResult, type UseTypingOptions, type UseTypingResult, type UseUnreadOptions, type UseUnreadResult, chatMessageFromHistory, chatMessageFromLive, useMemberList, useMessages, useNoveraChat, useRoom, useRoomFiles, useRoomList, useRoomSettings, useTyping, useUnread };
+export { type MemberListSnapshot, MemberListStore, NoveraChatProvider, type NoveraChatProviderProps, type RoomFileItem, type RoomFilesSnapshot, RoomFilesStore, type RoomListItem, type RoomListSnapshot, RoomListStore, type RoomListStoreOptions, type RoomSettingsSnapshot, RoomSettingsStore, type RoomSnapshot, RoomStore, type UseMemberListResult, type UseMessagesOptions, type UseMessagesResult, type UseRoomFilesOptions, type UseRoomFilesResult, type UseRoomListResult, type UseRoomSettingsResult, type UseTypingOptions, type UseTypingResult, type UseUnreadOptions, type UseUnreadResult, useMemberList, useMessages, useNoveraChat, useRoom, useRoomFiles, useRoomList, useRoomSettings, useTyping, useUnread };

package/dist/index.d.ts

@@ -1,65 +1,8 @@
-import { SenderMini, FileInline, ReactionEntry, MessageOut, WsChatReceive, ClientOptions, NoveraChat, RoomMemberOut, FileMeta, MemberPreview, InviteToken, JoinRequestOut, PushTrigger, SendFileOptions, DeleteScope, Room, UnreadSummary } from '@noverachat/sdk-web';
+import { ClientOptions, NoveraChat, RoomMemberOut, FileMeta, MemberPreview, WsChatReceive, InviteToken, JoinRequestOut, PushTrigger, ChatMessage, SendFileOptions, DeleteScope, Room, UnreadSummary } from '@noverachat/sdk-web';
 export * from '@noverachat/sdk-web';
+export { ChatMessage, ChatMessageStatus, chatMessageFromHistory, chatMessageFromLive } from '@noverachat/sdk-web';
 import { ReactNode } from 'react';
 
-/** 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 — `RoomStore` 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 `RoomStore` 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;
-
 interface NoveraChatProviderProps {
     /** Options for the `NoveraChat` this provider creates. Read **once**, when
      *  the provider first mounts — to connect with different options, give the
@@ -380,19 +323,20 @@ interface RoomSnapshot {
     readWatermarks: Readonly<Record<string, string>>;
 }
 /**
- * Turns a `Room`'s events into an externally-subscribable message list and
- * drives optimistic sends. Framework-agnostic on purpose so it can also be
- * used outside hooks (tests, non-React glue).
+ * React-side glue over the core `MessageCollection` — the message state
+ * (event folding, optimistic sends, cache hydrate→replace) is owned by the
+ * core; this store bridges the collection's change events into
+ * `useSyncExternalStore`-shaped immutable snapshots. Framework-agnostic on
+ * purpose so it can also be used outside hooks (tests, non-React glue).
  *
- * Lifecycle: construct → `attach()` (subscribe WS events; idempotent) →
- * `dispose()` (flush read watermark + unsubscribe). `useMessages` does all
- * three for you.
+ * Lifecycle: construct → `attach()` (idempotent) → `dispose()` (flush read
+ * watermark + detach page listeners). `useMessages` does all three for you.
  *
  * Holds `(chat, roomId)` rather than a `Room` instance and re-resolves the
  * live facade on every use — `chat.disconnect()` drops its Room facades, so
  * a remounted provider (React StrictMode simulates this) would otherwise
- * leave the store subscribed to an orphaned Room that no longer receives
- * dispatches.
+ * leave the store bound to an orphaned Room that no longer receives
+ * dispatches. The backing collection is recreated when the facade changes.
  *
  * ```ts
  * const store = new RoomStore(chat, "room_123");
@@ -406,12 +350,8 @@ declare class RoomStore {
     private readonly chat;
     readonly roomId: string;
     private readonly listeners;
-    private readonly unsubs;
-    private messages;
-    private readWatermarks;
-    private hasMore;
-    private oldestCursor;
-    private loadingMore;
+    private col;
+    private colUnsub;
     private historyRequested;
     private snapshot;
     private attached;
@@ -420,26 +360,32 @@ declare class RoomStore {
     /** The live `Room` facade — resolved from the client on every access
      *  (get-or-create in a map, cheap) so we never act on an orphan. */
     private get room();
-    /** Subscribe to WS events + page lifecycle. Safe to call repeatedly
-     *  (no-op while attached) — matches React 18/19 StrictMode's
+    /** The backing collection, bound to the CURRENT facade. Recreated when
+     *  the facade was dropped (post-`chat.disconnect()`) — the old one would
+     *  never receive dispatches again. */
+    private collection;
+    /** Subscribe page lifecycle + ensure the collection is live. Safe to call
+     *  repeatedly (no-op while attached) — matches React 18/19 StrictMode's
      *  mount → cleanup → mount effect cycle. */
     attach(): void;
-    /** Unsubscribe everything and flush the pending read watermark. The store
-     *  keeps its message state, so a later `attach()` resumes cleanly. */
+    /** Detach page listeners and flush the pending read watermark. The
+     *  collection (and its state) survives, so a later `attach()` resumes
+     *  cleanly — StrictMode's mount → cleanup → mount cycle keeps messages. */
     dispose(): void;
     /** `useSyncExternalStore`-compatible subscribe. Returns an unsubscribe fn. */
     readonly subscribe: (fn: () => void) => (() => void);
     readonly getSnapshot: () => RoomSnapshot;
-    private emit;
+    private rebuild;
     /** 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 and prepend it. No-op after the
-     *  first call (StrictMode double-mount safe) — use `loadMore` for
-     *  scrollback. */
+    /** Load the most recent page of history. No-op after the first call
+     *  (StrictMode double-mount safe) — use `loadMore` for scrollback.
+     *  캐시(`ClientOptions.cacheStore`)가 켜져 있으면 스냅샷 즉시 렌더 →
+     *  API 도착 시 통째 교체가 컬렉션 안에서 일어난다. */
     loadHistory(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`
@@ -474,17 +420,7 @@ declare class RoomStore {
     search(q: string, limit?: number): Promise<ChatMessage[]>;
     /** Mark `messageId` read (debounced inside the SDK). */
     markRead(messageId: string): void;
-    private onIncoming;
-    private onUpdated;
-    private onDeleted;
-    private onCleared;
-    private onReactionAdded;
-    private onReactionRemoved;
-    private onSyncTick;
     private onVisibilityChange;
-    private bindAck;
-    private mutateById;
-    private mutateByTempId;
 }
 
 interface UseMessagesOptions {
@@ -672,4 +608,4 @@ interface UseUnreadResult {
  */
 declare function useUnread(opts?: UseUnreadOptions): UseUnreadResult;
 
-export { type ChatMessage, type ChatMessageStatus, type MemberListSnapshot, MemberListStore, NoveraChatProvider, type NoveraChatProviderProps, type RoomFileItem, type RoomFilesSnapshot, RoomFilesStore, type RoomListItem, type RoomListSnapshot, RoomListStore, type RoomListStoreOptions, type RoomSettingsSnapshot, RoomSettingsStore, type RoomSnapshot, RoomStore, type UseMemberListResult, type UseMessagesOptions, type UseMessagesResult, type UseRoomFilesOptions, type UseRoomFilesResult, type UseRoomListResult, type UseRoomSettingsResult, type UseTypingOptions, type UseTypingResult, type UseUnreadOptions, type UseUnreadResult, chatMessageFromHistory, chatMessageFromLive, useMemberList, useMessages, useNoveraChat, useRoom, useRoomFiles, useRoomList, useRoomSettings, useTyping, useUnread };
+export { type MemberListSnapshot, MemberListStore, NoveraChatProvider, type NoveraChatProviderProps, type RoomFileItem, type RoomFilesSnapshot, RoomFilesStore, type RoomListItem, type RoomListSnapshot, RoomListStore, type RoomListStoreOptions, type RoomSettingsSnapshot, RoomSettingsStore, type RoomSnapshot, RoomStore, type UseMemberListResult, type UseMessagesOptions, type UseMessagesResult, type UseRoomFilesOptions, type UseRoomFilesResult, type UseRoomListResult, type UseRoomSettingsResult, type UseTypingOptions, type UseTypingResult, type UseUnreadOptions, type UseUnreadResult, useMemberList, useMessages, useNoveraChat, useRoom, useRoomFiles, useRoomList, useRoomSettings, useTyping, useUnread };