easemob-websdk 4.24.1 → 5.0.0

package/types/push.d.ts

@@ -0,0 +1,296 @@
+/**
+ * [zh-CN] PushManager 对外类型定义，供推送 API 调用与文档生成使用。
+ * [en-US] Public type definitions for PushManager, used by push APIs and documentation generation.
+ */
+/**
+ * [zh-CN] 会话类型常量集合。
+ * [en-US] Conversation type constants.
+ */
+export declare const PUSH_CONVERSATION_TYPE: {
+    readonly SINGLE_CHAT: "singleChat";
+    readonly GROUP_CHAT: "groupChat";
+};
+/**
+ * [zh-CN] PushManager 支持的会话类型。
+ * [en-US] Conversation types supported by PushManager.
+ */
+export type PushConversationType = (typeof PUSH_CONVERSATION_TYPE)[keyof typeof PUSH_CONVERSATION_TYPE];
+/**
+ * [zh-CN] 推送提醒类型常量集合。
+ * [en-US] Push remind type constants.
+ */
+export declare const PUSH_REMIND_TYPE: {
+    readonly ALL: "ALL";
+    readonly AT: "AT";
+    readonly NONE: "NONE";
+    readonly DEFAULT: "DEFAULT";
+};
+/**
+ * [zh-CN] 推送提醒类型。
+ * [en-US] Push reminder type.
+ */
+export type PushRemindType = (typeof PUSH_REMIND_TYPE)[keyof typeof PUSH_REMIND_TYPE];
+/**
+ * [zh-CN] 可设置的推送提醒类型（不包含 DEFAULT）。
+ * [en-US] Configurable push reminder types (excluding 'DEFAULT').
+ */
+export type PushRemindTypeWithoutDefault = Exclude<PushRemindType, 'DEFAULT'>;
+/**
+ * [zh-CN] 免打扰模式常量集合。
+ * [en-US] Do Not Disturb (DND) mode constants.
+ */
+export declare const PUSH_SILENT_MODE: {
+    readonly REMIND_TYPE: "REMIND_TYPE";
+    readonly DURATION: "DURATION";
+    readonly INTERVAL: "INTERVAL";
+};
+/**
+ * [zh-CN] 免打扰模式类型。
+ * [en-US] Do Not Disturb (DND) types.
+ */
+export type PushSilentMode = (typeof PUSH_SILENT_MODE)[keyof typeof PUSH_SILENT_MODE];
+/**
+ * [zh-CN] 时间点（24 小时制）。
+ * [en-US] Time in 24-hour format.
+ */
+export interface PushTimePoint {
+    /** [zh-CN] 小时，范围为 0 至 23。 [en-US] Hour, in the range [0, 23]. */
+    readonly hours: number;
+    /** [zh-CN] 分钟，范围为 0 至 59。 [en-US] Minute, in the range [0, 59]. */
+    readonly minutes: number;
+}
+/**
+ * [zh-CN] 推送提醒规则配置项（基于提醒类型）。
+ * [en-US] Push reminder rule configuration (based on reminder type).
+ */
+export interface PushSilentModeRemindTypeRuleInput {
+    /** [zh-CN] 取值必须为 `REMIND_TYPE`。 [en-US] Must be `REMIND_TYPE`. */
+    readonly mode: 'REMIND_TYPE';
+    /** [zh-CN] 提醒类型。可选值：`ALL`、`AT`、`NONE`。 [en-US] Reminder type. Valid values: `ALL`, `AT`, `NONE`. */
+    readonly remindType: PushRemindTypeWithoutDefault;
+}
+/**
+ * [zh-CN] 推送提醒规则配置项（基于持续时长）。
+ * [en-US] Push reminder rule configuration (based on duration).
+ */
+export interface PushSilentModeDurationRuleInput {
+    /** [zh-CN] 取值必须为 `DURATION`。 [en-US] Must be `DURATION`. */
+    readonly mode: 'DURATION';
+    /** [zh-CN] 持续时长（分钟），必须为正整数。SDK 会在 REST 请求中转换为毫秒。 [en-US] Duration in minutes, must be a positive integer. The SDK converts it to milliseconds for REST requests. */
+    readonly duration: number;
+}
+/**
+ * [zh-CN] 推送提醒规则配置项（基于时间区间）。
+ * [en-US] Push reminder rule configuration (based on time interval).
+ */
+export interface PushSilentModeIntervalRuleInput {
+    /** [zh-CN] 取值必须为 `INTERVAL`。 [en-US] Must be `INTERVAL`. */
+    readonly mode: 'INTERVAL';
+    /** [zh-CN] 开始时间点。 [en-US] Interval start time. */
+    readonly startTime: PushTimePoint;
+    /** [zh-CN] 结束时间点。 [en-US] Interval end time. */
+    readonly endTime: PushTimePoint;
+}
+/**
+ * [zh-CN] 免打扰规则配置项联合类型。
+ * [en-US] Union type for DND mode rule configurations.
+ */
+export type PushSilentModeRuleInput = PushSilentModeRemindTypeRuleInput | PushSilentModeDurationRuleInput | PushSilentModeIntervalRuleInput;
+/**
+ * [zh-CN] 免打扰规则查询视图（各字段可并存）。
+ * [en-US] DND mode rule view (fields can coexist).
+ */
+export interface PushSilentModeRuleView {
+    /** [zh-CN] 当前提醒类型。 [en-US] Current reminder type. */
+    readonly remindType?: PushRemindType;
+    /** [zh-CN] 免打扰到期时间戳（毫秒）。该值直接映射服务端响应中的 `ignoreDuration`，SDK 不自行计算。 [en-US] DND expiration timestamp in milliseconds. This value maps directly from `ignoreDuration` in the server response and is not calculated by the SDK. */
+    readonly expireTimestamp?: number;
+    /** [zh-CN] 每日免打扰开始时间。 [en-US] Daily DND mode start time. */
+    readonly silentModeStartTime?: PushTimePoint;
+    /** [zh-CN] 每日免打扰结束时间。 [en-US] Daily DND mode end time. */
+    readonly silentModeEndTime?: PushTimePoint;
+}
+/**
+ * [zh-CN] 仅包含提醒类型的规则视图。
+ * [en-US] Reminder-type-only rule view.
+ */
+export type PushSilentModeRemindTypeRuleView = Readonly<{
+    /** [zh-CN] 当前提醒类型。 [en-US] Current reminder type. */
+    remindType: PushRemindType;
+}>;
+/**
+ * [zh-CN] 仅包含时长模式到期时间的规则视图。
+ * [en-US] Expiration-only rule view for duration mode.
+ */
+export type PushSilentModeDurationRuleView = Readonly<{
+    /** [zh-CN] 免打扰到期时间戳（毫秒），直接来自服务端响应。 [en-US] DND expiration timestamp in milliseconds, returned directly by the server. */
+    expireTimestamp: number;
+}>;
+/**
+ * [zh-CN] 仅包含时间区间的规则视图。
+ * [en-US] Interval-only rule view.
+ */
+export type PushSilentModeIntervalRuleView = Readonly<{
+    /** [zh-CN] 每日免打扰开始时间。 [en-US] Daily silent mode start time. */
+    silentModeStartTime: PushTimePoint;
+    /** [zh-CN] 每日免打扰结束时间。 [en-US] Daily silent mode end time. */
+    silentModeEndTime: PushTimePoint;
+}>;
+/**
+ * [zh-CN] 全局免打扰响应结果。
+ * [en-US] Response for global DND mode.
+ */
+export interface GlobalSilentModeResponse {
+    /** [zh-CN] 作用域，必须为 `global`。 [en-US] Scope, always `global`. */
+    readonly scope: 'global';
+    /** [zh-CN] 全局免打扰规则。 [en-US] Global DND mode rule. */
+    readonly rule: PushSilentModeRuleView;
+}
+/**
+ * [zh-CN] 会话免打扰配置响应。
+ * [en-US] Response for DND configuration for a single conversation.
+ */
+export interface ConversationSilentModeResponse {
+    /** [zh-CN] 会话 ID。 [en-US] Conversation ID. */
+    readonly conversationId: string;
+    /** [zh-CN] 会话类型。 [en-US] Conversation type. */
+    readonly conversationType: PushConversationType;
+    /** [zh-CN] 会话免打扰规则。 [en-US] Conversation DND mode rule. */
+    readonly rule: PushSilentModeRuleView;
+}
+/**
+ * [zh-CN] 会话标识。
+ * [en-US] Conversation identification.
+ */
+export interface ConversationIdentifier {
+    /** [zh-CN] 会话 ID。 [en-US] Conversation ID. */
+    readonly conversationId: string;
+    /** [zh-CN] 会话类型。 [en-US] Conversation type. */
+    readonly conversationType: PushConversationType;
+}
+/**
+ * [zh-CN] 批量会话免打扰响应。
+ * [en-US] Response for DND settings of a batch of conversations.
+ */
+export interface BatchConversationSilentModeResponse {
+    /** [zh-CN] 会话免打扰结果列表。 [en-US] List of conversation DND mode settings. */
+    readonly conversations: ReadonlyArray<ConversationSilentModeResponse>;
+}
+/**
+ * [zh-CN] 推送语言响应。
+ * [en-US] Push language response.
+ */
+export interface PushLanguageResponse {
+    /** [zh-CN] 当前生效的语言。 [en-US] Current push language. */
+    readonly language: string;
+}
+/**
+ * [zh-CN] 免打扰会话条目。
+ * [en-US] Muted conversation item.
+ */
+export interface MutedConversationItem {
+    /** [zh-CN] 会话 ID。 [en-US] Conversation ID. */
+    readonly conversationId: string;
+    /** [zh-CN] 会话类型。 [en-US] Conversation type. */
+    readonly conversationType: PushConversationType;
+    /** [zh-CN] 推送提醒类型。可选值：`ALL`、`AT`、`NONE`。 [en-US] Reminder type. Valid values: `ALL`, `AT`, `NONE`. */
+    readonly remindType: PushRemindTypeWithoutDefault;
+}
+/**s
+ * [zh-CN] 免打扰会话分页响应结果。
+ * [en-US] Paginated response for muted conversations.
+ */
+export interface MutedConversationPageResponse {
+    /** [zh-CN] 当前页的免打扰会话列表。 [en-US] List of muted conversations for the current page. */
+    readonly conversations: ReadonlyArray<MutedConversationItem>;
+    /** [zh-CN] 下一页游标。若为空字符串，则表示没有更多数据。 [en-US] Next-page cursor. An empty string indicates no more data. */
+    readonly cursor: string;
+}
+/**
+ * [zh-CN] 上传推送 Token 的参数。
+ * [en-US] Parameters for uploading the push token.
+ */
+export interface UploadPushTokenParams {
+    /** [zh-CN] 设备唯一标识。 [en-US] Unique device ID. */
+    readonly deviceId: string;
+    /** [zh-CN] 设备推送 Token。 [en-US] Device push token. */
+    readonly deviceToken: string;
+    /** [zh-CN] 推送通道名称（例如：'FCM'）。 [en-US] Push channel name (e.g., 'FCM'). */
+    readonly notifierName: string;
+}
+/**
+ * [zh-CN] 设置全局免打扰的参数。
+ * [en-US] Parameters for setting global Do Not Disturb (DND) mode.
+ */
+export interface SetGlobalSilentModeParams {
+    /** [zh-CN] 推送提醒规则配置项。 [en-US] Push reminder rule configuration. */
+    readonly rule: PushSilentModeRuleInput;
+}
+/**
+ * [zh-CN] 查询全局免打扰设置的参数。
+ * [en-US] Parameters for querying global DND settings.
+ */
+export type GetGlobalSilentModeParams = Record<string, never>;
+/**
+ * [zh-CN] 设置会话免打扰参数。
+ * [en-US] Parameters for setting the conversation DND mode.
+ */
+export interface SetConversationSilentModeParams {
+    /** [zh-CN] 会话 ID。 [en-US] Conversation ID. */
+    readonly conversationId: string;
+    /** [zh-CN] 会话类型。 [en-US] Conversation type. */
+    readonly conversationType: PushConversationType;
+    /** [zh-CN] 会话免打扰规则。 [en-US] DND mode rule for the conversation. */
+    readonly rule: PushSilentModeRuleInput;
+}
+/**
+ * [zh-CN] 查询会话免打扰参数。
+ * [en-US]Parameters for querying the conversation DND mode.
+ */
+export interface GetConversationSilentModeParams {
+    /** [zh-CN] 会话 ID。 [en-US] Conversation ID. */
+    readonly conversationId: string;
+    /** [zh-CN] 会话类型。 [en-US] Conversation type. */
+    readonly conversationType: PushConversationType;
+}
+/**
+ * [zh-CN] 清除会话推送提醒类型参数。
+ * [en-US] Parameters for clearing the conversation push reminder type.
+ */
+export interface ClearConversationRemindTypeParams {
+    /** [zh-CN] 会话 ID。 [en-US] Conversation ID. */
+    readonly conversationId: string;
+    /** [zh-CN] 会话类型。 [en-US] Conversation type. */
+    readonly conversationType: PushConversationType;
+}
+/**
+ * [zh-CN] 批量查询会话免打扰设置的参数。
+ * [en-US] Parameters for batch querying conversation DND mode.
+ */
+export interface GetConversationSilentModesParams {
+    /** [zh-CN] 会话标识列表。单次最多支持 20 条。 [en-US] List of conversation IDs, up to 20 per request. */
+    readonly conversationList: ReadonlyArray<ConversationIdentifier>;
+}
+/**
+ * [zh-CN] 设置推送目标语言的参数。
+ * [en-US] Parameters for setting the push notification language.
+ */
+export interface SetPushLanguageParams {
+    /** [zh-CN] 语言标识符（例如：`zh-Hans`、`en`）。 [en-US] Language identifier (e.g., `zh-Hans`, `en`). */
+    readonly language: string;
+}
+/**
+ * [zh-CN] 查询推送目标语言的参数。
+ * [en-US] Parameters for querying the push notification language.
+ */
+export type GetPushLanguageParams = Record<string, never>;
+/**
+ * [zh-CN] 分页查询会话提醒类型参数。
+ * [en-US] Parameters for paginating conversations by reminder type.
+ */
+export interface GetConversationListByRemindTypeParams {
+    /** [zh-CN] 分页大小，必须为正整数。 [en-US] Number of conversations per page. It must be a positive integer. */
+    readonly pageSize: number;
+    /** [zh-CN] 下一页游标。首次查询时无需传入。 [en-US] Cursor for the next page. Omit for the first request. */
+    readonly cursor?: string;
+}

package/types/sender.d.ts

@@ -0,0 +1,12 @@
+/**
+ * [zh-CN] 发送者信息。
+ * [en-US] Sender information.
+ */
+export interface Sender {
+    /** [zh-CN] 发送者用户 ID。 [en-US] Sender user ID. */
+    userId: string;
+    /** [zh-CN] 发送者昵称。 [en-US] Sender nickname. */
+    nickname?: string;
+    /** [zh-CN] 发送者头像地址。 [en-US] Sender avatar URL. */
+    avatarUrl?: string;
+}

package/types/sync-data.d.ts

@@ -0,0 +1,54 @@
+import type { ErrorCode } from '../utils/error-codes';
+/**
+ * [zh-CN] 登录后自动同步的数据类型。
+ * [en-US] Data type synchronized automatically after login.
+ */
+export type SyncDataType = 'conversation' | 'contact' | 'group';
+/**
+ * [zh-CN] 同步完成状态。
+ * [en-US] Terminal status of a sync round.
+ */
+export type SyncDataStatus = 'success' | 'failed';
+/**
+ * [zh-CN] 同步失败阶段。
+ * [en-US] Stage where a sync round failed.
+ */
+export type SyncDataErrorStage = 'config' | 'socket_connect' | 'metadata' | 'request_send' | 'sync_page' | 'decode' | 'response_decode' | 'batch_merge' | 'preview_persist' | 'completion_meta' | 'auth' | 'server_limit' | 'cancelled' | 'fallback';
+/**
+ * [zh-CN] 同步失败详情。
+ * [en-US] Diagnostic error details for a sync round.
+ */
+export interface SyncDataError {
+    /** [zh-CN] 同步数据类型。 [en-US] Synchronized data type. */
+    readonly dataType: SyncDataType;
+    /** [zh-CN] SDK 对外错误码。 [en-US] Public SDK error code. */
+    readonly code: ErrorCode;
+    /** [zh-CN] 失败阶段。 [en-US] Failure stage. */
+    readonly stage: SyncDataErrorStage;
+    /** [zh-CN] 错误消息。 [en-US] Error message. */
+    readonly message: string;
+    /** [zh-CN] 是否建议重试。 [en-US] Whether retrying is recommended. */
+    readonly retryable: boolean;
+    /** [zh-CN] 服务端原始错误码，仅用于排障。 [en-US] Original service error code for troubleshooting only. */
+    readonly serverCode?: number | string;
+}
+/**
+ * [zh-CN] 同步开始事件载荷。
+ * [en-US] Payload emitted when a sync round starts.
+ */
+export interface SyncDataStartPayload {
+    /** [zh-CN] 同步数据类型。 [en-US] Synchronized data type. */
+    readonly dataType: SyncDataType;
+}
+/**
+ * [zh-CN] 同步完成事件载荷。
+ * [en-US] Payload emitted when a sync round finishes.
+ */
+export interface SyncDataFinishedPayload {
+    /** [zh-CN] 同步数据类型。 [en-US] Synchronized data type. */
+    readonly dataType: SyncDataType;
+    /** [zh-CN] 完成状态。 [en-US] Terminal status. */
+    readonly status: SyncDataStatus;
+    /** [zh-CN] 失败时的错误详情。 [en-US] Error details when the round failed. */
+    readonly error?: SyncDataError;
+}

package/types/user-info.d.ts

@@ -0,0 +1,178 @@
+/**
+ * [zh-CN] UserInfoManager 对外类型定义。
+ * [en-US] Public types for UserInfoManager.
+ */
+/**
+ * [zh-CN] 用户资料属性名。
+ * [en-US] Public user profile attribute names.
+ */
+export type UserInfoAttribute = 'nickname' | 'avatarUrl' | 'mail' | 'phone' | 'gender' | 'sign' | 'birth' | 'ext';
+/**
+ * [zh-CN] 单个用户资料属性允许的值类型。
+ * [en-US] Allowed types of values for attributes in the profile of a single user.
+ */
+export type UserInfoAttributeValue = string | number | boolean;
+/**
+ * [zh-CN] UserInfoManager 查询/更新成功后返回的标准化用户资料对象。
+ * [en-US] Normalized user profile returned by UserInfoManager fetch/update APIs.
+ */
+export interface UserInfo {
+    /** [zh-CN] 用户 ID。 [en-US] User ID. */
+    readonly userId: string;
+    /** [zh-CN] 昵称。 [en-US] Nickname. */
+    readonly nickname?: string;
+    /** [zh-CN] 头像地址。 [en-US] Avatar URL. */
+    readonly avatarUrl?: string;
+    /** [zh-CN] 邮箱。 [en-US] Email. */
+    readonly mail?: string;
+    /** [zh-CN] 手机号。 [en-US] Phone number. */
+    readonly phone?: string;
+    /** [zh-CN] 性别或自定义标识。 [en-US] Gender or custom gender marker. */
+    readonly gender?: UserInfoAttributeValue;
+    /** [zh-CN] 签名。 [en-US] Signature. */
+    readonly sign?: string;
+    /** [zh-CN] 生日。 [en-US] Birthday. */
+    readonly birth?: string;
+    /** [zh-CN] 扩展字段。 [en-US] Extension field. */
+    readonly ext?: string;
+}
+/**
+ * [zh-CN] 用户资料事件监听器。
+ * [en-US] User profile event listener.
+ */
+export interface UserInfoListener {
+    /**
+     * [zh-CN] 当前用户资料更新时触发。
+     * [en-US] Triggered when the current user's profile is updated.
+     */
+    readonly onOwnInfoUpdated?: (userInfo: UserInfo) => void;
+    /**
+     * [zh-CN] 他人资料通过消息补位更新时触发。
+     * [en-US] Triggered when other users' profiles are hydrated from messages.
+     */
+    readonly onUserInfoUpdated?: (userInfos: ReadonlyArray<UserInfo>) => void;
+}
+/**
+ * [zh-CN] 按用户 ID 查询默认字段的参数。
+ * [en-US] Parameters for fetching default profile fields by user IDs.
+ */
+export interface FetchUserInfoByUserIdParams {
+    /** [zh-CN] 目标用户 ID 列表。 [en-US] Target user ID list. */
+    readonly userIds: ReadonlyArray<string>;
+}
+/**
+ * [zh-CN] 按用户 ID 与属性集查询资料的参数。
+ * [en-US] Parameters for fetching profiles by user IDs with an explicit attribute projection.
+ */
+export interface FetchUserInfoByAttributeParams {
+    /** [zh-CN] 目标用户 ID 列表。 [en-US] Target user ID list. */
+    readonly userIds: ReadonlyArray<string>;
+    /** [zh-CN] 需要查询的资料属性。 [en-US] Requested profile attributes. */
+    readonly attributes: ReadonlyArray<UserInfoAttribute>;
+}
+/**
+ * [zh-CN] 批量订阅陌生人资料变化的参数。
+ * [en-US] Parameters for subscribing to stranger profile change notifications.
+ */
+export interface SubscribeUsersInfoParams {
+    /** [zh-CN] 待订阅的用户 ID 列表。 [en-US] Target user ID list to subscribe. */
+    readonly userIds: ReadonlyArray<string>;
+}
+/**
+ * [zh-CN] 批量取消订阅陌生人资料变化的参数。
+ * [en-US] Parameters for unsubscribing stranger profile change notifications.
+ */
+export interface UnsubscribeUsersInfoParams {
+    /** [zh-CN] 待取消订阅的用户 ID 列表。 [en-US] Target user ID list to unsubscribe. */
+    readonly userIds: ReadonlyArray<string>;
+}
+/** @internal 用户资料 notify 来源。 */
+export type UserInfoNotifySource = 'subscription' | 'contact' | 'own';
+/** @internal 原始用户资料 notify 类型。 */
+export type UserInfoRawNotifyType = 'subscribe_metadata_updated' | 'contact_metadata_updated' | 'user_metadata_updated';
+/** @internal MessageReceiver 转发给 ChatClient 的用户资料原始 notify。 */
+export interface UserInfoRawNotifyEvent {
+    readonly notifyType: UserInfoRawNotifyType;
+    readonly userId: string;
+    readonly metadata: Record<string, unknown>;
+    readonly lastModified: number;
+}
+/** @internal 归一化后的用户资料补丁。 */
+export interface UserInfoNotifyPatch {
+    readonly userId: string;
+    readonly attributes: Partial<UserInfo>;
+    readonly lastModified: number;
+    readonly source: UserInfoNotifySource;
+}
+/**
+ * [zh-CN] 当前用户整对象更新参数。
+ * [en-US] Patch-style update parameters for the current user's profile.
+ */
+export interface UpdateOwnInfoParams {
+    /** [zh-CN] 昵称；传空字符串表示清空。 [en-US] Nickname; pass an empty string to clear it. */
+    readonly nickname?: string;
+    /** [zh-CN] 头像地址；传空字符串表示清空。 [en-US] Avatar URL; pass an empty string to clear it. */
+    readonly avatarUrl?: string;
+    /** [zh-CN] 邮箱；传空字符串表示清空。 [en-US] Email; pass an empty string to clear it. */
+    readonly mail?: string;
+    /** [zh-CN] 手机号；传空字符串表示清空。 [en-US] Phone number; pass an empty string to clear it. */
+    readonly phone?: string;
+    /** [zh-CN] 性别；`false` / `0` 也是合法值。 [en-US] Gender; `false` and `0` are valid values. */
+    readonly gender?: UserInfoAttributeValue;
+    /** [zh-CN] 签名；传空字符串表示清空。 [en-US] Signature; pass an empty string to clear it. */
+    readonly sign?: string;
+    /** [zh-CN] 生日；传空字符串表示清空。 [en-US] Birthday; pass an empty string to clear it. */
+    readonly birth?: string;
+    /** [zh-CN] 扩展字段；传空字符串表示清空。 [en-US] Extension field; pass an empty string to clear it. */
+    readonly ext?: string;
+}
+/**
+ * [zh-CN] 当前用户单属性更新参数模型。
+ * [en-US] Data model for updating a single attribute of the current user's profile.
+ */
+export interface UpdateOwnInfoByAttributeParams {
+    /** [zh-CN] 目标属性。 [en-US] Target attribute. */
+    readonly attribute: UserInfoAttribute;
+    /** [zh-CN] 属性值。 [en-US] Attribute value. */
+    readonly value: UserInfoAttributeValue;
+}
+/** @internal 服务端用户资料属性结构。 */
+export interface ServerUserInfoAttributes {
+    readonly nickname?: unknown;
+    readonly avatarurl?: unknown;
+    readonly avatarUrl?: unknown;
+    readonly mail?: unknown;
+    readonly phone?: unknown;
+    readonly gender?: unknown;
+    readonly sign?: unknown;
+    readonly birth?: unknown;
+    readonly ext?: unknown;
+}
+/** @internal 查询接口真实响应 envelope。 */
+export interface UserInfoFetchResponseEnvelope {
+    readonly timestamp?: unknown;
+    readonly data?: unknown;
+    readonly lastModified?: unknown;
+    readonly duration?: unknown;
+}
+/** @internal 更新接口真实响应 envelope。 */
+export interface UserInfoUpdateResponseEnvelope {
+    readonly timestamp?: unknown;
+    readonly data?: unknown;
+    readonly lastModified?: unknown;
+    readonly duration?: unknown;
+}
+/** @internal 订阅相关接口真实响应 envelope。 */
+export interface UserInfoSubscriptionResponseEnvelope {
+    readonly path?: unknown;
+    readonly uri?: unknown;
+    readonly status?: unknown;
+    readonly timestamp?: unknown;
+    readonly organization?: unknown;
+    readonly application?: unknown;
+    readonly entities?: unknown;
+    readonly count?: unknown;
+    readonly data?: unknown;
+    readonly duration?: unknown;
+    readonly applicationName?: unknown;
+}

package/upload/attachment-file-store.d.ts

@@ -0,0 +1,11 @@
+import type { CompatibleFile } from '../types';
+declare class AttachmentFileStore {
+    private readonly store;
+    set(msgLocalId: string, file: CompatibleFile): void;
+    get(msgLocalId: string): CompatibleFile | undefined;
+    consume(msgLocalId: string): CompatibleFile | undefined;
+    delete(msgLocalId: string): void;
+    clear(): void;
+}
+export declare const attachmentFileStore: AttachmentFileStore;
+export type { AttachmentFileStore };

package/upload/attachment-uploader.d.ts

@@ -0,0 +1,36 @@
+import type { UploadAdapter } from '../platform';
+import type { Message, SendMessageOptions } from '../types';
+import type { UploadConfig } from './types';
+interface AttachmentUploaderConfig extends UploadConfig {
+    uploadAdapter?: UploadAdapter;
+}
+export declare class AttachmentUploader {
+    private config;
+    constructor(config?: AttachmentUploaderConfig);
+    updateConfig(config: AttachmentUploaderConfig): void;
+    updateAuthToken(token: string): void;
+    /**
+     * 发送前统一准备附件消息。
+     * 这里会串起 029 的主流程：解析本地文件、决定图片发送语义、按门槛做预检、命中则复用远端资源，未命中再进入实际上传。
+     */
+    prepareMessage(message: Message, options?: SendMessageOptions): Promise<Message>;
+    private resolveUploadUrl;
+    private hasUploadedRemoteResource;
+    private prepareAttachmentUpload;
+    private resolveImageCandidate;
+    private maybePrecheck;
+    private computeMd5;
+    private resolveImageProcessor;
+    private requestPrecheck;
+    private requestJson;
+    private requestByAdapter;
+    private requestByFetch;
+    private buildPrecheckedUploadResult;
+    private uploadAttachment;
+    private uploadByAdapter;
+    private buildPreparedMessage;
+    private resolveThumbnailWidth;
+    private resolveThumbnailHeight;
+    private resolveUploadMetadata;
+}
+export {};

package/upload/constants.d.ts

@@ -0,0 +1,8 @@
+export declare const MULTIPART_THRESHOLD: number;
+export declare const DEFAULT_PART_SIZE: number;
+export declare const MAX_POOL = 4;
+export declare const FILE_CONVERSATION_TYPES: {
+    readonly single: "CHAT";
+    readonly group: "GROUP";
+    readonly room: "ROOM";
+};

package/upload/index.d.ts

@@ -0,0 +1,2 @@
+export * from './attachment-uploader';
+export * from './types';

package/upload/multipart-upload.d.ts

@@ -0,0 +1,14 @@
+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>;

package/upload/simple-upload.d.ts

@@ -0,0 +1,3 @@
+import type { UploadRequest } from './types';
+import { buildUploadResult } from './utils';
+export declare const simpleUpload: (request: UploadRequest) => Promise<ReturnType<typeof buildUploadResult>>;