taro-bluetooth-print 2.7.0 → 2.8.3

package/dist/types/device/DeviceManager.d.ts

@@ -22,7 +22,7 @@ export interface BluetoothDevice {
     /** Signal strength (RSSI) */
     rssi?: number;
     /** Advertisement data */
-    advertisData?: ArrayBuffer;
+    advertisementData?: ArrayBuffer;
     /** Service UUIDs */
     serviceUUIDs?: string[];
     /** Local name from advertisement */

package/dist/types/device/DiscoveryService.d.ts

@@ -1,4 +1,5 @@
 import { EventEmitter } from '../core/EventEmitter';
+import { IPrinterAdapter } from '../types';
 export interface DiscoveredDevice {
     id: string;
     name: string;
@@ -40,7 +41,7 @@ export interface DiscoveryEvents {
     'discovery-stop': void;
     'discovery-complete': DiscoveredDevice[];
     'discovery-error': Error;
-    'retry': {
+    retry: {
         attempt: number;
         maxRetries: number;
     };
@@ -58,7 +59,7 @@ export declare class DiscoveryService extends EventEmitter<DiscoveryEvents> {
     /**
      * 设置平台适配器
      */
-    setPlatformAdapter(adapter: any): void;
+    setPlatformAdapter(adapter: IPrinterAdapter): void;
     /**
      * 开始发现设备
      */

package/dist/types/drivers/SprtDriver.d.ts

@@ -0,0 +1,87 @@
+import { EscPos, 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 declare class SprtDriver extends EscPos {
+    /**
+     * 思普瑞特特定: 进入低功耗/休眠模式
+     * @returns Array of command buffers
+     */
+    sleep(): Uint8Array[];
+    /**
+     * 思普瑞特特定: 唤醒打印机
+     * 发送空字符或特定序列唤醒休眠中的打印机
+     * @returns Array of command buffers
+     */
+    wakeUp(): Uint8Array[];
+    /**
+     * 思普瑞特特定: 深度唤醒
+     * 使用完整的初始化序列唤醒打印机
+     * @returns Array of command buffers
+     */
+    wakeUpDeep(): Uint8Array[];
+    /**
+     * 思普瑞特特定: 打开钱箱
+     * @param pin 钱箱引脚 (0 或 1, 默认 0)
+     * @returns Array of command buffers
+     */
+    openCashDrawer(pin?: number): Uint8Array[];
+    /**
+     * 思普瑞特特定: 发送声响警报
+     * @param times 次数 (1-9)
+     * @param duration 持续时间 (ms)
+     * @returns Array of command buffers
+     */
+    beep(times?: number, duration?: number): Uint8Array[];
+    /**
+     * 思普瑞特特定: 打印自检页
+     * @returns Array of command buffers
+     */
+    selfTest(): Uint8Array[];
+    /**
+     * 思普瑞特特定: 获取打印机状态
+     * @returns Array of command buffers
+     */
+    getStatus(): Uint8Array[];
+    /**
+     * 思普瑞特特定: 设置字符代码页
+     * @param codePage 代码页编号 (0-255)
+     * @returns Array of command buffers
+     */
+    setCodePage(codePage: number): Uint8Array[];
+    /**
+     * 思普瑞特特定: 设置左边界
+     * @param n 左边界字符数
+     * @returns Array of command buffers
+     */
+    setLeftMargin(n: number): Uint8Array[];
+    /**
+     * 思普瑞特特定: 设置打印区域宽度
+     * @param n 宽度 (字符数)
+     * @returns Array of command buffers
+     */
+    setPrintWidth(n: number): Uint8Array[];
+    /**
+     * 思普瑞特特定: 使能/禁止自动休眠
+     * @param enable true=使能自动休眠, false=禁止自动休眠
+     * @returns Array of command buffers
+     */
+    setAutoSleep(enable: boolean): Uint8Array[];
+}

package/dist/types/drivers/XprinterDriver.d.ts

@@ -0,0 +1,84 @@
+import { EscPos, 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 declare class XprinterDriver extends EscPos {
+    /**
+     * 芯烨打印机特定: 增强初始化
+     * 添加芯烨特定的初始化序列
+     *
+     * @returns Array of command buffers
+     */
+    init(): Uint8Array[];
+    /**
+     * 芯烨打印机特定: 打开钱箱
+     * @param pin 钱箱引脚 (0 或 1, 默认 0)
+     * @returns Array of command buffers
+     */
+    openCashDrawer(pin?: number): Uint8Array[];
+    /**
+     * 芯烨打印机特定: 发送声响警报
+     * @param times 次数 (1-9)
+     * @param duration 持续时间 (ms)
+     * @returns Array of command buffers
+     */
+    beep(times?: number, duration?: number): Uint8Array[];
+    /**
+     * 芯烨打印机特定: 打印自检页
+     * @returns Array of command buffers
+     */
+    selfTest(): Uint8Array[];
+    /**
+     * 芯烨打印机特定: 获取打印机状态
+     * 返回打印机状态字节
+     * @returns Array of command buffers
+     */
+    getStatus(): Uint8Array[];
+    /**
+     * 芯烨打印机特定: 获取详细状态
+     * 使用 DLE EOT 命令获取不同类型的状态
+     * @returns Array of command buffers (4 status queries)
+     */
+    getDetailedStatus(): Uint8Array[];
+    /**
+     * 芯烨打印机特定: 设置字符代码页
+     * @param codePage 代码页编号 (0-255)
+     * @returns Array of command buffers
+     */
+    setCodePage(codePage: number): Uint8Array[];
+    /**
+     * 芯烨打印机特定: 设置左边界
+     * @param n 左边界字符数
+     * @returns Array of command buffers
+     */
+    setLeftMargin(n: number): Uint8Array[];
+    /**
+     * 芯烨打印机特定: 设置打印区域宽度
+     * @param n 宽度 (字符数)
+     * @returns Array of command buffers
+     */
+    setPrintWidth(n: number): Uint8Array[];
+    /**
+     * 芯烨打印机特定: 进纸并切割
+     * @param lines 进纸行数
+     * @returns Array of command buffers
+     */
+    feedAndCut(lines: number): Uint8Array[];
+}

package/dist/types/drivers/index.d.ts

@@ -4,6 +4,8 @@
  */
 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, type TextOptions, type BarcodeOptions, type QRCodeOptions, type BoxOptions, type LineOptions, } from './TsplDriver';
 export { ZplDriver, type ZplLabelSize, type ZplTextOptions, type ZplBarcodeOptions, type ZplQRCodeOptions, type ZplBoxOptions, } from './ZplDriver';
 export { CpclDriver, type CPCLPageSize, type CpclTextOptions, type CpclBarcodeOptions, type CpclQRCodeOptions, type CpclLineOptions, type CpclBoxOptions, } from './CpclDriver';

package/dist/types/services/CloudPrintManager.d.ts

@@ -0,0 +1,123 @@
+import { EventEmitter } from '../core/EventEmitter';
+export interface CloudPrintOptions {
+    /** WebSocket 服务器地址 */
+    serverUrl: string;
+    /** 设备 ID */
+    deviceId: string;
+    /** API 密钥（可选） */
+    apiKey?: string;
+    /** 自动重连 */
+    reconnect?: boolean;
+    /** 重连间隔 (ms) */
+    reconnectInterval?: number;
+    /** 心跳间隔 (ms) */
+    heartbeatInterval?: number;
+    /** 连接超时 (ms) */
+    connectTimeout?: number;
+}
+export interface PrintJob {
+    /** 任务 ID */
+    id: string;
+    /** 打印数据 */
+    data: Uint8Array | string;
+    /** 份数 */
+    copies?: number;
+    /** 优先级 */
+    priority?: number;
+}
+export interface CloudPrinterStatus {
+    /** 打印机状态 */
+    status: 'idle' | 'printing' | 'error' | 'offline';
+    /** 纸张状态 */
+    paper?: 'ok' | 'low' | 'out';
+    /** 错误信息 */
+    error?: string;
+    /** 最后更新时间 */
+    timestamp: number;
+}
+export interface CloudPrintEvents {
+    /** 连接成功 */
+    connect: void;
+    /** 断开连接 */
+    disconnect: void;
+    /** 连接错误 */
+    error: Error;
+    /** 状态更新 */
+    status: CloudPrinterStatus;
+    /** 打印完成 */
+    'print-complete': string;
+    /** 打印失败 */
+    'print-error': {
+        jobId: string;
+        error: string;
+    };
+    /** 收到原始消息 */
+    message: Record<string, unknown>;
+}
+export type CloudPrintEvent = keyof CloudPrintEvents;
+/**
+ * 云打印管理器
+ *
+ * 通过 WebSocket 连接到云端服务器，实现远程打印任务下发
+ */
+export declare class CloudPrintManager extends EventEmitter<CloudPrintEvents> {
+    private readonly log;
+    private options;
+    private ws;
+    private isConnected;
+    private reconnectTimer;
+    private heartbeatTimer;
+    private status;
+    private connectResolve;
+    private connectReject;
+    constructor(options: CloudPrintOptions);
+    /**
+     * 检查是否已连接
+     */
+    get connected(): boolean;
+    /**
+     * 获取当前打印机状态
+     */
+    get currentStatus(): CloudPrinterStatus;
+    /**
+     * 连接到云端服务器
+     */
+    connect(): Promise<void>;
+    /**
+     * 断开连接
+     */
+    disconnect(): void;
+    /**
+     * 发送打印任务
+     * @throws Error 如果未连接
+     */
+    print(job: PrintJob): void;
+    /**
+     * 获取打印机状态
+     */
+    getStatus(): CloudPrinterStatus;
+    /**
+     * 处理接收到的消息
+     */
+    private handleMessage;
+    /**
+     * 启动心跳
+     */
+    private startHeartbeat;
+    /**
+     * 停止心跳
+     */
+    private stopHeartbeat;
+    /**
+     * 安排重连
+     */
+    private scheduleReconnect;
+    /**
+     * 取消重连
+     */
+    private cancelReconnect;
+    /**
+     * ArrayBuffer 转 Base64
+     */
+    private arrayBufferToBase64;
+}

package/dist/types/services/PrintScheduler.d.ts

@@ -28,7 +28,7 @@ export interface ScheduleOptions {
 }
 export interface ScheduleEvents {
     'will-execute': ScheduledPrint;
-    'executed': {
+    executed: {
         job: ScheduledPrint;
         success: boolean;
         error?: Error;
@@ -37,8 +37,8 @@ export interface ScheduleEvents {
         job: ScheduledPrint;
         runTime: number;
     };
-    'completed': ScheduledPrint;
-    'failed': {
+    completed: ScheduledPrint;
+    failed: {
         job: ScheduledPrint;
         error: Error;
     };

package/dist/types/services/QRCodeDiscoveryService.d.ts

@@ -0,0 +1,120 @@
+/**
+ * QRCodeDiscoveryService - 二维码打印机配对服务
+ *
+ * 用于扫描打印机屏幕二维码获取设备信息并直连
+ *
+ * 支持的二维码格式：
+ * 1. 商米格式 (Sunmi): 包含蓝牙地址和服务信息
+ * 2. 标准格式: 包含 MAC 地址
+ * 3. 自定义格式: 可扩展
+ */
+/**
+ * 二维码发现服务配置选项
+ */
+export interface QRCodeDiscoveryOptions {
+    /** 二维码格式类型 */
+    format: 'sunmi' | 'standard' | 'custom';
+    /** 是否自动连接 */
+    autoConnect?: boolean;
+    /** 自定义解析函数 */
+    parser?: (content: string) => ParsedDeviceInfo;
+}
+/**
+ * 解析后的设备信息
+ */
+export interface ParsedDeviceInfo {
+    /** 设备名称 */
+    name?: string;
+    /** 蓝牙 MAC 地址 */
+    address?: string;
+    /** 服务 UUID */
+    serviceUuid?: string;
+    /** 设备类型 */
+    type?: 'printer' | 'scanner' | 'other';
+    /** 其他元数据 */
+    metadata?: Record<string, string>;
+}
+/**
+ * 发现结果
+ */
+export interface DiscoveryResult {
+    /** 解析后的设备信息 */
+    device: ParsedDeviceInfo;
+    /** 原始二维码内容 */
+    raw: string;
+    /** 解析格式 */
+    format: string;
+}
+/**
+ * 二维码发现服务
+ */
+export declare class QRCodeDiscoveryService {
+    private options;
+    constructor(options: QRCodeDiscoveryOptions);
+    /**
+     * 解析二维码内容
+     * @param content 二维码字符串内容
+     * @returns 解析结果
+     */
+    parse(content: string): DiscoveryResult;
+    /**
+     * 解析商米格式二维码
+     * 商米打印机二维码通常包含:
+     * - 设备名称
+     * - 蓝牙地址
+     * - 连接参数
+     *
+     * 支持的格式:
+     * 1. JSON: {"name":"SUNMI P2","mac":"AA:BB:CC:DD:EE:FF","type":"printer"}
+     * 2. 分隔符: SUNMI P2|AA:BB:CC:DD:EE:FF|printer
+     */
+    parseSunmi(content: string): DiscoveryResult;
+    /**
+     * 解析商米 JSON 格式
+     */
+    private parseSunmiJson;
+    /**
+     * 解析商米分隔符格式 (name|MAC|type)
+     */
+    private parseSunmiPipe;
+    /**
+     * 解析标准格式二维码
+     * 标准格式通常是 MAC 地址或蓝牙设备信息
+     *
+     * 支持的格式:
+     * 1. AA:BB:CC:DD:EE:FF (冒号分隔)
+     * 2. AA-BB-CC-DD-EE-FF (连字符分隔)
+     * 3. AABBCCDDEEFF (无分隔符)
+     */
+    parseStandard(content: string): DiscoveryResult;
+    /**
+     * 解析 MAC 地址
+     */
+    private parseMacAddress;
+    /**
+     * 标准化 MAC 地址格式（转换为大写冒号分隔）
+     */
+    private normalizeMacAddress;
+    /**
+     * 格式化 MAC 地址为冒号分隔格式
+     */
+    private formatMacWithColons;
+    /**
+     * 标准化设备类型
+     */
+    private normalizeDeviceType;
+    /**
+     * 从 JSON 字符串中提取元数据
+     */
+    private extractJsonMetadata;
+    /**
+     * 获取配置选项
+     */
+    getOptions(): QRCodeDiscoveryOptions;
+    /**
+     * 验证解析结果是否有效
+     */
+    static isValidResult(result: DiscoveryResult): boolean;
+}
+export { parseQRCode, parseMultipleQRCodes, detectQRCodeFormat, addQRCodeFormat, removeQRCodeFormat, getSupportedFormats, QR_CODE_FORMATS, } from './QRCodeParser';
+export type { QRCodeFormat } from './QRCodeParser';

package/dist/types/services/QRCodeParser.d.ts

@@ -0,0 +1,60 @@
+import { ParsedDeviceInfo } from './QRCodeDiscoveryService';
+/**
+ * 二维码格式定义
+ */
+export interface QRCodeFormat {
+    /** 格式名称 */
+    name: string;
+    /** 正则表达式 */
+    pattern: RegExp;
+    /** 解析函数 */
+    parse: (match: RegExpMatchArray, raw: string) => ParsedDeviceInfo;
+}
+/**
+ * 内置支持的二维码格式
+ */
+export declare const QR_CODE_FORMATS: QRCodeFormat[];
+/**
+ * 解析二维码字符串
+ *
+ * @param content 二维码原始内容
+ * @returns 解析后的设备信息，如果无法解析则返回 null
+ */
+export declare function parseQRCode(content: string): ParsedDeviceInfo | null;
+/**
+ * 批量解析多个二维码
+ *
+ * @param contents 二维码内容数组
+ * @returns 解析结果数组，包含成功解析和失败的结果
+ */
+export declare function parseMultipleQRCodes(contents: string[]): {
+    success: Array<{
+        content: string;
+        device: ParsedDeviceInfo;
+    }>;
+    failed: string[];
+};
+/**
+ * 检测二维码内容类型
+ *
+ * @param content 二维码内容
+ * @returns 格式名称，如果无法识别则返回 null
+ */
+export declare function detectQRCodeFormat(content: string): string | null;
+/**
+ * 添加自定义二维码格式
+ *
+ * @param format 格式定义
+ */
+export declare function addQRCodeFormat(format: QRCodeFormat): void;
+/**
+ * 移除自定义二维码格式
+ *
+ * @param formatName 格式名称
+ * @returns 是否成功移除
+ */
+export declare function removeQRCodeFormat(formatName: string): boolean;
+/**
+ * 获取所有支持的格式名称列表
+ */
+export declare function getSupportedFormats(): string[];

package/dist/types/services/index.d.ts

@@ -12,3 +12,6 @@ export { PrintStatistics, printStatistics, type PrintStatisticsData, type JobTra
 export { ScheduledRetryManager, scheduledRetryManager, type ScheduledRetry, type RetryOptions, type ScheduledRetryEvents, type ScheduledRetryManagerConfig, } from './ScheduledRetryManager';
 export { PrintScheduler, printScheduler, type ScheduledPrint, type ScheduleOptions, type ScheduleEvents, parseCronExpression, getNextCronRun, getNextIntervalRun, } from './PrintScheduler';
 export * from './interfaces';
+export { CloudPrintManager, type CloudPrintOptions, type PrintJob, type CloudPrinterStatus, type CloudPrintEvents, type CloudPrintEvent, } from './CloudPrintManager';
+export { QRCodeDiscoveryService, type QRCodeDiscoveryOptions, type ParsedDeviceInfo, type DiscoveryResult, } from './QRCodeDiscoveryService';
+export { parseQRCode, parseMultipleQRCodes, detectQRCodeFormat, addQRCodeFormat, removeQRCodeFormat, getSupportedFormats, QR_CODE_FORMATS, type QRCodeFormat, } from './QRCodeParser';

package/dist/types/types.d.ts

@@ -153,5 +153,5 @@ export interface DeviceInfo {
     /** Device RSSI (signal strength) */
     rssi?: number;
     /** Device manufacturer data */
-    advertisData?: ArrayBuffer;
+    advertisementData?: ArrayBuffer;
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "taro-bluetooth-print",
-  "version": "2.7.0",
+  "version": "2.8.3",
   "description": "Taro 蓝牙打印库 v2.6 - 轻量级、高性能、跨平台支持微信、支付宝、百度、字节跳动小程序及H5 Web Bluetooth",
   "type": "module",
   "main": "dist/index.cjs.js",

package/src/device/DeviceManager.ts

@@ -26,7 +26,7 @@ export interface BluetoothDevice {
   /** Signal strength (RSSI) */
   rssi?: number;
   /** Advertisement data */
-  advertisData?: ArrayBuffer;
+  advertisementData?: ArrayBuffer;
   /** Service UUIDs */
   serviceUUIDs?: string[];
   /** Local name from advertisement */
@@ -404,7 +404,7 @@ export class DeviceManager implements IDeviceManager {
         deviceId: device.deviceId,
         name: device.name || device.localName || 'Unknown',
         rssi: device.RSSI,
-        advertisData: device.advertisData,
+        advertisementData: device.advertisData,
         serviceUUIDs: device.advertisServiceUUIDs,
         localName: device.localName,
       };