taro-bluetooth-print 2.9.0 → 2.9.1

package/CHANGELOG.md

@@ -5,7 +5,7 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
-## [2.9.0] - 2026-04-07
+## [2.10.0] - 2026-04-07
 
 ### 架构升级
 
@@ -13,6 +13,17 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 - **接口分离**: 将 `services/interfaces/index.ts` 拆分为独立文件 (`IConnectionManager.ts`, `IPrintJobManager.ts`, `ICommandBuilder.ts`)，改善依赖管理
 - **错误类层次**: 新增 `ConnectionError` / `PrintJobError` / `CommandBuildError` 专用错误类，继承自 `BluetoothPrintError`
 - **BluetoothPrinter 简化**: 移除构造函数向后兼容逻辑，使用清晰的依赖注入模式
+- **validation.ts 拆分**: 1155 行拆分为 `validators/` 目录（types/common/printer/buffer/uuid/number/object/array/chain）
+- **TemplateEngine.ts 拆分**: 1114 行拆分为 `parsers/TemplateParser.ts` + `engines/TemplateRenderer.ts`
+
+### 修复
+
+- **MultiPrinterManager 内存泄漏**: `disconnect()` 时移除 error 事件监听器，防止反复连接/断开时监听器堆积
+
+### 测试
+
+- 补充分类测试覆盖：CommandBuilder (33)、ConnectionManager (37)、PrintJobManager (31)、PrinterFactory (11)、错误类扩充 (+17)
+- 总测试数：648 → **789** (+141)
 
 ### 导出新增
 
@@ -404,3 +415,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 - 初始版本发布
 - 基础蓝牙打印功能
 - 微信小程序支持
+
+---
+
+_以上内容由 AI 助理自动生成_

package/README.md

@@ -69,7 +69,7 @@ pnpm add taro-bluetooth-print
 ```
 
 ```typescript
-import { BluetoothPrinter, DeviceManager } from 'taro-bluetooth-print';
+import { createBluetoothPrinter, DeviceManager, WebBluetoothAdapter } from 'taro-bluetooth-print';
 
 async function print() {
   // 1. 扫描设备
@@ -82,8 +82,11 @@ async function print() {
     return;
   }
 
-  // 2. 连接打印机
-  const printer = new BluetoothPrinter();
+  // 2. 创建打印机实例（推荐方式）
+  const printer = createBluetoothPrinter({
+    adapter: new WebBluetoothAdapter()
+  });
+
   await printer.connect(devices[0].deviceId);
 
   // 3. 链式调用打印
@@ -140,7 +143,7 @@ async function print() {
 ## 配置与事件
 
 ```typescript
-const printer = new BluetoothPrinter();
+const printer = createBluetoothPrinter();
 
 // 传输参数
 printer.setOptions({
@@ -155,6 +158,7 @@ printer.on('progress', ({ sent, total }) => {
 });
 
 printer.on('error', (error) => {
+  // error 是 BluetoothPrintError 的实例
   console.error('错误:', error.code, error.message);
 });
 
@@ -163,12 +167,57 @@ printer.on('print-complete', () => {
 });
 ```
 
+### 错误类层次
+
+```typescript
+import {
+  BluetoothPrintError,
+  ConnectionError,
+  PrintJobError,
+  CommandBuildError,
+  ErrorCode
+} from 'taro-bluetooth-print';
+
+// 统一错误基类
+try {
+  await printer.print();
+} catch (err) {
+  if (err instanceof BluetoothPrintError) {
+    console.log(err.code, err.message);
+  }
+}
+
+// 专用错误类型（推荐用于精确处理）
+try {
+  await printer.connect(deviceId);
+} catch (err) {
+  if (ConnectionError.isConnectionError(err)) {
+    // 连接失败：重试或提示用户
+    console.log('连接错误:', err.message);
+  }
+}
+
+try {
+  // ... 打印操作
+} catch (err) {
+  if (PrintJobError.isPrintJobError(err)) {
+    // 打印任务失败：重新排队
+    console.log('任务错误:', err.message);
+  }
+}
+```
+
 ---
 
 ## 架构
 
 ```
   ┌─────────────────────────────────────────┐
+  │         PrinterFactory (createPrinter)      │
+  │  createBluetoothPrinter · createWebBluetooth │
+  └────────────────────┬────────────────────┘
+                       ▼
+  ┌─────────────────────────────────────────┐
   │           BluetoothPrinter (Core)        │
   │  text() feed() qr() cut() image() print()│
   └──────────────┬──────────────────────────┘