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

package/dist/index.cjs

@@ -231,6 +231,12 @@ function buildUrl(baseUrl, path, pathPrefix, params) {
   }
   return url.toString();
 }
+function sanitizeHeaders(headers) {
+  return {
+    ...headers,
+    Authorization: headers.Authorization ? "Bot ***" : ""
+  };
+}
 async function request(options) {
   const {
     token,
@@ -241,6 +247,7 @@ async function request(options) {
     params,
     body,
     timeout = HTTP.DEFAULT_TIMEOUT,
+    userAgent,
     raw = false
   } = options;
   validateToken(token);
@@ -252,7 +259,11 @@ async function request(options) {
     Accept: "application/json",
     Authorization: `Bot ${extractBotToken(token)}`
   };
+  if (userAgent) {
+    headers["User-Agent"] = userAgent;
+  }
   logger.info("[Request]", method, url);
+  logger.info("[Headers]", JSON.stringify(sanitizeHeaders(headers)));
   if (body) {
     logger.info("[Body]", JSON.stringify(body));
   }
@@ -350,10 +361,11 @@ function mapStatusCodeToErrorCode(status) {
 
 // src/api/file.ts
 async function getUploadURL(params) {
-  const { token, baseUrl, ...body } = params;
+  const { token, baseUrl, userAgent, ...body } = params;
   return request({
     token,
     baseUrl,
+    userAgent,
     method: "POST",
     path: "getUploadURL",
     body: {
@@ -371,10 +383,11 @@ async function getUploadURL(params) {
   });
 }
 async function getMultiPartUploadURL(params) {
-  const { token, baseUrl, ...body } = params;
+  const { token, baseUrl, userAgent, ...body } = params;
   return request({
     token,
     baseUrl,
+    userAgent,
     method: "POST",
     path: "getMultiPartUploadURL",
     body: {
@@ -390,10 +403,11 @@ async function getMultiPartUploadURL(params) {
   });
 }
 async function completeMultipartUpload(params) {
-  const { token, baseUrl, ...body } = params;
+  const { token, baseUrl, userAgent, ...body } = params;
   return request({
     token,
     baseUrl,
+    userAgent,
     method: "POST",
     path: "completeMultipartUpload",
     body: {
@@ -405,10 +419,11 @@ async function completeMultipartUpload(params) {
   });
 }
 async function getAccessURL(params) {
-  const { token, baseUrl, ...queryParams } = params;
+  const { token, baseUrl, userAgent, ...queryParams } = params;
   return request({
     token,
     baseUrl,
+    userAgent,
     method: "GET",
     path: "getAccessURL",
     params: {
@@ -486,21 +501,22 @@ function formatSpeed(bytesPerSecond) {
     return `${(bytesPerSecond / 1024 / 1024).toFixed(2)}MB/s`;
   }
 }
-async function uploadFile(token, buffer, options, baseUrl) {
+async function uploadFile(token, buffer, options, baseUrl, userAgent) {
   const { fileName, contentType, onProgress } = options;
   const size = buffer.length;
   const md5 = await computeMD5(buffer);
   logger.info(`[uploadFile] Starting upload: ${fileName}, size: ${size}, md5: ${md5}`);
   if (size < UPLOAD.MULTIPART_THRESHOLD) {
-    return uploadSingleFile(token, buffer, fileName, contentType, md5, baseUrl, onProgress);
+    return uploadSingleFile(token, buffer, fileName, contentType, md5, baseUrl, userAgent, onProgress);
   } else {
-    return uploadMultipartFile(token, buffer, fileName, contentType, md5, baseUrl, onProgress);
+    return uploadMultipartFile(token, buffer, fileName, contentType, md5, baseUrl, userAgent, onProgress);
   }
 }
-async function uploadSingleFile(token, buffer, fileName, contentType, md5, baseUrl, onProgress) {
+async function uploadSingleFile(token, buffer, fileName, contentType, md5, baseUrl, userAgent, onProgress) {
   const result = await getUploadURL({
     token,
     baseUrl,
+    userAgent,
     originFileName: fileName,
     contentType,
     md5,
@@ -513,13 +529,14 @@ async function uploadSingleFile(token, buffer, fileName, contentType, md5, baseU
   const ossResult = await uploadToOSS(result.signedUrl, buffer, contentType, result.callback || "", onProgress);
   return { fileID: ossResult.id, path: ossResult.path, size: ossResult.size };
 }
-async function uploadMultipartFile(token, buffer, fileName, contentType, md5, baseUrl, onProgress) {
+async function uploadMultipartFile(token, buffer, fileName, contentType, md5, baseUrl, userAgent, onProgress) {
   const size = buffer.length;
   const chunkNum = getChunkNum(size);
   logger.info(`[uploadMultipartFile] Starting multipart upload: ${chunkNum} chunks`);
   const result = await getMultiPartUploadURL({
     token,
     baseUrl,
+    userAgent,
     originFileName: fileName,
     contentType,
     md5,
@@ -567,6 +584,7 @@ async function uploadMultipartFile(token, buffer, fileName, contentType, md5, ba
   const complete = await completeMultipartUpload({
     token,
     baseUrl,
+    userAgent,
     originFileName: fileName,
     md5,
     UploadParts: uploadParts
@@ -574,13 +592,14 @@ async function uploadMultipartFile(token, buffer, fileName, contentType, md5, ba
   logger.info(`[uploadMultipartFile] Upload complete: ${complete.ID}`);
   return { fileID: complete.ID, path: complete.path, size };
 }
-async function sendMediaMessage(token, sessionInfo, options, baseUrl) {
+async function sendMediaMessage(token, sessionInfo, options, baseUrl, userAgent) {
   const { buffer, fileName, contentType, content, onProgress } = options;
-  const { fileID, path } = await uploadFile(token, buffer, { fileName, contentType, onProgress }, baseUrl);
+  const { fileID, path } = await uploadFile(token, buffer, { fileName, contentType, onProgress }, baseUrl, userAgent);
   logger.info(`[sendMediaMessage] fileID=${fileID}, path=${path}`);
   return sendMessage({
     token,
     baseUrl,
+    userAgent,
     sessionInfo,
     msgContent: {
       content: content || "",
@@ -599,10 +618,11 @@ async function sendMediaMessage(token, sessionInfo, options, baseUrl) {
 
 // src/api/user.ts
 async function getUsers(params) {
-  const { token, baseUrl } = params;
+  const { token, baseUrl, userAgent } = params;
   const result = await request({
     token,
     baseUrl,
+    userAgent,
     method: "POST",
     path: "general/SyncCompanyUser",
     pathPrefix: "/",
@@ -618,10 +638,11 @@ async function getUsers(params) {
 
 // src/api/index.ts
 async function getUpdates(params) {
-  const { token, baseUrl, timeout = API.DEFAULT_TIMEOUT, offset, limit = API.DEFAULT_LIMIT } = params;
+  const { token, baseUrl, userAgent, timeout = API.DEFAULT_TIMEOUT, offset, limit = API.DEFAULT_LIMIT } = params;
   return request({
     token,
     baseUrl,
+    userAgent,
     method: "POST",
     path: "getUpdates",
     body: {
@@ -633,10 +654,11 @@ async function getUpdates(params) {
   });
 }
 async function getUpdatesV2(params) {
-  const { token, baseUrl, timeout = API.DEFAULT_TIMEOUT, limit = API.DEFAULT_LIMIT } = params;
+  const { token, baseUrl, userAgent, timeout = API.DEFAULT_TIMEOUT, limit = API.DEFAULT_LIMIT } = params;
   return request({
     token,
     baseUrl,
+    userAgent,
     method: "POST",
     path: "getUpdatesV2",
     body: {
@@ -647,7 +669,7 @@ async function getUpdatesV2(params) {
   });
 }
 async function sendMessage(params) {
-  const { token, baseUrl, sessionInfo, msgContent } = params;
+  const { token, baseUrl, userAgent, sessionInfo, msgContent } = params;
   const hasContent = msgContent.content && msgContent.content.trim() !== "";
   const hasAttachment = msgContent.extraInfo?.attechmentInfo || msgContent.extraInfo?.attechmentInfos && msgContent.extraInfo.attechmentInfos.length > 0;
   if (!hasContent && !hasAttachment) {
@@ -657,6 +679,7 @@ async function sendMessage(params) {
   return request({
     token,
     baseUrl,
+    userAgent,
     method: "POST",
     path: "sendMessage",
     body: {
@@ -783,6 +806,7 @@ var MeetBot = class {
   pollingLimit;
   longPollingTimeout;
   useV2;
+  userAgent;
   eventHandlers = /* @__PURE__ */ new Map();
   polling = false;
   offset = 0;
@@ -803,6 +827,7 @@ var MeetBot = class {
     this.pollingLimit = config.pollingLimit ?? POLLING.DEFAULT_LIMIT;
     this.longPollingTimeout = config.longPollingTimeout ?? POLLING.DEFAULT_TIMEOUT;
     this.useV2 = config.useV2 ?? false;
+    this.userAgent = config.userAgent;
     this.userCache = new UserCache(config.userCacheOptions);
     logger.setLevel(config.logLevel ?? "silent");
   }
@@ -855,6 +880,7 @@ var MeetBot = class {
           const result = await getUpdatesV2({
             token: this.token,
             baseUrl: this.baseUrl,
+            userAgent: this.userAgent,
             timeout,
             limit
           });
@@ -868,6 +894,7 @@ var MeetBot = class {
           const updates = await getUpdates({
             token: this.token,
             baseUrl: this.baseUrl,
+            userAgent: this.userAgent,
             timeout,
             offset: this.offset,
             limit
@@ -907,6 +934,7 @@ var MeetBot = class {
     return getUpdates({
       token: this.token,
       baseUrl: this.baseUrl,
+      userAgent: this.userAgent,
       ...options
     });
   }
@@ -914,6 +942,7 @@ var MeetBot = class {
     return getUpdatesV2({
       token: this.token,
       baseUrl: this.baseUrl,
+      userAgent: this.userAgent,
       ...options
     });
   }
@@ -921,6 +950,7 @@ var MeetBot = class {
     return sendMessage({
       token: this.token,
       baseUrl: this.baseUrl,
+      userAgent: this.userAgent,
       sessionInfo,
       msgContent
     });
@@ -932,6 +962,7 @@ var MeetBot = class {
     return getUploadURL({
       token: this.token,
       baseUrl: this.baseUrl,
+      userAgent: this.userAgent,
       ...params
     });
   }
@@ -942,6 +973,7 @@ var MeetBot = class {
     return getMultiPartUploadURL({
       token: this.token,
       baseUrl: this.baseUrl,
+      userAgent: this.userAgent,
       ...params
     });
   }
@@ -952,6 +984,7 @@ var MeetBot = class {
     return completeMultipartUpload({
       token: this.token,
       baseUrl: this.baseUrl,
+      userAgent: this.userAgent,
       ...params
     });
   }
@@ -970,6 +1003,7 @@ var MeetBot = class {
     return getAccessURL({
       token: this.token,
       baseUrl: this.baseUrl,
+      userAgent: this.userAgent,
       ...apiParams
     });
   }
@@ -977,20 +1011,20 @@ var MeetBot = class {
    * 上传文件（自动选择单文件或分片上传）
    */
   async uploadFile(buffer, options) {
-    return uploadFile(this.token, buffer, options, this.baseUrl);
+    return uploadFile(this.token, buffer, options, this.baseUrl, this.userAgent);
   }
   /**
    * 发送媒体消息（上传并发送）
    */
   async sendMedia(sessionInfo, options) {
-    return sendMediaMessage(this.token, sessionInfo, options, this.baseUrl);
+    return sendMediaMessage(this.token, sessionInfo, options, this.baseUrl, this.userAgent);
   }
   /**
    * 刷新用户缓存
    */
   async refreshUserCache() {
     await this.userCache.load(async () => {
-      return getUsers({ token: this.token, baseUrl: this.baseUrl });
+      return getUsers({ token: this.token, baseUrl: this.baseUrl, userAgent: this.userAgent });
     });
   }
   /**
@@ -998,7 +1032,7 @@ var MeetBot = class {
    */
   async getUserById(userId) {
     await this.userCache.ensureLoaded(async () => {
-      return getUsers({ token: this.token, baseUrl: this.baseUrl });
+      return getUsers({ token: this.token, baseUrl: this.baseUrl, userAgent: this.userAgent });
     });
     return this.userCache.getById(userId);
   }
@@ -1007,7 +1041,7 @@ var MeetBot = class {
    */
   async getUserByIds(userIds) {
     await this.userCache.ensureLoaded(async () => {
-      return getUsers({ token: this.token, baseUrl: this.baseUrl });
+      return getUsers({ token: this.token, baseUrl: this.baseUrl, userAgent: this.userAgent });
     });
     return this.userCache.getByIds(userIds);
   }
@@ -1016,7 +1050,7 @@ var MeetBot = class {
    */
   async getUserByName(name) {
     await this.userCache.ensureLoaded(async () => {
-      return getUsers({ token: this.token, baseUrl: this.baseUrl });
+      return getUsers({ token: this.token, baseUrl: this.baseUrl, userAgent: this.userAgent });
     });
     return this.userCache.getByName(name);
   }
@@ -1025,7 +1059,7 @@ var MeetBot = class {
    */
   async searchUserByName(query) {
     await this.userCache.ensureLoaded(async () => {
-      return getUsers({ token: this.token, baseUrl: this.baseUrl });
+      return getUsers({ token: this.token, baseUrl: this.baseUrl, userAgent: this.userAgent });
     });
     return this.userCache.searchByName(query);
   }

package/dist/index.d.cts

@@ -91,6 +91,7 @@ interface MeetBotConfig {
     longPollingTimeout?: number;
     logLevel?: LogLevel;
     useV2?: boolean;
+    userAgent?: string;
 }
 interface GetUpdatesOptions {
     token: string;
@@ -310,6 +311,7 @@ declare class MeetBot {
     private readonly pollingLimit;
     private readonly longPollingTimeout;
     private readonly useV2;
+    private readonly userAgent?;
     private readonly eventHandlers;
     private polling;
     private offset;
@@ -352,36 +354,42 @@ declare class MeetBot {
 interface GetUploadURLApiParams extends GetUploadURLParams {
     token: string;
     baseUrl?: string;
+    userAgent?: string;
 }
 declare function getUploadURL(params: GetUploadURLApiParams): Promise<UploadURLResult>;
 interface GetMultiPartUploadURLApiParams extends GetMultiPartUploadURLParams {
     token: string;
     baseUrl?: string;
+    userAgent?: string;
 }
 declare function getMultiPartUploadURL(params: GetMultiPartUploadURLApiParams): Promise<MultiPartUploadURLResult>;
 interface CompleteMultipartUploadApiParams extends CompleteMultipartUploadParams {
     token: string;
     baseUrl?: string;
+    userAgent?: string;
 }
 declare function completeMultipartUpload(params: CompleteMultipartUploadApiParams): Promise<CompleteMultipartUploadResult>;
 interface GetAccessURLApiParams extends GetAccessURLParams {
     token: string;
     baseUrl?: string;
+    userAgent?: string;
 }
 declare function getAccessURL(params: GetAccessURLApiParams): Promise<AccessURLResult>;
 
 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 uploadFile(token: string, buffer: Buffer, options: UploadFileOptions, baseUrl?: string, userAgent?: string): Promise<UploadFileResult>;
+declare function sendMediaMessage(token: string, sessionInfo: SessionInfo, options: SendMediaOptions, baseUrl?: string, userAgent?: string): Promise<SendMessageResult>;
 
 declare function getUsers(params: {
     token: string;
     baseUrl?: string;
+    userAgent?: string;
 }): Promise<MeetUser[]>;
 
 interface GetUpdatesParams {
     token: string;
     baseUrl?: string;
+    userAgent?: string;
     timeout?: number;
     offset?: number;
     limit?: number;
@@ -390,6 +398,7 @@ declare function getUpdates(params: GetUpdatesParams): Promise<BotUpdate[]>;
 interface GetUpdatesV2Params {
     token: string;
     baseUrl?: string;
+    userAgent?: string;
     timeout?: number;
     limit?: number;
 }
@@ -397,6 +406,7 @@ declare function getUpdatesV2(params: GetUpdatesV2Params): Promise<GetUpdatesV2R
 interface SendMessageParams {
     token: string;
     baseUrl?: string;
+    userAgent?: string;
     sessionInfo: SessionInfo;
     msgContent: MsgContent;
 }

package/dist/index.d.ts

@@ -91,6 +91,7 @@ interface MeetBotConfig {
     longPollingTimeout?: number;
     logLevel?: LogLevel;
     useV2?: boolean;
+    userAgent?: string;
 }
 interface GetUpdatesOptions {
     token: string;
@@ -310,6 +311,7 @@ declare class MeetBot {
     private readonly pollingLimit;
     private readonly longPollingTimeout;
     private readonly useV2;
+    private readonly userAgent?;
     private readonly eventHandlers;
     private polling;
     private offset;
@@ -352,36 +354,42 @@ declare class MeetBot {
 interface GetUploadURLApiParams extends GetUploadURLParams {
     token: string;
     baseUrl?: string;
+    userAgent?: string;
 }
 declare function getUploadURL(params: GetUploadURLApiParams): Promise<UploadURLResult>;
 interface GetMultiPartUploadURLApiParams extends GetMultiPartUploadURLParams {
     token: string;
     baseUrl?: string;
+    userAgent?: string;
 }
 declare function getMultiPartUploadURL(params: GetMultiPartUploadURLApiParams): Promise<MultiPartUploadURLResult>;
 interface CompleteMultipartUploadApiParams extends CompleteMultipartUploadParams {
     token: string;
     baseUrl?: string;
+    userAgent?: string;
 }
 declare function completeMultipartUpload(params: CompleteMultipartUploadApiParams): Promise<CompleteMultipartUploadResult>;
 interface GetAccessURLApiParams extends GetAccessURLParams {
     token: string;
     baseUrl?: string;
+    userAgent?: string;
 }
 declare function getAccessURL(params: GetAccessURLApiParams): Promise<AccessURLResult>;
 
 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 uploadFile(token: string, buffer: Buffer, options: UploadFileOptions, baseUrl?: string, userAgent?: string): Promise<UploadFileResult>;
+declare function sendMediaMessage(token: string, sessionInfo: SessionInfo, options: SendMediaOptions, baseUrl?: string, userAgent?: string): Promise<SendMessageResult>;
 
 declare function getUsers(params: {
     token: string;
     baseUrl?: string;
+    userAgent?: string;
 }): Promise<MeetUser[]>;
 
 interface GetUpdatesParams {
     token: string;
     baseUrl?: string;
+    userAgent?: string;
     timeout?: number;
     offset?: number;
     limit?: number;
@@ -390,6 +398,7 @@ declare function getUpdates(params: GetUpdatesParams): Promise<BotUpdate[]>;
 interface GetUpdatesV2Params {
     token: string;
     baseUrl?: string;
+    userAgent?: string;
     timeout?: number;
     limit?: number;
 }
@@ -397,6 +406,7 @@ declare function getUpdatesV2(params: GetUpdatesV2Params): Promise<GetUpdatesV2R
 interface SendMessageParams {
     token: string;
     baseUrl?: string;
+    userAgent?: string;
     sessionInfo: SessionInfo;
     msgContent: MsgContent;
 }

package/dist/index.js

@@ -225,6 +225,12 @@ function buildUrl(baseUrl, path, pathPrefix, params) {
   }
   return url.toString();
 }
+function sanitizeHeaders(headers) {
+  return {
+    ...headers,
+    Authorization: headers.Authorization ? "Bot ***" : ""
+  };
+}
 async function request(options) {
   const {
     token,
@@ -235,6 +241,7 @@ async function request(options) {
     params,
     body,
     timeout = HTTP.DEFAULT_TIMEOUT,
+    userAgent,
     raw = false
   } = options;
   validateToken(token);
@@ -246,7 +253,11 @@ async function request(options) {
     Accept: "application/json",
     Authorization: `Bot ${extractBotToken(token)}`
   };
+  if (userAgent) {
+    headers["User-Agent"] = userAgent;
+  }
   logger.info("[Request]", method, url);
+  logger.info("[Headers]", JSON.stringify(sanitizeHeaders(headers)));
   if (body) {
     logger.info("[Body]", JSON.stringify(body));
   }
@@ -344,10 +355,11 @@ function mapStatusCodeToErrorCode(status) {
 
 // src/api/file.ts
 async function getUploadURL(params) {
-  const { token, baseUrl, ...body } = params;
+  const { token, baseUrl, userAgent, ...body } = params;
   return request({
     token,
     baseUrl,
+    userAgent,
     method: "POST",
     path: "getUploadURL",
     body: {
@@ -365,10 +377,11 @@ async function getUploadURL(params) {
   });
 }
 async function getMultiPartUploadURL(params) {
-  const { token, baseUrl, ...body } = params;
+  const { token, baseUrl, userAgent, ...body } = params;
   return request({
     token,
     baseUrl,
+    userAgent,
     method: "POST",
     path: "getMultiPartUploadURL",
     body: {
@@ -384,10 +397,11 @@ async function getMultiPartUploadURL(params) {
   });
 }
 async function completeMultipartUpload(params) {
-  const { token, baseUrl, ...body } = params;
+  const { token, baseUrl, userAgent, ...body } = params;
   return request({
     token,
     baseUrl,
+    userAgent,
     method: "POST",
     path: "completeMultipartUpload",
     body: {
@@ -399,10 +413,11 @@ async function completeMultipartUpload(params) {
   });
 }
 async function getAccessURL(params) {
-  const { token, baseUrl, ...queryParams } = params;
+  const { token, baseUrl, userAgent, ...queryParams } = params;
   return request({
     token,
     baseUrl,
+    userAgent,
     method: "GET",
     path: "getAccessURL",
     params: {
@@ -480,21 +495,22 @@ function formatSpeed(bytesPerSecond) {
     return `${(bytesPerSecond / 1024 / 1024).toFixed(2)}MB/s`;
   }
 }
-async function uploadFile(token, buffer, options, baseUrl) {
+async function uploadFile(token, buffer, options, baseUrl, userAgent) {
   const { fileName, contentType, onProgress } = options;
   const size = buffer.length;
   const md5 = await computeMD5(buffer);
   logger.info(`[uploadFile] Starting upload: ${fileName}, size: ${size}, md5: ${md5}`);
   if (size < UPLOAD.MULTIPART_THRESHOLD) {
-    return uploadSingleFile(token, buffer, fileName, contentType, md5, baseUrl, onProgress);
+    return uploadSingleFile(token, buffer, fileName, contentType, md5, baseUrl, userAgent, onProgress);
   } else {
-    return uploadMultipartFile(token, buffer, fileName, contentType, md5, baseUrl, onProgress);
+    return uploadMultipartFile(token, buffer, fileName, contentType, md5, baseUrl, userAgent, onProgress);
   }
 }
-async function uploadSingleFile(token, buffer, fileName, contentType, md5, baseUrl, onProgress) {
+async function uploadSingleFile(token, buffer, fileName, contentType, md5, baseUrl, userAgent, onProgress) {
   const result = await getUploadURL({
     token,
     baseUrl,
+    userAgent,
     originFileName: fileName,
     contentType,
     md5,
@@ -507,13 +523,14 @@ async function uploadSingleFile(token, buffer, fileName, contentType, md5, baseU
   const ossResult = await uploadToOSS(result.signedUrl, buffer, contentType, result.callback || "", onProgress);
   return { fileID: ossResult.id, path: ossResult.path, size: ossResult.size };
 }
-async function uploadMultipartFile(token, buffer, fileName, contentType, md5, baseUrl, onProgress) {
+async function uploadMultipartFile(token, buffer, fileName, contentType, md5, baseUrl, userAgent, onProgress) {
   const size = buffer.length;
   const chunkNum = getChunkNum(size);
   logger.info(`[uploadMultipartFile] Starting multipart upload: ${chunkNum} chunks`);
   const result = await getMultiPartUploadURL({
     token,
     baseUrl,
+    userAgent,
     originFileName: fileName,
     contentType,
     md5,
@@ -561,6 +578,7 @@ async function uploadMultipartFile(token, buffer, fileName, contentType, md5, ba
   const complete = await completeMultipartUpload({
     token,
     baseUrl,
+    userAgent,
     originFileName: fileName,
     md5,
     UploadParts: uploadParts
@@ -568,13 +586,14 @@ async function uploadMultipartFile(token, buffer, fileName, contentType, md5, ba
   logger.info(`[uploadMultipartFile] Upload complete: ${complete.ID}`);
   return { fileID: complete.ID, path: complete.path, size };
 }
-async function sendMediaMessage(token, sessionInfo, options, baseUrl) {
+async function sendMediaMessage(token, sessionInfo, options, baseUrl, userAgent) {
   const { buffer, fileName, contentType, content, onProgress } = options;
-  const { fileID, path } = await uploadFile(token, buffer, { fileName, contentType, onProgress }, baseUrl);
+  const { fileID, path } = await uploadFile(token, buffer, { fileName, contentType, onProgress }, baseUrl, userAgent);
   logger.info(`[sendMediaMessage] fileID=${fileID}, path=${path}`);
   return sendMessage({
     token,
     baseUrl,
+    userAgent,
     sessionInfo,
     msgContent: {
       content: content || "",
@@ -593,10 +612,11 @@ async function sendMediaMessage(token, sessionInfo, options, baseUrl) {
 
 // src/api/user.ts
 async function getUsers(params) {
-  const { token, baseUrl } = params;
+  const { token, baseUrl, userAgent } = params;
   const result = await request({
     token,
     baseUrl,
+    userAgent,
     method: "POST",
     path: "general/SyncCompanyUser",
     pathPrefix: "/",
@@ -612,10 +632,11 @@ async function getUsers(params) {
 
 // src/api/index.ts
 async function getUpdates(params) {
-  const { token, baseUrl, timeout = API.DEFAULT_TIMEOUT, offset, limit = API.DEFAULT_LIMIT } = params;
+  const { token, baseUrl, userAgent, timeout = API.DEFAULT_TIMEOUT, offset, limit = API.DEFAULT_LIMIT } = params;
   return request({
     token,
     baseUrl,
+    userAgent,
     method: "POST",
     path: "getUpdates",
     body: {
@@ -627,10 +648,11 @@ async function getUpdates(params) {
   });
 }
 async function getUpdatesV2(params) {
-  const { token, baseUrl, timeout = API.DEFAULT_TIMEOUT, limit = API.DEFAULT_LIMIT } = params;
+  const { token, baseUrl, userAgent, timeout = API.DEFAULT_TIMEOUT, limit = API.DEFAULT_LIMIT } = params;
   return request({
     token,
     baseUrl,
+    userAgent,
     method: "POST",
     path: "getUpdatesV2",
     body: {
@@ -641,7 +663,7 @@ async function getUpdatesV2(params) {
   });
 }
 async function sendMessage(params) {
-  const { token, baseUrl, sessionInfo, msgContent } = params;
+  const { token, baseUrl, userAgent, sessionInfo, msgContent } = params;
   const hasContent = msgContent.content && msgContent.content.trim() !== "";
   const hasAttachment = msgContent.extraInfo?.attechmentInfo || msgContent.extraInfo?.attechmentInfos && msgContent.extraInfo.attechmentInfos.length > 0;
   if (!hasContent && !hasAttachment) {
@@ -651,6 +673,7 @@ async function sendMessage(params) {
   return request({
     token,
     baseUrl,
+    userAgent,
     method: "POST",
     path: "sendMessage",
     body: {
@@ -777,6 +800,7 @@ var MeetBot = class {
   pollingLimit;
   longPollingTimeout;
   useV2;
+  userAgent;
   eventHandlers = /* @__PURE__ */ new Map();
   polling = false;
   offset = 0;
@@ -797,6 +821,7 @@ var MeetBot = class {
     this.pollingLimit = config.pollingLimit ?? POLLING.DEFAULT_LIMIT;
     this.longPollingTimeout = config.longPollingTimeout ?? POLLING.DEFAULT_TIMEOUT;
     this.useV2 = config.useV2 ?? false;
+    this.userAgent = config.userAgent;
     this.userCache = new UserCache(config.userCacheOptions);
     logger.setLevel(config.logLevel ?? "silent");
   }
@@ -849,6 +874,7 @@ var MeetBot = class {
           const result = await getUpdatesV2({
             token: this.token,
             baseUrl: this.baseUrl,
+            userAgent: this.userAgent,
             timeout,
             limit
           });
@@ -862,6 +888,7 @@ var MeetBot = class {
           const updates = await getUpdates({
             token: this.token,
             baseUrl: this.baseUrl,
+            userAgent: this.userAgent,
             timeout,
             offset: this.offset,
             limit
@@ -901,6 +928,7 @@ var MeetBot = class {
     return getUpdates({
       token: this.token,
       baseUrl: this.baseUrl,
+      userAgent: this.userAgent,
       ...options
     });
   }
@@ -908,6 +936,7 @@ var MeetBot = class {
     return getUpdatesV2({
       token: this.token,
       baseUrl: this.baseUrl,
+      userAgent: this.userAgent,
       ...options
     });
   }
@@ -915,6 +944,7 @@ var MeetBot = class {
     return sendMessage({
       token: this.token,
       baseUrl: this.baseUrl,
+      userAgent: this.userAgent,
       sessionInfo,
       msgContent
     });
@@ -926,6 +956,7 @@ var MeetBot = class {
     return getUploadURL({
       token: this.token,
       baseUrl: this.baseUrl,
+      userAgent: this.userAgent,
       ...params
     });
   }
@@ -936,6 +967,7 @@ var MeetBot = class {
     return getMultiPartUploadURL({
       token: this.token,
       baseUrl: this.baseUrl,
+      userAgent: this.userAgent,
       ...params
     });
   }
@@ -946,6 +978,7 @@ var MeetBot = class {
     return completeMultipartUpload({
       token: this.token,
       baseUrl: this.baseUrl,
+      userAgent: this.userAgent,
       ...params
     });
   }
@@ -964,6 +997,7 @@ var MeetBot = class {
     return getAccessURL({
       token: this.token,
       baseUrl: this.baseUrl,
+      userAgent: this.userAgent,
       ...apiParams
     });
   }
@@ -971,20 +1005,20 @@ var MeetBot = class {
    * 上传文件（自动选择单文件或分片上传）
    */
   async uploadFile(buffer, options) {
-    return uploadFile(this.token, buffer, options, this.baseUrl);
+    return uploadFile(this.token, buffer, options, this.baseUrl, this.userAgent);
   }
   /**
    * 发送媒体消息（上传并发送）
    */
   async sendMedia(sessionInfo, options) {
-    return sendMediaMessage(this.token, sessionInfo, options, this.baseUrl);
+    return sendMediaMessage(this.token, sessionInfo, options, this.baseUrl, this.userAgent);
   }
   /**
    * 刷新用户缓存
    */
   async refreshUserCache() {
     await this.userCache.load(async () => {
-      return getUsers({ token: this.token, baseUrl: this.baseUrl });
+      return getUsers({ token: this.token, baseUrl: this.baseUrl, userAgent: this.userAgent });
     });
   }
   /**
@@ -992,7 +1026,7 @@ var MeetBot = class {
    */
   async getUserById(userId) {
     await this.userCache.ensureLoaded(async () => {
-      return getUsers({ token: this.token, baseUrl: this.baseUrl });
+      return getUsers({ token: this.token, baseUrl: this.baseUrl, userAgent: this.userAgent });
     });
     return this.userCache.getById(userId);
   }
@@ -1001,7 +1035,7 @@ var MeetBot = class {
    */
   async getUserByIds(userIds) {
     await this.userCache.ensureLoaded(async () => {
-      return getUsers({ token: this.token, baseUrl: this.baseUrl });
+      return getUsers({ token: this.token, baseUrl: this.baseUrl, userAgent: this.userAgent });
     });
     return this.userCache.getByIds(userIds);
   }
@@ -1010,7 +1044,7 @@ var MeetBot = class {
    */
   async getUserByName(name) {
     await this.userCache.ensureLoaded(async () => {
-      return getUsers({ token: this.token, baseUrl: this.baseUrl });
+      return getUsers({ token: this.token, baseUrl: this.baseUrl, userAgent: this.userAgent });
     });
     return this.userCache.getByName(name);
   }
@@ -1019,7 +1053,7 @@ var MeetBot = class {
    */
   async searchUserByName(query) {
     await this.userCache.ensureLoaded(async () => {
-      return getUsers({ token: this.token, baseUrl: this.baseUrl });
+      return getUsers({ token: this.token, baseUrl: this.baseUrl, userAgent: this.userAgent });
     });
     return this.userCache.searchByName(query);
   }

package/package.json

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