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

package/dist/index.d.cts

@@ -26,12 +26,21 @@ interface MsgContent {
     timestamp?: number;
     fromUid?: number;
     atIds?: number[];
+    quoteSeqID?: number;
     extraInfo?: ExtraInfo;
     sessionInfo?: SessionInfo;
 }
 interface BotUpdate {
     message?: MsgContent;
 }
+interface BotMsgUpdate {
+    message: MsgContent;
+}
+type QuoteMsgMap = Record<string, MsgContent>;
+interface GetUpdatesV2Result {
+    msgs: BotMsgUpdate[];
+    quoteMsgMap: QuoteMsgMap;
+}
 interface BotUser {
     id: number;
     name: string;
@@ -81,6 +90,7 @@ interface MeetBotConfig {
     pollingLimit?: number;
     longPollingTimeout?: number;
     logLevel?: LogLevel;
+    useV2?: boolean;
 }
 interface GetUpdatesOptions {
     token: string;
@@ -161,9 +171,14 @@ interface GetAccessURLParams {
     sessionType: number;
     seqId: number;
     fileId: number;
+    companyId?: number;
     'x-oss-process'?: string;
-    origin?: string;
-    bestDomain?: string;
+    printResult?: string;
+}
+interface GetAccessURLBySessionParams {
+    sessionInfo: SessionInfo;
+    seqId: number;
+    fileId: number;
     printResult?: string;
 }
 interface AccessURLResult {
@@ -201,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);
@@ -212,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;
@@ -223,9 +272,34 @@ 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: BotUpdate['message'];
+    message: {
+        message: MsgContent;
+        quoteMsgMap: QuoteMsgMap;
+    };
     error: Error;
     polling_start: void;
     polling_stop: void;
@@ -235,11 +309,15 @@ declare class MeetBot {
     private readonly baseUrl;
     private readonly pollingLimit;
     private readonly longPollingTimeout;
+    private readonly useV2;
     private readonly eventHandlers;
     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;
@@ -251,13 +329,23 @@ declare class MeetBot {
         offset?: number;
         limit?: number;
     }): Promise<BotUpdate[]>;
+    getUpdatesV2(options?: {
+        timeout?: number;
+        limit?: number;
+    }): Promise<GetUpdatesV2Result>;
     sendMessage(sessionInfo: SessionInfo, msgContent: MsgContent): Promise<SendMessageResult>;
     getUploadURL(params: Omit<GetUploadURLParams, 'fileType'>): Promise<UploadURLResult>;
     getMultiPartUploadURL(params: Omit<GetMultiPartUploadURLParams, 'fileType'>): Promise<MultiPartUploadURLResult>;
     completeMultipartUpload(params: CompleteMultipartUploadParams): Promise<CompleteMultipartUploadResult>;
-    getAccessURL(params: GetAccessURLParams): Promise<AccessURLResult>;
+    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;
 }
 
@@ -286,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;
@@ -294,6 +387,13 @@ interface GetUpdatesParams {
     limit?: number;
 }
 declare function getUpdates(params: GetUpdatesParams): Promise<BotUpdate[]>;
+interface GetUpdatesV2Params {
+    token: string;
+    baseUrl?: string;
+    timeout?: number;
+    limit?: number;
+}
+declare function getUpdatesV2(params: GetUpdatesV2Params): Promise<GetUpdatesV2Result>;
 interface SendMessageParams {
     token: string;
     baseUrl?: string;
@@ -339,6 +439,13 @@ declare const CHUNK_RULES: readonly [{
     readonly maxSize: number;
     readonly chunks: 50;
 }];
+declare const SESSION_TYPE: {
+    readonly PRIVATE: 1;
+    readonly GROUP: 3;
+    readonly CHANNEL: 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 BotUpdate, type BotUser, CHUNK_RULES, type ChatType, type CompleteMultipartUploadParams, type CompleteMultipartUploadResult, DEFAULT_BASE_URL, type ErrorCode, type ExtraInfo, type GetAccessURLParams, type GetMultiPartUploadURLParams, type GetUpdatesOptions, type GetUploadURLParams, HTTP, type LogLevel, MeetBot, type MeetBotConfig, MeetBotError, type MsgContent, type MsgType, type MultiPartUploadURLResult, NetworkError, POLLING, type PollingOptions, type ReceivedAttachmentInfo, 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, getMultiPartUploadURL, getUpdates, 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

@@ -26,12 +26,21 @@ interface MsgContent {
     timestamp?: number;
     fromUid?: number;
     atIds?: number[];
+    quoteSeqID?: number;
     extraInfo?: ExtraInfo;
     sessionInfo?: SessionInfo;
 }
 interface BotUpdate {
     message?: MsgContent;
 }
+interface BotMsgUpdate {
+    message: MsgContent;
+}
+type QuoteMsgMap = Record<string, MsgContent>;
+interface GetUpdatesV2Result {
+    msgs: BotMsgUpdate[];
+    quoteMsgMap: QuoteMsgMap;
+}
 interface BotUser {
     id: number;
     name: string;
@@ -81,6 +90,7 @@ interface MeetBotConfig {
     pollingLimit?: number;
     longPollingTimeout?: number;
     logLevel?: LogLevel;
+    useV2?: boolean;
 }
 interface GetUpdatesOptions {
     token: string;
@@ -161,9 +171,14 @@ interface GetAccessURLParams {
     sessionType: number;
     seqId: number;
     fileId: number;
+    companyId?: number;
     'x-oss-process'?: string;
-    origin?: string;
-    bestDomain?: string;
+    printResult?: string;
+}
+interface GetAccessURLBySessionParams {
+    sessionInfo: SessionInfo;
+    seqId: number;
+    fileId: number;
     printResult?: string;
 }
 interface AccessURLResult {
@@ -201,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);
@@ -212,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;
@@ -223,9 +272,34 @@ 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: BotUpdate['message'];
+    message: {
+        message: MsgContent;
+        quoteMsgMap: QuoteMsgMap;
+    };
     error: Error;
     polling_start: void;
     polling_stop: void;
@@ -235,11 +309,15 @@ declare class MeetBot {
     private readonly baseUrl;
     private readonly pollingLimit;
     private readonly longPollingTimeout;
+    private readonly useV2;
     private readonly eventHandlers;
     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;
@@ -251,13 +329,23 @@ declare class MeetBot {
         offset?: number;
         limit?: number;
     }): Promise<BotUpdate[]>;
+    getUpdatesV2(options?: {
+        timeout?: number;
+        limit?: number;
+    }): Promise<GetUpdatesV2Result>;
     sendMessage(sessionInfo: SessionInfo, msgContent: MsgContent): Promise<SendMessageResult>;
     getUploadURL(params: Omit<GetUploadURLParams, 'fileType'>): Promise<UploadURLResult>;
     getMultiPartUploadURL(params: Omit<GetMultiPartUploadURLParams, 'fileType'>): Promise<MultiPartUploadURLResult>;
     completeMultipartUpload(params: CompleteMultipartUploadParams): Promise<CompleteMultipartUploadResult>;
-    getAccessURL(params: GetAccessURLParams): Promise<AccessURLResult>;
+    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;
 }
 
@@ -286,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;
@@ -294,6 +387,13 @@ interface GetUpdatesParams {
     limit?: number;
 }
 declare function getUpdates(params: GetUpdatesParams): Promise<BotUpdate[]>;
+interface GetUpdatesV2Params {
+    token: string;
+    baseUrl?: string;
+    timeout?: number;
+    limit?: number;
+}
+declare function getUpdatesV2(params: GetUpdatesV2Params): Promise<GetUpdatesV2Result>;
 interface SendMessageParams {
     token: string;
     baseUrl?: string;
@@ -339,6 +439,13 @@ declare const CHUNK_RULES: readonly [{
     readonly maxSize: number;
     readonly chunks: 50;
 }];
+declare const SESSION_TYPE: {
+    readonly PRIVATE: 1;
+    readonly GROUP: 3;
+    readonly CHANNEL: 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 BotUpdate, type BotUser, CHUNK_RULES, type ChatType, type CompleteMultipartUploadParams, type CompleteMultipartUploadResult, DEFAULT_BASE_URL, type ErrorCode, type ExtraInfo, type GetAccessURLParams, type GetMultiPartUploadURLParams, type GetUpdatesOptions, type GetUploadURLParams, HTTP, type LogLevel, MeetBot, type MeetBotConfig, MeetBotError, type MsgContent, type MsgType, type MultiPartUploadURLResult, NetworkError, POLLING, type PollingOptions, type ReceivedAttachmentInfo, 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, getMultiPartUploadURL, getUpdates, 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 };