wowok 2.1.16 → 2.1.18

package/dist/esm/w/messenger/messenger.d.ts

@@ -1,15 +1,20 @@
 import type { CallEnv } from "../common.js";
-import type { MessengerConfig, Message, SendMessageResult, DecryptedMessage, ZipContentType, ListOperationResponse, GuardListItem } from "./types.js";
+import type { MessengerConfig, Message, SendMessageResult, DecryptedMessage, ZipContentType, ListOperationResponse, GuardListItem, PreKeyStatus } from "./types.js";
 export declare class Messenger {
     private session;
     private serverClient;
     private config;
     private userAddress;
-    private eventSource;
     private onMessageCallback;
-    private prekeyCheckTimer;
+    private pollingTimer;
+    private messageConsecutiveEmptyPulls;
+    private prekeyConsecutiveOkCount;
+    private currentMessageInterval;
+    private isPollingRunning;
     private messageStorage;
     private sessionStateStorage;
+    private waitingMessages;
+    private failedMessages;
     constructor(userAddress: string, config?: Partial<MessengerConfig>);
     /**
      * 获取用户地址
@@ -43,7 +48,7 @@ export declare class Messenger {
      * 2. 注册设备到服务器
      * 3. 上传预密钥
      * 4. 检查预密钥状态（如低于阈值则补充）
-     * 5. 启动定期预密钥检查
+     * 5. 启动合并的polling timer
      */
     initialize(): Promise<void>;
     /**
@@ -53,13 +58,30 @@ export declare class Messenger {
      */
     private checkAndRefillPrekeys;
     /**
-     * 启动预密钥定期检查定时器
+     * 启动合并的polling timer
      */
-    private startPrekeyCheckTimer;
+    private startPollingTimer;
     /**
-     * 停止预密钥定期检查定时器
+     * 停止polling timer
      */
-    stopPrekeyCheckTimer(): void;
+    private stopPollingTimer;
+    /**
+     * 安排下一次poll
+     */
+    private scheduleNextPoll;
+    /**
+     * 获取下次poll的间隔时间
+     * 【优化】增加3秒快速模式（有待解密消息时）
+     */
+    private getNextPollInterval;
+    /**
+     * 执行一次poll（拉取消息和检查prekey状态）
+     */
+    private poll;
+    /**
+     * 触发快速poll（发送消息后调用）
+     */
+    private triggerFastPoll;
     /**
      * 发送加密消息
      *
@@ -83,7 +105,10 @@ export declare class Messenger {
      * 3. 验证 Merkle 证明
      * 4. 本地存储并确认消息
      */
-    pullMessages(limit?: number): Promise<DecryptedMessage[]>;
+    pullMessages(limit?: number): Promise<{
+        messages: DecryptedMessage[];
+        prekey_status?: PreKeyStatus;
+    }>;
     /**
      * 获取最后发送的消息序号
      * @param peerAddress 对方地址
@@ -111,30 +136,9 @@ export declare class Messenger {
         proofAddress: string;
         txHash: string;
     }>;
-    /**
-     * 建立 SSE 连接并监听服务器事件
-     *
-     * 安全要求：必须提供签名验证，防止未授权监听他人事件
-     * @param onMessage 新消息回调
-     * @param signatureParams 签名参数（可选，不提供时自动生成）
-     */
-    connectEventSource(onMessage?: (messages: DecryptedMessage[]) => void, signatureParams?: {
-        signatureScheme: string;
-        signature: string;
-        timestamp: number;
-        nonce: string;
-    }): Promise<void>;
-    /**
-     * 检查 SSE 是否已连接
-     */
-    isEventSourceConnected(): boolean;
-    /**
-     * 断开 SSE 连接
-     */
-    disconnectEventSource(): void;
     /**
      * 销毁 Messenger 实例
-     * 清理所有资源（定时器、SSE 连接等）
+     * 清理所有资源（定时器等）
      */
     destroy(): void;
     /**
@@ -142,6 +146,11 @@ export declare class Messenger {
      * 用于清理资源
      */
     disconnect(): void;
+    /**
+     * 设置新消息回调
+     * @param onMessage 新消息回调函数
+     */
+    setOnMessageCallback(onMessage: (messages: DecryptedMessage[]) => void): void;
     /**
      * 发送 ZIP 压缩文件
      *
@@ -228,4 +237,52 @@ export declare class Messenger {
      * Guard 列表 - 获取列表
      */
     getGuardList(): Promise<ListOperationResponse>;
+    /**
+     * 尝试解密单条消息
+     * @param serverMsg 服务器消息
+     * @returns 解密结果
+     */
+    private tryDecryptMessage;
+    /**
+     * 判断错误是否可重试（Skip Keys 机制）
+     * @param errorMessage 错误信息
+     * @returns 是否可重试
+     */
+    private isRetryableError;
+    /**
+     * 处理 waitingMessages 池中的消息
+     * @param decryptedMessages 解密成功的消息列表
+     * @param acknowledgedIds 已确认的消息ID列表
+     */
+    private processWaitingMessages;
+    /**
+     * 保存解密失败的消息
+     * @param serverMsg 服务器消息
+     * @param error 错误信息
+     */
+    private saveFailedMessage;
+    /**
+     * 重新调度轮询（用于切换到快速模式）
+     */
+    private reschedulePolling;
+    /**
+     * 获取解密失败的消息（供用户决策重发）
+     * @returns 失败消息列表
+     */
+    getFailedMessages(): Array<{
+        messageId: string;
+        from: string;
+        error: string;
+        leafIndex?: number;
+    }>;
+    /**
+     * 清除解密失败的消息记录
+     * @param messageId 消息ID（可选，不提供则清除所有）
+     */
+    clearFailedMessages(messageId?: string): void;
+    /**
+     * 获取等待解密的消息数量
+     * @returns 等待消息数量
+     */
+    getWaitingMessageCount(): number;
 }