@16x/webphone-sdk 3.1.17 → 3.1.19

package/CHANGELOG.md

@@ -1,31 +1,267 @@
-# Changelog
-
-## 3.1.17
-
-修复平台抖动后 dial 永久不可自愈（CALL_NOT_CONNECTED）——与主线 3.2.8 同源修复：
-
-- `ReconnectManager` 新增 `isRecovered` 校验：recover() 成功返回不再被当作连接已恢复，未恢复按失败继续退避。
-- `recoverInvalidSession` 重建失败不再 `reconnect.cancel()` 永久取消重连循环（事故主根因），保持封顶退避重试。
-- `recoverConnection` 在会话被清空后改走 `performConnect` 全新建会话；在途通话超过 120s 宽限后强制终态（终态事件不可达时）。
-- 媒体释放屏障增加 5s 超时，防止永不 settle 的释放操作锁死重连。
-
-## 3.1.16 - 2026-10-08
-
-- 修正客户专属发布版本号与 npm dist-tag 对齐；此版本运行时代码与 3.1.15 相同。
-
-## 3.1.15 - 2026-10-08
-
-- 回移 3.2.6–3.2.7 的 ICE 改进：增加 ICE gathering 3 秒兜底、按 URL 探测 ICE 服务，并将探测结果区分为可用、不可用和未知。
-- 探测在后台运行，不阻塞拨号；未知结果不永久删除 ICE 地址。后续新通话可使用 5 分钟内最近验证可用的配置，并在网络恢复、SIP 重连、ICE 失败或缓存过期时重新探测。
-- 增加有退避上限的重试及 ICE 诊断字段。
-- 保持 3.1.x 客户服务端 `getToken`、`getAccount` 和会话组装流程不变；未更改 SDK 的双接口对接契约。
-
-## 3.1.12 - 2026-10-06
-
-- 保持既有 `sessionProvider` 接入契约：客户服务端继续完成 `getToken`、`getAccount` 和会话组装，SDK 接收完整会话；本版本不改变该流程。
-- 升级 JsSIP 到 3.13.8。
-- 增加外呼号码与 SIP URI 格式校验，非法目标在创建 SIP 通话前返回 `CALL_INVALID_DESTINATION`。
-- hold/unhold 操作失败时保留底层原因；区分本地保持与远端保持，并拒绝不适用的本地恢复操作。
-- `CCBarError` 增加客户可读的 `message`，保留稳定字符串 `code`，并支持传递平台数字 `platformCode`。
-- 合并并发 `client.connect()` 调用，避免重复执行凭证失效钩子；坐席状态在运行时校验。
-- 改进内置通话组件的错误提示展示。
+# Changelog
+
+## 3.1.19
+
+新增 i18n 多语言支持（中文 / 英文 / 印尼语 / 西班牙语）：
+
+- 新增 `src/i18n` 四语言错误消息表；`CCBarClient` 构造时按 `options.locale` 设置语言，未传时回落浏览器语言（`navigator.language`），最后默认 `zh-CN`；BCP 47 前缀归一化（`zh` → `zh-CN`、`in-ID` → `id-ID` 等），未知语言回落默认。
+- `CCBarError` 构造时按当前语言输出文案，新增 `localizedMessage(locale?)` 按指定语言取文案。
+- SharedWorker attach 请求携带 locale，worker 侧错误文案与页面侧保持一致。
+- UI 组件（XCallCCBarElement）文案由 `locale` 属性决定，新增印尼语 / 西班牙语两套 UI 文案。
+
+## 3.2.9
+
+修复通话失败原因被统一包装成「当前通话状态不支持此操作」的误导文案：
+
+- `CallManager.failureError` 新增 SIP 拒绝载荷映射：对方挂断/平台拒绝（480/488/4xx-6xx 家族）→ `CALL_REJECTED`（"对方或呼叫平台拒绝了本次呼叫"），486/BUSY → `CALL_BUSY`，408/Request Timeout → `NETWORK_TIMEOUT`。
+- 此前 JsSIP 原始失败载荷（`{originator:'remote', message:{data:'SIP/2.0 4xx…'}}`）一律落入 `CALL_OPERATION_NOT_ALLOWED` 兜底，文案指向状态机，严重误导排障方向（实测复现：拨不存在分机收到 480、平台 488 拒绝时均显示"当前通话状态不支持此操作"）。原始载荷完整保留在 `error.cause`。
+- 无 SIP 信息的未知载荷行为不变（仍为 `CALL_OPERATION_NOT_ALLOWED`），`CALL_REJECTED`/`CALL_BUSY` 错误码自此真正被 SIP 层触发。
+
+## 3.2.8
+
+修复平台抖动后 dial 永久不可自愈（CALL_NOT_CONNECTED）：
+
+- `ReconnectManager` 新增 `isRecovered` 校验：recover() 成功返回不再被当作连接已恢复，未恢复按失败继续退避。
+- `recoverInvalidSession` 重建失败不再 `reconnect.cancel()` 永久取消重连循环（3.2.7 事故主根因），保持封顶退避重试。
+- `recoverConnection` 在会话被清空后改走 `performConnect` 全新建会话；在途通话超过 120s 宽限后强制终态（终态事件不可达时）。
+- 媒体释放屏障增加 5s 超时，防止永不 settle 的释放操作锁死重连。
+
+## 3.2.7 - 2026-10-08
+
+- Treat ICE probe timeouts as unknown instead of permanently marking servers unavailable; preserve
+  the original ICE pool for later re-probing.
+- Keep ICE probing in the background so it does not block dialing. Use recently available ICE
+  servers for new calls with a five-minute cache, and re-probe after network recovery, SIP
+  reconnection, ICE failure, or cache expiry.
+- Add bounded retry backoff and diagnostics for probe state, unknown/unavailable URL counts, cache
+  age, and the ICE configuration selected for the next call.
+
+## 3.2.6 - 2026-10-07
+
+- Fix the multi-egress-office dial delay at its root: a dead STUN/TURN-UDP endpoint dragged JsSIP's
+  non-trickle ICE gathering through the browser retransmission tables (~40s measured with both
+  STUN binding and TURN allocation retrying in parallel) even though a usable TURN-TCP relay
+  candidate was already available at ~150ms.
+- Attach an ICE gathering timeout to every outgoing/incoming session: call JsSIP's built-in
+  `icecandidate` `ready()` shortcut as soon as an srflx/relay candidate arrives, and force-close
+  the local SDP with the most recent ready callback after 3s so INVITE/200 OK never waits for
+  dead servers (mirrors ccbar BUG-013).
+- Add URL-level ICE server probing after each successful registration (`iceServerQuality`):
+  every stun/turn/turns URL is probed with its own PeerConnection (credentials inherited);
+  URLs that yield no srflx/relay are dropped from the dial-time pcConfig. Healthy networks keep
+  the original list unchanged (zero behavior change); when every URL fails the list becomes
+  host-only so the INVITE still goes out immediately. Attribution must be per-URL because relay
+  candidates always report `protocol: udp` (it describes the relayed port, not the client
+  transport) and mixing dead and live URLs in one probe drags them all to timeout.
+- `getDiagnostics()` now includes an `ice.probe` summary (runs / lastMs / udpOk / tcpRelayOk /
+  convergedServers) from the tab-local adapter (absent in SharedWorker mode).
+- Correct the `warmIceCandidatePool` comment: `iceCandidatePoolSize` is per-RTCPeerConnection,
+  so warmed candidates cannot transfer to call connections — the timeout + convergence above
+  are the actual safeguards. `answer()` now also passes `iceCandidatePoolSize`.
+
+## 3.2.5 - 2026-10-06
+
+- Keep held-call state synchronized with the call controls so resume, hangup, and DTMF remain available after a hold transition.
+- Show a specific authentication-token-unavailable message in the embedded phone UI and document the recovery steps.
+
+## 3.2.4 - 2026-10-05
+
+- Prevent overlapping hold/resume requests and include actionable `cause.reason` values when an operation is already pending or JsSIP rejects a hold change.
+- Track local and remote hold origins separately; reject a local resume request while only the remote party has held the call.
+- Document hold/resume completion and diagnostic causes.
+
+## 3.2.3 - 2026-10-04
+
+- Give `CCBarError.message` customer-readable Chinese text while keeping stable string `code` values for programmatic handling.
+- Preserve numeric platform response codes as optional `platformCode`; normalize token rejection from the seat account API without mislabeling every 401 as an expired token.
+- Carry `platformCode` and readable messages through SharedWorker serialization.
+
+## 3.2.2 - 2026-10-04
+
+- Reject malformed outbound destinations before creating a call or sending a SIP INVITE; preserve 3–20 digit phone numbers and SIP/SIPS URI destinations.
+- Document the destination formats and the non-retryable `CALL_INVALID_DESTINATION` error.
+
+## 3.2.1 - 2026-10-04
+
+- 修复运行时传入不支持的坐席状态（例如 `busy`）时出现未处理 TypeError 的问题；现在会返回明确的 `CONFIG_INVALID` SDK 错误，并且不会发送状态请求。
+- 明确覆盖 `getToken()` 返回 `accessToken`、但账号接口拒绝该凭证时的认证错误信息，便于接入方定位凭证类型或权限问题。
+
+## 3.2.0 - 2026-10-03
+
+- 新增 `createTokenSessionProvider` 根入口，客户可通过 `getToken` 提供短期凭证；SDK 内部完成坐席账号获取、SIP 会话创建、注册登录、凭证刷新和坐席状态请求。
+- 重复调用 `client.connect()` 时复用进行中的连接流程，已连接时直接返回，避免重复获取凭证和重复初始化连接。
+- 完善接入文档，说明连接、坐席、通话状态，事件与错误处理，以及 `userdata` 到 SIP header 和话单字段的映射方式。
+- 补充 9196、9199 实时验收及凭证错误、网络中断、STUN 异常和资源清理场景。
+
+## 3.1.11 - 2026-09-30
+
+- **破坏性变更（会话来源）**：会话来源工厂的 `sipWsUrl` 改为**必填**，软电话地址
+  由接入方传完整地址（`wss://` / `ws://`）。SDK 不再按坐席账号的 `domain` / `wssPort`（缺省 7443）
+  与固定路径 `/api/fs/sip-ws` 拼装，`sipWsPath` 选项删除；缺 `sipWsUrl`、传相对路径或 `http(s)://`
+  地址时，建会话（`createSession` / `refreshSession`）抛 `CONFIG_INVALID`（**构造本身不抛**）。
+- 地址上已有的查询参数保留，SDK 仍把 fs token 挂成 `?token=`（`attachTokenToWss: false` 可关掉）。
+- 只影响使用兼容会话入口的调用方；服务端下发完整 `transport.wssUrl` 的接入方式不受影响。
+
+## 3.1.10 - 2026-09-24
+
+- **会话入口自动识别密文**：接入方把 `seat/account/get` 返回的 `password` 密文**直接**塞进
+  `session.sip.registerTicket` 时，SDK 现在会在会话进入的那一处（`createSessionProviderApi`）
+  先用平台内置 key/iv 解一次，解不出来就原样放行 —— 服务端因此可以只做转发，
+  不必再自己调 `decryptSipPassword`。
+- 判定条件收得很紧，避免把明文密码当密文解坏：合法 Base64、长度是 4 的倍数、解码后是 16 字节的整数倍、
+  AES 解出的文本没有替换符与控制字符。固定种子采样（字母数字 8~40 位、32 位十六进制、
+  以及「刚好是 16 字节 Base64 带 `=` 填充」这种最危险的形状）实测没有误判。
+- 只认平台内置的 key/iv（即 `decryptSipPassword` 的默认值）：环境不同、key/iv 被改过时，
+  自动判定会失败并退回原值，这种环境仍需接入方自己用 `decryptSipPassword(cipher, { key, iv })`
+  解好再放进会话。
+- 非破坏性：已经自行解密的接入方拿到的会话对象原样不变；`decryptSipPassword` 的实现移入独立加密模块，
+  公开导出与行为保持不变。
+
+## 3.1.9 - 2026-09-24
+
+- **坐席状态接口直接用会话里的那张票**：平台把 fs token 拼在软电话地址上（`wss://…/api/fs/sip-ws?token=…`），
+  同一个 token 也用于 HTTP 接口的 `Authorization`。`client.setAgentStatus()` 现在把这个地址带给会话来源
+  （`SessionProvider.setAgentStatus(request, context?)`，新增可选参数 `AgentStatusContext.wssUrl`），
+  订阅来源可以直接拿它去打 `seat/account/get` 与 `seats/set-status`，**不再单独换一次票**。
+- 会话来源的 `setAgentStatus` 按这个顺序取票：
+  会话地址里的 token → 最近见过的那个（退签时会话已经断开）→ `getToken`/`tokenUrl` 重新换票（与旧行为一致）。
+  它自己在 `createSession` 里拼过 WSS 地址时也会记住那张票；`invalidateToken()` 会把它一起清掉。
+- 非破坏性：`setAgentStatus` 的第二个参数是可选的，旧接入方（不传 context、只用 `getToken`/`tokenUrl`）行为不变。
+
+## 3.1.8 - 2026-09-23
+
+- **修 3.1.7 引入的回归：来电会被立刻拒掉（对端收到 480）。**
+  3.1.7 新加的 `mediaConnected` 订阅在「会话还没有 PeerConnection」时崩了：JsSIP 的
+  `session.connection` 在 PC 建好之前返回的是 **`null`，不是 `undefined`**（来电要等 `answer()`
+  才建 PC），而那处只判了 `undefined` → `null.addEventListener` 抛 TypeError →
+  `CCBarCall` 构造函数的 catch 里 `terminate()` → 页面收到一个包着 `CALL_OPERATION_NOT_ALLOWED`
+  的错误，对端收到 `480 Temporarily Unavailable`（SIP 原文里是 `newRTCSession` 后 1ms 就 `terminate`）。
+  现在按 `null` 处理：PC 还没建就只挂 `peerconnection` 监听，等它出现再挂 `connectionstatechange`。
+- 同一处一并修了 `getMediaRegistration()`：PC 还没建时不再拿 `null` 去建媒体注册对象
+  （那个对象之后一被用就会抛；来电在 answer 之后的状态变化里会重新注册，不受影响）。
+- 类型跟着改了：`jsSipTypes.ts` 里 `connection` 声明为 `RTCPeerConnection | null` ——
+  这个 bug 正是被「只写了 undefined」的类型漏过去的，改完之后 `tsc` 会把同类问题拦住。
+- 补用例：会话 `connection` 为 `null` 时订阅 `mediaConnected` 不能抛；测试里的假 JsSIP 会话
+  现在默认就是 `null`（与真实 JsSIP 一致）。
+
+
+## 3.1.7 - 2026-09-23
+
+- **`active` 不再只认 SIP 的 ACK**：新增会话事件 `mediaConnected` —— 媒体真的通了（ICE + DTLS 完成）时，
+  只要通话已经进入 `connecting` 就推进到 `active`。
+  背景：`active` 原来只由 JsSIP 的 `confirmed` 驱动，而它要等对端回 ACK。有些平台（SBC）不回 ACK：
+  200 OK 之后音频已经通了、双方都在通话，`confirmed` 却永远不来，页面就一直停在「接通中」
+  （3.1.6 之前停在「振铃中」，那是同一现象的另一个表现，见 3.1.6 第一条）。
+- 只从 `connecting` 推进：`ringing` / `dialing` 阶段的连接可能只是早期媒体（回铃），不算接通。
+- `CallSessionEvent` 增加 `'mediaConnected'`（新增事件，对已有集成无影响）；JsSIP 适配器在
+  PeerConnection 的 `connectionstatechange` 变成 `connected` 时发一次，通话结束时撤掉会话上的订阅。
+- 仍未解决、且**在平台侧**的一点：如果平台始终不回 ACK，JsSIP 自己的 ACK 定时器会在 32 秒后以
+  `NO_ACK` 结束这通电话。SDK 不能替对端回 ACK，只能让状态先跟上事实；平台侧需补齐 ACK。
+
+
+## 3.1.6 - 2026-09-23
+
+- **接听后立刻进入 `connecting`**：原来要等 JsSIP 的 `accepted`（也就是 200 OK 真发出去之后）才动状态。
+  背景：`answer()` 只让 JsSIP 同步进入 ANSWERED，200 OK 还要等本地媒体/SDP 准备好（首次通话还要等
+  麦克风授权），这十几秒里状态一直停在 `ringing` —— 页面上就是「点了接听没反应、状态还是振铃中」，
+  用户会以为没接上。现在点完接听立刻走 `ringing → connecting`，随后的 `accepted` / `confirmed`
+  照旧推到 `active`（公开状态链 `ringing→connecting→active` 不变，已有用例覆盖）。
+- 修 `hangup()`：terminate 之后若通话已被推成终态（JsSIP 对未确认的来电会**同步**发 `failed`），
+  不再多做一次非法的 `failed → ended` 转换 —— 那一帧会多抛一个 `CALL_OPERATION_NOT_ALLOWED`，
+  页面红字行/日志里就多一条看不懂的报错。
+- 修媒体收尾的噪音：通话结束解绑发送通道时，若连接已经关闭（WebRTC 规定此时 `replaceTrack` 抛
+  `InvalidStateError`），按「没有东西可解绑」处理，不再报 `SDK_INTERNAL_ERROR`
+  （典型现象：挂断瞬间刷一条 `replaceTrack ... The peer connection is closed`）。
+- 接听 / 拒接失败时**先把原始原因报出来**再 terminate 清理：terminate 会同步触发 JsSIP 的 `failed`
+  （cause 固定是 `REJECTED`），原来的原因会被这个终态盖掉 —— 之前只能看到 `REJECTED`，
+  看不到「为什么接听会失败」。现在先经 `error` 事件把原始 cause 带出去。
+
+
+## 3.1.5 - 2026-09-23
+
+- 新增 `dial({ destination, userdata })`：自定义参数原样写进 INVITE 的 `X-User-Data` 头，由平台/服务端从 SIP
+  报文里读 —— 就是旧版脚本 SDK 的 `userdata`，头名与含义都没变，平台侧不用改。未传、空串、纯空白＝不带头
+  （与旧行为逐字一致）；`dial({ destination, userdata: '' })` 也不会多出任何头。
+- 只接受可见 ASCII：换行/制表能伪造出新的 SIP 头，中文等非 ASCII 不合规（中间设备可能吞掉或改写），
+  两者都抛 `CALL_INVALID_USERDATA`（`category: 'call'`、`retryable: false`，处置建议放在 `cause` 里）。
+  要传中文或 JSON 请调用方先 `encodeURIComponent` / base64，再在平台侧解回来。
+- 校验在建通话之前完成：非法值不占并发额度、也不留 pending —— 否则同号紧接着再拨会撞 `CALL_ALREADY_EXISTS`。
+- 注意：SDK 不暴露 SIP 头，页面侧读不到这个值（`call.incoming` 只给 `callId` / `from`）；它是对平台/服务端说的，
+  页面上要排障只能像演示页那样打开 JsSIP 的 debug 抓 console 原文。
+
+
+## 3.1.4 - 2026-09-22
+
+- **移动端形态（`platform: 'mobile-web'`）可以接来电了**：能不能接听改由会话策略 `policy.mobileIncomingEnabled` 决定
+  （这个字段契约里一直有、之前只声明没实现）。打开时保留 `inbound` 能力，来电正常进 `call.incoming`、可以 `answer()`；
+  `false` 或缺省时行为与旧版完全一致（来电直接拒掉，`CAPABILITY_NOT_SUPPORTED`）。保持 / 转接仍然不在移动端支持
+  （移动 UI 上没有这两个操作），并发数仍是 1。
+- 背景：`mobile-web` 之前无条件删掉 `inbound`，导致手机浏览器「能打出去、别人打不进来」——被叫把 INVITE 直接结束，
+  主叫那边只会看到平台转出来的 `480 Temporarily Unavailable`（`Q.850 cause=16 NORMAL_CLEARING`），页面连来电浮层都不弹。
+  注意 `platform` 不传时 `detectPlatform()` 命中 `iPhone|iPad|Android` 会自动选 `mobile-web`，所以这个坑对手机端接入方是默认生效的。
+- `CallManager.answer` / `CCBarCall.answer` 的「按平台一刀切」改成按能力判断（会话说了算）：
+  平台若给移动端授予 `inbound`，同样能正常接听。
+
+
+## 3.1.3 - 2026-09-22
+
+- 新增可选构造参数 `agentTerminal`：设了就在 INVITE / REGISTER 上带 `X-Agent-Terminal` 并作为 UA 的
+  User-Agent。**默认不发**（旧版脚本 SDK 的两种做法都能外呼：xcall fork 带 `'ccbar坐席'`，另一个参考页完全不带）。
+- 会话定时器默认关闭（`session_timers: false`，与旧版脚本 SDK 一致），呼叫参数用 `sessionTimersExpires: 120`：
+  开着时 INVITE 会多出 `Session-Expires` / `Supported: timer`。可用 `sipSessionTimers: true` 打开。
+- 注册成功后先建一个带 `iceCandidatePoolSize` 的空连接预热候选（`warmIceCandidatePool`）：
+  JsSIP 要等 ICE 收集结束才发 INVITE，机器上有虚拟网卡/不通的 STUN 时收集会拖到几十秒，
+  预热后第一次外呼也能立刻出局。
+
+
+## 3.1.2 - 2026-09-21
+
+- 拨号更快出局：`pcConfig` 带上 `iceCandidatePoolSize: 2`（与旧版 SDK 的 login config 一致）。
+  背景：JsSIP 会等 ICE 收集完成才发 INVITE，不预收集候选时，STUN 的往返会直接变成「点了外呼要等一会儿才拨出去」。
+
+
+## 3.1.1 - 2026-09-21
+
+- 新增 SIP 保活：已注册时每 `sipKeepaliveSeconds`（默认 25 秒）重发一次 REGISTER，撑住 nginx/NAT 上的长连接。
+  起因：浏览器发不了 WebSocket ping，中间设备会静默掐掉空闲的 WSS —— 页面还显示已注册，下一次 INVITE 直接
+  失败（`CALL_OPERATION_NOT_ALLOWED`，JsSIP 的 `NotConnected`）。注册有效期本身比间隔短时不再叠这一层。
+  可用构造参数 `sipKeepaliveSeconds` 调整，`0` 关闭。
+
+
+## 3.1.0 - 2026-09-21
+
+- 新增可选构造参数 `sessionProvider`：由接入方提供会话（`createSession` / 可选 `refreshSession`
+  / `setAgentStatus`），SDK 不再要求必须存在 `/webphone/v1/sessions`。用于把 SDK 接到自建服务或既有平台接口
+  （例如 `token/fs` + `seat/account/get` 那一套）上，`tokenProvider` 与 `sessionProvider` 二选一。
+- `sessionProvider` 缺省 `refreshSession` 时用 `createSession` 重建；缺省 `setAgentStatus` 时抛
+  `CAPABILITY_NOT_SUPPORTED`，不静默失败；没有提供任何来源时构造即报 `CONFIG_INVALID`。
+- `transport.ticket` 为空时不再声明 `xcall-ticket.` 子协议，只发 `sip`：平台把凭据放在
+  WSS URL 的 `?token=` 上，多余子协议会让握手带上一个平台不认识的协议名。
+- REGISTER 的 `register_expires` 改为按 `session.sip.registerExpires` 走（原先前端写死 300 秒），
+  会话没给或给了非正数时才回退 300。平台侧要按自己的注册策略下发这个值。
+- 打包脚本在缺少 `zip` 命令的环境（如未装 zip 的 Windows）回退到系统自带 `tar`，交付包仍为 `.zip`。
+
+## 3.0.2 - 2026-09-21
+
+- 修复 disconnect 后仍挂着的 `online`/`offline` 监听，以及 `deletedSessions` 墓碑无限增长。
+- `CallManager` 在通话结束通知完成后删除 terminal 记账；`dispose` 仍会清空剩余 maps。
+- `WebPhoneApi` 的 fetch 使用 `credentials: 'omit'`；SIP `wssUrl` 仅允许 `wss:` 或 loopback `ws:`。
+- React / Vue 在应用卸载时 `dispose()`；Vanilla default-ui 与 Mobile H5 通过 `ownsClient` 在组件卸载时释放。
+- 传入 `sharedWorker` 时 `CCBarClient` 会 attach 同源 Worker，并在 `dispose()` 时先 detach 再关闭端口；SIP 仍是单标签页。
+- 诊断报告中的 SDK 版本与 `@16x/webphone-sdk@3.0.2` 对齐。
+
+## 3.0.1 - 2026-09-19
+
+- 以 `@16x/webphone-sdk` 发布到 npmjs：https://www.npmjs.com/package/@16x/webphone-sdk
+- 发布 WebPhone SDK 3.0.1，包含 WSS ticket 通过 `Sec-WebSocket-Protocol` 传递及 API 主机相对路径解析修复。
+
+## 0.1.0 - 2026-09-18
+
+- 完成 Headless Core 生命周期、SIP/通话控制、媒体设备、重连与脱敏诊断能力。
+- 提供 ESM、CJS、UMD、类型声明及根入口、UI、兼容、诊断与样式入口。
+- 新增 `CCBarSDK` 兼容层，按设计映射连接、拨号、当前通话控制和坐席状态方法。
+- `insideCall(number)` 在当前 `DialOptions` 不支持 `type` 时保留原目标号码，不添加隐式前缀。
+- `setBu()` 改为抛出明确的 `DeprecatedError`，不允许浏览器伪造忙碌状态。
+- 兼容 API 弃用提示仅在开发构建中按方法输出一次；生产构建保持安静。
+- 显式加载兼容入口模块时才在浏览器附加 `window.CCBarSDK`，并保持 SSR 导入安全。
+- 增加 50 次初始化、连接、拨号、结束和销毁生命周期资源回收测试。

package/LICENSE

@@ -1 +1 @@
-Copyright 16X. All rights reserved.
+Copyright 16X. All rights reserved.