更新日志
TIP
本页镜像 @appzgatenz/label-print-topbridge-js 的 CHANGELOG.md，随 SDK 每次发版手动同步。
0.6.2
Patch Changes
- 容忍结构化 widget 的拍平点号 schema 字段名。部分 TopBridge App 构建会在
templateschema 中输出price.currency/price.value条目，而非单个父级price字段；planFields现在会把点号前缀（price）注册为结构化字段，使嵌套对象与点路径两种产品输入均可正确通过校验。显式声明的父字段始终优先。
本包的所有重要变更均记录于本文件。0.6.1 及之前的条目在采用 Changesets 时依据带 tag 的 Git 历史重建；之后的条目由 changeset 片段生成。撰写与发布流程见 SDK 仓库的撰写与发布文档。
0.6.1
Patch Changes
- 3c4cf12: 新增
printerSetup.reset()，用于清除打印机的协议配置而不改变 Windows 默认打印机。printerSetup.list()与printerSetup.getOptions()现在也返回描述每台打印机配置的protocol与protocolLabel字段。
0.6.1-beta.0
Patch Changes
- c866d5f: 公开的推送事件契约与 WebSocket API v2 对齐。
TemplateEvent与UserEvent现在是按action区分的判别联合类型；BenefitsData.expiresAt现在可以为null；RefreshTemplatesFullResponse现在区分ok（同步计数）与warning（完整同步已在运行）。
0.6.0
Minor Changes
- aad57ba: 新增
session模块，提供client.session.kickSession()，用于在 SessionBlocked 登录场景下踢除现有 Keycloak 会话以解除阻塞。会话数超限现在以新的TopBridgeSessionError（服务端代码SESSION_LIMIT_EXCEEDED）呈现。 - aad57ba: 新增强制刷新 API：
client.benefits.refreshBenefit()按需重新校验打印权益，client.templates.refreshTemplates()支持完整同步与按 ID 两种模式。
0.5.3
Minor Changes
- 90c7246: 新增
templates.json()，批量获取指定模板的完整 JSON 数据；缺失的模板以警告形式报告，不再使整个请求失败。
0.5.2-beta.1
Minor Changes
- f8bf178: Breaking — BPAC 安装失败原因与 WebSocket API v2 对齐：移除
INSTALL_NOT_COMPLETED，改用INSTALL_FAILED/INSTALL_TIMEOUT；InstallResult.detail更名为message。 - fdd1078: Breaking — 移除 BPAC 字体管理。
addFont/deleteFont不再接受'BPAC'协议；此类请求现在会在客户端被拒绝，因为服务端报告其不受支持。
0.5.2-beta.0
Minor Changes
- a9d94e5: 为
printerSetup新增字符集与字体管理（addCharset/deleteCharset/addFont/deleteFont），含客户端输入校验。 - 1c1b138: 新增异步 BPAC 安装处理——
printerSetup.configure()现在会桥接pending安装状态，并在 BPAC 向导完成后 resolve。 - 1c1b138: 改进连接韧性：共享连接在空闲宽限期后自动关闭；重连采用带抖动的指数退避，并限制尝试次数。
0.5.0
Minor Changes
- 168f2ad: 新增
printerSetup模块，用于配置已安装的打印机（加载选项、列出打印机、更新设置）。 - 0525054: 引入混合连接模型：轻量请求与服务端推送事件（
printer/template/user）共享一条由ConnectionManager管理的长连接，而print保持独立短连接以避免队头阻塞。 - 0525054: 通过
client.events新增类型化推送事件订阅、显式连接控制（client.connect()/client.close()/client.getConnectionState()），以及新的TopBridgePrinterSetupError。
0.5.0 之前的版本（0.3.x–0.4.0）早于 changelog 跟踪机制，本文件不覆盖。