wowok 2.1.39 → 2.1.40

package/dist/esm/w/messenger/templates/wts-html-template.d.ts

@@ -1,7 +1,3 @@
-/**
- * WTS to HTML 模板
- * 将 HTML 模板独立出来，便于维护和定制
- */
 import type { WtsPayload, WtsMessage, WtsMeta, WtsVerificationResult } from "../types.js";
 export interface TemplateData {
     title: string;
@@ -15,47 +11,20 @@ export interface TemplateData {
     maxLastReceivedLeafIndex: number;
     myAddress: string;
 }
-/**
- * HTML 转义函数
- */
 export declare function escapeHtml(text: string): string;
-/**
- * 格式化文件大小
- */
 export declare function formatFileSize(bytes: number): string;
-/**
- * 判断是否为非文本消息
- */
 export declare function isNonTextMessage(msg: WtsMessage): boolean;
-/**
- * 获取文件类型标签
- */
 export declare function getFileTypeLabel(msg: WtsMessage): string;
-/**
- * 获取主题颜色配置
- */
 export declare function getThemeColors(theme: "light" | "dark"): {
     bgColor: string;
     textColor: string;
     borderColor: string;
 };
-/**
- * 获取消息颜色配置
- */
 export declare function getMessageColors(theme: "light" | "dark", isMyMessage: boolean): {
     bgColor: string;
     borderColor: string;
 };
-/**
- * 生成文件保存按钮 HTML
- */
 export declare function generateFileButton(msg: WtsMessage, index: number, theme: "light" | "dark"): string;
-/**
- * 生成单条消息 HTML
- */
 export declare function generateMessageHtml(msg: WtsMessage, index: number, data: TemplateData): string;
-/**
- * 生成签名验证信息 HTML
- */
 export declare function generateSignatureHtml(verifyResult: WtsVerificationResult, theme: "light" | "dark", textColor: string): string;
 export declare function generateHtmlPage(data: TemplateData): string;

package/dist/esm/w/messenger/templates/wts-html-template.js

@@ -1,10 +1,3 @@
-/**
- * WTS to HTML 模板
- * 将 HTML 模板独立出来，便于维护和定制
- */
-/**
- * HTML 转义函数
- */
 export function escapeHtml(text) {
     if (!text)
         return "";
@@ -15,9 +8,6 @@ export function escapeHtml(text) {
         .replace(/"/g, """)
         .replace(/'/g, "'");
 }
-/**
- * 格式化文件大小
- */
 export function formatFileSize(bytes) {
     if (bytes < 1024)
         return bytes + " B";
@@ -25,22 +15,13 @@ export function formatFileSize(bytes) {
         return (bytes / 1024).toFixed(1) + " KB";
     return (bytes / (1024 * 1024)).toFixed(1) + " MB";
 }
-/**
- * 判断是否为非文本消息
- */
 export function isNonTextMessage(msg) {
-    // 如果有 zipMetadata，说明是非文本消息（ZIP文件）
     return !!msg.zipMetadata;
 }
-/**
- * 获取文件类型标签
- */
 export function getFileTypeLabel(msg) {
-    // 首先检查 zipMetadata 中的 contentType
     if (msg.zipMetadata?.contentType) {
         return msg.zipMetadata.contentType.toUpperCase();
     }
-    // 根据文件名推断类型
     const fileName = msg.zipMetadata?.fileName || "";
     if (fileName.endsWith(".wts"))
         return "WTS";
@@ -52,14 +33,10 @@ export function getFileTypeLabel(msg) {
         return "JSON";
     if (fileName.endsWith(".txt"))
         return "TXT";
-    // 根据 zipMetadata 推断
     if (msg.zipMetadata)
         return "ZIP";
     return "FILE";
 }
-/**
- * 获取主题颜色配置
- */
 export function getThemeColors(theme) {
     return {
         bgColor: theme === "dark" ? "#1a1a1a" : "#ffffff",
@@ -67,28 +44,20 @@ export function getThemeColors(theme) {
         borderColor: theme === "dark" ? "#444444" : "#e0e0e0",
     };
 }
-/**
- * 获取消息颜色配置
- */
 export function getMessageColors(theme, isMyMessage) {
     if (isMyMessage) {
-        // 发送的消息 - 蓝色系
         return {
             bgColor: theme === "dark" ? "#1a365d" : "#e3f2fd",
             borderColor: theme === "dark" ? "#3b82f6" : "#90caf9",
         };
     }
     else {
-        // 接收的消息 - 绿色系
         return {
             bgColor: theme === "dark" ? "#1e3a2f" : "#e8f5e9",
             borderColor: theme === "dark" ? "#10b981" : "#a5d6a7",
         };
     }
 }
-/**
- * 生成文件保存按钮 HTML
- */
 export function generateFileButton(msg, index, theme) {
     if (!msg.plaintext || !msg.zipMetadata?.fileName)
         return "";
@@ -96,7 +65,6 @@ export function generateFileButton(msg, index, theme) {
     const fileData = msg.plaintext;
     const fileSize = msg.zipMetadata.fileSize || 0;
     const fileType = getFileTypeLabel(msg);
-    // 根据主题调整颜色
     const bgColor = theme === "dark" ? "#2a3f2a" : "#e8f5e9";
     const borderColor = theme === "dark" ? "#4caf50" : "#4caf50";
     const textColor = theme === "dark" ? "#81c784" : "#2e7d32";
@@ -150,9 +118,6 @@ export function generateFileButton(msg, index, theme) {
 		<\/script>
 	`;
 }
-/**
- * 生成单条消息 HTML
- */
 export function generateMessageHtml(msg, index, data) {
     const { theme, borderColor, myAddress, maxLastReceivedLeafIndex } = data;
     const isNonText = isNonTextMessage(msg);
@@ -200,9 +165,6 @@ export function generateMessageHtml(msg, index, data) {
 		</div>
 	`;
 }
-/**
- * 生成签名验证信息 HTML
- */
 export function generateSignatureHtml(verifyResult, theme, textColor) {
     if (!verifyResult.signatures || verifyResult.signatures.length === 0) {
         return "";
@@ -226,15 +188,11 @@ export function generateSignatureHtml(verifyResult, theme, textColor) {
 		</div>
 	`;
 }
-/**
- * 生成完整 HTML 页面
- */
 const MESSAGES_PER_PAGE = 100;
 export function generateHtmlPage(data) {
     const { title, theme, bgColor, textColor, borderColor, meta, payload, verifyResult, maxLastReceivedLeafIndex, } = data;
     const totalMessages = payload.messages.length;
     const totalPages = Math.ceil(totalMessages / MESSAGES_PER_PAGE);
-    // 生成所有页面的消息 HTML
     const pagesHtml = [];
     for (let page = 0; page < totalPages; page++) {
         const start = page * MESSAGES_PER_PAGE;
@@ -411,4 +369,3 @@ function generatePaginationHtml(totalPages, theme, textColor) {
         <button id="next-btn" ${totalPages <= 1 ? "disabled" : ""}>Next →</button>
     </div>`;
 }
-//# sourceMappingURL=wts-html-template.js.map

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

@@ -1,16 +1,8 @@
 import { ENTRYPOINT } from "../../client/network.js";
 import type { SignatureScheme } from "../../cryptography/signature-scheme.js";
 import type { AccountOrMark_Address } from "../local/index.js";
-/**
- * Messenger 核心类型定义
- *
- * 三重信任模型：
- * 1. 身份信任：基于 wowok 账户体系的 Ed25519 签名验证
- * 2. 加密信任：基于 Signal Protocol 双棘轮算法的端到端加密
- * 3. 时序信任：基于 Merkle Tree + 服务器签名 + 链上证明
- */
 export declare enum MessageType {
-    PREKEY_MESSAGE = 3,// 首次建立会话的预密钥消息
+    PREKEY_MESSAGE = 3,
     NORMAL_MESSAGE = 1
 }
 export declare enum MessageDirection {
@@ -18,28 +10,19 @@ export declare enum MessageDirection {
     RECEIVED = "received"
 }
 export declare enum MessageStatus {
-    PENDING = "pending",// 已提交服务器，等待确认
-    CONFIRMED = "confirmed",// 已纳入 Merkle Tree
-    READ = "read",// 接收方已确认（ARK）
-    FAILED = "failed",// 发送/处理失败
-    REJECTED = "rejected",// Guard 验证被拒绝
-    DECRYPTED = "decrypted",// 【新增】解密成功
+    PENDING = "pending",
+    CONFIRMED = "confirmed",
+    READ = "read",
+    FAILED = "failed",
+    REJECTED = "rejected",
+    DECRYPTED = "decrypted",
     DECRYPT_FAILED = "decrypt_failed"
 }
-/**
- * 明文消息内容结构
- * 包含实际消息内容和消息确认信息
- */
 export interface PlaintextMessage {
-    /** 实际消息内容 */
     content: string;
-    /** 最后收到的消息 leafIndex（用于消息同步确认） */
     lastReceivedLeafIndex: number;
-    /** 消息创建时间戳（客户端时间，毫秒） */
     createdAt: number;
-    /** Guard 地址（可选） */
     guardAddress?: string;
-    /** Passport 地址（可选） */
     passportAddress?: string;
 }
 export interface Message {
@@ -73,12 +56,6 @@ export interface Message {
     decryptError?: string;
     decryptAttempts?: number;
     lastDecryptAttemptAt?: number;
-    /**
-     * 当前用户查看此消息的时间戳（本地存储）
-     * - 如果存在，表示当前用户已查看此消息
-     * - 如果不存在，表示未查看
-     * - 仅用于接收到的消息（direction === "received"）
-     */
     viewedAt?: number;
 }
 export type ZipContentType = "wts" | "wip" | "zip";
@@ -99,13 +76,10 @@ export interface MerkleProof {
 export interface MerkleMetadata {
     leafIndex: number;
     leafHash: string;
-    /** 当前 Merkle Root (服务器返回的字段名) */
     newRoot: string;
     proofSiblings: string[];
     proofIndices: number[];
-    /** 前一个 Merkle Root (服务器返回的字段名) */
     prevRoot: string;
-    /** 服务器时间戳（服务器返回的字段名） */
     serverTimestamp: number;
     serverSignature?: string;
     serverPublicKey?: string;
@@ -209,11 +183,6 @@ export interface SendMessageResponse {
         serverTimestamp: number;
         serverPublicKey: string;
     };
-    /**
-     * 方案B：会话中其他已验证消息的 Merkle 数据
-     * 当发送方发送新消息时，服务器返回会话中其他已验证但发送方可能缺少 Merkle 数据的消息
-     * 键为消息ID，值为Merkle数据
-     */
     pendingMerkleData?: Record<string, {
         leafIndex: number;
         leafHash: string;
@@ -414,119 +383,46 @@ export declare enum MessengerErrorCode {
     ACCOUNT_MESSENGER_NOT_ENABLED = "ACCOUNT_MESSENGER_NOT_ENABLED",
     REGISTRATION_FAILED = "REGISTRATION_FAILED"
 }
-/**
- * 消息过滤条件
- *
- * 所有条件都是可选的，默认返回当前用户的所有消息
- */
-/** 时间字段类型 */
 export type MessageTimeField = "createdAt" | "receivedAt" | "serverTimestamp";
-/**
- * 消息内容类型（用于过滤）
- * - "text": 普通文本消息
- * - "zip": ZIP 压缩文件消息
- * - "wts": WTS 文件消息
- * - "wip": WIP 文件消息
- */
 export type MessageContentType = "text" | "zip" | "wts" | "wip";
 export interface MessageFilter {
-    /** 按账号过滤（指定要查询的账号） */
     account?: string;
-    /** 按消息方向过滤 */
     direction?: MessageDirection;
-    /** 按消息状态过滤 */
     status?: MessageStatus;
-    /** 按会话过滤（对方地址） */
     peerAddress?: AccountOrMark_Address;
-    /** 按消息类型过滤（使用 MessageType 枚举） */
     msgType?: MessageType;
-    /** 按内容类型过滤（更友好的方式） */
     contentType?: MessageContentType;
-    /** 只返回已解密的消息 */
     decryptedOnly?: boolean;
-    /** 只返回已确认的消息（已纳入 Merkle Tree） */
     confirmedOnly?: boolean;
-    /** 关键词搜索（在明文中搜索） */
     keyword?: string;
-    /** 排序方式：asc = 正序（旧到新），desc = 倒序（新到旧） */
     sortOrder?: "asc" | "desc";
-    /** 返回数量限制 */
     limit?: number;
-    /** 分页偏移量 */
     offset?: number;
-    /** 用于时间过滤的时间字段，默认为 "createdAt" */
     timeField?: MessageTimeField;
-    /** 开始时间戳（毫秒） */
     startTime?: number;
-    /** 结束时间戳（毫秒） */
     endTime?: number;
-    /** 按创建时间过滤（客户端发送时间） */
     createdAtStart?: number;
     createdAtEnd?: number;
-    /** 按本地接收时间过滤 */
     receivedAtStart?: number;
     receivedAtEnd?: number;
-    /** 按服务器确认时间过滤 */
     serverTimestampStart?: number;
     serverTimestampEnd?: number;
-    /** 只返回已收到 ARK 确认的消息 */
     arkConfirmedOnly?: boolean;
-    /** 按 ARK 确认时间过滤 */
     arkTimestampStart?: number;
     arkTimestampEnd?: number;
-    /** 只返回已设置 proof 的消息 */
     proofedOnly?: boolean;
-    /** 只返回包含 lastReceivedLeafIndex 的消息（发送方有确认收到消息） */
     hasLastReceivedIndexOnly?: boolean;
-    /** 按 lastReceivedLeafIndex 范围过滤 */
     lastReceivedIndexMin?: number;
     lastReceivedIndexMax?: number;
-    /**
-     * 名单过滤模式
-     * - "friends": 只返回好友列表中的发送者消息
-     * - "guard": 只返回 Guard 消息发送者消息
-     * - "stranger": 只返回陌生人消息（不在好友、Guard 列表中）
-     * - "any": 不过滤（默认）
-     */
     listFilterMode?: "friends" | "guard" | "stranger" | "any";
-    /**
-     * 自定义名单过滤（高级用法）
-     * 与 listFilterMode 组合使用，实现交叉过滤
-     */
     customListFilter?: {
-        /** 包含这些地址的消息（优先级最高） */
         includeAddresses?: string[];
-        /** 排除这些地址的消息 */
         excludeAddresses?: string[];
-        /** 地址列表关系："union" = 并集，"intersection" = 交集 */
         relation?: "union" | "intersection";
     };
-    /**
-     * 按已读状态过滤（可选）
-     * - true: 只返回已查看的消息（viewedAt 存在）
-     * - false: 只返回未查看的消息（viewedAt 不存在）
-     * - undefined: 不过滤
-     */
     viewed?: boolean;
-    /**
-     * 按查看时间过滤 - 开始时间戳（毫秒，可选）
-     * 只返回 viewedAt >= 此值的消息
-     */
     viewedAtStart?: number;
-    /**
-     * 按查看时间过滤 - 结束时间戳（毫秒，可选）
-     * 只返回 viewedAt <= 此值的消息
-     */
     viewedAtEnd?: number;
-    /**
-     * 是否跳过自动标记为已查看（可选，默认 false）
-     * - true: 不自动标记，保持消息的 viewedAt 不变
-     * - false/undefined: 自动将返回的消息标记为已查看（设置 viewedAt = 当前时间）
-     *
-     * 使用场景：
-     * - 用户进入聊天界面查看消息时：不设置（默认自动标记）
-     * - 后台查询或预览时：设为 true（跳过标记）
-     */
     skipAutoMarkViewed?: boolean;
 }
 export declare class MessengerError extends Error {
@@ -534,183 +430,87 @@ export declare class MessengerError extends Error {
     cause?: Error;
     constructor(code: MessengerErrorCode, message: string, cause?: Error);
 }
-/** Guard 列表项 */
 export interface GuardListItem {
     guardAddress: string;
     passportValiditySeconds: number;
 }
-/** 用户名单数据 */
 export interface ContactLists {
-    /** 好友列表 */
     friends: string[];
-    /** Guard 列表 */
     guards: GuardListItem[];
-    /** 最后更新时间 */
     lastUpdatedAt: number;
 }
-/** 名单同步结果 */
 export interface ContactListsSyncResult {
     success: boolean;
     friends: string[];
     guards: GuardListItem[];
     error?: string;
 }
-/** 消息列表查询结果 */
 export interface MessageListResult {
-    /** 消息列表 */
     messages: Message[];
-    /** 总数 */
     total: number;
-    /** 当前页 */
     offset: number;
-    /** 每页数量 */
     limit: number;
 }
-/** 会话信息 */
 export interface ConversationInfo {
-    /** 对方地址 */
     peerAddress: string;
-    /** 最后消息时间戳（毫秒） */
     lastMessageAt: number;
-    /** 消息总数（发送+接收） */
     messageCount: number;
-    /**
-     * 未读消息数
-     * 基于 viewedAt 字段计算：
-     * - 接收到的消息（direction === "received"）且 viewedAt 不存在 = 未读
-     */
     unreadCount: number;
-    /** 最后一条消息预览（纯文本前100字符） */
     lastMessagePreview?: string;
-    /**
-     * 预览消息列表（根据 ConversationsFilter.previewMessageCount）
-     * 包含最新消息的完整内容
-     * 如果 previewMessageCount 为 0 或未设置，此字段不存在
-     */
     previewMessages?: Message[];
 }
-/**
- * 会话列表过滤条件
- * 用于 watch_conversations 查询会话列表
- */
 export interface ConversationsFilter {
-    /**
-     * 账号地址或名称（可选）
-     * 不指定则使用当前默认账号
-     */
     account?: string;
-    /**
-     * 只返回有未读消息的会话（可选）
-     * - true: 只返回 unreadCount > 0 的会话
-     * - false/undefined: 返回所有会话
-     */
     unreadOnly?: boolean;
-    /**
-     * 时间段过滤 - 开始时间戳（毫秒，可选）
-     * 基于会话的最后消息时间（lastMessageAt）进行过滤
-     */
     startTime?: number;
-    /**
-     * 时间段过滤 - 结束时间戳（毫秒，可选）
-     * 基于会话的最后消息时间（lastMessageAt）进行过滤
-     */
     endTime?: number;
-    /**
-     * 每个会话返回的预览消息数量（可选，默认2条）
-     * - 0: 不返回消息预览，只返回会话统计信息
-     * - >0: 返回指定数量的最新消息作为预览
-     */
     previewMessageCount?: number;
-    /**
-     * 排序方式（可选，默认 "lastMessageAt"）
-     * - "lastMessageAt": 按最后消息时间排序（新消息在前）
-     * - "unreadCount": 按未读消息数量排序（未读多的在前）
-     * - "messageCount": 按总消息数量排序（消息多的在前）
-     */
     sortBy?: "lastMessageAt" | "unreadCount" | "messageCount";
-    /**
-     * 排序方向（可选，默认 "desc"）
-     * - "desc": 降序（数值大的在前）
-     * - "asc": 升序（数值小的在前）
-     */
     sortOrder?: "asc" | "desc";
-    /**
-     * 是否跳过自动标记为已查看（可选，默认 false）
-     * - true: 不自动标记预览消息的 viewedAt
-     * - false/undefined: 自动将预览消息标记为已查看
-     *
-     * 注意：只影响 previewMessages 中的消息
-     */
     skipAutoMarkViewed?: boolean;
 }
-/** 范围类型 */
 export type RangeType = "time" | "messageId" | "seqIndex";
-/** 基础范围 */
 export interface BaseRange {
-    /** 范围类型 */
     type: RangeType;
-    /** 起始值 */
     start: number | string;
-    /** 结束值 */
     end: number | string;
 }
-/** 客户端时间范围 */
 export interface TimeRange extends BaseRange {
     type: "time";
     start: number;
     end: number;
 }
-/** 消息ID范围 */
 export interface MessageIdRange extends BaseRange {
     type: "messageId";
     start: string;
     end: string;
 }
-/** 序列索引范围（基于 leafIndex） */
 export interface SeqIndexRange extends BaseRange {
     type: "seqIndex";
     start: number;
     end: number;
 }
-/** WTS 范围过滤参数 */
 export type WtsRange = TimeRange | MessageIdRange | SeqIndexRange;
-/** WTS 生成参数 */
 export interface WtsGenerationParams {
-    /** 我的账号 */
     myAccount: string;
-    /** 对方账号 */
     peerAccount: AccountOrMark_Address;
-    /**
-     * 范围过滤参数
-     * 支持按客户端时间、服务器时间或消息索引（leafIndex）过滤
-     * 三种类型只需指定一种
-     */
     range?: WtsRange;
-    /** 是否不包含明文（默认包含，设置为 true 时排除） */
     excludePlaintext?: boolean;
-    /** 输出目录路径 */
     outputDir: string;
 }
-/** WTS 文件结果 */
 export interface WtsFileResult {
-    /** 生成的 WTS 文件路径列表 */
     files: string[];
-    /** 总消息数量 */
     totalMessageCount: number;
-    /** 时间范围 */
     timeRange: {
         start: number;
         end: number;
     };
 }
-/** WTS Schema URL，用于标识 WTS 文件格式版本 */
 export declare const WTS_SCHEMA_URL = "https://schema.wowok.net/wts/v1";
-/** WTS 会话信息 */
 export interface WtsSession {
     id: string;
     participants: string[];
 }
-/** WTS 消息 */
 export interface WtsMessage {
     id: string;
     from: string;
@@ -726,7 +526,6 @@ export interface WtsMessage {
     serverPublicKey: string;
     guardAddress?: string;
     passportAddress?: string;
-    /** 最后收到的消息序号（用于消息同步确认） */
     lastReceivedLeafIndex?: number;
     arkConfirmed?: {
         recipient: string;
@@ -737,19 +536,16 @@ export interface WtsMessage {
     msgType?: MessageType;
     zipMetadata?: ZipMetadata;
 }
-/** WTS 载荷 */
 export interface WtsPayload {
     session: WtsSession;
     messages: WtsMessage[];
 }
-/** WTS 签名 */
 export interface WtsSignature {
     value: string;
     publicKey: string;
     algorithm: "Ed25519";
     address?: string;
 }
-/** WTS 服务器公钥 */
 export interface WtsServerPublicKey {
     publicKey: string;
     keyId?: string;
@@ -757,7 +553,6 @@ export interface WtsServerPublicKey {
     validUntil?: number;
     algorithm?: string;
 }
-/** WTS 元数据 */
 export interface WtsMeta {
     type: "wts";
     version: string;
@@ -768,26 +563,21 @@ export interface WtsMeta {
     endTime: number;
     messageCount: number;
     merkleRoot: string;
-    /** WTS 生成者地址 */
     creator: string;
-    /** 参与者地址（对方） */
     participant: string;
     serverPublicKeys?: WtsServerPublicKey[];
     signature?: WtsSignature | WtsSignature[];
 }
-/** WTS 文件结构 */
 export interface WtsFile {
     wts: string;
     payload: WtsPayload;
     meta: WtsMeta;
 }
-/** WTS 签名验证详情 */
 export interface WtsSignatureVerification {
     publicKey: string;
     address?: string;
     valid: boolean;
 }
-/** WTS 验证结果 */
 export interface WtsVerificationResult {
     valid: boolean;
     error?: string;
@@ -796,7 +586,6 @@ export interface WtsVerificationResult {
     signatureValid?: boolean;
     signatures?: WtsSignatureVerification[];
 }
-/** WTS 转 HTML 选项 */
 export interface WtsToHtmlOptions {
     title?: string;
     theme?: "light" | "dark";