@16x/webphone-sdk 3.1.9 → 3.1.10

package/CHANGELOG.md

@@ -1,5 +1,20 @@
 # Changelog
 
+## 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 })`
+  解好再放进会话。
+- 非破坏性：已经自己解好的接入方（含 `createLegacySessionProvider`）拿到的会话对象原样不变；
+  `decryptSipPassword` 的实现搬到 `src/crypto/legacySipTicket.ts`，公开导出与行为保持不变。
+
 ## 3.1.9 - 2026-09-24
 
 > 同日先发过 `3.8.1`（内容与本文完全相同），按项目版本线改成 3.1.9（3.1.8 的补丁位）重新发布；3.8.1 不再维护。