nim-web-sdk-ng 10.9.90 → 10.10.1

package/dist/esm/adapters.d.ts

@@ -307,6 +307,10 @@ export interface AdapterSystemInfo {
      * - 小程序：等于 hostEnv
      */
     manufactor: string;
+    /**
+     * 端设备时区。仅在 adapter 能稳定获取端设备时区时填写，不支持时返回空字符串。
+     */
+    timeZone?: string;
     pushDeviceInfo?: {
         PRODUCT: string;
         DEVICE: string;
@@ -360,6 +364,18 @@ export interface AdapterUploadFileOptions {
     headers?: {
         [key: string]: string;
     };
+    timeout?: number;
+    uploadHostCandidates?: Array<{
+        url: string;
+        source?: 'lbs' | 'default';
+    }>;
+    maxRetry?: number;
+    onUploadAttemptFail?: (info: {
+        url: string;
+        source: 'lbs' | 'default';
+        error: any;
+        kind: 'network' | 'business' | 'communication' | 'server';
+    }) => void;
     onUploadStart?: (task: {
         abort: () => void;
         [key: string]: any;

package/dist/esm/nim/src/CloudStorageServiceInterface.d.ts

@@ -317,6 +317,28 @@ export interface GetFileTokenResult {
     ttl: number;
 }
 export interface NIMEModuleParamCloudStorageConfig {
+    /**
+     * @Multi_Lang_Tag
+     * @locale cn
+     * IM NOS LBS 地址，必须是包含 scheme 和 host 的完整 URL。SDK 默认 'https://lbs.netease.im/lbs/nosconf'
+     * @locale
+     *
+     * @locale en
+     * IM NOS LBS URL. It must be an absolute URL with scheme and host. SDK default: 'https://lbs.netease.im/lbs/nosconf'
+     * @locale
+     */
+    imNOSUploadLBS?: string;
+    /**
+     * @Multi_Lang_Tag
+     * @locale cn
+     * 是否启用 IM NOS LBS。显式设置时使用该值；未设置时由 IM 登录 LBS 地址是否为默认值决定。
+     * @locale
+     *
+     * @locale en
+     * Whether IM NOS LBS is enabled. Explicit values take effect directly. If unset, the default is derived from whether IM login LBS URLs are default.
+     * @locale
+     */
+    enableIMNOSLBS?: boolean;
     /**
      * @Multi_Lang_Tag
      * @locale cn

package/dist/esm/nim/src/NIMInterface.d.ts

@@ -9,6 +9,7 @@ import { SyncOptions } from './SyncServiceInterface';
 import { SystemMessage, TSystemMessageStatus, TSystemMessageType } from './SystemMessageServiceInterface';
 import { Team, TeamMember, TeamMemberType } from './TeamServiceInterface';
 import { NIMServiceName, StrAnyObj } from './types';
+import { NIMAppServiceRegion, NIMEStrAnyObj } from '../../types';
 import { Relations, UserNameCard } from './UserServiceInterface';
 import { NIMEInstanceStatus, V1NIMLoginKickOptions, V1NIMLoginKickResult, V1NIMLoginListener, NIMEModuleParamV1Login } from './V1NIMLoginService';
 import { V2NIMFriendServiceConfig } from './V2NIMFriendService';
@@ -192,6 +193,12 @@ export interface NIMInitializeOptions {
      * @locale
      */
     appkey: string;
+    /**
+     * App 服务区域。未持久化 LBS 服务区域时，用于聊天室内置 default link 区域兜底。
+     *
+     * 可选值：NIMAppServiceRegionUnspecified、NIMAppServiceRegionCN、NIMAppServiceRegionSG
+     */
+    appServiceRegion?: NIMAppServiceRegion;
     /**
      * @Multi_Lang_Tag
      * @locale cn
@@ -548,6 +555,12 @@ export declare type NIMOtherOptionsAbtestConfig = {
      * abTest 服务器下发地址
      */
     abtestUrl?: string;
+    /**
+     * 对线上拉取到的 abtInfo 做预处理，返回值会作为实例最终生效的 abtInfo。
+     *
+     * 可用于 ABTest 测试阶段覆盖或调整线上返回配置。
+     */
+    abtestInfoPreprocessor?: (abtInfo: NIMEStrAnyObj) => NIMEStrAnyObj;
 };
 export declare type NIMOtherOptionsPrivateConfig = {
     /**
@@ -568,6 +581,10 @@ export declare type NIMOtherOptionsPrivateConfig = {
      * 上传地址
      */
     nos_uploader?: string;
+    /**
+     * IM NOS LBS 地址
+     */
+    im_nos_lbs?: string;
     /**
      * 下载地址的格式
      */
@@ -638,6 +655,28 @@ export declare type NIMOtherOptionsReporterConfig = {
     isDataReportEnable?: boolean;
 };
 export interface ServerConfig {
+    /**
+     * @Multi_Lang_Tag
+     * @locale cn
+     * IM NOS LBS 地址，必须是包含 scheme 和 host 的完整 URL。SDK 默认 'https://lbs.netease.im/lbs/nosconf'
+     * @locale
+     *
+     * @locale en
+     * IM NOS LBS URL. It must be an absolute URL with scheme and host. SDK default: 'https://lbs.netease.im/lbs/nosconf'
+     * @locale
+     */
+    imNOSUploadLBS?: string;
+    /**
+     * @Multi_Lang_Tag
+     * @locale cn
+     * 是否启用 IM NOS LBS。显式设置时使用该值；未设置时由 IM 登录 LBS 地址是否为默认值决定。
+     * @locale
+     *
+     * @locale en
+     * Whether IM NOS LBS is enabled. Explicit values take effect directly. If unset, the default is derived from whether IM login LBS URLs are default.
+     * @locale
+     */
+    enableIMNOSLBS?: boolean;
     /**
      * @Multi_Lang_Tag
      * @locale cn

package/dist/esm/nim/src/OfflinePushInterface.d.ts

@@ -63,10 +63,15 @@ export interface NIMESetOfflinePushConfigOptions {
     authConfig: NIMEOfflinePushAuthConfig;
 }
 export interface NIMEOfflinePushPlugin {
+    /**
+     * 获取设备 token。回调参数兼容新版本 iOS 插件返回的 { token, pushKitToken } 对象格式。
+     * 注意：V1 模块仅兼容此格式取 token.token 作为 APNs token，不支持 pushkit 证书配置与上报。
+     * 如需 pushkit 功能请使用 V2NIMSettingService。
+     */
     getDeviceToken: (opt: {
         suggestPushType: string;
         config?: NIMEOfflinePushAuthConfig;
-    }, fn: (token: string) => void) => void;
+    }, fn: (token: string | Record<string, string>) => void) => void;
 }
 export interface NIMEOfflinePushAuthConfig {
     /**

package/dist/esm/nim/src/V2NIMConst.d.ts

@@ -200,6 +200,7 @@ export declare const V2NIMErrorCode: {
     V2NIM_ERROR_CODE_INTERRUPTION_REJECTED: number;
 };
 export declare const V2NIMErrorDesc: NIMEStrAnyObj;
+export { NIMAppServiceRegion } from '../../types';
 export { V2NIMDataSyncLevel, V2NIMDataSyncType, V2NIMDataSyncState } from './SyncServiceInterface';
 export { V2NIMConversationType, V2NIMLastMessageState } from './V2NIMConversationService';
 export { V2NIMFriendAddMode, V2NIMFriendAddApplicationType, V2NIMFriendAddApplicationStatus, V2NIMFriendDeletionType, V2NIMFriendVerifyType } from './V2NIMFriendService';

package/dist/esm/nim/src/V2NIMLoginService.d.ts

@@ -667,4 +667,12 @@ export declare type NIMEModuleParamV2Login = {
      * 注: 传 false 将允许 LBS 和 Websocket 连接使用 http 和 ws 协议. 不推荐使用.
      */
     linkSSL?: boolean;
+    /**
+     * 是否启用网络可达性探测上报。默认 true。
+     *
+     * 注: 该能力仅用于在 login、chatroomLogin、LinkKeep 等 SDK 数据上报中追加 net_probe 字段，
+     * 不会改变连接、心跳、断线或重连行为。设置为 false 时，SDK 不读取网络探测 ABTest 配置、
+     * 不发起探测请求，也不追加 net_probe。
+     */
+    networkProbeEnable?: boolean;
 };

package/dist/esm/nim/src/V2NIMSettingService.d.ts

@@ -216,6 +216,10 @@ export interface V2NIMOfflinePushConfig {
      * 苹果推送配置，需要填写: certificateName
      */
     apns?: V2NIMManufacturerPushConfig;
+    /**
+     * 苹果 pushkit 推送配置. 需要填写: certificateName
+     */
+    pushkit?: V2NIMManufacturerPushConfig;
     /**
      * 华为推送配置，需要填写: appId, certificateName
      */