easemob-websdk 5.1.1 → 5.1.2

package/rest/error-maps/contact.d.ts

@@ -13,6 +13,10 @@ export declare const CONTACT_ERROR_MAP: {
                         readonly code: 110;
                         readonly retryable: false;
                     };
+                    readonly cannot_add_self: {
+                        readonly code: 110;
+                        readonly retryable: false;
+                    };
                 };
             };
             readonly errors: {
@@ -60,6 +64,7 @@ export declare const CONTACT_ERROR_MAP: {
                     readonly code: 204;
                     readonly httpStatus: 404;
                     readonly retryable: false;
+                    readonly aliases: readonly ["service_resource_not_found"];
                 };
             };
         };
@@ -114,7 +119,7 @@ export declare const CONTACT_ERROR_MAP: {
             };
         };
         readonly setContactRemark: {
-            readonly range: "4,110,223";
+            readonly range: "4,110,221";
             readonly localErrors: {
                 readonly setContactRemark: {
                     readonly validation_invalid: {
@@ -124,8 +129,8 @@ export declare const CONTACT_ERROR_MAP: {
                 };
             };
             readonly errors: {
-                readonly illegal_argument: {
-                    readonly code: 223;
+                readonly USER_NOT_ON_ROSTER: {
+                    readonly code: 221;
                     readonly httpStatus: 400;
                     readonly retryable: false;
                     readonly matchField: "error_description";

package/rest/error-maps/push.d.ts

@@ -56,7 +56,7 @@ export declare const PUSH_ERROR_MAP: {
             };
         };
         readonly uploadPushToken: {
-            readonly range: "110,1500";
+            readonly range: "110,201,1500";
             readonly localErrors: {
                 readonly uploadPushToken: {
                     readonly validation_invalid: {
@@ -64,6 +64,18 @@ export declare const PUSH_ERROR_MAP: {
                         readonly retryable: false;
                     };
                 };
+                readonly setNativePush: {
+                    readonly validation_invalid: {
+                        readonly code: 110;
+                        readonly retryable: false;
+                    };
+                };
+                readonly removePushToken: {
+                    readonly auth_not_login: {
+                        readonly code: 201;
+                        readonly retryable: false;
+                    };
+                };
             };
             readonly errors: {
                 readonly TOKEN_UPLOAD_FAILED: {

package/rest/error-maps/user-info.d.ts

@@ -2,7 +2,7 @@ export declare const USER_INFO_ERROR_MAP: {
     readonly common: {};
     readonly apis: {
         readonly updateOwnUserInfo: {
-            readonly range: "4,110,204,901";
+            readonly range: "4,110,204,303,505,901";
             readonly localErrors: {
                 readonly updateOwnInfo: {
                     readonly validation_invalid: {
@@ -18,10 +18,26 @@ export declare const USER_INFO_ERROR_MAP: {
                 };
             };
             readonly errors: {
+                readonly service_not_enabled: {
+                    readonly code: 505;
+                    readonly httpStatus: 403;
+                    readonly retryable: false;
+                    readonly matchField: "desc";
+                    readonly matchPattern: "user metadata service not allow";
+                };
                 readonly data_length_exceed: {
                     readonly code: 901;
                     readonly httpStatus: 403;
                     readonly retryable: false;
+                    readonly matchField: "desc";
+                    readonly matchPattern: "exceeds";
+                };
+                readonly concurrent_update_conflict: {
+                    readonly code: 303;
+                    readonly httpStatus: 409;
+                    readonly retryable: true;
+                    readonly matchField: "desc";
+                    readonly matchPattern: "Concurrent";
                 };
                 readonly resource_not_found: {
                     readonly code: 204;
@@ -36,7 +52,7 @@ export declare const USER_INFO_ERROR_MAP: {
             };
         };
         readonly updateOwnInfo: {
-            readonly range: "4,110,204,901";
+            readonly range: "4,110,204,303,505,901";
             readonly localErrors: {
                 readonly updateOwnInfo: {
                     readonly validation_invalid: {
@@ -52,10 +68,26 @@ export declare const USER_INFO_ERROR_MAP: {
                 };
             };
             readonly errors: {
+                readonly service_not_enabled: {
+                    readonly code: 505;
+                    readonly httpStatus: 403;
+                    readonly retryable: false;
+                    readonly matchField: "desc";
+                    readonly matchPattern: "user metadata service not allow";
+                };
                 readonly data_length_exceed: {
                     readonly code: 901;
                     readonly httpStatus: 403;
                     readonly retryable: false;
+                    readonly matchField: "desc";
+                    readonly matchPattern: "exceeds";
+                };
+                readonly concurrent_update_conflict: {
+                    readonly code: 303;
+                    readonly httpStatus: 409;
+                    readonly retryable: true;
+                    readonly matchField: "desc";
+                    readonly matchPattern: "Concurrent";
                 };
                 readonly resource_not_found: {
                     readonly code: 204;
@@ -70,7 +102,7 @@ export declare const USER_INFO_ERROR_MAP: {
             };
         };
         readonly updateOwnInfoByAttribute: {
-            readonly range: "4,110,204,901";
+            readonly range: "4,110,204,303,505,901";
             readonly localErrors: {
                 readonly updateOwnInfo: {
                     readonly validation_invalid: {
@@ -86,10 +118,26 @@ export declare const USER_INFO_ERROR_MAP: {
                 };
             };
             readonly errors: {
+                readonly service_not_enabled: {
+                    readonly code: 505;
+                    readonly httpStatus: 403;
+                    readonly retryable: false;
+                    readonly matchField: "desc";
+                    readonly matchPattern: "user metadata service not allow";
+                };
                 readonly data_length_exceed: {
                     readonly code: 901;
                     readonly httpStatus: 403;
                     readonly retryable: false;
+                    readonly matchField: "desc";
+                    readonly matchPattern: "exceeds";
+                };
+                readonly concurrent_update_conflict: {
+                    readonly code: 303;
+                    readonly httpStatus: 409;
+                    readonly retryable: true;
+                    readonly matchField: "desc";
+                    readonly matchPattern: "Concurrent";
                 };
                 readonly resource_not_found: {
                     readonly code: 204;

package/rest/service-url.d.ts

@@ -0,0 +1,6 @@
+/**
+ * 将 REST 服务地址转换为统一数据同步 WebSocket 地址。
+ *
+ * @internal
+ */
+export declare const deriveSyncWebSocketUrl: (restApiUrl: string) => string;

package/types/chat-client.d.ts

@@ -12,18 +12,14 @@ import type { CreatePlatformAdapterOptions } from '../platform/types';
  */
 export type ConnectionState = ConnectionStatus;
 /**
- * [zh-CN] 固定服务地址配置。
- * [en-US] Fixed service endpoint configuration.
+ * [zh-CN] 固定服务地址配置。同步 REST 请求复用 `restApiUrl`，同步 WebSocket 地址由 SDK 按 `http→ws`、`https→wss` 自动派生为 `<ws|wss>://<REST host[:port]>/ws`。
+ * [en-US] Fixed service endpoint configuration. Sync REST requests reuse `restApiUrl`, and the SDK derives the sync WebSocket URL as `<ws|wss>://<REST host[:port]>/ws`, mapping `http` to `ws` and `https` to `wss`.
  */
 export interface ServerUrlsConfig {
-    /** [zh-CN] REST API 服务的基准地址。 [en-US] The base URL for the REST API service.  */
+    /** [zh-CN] REST API 服务的基准地址；同步 REST 与同步 WebSocket 也统一以此地址为来源。 [en-US] The base URL for REST APIs; sync REST and sync WebSocket endpoints also use this URL as their source. */
     readonly restApiUrl?: string;
-    /** [zh-CN] 消息长连接的 WebSocket 地址。 [en-US] The WebSocket URL for the messaging connection. */
+    /** [zh-CN] 消息长连接的 WebSocket 地址；地址未携带路径或仅携带根路径 `/` 时，SDK 会自动补齐 `/websocket`，其他显式路径保持不变。 [en-US] The WebSocket URL for the messaging connection. The SDK appends `/websocket` only when the URL has no path or only the root path `/`; other explicit paths are preserved. */
     readonly wsUrl?: string;
-    /** [zh-CN] 会话与好友同步 REST API 服务的基准地址。  [en-US] The base URL for the conversation and friend synchronization REST API service.  */
-    readonly syncRestApiUrl?: string;
-    /** [zh-CN] 会话与好友同步长连接的 WebSocket 地址。  [en-US] The WebSocket URL for the conversation and friend synchronization connection.  */
-    readonly syncWsUrl?: string;
 }
 /**
  * [zh-CN] 服务接入配置。
@@ -140,6 +136,17 @@ export interface AuthContext {
     /** [zh-CN] IM 登录 token。 [en-US] IM login token. */
     token: string;
 }
+/**
+ * [zh-CN] 单次登录选项。
+ * [en-US] Options for a single login operation.
+ */
+export interface LoginOptions {
+    /**
+     * [zh-CN] 首次登录端到端总超时，单位毫秒；默认 30000，允许范围 5000～120000。该值不影响登录成功后的断线重连。
+     * [en-US] End-to-end timeout for the initial login in milliseconds. Defaults to 30000 and accepts 5000–120000. It does not affect reconnection after login succeeds.
+     */
+    readonly timeoutMs?: number;
+}
 /**
  * [zh-CN] IM token 续期结果。
  * [en-US] IM token renewal result.
@@ -234,7 +241,7 @@ export interface DnsConfig {
     'msync-wx': {
         hosts: DnsHost[];
     };
-    /** [zh-CN] 会话/联系人同步 WebSocket 地址集合。 [en-US] Session/contact sync WebSocket host set. */
+    /** [zh-CN] 历史会话/联系人同步 WebSocket 地址集合；仅为 DNS 响应结构兼容保留，不参与端点选择。 [en-US] Legacy session/contact sync WebSocket host set retained only for DNS response compatibility; it is not used for endpoint selection. */
     'sync-ws'?: {
         hosts: DnsHost[];
     };

package/types/chatroom.d.ts

@@ -99,32 +99,6 @@ export interface ChatRoomListResult {
      */
     readonly hasMore?: boolean;
 }
-/**
- * [zh-CN] 当前用户在聊天室中的状态。
- * [en-US] Status of the current user in the chat room.
- */
-export interface ChatRoomCurrentUserStatus {
-    /**
-     * [zh-CN] 当前用户是否在白名单中。
-     * [en-US] Whether the current user is in the allow list.
-     */
-    readonly inAllowlist?: boolean;
-    /**
-     * [zh-CN] 当前用户是否处于禁言状态。
-     * [en-US] Whether the current user is muted.
-     */
-    readonly muted?: boolean;
-    /**
-     * [zh-CN] 当前用户的禁言到期时间。
-     * [en-US] Mute expiration time of the current user.
-     */
-    readonly muteExpireAt?: number;
-    /**
-     * [zh-CN] 当前用户在聊天室中的权限类型。
-     * [en-US] Permission type of the current user in the chat room.
-     */
-    readonly permissionType?: ChatRoomPermissionType;
-}
 /**
  * [zh-CN] 聊天室详情。
  * [en-US] Details of the chat room.
@@ -151,20 +125,15 @@ export interface ChatRoomDetail extends ChatRoomSummary {
      */
     readonly ext?: string;
     /**
-     * [zh-CN] 聊天室公告。
-     * [en-US] Chat room announcement.
+     * [zh-CN] 是否开启全员禁言。该字段映射服务端聊天室详情的 `mute`。
+     * [en-US] Whether all-member mute is enabled. This field maps to `mute` in the server chat room detail.
      */
-    readonly announcement?: string;
+    readonly muteAllMembers?: boolean;
     /**
      * [zh-CN] 当前用户在聊天室中的权限类型。
      * [en-US] Permission type of the current user in the chat room.
      */
     readonly permissionType?: ChatRoomPermissionType;
-    /**
-     * [zh-CN] 当前用户在聊天室中的状态快照。
-     * [en-US] Snapshot of the current user's status in the chat room.
-     */
-    readonly currentUserStatus?: ChatRoomCurrentUserStatus;
 }
 /**
  * [zh-CN] 基于页码的分页参数。

package/types/event-system.d.ts

@@ -11,8 +11,10 @@ import type { ChatRoomAdminAddedEventPayload, ChatRoomAdminRemovedEventPayload,
 import type { GroupAdminAddedEventPayload, GroupAdminRemovedEventPayload, GroupAllMemberMuteStateChangedEventPayload, GroupAnnouncementChangedEventPayload, GroupAutoAcceptInvitationEventPayload, GroupDestroyedEventPayload, GroupInvitationAcceptedEventPayload, GroupInvitationDeclinedEventPayload, GroupInvitationReceivedEventPayload, GroupMemberAttributeChangedEventPayload, GroupDisabledChangedEventPayload, GroupInfoChangedEventPayload, GroupMembersExitedEventPayload, GroupMembersJoinedEventPayload, GroupMuteListAddedEventPayload, GroupMuteListRemovedEventPayload, GroupOwnerChangedEventPayload, GroupRawNotifyEvent, GroupRequestToJoinAcceptedEventPayload, GroupRequestToJoinDeclinedEventPayload, GroupRequestToJoinReceivedEventPayload, GroupSharedFileAddedEventPayload, GroupSharedFileDeletedEventPayload, GroupUserGroupNamecardUpdatedEventPayload, GroupUserRemovedEventPayload, GroupAllowListAddedEventPayload, GroupAllowListRemovedEventPayload } from './group';
 import type { PresenceState } from './presence';
 import type { UserInfo, UserInfoRawNotifyEvent } from './user-info';
+import type { PushTokenBoundEvent, PushTokenOperationFailedEvent } from './push';
 import type { MessageDeliveredEventPayload, MessageReceiptEventPayload, MessageRecalledEventPayload, MessageUpdatedEventPayload, PinnedMessageChangedEventPayload, ReactionChangedEventPayload } from './chat-manager';
 import type { MultiDeviceContactEvent, MultiDeviceConversationEvent, MultiDeviceGroupEvent, MultiDeviceMessageRemovedEvent, MultiDeviceThreadEvent } from './multi-device';
+import type { LogEntry } from './log';
 /**
  * [zh-CN] 连接事件名称。
  * [en-US] Connection event name.
@@ -47,6 +49,18 @@ export declare const ChatEventName: {
  * [en-US] Chat event name.
  */
 export type ChatEventName = (typeof ChatEventName)[keyof typeof ChatEventName];
+/**
+ * [zh-CN] 日志事件名称常量。
+ * [en-US] Log event name constants.
+ */
+export declare const LogEventName: {
+    readonly LOG: "onLog";
+};
+/**
+ * [zh-CN] 日志事件名称。
+ * [en-US] Log event name.
+ */
+export type LogEventName = (typeof LogEventName)[keyof typeof LogEventName];
 /**
  * [zh-CN] 消息话题事件名称常量。
  * [en-US] Chat thread event name constants.
@@ -132,12 +146,31 @@ export type ChatRoomDispatchEventName = (typeof ChatRoomDispatchEventName)[keyof
  * [zh-CN] SDK 事件名称联合类型。
  * [en-US] Union of SDK event names.
  */
-export type EventName = ConnectionEventName | ChatEventName | ChatThreadEventName | InternalEventName | PresenceEventName | ContactEventName | UserInfoEventName | GroupEventName | ChatRoomDispatchEventName;
+export type EventName = ConnectionEventName | ChatEventName | LogEventName | ChatThreadEventName | InternalEventName | PresenceEventName | ContactEventName | UserInfoEventName | GroupEventName | ChatRoomDispatchEventName | PushEventName;
+/** [zh-CN] PushManager 事件名称。 [en-US] PushManager event names. */
+export declare const PushEventName: {
+    readonly TOKEN_BOUND: "onPushTokenBound";
+    readonly TOKEN_BIND_FAILED: "onPushTokenBindFailed";
+    readonly TOKEN_REMOVE_FAILED: "onPushTokenRemoveFailed";
+};
+/** [zh-CN] PushManager 事件名称联合类型。 [en-US] Union of PushManager event names. */
+export type PushEventName = (typeof PushEventName)[keyof typeof PushEventName];
 /**
  * [zh-CN] SDK 事件名称到事件载荷的映射。
  * [en-US] Mapping from SDK event names to event payloads.
  */
 export interface EventPayloadMap {
+    /** [zh-CN] 原生 Push Token 已成功绑定。 [en-US] Native push token was bound successfully. */
+    onPushTokenBound: PushTokenBoundEvent;
+    /** [zh-CN] 原生 Push Token 注册或绑定失败。 [en-US] Native push token registration or binding failed. */
+    onPushTokenBindFailed: PushTokenOperationFailedEvent;
+    /** [zh-CN] 原生 Push Token 自动或手动移除失败。 [en-US] Automatic or manual native push token removal failed. */
+    onPushTokenRemoveFailed: PushTokenOperationFailedEvent;
+    /**
+     * [zh-CN] SDK 产生并完成脱敏的结构化日志。控制台日志关闭后，此事件仍可继续触发。
+     * [en-US] A structured, sanitized SDK log. This event can still fire when console logging is disabled.
+     */
+    onLog: LogEntry;
     /** [zh-CN] 正在连接到服务器（含自动重连）。 [en-US] Connecting to server (including auto-reconnect). */
     onConnecting: ConnectionEventPayload;
     /** [zh-CN] 成功连接到服务器。 [en-US] Successfully connected to server. */
@@ -630,6 +663,18 @@ export type ChatEventPayloadMap = Pick<EventPayloadMap, ChatEventName>;
 export type ChatEventHandlerMap = Partial<{
     [K in ChatEventName]: (payload: ChatEventPayloadMap[K]) => EventHandlerResult;
 }>;
+/**
+ * [zh-CN] 日志事件载荷映射。
+ * [en-US] Log event payload map.
+ */
+export type LogEventPayloadMap = Pick<EventPayloadMap, LogEventName>;
+/**
+ * [zh-CN] 日志事件处理器映射。
+ * [en-US] Log event handler map.
+ */
+export type LogEventHandlerMap = Partial<{
+    [K in LogEventName]: (payload: LogEventPayloadMap[K]) => EventHandlerResult;
+}>;
 /**
  * [zh-CN] 消息话题事件载荷映射。
  * [en-US] Chat thread event payload map.
@@ -718,4 +763,10 @@ export type EventHandlerMap = Partial<{
  * [en-US] Event handler registration ID.
  */
 export type EventHandlerId = string;
+/** [zh-CN] PushManager 事件载荷映射。 [en-US] PushManager event payload map. */
+export type PushEventPayloadMap = Pick<EventPayloadMap, PushEventName>;
+/** [zh-CN] PushManager 事件处理器映射。 [en-US] PushManager event handler map. */
+export type PushEventHandlerMap = Partial<{
+    [K in PushEventName]: (payload: PushEventPayloadMap[K]) => EventHandlerResult;
+}>;
 export {};

package/types/index.d.ts

@@ -8,9 +8,10 @@ import type { ChatThreadMessageContext, ChatThreadOverview } from './chat-thread
 import type { ChatConversationType } from './message-conversation';
 import type { Sender } from './sender';
 export * from './chat-client';
+export * from './log';
 export * from './sync-data';
 export * from './connection';
-export { ChatEventName, ChatRoomDispatchEventName, ContactEventName, GroupEventName, PresenceEventName, UserInfoEventName, } from './event-system';
+export { ChatEventName, ChatRoomDispatchEventName, ContactEventName, GroupEventName, LogEventName, PresenceEventName, PushEventName, UserInfoEventName, } from './event-system';
 export type { ChatEventHandlerMap, // Chat 事件处理器映射
 ChatEventPayloadMap, // Chat 事件载荷映射
 ContactEventHandlerMap, // 联系人事件处理器映射
@@ -26,7 +27,9 @@ EventName, // 统一事件名称
 EventPayloadMap, // 事件载荷映射
 GroupEventHandlerMap, // 群组事件处理器映射
 GroupEventPayloadMap, // 群组事件载荷映射
-UserInfoEventHandlerMap, // 用户资料事件处理器映射
+LogEventHandlerMap, // 日志事件处理器映射
+LogEventPayloadMap, // 日志事件载荷映射
+PushEventHandlerMap, PushEventPayloadMap, UserInfoEventHandlerMap, // 用户资料事件处理器映射
 UserInfoEventPayloadMap, } from './event-system';
 export * from './manager';
 export * from './message-create';
@@ -108,11 +111,6 @@ export interface MessageModifiedInfo {
  * 连接状态（联合类型，不使用 enum）
  * 由 src/types/connection.ts 统一定义
  */
-/**
- * [zh-CN] SDK 日志级别。
- * [en-US] SDK log level.
- */
-export type LogLevel = 'DEBUG' | 'WARN' | 'ERROR';
 /**
  * [zh-CN] 小程序或 uni-app 本地文件对象。
  * [en-US] Local file descriptor for Mini Program or uni-app runtimes.

package/types/log.d.ts

@@ -0,0 +1,19 @@
+/**
+ * [zh-CN] SDK 日志级别。
+ * [en-US] SDK log level.
+ */
+export type LogLevel = 'DEBUG' | 'WARN' | 'ERROR';
+/**
+ * [zh-CN] SDK 生成并完成脱敏的结构化日志条目。该对象为只读视图，SDK 不提供运行时深冻结保证。
+ * [en-US] A structured log entry generated and sanitized by the SDK. This is a readonly view; the SDK does not guarantee runtime deep freezing.
+ */
+export interface LogEntry {
+    /** [zh-CN] 日志产生时间，使用 ISO 8601 字符串。 [en-US] The log creation time as an ISO 8601 string. */
+    readonly timestamp: string;
+    /** [zh-CN] 日志级别。 [en-US] The log level. */
+    readonly level: LogLevel;
+    /** [zh-CN] SDK 日志正文。 [en-US] The SDK log message. */
+    readonly message: string;
+    /** [zh-CN] 已按 SDK 日志规则脱敏的附加参数。 [en-US] Additional arguments sanitized according to the SDK logging rules. */
+    readonly args: ReadonlyArray<unknown>;
+}

package/types/manager.d.ts

@@ -27,6 +27,31 @@ export type RawNotifyEvent = {
     readonly type: 'userInfo';
     readonly payload: unknown;
 };
+/**
+ * [zh-CN] Manager 会话结束原因。
+ * [en-US] Reason why a manager session is ending.
+ */
+export type ManagerSessionEndReason = 'logout' | 'terminal-disconnect';
+/**
+ * [zh-CN] Manager 可使用的当前登录会话标识；不包含鉴权 Token。
+ * [en-US] Current login session identity available to managers; authentication tokens are excluded.
+ */
+export interface ManagerSessionContext {
+    /** [zh-CN] 当前 SDK 实例内单调递增的会话代次。 [en-US] Monotonically increasing session generation within this SDK instance. */
+    readonly generation: number;
+    /** [zh-CN] 当前登录用户 ID。 [en-US] Current logged-in user ID. */
+    readonly userId: string;
+    /** [zh-CN] 当前连接的设备资源标识。 [en-US] Device resource identifier for the current connection. */
+    readonly clientResource: string;
+}
+/**
+ * [zh-CN] Manager 会话结束上下文。
+ * [en-US] Context provided when a manager session is ending.
+ */
+export interface ManagerSessionEndContext extends ManagerSessionContext {
+    /** [zh-CN] 会话结束原因。 [en-US] Session-ending reason. */
+    readonly reason: ManagerSessionEndReason;
+}
 /**
  * [zh-CN] SDK 绑定管理器时提供的事件上下文。
  * [en-US] Event context provided when the SDK binds a manager.
@@ -50,6 +75,12 @@ export interface ManagerBase<Client> {
     bind(client: Client, context?: ManagerEventContext): void;
     /** [zh-CN] 处理管理器订阅的原始通知。 [en-US] Handles raw notifications subscribed to by the manager. */
     handleRawNotify?(event: RawNotifyEvent): void | Promise<void>;
+    /** [zh-CN] 登录上下文就绪后通知管理器；不得阻塞登录主链路。 [en-US] Notifies the manager after login context becomes ready; it must not block the login path. */
+    onSessionReady?(context: ManagerSessionContext): void;
+    /** [zh-CN] 鉴权上下文清理前通知管理器结束会话。 [en-US] Notifies the manager before authentication context is cleared. */
+    onSessionEnding?(context: ManagerSessionEndContext): void | Promise<void>;
+    /** [zh-CN] 清理当前会话运行时状态。 [en-US] Clears current session runtime state. */
+    resetSessionRuntime?(): void;
 }
 /**
  * [zh-CN] 带静态注册键的管理器构造器。

package/types/push.d.ts

@@ -2,6 +2,83 @@
  * [zh-CN] PushManager 对外类型定义，供推送 API 调用与文档生成使用。
  * [en-US] Public type definitions for PushManager, used by push APIs and documentation generation.
  */
+/** [zh-CN] UTS 插件返回的原生推送通道编码。 [en-US] Native push channel code returned by the UTS plugin. */
+export type NativePushTypeCode = 0 | 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8;
+/** [zh-CN] SDK 归一化后的原生推送通道。 [en-US] SDK-normalized native push channel. */
+export type NativePushChannel = 'apns' | 'fcm' | 'huawei' | 'xiaomi' | 'meizu' | 'vivo' | 'oppo' | 'honor' | 'normal';
+/**
+ * [zh-CN] UTS 插件 Token 注册结果。`push_token` 是敏感信息，不应记录日志。
+ * [en-US] Token registration result from the UTS plugin. `push_token` is sensitive and must not be logged.
+ */
+export interface NativePushTokenResult {
+    /** [zh-CN] 厂商或 APNs Token。 [en-US] Vendor or APNs token. */
+    readonly push_token: string;
+    /** [zh-CN] 插件通道编码。 [en-US] Plugin channel code. */
+    readonly push_type: NativePushTypeCode;
+    /** [zh-CN] `200` 表示注册成功。 [en-US] `200` indicates successful registration. */
+    readonly code: number;
+    /** [zh-CN] 插件错误文本，仅供 SDK 内部判断。 [en-US] Plugin error text for internal SDK classification only. */
+    readonly error: string;
+}
+/**
+ * [zh-CN] SDK 所需的最小 UTS 原生推送插件接口。
+ * [en-US] Minimal UTS native push plugin interface required by the SDK.
+ */
+export interface NativePushPlugin {
+    /** [zh-CN] 注册并持续监听 Token。 [en-US] Registers and continuously observes token updates. */
+    onRegister(callback: (result: NativePushTokenResult) => void): void;
+    /** [zh-CN] 结束插件侧注册。 [en-US] Ends plugin-side registration. */
+    unRegister(): void;
+}
+/**
+ * [zh-CN] 各原生通道在环信控制台中的证书名称。
+ * [en-US] Certificate names configured in the Easemob console for native channels.
+ */
+export interface NativePushCertificates {
+    /** [zh-CN] Apple APNs 证书名称。 [en-US] Apple APNs certificate name. */
+    readonly apns?: string;
+    /** [zh-CN] Firebase Cloud Messaging 证书名称。 [en-US] Firebase Cloud Messaging certificate name. */
+    readonly fcm?: string;
+    /** [zh-CN] 华为推送证书名称。 [en-US] Huawei push certificate name. */
+    readonly huawei?: string;
+    /** [zh-CN] 小米推送证书名称。 [en-US] Xiaomi push certificate name. */
+    readonly xiaomi?: string;
+    /** [zh-CN] 魅族推送证书名称。 [en-US] Meizu push certificate name. */
+    readonly meizu?: string;
+    /** [zh-CN] vivo 推送证书名称。 [en-US] vivo push certificate name. */
+    readonly vivo?: string;
+    /** [zh-CN] OPPO 推送证书名称。 [en-US] OPPO push certificate name. */
+    readonly oppo?: string;
+    /** [zh-CN] 荣耀推送证书名称。 [en-US] Honor push certificate name. */
+    readonly honor?: string;
+}
+/** [zh-CN] 配置原生推送所需参数。 [en-US] Options required to configure native push. */
+export interface SetNativePushOptions {
+    /** [zh-CN] 宿主从 UTS 导出函数组装的插件对象。 [en-US] Plugin object assembled from host-imported UTS functions. */
+    readonly plugin: NativePushPlugin;
+    /** [zh-CN] 通道到环信证书名称的映射，至少配置一项。 [en-US] Channel-to-certificate mapping with at least one entry. */
+    readonly certificates: NativePushCertificates;
+}
+/** [zh-CN] 原生 Push Token 成功绑定事件。 [en-US] Native push token bound event. */
+export interface PushTokenBoundEvent {
+    /** [zh-CN] 实际绑定的原生推送通道。 [en-US] Native push channel that was bound. */
+    readonly channel: Exclude<NativePushChannel, 'normal'>;
+    /** [zh-CN] 实际使用的环信证书名称。 [en-US] Easemob certificate name used for binding. */
+    readonly notifierName: string;
+}
+/** [zh-CN] 原生 Push Token 操作失败事件。 [en-US] Native push token operation failure event. */
+export interface PushTokenOperationFailedEvent {
+    /** [zh-CN] 失败发生的操作阶段。 [en-US] Operation stage where the failure occurred. */
+    readonly stage: 'register' | 'bind' | 'remove';
+    /** [zh-CN] 已解析出的推送通道。 [en-US] Resolved push channel, when available. */
+    readonly channel?: NativePushChannel;
+    /** [zh-CN] 已匹配的环信证书名称。 [en-US] Matched Easemob certificate name, when available. */
+    readonly notifierName?: string;
+    /** [zh-CN] SDK 统一错误码。 [en-US] Unified SDK error code. */
+    readonly code?: number;
+    /** [zh-CN] 相同操作是否适合重试。 [en-US] Whether retrying the same operation is appropriate. */
+    readonly retryable: boolean;
+}
 /**
  * [zh-CN] 会话类型常量集合。
  * [en-US] Conversation type constants.

package/upload/attachment-uploader.d.ts

@@ -1,9 +1,6 @@
-import type { UploadAdapter } from '../platform';
 import type { Message, SendMessageOptions } from '../types';
 import type { UploadConfig } from './types';
-interface AttachmentUploaderConfig extends UploadConfig {
-    uploadAdapter?: UploadAdapter;
-}
+type AttachmentUploaderConfig = UploadConfig;
 export declare class AttachmentUploader {
     private config;
     constructor(config?: AttachmentUploaderConfig);
@@ -24,7 +21,6 @@ export declare class AttachmentUploader {
     private requestPrecheck;
     private requestJson;
     private requestByAdapter;
-    private requestByFetch;
     private buildPrecheckedUploadResult;
     private uploadAttachment;
     private uploadByAdapter;

package/upload/multipart-upload.d.ts

@@ -1,14 +1,4 @@
-import type { UploadRequest } from './types';
-import { buildUploadResult } from './utils';
-import type { RequestAdapter } from '../platform/types';
-import type { DataReportOperationHandle } from '../data-report/types';
-export declare const multipartUpload: (request: UploadRequest) => Promise<ReturnType<typeof buildUploadResult>>;
-export declare const multipartAbort: (options: {
-    restBaseUrl: string;
-    orgName: string;
-    appName: string;
-    token: string;
-    uuid: string;
-    requestAdapter?: RequestAdapter;
-    dataReportOperation?: DataReportOperationHandle;
-}) => Promise<void>;
+/**
+ * @deprecated 浏览器兼容分片上传入口。实际网络实现位于平台层。
+ */
+export { multipartAbort, multipartUpload, } from '../platform/upload/legacy-multipart-upload';

package/upload/simple-upload.d.ts

@@ -1,3 +1,4 @@
-import type { UploadRequest } from './types';
-import { buildUploadResult } from './utils';
-export declare const simpleUpload: (request: UploadRequest) => Promise<ReturnType<typeof buildUploadResult>>;
+/**
+ * @deprecated 浏览器兼容上传入口。实际网络实现位于平台层。
+ */
+export { simpleUpload } from '../platform/upload/legacy-simple-upload';

package/upload/types.d.ts

@@ -1,5 +1,5 @@
 import type { ChatConversationType, FileUploadProgress, FileUploadResult, ImageType, Message, MessageType, SendMessageOptions, CombineMessageBody, FileMessageBody, ImageMessageBody, VideoMessageBody, VoiceMessageBody } from '../types';
-import type { ImageProcessor, NormalizedUploadSource, RequestAdapter } from '../platform';
+import type { ImageProcessor, NormalizedUploadSource, RequestAdapter, UploadAdapter } from '../platform';
 import type { DataReportOperationHandle } from '../data-report/types';
 export type AttachmentMessageType = Extract<MessageType, 'image' | 'video' | 'voice' | 'file' | 'combine'>;
 export type ImagePolicyReason = 'explicit-original' | 'default-large' | 'gif-force-origin' | 'large-fallback-origin';
@@ -14,6 +14,7 @@ export interface UploadConfig {
     enableMd5Check?: boolean;
     enableMultipartUpload?: boolean;
     requestAdapter?: RequestAdapter;
+    uploadAdapter?: UploadAdapter;
     imageProcessor?: ImageProcessor;
 }
 export interface UploadRequest {

package/utils/error-codes.generated.d.ts

@@ -11,6 +11,7 @@ export declare const ERROR_CODES: {
     readonly AUTH_LOGIN_TOO_MANY_DEVICES: number;
     readonly AUTH_USER_MUTED: number;
     readonly CONNECTION_TIMEOUT: number;
+    readonly CONNECTION_LOGIN_TIMEOUT: number;
     readonly CONNECTION_WEBSOCKET_ERROR: number;
     readonly CONNECTION_NOT_CREATED: number;
     readonly CONNECTION_CLOSED_BEFORE_READY: number;