wowok 2.1.39 → 2.1.41

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

@@ -18,152 +18,38 @@ export declare class Messenger {
     private failedMessages;
     private waitingMessageRetries;
     constructor(userAddress: string, config?: Partial<MessengerConfig>);
-    /**
-     * 获取用户地址
-     * @returns 用户地址
-     */
     getUserAddress(): string;
-    /**
-     * 获取用户公钥
-     * @returns 公钥（带标志位）
-     */
     getPublicKey(): Promise<string>;
-    /**
-     * 验证Guard消息格式
-     * @param guardAddress Guard地址
-     * @param passportAddress Passport地址
-     * @returns 是否为有效的Guard消息
-     */
     isValidGuardMessage(guardAddress: string | null | undefined, passportAddress: string | null | undefined): boolean;
-    /**
-     * 生成签名参数
-     * 用于需要签名验证的 API 调用
-     */
     private generateSignatureParams;
-    /**
-     * 生成随机 nonce
-     */
     private generateNonce;
-    /**
-     * 初始化 Messenger
-     * 1. 确保本地身份
-     * 2. 注册设备到服务器
-     * 3. 上传预密钥
-     * 4. 检查预密钥状态（如低于阈值则补充）
-     * 5. 启动合并的polling timer
-     */
     initialize(): Promise<void>;
-    /**
-     * 检查并补充预密钥
-     *
-     * 逻辑：如果服务器预密钥未满，自动补充到最大容量
-     */
     private checkAndRefillPrekeys;
-    /**
-     * 启动合并的polling timer
-     */
     private startPollingTimer;
-    /**
-     * 停止polling timer
-     */
     private stopPollingTimer;
-    /**
-     * 安排下一次poll
-     */
     private scheduleNextPoll;
-    /**
-     * 获取下次poll的间隔时间
-     * 【优化】增加3秒快速模式（有待解密消息时）
-     */
     private getNextPollInterval;
-    /**
-     * 执行一次poll（拉取消息和检查prekey状态）
-     */
     private poll;
-    /**
-     * 触发快速poll（发送消息后调用）
-     */
     private triggerFastPoll;
-    /**
-     * 发送加密消息
-     *
-     * 流程：
-     * 1. 使用 Signal Protocol 加密消息
-     * 2. 发送到服务器
-     * 3. 接收服务器返回的 Merkle 证明数据
-     * 4. 本地存储消息
-     */
     sendMessage(recipientAddress: string, plaintext: string, options?: {
         guardAddress?: string;
         passportAddress?: string;
         force?: boolean;
     }): Promise<SendMessageResult>;
-    /**
-     * 拉取消息
-     *
-     * 流程：
-     * 1. 从服务器拉取消息
-     * 2. 解密消息（Signal Protocol）
-     * 3. 验证 Merkle 证明
-     * 4. 本地存储并确认消息
-     */
     pullMessages(limit?: number): Promise<{
         messages: DecryptedMessage[];
         prekey_status?: PreKeyStatus;
     }>;
-    /**
-     * 获取最后发送的消息序号
-     * @param peerAddress 对方地址
-     * @returns 最后发送的消息 leafIndex，如果没有发送过返回 -1
-     */
     private getLastSentLeafIndex;
-    /**
-     * 获取会话历史消息
-     */
     getSessionMessages(peerAddress: string): Message[];
-    /**
-     * 获取会话当前状态
-     */
     getSessionState(peerAddress: string): import("./types.js").SessionState;
-    /**
-     * 提交链上证明
-     *
-     * 使用 proof.ts 将 Merkle Root 提交到链上，获得时间证明
-     *
-     * @param env CallEnv 环境
-     * @param peerAddress 对方地址
-     * @param description 证明描述
-     */
     submitChainProof(env: CallEnv, peerAddress: string, description?: string): Promise<{
         proofAddress: string;
         txHash: string;
     }>;
-    /**
-     * 销毁 Messenger 实例
-     * 清理所有资源（定时器等）
-     */
     destroy(): void;
-    /**
-     * 断开连接（destroy 的别名）
-     * 用于清理资源
-     */
     disconnect(): void;
-    /**
-     * 设置新消息回调
-     * @param onMessage 新消息回调函数
-     */
     setOnMessageCallback(onMessage: (messages: DecryptedMessage[]) => void): void;
-    /**
-     * 发送 ZIP 压缩文件
-     *
-     * 支持发送本地或网络 WTS/WIP 文件，经过 ZIP 压缩后发送给对方
-     * 支持 Guard 验证，如果提供 guardAddress 和 passportAddress，消息将进入 Guard 验证流程
-     *
-     * @param recipientAddress 接收方地址
-     * @param source 文件源（本地路径或网络 URL）
-     * @param options 可选参数
-     * @returns 发送结果
-     */
     sendZipFile(recipientAddress: string, source: string, options?: {
         fileName?: string;
         contentType?: ZipContentType;
@@ -171,128 +57,36 @@ export declare class Messenger {
         passportAddress?: string;
         force?: boolean;
     }): Promise<SendMessageResult>;
-    /**
-     * 加载文件数据（支持本地路径和网络 URL）
-     */
     private loadFileData;
-    /**
-     * 检测内容类型
-     */
     private detectContentType;
-    /**
-     * 生成签名的请求
-     */
     private _createSignedRequest;
-    /**
-     * 验证地址列表
-     */
     private _validateAddresses;
-    /**
-     * 黑名单 - 添加地址
-     */
     addToBlacklist(addresses: string[]): Promise<ListOperationResponse>;
-    /**
-     * 黑名单 - 移除地址
-     */
     removeFromBlacklist(addresses: string[]): Promise<ListOperationResponse>;
-    /**
-     * 黑名单 - 清空
-     */
     clearBlacklist(): Promise<ListOperationResponse>;
-    /**
-     * 黑名单 - 获取列表
-     */
     getBlacklist(): Promise<string[]>;
-    /**
-     * 黑名单 - 检查存在
-     */
     existInBlacklist(addresses: string[]): Promise<ListOperationResponse>;
-    /**
-     * 好友列表 - 添加地址
-     */
     addToFriendsList(addresses: string[]): Promise<ListOperationResponse>;
-    /**
-     * 好友列表 - 移除地址
-     */
     removeFromFriendsList(addresses: string[]): Promise<ListOperationResponse>;
-    /**
-     * 好友列表 - 清空
-     */
     clearFriendsList(): Promise<ListOperationResponse>;
-    /**
-     * 好友列表 - 获取列表
-     */
     getFriendsList(): Promise<string[]>;
-    /**
-     * 好友列表 - 检查存在
-     */
     existInFriendsList(addresses: string[]): Promise<ListOperationResponse>;
-    /**
-     * Guard 列表 - 添加
-     */
     addToGuardList(guards: GuardListItem[]): Promise<ListOperationResponse>;
-    /**
-     * Guard 列表 - 移除
-     */
     removeFromGuardList(addresses: string[]): Promise<ListOperationResponse>;
-    /**
-     * Guard 列表 - 获取列表
-     */
     getGuardList(): Promise<ListOperationResponse>;
-    /**
-     * 获取用户设置
-     */
     getSettings(): Promise<GetSettingsResponse>;
-    /**
-     * 设置用户设置
-     */
     setSettings(settings: Partial<UpdateSettingsRequest>): Promise<boolean>;
-    /**
-     * 尝试解密单条消息
-     * @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;
 }