taro-bluetooth-print 2.3.1 → 2.4.1

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

@@ -5,4 +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 * from './interfaces';

package/package.json

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

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;

package/src/adapters/BaiduAdapter.ts

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

package/src/adapters/ByteDanceAdapter.ts

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

package/src/adapters/TaroAdapter.ts

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

package/src/adapters/WebBluetoothAdapter.ts

@@ -359,7 +359,7 @@ export class WebBluetoothAdapter extends BaseAdapter {
         })
         .catch(error => {
           clearTimeout(timeoutId);
-          reject(error);
+          reject(error instanceof Error ? error : new Error(String(error)));
         });
     });
   }