node-nim 10.4.0-beta.1 → 10.6.0-beta.0

package/types/v2/v2_nim_friend_service.d.ts

@@ -1,6 +1,7 @@
-import { V2NIMFriend, V2NIMFriendAddApplication, V2NIMFriendAddParams, V2NIMFriendDeleteParams, V2NIMFriendSetParams, V2NIMFriendAddApplicationQueryOption, V2NIMFriendAddApplicationResult, V2NIMFriendSearchOption } from 'ts/v2_def/v2_nim_struct_def';
+import { V2NIMFriend, V2NIMFriendAddApplication, V2NIMFriendAddApplicationQueryOption, V2NIMFriendAddApplicationResult, V2NIMFriendAddParams, V2NIMFriendDeleteParams, V2NIMFriendSearchOption, V2NIMFriendSetParams } from 'ts/v2_def/v2_nim_struct_def';
 import { EventEmitter } from 'eventemitter3';
-export declare interface V2NIMFriendServiceEvents {
+import { V2NIMFriendDeletionType } from 'ts/v2_def/v2_nim_enum_def';
+export declare interface V2NIMFriendListener {
     /** 添加好友 */
     friendAdded: [V2NIMFriend];
     /** 删除好友 */
@@ -13,58 +14,158 @@ export declare interface V2NIMFriendServiceEvents {
     friendInfoChanged: [V2NIMFriend];
 }
 /** @brief 好友服务 */
-export declare class V2NIMFriendService extends EventEmitter<V2NIMFriendServiceEvents> {
+export declare class V2NIMFriendService extends EventEmitter<V2NIMFriendListener> {
     instance: any;
     constructor();
-    /** @brief 添加好友 */
-    /** @param accountId 账号 ID */
-    /** @param params 添加好友参数 */
-    /** @return void */
+    /**
+     * @brief 添加好友
+     * @param accountId 账号 ID
+     * @param params 添加好友参数
+     * @returns void
+     * @example
+     * ```javascript
+     * await v2.friendService.addFriend('accountId', {
+     *     addMode: 1
+     * })
+     * ```
+     */
     addFriend(accountId: string, params: V2NIMFriendAddParams): Promise<void>;
-    /** @brief 删除好友 */
-    /** @param accountId 账号 ID */
-    /** @param params 删除好友参数 */
-    /** @return void */
+    /**
+     * @brief 删除好友
+     * @param accountId 账号 ID
+     * @param params 删除好友参数
+     * @returns void
+     * @example
+     * ```javascript
+     * await v2.friendService.deleteFriend('accountId', {
+     *     deleteAlias: true
+     * })
+     * ```
+     */
     deleteFriend(accountId: string, params: V2NIMFriendDeleteParams): Promise<void>;
-    /** @brief 接受好友申请 */
-    /** @param application 好友申请 */
-    /** @return void */
+    /**
+     * @brief 接受好友申请
+     * @param application 好友申请
+     * @returns void
+     * @example
+     * ```javascript
+     * await v2.friendService.acceptAddApplication(application)
+     * ```
+     */
     acceptAddApplication(application: V2NIMFriendAddApplication): Promise<void>;
-    /** @brief 拒绝好友申请 */
-    /** @param application 好友申请 */
-    /** @param postscript 拒绝理由 */
-    /** @return void */
+    /**
+     * @brief 拒绝好友申请
+     * @param application 好友申请
+     * @param postscript 拒绝理由
+     * @returns void
+     * @example
+     * ```javascript
+     * await v2.friendService.rejectAddApplication(application, 'reason')
+     * ```
+     */
     rejectAddApplication(application: V2NIMFriendAddApplication, postscript: String): Promise<void>;
-    /** @brief 设置好友信息 */
-    /** @param accountId 账号 ID */
-    /** @param params 设置好友信息参数 */
-    /** @return void */
+    /**
+     * @brief 设置好友信息
+     * @param accountId 账号 ID
+     * @param params 设置好友信息参数
+     * @returns void
+     * @example
+     * ```javascript
+     * await v2.friendService.setFriendInfo('accountId', {
+     *     alias: 'alias'
+     * })
+     * ```
+     */
     setFriendInfo(accountId: string, params: V2NIMFriendSetParams): Promise<void>;
-    /** @brief 获取好友列表 */
-    /** @return void */
+    /**
+     * @brief 获取好友列表
+     * @returns void
+     * @example
+     * ```javascript
+     * await v2.friendService.getFriendList()
+     * ```
+     */
     getFriendList(): Promise<Array<V2NIMFriend>>;
-    /** @brief 根据账号 ID 获取好友信息 */
-    /** @param accountIds 账号 ID 列表 */
-    /** @return void */
+    /**
+     * @brief 根据账号 ID 获取好友信息
+     * @param accountIds 账号 ID 列表
+     * @returns void
+     * @example
+     * ```javascript
+     * await v2.friendService.getFriendByIds(['accountId1', 'accountId2'])
+     * ```
+     */
     getFriendByIds(accountIds: Array<string>): Promise<Array<V2NIMFriend>>;
-    /** @brief 根据账号 ID 检查好友状态 */
-    /** @param accountIds 账号 ID 列表 */
-    /** @return void */
+    /**
+     * @brief 根据账号 ID 检查好友状态
+     * @param accountIds 账号 ID 列表
+     * @returns void
+     * @example
+     * ```javascript
+     * await v2.friendService.checkFriend(['accountId1', 'accountId2'])
+     * ```
+     */
     checkFriend(accountIds: Array<string>): Promise<Map<string, boolean>>;
-    /** @brief 获取申请添加好友信息列表 */
-    /** @param option 查询申请添加好友相关信息参数 */
-    /** @return void */
+    /**
+     * @brief 获取申请添加好友信息列表
+     * @param option 查询申请添加好友相关信息参数
+     * @returns void
+     * @example
+     * ```javascript
+     * await v2.friendService.getAddApplicationList({
+     *     offset: 0,
+     *     limit: 10
+     * })
+     * ```
+     */
     getAddApplicationList(option: V2NIMFriendAddApplicationQueryOption): Promise<V2NIMFriendAddApplicationResult>;
-    /** @brief 获取申请添加好友未读数量 */
-    /** @return void */
+    /**
+     * @brief 获取申请添加好友未读数量
+     * @returns void
+     * @example
+     * ```javascript
+     * await v2.friendService.getAddApplicationUnreadCount()
+     * ```
+     */
     getAddApplicationUnreadCount(): Promise<number>;
-    /** @brief 设置申请添加好友已读 */
-    /** @return void */
+    /**
+     * @brief 设置申请添加好友已读
+     * @returns void
+     * @example
+     * ```javascript
+     * await v2.friendService.setAddApplicationRead()
+     * ```
+     */
     setAddApplicationRead(): Promise<void>;
     /**
-     * 根据关键字搜索用户信息
+     * @brief 根据关键字搜索用户信息
      * @param option 搜索选项 @see V2NIMFriendSearchOption
-     * @return Promise<Array<V2NIMFriend>>
+     * @returns Promise<Array<V2NIMFriend>>
+     * @example
+     * ```javascript
+     * await v2.friendService.searchFriendByOption({
+     *     keyword: 'keyword'
+     * })
+     * ```
      */
     searchFriendByOption(option: V2NIMFriendSearchOption): Promise<Array<V2NIMFriend>>;
+    /**
+     * @brief 清空所有添加好友申请
+     * @returns Promise<void>
+     * @example
+     * ```javascript
+     * await v2.friendService.clearAllAddApplication()
+     * ```
+     */
+    clearAllAddApplication(): Promise<void>;
+    /**
+     * @brief 删除添加好友申请
+     * @param application 添加好友申请
+     * @returns Promise<void>
+     * @example
+     * ```javascript
+     * await v2.friendService.deleteAddApplication(application)
+     * ```
+     */
+    deleteAddApplication(application: V2NIMFriendAddApplication): Promise<void>;
 }

package/types/v2/v2_nim_login_service.d.ts

@@ -1,7 +1,8 @@
 import { V2NIMDataSyncDetail, V2NIMError, V2NIMKickedOfflineDetail, V2NIMLoginClient, V2NIMLoginOption } from 'ts/v2_def/v2_nim_struct_def';
 import { EventEmitter } from 'eventemitter3';
 import { V2NIMReconnectDelayProvider } from 'ts/v2_def/v2_nim_callback_def';
-export declare interface V2NIMLoginServiceEvents {
+import { V2NIMConnectStatus, V2NIMDataSyncState, V2NIMDataSyncType, V2NIMLoginClientChange, V2NIMLoginStatus } from 'ts/v2_def/v2_nim_enum_def';
+export declare interface V2NIMLoginListener {
     /** 登录状态变更回调 */
     loginStatus: [V2NIMLoginStatus];
     /** 登录失败回调 */
@@ -19,62 +20,122 @@ export declare interface V2NIMLoginServiceEvents {
     /** 数据同步回调 */
     dataSync: [V2NIMDataSyncType, V2NIMDataSyncState, V2NIMError | null];
 }
-export declare class V2NIMLoginService extends EventEmitter<V2NIMLoginServiceEvents> {
+export declare class V2NIMLoginService extends EventEmitter<V2NIMLoginListener> {
     instance: any;
     constructor();
     /**
-     * 登录接口
+     * @brief 登录接口
      * @param accountId 账号
      * @param token 密码
      * @param option 登录选项
      * @returns Promise<void>
+     * @example
+     * ```javascript
+     * await v2.loginService.login('accountId', 'token', {})
+     * ```
      */
     login(accountId: string, token: string, option: V2NIMLoginOption): Promise<void>;
     /**
-     * 登出接口
+     * @brief 登出接口
      * @returns Promise<void>
+     * @example
+     * ```javascript
+     * await v2.loginService.logout()
+     * ```
      */
     logout(): Promise<void>;
     /**
-     * 获取当前登录用户
+     * @brief 获取当前登录用户
      * @returns string 当前登录用户
+     * @example
+     * ```javascript
+     * const user = v2.loginService.getLoginUser()
+     * ```
      */
     getLoginUser(): string;
     /**
-     * 获取登录状态
+     * @brief 获取登录状态
      * @returns V2NIMLoginStatus 登录状态
+     * @example
+     * ```javascript
+     * const status = v2.loginService.getLoginStatus()
+     * ```
      */
     getLoginStatus(): V2NIMLoginStatus;
     /**
-     * 获取登录客户端列表
+     * @brief 获取登录客户端列表
      * @returns V2NIMLoginClient[] 登录客户端列表
+     * @example
+     * ```javascript
+     * const clients = v2.loginService.getLoginClients()
+     * ```
      */
     getLoginClients(): V2NIMLoginClient[];
     /**
-     * 踢掉登录客户端下线
+     * @brief 获取当前登录客户端
+     * @returns V2NIMLoginClient 当前登录客户端
+     * @example
+     * ```javascript
+     * const client = v2.loginService.getCurrentLoginClient()
+     * ```
+     */
+    getCurrentLoginClient(): V2NIMLoginClient;
+    /**
+     * @brief 踢掉登录客户端下线
      * @param client 登录客户端
      * @returns Promise<void>
+     * @example
+     * ```javascript
+     * const otherClients = v2.loginService.getLoginClients()
+     * await v2.loginService.kickOffline(otherClients[0])
+     * ```
      */
     kickOffline(client: V2NIMLoginClient): Promise<void>;
     /**
-     * 获取被踢下线原因
+     * @brief 获取被踢下线原因
      * @returns V2NIMKickedOfflineDetail 被踢下线原因
+     * @example
+     * ```javascript
+     * const detail = v2.loginService.getKickedOfflineDetail()
+     * ```
      */
     getKickedOfflineDetail(): V2NIMKickedOfflineDetail;
+    /**
+     * @brief 获取连接状态
+     * @returns V2NIMConnectStatus 连接状态
+     * @example
+     * ```javascript
+     * const status = v2.loginService.getConnectStatus()
+     * ```
+     */
     getConnectStatus(): V2NIMConnectStatus;
     /**
-     * 获取数据同步状态
+     * @brief 获取数据同步状态
      * @returns V2NIMDataSyncDetail[]  数据同步状态列表
+     * @example
+     * ```javascript
+     * const details = v2.loginService.getDataSync()
+     * ```
      */
     getDataSync(): V2NIMDataSyncDetail[];
-    /** @brief 获取聊天室 link 地址 */
-    /** @param roomId 聊天室 ID */
-    /** @return void */
+    /**
+     * @brief 获取聊天室 link 地址
+     * @param roomId 聊天室 ID
+     * @returns Promise<Array<string>>
+     * @example
+     * ```javascript
+     * const linkAddresses = await v2.loginService.getChatroomLinkAddress('roomId')
+     * ```
+     */
     getChatroomLinkAddress(roomId: string): Promise<Array<string>>;
     /**
-     * 设置获取重连延时回调
+     * @brief 设置获取重连延时回调
      * @param provider 获取重连延时回调
      * @returns void
+     * @example
+     * ```javascript
+     * v2.loginService.setReconnectDelayProvider(provider)
+     * ```
      */
     setReconnectDelayProvider(provider: V2NIMReconnectDelayProvider): void;
 }