@noverachat/sdk-web 0.2.0 → 0.4.0

package/src/index.ts

@@ -1,5 +1,23 @@
 export { NoveraChat } from "./client.js";
 export { Room, type RoomEvents } from "./features/room.js";
+
+// 스냅샷 캐시 — 앱 주입 저장소 인터페이스 + 정책 + 키 규칙
+export { CacheKeys, type CachePolicy, type CacheStore } from "./cache.js";
+
+// 코어 소유 메시지 상태 + 뷰모델 (sdk-react에서 이동)
+export {
+  MessageCollection,
+  type CollectionChange,
+  type CollectionChangeKind,
+} from "./features/message-collection.js";
+export {
+  chatMessageFromHistory,
+  chatMessageFromLive,
+  pendingChatMessage,
+  pendingFileChatMessage,
+  type ChatMessage,
+  type ChatMessageStatus,
+} from "./chat-message.js";
 export {
   ErrorCode,
   NoveraChatError,
@@ -20,6 +38,7 @@ export type {
   MessageType,
   ReactionEntry,
   RoomMemberOut,
+  RoomOut,
   RoomUnread,
   SendParams,
   SenderMini,
@@ -29,3 +48,28 @@ export type {
   WsInbound,
   WsOutbound,
 } from "./types.js";
+
+// WS 이벤트 프레임 + 파일 메타 타입 — sdk-react 같은 상위 바인딩이 이벤트
+// 페이로드를 직접 타이핑할 수 있도록 공개 (타입 전용, 런타임 영향 없음).
+export type { ClientEvents } from "./client.js";
+export type {
+  FileInline,
+  FileKind,
+  FileMeta,
+  FileThumbnailStatus,
+  MemberPreview,
+  MemberRole,
+  MessageIdStr,
+  PushTrigger,
+  SendFileOptions,
+  WsChatReceive,
+  WsMessageDeleted,
+  WsMessagesCleared,
+  WsMessageUpdated,
+  WsPresence,
+  WsReactionAdded,
+  WsReactionRemoved,
+  WsRoomEvent,
+  WsSyncTick,
+  WsTypingBroadcast,
+} from "./types.js";

package/src/internal/compare-id.ts

@@ -0,0 +1,17 @@
+/**
+ * Snowflake id 비교 — 63비트 정수가 문자열로 오므로 BigInt로 비교한다
+ * (길이가 다르면 사전순 `>`는 틀린다: "9" > "10"). null/빈 문자열/"0"은
+ * "id 없음 = -∞"로 취급.
+ */
+export function idGreater(
+  a: string | null | undefined,
+  b: string | null | undefined,
+): boolean {
+  if (!a || a === "0") return false;
+  if (!b || b === "0") return true;
+  try {
+    return BigInt(a) > BigInt(b);
+  } catch {
+    return a > b;
+  }
+}

package/src/types.ts

@@ -48,6 +48,8 @@ export type {
   SenderMini,
   ReactionEntry,
   MemberPreview,
+  MemberRole,
+  PushTrigger,
   RoomUnread,
   UnreadRoomItem,
   UnreadSummary,
@@ -150,8 +152,7 @@ export 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;
@@ -236,11 +237,22 @@ export interface FilePresignResponse {
 
 // (wire frame types are generated — see re-export block near the top)
 
+import type { CachePolicy, CacheStore } from "./cache.js";
+
 export interface ClientOptions {
   appId: string;
   endpoint: string;                // e.g. "https://chat.example.com"
   wsEndpoint?: string;             // defaults to endpoint with ws(s)://
   tokenProvider: () => Promise<string>;
+  /**
+   * 스냅샷 캐시 저장소 — 생략(기본)하면 캐시 기능이 전부 꺼진다.
+   * 주입하면 방 목록·방 히스토리 최신 페이지가 REST 원문 그대로 저장되고,
+   * `cachedUnreadSummary()` / `room.cachedRecent()` 로 콜드 스타트 즉시
+   * 렌더에 쓸 수 있다. 자세한 건 `CacheStore` 문서 참조.
+   */
+  cacheStore?: CacheStore;
+  /** 캐시 스냅샷과 API 응답의 합성 방식. 현재 `"replaceByApi"`만 지원. */
+  cachePolicy?: CachePolicy;
   autoReconnect?: boolean;         // default true
   pingIntervalMs?: number;         // default 20_000
   readWatermarkDebounceMs?: number;// default 1500