wowok 1.8.2 → 2.1.9

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

@@ -0,0 +1,134 @@
+/**
+ * Messenger 服务器客户端模块
+ *
+ * 负责与 Messenger 服务器进行通信：
+ * 1. 设备注册和预密钥上传
+ * 2. 获取对方公钥包
+ * 3. 发送和接收消息
+ * 4. 同步会话状态
+ */
+import type { SignatureScheme } from "../../cryptography/signature-scheme.js";
+import type { ServerRegisterRequest, ServerRegisterResponse, UploadPreKeysRequest, UploadPreKeysResponse, RemoteBundle, SendMessageRequest, SendMessageResponse, PullMessagesResponse, MessengerConfig, PreKeyStatus, SignedRequest, Empty, AddListRequest, AddGuardListRequest, RemoveListRequest, ClearListRequest, ExistListRequest, ListOperationResponse } from "./types.js";
+export declare class MessengerServerClient {
+    private config;
+    constructor(config?: Partial<MessengerConfig>);
+    /**
+     * 注册设备并上传预密钥
+     *
+     * 注意：请求必须包含 wowok 私钥签名，证明地址所有权
+     * 服务器会验证签名并返回详细的上传结果
+     *
+     * 如果身份已存在且密钥一致，会自动追加预密钥，不会报错
+     */
+    registerDevice(request: ServerRegisterRequest): Promise<ServerRegisterResponse>;
+    /**
+     * 上传额外的预密钥
+     *
+     * 注意：请求必须包含 wowok 私钥签名
+     * 服务器会验证签名并返回详细的上传结果
+     */
+    uploadPreKeys(request: UploadPreKeysRequest): Promise<UploadPreKeysResponse>;
+    /**
+     * 获取对方的密钥包（用于建立会话）
+     *
+     * 安全要求：必须提供签名验证
+     */
+    fetchRemoteBundle(userAddress: string, myAddress: string, myPublicKey: string, signatureParams: {
+        signatureScheme: string;
+        signature: string;
+        timestamp: number;
+        nonce: string;
+    }, _deviceId?: number): Promise<RemoteBundle>;
+    /**
+     * 发送加密消息（支持普通发送和强制发送）
+     */
+    sendMessage(request: SendMessageRequest): Promise<SendMessageResponse & {
+        guard_list?: string[];
+    }>;
+    /**
+     * 拉取消息
+     *
+     * 安全要求：必须提供签名验证
+     * @param userAddress 用户地址（用于URL路径）
+     * @param publicKey 用户公钥（用于服务器验签）
+     * @param signatureParams 签名参数
+     */
+    pullMessages(userAddress: string, publicKey: string, signatureParams: {
+        signatureScheme: string;
+        signature: string;
+        timestamp: number;
+        nonce: string;
+    }, limit?: number): Promise<PullMessagesResponse>;
+    /**
+     * 获取预密钥状态
+     */
+    getPrekeyStatus(userAddress: string): Promise<PreKeyStatus>;
+    /**
+     * 确认消息已处理（从服务器删除）
+     * 接收方验证 plaintextHash 后发送 ARK
+     */
+    acknowledgeMessages(messageIds: string[], senderPublicKey: string, signatureParams: {
+        publicKey: string;
+        signatureScheme: SignatureScheme;
+        signature: string;
+        timestamp: number;
+        nonce: string;
+    }): Promise<void>;
+    /**
+     * 黑名单 - 添加地址
+     */
+    addToBlacklist(userAddress: string, signedRequest: SignedRequest<AddListRequest>): Promise<ListOperationResponse>;
+    /**
+     * 黑名单 - 移除地址
+     */
+    removeFromBlacklist(userAddress: string, signedRequest: SignedRequest<RemoveListRequest>): Promise<ListOperationResponse>;
+    /**
+     * 黑名单 - 清空
+     */
+    clearBlacklist(userAddress: string, signedRequest: SignedRequest<ClearListRequest>): Promise<ListOperationResponse>;
+    /**
+     * 黑名单 - 获取列表
+     */
+    getBlacklist(userAddress: string, signedRequest: SignedRequest<Empty>): Promise<string[]>;
+    /**
+     * 黑名单 - 检查存在
+     */
+    existInBlacklist(userAddress: string, signedRequest: SignedRequest<ExistListRequest>): Promise<ListOperationResponse>;
+    /**
+     * 好友列表 - 添加地址
+     */
+    addToFriendsList(userAddress: string, signedRequest: SignedRequest<AddListRequest>): Promise<ListOperationResponse>;
+    /**
+     * 好友列表 - 移除地址
+     */
+    removeFromFriendsList(userAddress: string, signedRequest: SignedRequest<RemoveListRequest>): Promise<ListOperationResponse>;
+    /**
+     * 好友列表 - 清空
+     */
+    clearFriendsList(userAddress: string, signedRequest: SignedRequest<ClearListRequest>): Promise<ListOperationResponse>;
+    /**
+     * 好友列表 - 获取列表
+     */
+    getFriendsList(userAddress: string, signedRequest: SignedRequest<Empty>): Promise<string[]>;
+    /**
+     * 好友列表 - 检查存在
+     */
+    existInFriendsList(userAddress: string, signedRequest: SignedRequest<ExistListRequest>): Promise<ListOperationResponse>;
+    /**
+     * Guard 列表 - 添加
+     */
+    addToGuardList(userAddress: string, signedRequest: SignedRequest<AddGuardListRequest>): Promise<ListOperationResponse>;
+    /**
+     * Guard 列表 - 移除
+     */
+    removeFromGuardList(userAddress: string, signedRequest: SignedRequest<RemoveListRequest>): Promise<ListOperationResponse>;
+    /**
+     * Guard 列表 - 获取列表
+     */
+    getGuardList(userAddress: string, signedRequest: SignedRequest<Empty>): Promise<ListOperationResponse>;
+    /**
+     * 内部方法：列表操作
+     */
+    private _listOperation;
+}
+export declare const defaultServerClient: MessengerServerClient;

package/dist/esm/w/messenger/server.js

@@ -0,0 +1,520 @@
+var __defProp = Object.defineProperty;
+var __defNormalProp = (obj, key, value) => key in obj ? __defProp(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
+var __publicField = (obj, key, value) => __defNormalProp(obj, typeof key !== "symbol" ? key + "" : key, value);
+import {
+  MessengerError,
+  MessengerErrorCode,
+  DEFAULT_MESSENGER_CONFIG
+} from "./types.js";
+class MessengerServerClient {
+  constructor(config) {
+    __publicField(this, "config");
+    this.config = { ...DEFAULT_MESSENGER_CONFIG, ...config };
+  }
+  /**
+   * 注册设备并上传预密钥
+   *
+   * 注意：请求必须包含 wowok 私钥签名，证明地址所有权
+   * 服务器会验证签名并返回详细的上传结果
+   *
+   * 如果身份已存在且密钥一致，会自动追加预密钥，不会报错
+   */
+  async registerDevice(request) {
+    try {
+      const response = await fetch(
+        `${this.config.serverUrl}/v1/register`,
+        {
+          method: "POST",
+          headers: { "Content-Type": "application/json" },
+          body: JSON.stringify(request)
+        }
+      );
+      if (!response.ok) {
+        const errorText = await response.text();
+        if (response.status === 409) {
+          if (errorText.includes("different key")) {
+            throw new MessengerError(
+              MessengerErrorCode.IDENTITY_CONFLICT,
+              `Identity already exists with different key: ${errorText}`
+            );
+          }
+          return {
+            success: true,
+            uploadedCount: 0,
+            failedPrekeys: [],
+            currentTotal: 0,
+            maxAllowed: 100
+          };
+        }
+        throw new MessengerError(
+          MessengerErrorCode.SERVER_ERROR,
+          `Registration failed: ${response.status} ${response.statusText} - ${errorText}`
+        );
+      }
+      const data = await response.json();
+      if (data.failedPrekeys && data.failedPrekeys.length > 0) {
+      }
+      return {
+        success: data.success,
+        uploadedCount: data.uploaded_count,
+        failedPrekeys: data.failed_prekeys || [],
+        currentTotal: data.current_total,
+        maxAllowed: data.max_allowed
+      };
+    } catch (error) {
+      if (error instanceof MessengerError) throw error;
+      throw new MessengerError(
+        MessengerErrorCode.NETWORK_ERROR,
+        "Failed to register device",
+        error
+      );
+    }
+  }
+  /**
+   * 上传额外的预密钥
+   *
+   * 注意：请求必须包含 wowok 私钥签名
+   * 服务器会验证签名并返回详细的上传结果
+   */
+  async uploadPreKeys(request) {
+    try {
+      const response = await fetch(
+        `${this.config.serverUrl}/v1/prekeys/upload`,
+        {
+          method: "POST",
+          headers: { "Content-Type": "application/json" },
+          body: JSON.stringify(request)
+        }
+      );
+      if (!response.ok) {
+        const errorText = await response.text();
+        throw new MessengerError(
+          MessengerErrorCode.SERVER_ERROR,
+          `Failed to upload prekeys: ${response.status} ${response.statusText} - ${errorText}`
+        );
+      }
+      const data = await response.json();
+      if (data.failedPrekeys && data.failedPrekeys.length > 0) {
+        throw new MessengerError(
+          MessengerErrorCode.SERVER_ERROR,
+          `Some prekeys failed to upload: ${JSON.stringify(data.failedPrekeys)}`
+        );
+      }
+      return {
+        success: data.success,
+        uploadedCount: data.uploaded_count,
+        failedPrekeys: data.failed_prekeys || [],
+        currentTotal: data.current_total,
+        maxAllowed: data.max_allowed
+      };
+    } catch (error) {
+      if (error instanceof MessengerError) throw error;
+      throw new MessengerError(
+        MessengerErrorCode.NETWORK_ERROR,
+        "Failed to upload prekeys",
+        error
+      );
+    }
+  }
+  /**
+   * 获取对方的密钥包（用于建立会话）
+   *
+   * 安全要求：必须提供签名验证
+   */
+  async fetchRemoteBundle(userAddress, myAddress, myPublicKey, signatureParams, _deviceId) {
+    try {
+      const queryParams = new URLSearchParams({
+        publicKey: myPublicKey,
+        signatureScheme: signatureParams.signatureScheme,
+        signature: signatureParams.signature,
+        timestamp: signatureParams.timestamp.toString(),
+        nonce: signatureParams.nonce
+      });
+      const response = await fetch(
+        `${this.config.serverUrl}/v1/bundle/${userAddress}?${queryParams}`
+      );
+      if (!response.ok) {
+        if (response.status === 404) {
+          throw new MessengerError(
+            MessengerErrorCode.IDENTITY_NOT_FOUND,
+            `User ${userAddress} not found on server`
+          );
+        }
+        throw new MessengerError(
+          MessengerErrorCode.SERVER_ERROR,
+          `Failed to fetch remote bundle: ${response.statusText}`
+        );
+      }
+      const bundle = await response.json();
+      return bundle;
+    } catch (error) {
+      if (error instanceof MessengerError) throw error;
+      throw new MessengerError(
+        MessengerErrorCode.NETWORK_ERROR,
+        "Failed to fetch remote bundle",
+        error
+      );
+    }
+  }
+  /**
+   * 发送加密消息（支持普通发送和强制发送）
+   */
+  async sendMessage(request) {
+    try {
+      const response = await fetch(
+        `${this.config.serverUrl}/v1/message`,
+        {
+          method: "POST",
+          headers: { "Content-Type": "application/json" },
+          body: JSON.stringify(request)
+        }
+      );
+      const responseData = await response.json();
+      if (!response.ok) {
+        const errorMessage = responseData?.message || response.statusText;
+        const error = new MessengerError(
+          MessengerErrorCode.SERVER_ERROR,
+          errorMessage
+        );
+        error.guardList = responseData?.guard_list;
+        throw error;
+      }
+      return responseData;
+    } catch (error) {
+      if (error instanceof MessengerError) throw error;
+      throw new MessengerError(
+        MessengerErrorCode.NETWORK_ERROR,
+        "Failed to send message",
+        error
+      );
+    }
+  }
+  /**
+   * 拉取消息
+   *
+   * 安全要求：必须提供签名验证
+   * @param userAddress 用户地址（用于URL路径）
+   * @param publicKey 用户公钥（用于服务器验签）
+   * @param signatureParams 签名参数
+   */
+  async pullMessages(userAddress, publicKey, signatureParams, limit) {
+    try {
+      const queryParams = new URLSearchParams({
+        publicKey,
+        signatureScheme: signatureParams.signatureScheme,
+        signature: signatureParams.signature,
+        timestamp: signatureParams.timestamp.toString(),
+        nonce: signatureParams.nonce
+      });
+      if (limit !== void 0) {
+        queryParams.set("limit", limit.toString());
+      }
+      const response = await fetch(
+        `${this.config.serverUrl}/v1/messages/${userAddress}?${queryParams}`
+      );
+      if (!response.ok) {
+        throw new MessengerError(
+          MessengerErrorCode.SERVER_ERROR,
+          `Failed to pull messages: ${response.statusText}`
+        );
+      }
+      const json = await response.json();
+      return json;
+    } catch (error) {
+      if (error instanceof MessengerError) throw error;
+      throw new MessengerError(
+        MessengerErrorCode.NETWORK_ERROR,
+        "Failed to pull messages",
+        error
+      );
+    }
+  }
+  /**
+   * 获取预密钥状态
+   */
+  async getPrekeyStatus(userAddress) {
+    try {
+      const response = await fetch(
+        `${this.config.serverUrl}/v1/prekeys/${userAddress}/status`
+      );
+      if (!response.ok) {
+        throw new MessengerError(
+          MessengerErrorCode.SERVER_ERROR,
+          `Failed to get prekey status: ${response.statusText}`
+        );
+      }
+      const data = await response.json();
+      return {
+        currentCount: data.current_count,
+        maxAllowed: data.max_allowed,
+        threshold: data.threshold,
+        shouldRefill: data.should_refill
+      };
+    } catch (error) {
+      if (error instanceof MessengerError) throw error;
+      throw new MessengerError(
+        MessengerErrorCode.NETWORK_ERROR,
+        "Failed to get prekey status",
+        error
+      );
+    }
+  }
+  /**
+   * 确认消息已处理（从服务器删除）
+   * 接收方验证 plaintextHash 后发送 ARK
+   */
+  async acknowledgeMessages(messageIds, senderPublicKey, signatureParams) {
+    try {
+      const response = await fetch(
+        `${this.config.serverUrl}/v1/messages/ack`,
+        {
+          method: "POST",
+          headers: { "Content-Type": "application/json" },
+          body: JSON.stringify({
+            publicKey: signatureParams.publicKey,
+            messageIds,
+            senderPublicKey,
+            signatureScheme: signatureParams.signatureScheme,
+            signature: signatureParams.signature,
+            timestamp: signatureParams.timestamp,
+            nonce: signatureParams.nonce
+          })
+        }
+      );
+      if (!response.ok) {
+        throw new MessengerError(
+          MessengerErrorCode.SERVER_ERROR,
+          `Failed to acknowledge messages: ${response.statusText}`
+        );
+      }
+    } catch (error) {
+      if (error instanceof MessengerError) throw error;
+      throw new MessengerError(
+        MessengerErrorCode.NETWORK_ERROR,
+        "Failed to acknowledge messages",
+        error
+      );
+    }
+  }
+  /**
+   * 黑名单 - 添加地址
+   */
+  async addToBlacklist(userAddress, signedRequest) {
+    return this._listOperation(
+      `${this.config.serverUrl}/v1/spam-protection/${userAddress}/blacklist`,
+      signedRequest,
+      "POST"
+    );
+  }
+  /**
+   * 黑名单 - 移除地址
+   */
+  async removeFromBlacklist(userAddress, signedRequest) {
+    return this._listOperation(
+      `${this.config.serverUrl}/v1/spam-protection/${userAddress}/blacklist`,
+      signedRequest,
+      "DELETE"
+    );
+  }
+  /**
+   * 黑名单 - 清空
+   */
+  async clearBlacklist(userAddress, signedRequest) {
+    return this._listOperation(
+      `${this.config.serverUrl}/v1/spam-protection/${userAddress}/blacklist/clear`,
+      signedRequest,
+      "POST"
+    );
+  }
+  /**
+   * 黑名单 - 获取列表
+   */
+  async getBlacklist(userAddress, signedRequest) {
+    try {
+      const response = await fetch(
+        `${this.config.serverUrl}/v1/spam-protection/${userAddress}/blacklist/get`,
+        {
+          method: "POST",
+          headers: { "Content-Type": "application/json" },
+          body: JSON.stringify(signedRequest)
+        }
+      );
+      if (!response.ok) {
+        const errorText = await response.text();
+        console.error("getBlacklist error response:", errorText);
+        throw new MessengerError(
+          MessengerErrorCode.SERVER_ERROR,
+          `Failed to get blacklist: ${response.statusText} - ${errorText}`
+        );
+      }
+      return await response.json();
+    } catch (error) {
+      if (error instanceof MessengerError) throw error;
+      throw new MessengerError(
+        MessengerErrorCode.NETWORK_ERROR,
+        "Failed to get blacklist",
+        error
+      );
+    }
+  }
+  /**
+   * 黑名单 - 检查存在
+   */
+  async existInBlacklist(userAddress, signedRequest) {
+    return this._listOperation(
+      `${this.config.serverUrl}/v1/spam-protection/${userAddress}/blacklist/exist`,
+      signedRequest,
+      "POST"
+    );
+  }
+  /**
+   * 好友列表 - 添加地址
+   */
+  async addToFriendsList(userAddress, signedRequest) {
+    return this._listOperation(
+      `${this.config.serverUrl}/v1/spam-protection/${userAddress}/friends-list`,
+      signedRequest,
+      "POST"
+    );
+  }
+  /**
+   * 好友列表 - 移除地址
+   */
+  async removeFromFriendsList(userAddress, signedRequest) {
+    return this._listOperation(
+      `${this.config.serverUrl}/v1/spam-protection/${userAddress}/friends-list`,
+      signedRequest,
+      "DELETE"
+    );
+  }
+  /**
+   * 好友列表 - 清空
+   */
+  async clearFriendsList(userAddress, signedRequest) {
+    return this._listOperation(
+      `${this.config.serverUrl}/v1/spam-protection/${userAddress}/friends-list/clear`,
+      signedRequest,
+      "POST"
+    );
+  }
+  /**
+   * 好友列表 - 获取列表
+   */
+  async getFriendsList(userAddress, signedRequest) {
+    try {
+      const response = await fetch(
+        `${this.config.serverUrl}/v1/spam-protection/${userAddress}/friends-list/get`,
+        {
+          method: "POST",
+          headers: { "Content-Type": "application/json" },
+          body: JSON.stringify(signedRequest)
+        }
+      );
+      if (!response.ok) {
+        throw new MessengerError(
+          MessengerErrorCode.SERVER_ERROR,
+          `Failed to get friends list: ${response.statusText}`
+        );
+      }
+      return await response.json();
+    } catch (error) {
+      if (error instanceof MessengerError) throw error;
+      throw new MessengerError(
+        MessengerErrorCode.NETWORK_ERROR,
+        "Failed to get friends list",
+        error
+      );
+    }
+  }
+  /**
+   * 好友列表 - 检查存在
+   */
+  async existInFriendsList(userAddress, signedRequest) {
+    return this._listOperation(
+      `${this.config.serverUrl}/v1/spam-protection/${userAddress}/friends-list/exist`,
+      signedRequest,
+      "POST"
+    );
+  }
+  /**
+   * Guard 列表 - 添加
+   */
+  async addToGuardList(userAddress, signedRequest) {
+    return this._listOperation(
+      `${this.config.serverUrl}/v1/spam-protection/${userAddress}/guard-list`,
+      signedRequest,
+      "POST"
+    );
+  }
+  /**
+   * Guard 列表 - 移除
+   */
+  async removeFromGuardList(userAddress, signedRequest) {
+    return this._listOperation(
+      `${this.config.serverUrl}/v1/spam-protection/${userAddress}/guard-list`,
+      signedRequest,
+      "DELETE"
+    );
+  }
+  /**
+   * Guard 列表 - 获取列表
+   */
+  async getGuardList(userAddress, signedRequest) {
+    try {
+      const response = await fetch(
+        `${this.config.serverUrl}/v1/spam-protection/${userAddress}/guard-list/get`,
+        {
+          method: "POST",
+          headers: { "Content-Type": "application/json" },
+          body: JSON.stringify(signedRequest)
+        }
+      );
+      if (!response.ok) {
+        throw new MessengerError(
+          MessengerErrorCode.SERVER_ERROR,
+          `Failed to get guard list: ${response.statusText}`
+        );
+      }
+      return await response.json();
+    } catch (error) {
+      if (error instanceof MessengerError) throw error;
+      throw new MessengerError(
+        MessengerErrorCode.NETWORK_ERROR,
+        "Failed to get guard list",
+        error
+      );
+    }
+  }
+  /**
+   * 内部方法：列表操作
+   */
+  async _listOperation(url, signedRequest, method = "POST") {
+    try {
+      const response = await fetch(url, {
+        method,
+        headers: { "Content-Type": "application/json" },
+        body: JSON.stringify(signedRequest)
+      });
+      if (!response.ok) {
+        const errorText = await response.text();
+        throw new MessengerError(
+          MessengerErrorCode.SERVER_ERROR,
+          `List operation failed: ${response.statusText} - ${errorText}`
+        );
+      }
+      return await response.json();
+    } catch (error) {
+      if (error instanceof MessengerError) throw error;
+      throw new MessengerError(
+        MessengerErrorCode.NETWORK_ERROR,
+        "Failed to perform list operation",
+        error
+      );
+    }
+  }
+}
+const defaultServerClient = new MessengerServerClient();
+export {
+  MessengerServerClient,
+  defaultServerClient
+};