taro-bluetooth-print 2.7.0 → 2.8.3

package/src/device/DiscoveryService.ts

@@ -1,43 +1,51 @@
+/* eslint-disable @typescript-eslint/no-explicit-any, @typescript-eslint/no-unsafe-member-access, @typescript-eslint/no-unsafe-assignment, @typescript-eslint/no-unsafe-call, @typescript-eslint/no-unsafe-argument */
+/**
+ * @fileoverview DiscoveryService uses dynamic adapter loading for platform-specific Bluetooth operations.
+ * The platformAdapter field is typed as `BaseAdapter | undefined` because different adapters
+ * (TaroAdapter, WebBluetoothAdapter, ReactNativeAdapter, etc.) are loaded based on runtime platform detection.
+ */
+
 /**
  * DiscoveryService - Enhanced printer discovery service
  * Supports filtering, sorting, auto-retry, and device caching
  */
 
 import { EventEmitter } from '../core/EventEmitter';
+import { IPrinterAdapter } from '../types';
 
 export interface DiscoveredDevice {
   id: string;
   name: string;
-  deviceId: string;           // 原始设备 ID
-  rssi?: number;              // 信号强度
-  appearance?: number;         // 设备类型外观
+  deviceId: string; // 原始设备 ID
+  rssi?: number; // 信号强度
+  appearance?: number; // 设备类型外观
   manufacturerData?: DataView; // 厂商数据
   serviceData?: Map<string, DataView>; // 服务数据
-  txPowerLevel?: number;       // 发射功率
-  lastSeen: number;           // 最后发现时间
-  discoveredCount: number;    // 被发现次数
+  txPowerLevel?: number; // 发射功率
+  lastSeen: number; // 最后发现时间
+  discoveredCount: number; // 被发现次数
 }
 
 export interface DiscoveryOptions {
   filters?: DeviceFilter[];
   sortBy?: SortOption[];
-  timeout?: number;           // 发现超时 (ms)
-  maxDevices?: number;        // 最大设备数
-  enableCache?: boolean;       // 启用设备缓存
-  cacheExpiry?: number;        // 缓存过期时间 (ms)
-  autoRetry?: boolean;        // 自动重试
-  retryInterval?: number;      // 重试间隔 (ms)
-  maxRetries?: number;         // 最大重试次数
+  timeout?: number; // 发现超时 (ms)
+  maxDevices?: number; // 最大设备数
+  enableCache?: boolean; // 启用设备缓存
+  cacheExpiry?: number; // 缓存过期时间 (ms)
+  autoRetry?: boolean; // 自动重试
+  retryInterval?: number; // 重试间隔 (ms)
+  maxRetries?: number; // 最大重试次数
 }
 
 export interface DeviceFilter {
-  name?: string | string[];      // 设备名称 (支持通配符 * 或正则)
-  namePattern?: RegExp;           // 名称正则
-  rssiThreshold?: number;         // 最低信号强度
-  manufacturerId?: number;        // 厂商 ID
+  name?: string | string[]; // 设备名称 (支持通配符 * 或正则)
+  namePattern?: RegExp; // 名称正则
+  rssiThreshold?: number; // 最低信号强度
+  manufacturerId?: number; // 厂商 ID
   manufacturerDataPrefix?: Uint8Array; // 厂商数据前缀匹配
-  serviceUUIDs?: string[];        // 必需的服务 UUID
-  appearance?: number[];          // 设备外观类型
+  serviceUUIDs?: string[]; // 必需的服务 UUID
+  appearance?: number[]; // 设备外观类型
 }
 
 export type SortOption = 'rssi' | 'name' | 'lastSeen' | 'discoveredCount';
@@ -50,7 +58,7 @@ export interface DiscoveryEvents {
   'discovery-stop': void;
   'discovery-complete': DiscoveredDevice[];
   'discovery-error': Error;
-  'retry': { attempt: number; maxRetries: number };
+  retry: { attempt: number; maxRetries: number };
 }
 
 /**
@@ -134,7 +142,7 @@ export class DiscoveryService extends EventEmitter<DiscoveryEvents> {
   private options: Required<DiscoveryOptions>;
   private isDiscovering: boolean = false;
   private stopTimeout: ReturnType<typeof setTimeout> | null = null;
-  private platformAdapter?: any; // Platform-specific Bluetooth adapter
+  private platformAdapter?: IPrinterAdapter; // Platform-specific Bluetooth adapter
 
   constructor(options: DiscoveryOptions = {}) {
     super();
@@ -154,7 +162,7 @@ export class DiscoveryService extends EventEmitter<DiscoveryEvents> {
   /**
    * 设置平台适配器
    */
-  setPlatformAdapter(adapter: any): void {
+  setPlatformAdapter(adapter: IPrinterAdapter): void {
     this.platformAdapter = adapter;
   }
 
@@ -175,7 +183,8 @@ export class DiscoveryService extends EventEmitter<DiscoveryEvents> {
     }
 
     try {
-      const devices = await this.platformAdapter?.requestDevices?.() ?? [];
+      // eslint-disable-next-line @typescript-eslint/no-explicit-any
+      const devices = (await (this.platformAdapter as any)?.requestDevices?.()) ?? [];
       this.processDevices(devices);
     } catch (error) {
       this.emit('discovery-error', error as Error);
@@ -198,7 +207,7 @@ export class DiscoveryService extends EventEmitter<DiscoveryEvents> {
       this.stopTimeout = null;
     }
 
-    this.platformAdapter?.stopDiscovery?.();
+    void this.platformAdapter?.stopDiscovery?.();
 
     if (this.isDiscovering) {
       this.isDiscovering = false;
@@ -219,6 +228,7 @@ export class DiscoveryService extends EventEmitter<DiscoveryEvents> {
   /**
    * 处理单个设备
    */
+  // eslint-disable-next-line @typescript-eslint/no-explicit-any
   private processDevice(deviceInfo: any): void {
     const deviceId = deviceInfo.deviceId || deviceInfo.id;
     const now = Date.now();
@@ -401,8 +411,11 @@ export class DiscoveryService extends EventEmitter<DiscoveryEvents> {
   /**
    * 等待发现指定设备
    */
-  async waitForDevice(predicate: (device: DiscoveredDevice) => boolean, timeout?: number): Promise<DiscoveredDevice | null> {
-    return new Promise((resolve) => {
+  async waitForDevice(
+    predicate: (device: DiscoveredDevice) => boolean,
+    timeout?: number
+  ): Promise<DiscoveredDevice | null> {
+    return new Promise(resolve => {
       const checkTimeout = timeout ?? this.options.timeout;
 
       const checkDevice = (device: DiscoveredDevice) => {

package/src/drivers/SprtDriver.ts

@@ -0,0 +1,163 @@
+/**
+ * SprtDriver (思普瑞特) Driver
+ *
+ * 思普瑞特热敏打印机兼容 ESC/POS 指令集
+ * 官网：https://www.sprt-printer.com/
+ *
+ * 思普瑞特特点：
+ * - 移动蓝牙打印机为主
+ * - 低功耗优化
+ * - 自动休眠/唤醒
+ * - 小票据打印优化
+ */
+
+import { EscPos, type EscPosOptions } from './EscPos';
+
+/**
+ * SprtDriver options (same as EscPosOptions)
+ */
+export type SprtDriverOptions = EscPosOptions;
+
+/**
+ * SprtDriver for Sprt (思普瑞特) thermal printers
+ *
+ * 思普瑞特打印机基于 ESC/POS 指令集，此驱动扩展了标准 EscPos
+ * 添加了思普瑞特特定的命令支持，特别是低功耗相关的功能
+ *
+ * @example
+ * ```typescript
+ * import { SprtDriver } from 'taro-bluetooth-print';
+ *
+ * const driver = new SprtDriver();
+ * let commands = driver.init();
+ * commands = driver.text('Hello 思普瑞特!', 'GBK');
+ * commands = driver.cut();
+ * ```
+ */
+export class SprtDriver extends EscPos {
+  /**
+   * 思普瑞特特定: 进入低功耗/休眠模式
+   * @returns Array of command buffers
+   */
+  sleep(): Uint8Array[] {
+    // ESC = (0x1B 0x3D 0x01) - 设置外设
+    return [new Uint8Array([0x1b, 0x3d, 0x01])];
+  }
+
+  /**
+   * 思普瑞特特定: 唤醒打印机
+   * 发送空字符或特定序列唤醒休眠中的打印机
+   * @returns Array of command buffers
+   */
+  wakeUp(): Uint8Array[] {
+    // 发送空字符唤醒
+    return [new Uint8Array([0x00])];
+  }
+
+  /**
+   * 思普瑞特特定: 深度唤醒
+   * 使用完整的初始化序列唤醒打印机
+   * @returns Array of command buffers
+   */
+  wakeUpDeep(): Uint8Array[] {
+    // 发送多次空字符确保唤醒
+    const commands: Uint8Array[] = [];
+    for (let i = 0; i < 5; i++) {
+      commands.push(new Uint8Array([0x00]));
+    }
+    // 发送初始化命令
+    commands.push(new Uint8Array([0x1b, 0x40])); // ESC @
+    return commands;
+  }
+
+  /**
+   * 思普瑞特特定: 打开钱箱
+   * @param pin 钱箱引脚 (0 或 1, 默认 0)
+   * @returns Array of command buffers
+   */
+  openCashDrawer(pin = 0): Uint8Array[] {
+    // ESC p m t1 t2
+    // m = 0 or 1 (pin)
+    // t1 = 50 (on time)
+    // t2 = 200 (off time)
+    return [new Uint8Array([0x1b, 0x70, pin, 50, 200])];
+  }
+
+  /**
+   * 思普瑞特特定: 发送声响警报
+   * @param times 次数 (1-9)
+   * @param duration 持续时间 (ms)
+   * @returns Array of command buffers
+   */
+  beep(times = 3, duration = 50): Uint8Array[] {
+    // ESC B n t
+    return [new Uint8Array([0x1b, 0x42, times, duration])];
+  }
+
+  /**
+   * 思普瑞特特定: 打印自检页
+   * @returns Array of command buffers
+   */
+  selfTest(): Uint8Array[] {
+    // ESC i (0x1B 0x69) - 自检并返回状态
+    return [new Uint8Array([0x1b, 0x69])];
+  }
+
+  /**
+   * 思普瑞特特定: 获取打印机状态
+   * @returns Array of command buffers
+   */
+  getStatus(): Uint8Array[] {
+    // DLE EOT n (n = 1-4 获取不同状态)
+    // 状态 1: 打印机状态
+    // 状态 2: 脱机状态
+    // 状态 3: 错误状态
+    // 状态 4: 纸张状态
+    const buffers: Uint8Array[] = [];
+    for (let i = 1; i <= 4; i++) {
+      buffers.push(new Uint8Array([0x10, 0x04, i]));
+    }
+    return buffers;
+  }
+
+  /**
+   * 思普瑞特特定: 设置字符代码页
+   * @param codePage 代码页编号 (0-255)
+   * @returns Array of command buffers
+   */
+  setCodePage(codePage: number): Uint8Array[] {
+    // ESC t n
+    return [new Uint8Array([0x1b, 0x74, codePage])];
+  }
+
+  /**
+   * 思普瑞特特定: 设置左边界
+   * @param n 左边界字符数
+   * @returns Array of command buffers
+   */
+  setLeftMargin(n: number): Uint8Array[] {
+    // ESC l n
+    return [new Uint8Array([0x1b, 0x6c, n])];
+  }
+
+  /**
+   * 思普瑞特特定: 设置打印区域宽度
+   * @param n 宽度 (字符数)
+   * @returns Array of command buffers
+   */
+  setPrintWidth(n: number): Uint8Array[] {
+    // ESC W n
+    return [new Uint8Array([0x1b, 0x57, n])];
+  }
+
+  /**
+   * 思普瑞特特定: 使能/禁止自动休眠
+   * @param enable true=使能自动休眠, false=禁止自动休眠
+   * @returns Array of command buffers
+   */
+  setAutoSleep(enable: boolean): Uint8Array[] {
+    // ESC = n (设置外设)
+    // n = 0x01 使能, 0x00 禁止
+    return [new Uint8Array([0x1b, 0x3d, enable ? 0x01 : 0x00])];
+  }
+}

package/src/drivers/XprinterDriver.ts

@@ -0,0 +1,155 @@
+/**
+ * Xprinter (芯烨) Driver
+ *
+ * 芯烨热敏打印机兼容 ESC/POS 指令集
+ * 官网：http://www.xprinter.net/
+ *
+ * 芯烨特点：
+ * - 兼容标准 ESC/POS
+ * - 支持钱箱驱动
+ * - 支持状态自动检测
+ * - 部分型号有特殊初始化序列
+ */
+
+import { EscPos, type EscPosOptions } from './EscPos';
+
+/**
+ * Xprinter options (same as EscPosOptions)
+ */
+export type XprinterOptions = EscPosOptions;
+
+/**
+ * XprinterDriver for Xprinter (芯烨) thermal printers
+ *
+ * 芯烨打印机基于 ESC/POS 指令集，此驱动扩展了标准 EscPos
+ * 添加了芯烨特定的命令支持
+ *
+ * @example
+ * ```typescript
+ * import { XprinterDriver } from 'taro-bluetooth-print';
+ *
+ * const driver = new XprinterDriver();
+ * let commands = driver.init();
+ * commands = driver.text('Hello 芯烨!', 'GBK');
+ * commands = driver.cut();
+ * ```
+ */
+export class XprinterDriver extends EscPos {
+  /**
+   * 芯烨打印机特定: 增强初始化
+   * 添加芯烨特定的初始化序列
+   *
+   * @returns Array of command buffers
+   */
+  init(): Uint8Array[] {
+    const commands = super.init();
+    // 添加芯烨特定初始化
+    // ESC @ (0x1B 0x40) - 初始化打印机已在父类实现
+    // 这里可以添加芯烨特定的初始化命令
+    return commands;
+  }
+
+  /**
+   * 芯烨打印机特定: 打开钱箱
+   * @param pin 钱箱引脚 (0 或 1, 默认 0)
+   * @returns Array of command buffers
+   */
+  openCashDrawer(pin = 0): Uint8Array[] {
+    // ESC p m t1 t2
+    // m = 0 or 1 (pin)
+    // t1 = 50 (on time)
+    // t2 = 200 (off time)
+    return [new Uint8Array([0x1b, 0x70, pin, 50, 200])];
+  }
+
+  /**
+   * 芯烨打印机特定: 发送声响警报
+   * @param times 次数 (1-9)
+   * @param duration 持续时间 (ms)
+   * @returns Array of command buffers
+   */
+  beep(times = 3, duration = 50): Uint8Array[] {
+    // ESC B n t
+    return [new Uint8Array([0x1b, 0x42, times, duration])];
+  }
+
+  /**
+   * 芯烨打印机特定: 打印自检页
+   * @returns Array of command buffers
+   */
+  selfTest(): Uint8Array[] {
+    // ESC i (0x1B 0x69) - 自检并返回状态
+    return [new Uint8Array([0x1b, 0x69])];
+  }
+
+  /**
+   * 芯烨打印机特定: 获取打印机状态
+   * 返回打印机状态字节
+   * @returns Array of command buffers
+   */
+  getStatus(): Uint8Array[] {
+    // ESC i (0x1B 0x69) - 自检并返回状态
+    return [new Uint8Array([0x1b, 0x69])];
+  }
+
+  /**
+   * 芯烨打印机特定: 获取详细状态
+   * 使用 DLE EOT 命令获取不同类型的状态
+   * @returns Array of command buffers (4 status queries)
+   */
+  getDetailedStatus(): Uint8Array[] {
+    // DLE EOT n (n = 1-4 获取不同状态)
+    // 状态 1: 打印机状态
+    // 状态 2: 脱机状态
+    // 状态 3: 错误状态
+    // 状态 4: 纸张状态
+    const buffers: Uint8Array[] = [];
+    for (let i = 1; i <= 4; i++) {
+      buffers.push(new Uint8Array([0x10, 0x04, i]));
+    }
+    return buffers;
+  }
+
+  /**
+   * 芯烨打印机特定: 设置字符代码页
+   * @param codePage 代码页编号 (0-255)
+   * @returns Array of command buffers
+   */
+  setCodePage(codePage: number): Uint8Array[] {
+    // ESC t n
+    return [new Uint8Array([0x1b, 0x74, codePage])];
+  }
+
+  /**
+   * 芯烨打印机特定: 设置左边界
+   * @param n 左边界字符数
+   * @returns Array of command buffers
+   */
+  setLeftMargin(n: number): Uint8Array[] {
+    // ESC l n
+    return [new Uint8Array([0x1b, 0x6c, n])];
+  }
+
+  /**
+   * 芯烨打印机特定: 设置打印区域宽度
+   * @param n 宽度 (字符数)
+   * @returns Array of command buffers
+   */
+  setPrintWidth(n: number): Uint8Array[] {
+    // ESC W n
+    return [new Uint8Array([0x1b, 0x57, n])];
+  }
+
+  /**
+   * 芯烨打印机特定: 进纸并切割
+   * @param lines 进纸行数
+   * @returns Array of command buffers
+   */
+  feedAndCut(lines: number): Uint8Array[] {
+    // 先进纸
+    const feedCmd = new Uint8Array([0x1b, 0x64, lines]); // ESC d n
+    // 再切割
+    const cutCmd = new Uint8Array([0x1d, 0x56, 0x00]); // GS V 0
+    return [feedCmd, cutCmd];
+  }
+}

package/src/drivers/index.ts

@@ -7,6 +7,10 @@ export { EscPos, type EscPosOptions } from './EscPos';
 
 export { GPrinterDriver, type GPrinterOptions } from './GPrinterDriver';
 
+export { XprinterDriver, type XprinterOptions } from './XprinterDriver';
+
+export { SprtDriver, type SprtDriverOptions } from './SprtDriver';
+
 export {
   TsplDriver,
   type LabelSize,