wowok 2.1.38 → 2.1.40

package/dist/cjs/w/messenger/index.d.ts

@@ -1,21 +1,3 @@
-/**
- * Wowok Messenger SDK
- *
- * 基于三重信任模型的端到端加密消息系统：
- *
- * 1. 身份信任（Identity Trust）
- *    - 基于 wowok 账户体系的 Ed25519 签名
- *    - 每个用户的钱包地址即身份标识
- *
- * 2. 加密信任（Encryption Trust）
- *    - 基于 Signal Protocol 的双棘轮算法
- *    - 端到端加密，服务器无法解密
- *
- * 3. 时序信任（Temporal Trust）
- *    - 基于 Merkle Tree 的消息时序完整性
- *    - 服务器签名确保消息顺序
- *    - 链上证明提供不可篡改的时间戳
- */
 export { MessengerManager } from "./messenger-manager.js";
 export { Messenger } from "./messenger.js";
 export * from "./messenger-api.js";

package/dist/cjs/w/messenger/index.js

@@ -1,28 +1,4 @@
-// Copyright (c) Wowok.
-// SPDX-License-Identifier: Apache-2.0
-/**
- * Wowok Messenger SDK
- *
- * 基于三重信任模型的端到端加密消息系统：
- *
- * 1. 身份信任（Identity Trust）
- *    - 基于 wowok 账户体系的 Ed25519 签名
- *    - 每个用户的钱包地址即身份标识
- *
- * 2. 加密信任（Encryption Trust）
- *    - 基于 Signal Protocol 的双棘轮算法
- *    - 端到端加密，服务器无法解密
- *
- * 3. 时序信任（Temporal Trust）
- *    - 基于 Merkle Tree 的消息时序完整性
- *    - 服务器签名确保消息顺序
- *    - 链上证明提供不可篡改的时间戳
- */
-// ========== 主类 ==========
 export { MessengerManager } from "./messenger-manager.js";
 export { Messenger } from "./messenger.js";
-// ========== Messenger API ==========
 export * from "./messenger-api.js";
-// ========== 枚举和常量 ==========
 export { MessageType, MessageDirection, MessageStatus, MessengerErrorCode, DEFAULT_MESSENGER_CONFIG, MessengerError, DEFAULT_QUERY_LIMIT, MAX_QUERY_LIMIT, } from "./types.js";
-//# sourceMappingURL=index.js.map

package/dist/cjs/w/messenger/messenger-api.d.ts

@@ -1,105 +1,17 @@
-/**
-明确核心目标：解密成功率100%。原则：
-1）小地址prekey作为会话的密钥起点；大地址如果回复则双方建立会话，如果大地址不回复，小地址的消息总是取最新的bundle（含one-time key)发送消息，大地址收到后总是按最新的密钥建立会话，只要回复，双方握手成功。
-2）回滚机制。因为要保证机密的环境，所以要有回滚机制（能否一直解密PREKEY_MESSAGE同时更新本地会话？），PREKEY_MESSAGE的优先级大于wisper message，只要解密成功，即刻更新最新的会话密钥（能否实现？）。
-3）对此重试和解密失败池子，现有的3秒*3次（只要有会话消息）就很好。请围绕核心目标和原则；遍历所有可能的情形，设计新的握手和解密方案。
- */
 import type { ConversationInfo, ConversationsFilter, Message, MessageFilter, SendMessageResult, WtsFileResult, WtsGenerationParams, WtsToHtmlOptions, WtsVerificationResult, ListOperationResponse, GetSettingsResponse } from "./types.js";
 import { MessengerManager } from "./messenger-manager.js";
 import type { ENTRYPOINT } from "../../client/network.js";
 import type { AccountOrMark_Address, ManyAccountOrMark_Address } from "../local/index.js";
-/**
- * 获取 MessengerManager 实例（单例）
- * 首次调用时会自动启动后台服务
- */
 export declare function getMessengerManager(): MessengerManager;
-/**
- * 获取会话列表
- *
- * 查询当前账号的所有会话，支持多种过滤和排序选项。
- * 返回的 unreadCount 基于 viewedAt 字段计算。
- *
- * @param filter 过滤条件（可选）
- * @returns 会话信息列表，按指定方式排序
- *
- * @example
- * // 获取所有会话（默认按最后消息时间排序，每个会话2条预览，自动标记为已查看）
- * const conversations = await watch_conversations();
- *
- * // 只获取有未读消息的会话
- * const unreadConversations = await watch_conversations({ unreadOnly: true });
- *
- * // 获取最近7天的会话，包含5条预览消息，跳过自动标记
- * const recent = await watch_conversations({
- * 	startTime: Date.now() - 7 * 24 * 60 * 60 * 1000,
- * 	previewMessageCount: 5,
- * 	skipAutoMarkViewed: true
- * });
- */
 export declare function watch_conversations(filter?: ConversationsFilter): Promise<ConversationInfo[]>;
-/**
- * 标记消息为已查看
- *
- * 将指定消息标记为当前用户已查看，设置 viewedAt 为当前时间戳。
- * 通常用于用户主动查看消息后调用。
- *
- * @param messageIds 消息ID列表（至少1条）
- * @param account 账号地址或名称（可选，默认当前账号）
- * @returns 成功标记的消息数量
- *
- * @example
- * // 标记单条消息
- * await mark_messages_as_viewed(["msg-123"]);
- *
- * // 标记多条消息
- * await mark_messages_as_viewed(["msg-1", "msg-2", "msg-3"]);
- */
 export declare function mark_messages_as_viewed(messageIds: string[], account?: string): Promise<number>;
-/**
- * 标记整个会话为已查看
- *
- * 将指定会话中的所有未查看消息标记为已查看。
- * 通常用于用户点击进入聊天界面时调用。
- *
- * @param peerAddress 对方地址或名称标记
- * @param account 账号地址或名称（可选，默认当前账号）
- * @returns 成功标记的消息数量
- *
- * @example
- * // 标记与某人的所有消息为已查看
- * await mark_conversation_as_viewed("0x123...");
- *
- * // 使用名称标记
- * await mark_conversation_as_viewed("alice");
- */
 export declare function mark_conversation_as_viewed(peerAddress: string | AccountOrMark_Address, account?: string): Promise<number>;
-/**
- * 发送消息
- *
- * @param from 发送者地址
- * @param to 接收者地址
- * @param content 消息内容
- * @param options 可选配置
- * @returns SendMessageResult
- */
 export declare function send_message(from: string | undefined | null, to: AccountOrMark_Address, content: string, options?: {
     guardAddress?: string;
     passportAddress?: string;
     force?: boolean;
     new_messenger_name?: string;
 }): Promise<SendMessageResult>;
-/**
- * 发送文件（ZIP 格式）
- *
- * 支持发送本地文件，经过 ZIP 压缩后发送给对方
- * 支持 Guard 验证，如果提供 guardAddress 和 passportAddress，消息将进入 Guard 验证流程
- *
- * @param from 发送者账号或地址
- * @param to 接收者地址
- * @param filePath 本地文件路径
- * @param options 可选配置
- * @returns SendMessageResult
- */
 export declare function send_file(from: string | undefined | null, to: AccountOrMark_Address, filePath: string, options?: {
     fileName?: string;
     contentType?: "wts" | "wip" | "zip";
@@ -108,82 +20,13 @@ export declare function send_file(from: string | undefined | null, to: AccountOr
     force?: boolean;
     new_messenger_name?: string;
 }): Promise<SendMessageResult>;
-/**
- * 查询消息
- *
- * 支持按已读状态过滤，可自动标记为已查看。
- *
- * @param filter 过滤条件（可选）
- * @returns Message 数组
- *
- * @example
- * // 获取所有未读消息（不自动标记）
- * const unread = await watch_messages({ viewed: false, skipAutoMarkViewed: true });
- *
- * // 获取并自动标记为已查看（用户进入聊天界面）
- * const messages = await watch_messages({
- * 	peerAddress: "0x123...",
- * });
- *
- * // 获取已查看的消息
- * const viewed = await watch_messages({ viewed: true });
- */
 export declare function watch_messages(filter?: MessageFilter): Promise<Message[]>;
 export declare function pull_messages(account?: string | undefined | null, limit?: number): Promise<Message[]>;
-/**
- * 批量解压多个 ZIP 消息到指定目录
- *
- * @param messages 包含 ZIP 数据的消息数组，或消息 ID 数组
- * @param outputDir 输出目录路径
- * @param userAddress 用户地址（当传入消息ID数组时需要）
- * @returns 解压后的文件路径数组
- */
 export declare function extract_zip_messages(account: string | undefined | null, messages: (Message | string)[], outputDir: string): Promise<string[]>;
 export declare function generate_wts(params: WtsGenerationParams): Promise<WtsFileResult>;
-/**
- * 验证 WTS 文件
- *
- * 验证内容包括：
- * 1. 文件结构完整性
- * 2. Merkle 链连续性
- * 3. 消息哈希格式
- * 4. Payload 哈希匹配
- * 5. 数字签名（如果存在）
- *
- * @param wtsFilePath WTS 文件路径（本地或网络文件）
- * @returns 验证结果
- */
 export declare function verify_wts(wtsFilePath: string): Promise<WtsVerificationResult>;
-/**
- * 使用账号签名 WTS 文件
- *
- * 此函数会自动加载 WTS 文件、验证格式、签名并保存。
- *
- * @param wtsFilePath WTS 文件路径（本地或网络文件）
- * @param account 签名账号
- * @param outputPath 输出文件路径（可选，默认覆盖原文件）
- * @returns 签名后的 WTS 文件路径
- */
 export declare function sign_wts(wtsFilePath: string, account: string | undefined | null, outputPath?: string): Promise<string>;
-/**
- * 将 WTS 文件或文件夹转换为 HTML
- *
- * @param wtsPath WTS 文件路径或文件夹路径（本地或网络文件）
- * @param options 转换选项
- * @returns HTML 字符串、保存的文件路径，或转换的文件路径数组
- */
 export declare function wts2html(wtsPath: string, options?: WtsToHtmlOptions): Promise<string | string[]>;
-/**
- * 提交消息链上证明
- *
- * 将消息的 Merkle 证明提交到链上，创建不可篡改的证明记录。
- * 此函数会先验证消息的完整性和合法性。
- *
- * @param account 账号名称或地址
- * @param messageId 消息ID
- * @param env 调用环境（包含网络、签名账号等）
- * @returns 证明对象地址
- */
 export declare function proof_message(account: string | undefined | null, messageId: string, network: ENTRYPOINT): Promise<{
     proofAddress: string;
 }>;
@@ -218,11 +61,6 @@ export type BlacklistResponse = {
     op: "exist";
     result: ListOperationResponse;
 };
-/**
- * 黑名单管理 - 统一入口
- * @param request 操作请求
- * @returns 操作结果
- */
 export declare function blacklist(request: BlacklistRequest): Promise<BlacklistResponse>;
 export type FriendslistRequest = {
     op: "add" | "remove";
@@ -255,11 +93,6 @@ export type FriendslistResponse = {
     op: "exist";
     result: ListOperationResponse;
 };
-/**
- * 好友列表管理 - 统一入口
- * @param request 操作请求
- * @returns 操作结果
- */
 export declare function friendslist(request: FriendslistRequest): Promise<FriendslistResponse>;
 export interface GuardParam {
     guard: string;
@@ -287,11 +120,6 @@ export type GuardlistResponse = {
     op: "get";
     result: ListOperationResponse;
 };
-/**
- * Guard 列表管理 - 统一入口
- * @param request 操作请求
- * @returns 操作结果
- */
 export declare function guardlist(request: GuardlistRequest): Promise<GuardlistResponse>;
 export type SettingsRequest = {
     op: "get";
@@ -309,9 +137,4 @@ export type SettingsResponse = {
     op: "set";
     result: boolean;
 };
-/**
- * 用户设置管理 - 统一入口
- * @param request 操作请求
- * @returns 操作结果
- */
 export declare function settings(request: SettingsRequest): Promise<SettingsResponse>;