wowok 2.1.39 → 2.1.41

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

@@ -19,18 +19,10 @@ interface StorageType {
     storeSession(encodedAddress: string, record: string): Promise<void>;
     removeSession(encodedAddress: string): Promise<void>;
 }
-/**
- * 重置数据库连接
- * 用于测试时清理数据后重新创建连接
- */
 export declare function resetDbConnection(): void;
 interface PersistedMeta {
     nextPreKeyId: number;
 }
-/**
- * Signal Protocol SQLite 存储
- * 兼容 libsignal-protocol-typescript 的 StorageType 接口
- */
 export declare class SignalProtocolStorage implements StorageType {
     private storePrefix;
     private userAddress;
@@ -52,20 +44,8 @@ export declare class SignalProtocolStorage implements StorageType {
         signature: ArrayBuffer;
     }) | undefined>;
     storeSignedPreKeyWithSignature(keyId: string | number, keyPair: KeyPairType, signature: ArrayBuffer): Promise<void>;
-    /**
-     * 【核心改进】加载会话，支持发送/接收会话映射
-     * encodedAddress 格式: "peerAddress.deviceId"
-     * 我们会同时检查默认key和带前缀的key
-     */
     loadSession(encodedAddress: string): Promise<string | undefined>;
-    /**
-     * 【关键修复】保存会话时，如果是默认key格式，同时保存到接收会话key
-     * 这样Signal Protocol的SessionCipher保存的会话可以被我们的recv:key找到
-     */
     storeSession(encodedAddress: string, record: string): Promise<void>;
-    /**
-     * 【关键修复】删除会话时，同时删除对应的recv:key
-     */
     removeSession(encodedAddress: string): Promise<void>;
     getMeta(): Promise<PersistedMeta>;
     setMeta(meta: Partial<PersistedMeta>): Promise<void>;
@@ -83,59 +63,12 @@ export declare class MessageStorage {
     getMessagesBySession(myAddress: string, peerAddress: string): Message[];
     getPendingMessages(myAddress: string): Message[];
     updateMessageStatus(messageId: string, status: Message["status"], updates?: Partial<Message>): void;
-    /**
-     * 更新消息查看状态
-     * 将消息标记为已查看，设置 viewed_at 为当前时间戳
-     *
-     * @param messageId 消息 ID
-     * @param viewedAt 查看时间戳（可选，默认当前时间）
-     * @returns 是否更新成功
-     */
     updateMessageViewed(messageId: string, viewedAt?: number): boolean;
-    /**
-     * 批量更新消息查看状态
-     *
-     * @param messageIds 消息 ID 列表
-     * @param viewedAt 查看时间戳（可选，默认当前时间）
-     * @returns 成功更新的消息数量
-     */
     updateMessagesViewed(messageIds: string[], viewedAt?: number): number;
-    /**
-     * 获取用户的所有消息
-     *
-     * @param userAddress 用户地址
-     * @returns 所有相关消息（发送和接收的）
-     */
     getAllMessages(userAddress: string): Message[];
-    /**
-     * 通过消息 ID 获取消息
-     *
-     * @param messageId 消息 ID
-     * @returns 消息对象或 undefined
-     */
     getMessageById(messageId: string): Message | undefined;
-    /**
-     * 更新消息 ID（用于 Guard 消息确认后更新 messageId）
-     *
-     * 由于 message_id 是主键，需要通过删除旧记录并插入新记录来实现
-     *
-     * @param oldMessageId 旧消息 ID（internal_id）
-     * @param newMessageId 新消息 ID（正式的 message_id）
-     * @param updates 可选的更新字段
-     * @returns 是否成功更新
-     */
     updateMessageId(oldMessageId: string, newMessageId: string, updates?: Partial<Message>): boolean;
     private rowToMessage;
-    /**
-     * 获取最后收到的消息序号（用于消息同步确认）
-     *
-     * 查询指定会话中，用户作为接收者时，发送者最后收到的消息序号
-     * 用于在发送新消息时，告诉对方我已经收到了哪些消息
-     *
-     * @param myAddress 当前用户地址
-     * @param peerAddress 对方地址
-     * @returns 最后收到的消息序号（leafIndex），如果没有则返回 -1
-     */
     getLastReceivedLeafIndex(myAddress: string, peerAddress: string): number;
 }
 export declare class SessionStateStorage {
@@ -148,103 +81,27 @@ export declare class SessionStateStorage {
     getCurrentRoot(myAddress: string, peerAddress: string): string;
 }
 export interface PersistedMessengerState {
-    /** 版本 */
     version: string;
-    /** 管理的账号列表（名称或地址） */
     accounts: string[];
-    /** Messenger 配置 */
     config: Partial<MessengerConfig>;
-    /** 最后更新时间 */
     updatedAt: number;
 }
-/**
- * MessengerManager 持久化存储类
- *
- * 使用 SQLite 存储 MessengerManager 的配置和状态
- */
 export declare class MessengerPersistStorage {
     private initialized;
     private get db();
-    /**
-     * 初始化存储表
-     */
     private initTable;
-    /**
-     * 保存 Messenger 配置和账号信息
-     *
-     * @param instanceId 实例标识（用于区分不同的 MessengerManager 实例）
-     * @param state 要保存的状态
-     */
     saveState(instanceId: string, state: PersistedMessengerState): void;
-    /**
-     * 加载 Messenger 配置和账号信息
-     *
-     * @param instanceId 实例标识
-     * @returns 保存的状态，如果不存在返回 null
-     */
     loadState(instanceId: string): PersistedMessengerState | null;
-    /**
-     * 删除保存的状态
-     *
-     * @param instanceId 实例标识
-     */
     deleteState(instanceId: string): void;
-    /**
-     * 获取所有实例ID列表
-     */
     getAllInstanceIds(): string[];
     private get processId();
-    /**
-     * 尝试获取指定账号的 SSE 连接锁
-     * @param accountAddress 账号地址
-     * @param instanceId 当前实例ID
-     * @returns 是否成功获取锁
-     */
     tryAcquireSSELock(accountAddress: string, instanceId: string): boolean;
-    /**
-     * 更新 SSE 连接锁的心跳
-     * @param accountAddress 账号地址
-     * @param instanceId 当前实例ID
-     */
     updateSSELockHeartbeat(accountAddress: string, instanceId: string): void;
-    /**
-     * 释放指定账号的 SSE 连接锁
-     * @param accountAddress 账号地址
-     * @param instanceId 当前实例ID
-     */
     releaseSSELock(accountAddress: string, instanceId: string): void;
-    /**
-     * 检查是否持有指定账号的 SSE 连接锁
-     * @param accountAddress 账号地址
-     * @param instanceId 当前实例ID
-     * @returns 是否持有锁
-     */
     holdsSSELock(accountAddress: string, instanceId: string): boolean;
-    /**
-     * 尝试获取指定账号的 Polling 连接锁
-     * @param accountAddress 账号地址
-     * @param instanceId 当前实例ID
-     * @returns 是否成功获取锁
-     */
     tryAcquirePollingLock(accountAddress: string, instanceId: string): boolean;
-    /**
-     * 更新 Polling 连接锁的心跳
-     * @param accountAddress 账号地址
-     * @param instanceId 当前实例ID
-     */
     updatePollingLockHeartbeat(accountAddress: string, instanceId: string): void;
-    /**
-     * 释放指定账号的 Polling 连接锁
-     * @param accountAddress 账号地址
-     * @param instanceId 当前实例ID
-     */
     releasePollingLock(accountAddress: string, instanceId: string): void;
-    /**
-     * 检查是否持有指定账号的 Polling 连接锁
-     * @param accountAddress 账号地址
-     * @param instanceId 当前实例ID
-     * @returns 是否持有锁
-     */
     holdsPollingLock(accountAddress: string, instanceId: string): boolean;
 }
 export declare const defaultPersistStorage: MessengerPersistStorage;