taro-bluetooth-print 2.3.0 → 2.4.0

package/dist/types/encoding/gbk-table.d.ts

@@ -1,53 +1,31 @@
 /**
- * GBK Encoding Table
+ * GBK Encoding Table - 懒加载版本
  *
- * This module provides character mapping tables for GBK, GB2312, and Big5 encodings.
- * GBK is a superset of GB2312 and covers most Chinese characters used in simplified Chinese.
- * Big5 is used for traditional Chinese characters.
+ * 优化策略：
+ * 1. 默认使用精简版编码表 (gbk-lite.ts，约 3500 常用字)
+ * 2. 遇到非常用字时动态加载完整编码表
+ * 3. 二分查找代替 Map，大幅减少内存占用
  *
- * GBK encoding uses double-byte encoding for Chinese characters:
- * - First byte: 0x81-0xFE
- * - Second byte: 0x40-0xFE (excluding 0x7F)
- *
- * 映射数据存储在 gbk-data.ts 中，运行时解码为 Map。
  * GBK: 23940 个字符映射
  * Big5: 13911 个字符映射
  */
-/**
- * Unicode to GBK mapping table
- * Maps Unicode code points to GBK byte pairs
- */
 export declare const unicodeToGbk: Map<number, number>;
-/**
- * GBK to Unicode mapping table
- * Maps GBK byte pairs to Unicode code points
- */
 export declare const gbkToUnicode: Map<number, number>;
-/**
- * Unicode to Big5 mapping table
- */
 export declare const unicodeToBig5: Map<number, number>;
-/**
- * Big5 to Unicode mapping table
- */
 export declare const big5ToUnicode: Map<number, number>;
 /**
  * Get GBK bytes for a Unicode character
- * @param unicode - Unicode code point
- * @returns GBK byte pair [high, low] or null if not found
+ * 先查精简表，查不到再懒加载完整表
  */
 export declare function getGbkBytes(unicode: number): [number, number] | null;
 /**
  * Get Unicode character from GBK bytes
- * @param high - High byte
- * @param low - Low byte
- * @returns Unicode code point or null if not found
+ * 懒加载完整表
  */
 export declare function getUnicodeFromGbk(high: number, low: number): number | null;
 /**
  * Get Big5 bytes for a Unicode character
- * @param unicode - Unicode code point
- * @returns Big5 byte pair or null if not found
+ * 懒加载完整表
  */
 export declare function getBig5Bytes(unicode: number): [number, number] | null;
 /**

package/dist/types/index.d.ts

@@ -1,24 +1,26 @@
 /**
  * Taro Bluetooth Print Library
- * A lightweight, high-performance Bluetooth printing library for Taro
+ * 轻量级、高性能的蓝牙打印库
  *
  * @packageDocumentation
  */
 export { BluetoothPrinter } from './core/BluetoothPrinter';
 export type { PrinterEvents } from './core/BluetoothPrinter';
 export { EventEmitter } from './core/EventEmitter';
-export { EscPos } from './drivers/EscPos';
-export { TsplDriver } from './drivers/TsplDriver';
-export type { LabelSize, TextOptions as TsplTextOptions, BarcodeOptions as TsplBarcodeOptions, QRCodeOptions as TsplQRCodeOptions, BoxOptions, LineOptions, } from './drivers/TsplDriver';
+export * from './drivers';
 export { TaroAdapter } from './adapters/TaroAdapter';
+export { AlipayAdapter } from './adapters/AlipayAdapter';
+export { BaiduAdapter } from './adapters/BaiduAdapter';
+export { ByteDanceAdapter } from './adapters/ByteDanceAdapter';
+export { WebBluetoothAdapter } from './adapters/WebBluetoothAdapter';
 export { AdapterFactory } from './adapters/AdapterFactory';
 export { BaseAdapter } from './adapters/BaseAdapter';
-export { WebBluetoothAdapter } from './adapters/WebBluetoothAdapter';
 export type { WebBluetoothRequestOptions } from './adapters/WebBluetoothAdapter';
-export { ConnectionManager } from './services/ConnectionManager';
-export type { ConnectionManagerConfig, ConnectionManagerEvents, } from './services/ConnectionManager';
-export { DeviceManager } from './device/DeviceManager';
+export * from './services';
+export { DeviceManager, deviceManager } from './device/DeviceManager';
 export type { BluetoothDevice, ScanOptions, DeviceManagerEvents } from './device/DeviceManager';
+export { MultiPrinterManager, multiPrinterManager } from './device/MultiPrinterManager';
+export type { PrinterConnection, MultiConnectOptions, BroadcastOptions, MultiPrinterManagerEvents, } from './device/MultiPrinterManager';
 export { PrintQueue } from './queue/PrintQueue';
 export type { PrintJob, PrintJobStatus, PrintJobPriority, QueueConfig, PrintQueueEvents, } from './queue/PrintQueue';
 export { OfflineCache } from './cache/OfflineCache';
@@ -40,6 +42,8 @@ export { PlatformType, detectPlatform, isPlatformSupported } from './utils/platf
 export { BluetoothPrintError, ErrorCode } from './errors/BluetoothError';
 export { DEFAULT_CONFIG, mergeConfig } from './config/PrinterConfig';
 export type { PrinterConfig, AdapterConfig, DriverConfig, LoggingConfig, } from './config/PrinterConfig';
+export { PrinterConfigManager, printerConfigManager } from './config/PrinterConfigManager';
+export type { SavedPrinter, GlobalConfig, IConfigStorage, } from './config/PrinterConfigManager';
 export { PluginManager } from './plugins/PluginManager';
 export { createLoggingPlugin, createRetryPlugin } from './plugins';
 export type { Plugin, PluginHooks, PluginOptions, PluginFactory } from './plugins/types';

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

@@ -0,0 +1,205 @@
+/**
+ * Batch Print Manager
+ *
+ * Optimizes printing multiple jobs by:
+ * - Merging small jobs into larger chunks
+ * - Reducing Bluetooth communication overhead
+ * - Prioritizing urgent jobs
+ * - Batching similar content for efficiency
+ *
+ * @example
+ * ```typescript
+ * const batchManager = new BatchPrintManager();
+ *
+ * // Add print jobs
+ * batchManager.addJob({ data: buffer1, priority: 1 });
+ * batchManager.addJob({ data: buffer2, priority: 2 });
+ *
+ * // Process batch when ready
+ * await batchManager.processBatch();
+ * ```
+ */
+/**
+ * Batch job entry
+ */
+export interface BatchJob {
+    /** Unique job ID */
+    id: string;
+    /** Print data */
+    data: Uint8Array;
+    /** Priority (higher = more urgent) */
+    priority: number;
+    /** Timestamp when added */
+    addedAt: number;
+    /** Metadata */
+    metadata?: Record<string, unknown>;
+}
+/**
+ * Batch configuration
+ */
+export interface BatchConfig {
+    /** Maximum batch size in bytes */
+    maxBatchSize: number;
+    /** Maximum wait time before processing in ms */
+    maxWaitTime: number;
+    /** Minimum jobs before batching */
+    minBatchSize: number;
+    /** Merge similar content */
+    enableMerging: boolean;
+    /** Auto-process interval in ms (0 = disabled) */
+    autoProcessInterval: number;
+}
+/**
+ * Batch statistics
+ */
+export interface BatchStats {
+    /** Total jobs added */
+    totalJobs: number;
+    /** Total bytes processed */
+    totalBytes: number;
+    /** Batches processed */
+    batchesProcessed: number;
+    /** Average batch size */
+    avgBatchSize: number;
+    /** Merged jobs count */
+    mergedJobs: number;
+}
+/**
+ * Batch events
+ */
+export interface BatchEvents {
+    'batch-ready': (data: BatchJob[]) => void;
+    'batch-processed': (data: {
+        jobCount: number;
+        bytes: number;
+    }) => void;
+    'job-added': (data: BatchJob) => void;
+    'job-rejected': (data: {
+        reason: string;
+    }) => void;
+}
+/**
+ * Batch Print Manager
+ *
+ * Collects print jobs and processes them in optimized batches.
+ * Reduces Bluetooth communication overhead by combining small jobs.
+ */
+export declare class BatchPrintManager {
+    private readonly logger;
+    private readonly jobs;
+    private readonly listeners;
+    private config;
+    private isProcessing;
+    private waitTimer;
+    private autoProcessTimer;
+    private stats;
+    /**
+     * Creates a new BatchPrintManager instance
+     */
+    constructor(config?: Partial<BatchConfig>);
+    /**
+     * Register event listener
+     */
+    on<K extends keyof BatchEvents>(event: K, callback: BatchEvents[K]): void;
+    /**
+     * Remove event listener
+     */
+    off<K extends keyof BatchEvents>(event: K, callback: BatchEvents[K]): void;
+    /**
+     * Emit an event
+     */
+    private emit;
+    /**
+     * Add a job to the batch queue
+     *
+     * @param data - Print data
+     * @param priority - Job priority (higher = more urgent)
+     * @param metadata - Optional metadata
+     * @returns Job ID
+     */
+    addJob(data: Uint8Array, priority?: number, metadata?: Record<string, unknown>): string;
+    /**
+     * Add multiple jobs at once
+     */
+    addJobs(jobs: Array<{
+        data: Uint8Array;
+        priority?: number;
+        metadata?: Record<string, unknown>;
+    }>): string[];
+    /**
+     * Cancel a job by ID
+     */
+    cancelJob(id: string): boolean;
+    /**
+     * Cancel all jobs
+     */
+    cancelAll(): void;
+    /**
+     * Get pending job count
+     */
+    get pendingCount(): number;
+    /**
+     * Get pending jobs
+     */
+    getPendingJobs(): BatchJob[];
+    /**
+     * Get current statistics
+     */
+    getStats(): BatchStats;
+    /**
+     * Update configuration
+     */
+    updateConfig(updates: Partial<BatchConfig>): void;
+    /**
+     * Process the current batch
+     *
+     * @param processor - Function to send batch data to printer
+     * @returns Number of jobs processed
+     */
+    processBatch(processor: (data: Uint8Array) => Promise<void>): Promise<number>;
+    /**
+     * Prepare batch from pending jobs
+     */
+    private prepareBatch;
+    /**
+     * Merge multiple jobs into a single buffer
+     */
+    private mergeJobs;
+    /**
+     * Check if we should process immediately
+     */
+    private shouldProcessImmediately;
+    /**
+     * Start the wait timer
+     */
+    private startWaitTimer;
+    /**
+     * Clear wait timer
+     */
+    private clearWaitTimer;
+    /**
+     * Start auto-process timer
+     */
+    private startAutoProcess;
+    /**
+     * Stop auto-process timer
+     */
+    private stopAutoProcess;
+    /**
+     * Clear all timers
+     */
+    private clearTimers;
+    /**
+     * Generate unique job ID
+     */
+    private generateId;
+    /**
+     * Reset statistics
+     */
+    resetStats(): void;
+    /**
+     * Destroy the manager
+     */
+    destroy(): void;
+}
+export declare const batchPrintManager: BatchPrintManager;

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

@@ -54,7 +54,7 @@ export declare class ConnectionManager extends EventEmitter<ConnectionManagerEve
     private adapter;
     private deviceId;
     private state;
-    private readonly logger;
+    private readonly connLogger;
     private readonly config;
     private heartbeatTimer;
     private reconnectAttempts;

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

@@ -0,0 +1,142 @@
+import { PrintJobStatus, PrintJobPriority } from '../queue/PrintQueue';
+/**
+ * Print history entry
+ */
+export interface PrintHistoryEntry {
+    /** Unique entry ID */
+    id: string;
+    /** Job ID from PrintJobManager */
+    jobId?: string;
+    /** Print data size in bytes */
+    dataSize: number;
+    /** Job status */
+    status: PrintJobStatus | 'unknown';
+    /** Priority */
+    priority: PrintJobPriority;
+    /** Creation timestamp */
+    createdAt: number;
+    /** Start timestamp */
+    startedAt?: number;
+    /** Completion timestamp */
+    completedAt?: number;
+    /** Duration in milliseconds */
+    duration?: number;
+    /** Error message if failed */
+    error?: string;
+    /** Device ID */
+    deviceId?: string;
+    /** Device name */
+    deviceName?: string;
+    /** Metadata */
+    metadata?: Record<string, unknown>;
+}
+/**
+ * History statistics
+ */
+export interface PrintHistoryStats {
+    /** Total jobs */
+    total: number;
+    /** Completed jobs */
+    completed: number;
+    /** Failed jobs */
+    failed: number;
+    /** Cancelled jobs */
+    cancelled: number;
+    /** Average duration in ms */
+    avgDuration: number;
+    /** Total bytes printed */
+    totalBytes: number;
+    /** Success rate */
+    successRate: number;
+}
+/**
+ * Query options for history
+ */
+export interface HistoryQueryOptions {
+    /** Start date filter */
+    startDate?: number;
+    /** End date filter */
+    endDate?: number;
+    /** Status filter */
+    status?: PrintJobStatus | PrintJobStatus[];
+    /** Device ID filter */
+    deviceId?: string;
+    /** Limit results */
+    limit?: number;
+    /** Offset for pagination */
+    offset?: number;
+}
+/**
+ * Print History Service
+ */
+export declare class PrintHistory {
+    private readonly logger;
+    private readonly entries;
+    private counter;
+    private readonly maxEntries;
+    /**
+     * Creates a new PrintHistory instance
+     * @param maxEntries - Maximum number of entries to keep (default: 1000)
+     */
+    constructor(maxEntries?: number);
+    /**
+     * Add a new print job to history
+     */
+    addJob(params: {
+        jobId?: string;
+        data: Uint8Array;
+        status: PrintJobStatus | 'unknown';
+        priority?: PrintJobPriority;
+        deviceId?: string;
+        deviceName?: string;
+        metadata?: Record<string, unknown>;
+    }): string;
+    /**
+     * Update job status
+     */
+    updateJob(id: string, updates: Partial<{
+        status: PrintJobStatus | 'unknown';
+        startedAt: number;
+        completedAt: number;
+        error: string;
+    }>): void;
+    /**
+     * Get entry by ID
+     */
+    getEntry(id: string): PrintHistoryEntry | undefined;
+    /**
+     * Get recent jobs
+     */
+    getRecent(count?: number): PrintHistoryEntry[];
+    /**
+     * Query history with filters
+     */
+    query(options?: HistoryQueryOptions): PrintHistoryEntry[];
+    /**
+     * Get statistics
+     */
+    getStats(options?: {
+        days?: number;
+    }): PrintHistoryStats;
+    /**
+     * Clear all history
+     */
+    clear(): void;
+    /**
+     * Export history as JSON
+     */
+    export(): string;
+    /**
+     * Import history from JSON
+     */
+    import(json: string): number;
+    /**
+     * Generate unique ID
+     */
+    private generateId;
+    /**
+     * Enforce maximum entries limit
+     */
+    private enforceMaxEntries;
+}
+export declare const printHistory: PrintHistory;

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

@@ -4,8 +4,15 @@ import { IPrintJobManager, IConnectionManager } from './interfaces';
  * Print Job Manager implementation
  */
 export declare class PrintJobManager implements IPrintJobManager {
-    /** 内存中的任务状态存储（可被子类或外部替换为持久化方案） */
-    private static jobStateStore;
+    /** Instance-level job state storage (per-printer support) */
+    private instanceJobStateStore;
+    /** Static job state store for backward compatibility */
+    private static _jobStateStore;
+    /**
+     * Get the static job state store (for backward compatibility)
+     * @deprecated Use instance-level store instead for multi-printer support
+     */
+    private static get jobStateStore();
     private adapter;
     private connectionManager;
     private jobBuffer;
@@ -65,8 +72,8 @@ export declare class PrintJobManager implements IPrintJobManager {
     /**
      * Saves the current job state for resume later.
      *
-     * 默认实现使用内存存储。如需持久化（如 localStorage），
-     * 可通过 setSaveHandler/setLoadHandler 自定义。
+     * Uses instance-level storage by default. Falls back to static store
+     * for backward compatibility.
      */
     private saveJobState;
     /**
@@ -79,6 +86,23 @@ export declare class PrintJobManager implements IPrintJobManager {
      * Clears the current job state
      */
     private clearJobState;
+    /**
+     * Cleanup resources and clear all job state.
+     * Call this when the printer is no longer needed.
+     */
+    destroy(): void;
+    /**
+     * Clean up expired job states from static store.
+     * Call this periodically to prevent memory leaks.
+     *
+     * @param maxAge - Maximum age in ms (default: 1 hour)
+     */
+    static cleanupExpiredJobs(maxAge?: number): number;
+    /**
+     * Get count of pending job states in static store.
+     * Useful for debugging memory usage.
+     */
+    static getStaticStoreSize(): number;
     /**
      * Emits job state change event
      *

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

@@ -0,0 +1,97 @@
+/**
+ * Printer Status Service
+ *
+ * Queries printer status including paper, battery, and error states.
+ * Works with ESC/POS printers that support status commands.
+ *
+ * @example
+ * ```typescript
+ * const status = new PrinterStatus(printer);
+ * const paperStatus = await status.getPaperStatus();
+ * console.log('Paper:', paperStatus);
+ * ```
+ */
+/**
+ * Paper status
+ */
+export declare enum PaperStatus {
+    /** Paper is present and OK */
+    OK = "ok",
+    /** Paper is low */
+    LOW = "low",
+    /** Paper is out */
+    OUT = "out",
+    /** Paper status unknown */
+    UNKNOWN = "unknown"
+}
+/**
+ * Printer status
+ */
+export interface PrinterStatusInfo {
+    /** Paper status */
+    paper: PaperStatus;
+    /** Cover open (if supported) */
+    coverOpen?: boolean;
+    /** Cutter error (if supported) */
+    cutterError?: boolean;
+    /** Motor error (if supported) */
+    motorError?: boolean;
+    /** Temperature issue (if supported) */
+    overTemp?: boolean;
+    /** Battery level (0-100, if supported) */
+    batteryLevel?: number;
+    /** Timestamp of status check */
+    timestamp: number;
+    /** Raw status bytes */
+    rawStatus?: Uint8Array;
+}
+/**
+ * Status query options
+ */
+export interface StatusQueryOptions {
+    /** Timeout for status query in ms */
+    timeout?: number;
+    /** Include raw status bytes */
+    includeRaw?: boolean;
+}
+/**
+ * Printer Status Service
+ */
+export declare class PrinterStatus {
+    private readonly logger;
+    /**
+     * Creates a new PrinterStatus instance
+     */
+    constructor();
+    /**
+     * Get printer status
+     *
+     * Sends ESC/POS status query command and parses the response.
+     *
+     * @param writeFunc - Function to write data to printer
+     * @param readFunc - Function to read response from printer
+     * @param options - Query options
+     * @returns Printer status info
+     */
+    getStatus(writeFunc: (data: ArrayBuffer) => Promise<void>, readFunc: () => Promise<ArrayBuffer>, options?: StatusQueryOptions): Promise<PrinterStatusInfo>;
+    /**
+     * Parse status bytes from printer
+     *
+     * Different printers return different status formats.
+     * This implementation handles common ESC/POS status responses.
+     */
+    private parseStatus;
+    /**
+     * Check if paper is available
+     */
+    checkPaper(writeFunc: (data: ArrayBuffer) => Promise<void>, readFunc: () => Promise<ArrayBuffer>): Promise<PaperStatus>;
+    /**
+     * Check if printer is ready
+     */
+    isReady(writeFunc: (data: ArrayBuffer) => Promise<void>, readFunc: () => Promise<ArrayBuffer>): Promise<boolean>;
+    /**
+     * Get human-readable status string
+     */
+    static toString(status: PrinterStatusInfo): string;
+}
+export declare const printerStatus: PrinterStatus;

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

@@ -0,0 +1,11 @@
+/**
+ * Services Module
+ * 服务模块 - 提供连接管理、命令构建、任务管理等功能
+ */
+export { ConnectionManager, type ConnectionManagerConfig, type ConnectionManagerEvents, } from './ConnectionManager';
+export { CommandBuilder } from './CommandBuilder';
+export { PrintJobManager } from './PrintJobManager';
+export { PrintHistory, printHistory, type PrintHistoryEntry, type PrintHistoryStats, type HistoryQueryOptions } from './PrintHistory';
+export { PrinterStatus, printerStatus, type PrinterStatusInfo, type StatusQueryOptions, type PaperStatus } from './PrinterStatus';
+export { BatchPrintManager, batchPrintManager, type BatchJob, type BatchConfig, type BatchStats, type BatchEvents } from './BatchPrintManager';
+export * from './interfaces';

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "taro-bluetooth-print",
-  "version": "2.3.0",
-  "description": "Taro 蓝牙打印库 v2.3 - 轻量级、高性能、跨平台支持微信、支付宝、百度、字节跳动小程序及H5 Web Bluetooth",
+  "version": "2.4.0",
+  "description": "Taro 蓝牙打印库 v2.4 - 轻量级、高性能、跨平台支持微信、支付宝、百度、字节跳动小程序及H5 Web Bluetooth",
   "type": "module",
   "main": "dist/index.cjs.js",
   "module": "dist/index.es.js",
@@ -13,6 +13,18 @@
       "require": "./dist/index.cjs.js",
       "default": "./dist/index.umd.js"
     },
+    "./core": {
+      "types": "./dist/types/core/index.d.ts",
+      "import": "./dist/core/index.es.js"
+    },
+    "./drivers": {
+      "types": "./dist/types/drivers/index.d.ts",
+      "import": "./dist/drivers/index.es.js"
+    },
+    "./adapters": {
+      "types": "./dist/types/adapters/index.d.ts",
+      "import": "./dist/adapters/index.es.js"
+    },
     "./package.json": "./package.json"
   },
   "files": [
@@ -49,13 +61,19 @@
   ],
   "author": "Agions",
   "license": "MIT",
-  "dependencies": {
-    "@tarojs/taro": "^4.1.11"
+  "peerDependencies": {
+    "@tarojs/taro": "^3.6.22"
+  },
+  "peerDependenciesMeta": {
+    "@tarojs/taro": {
+      "optional": true
+    }
   },
   "devDependencies": {
     "@types/node": "^20.14.8",
-    "@typescript-eslint/eslint-plugin": "^6.19.0",
-    "@typescript-eslint/parser": "^6.19.0",
+    "@types/web-bluetooth": "^0.0.21",
+    "@typescript-eslint/eslint-plugin": "^8.57.1",
+    "@typescript-eslint/parser": "^8.57.1",
     "@vitest/coverage-v8": "^4.0.18",
     "eslint": "^8.56.0",
     "eslint-config-prettier": "^9.1.0",
@@ -67,7 +85,7 @@
     "typescript": "^5.9.3",
     "vite": "^7.3.1",
     "vite-plugin-dts": "^4.5.4",
-    "vitepress": "^1.0.0",
+    "vitepress": "^1.6.4",
     "vitest": "^4.0.18"
   },
   "sideEffects": false

package/src/adapters/AlipayAdapter.ts

@@ -6,6 +6,7 @@
 import { MiniProgramAdapter, MiniProgramBLEApi } from './BaseAdapter';
 
 // Declare Alipay global for TypeScript
+// eslint-disable-next-line @typescript-eslint/no-empty-object-type
 interface AlipayGlobal extends MiniProgramBLEApi {}
 
 declare const my: AlipayGlobal;