taro-bluetooth-print 2.4.0 → 2.4.1

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

@@ -132,7 +132,7 @@ export declare class MultiPrinterManager {
     /**
      * Print to a specific printer
      */
-    print(printerId: string, data: Uint8Array): Promise<void>;
+    print(printerId: string, data: Uint8Array): void;
     /**
      * Broadcast data to all connected printers
      */

package/dist/types/index.d.ts

@@ -43,7 +43,7 @@ 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 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/index.d.ts

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

package/src/config/PrinterConfigManager.ts

@@ -425,12 +425,16 @@ export class PrinterConfigManager {
    * Export all configuration as JSON
    */
   export(): string {
-    return JSON.stringify({
-      printers: Array.from(this.printers.values()),
-      globalConfig: this.globalConfig,
-      lastUsedPrinterId: this.lastUsedPrinterId,
-      exportedAt: Date.now(),
-    }, null, 2);
+    return JSON.stringify(
+      {
+        printers: Array.from(this.printers.values()),
+        globalConfig: this.globalConfig,
+        lastUsedPrinterId: this.lastUsedPrinterId,
+        exportedAt: Date.now(),
+      },
+      null,
+      2
+    );
   }
 
   /**

package/src/device/MultiPrinterManager.ts

@@ -26,6 +26,7 @@
 import { Logger } from '@/utils/logger';
 import { BluetoothPrintError, ErrorCode } from '@/errors/BluetoothError';
 import { BluetoothPrinter } from '@/core/BluetoothPrinter';
+import { PrinterState } from '@/types';
 
 /**
  * Printer connection info
@@ -137,11 +138,12 @@ export class MultiPrinterManager {
    * Emit an event
    */
   // eslint-disable-next-line @typescript-eslint/no-explicit-any
+  // eslint-disable-next-line @typescript-eslint/no-unsafe-call
   private emit<K extends keyof MultiPrinterManagerEvents>(event: K, data: any): void {
     this.listeners[event].forEach(handler => {
       try {
-        // eslint-disable-next-line @typescript-eslint/no-explicit-any
-        (handler as any)(data);
+        // eslint-disable-next-line @typescript-eslint/no-unsafe-call
+        (handler as (data: any) => void)(data);
       } catch (error) {
         this.logger.error(`Error in event handler for "${event}":`, error);
       }
@@ -200,7 +202,7 @@ export class MultiPrinterManager {
       const printer = new BluetoothPrinter();
 
       // Set up error handler
-      printer.on('error', (error) => {
+      printer.on('error', error => {
         this.emit('printer-error', { printerId, error });
       });
 
@@ -323,13 +325,10 @@ export class MultiPrinterManager {
   /**
    * Print to a specific printer
    */
-  async print(printerId: string, data: Uint8Array): Promise<void> {
+  print(printerId: string, data: Uint8Array): void {
     const connection = this.printers.get(printerId);
     if (!connection) {
-      throw new BluetoothPrintError(
-        ErrorCode.DEVICE_NOT_FOUND,
-        `Printer not found: ${printerId}`
-      );
+      throw new BluetoothPrintError(ErrorCode.DEVICE_NOT_FOUND, `Printer not found: ${printerId}`);
     }
 
     connection.lastActivity = Date.now();
@@ -358,6 +357,7 @@ export class MultiPrinterManager {
     }
 
     const printPromises = Array.from(this.printers.entries()).map(
+      // eslint-disable-next-line @typescript-eslint/require-await
       async ([printerId, connection]) => {
         try {
           // Update activity
@@ -401,7 +401,7 @@ export class MultiPrinterManager {
    */
   getIdlePrinters(): PrinterConnection[] {
     return Array.from(this.printers.values())
-      .filter(c => c.printer.state === 'connected')
+      .filter(c => c.printer.state === PrinterState.CONNECTED)
       .sort((a, b) => (a.lastActivity ?? 0) - (b.lastActivity ?? 0));
   }
 
@@ -420,7 +420,7 @@ export class MultiPrinterManager {
     };
 
     for (const connection of this.printers.values()) {
-      if (connection.printer.state === 'connected') {
+      if (connection.printer.state === PrinterState.CONNECTED) {
         stats.connected++;
       }
 

package/src/index.ts

@@ -98,11 +98,7 @@ export type {
 } from './config/PrinterConfig';
 
 export { PrinterConfigManager, printerConfigManager } from './config/PrinterConfigManager';
-export type {
-  SavedPrinter,
-  GlobalConfig,
-  IConfigStorage,
-} from './config/PrinterConfigManager';
+export type { SavedPrinter, GlobalConfig, IConfigStorage } from './config/PrinterConfigManager';
 
 // Plugin System - 插件系统
 export { PluginManager } from './plugins/PluginManager';

package/src/services/BatchPrintManager.ts

@@ -92,11 +92,11 @@ type BatchEventHandlerMap = {
  * Default batch configuration
  */
 const DEFAULT_CONFIG: BatchConfig = {
-  maxBatchSize: 1024 * 50,      // 50KB max per batch
-  maxWaitTime: 1000,            // 1 second max wait
-  minBatchSize: 1,              // Process even single jobs
-  enableMerging: true,          // Enable content merging
-  autoProcessInterval: 500,     // Check every 500ms
+  maxBatchSize: 1024 * 50, // 50KB max per batch
+  maxWaitTime: 1000, // 1 second max wait
+  minBatchSize: 1, // Process even single jobs
+  enableMerging: true, // Enable content merging
+  autoProcessInterval: 500, // Check every 500ms
 };
 
 /**
@@ -136,20 +136,14 @@ export class BatchPrintManager {
   /**
    * Register event listener
    */
-  on<K extends keyof BatchEvents>(
-    event: K,
-    callback: BatchEvents[K]
-  ): void {
+  on<K extends keyof BatchEvents>(event: K, callback: BatchEvents[K]): void {
     this.listeners[event].add(callback);
   }
 
   /**
    * Remove event listener
    */
-  off<K extends keyof BatchEvents>(
-    event: K,
-    callback: BatchEvents[K]
-  ): void {
+  off<K extends keyof BatchEvents>(event: K, callback: BatchEvents[K]): void {
     this.listeners[event].delete(callback);
   }
 
@@ -157,11 +151,11 @@ export class BatchPrintManager {
    * Emit an event
    */
   // eslint-disable-next-line @typescript-eslint/no-explicit-any
-  private emit<K extends keyof BatchEvents>(event: K, data: any): void {
+  private emit<K extends keyof BatchEvents>(event: K, data: Parameters<BatchEvents[K]>[0]): void {
     this.listeners[event].forEach(handler => {
       try {
-        // eslint-disable-next-line @typescript-eslint/no-explicit-any
-        (handler as any)(data);
+        // eslint-disable-next-line @typescript-eslint/no-unsafe-call
+        (handler as (data: Parameters<BatchEvents[K]>[0]) => void)(data);
       } catch (error) {
         this.logger.error(`Error in event handler for "${event}":`, error);
       }
@@ -176,11 +170,7 @@ export class BatchPrintManager {
    * @param metadata - Optional metadata
    * @returns Job ID
    */
-  addJob(
-    data: Uint8Array,
-    priority = 1,
-    metadata?: Record<string, unknown>
-  ): string {
+  addJob(data: Uint8Array, priority = 1, metadata?: Record<string, unknown>): string {
     const id = this.generateId();
     const job: BatchJob = {
       id,
@@ -216,7 +206,9 @@ export class BatchPrintManager {
   /**
    * Add multiple jobs at once
    */
-  addJobs(jobs: Array<{ data: Uint8Array; priority?: number; metadata?: Record<string, unknown> }>): string[] {
+  addJobs(
+    jobs: Array<{ data: Uint8Array; priority?: number; metadata?: Record<string, unknown> }>
+  ): string[] {
     return jobs.map(job => this.addJob(job.data, job.priority, job.metadata));
   }
 
@@ -279,9 +271,7 @@ export class BatchPrintManager {
    * @param processor - Function to send batch data to printer
    * @returns Number of jobs processed
    */
-  async processBatch(
-    processor: (data: Uint8Array) => Promise<void>
-  ): Promise<number> {
+  async processBatch(processor: (data: Uint8Array) => Promise<void>): Promise<number> {
     if (this.isProcessing) {
       throw new BluetoothPrintError(
         ErrorCode.PRINT_JOB_IN_PROGRESS,
@@ -390,7 +380,11 @@ export class BatchPrintManager {
 
     // Large single job
     const firstJob = this.jobs[0];
-    if (this.jobs.length === 1 && firstJob && firstJob.data.length >= this.config.maxBatchSize * 0.8) {
+    if (
+      this.jobs.length === 1 &&
+      firstJob &&
+      firstJob.data.length >= this.config.maxBatchSize * 0.8
+    ) {
       return true;
     }
 

package/src/services/PrintHistory.ts

@@ -139,12 +139,15 @@ export class PrintHistory {
   /**
    * Update job status
    */
-  updateJob(id: string, updates: Partial<{
-    status: PrintJobStatus | 'unknown';
-    startedAt: number;
-    completedAt: number;
-    error: string;
-  }>): void {
+  updateJob(
+    id: string,
+    updates: Partial<{
+      status: PrintJobStatus | 'unknown';
+      startedAt: number;
+      completedAt: number;
+      error: string;
+    }>
+  ): void {
     const entry = this.entries.get(id);
     if (!entry) {
       this.logger.warn(`History entry not found: ${id}`);
@@ -242,9 +245,7 @@ export class PrintHistory {
     }
 
     const completed = entries.filter(e => e.status === PrintJobStatus.COMPLETED);
-    const failed = entries.filter(e => 
-      e.status === PrintJobStatus.FAILED || e.error
-    );
+    const failed = entries.filter(e => e.status === PrintJobStatus.FAILED || e.error);
     const cancelled = entries.filter(e => e.status === PrintJobStatus.CANCELLED);
 
     const totalDuration = completed
@@ -320,8 +321,9 @@ export class PrintHistory {
     }
 
     // Remove oldest entries
-    const sorted = Array.from(this.entries.entries())
-      .sort((a, b) => a[1].createdAt - b[1].createdAt);
+    const sorted = Array.from(this.entries.entries()).sort(
+      (a, b) => a[1].createdAt - b[1].createdAt
+    );
 
     const toRemove = sorted.slice(0, this.entries.size - this.maxEntries);
     for (const [id] of toRemove) {

package/src/services/PrintJobManager.ts

@@ -40,10 +40,10 @@ interface SavedJobState {
 export class PrintJobManager implements IPrintJobManager {
   /** Instance-level job state storage (per-printer support) */
   private instanceJobStateStore: Map<string, SavedJobState> = new Map();
-  
+
   /** Static job state store for backward compatibility */
   private static _jobStateStore: Map<string, SavedJobState> = new Map();
-  
+
   /**
    * Get the static job state store (for backward compatibility)
    * @deprecated Use instance-level store instead for multi-printer support
@@ -332,7 +332,7 @@ export class PrintJobManager implements IPrintJobManager {
   /**
    * 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 = 3600000): number {

package/src/services/PrinterStatus.ts

@@ -70,8 +70,8 @@ const ESCPOS_STATUS_NUL = 0x04; // ENQ
 /**
  * Status response bit masks for common printers
  */
-const STATUS_BIT_PAPER_OUT = 0x20;   // Bit 5: Paper out
-const STATUS_BIT_PAPER_LOW = 0x40;   // Bit 6: Paper low
+const STATUS_BIT_PAPER_OUT = 0x20; // Bit 5: Paper out
+const STATUS_BIT_PAPER_LOW = 0x40; // Bit 6: Paper low
 
 /**
  * Printer Status Service
@@ -109,18 +109,12 @@ export class PrinterStatus {
       // Set up timeout promise
       const timeoutPromise = new Promise<ArrayBuffer>((_, reject) => {
         setTimeout(() => {
-          reject(new BluetoothPrintError(
-            ErrorCode.CONNECTION_TIMEOUT,
-            'Status query timed out'
-          ));
+          reject(new BluetoothPrintError(ErrorCode.CONNECTION_TIMEOUT, 'Status query timed out'));
         }, timeout);
       });
 
       // Read response with timeout
-      const response = await Promise.race([
-        readFunc(),
-        timeoutPromise
-      ]);
+      const response = await Promise.race([readFunc(), timeoutPromise]);
 
       return this.parseStatus(new Uint8Array(response), includeRaw);
     } catch (error) {

package/src/services/index.ts

@@ -13,10 +13,29 @@ export { CommandBuilder } from './CommandBuilder';
 
 export { PrintJobManager } from './PrintJobManager';
 
-export { PrintHistory, printHistory, type PrintHistoryEntry, type PrintHistoryStats, type HistoryQueryOptions } from './PrintHistory';
+export {
+  PrintHistory,
+  printHistory,
+  type PrintHistoryEntry,
+  type PrintHistoryStats,
+  type HistoryQueryOptions,
+} from './PrintHistory';
 
-export { PrinterStatus, printerStatus, type PrinterStatusInfo, type StatusQueryOptions, type PaperStatus } from './PrinterStatus';
+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 {
+  BatchPrintManager,
+  batchPrintManager,
+  type BatchJob,
+  type BatchConfig,
+  type BatchStats,
+  type BatchEvents,
+} from './BatchPrintManager';
 
 export * from './interfaces';