@ermis-network/ermis-chat-sdk 1.0.9 → 2.0.0

package/dist/index.d.mts

@@ -267,11 +267,13 @@ type FormatMessageResponse<ErmisChatGenerics extends ExtendableGenerics = Defaul
     status: string;
     updated_at: Date;
 };
+type MessageDisplayType = 'normal' | 'deleted';
 type MessageResponse<ErmisChatGenerics extends ExtendableGenerics = DefaultGenerics> = MessageResponseBase<ErmisChatGenerics> & {
     quoted_message?: MessageResponseBase<ErmisChatGenerics>;
 };
 type MessageResponseBase<ErmisChatGenerics extends ExtendableGenerics = DefaultGenerics> = MessageBase<ErmisChatGenerics> & {
     type: MessageLabel;
+    display_type?: MessageDisplayType;
     channel?: ChannelResponse<ErmisChatGenerics>;
     cid?: string;
     created_at?: string;
@@ -351,6 +353,7 @@ type ChannelQueryOptions = {
         id_lt?: string;
         id_gt?: string;
         id_around?: string;
+        include_hidden_messages?: boolean;
     };
 };
 type ChannelStateOptions = {
@@ -383,6 +386,13 @@ type ErmisChatOptions = AxiosRequestConfig & {
     recoverStateOnReconnect?: boolean;
     warmUp?: boolean;
     wsConnection?: StableWSConnection;
+    recoveryConfig?: {
+        filter?: ChannelFilters;
+        sort?: ChannelSort;
+        options?: {
+            message_limit?: number;
+        };
+    };
 };
 /**
  * Event Types
@@ -429,6 +439,8 @@ type ChannelFilters = {
     parent_cid?: string;
     parent_id?: string;
     include_parent?: boolean;
+    include_hidden_messages?: boolean;
+    include_quoted_messages?: boolean;
 };
 type CreateTopicData = {
     name: string;
@@ -596,6 +608,7 @@ declare enum CallAction {
     UPGRADE_CALL = "upgrade-call"
 }
 declare enum CallStatus {
+    PREPARING = "preparing",
     RINGING = "ringing",
     ENDED = "ended",
     CONNECTED = "connected",
@@ -664,7 +677,8 @@ declare enum FRAME_TYPE {
     TRANSCEIVER_STATE = 7,
     REQUEST_CONFIG = 8,
     REQUEST_KEY_FRAME = 9,
-    END_CALL = 10
+    END_CALL = 10,
+    HEALTH_CALL = 11
 }
 
 type ChannelReadStatus<ErmisChatGenerics extends ExtendableGenerics = DefaultGenerics> = Record<string, {
@@ -1321,34 +1335,67 @@ declare class ErmisChat<ErmisChatGenerics extends ExtendableGenerics = DefaultGe
     _buildWSPayload: (client_request_id?: string) => string;
 }
 
-declare class ErmisCall {
-  free(): void;
-  [Symbol.dispose](): void;
-  constructor();
-  spawn(relay_urls: any, secret_key?: Uint8Array | null): Promise<void>;
-  getLocalEndpointAddr(): Promise<string>;
-  connect(addr: string): Promise<void>;
-  closeEndpoint(): Promise<void>;
-  closeConnection(): void;
-  acceptConnection(): Promise<void>;
-  sendControlFrame(data: Uint8Array): void;
-  sendAudioFrame(data: Uint8Array): void;
-  sendFrame(data: Uint8Array): void;
-  notifyNewGop(): void;
-  recv(): Uint8Array;
-  asyncRecv(): Promise<Uint8Array>;
-  beginWithGop(data: Uint8Array): void;
-  connectionType(): string | undefined;
-  roundTripTime(): number | undefined;
-  currentPacketLoss(): number | undefined;
-  networkChange(): void;
-  getStats(): any;
+/**
+ * WasmWorkerProxy — Proxy class chạy trên Main Thread.
+ *
+ * Implement interface INodeCall, nhưng mọi method call đều được forward
+ * tới Web Worker qua postMessage. Main Thread KHÔNG BAO GIỜ gọi WASM trực tiếp.
+ *
+ * Data transfer dùng Transferable buffers (zero-copy).
+ */
+
+declare class WasmWorkerProxy implements INodeCall {
+    private worker;
+    private nextId;
+    private pendingCalls;
+    /** Queue cho asyncRecv — Worker gửi data về, Main Thread consume từng cái */
+    private recvResolveQueue;
+    private recvDataQueue;
+    private recvErrorQueue;
+    /** Static cache — persist across Worker instances */
+    private static cachedBlobUrl;
+    private static cachedWasmBytes;
+    constructor(workerUrl: string | URL);
+    /** Initialize WASM trong Worker — fetch bytes 1 lần, gửi cached bytes cho Worker */
+    init(wasmPath?: string): Promise<void>;
+    /** Spawn WASM node */
+    spawn(relayUrls: string[]): Promise<void>;
+    /** Lấy local endpoint address */
+    getLocalEndpointAddr(): Promise<string>;
+    connect(address: string): Promise<void>;
+    acceptConnection(): Promise<void>;
+    sendFrame(data: Uint8Array): Promise<void>;
+    beginWithGop(data: Uint8Array): Promise<void>;
+    sendAudioFrame(data: Uint8Array): Promise<void>;
+    sendControlFrame(data: Uint8Array): Promise<void>;
+    /**
+     * asyncRecv — nhận data từ Worker recv loop.
+     *
+     * Worker chạy recv loop nội bộ, gửi data về qua postMessage.
+     * Method này trả về Promise resolve khi có data mới.
+     * KHÔNG BAO GIỜ block Main Thread — chỉ chờ postMessage event.
+     */
+    asyncRecv(): Promise<Uint8Array>;
+    /** Bắt đầu recv loop trong Worker */
+    startRecvLoop(): Promise<void>;
+    /** Dừng recv loop trong Worker */
+    stopRecvLoop(): Promise<void>;
+    closeEndpoint(): Promise<void>;
+    closeConnection(): void;
+    networkChange(): void;
+    getStats(): Promise<any>;
+    /** Terminate Worker — gọi khi call kết thúc */
+    terminate(): Promise<void>;
+    private handleMessage;
+    /** Send RPC call to Worker and wait for response */
+    private call;
 }
 
 declare class MediaStreamSender {
     private videoEncoder;
     private audioEncoder;
     private videoReader;
+    private audioReader;
     private localStream;
     private videoConfig;
     private audioConfig;
@@ -1357,7 +1404,10 @@ declare class MediaStreamSender {
     private hasVideo;
     private hasAudio;
     private forceKeyFrame;
+    private isSendingVideo;
+    private isSendingAudio;
     private nodeCall;
+    private healthCallInterval;
     constructor(nodeCall: INodeCall);
     /**
      * Bắt đầu xử lý MediaStream
@@ -1384,6 +1434,8 @@ declare class MediaStreamSender {
     private sendVideoConfig;
     private sendAudioConfig;
     sendConnected: () => Promise<void>;
+    private startHealthCallInterval;
+    private sendHealthCall;
     private sendPacketOrQueue;
 }
 
@@ -1393,9 +1445,12 @@ declare class MediaStreamReceiver {
     private videoWriter;
     private audioContext;
     private mediaDestination;
+    private scheduledAudioNodes;
     private isWaitingForKeyFrame;
     private nextStartTime;
     private lastVideoConfig;
+    private lastVideoConfigStr;
+    private lastAudioConfigStr;
     private nodeCall;
     private events;
     private generatedStream;
@@ -1417,6 +1472,7 @@ declare class MediaStreamReceiver {
 
 declare class ErmisCallNode<ErmisChatGenerics extends ExtendableGenerics = DefaultGenerics> {
     wasmPath: string;
+    workerPath: string;
     relayUrl: string;
     /** Reference to the Ermis Chat client instance */
     _client: ErmisChat<ErmisChatGenerics>;
@@ -1426,12 +1482,12 @@ declare class ErmisCallNode<ErmisChatGenerics extends ExtendableGenerics = Defau
     cid?: string;
     /** Type of call: 'audio' or 'video' */
     callType?: string;
-    /** ID of the current user */
-    userID?: string | undefined;
+    /** ID of the current user — always reads live value from client */
+    get userID(): string | undefined;
     /** Current status of the call */
     callStatus?: string | undefined;
     metadata?: Metadata;
-    callNode: ErmisCall | null;
+    callNode: WasmWorkerProxy | null;
     /** Local media stream from user's camera/microphone */
     localStream?: MediaStream | null;
     /** Remote media stream from the other participant */
@@ -1493,7 +1549,7 @@ declare class ErmisCallNode<ErmisChatGenerics extends ExtendableGenerics = Defau
     private isDestroyed;
     mediaSender: MediaStreamSender | null;
     mediaReceiver: MediaStreamReceiver | null;
-    constructor(client: ErmisChat<ErmisChatGenerics>, sessionID: string, wasmPath: string, relayUrl: string);
+    constructor(client: ErmisChat<ErmisChatGenerics>, sessionID: string, wasmPath: string, relayUrl: string, workerPath?: string);
     private loadWasm;
     private initialize;
     getLocalEndpointAddr(): Promise<string | null>;
@@ -1508,7 +1564,7 @@ declare class ErmisCallNode<ErmisChatGenerics extends ExtendableGenerics = Defau
     private setUserInfo;
     private listenSocketEvents;
     private cleanupCall;
-    private destroy;
+    destroy(): Promise<void>;
     getDevices(): Promise<{
         audioDevices: MediaDeviceInfo[];
         videoDevices: MediaDeviceInfo[];
@@ -1521,6 +1577,7 @@ declare class ErmisCallNode<ErmisChatGenerics extends ExtendableGenerics = Defau
         audioDevice?: MediaDeviceInfo;
         videoDevice?: MediaDeviceInfo;
     };
+    prefillUserInfo(cid: string): void;
     createCall(callType: string, cid: string): Promise<void>;
     acceptCall(): Promise<void>;
     endCall(): Promise<void>;
@@ -1667,15 +1724,70 @@ declare function formatMessage<ErmisChatGenerics extends ExtendableGenerics = De
 declare const createForwardMessagePayload: <ErmisChatGenerics extends ExtendableGenerics = DefaultGenerics>(message: FormatMessageResponse<ErmisChatGenerics>, targetCid: string, activeCid: string) => ForwardMessage<ErmisChatGenerics>;
 
 /**
- * Parse a raw system message string into a human-readable English sentence.
+ * Translation templates for system messages.
+ * Placeholders: {{user}}, {{channel}}, {{type}}, {{duration}}, {{targetUser}}, {{admin}}
+ */
+interface SystemMessageTranslations {
+    '1'?: string;
+    '2'?: string;
+    '3'?: string;
+    '4'?: string;
+    '5'?: string;
+    '6'?: string;
+    '7'?: string;
+    '8'?: string;
+    '9'?: string;
+    '10'?: string;
+    '11'?: string;
+    '12'?: string;
+    '13'?: string;
+    '14'?: string;
+    '15_on'?: string;
+    '15_off'?: string;
+    '16'?: string;
+    '17'?: string;
+    '18'?: string;
+    '19'?: string;
+    '20'?: string;
+    changeName?: string;
+    changeAvatar?: string;
+    changeDescription?: string;
+    removed?: string;
+    banned?: string;
+    unbanned?: string;
+    promoted?: string;
+    demoted?: string;
+    permissionsUpdated?: string;
+    joined?: string;
+    declined?: string;
+    left?: string;
+    clearedHistory?: string;
+    changeType?: string;
+    cooldownOn?: string;
+    cooldownOff?: string;
+    bannedWordsUpdated?: string;
+    added?: string;
+    adminTransfer?: string;
+    pinned?: string;
+    unpinned?: string;
+    public?: string;
+    private?: string;
+    userFallback?: string;
+    adminFallback?: string;
+    durationUnitMin?: string;
+    durationUnitSec?: string;
+}
+/**
+ * Parse a raw system message string into a human-readable sentence.
  *
  * The raw format is: `"<formatId> <userID> [<param1> <param2> ...]"`
  *
- * @param value   - Raw system message string from the server
- * @param userMap - Mapping of user IDs → display names
- * @returns         Parsed English text, or the original string if the format is unknown
+ * @param value        - Raw system message string from the server
+ * @param userMap      - Mapping of user IDs → display names
+ * @param translations - Optional translation templates
+ * @returns              Parsed text, or the original string if the format is unknown
  */
-declare function parseSystemMessage(value: string, userMap: Record<string, string>): string;
+declare function parseSystemMessage(value: string, userMap: Record<string, string>, translations?: SystemMessageTranslations): string;
 
 /**
  * Call type constants for signal messages.
@@ -1695,16 +1807,37 @@ interface SignalMessageResult {
     color: string;
 }
 /**
- * Parse a raw signal message string into a structured object
- * containing text, duration, call type, and color.
+ * Translation templates for signal messages.
+ */
+interface SignalMessageTranslations {
+    calling?: string;
+    incomingAudioCall?: string;
+    incomingVideoCall?: string;
+    outgoingAudioCall?: string;
+    outgoingVideoCall?: string;
+    missedAudioCall?: string;
+    missedVideoCall?: string;
+    cancelAudioCall?: string;
+    cancelVideoCall?: string;
+    rejectedAudioCallRecipient?: string;
+    rejectedAudioCallYou?: string;
+    rejectedVideoCallRecipient?: string;
+    rejectedVideoCallYou?: string;
+    busyRecipient?: string;
+    durationUnitMin?: string;
+    durationUnitSec?: string;
+}
+/**
+ * Parse a raw signal message string into a structured object.
  *
  * Signal messages represent call events. The raw format is:
  * `"<formatId> <callerId> [<enderId> <duration>]"`
  *
- * @param value    - Raw signal message string from the server
- * @param myUserId - The current user's ID (from client.userID)
- * @returns          Parsed signal message object, or null if input is empty
+ * @param value        - Raw signal message string from the server
+ * @param myUserId     - The current user's ID
+ * @param translations - Optional translation templates
+ * @returns              Parsed signal message object, or null if input is empty
  */
-declare function parseSignalMessage(value: string, myUserId: string): SignalMessageResult | null;
+declare function parseSignalMessage(value: string, myUserId: string, translations?: SignalMessageTranslations): SignalMessageResult | null;
 
-export { type APIErrorResponse, type APIResponse, type AscDesc, type Attachment, type AttachmentResponse, type AudioConfig, CallAction, type CallEventData, type CallEventType, CallStatus, CallType, type CallTypeValue, Channel, type ChannelAPIResponse, type ChannelData, type ChannelFilters, type ChannelMemberResponse, type ChannelMembership, type ChannelQueryOptions, type ChannelResponse, type ChannelSort, ChannelState, type ChannelStateOptions, ClientState, type ConnectAPIResponse, type ConnectionOpen, type Contact, type ContactResponse, type ContactResult, type CreateTopicData, type DefaultGenerics, EVENT_MAP, type EditMessage, type EditTopicData, ErmisAuthProvider, ErmisCallNode, ErmisChat, type ErmisChatOptions, ErrorFromResponse, type Event$1 as Event, type EventHandler, type EventTypes, type ExtendableGenerics, FRAME_TYPE, type FormatMessageResponse, type ForwardMessage, type IMediaReceiverEvents, type INodeCall, type LiteralStringForUnion, type LogLevel, type Logger, type Message, type MessageBase, type MessageLabel, type MessageResponse, type MessageResponseBase, type MessageSetType, type Metadata, type PollMessage, type QueryChannelAPIResponse, type QueryChannelsAPIResponse, type Reaction, type ReactionAPIResponse, type ReactionResponse, type ReadResponse, type Role, type SendFileAPIResponse, type SendMessageAPIResponse, type SignalData, type SignalMessageResult, StableWSConnection, TokenManager, type TransceiverState, type UR, type UpdateChannelAPIResponse, type UserCallInfo, type UserResponse, type UsersResponse, type VideoConfig, type VoiceRecordingMeta, buildAttachmentPayload, chatCodes, createForwardMessagePayload, formatMessage, getAttachmentCategory, isHeicFile, isVideoFile, logChatPromiseExecution, normalizeFileName, parseSignalMessage, parseSystemMessage };
+export { type APIErrorResponse, type APIResponse, type AscDesc, type Attachment, type AttachmentResponse, type AudioConfig, CallAction, type CallEventData, type CallEventType, CallStatus, CallType, type CallTypeValue, Channel, type ChannelAPIResponse, type ChannelData, type ChannelFilters, type ChannelMemberResponse, type ChannelMembership, type ChannelQueryOptions, type ChannelResponse, type ChannelSort, ChannelState, type ChannelStateOptions, ClientState, type ConnectAPIResponse, type ConnectionOpen, type Contact, type ContactResponse, type ContactResult, type CreateTopicData, type DefaultGenerics, EVENT_MAP, type EditMessage, type EditTopicData, ErmisAuthProvider, ErmisCallNode, ErmisChat, type ErmisChatOptions, ErrorFromResponse, type Event$1 as Event, type EventHandler, type EventTypes, type ExtendableGenerics, FRAME_TYPE, type FormatMessageResponse, type ForwardMessage, type IMediaReceiverEvents, type INodeCall, type LiteralStringForUnion, type LogLevel, type Logger, type Message, type MessageBase, type MessageDisplayType, type MessageLabel, type MessageResponse, type MessageResponseBase, type MessageSetType, type Metadata, type PollMessage, type QueryChannelAPIResponse, type QueryChannelsAPIResponse, type Reaction, type ReactionAPIResponse, type ReactionResponse, type ReadResponse, type Role, type SendFileAPIResponse, type SendMessageAPIResponse, type SignalData, type SignalMessageResult, type SignalMessageTranslations, StableWSConnection, type SystemMessageTranslations, TokenManager, type TransceiverState, type UR, type UpdateChannelAPIResponse, type UserCallInfo, type UserResponse, type UsersResponse, type VideoConfig, type VoiceRecordingMeta, buildAttachmentPayload, chatCodes, createForwardMessagePayload, formatMessage, getAttachmentCategory, isHeicFile, isVideoFile, logChatPromiseExecution, normalizeFileName, parseSignalMessage, parseSystemMessage };