@meet-im/meet-bot-jssdk 1.0.0 → 1.1.0

package/dist/index.d.cts

@@ -216,6 +216,37 @@ interface ReceivedAttachmentInfo {
     mimeType?: string;
 }
 
+interface MeetUser {
+    userID: number;
+    nickName: string;
+    nickNamePinyin?: string;
+    aliasName?: string;
+    aliasNamePinyin?: string;
+    gender?: number;
+    birthday?: string;
+    avatar?: string;
+    avatarUrl?: string;
+    email?: string;
+    mobile?: string;
+    jobNumber?: string;
+    tag?: string;
+    tags?: string[];
+    companyId?: number;
+    status?: number;
+    statusMsg?: string[];
+    sourceType?: number;
+    employeeStatus?: number;
+    cleanStatus?: number;
+    deletedAt?: number;
+    isDepartmentAdmin?: boolean;
+    isHide?: boolean;
+    sort?: number;
+    oaUID?: number;
+    msgDelTimeStamp?: number;
+    userType?: number;
+    updatedAt?: number;
+}
+
 declare class MeetBotError extends Error {
     readonly code: ErrorCode;
     constructor(message: string, code: ErrorCode);
@@ -227,10 +258,13 @@ declare class ApiError extends MeetBotError {
 }
 declare class NetworkError extends MeetBotError {
     readonly cause?: Error;
-    constructor(message: string, cause?: Error);
+    readonly httpStatus?: number;
+    readonly responseSnippet?: string;
+    constructor(message: string, cause?: Error, httpStatus?: number, responseSnippet?: string);
 }
 declare class TimeoutError extends MeetBotError {
-    constructor(message: string);
+    readonly isLocal: boolean;
+    constructor(message: string, isLocal?: boolean);
 }
 declare class ValidationError extends MeetBotError {
     readonly field: string;
@@ -238,6 +272,28 @@ declare class ValidationError extends MeetBotError {
     constructor(message: string, field: string, value: unknown);
 }
 
+interface UserCacheOptions {
+    ttl?: number;
+}
+declare class UserCache {
+    private byId;
+    private byNickName;
+    private byAliasName;
+    private loadedAt;
+    private readonly ttl;
+    private loading;
+    constructor(options?: UserCacheOptions);
+    isExpired(): boolean;
+    load(fetchAll: () => Promise<MeetUser[]>): Promise<void>;
+    private rebuild;
+    ensureLoaded(fetchAll: () => Promise<MeetUser[]>): Promise<void>;
+    getById(userId: number): MeetUser | undefined;
+    getByIds(userIds: number[]): Map<number, MeetUser>;
+    getByName(name: string): MeetUser[];
+    searchByName(query: string): MeetUser[];
+    get size(): number;
+}
+
 type EventHandler<T = unknown> = (data: T) => void;
 interface Events {
     message: {
@@ -258,7 +314,10 @@ declare class MeetBot {
     private polling;
     private offset;
     private abortController;
-    constructor(config: MeetBotConfig);
+    private readonly userCache;
+    constructor(config: MeetBotConfig & {
+        userCacheOptions?: UserCacheOptions;
+    });
     on<K extends keyof Events>(event: K, handler: EventHandler<Events[K]>): this;
     off<K extends keyof Events>(event: K, handler: EventHandler<Events[K]>): this;
     private emit;
@@ -281,6 +340,12 @@ declare class MeetBot {
     getAccessURL(params: GetAccessURLParams | GetAccessURLBySessionParams): Promise<AccessURLResult>;
     uploadFile(buffer: Buffer, options: UploadFileOptions): Promise<UploadFileResult>;
     sendMedia(sessionInfo: SessionInfo, options: SendMediaOptions): Promise<SendMessageResult>;
+    refreshUserCache(): Promise<void>;
+    getUserById(userId: number): Promise<MeetUser | undefined>;
+    getUserByIds(userIds: number[]): Promise<Map<number, MeetUser>>;
+    getUserByName(name: string): Promise<MeetUser[]>;
+    searchUserByName(query: string): Promise<MeetUser[]>;
+    get userCacheSize(): number;
     private sleep;
 }
 
@@ -309,6 +374,11 @@ declare function computeMD5(buffer: Buffer): Promise<string>;
 declare function uploadFile(token: string, buffer: Buffer, options: UploadFileOptions, baseUrl?: string): Promise<UploadFileResult>;
 declare function sendMediaMessage(token: string, sessionInfo: SessionInfo, options: SendMediaOptions, baseUrl?: string): Promise<SendMessageResult>;
 
+declare function getUsers(params: {
+    token: string;
+    baseUrl?: string;
+}): Promise<MeetUser[]>;
+
 interface GetUpdatesParams {
     token: string;
     baseUrl?: string;
@@ -378,4 +448,4 @@ declare function getChunkNum(size: number): number;
 declare function getConvID(firstID: number, secondID: number, sessionType: number, companyID?: number): string;
 declare function getQuoteMsgKey(convID: string, seqID: number): string;
 
-export { API, type AccessURLResult, ApiError, type ApiErrorResponse, type ApiResponse, type AttachmentInfo, type BotChat, type BotFile, type BotMsg, type BotMsgUpdate, type BotUpdate, type BotUser, CHUNK_RULES, type ChatType, type CompleteMultipartUploadParams, type CompleteMultipartUploadResult, DEFAULT_BASE_URL, type ErrorCode, type ExtraInfo, type GetAccessURLBySessionParams, type GetAccessURLParams, type GetMultiPartUploadURLParams, type GetUpdatesOptions, type GetUpdatesV2Result, type GetUploadURLParams, HTTP, type LogLevel, MeetBot, type MeetBotConfig, MeetBotError, type MsgContent, type MsgType, type MultiPartUploadURLResult, NetworkError, POLLING, type PollingOptions, type QuoteMsgMap, type ReceivedAttachmentInfo, SESSION_TYPE, type SendMediaOptions, type SendMessageOptions, type SendMessageResult, type SessionInfo, type SessionType, TimeoutError, UPLOAD, type UploadFileOptions, type UploadFileResult, type UploadPart, type UploadProgress, type UploadURLResult, ValidationError, completeMultipartUpload, computeMD5, getAccessURL, getChunkNum, getConvID, getMultiPartUploadURL, getQuoteMsgKey, getUpdates, getUpdatesV2, getUploadURL, sendMediaMessage, sendMessage, uploadFile };
+export { API, type AccessURLResult, ApiError, type ApiErrorResponse, type ApiResponse, type AttachmentInfo, type BotChat, type BotFile, type BotMsg, type BotMsgUpdate, type BotUpdate, type BotUser, CHUNK_RULES, type ChatType, type CompleteMultipartUploadParams, type CompleteMultipartUploadResult, DEFAULT_BASE_URL, type ErrorCode, type ExtraInfo, type GetAccessURLBySessionParams, type GetAccessURLParams, type GetMultiPartUploadURLParams, type GetUpdatesOptions, type GetUpdatesV2Result, type GetUploadURLParams, HTTP, type LogLevel, MeetBot, type MeetBotConfig, MeetBotError, type MeetUser, type MsgContent, type MsgType, type MultiPartUploadURLResult, NetworkError, POLLING, type PollingOptions, type QuoteMsgMap, type ReceivedAttachmentInfo, SESSION_TYPE, type SendMediaOptions, type SendMessageOptions, type SendMessageResult, type SessionInfo, type SessionType, TimeoutError, UPLOAD, type UploadFileOptions, type UploadFileResult, type UploadPart, type UploadProgress, type UploadURLResult, UserCache, type UserCacheOptions, ValidationError, completeMultipartUpload, computeMD5, getAccessURL, getChunkNum, getConvID, getMultiPartUploadURL, getQuoteMsgKey, getUpdates, getUpdatesV2, getUploadURL, getUsers, sendMediaMessage, sendMessage, uploadFile };

package/dist/index.d.ts

@@ -216,6 +216,37 @@ interface ReceivedAttachmentInfo {
     mimeType?: string;
 }
 
+interface MeetUser {
+    userID: number;
+    nickName: string;
+    nickNamePinyin?: string;
+    aliasName?: string;
+    aliasNamePinyin?: string;
+    gender?: number;
+    birthday?: string;
+    avatar?: string;
+    avatarUrl?: string;
+    email?: string;
+    mobile?: string;
+    jobNumber?: string;
+    tag?: string;
+    tags?: string[];
+    companyId?: number;
+    status?: number;
+    statusMsg?: string[];
+    sourceType?: number;
+    employeeStatus?: number;
+    cleanStatus?: number;
+    deletedAt?: number;
+    isDepartmentAdmin?: boolean;
+    isHide?: boolean;
+    sort?: number;
+    oaUID?: number;
+    msgDelTimeStamp?: number;
+    userType?: number;
+    updatedAt?: number;
+}
+
 declare class MeetBotError extends Error {
     readonly code: ErrorCode;
     constructor(message: string, code: ErrorCode);
@@ -227,10 +258,13 @@ declare class ApiError extends MeetBotError {
 }
 declare class NetworkError extends MeetBotError {
     readonly cause?: Error;
-    constructor(message: string, cause?: Error);
+    readonly httpStatus?: number;
+    readonly responseSnippet?: string;
+    constructor(message: string, cause?: Error, httpStatus?: number, responseSnippet?: string);
 }
 declare class TimeoutError extends MeetBotError {
-    constructor(message: string);
+    readonly isLocal: boolean;
+    constructor(message: string, isLocal?: boolean);
 }
 declare class ValidationError extends MeetBotError {
     readonly field: string;
@@ -238,6 +272,28 @@ declare class ValidationError extends MeetBotError {
     constructor(message: string, field: string, value: unknown);
 }
 
+interface UserCacheOptions {
+    ttl?: number;
+}
+declare class UserCache {
+    private byId;
+    private byNickName;
+    private byAliasName;
+    private loadedAt;
+    private readonly ttl;
+    private loading;
+    constructor(options?: UserCacheOptions);
+    isExpired(): boolean;
+    load(fetchAll: () => Promise<MeetUser[]>): Promise<void>;
+    private rebuild;
+    ensureLoaded(fetchAll: () => Promise<MeetUser[]>): Promise<void>;
+    getById(userId: number): MeetUser | undefined;
+    getByIds(userIds: number[]): Map<number, MeetUser>;
+    getByName(name: string): MeetUser[];
+    searchByName(query: string): MeetUser[];
+    get size(): number;
+}
+
 type EventHandler<T = unknown> = (data: T) => void;
 interface Events {
     message: {
@@ -258,7 +314,10 @@ declare class MeetBot {
     private polling;
     private offset;
     private abortController;
-    constructor(config: MeetBotConfig);
+    private readonly userCache;
+    constructor(config: MeetBotConfig & {
+        userCacheOptions?: UserCacheOptions;
+    });
     on<K extends keyof Events>(event: K, handler: EventHandler<Events[K]>): this;
     off<K extends keyof Events>(event: K, handler: EventHandler<Events[K]>): this;
     private emit;
@@ -281,6 +340,12 @@ declare class MeetBot {
     getAccessURL(params: GetAccessURLParams | GetAccessURLBySessionParams): Promise<AccessURLResult>;
     uploadFile(buffer: Buffer, options: UploadFileOptions): Promise<UploadFileResult>;
     sendMedia(sessionInfo: SessionInfo, options: SendMediaOptions): Promise<SendMessageResult>;
+    refreshUserCache(): Promise<void>;
+    getUserById(userId: number): Promise<MeetUser | undefined>;
+    getUserByIds(userIds: number[]): Promise<Map<number, MeetUser>>;
+    getUserByName(name: string): Promise<MeetUser[]>;
+    searchUserByName(query: string): Promise<MeetUser[]>;
+    get userCacheSize(): number;
     private sleep;
 }
 
@@ -309,6 +374,11 @@ declare function computeMD5(buffer: Buffer): Promise<string>;
 declare function uploadFile(token: string, buffer: Buffer, options: UploadFileOptions, baseUrl?: string): Promise<UploadFileResult>;
 declare function sendMediaMessage(token: string, sessionInfo: SessionInfo, options: SendMediaOptions, baseUrl?: string): Promise<SendMessageResult>;
 
+declare function getUsers(params: {
+    token: string;
+    baseUrl?: string;
+}): Promise<MeetUser[]>;
+
 interface GetUpdatesParams {
     token: string;
     baseUrl?: string;
@@ -378,4 +448,4 @@ declare function getChunkNum(size: number): number;
 declare function getConvID(firstID: number, secondID: number, sessionType: number, companyID?: number): string;
 declare function getQuoteMsgKey(convID: string, seqID: number): string;
 
-export { API, type AccessURLResult, ApiError, type ApiErrorResponse, type ApiResponse, type AttachmentInfo, type BotChat, type BotFile, type BotMsg, type BotMsgUpdate, type BotUpdate, type BotUser, CHUNK_RULES, type ChatType, type CompleteMultipartUploadParams, type CompleteMultipartUploadResult, DEFAULT_BASE_URL, type ErrorCode, type ExtraInfo, type GetAccessURLBySessionParams, type GetAccessURLParams, type GetMultiPartUploadURLParams, type GetUpdatesOptions, type GetUpdatesV2Result, type GetUploadURLParams, HTTP, type LogLevel, MeetBot, type MeetBotConfig, MeetBotError, type MsgContent, type MsgType, type MultiPartUploadURLResult, NetworkError, POLLING, type PollingOptions, type QuoteMsgMap, type ReceivedAttachmentInfo, SESSION_TYPE, type SendMediaOptions, type SendMessageOptions, type SendMessageResult, type SessionInfo, type SessionType, TimeoutError, UPLOAD, type UploadFileOptions, type UploadFileResult, type UploadPart, type UploadProgress, type UploadURLResult, ValidationError, completeMultipartUpload, computeMD5, getAccessURL, getChunkNum, getConvID, getMultiPartUploadURL, getQuoteMsgKey, getUpdates, getUpdatesV2, getUploadURL, sendMediaMessage, sendMessage, uploadFile };
+export { API, type AccessURLResult, ApiError, type ApiErrorResponse, type ApiResponse, type AttachmentInfo, type BotChat, type BotFile, type BotMsg, type BotMsgUpdate, type BotUpdate, type BotUser, CHUNK_RULES, type ChatType, type CompleteMultipartUploadParams, type CompleteMultipartUploadResult, DEFAULT_BASE_URL, type ErrorCode, type ExtraInfo, type GetAccessURLBySessionParams, type GetAccessURLParams, type GetMultiPartUploadURLParams, type GetUpdatesOptions, type GetUpdatesV2Result, type GetUploadURLParams, HTTP, type LogLevel, MeetBot, type MeetBotConfig, MeetBotError, type MeetUser, type MsgContent, type MsgType, type MultiPartUploadURLResult, NetworkError, POLLING, type PollingOptions, type QuoteMsgMap, type ReceivedAttachmentInfo, SESSION_TYPE, type SendMediaOptions, type SendMessageOptions, type SendMessageResult, type SessionInfo, type SessionType, TimeoutError, UPLOAD, type UploadFileOptions, type UploadFileResult, type UploadPart, type UploadProgress, type UploadURLResult, UserCache, type UserCacheOptions, ValidationError, completeMultipartUpload, computeMD5, getAccessURL, getChunkNum, getConvID, getMultiPartUploadURL, getQuoteMsgKey, getUpdates, getUpdatesV2, getUploadURL, getUsers, sendMediaMessage, sendMessage, uploadFile };

package/dist/index.js

@@ -44,16 +44,34 @@ var init_error = __esm({
     };
     NetworkError = class extends MeetBotError {
       cause;
-      constructor(message, cause) {
+      /**
+       * HTTP 状态码（如果有的话）
+       * 例如：504 表示网关超时，0 表示无 HTTP 响应
+       */
+      httpStatus;
+      /**
+       * 响应内容片段（用于调试）
+       */
+      responseSnippet;
+      constructor(message, cause, httpStatus, responseSnippet) {
         super(message, "NETWORK_ERROR");
         this.name = "NetworkError";
         this.cause = cause;
+        this.httpStatus = httpStatus;
+        this.responseSnippet = responseSnippet;
       }
     };
     TimeoutError = class extends MeetBotError {
-      constructor(message) {
+      /**
+       * 是否为本地客户端超时（AbortController 触发）
+       * true: 本地 HTTP 请求超时
+       * false: 服务端/网关返回的超时（如 504 Gateway Timeout）
+       */
+      isLocal;
+      constructor(message, isLocal = true) {
         super(message, "TIMEOUT_ERROR");
         this.name = "TimeoutError";
+        this.isLocal = isLocal;
       }
     };
     ValidationError = class extends MeetBotError {
@@ -196,8 +214,8 @@ function extractBotToken(token) {
   const parts = token.split(":");
   return parts.length >= 2 ? parts.slice(1).join(":") : token;
 }
-function buildUrl(baseUrl, path, params) {
-  const url = new URL(`/im/bot/${path}`, baseUrl);
+function buildUrl(baseUrl, path, pathPrefix, params) {
+  const url = new URL(`${pathPrefix}${path}`, baseUrl);
   if (params) {
     for (const [key, value] of Object.entries(params)) {
       if (value !== void 0) {
@@ -208,9 +226,19 @@ function buildUrl(baseUrl, path, params) {
   return url.toString();
 }
 async function request(options) {
-  const { token, baseUrl, method = "GET", path, params, body, timeout = HTTP.DEFAULT_TIMEOUT } = options;
+  const {
+    token,
+    baseUrl,
+    method = "GET",
+    path,
+    pathPrefix = "/im/bot/",
+    params,
+    body,
+    timeout = HTTP.DEFAULT_TIMEOUT,
+    raw = false
+  } = options;
   validateToken(token);
-  const url = buildUrl(baseUrl || DEFAULT_BASE_URL, path, method === "GET" ? params : void 0);
+  const url = buildUrl(baseUrl || DEFAULT_BASE_URL, path, pathPrefix, method === "GET" ? params : void 0);
   const controller = new AbortController();
   const timeoutId = setTimeout(() => controller.abort(), timeout);
   const headers = {
@@ -239,18 +267,40 @@ async function request(options) {
     const responseText = await response.text();
     if (!contentType.includes("application/json")) {
       logger.error("[Response] Non-JSON response:", responseText.substring(0, 500));
-      throw new NetworkError(`Server returned non-JSON response (status ${response.status})`, void 0);
+      if (response.status === 504) {
+        throw new TimeoutError(`Gateway timeout (status ${response.status})`, false);
+      }
+      throw new NetworkError(
+        `Server returned non-JSON response (status ${response.status})`,
+        void 0,
+        response.status,
+        responseText.substring(0, 200)
+      );
     }
     let data;
     try {
       data = JSON.parse(responseText);
     } catch {
       logger.error("[Response] Failed to parse JSON:", responseText.substring(0, 500));
-      throw new NetworkError("Failed to parse server response", void 0);
+      throw new NetworkError(
+        "Failed to parse server response",
+        void 0,
+        response.status,
+        responseText.substring(0, 200)
+      );
     }
     logger.info("[Response Body]", JSON.stringify(data));
+    if (raw) {
+      return data;
+    }
     if (!response.ok || !data.ok) {
       const errorData = data;
+      if (response.status === 504) {
+        throw new TimeoutError(
+          errorData.description || `Gateway timeout (status ${response.status})`,
+          false
+        );
+      }
       throw new ApiError(
         errorData.description || `HTTP ${response.status}`,
         response.status,
@@ -266,7 +316,7 @@ async function request(options) {
     }
     if (error instanceof Error) {
       if (error.name === "AbortError") {
-        throw new TimeoutError(`Request timeout after ${timeout}ms`);
+        throw new TimeoutError(`Request timeout after ${timeout}ms`, true);
       }
       throw new NetworkError(`Network error: ${error.message}`, error);
     }
@@ -541,6 +591,25 @@ async function sendMediaMessage(token, sessionInfo, options, baseUrl) {
   });
 }
 
+// src/api/user.ts
+async function getUsers(params) {
+  const { token, baseUrl } = params;
+  const result = await request({
+    token,
+    baseUrl,
+    method: "POST",
+    path: "general/SyncCompanyUser",
+    pathPrefix: "/",
+    body: { syncAt: 0 },
+    timeout: HTTP.DEFAULT_TIMEOUT,
+    raw: true
+  });
+  return Object.values(result.users).map((user) => ({
+    userID: user.userID,
+    nickName: user.nickName
+  }));
+}
+
 // src/api/index.ts
 async function getUpdates(params) {
   const { token, baseUrl, timeout = API.DEFAULT_TIMEOUT, offset, limit = API.DEFAULT_LIMIT } = params;
@@ -593,6 +662,115 @@ async function sendMessage(params) {
 
 // src/client.ts
 init_error();
+
+// src/user-cache.ts
+var UserCache = class {
+  byId = /* @__PURE__ */ new Map();
+  byNickName = /* @__PURE__ */ new Map();
+  byAliasName = /* @__PURE__ */ new Map();
+  loadedAt = 0;
+  ttl;
+  loading = null;
+  constructor(options) {
+    this.ttl = options?.ttl ?? 60 * 60 * 1e3;
+  }
+  isExpired() {
+    return this.byId.size === 0 || this.ttl > 0 && Date.now() - this.loadedAt > this.ttl;
+  }
+  async load(fetchAll) {
+    if (this.loading) {
+      return this.loading;
+    }
+    this.loading = (async () => {
+      try {
+        const users = await fetchAll();
+        this.rebuild(users);
+        logger.info(`\u7528\u6237\u7F13\u5B58\u5DF2\u52A0\u8F7D\uFF0C\u5171 ${users.length} \u4E2A\u7528\u6237`);
+      } finally {
+        this.loading = null;
+      }
+    })();
+    return this.loading;
+  }
+  rebuild(users) {
+    this.byId.clear();
+    this.byNickName.clear();
+    this.byAliasName.clear();
+    for (const user of users) {
+      this.byId.set(user.userID, user);
+      const nickKey = user.nickName.toLowerCase();
+      let nickList = this.byNickName.get(nickKey);
+      if (!nickList) {
+        nickList = [];
+        this.byNickName.set(nickKey, nickList);
+      }
+      nickList.push(user);
+      if (user.aliasName) {
+        const aliasKey = user.aliasName.toLowerCase();
+        let aliasList = this.byAliasName.get(aliasKey);
+        if (!aliasList) {
+          aliasList = [];
+          this.byAliasName.set(aliasKey, aliasList);
+        }
+        aliasList.push(user);
+      }
+    }
+    this.loadedAt = Date.now();
+  }
+  async ensureLoaded(fetchAll) {
+    if (!this.isExpired()) return;
+    await this.load(fetchAll);
+  }
+  getById(userId) {
+    return this.byId.get(userId);
+  }
+  getByIds(userIds) {
+    const result = /* @__PURE__ */ new Map();
+    for (const id of userIds) {
+      const user = this.byId.get(id);
+      if (user) {
+        result.set(id, user);
+      }
+    }
+    return result;
+  }
+  getByName(name) {
+    const key = name.toLowerCase();
+    const byNick = this.byNickName.get(key);
+    const byAlias = this.byAliasName.get(key);
+    if (!byNick && !byAlias) return [];
+    if (!byNick) return [...byAlias];
+    if (!byAlias) return [...byNick];
+    const seen = /* @__PURE__ */ new Set();
+    const result = [];
+    for (const u of [...byNick, ...byAlias]) {
+      if (!seen.has(u.userID)) {
+        seen.add(u.userID);
+        result.push(u);
+      }
+    }
+    return result;
+  }
+  searchByName(query) {
+    const q = query.toLowerCase();
+    const result = [];
+    const seen = /* @__PURE__ */ new Set();
+    for (const user of this.byId.values()) {
+      if (user.nickName.toLowerCase().includes(q) || user.aliasName && user.aliasName.toLowerCase().includes(q) || user.nickNamePinyin && user.nickNamePinyin.toLowerCase().includes(q) || user.aliasNamePinyin && user.aliasNamePinyin.toLowerCase().includes(q)) {
+        if (!seen.has(user.userID)) {
+          seen.add(user.userID);
+          result.push(user);
+        }
+      }
+    }
+    return result;
+  }
+  get size() {
+    return this.byId.size;
+  }
+};
+
+// src/client.ts
 var MeetBot = class {
   token;
   baseUrl;
@@ -603,6 +781,7 @@ var MeetBot = class {
   polling = false;
   offset = 0;
   abortController = null;
+  userCache;
   constructor(config) {
     if (config.token) {
       if (!config.token.includes(":")) {
@@ -618,6 +797,7 @@ var MeetBot = class {
     this.pollingLimit = config.pollingLimit ?? POLLING.DEFAULT_LIMIT;
     this.longPollingTimeout = config.longPollingTimeout ?? POLLING.DEFAULT_TIMEOUT;
     this.useV2 = config.useV2 ?? false;
+    this.userCache = new UserCache(config.userCacheOptions);
     logger.setLevel(config.logLevel ?? "silent");
   }
   on(event, handler) {
@@ -799,6 +979,56 @@ var MeetBot = class {
   async sendMedia(sessionInfo, options) {
     return sendMediaMessage(this.token, sessionInfo, options, this.baseUrl);
   }
+  /**
+   * 刷新用户缓存
+   */
+  async refreshUserCache() {
+    await this.userCache.load(async () => {
+      return getUsers({ token: this.token, baseUrl: this.baseUrl });
+    });
+  }
+  /**
+   * 根据用户 ID 获取用户信息
+   */
+  async getUserById(userId) {
+    await this.userCache.ensureLoaded(async () => {
+      return getUsers({ token: this.token, baseUrl: this.baseUrl });
+    });
+    return this.userCache.getById(userId);
+  }
+  /**
+   * 批量根据用户 ID 获取用户信息
+   */
+  async getUserByIds(userIds) {
+    await this.userCache.ensureLoaded(async () => {
+      return getUsers({ token: this.token, baseUrl: this.baseUrl });
+    });
+    return this.userCache.getByIds(userIds);
+  }
+  /**
+   * 根据昵称或别名精确查找用户
+   */
+  async getUserByName(name) {
+    await this.userCache.ensureLoaded(async () => {
+      return getUsers({ token: this.token, baseUrl: this.baseUrl });
+    });
+    return this.userCache.getByName(name);
+  }
+  /**
+   * 根据昵称或别名模糊搜索用户
+   */
+  async searchUserByName(query) {
+    await this.userCache.ensureLoaded(async () => {
+      return getUsers({ token: this.token, baseUrl: this.baseUrl });
+    });
+    return this.userCache.searchByName(query);
+  }
+  /**
+   * 获取缓存用户数
+   */
+  get userCacheSize() {
+    return this.userCache.size;
+  }
   sleep(ms) {
     return new Promise((resolve) => setTimeout(resolve, ms));
   }
@@ -807,6 +1037,4 @@ var MeetBot = class {
 // src/index.ts
 init_error();
 
-export { API, ApiError, CHUNK_RULES, DEFAULT_BASE_URL, HTTP, MeetBot, MeetBotError, NetworkError, POLLING, SESSION_TYPE, TimeoutError, UPLOAD, ValidationError, completeMultipartUpload, computeMD5, getAccessURL, getChunkNum, getConvID, getMultiPartUploadURL, getQuoteMsgKey, getUpdates, getUpdatesV2, getUploadURL, sendMediaMessage, sendMessage, uploadFile };
-//# sourceMappingURL=index.js.map
-//# sourceMappingURL=index.js.map
+export { API, ApiError, CHUNK_RULES, DEFAULT_BASE_URL, HTTP, MeetBot, MeetBotError, NetworkError, POLLING, SESSION_TYPE, TimeoutError, UPLOAD, UserCache, ValidationError, completeMultipartUpload, computeMD5, getAccessURL, getChunkNum, getConvID, getMultiPartUploadURL, getQuoteMsgKey, getUpdates, getUpdatesV2, getUploadURL, getUsers, sendMediaMessage, sendMessage, uploadFile };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@meet-im/meet-bot-jssdk",
-  "version": "1.0.0",
+  "version": "1.1.0",
   "description": "MeetIM Chatbot JavaScript SDK - 支持 Long Polling 消息获取和消息发送",
   "type": "module",
   "main": "./dist/index.cjs",