Keyboard shortcuts

Press ← or → to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

oak-internal-sdk 更新日志

当前 package1.1.5
最新 tag1.1.4
覆盖区间1.1.3..1.1.4 / 1.1.4..HEAD

1.1.5 未发布（区间：1.1.4..HEAD）

未发布加密 endpoint、声明输出和 TS6 兼容调整。
  • EncConnector 增加 endpoint 调用能力：前端实现 callEndpoint、openEndpointStream、callSSEEndpoint、makeEndpointUrl，并按 routerPrefixes.endpoint 生成 endpoint 地址。
  • 加密 SSE endpoint 打通前后端：服务端 serializeSSEEndpointResult 会在请求头 oak-encrypted: 1 且存在 session key 时，把 SSE data: packet 加密后输出；前端 callSSEEndpoint 会按 oak-encrypted 响应头逐包解密并分发事件。
  • 前端 SSE client 支持 onMessage、按事件名 on、onError、onDone、close；event: error 中携带的 Oak exception 会通过 makeException 还原。
  • src/index.ts 除 SafeConnector 外，新增导出 utils/env 和 adaptor/memoryAdaptor，方便消费端直接拿到加密连接器和内存 adaptor。
  • package.json 增加 oak.es.optimize.includeDeps，显式包含 crypto-js/sha256、crypto-js/enc-hex，避免 ESM 优化时漏掉 SafeConnector 需要的 crypto-js 子路径。
  • 移除 lodash / @types/lodash，开发态 oak-domain 改为 file:../oak-domain，并移除 downlevelIteration 以适配当前 TS 构建参数。
  • formate.d.ts 的 BaseEntityDict 引用按 es/lib 产物分别改成 oak-domain/es/index、oak-domain/lib/index，避免声明输出指到不匹配的入口。
  • 编译产物 es/、lib/ 已同步更新。
  • connector 错误日志不再直接输出原始错误对象，避免把请求或加密上下文中的敏感细节写入普通日志。
主要 diff 文件：package.json、src/index.ts、src/utils/env/impls/backend.ts、src/utils/env/impls/frontend.ts、tsconfig*.json、es/*.d.ts、lib/*.d.ts

1.1.4（tag：1.1.4，区间：1.1.3..1.1.4）

已发布i18n、Vite build 和 adaptor 输出整理。
  • 增加 i18n 相关能力。
  • oak-domain 转为 peerDependencies / version reference。
  • 增加 Vite build / alias 支持。
  • memory / redis adaptor 输出整理。
  • exception data debug、clock drift exception、parseRequest array bug 和 class name preservation 修复。

升级注意

peer 依赖：依赖该包的内部服务应对齐 peer 中的 oak-domain 版本，不要再假设它由 internal sdk 直接带入。
SSE 同步升级：加密 SSE endpoint 需要前端 callSSEEndpoint 与服务端 serializeSSEEndpointResult 配套升级。只升级一端时，客户端可能把加密后的 data: 当普通 JSON 解析，或服务端返回未加密流导致敏感数据明文传输。
Endpoint 路径：前端 endpoint URL 现在使用 routerPrefixes.endpoint 或默认 /endpoint。自定义网关、反向代理和 CORS expose headers 需要允许 oak-encrypted、oak-nonce 等响应头。