taro-bluetooth-print 2.2.0 → 2.3.0

package/dist/types/plugins/PluginManager.d.ts

@@ -0,0 +1,87 @@
+import { Plugin, PluginHooks, PluginOptions } from './types';
+import { BluetoothPrintError } from '../errors/BluetoothError';
+import { PrinterState } from '../types';
+/**
+ * Manages plugins for BluetoothPrinter
+ */
+export declare class PluginManager {
+    private plugins;
+    private readonly logger;
+    /**
+     * Register a plugin
+     * @param plugin - Plugin to register
+     * @param options - Plugin options
+     * @throws {BluetoothPrintError} If plugin with same name already exists
+     */
+    register(plugin: Plugin, options?: PluginOptions): Promise<void>;
+    /**
+     * Unregister a plugin
+     * @param name - Plugin name to unregister
+     */
+    unregister(name: string): Promise<void>;
+    /**
+     * Get a registered plugin
+     * @param name - Plugin name
+     * @returns Plugin instance or undefined
+     */
+    get(name: string): Plugin | undefined;
+    /**
+     * Get all registered plugin names
+     * @returns Array of plugin names
+     */
+    getNames(): string[];
+    /**
+     * Check if a plugin is registered
+     * @param name - Plugin name
+     * @returns True if registered
+     */
+    has(name: string): boolean;
+    /**
+     * Execute a hook across all plugins
+     * @param hookName - Name of the hook to execute
+     * @param args - Arguments to pass to the hook
+     * @returns Result from hooks (last non-void result)
+     */
+    executeHook<K extends keyof PluginHooks>(hookName: K, ...args: Parameters<NonNullable<PluginHooks[K]>>): Promise<unknown>;
+    /**
+     * Execute beforeConnect hooks
+     */
+    beforeConnect(deviceId: string): Promise<string>;
+    /**
+     * Execute afterConnect hooks
+     */
+    afterConnect(deviceId: string): Promise<void>;
+    /**
+     * Execute beforeDisconnect hooks
+     */
+    beforeDisconnect(deviceId: string): Promise<void>;
+    /**
+     * Execute afterDisconnect hooks
+     */
+    afterDisconnect(deviceId: string): Promise<void>;
+    /**
+     * Execute beforePrint hooks
+     */
+    beforePrint(buffer: Uint8Array): Promise<Uint8Array>;
+    /**
+     * Execute afterPrint hooks
+     */
+    afterPrint(bytesSent: number): Promise<void>;
+    /**
+     * Execute onError hooks
+     * @returns True if error should be suppressed
+     */
+    onError(error: BluetoothPrintError): Promise<boolean>;
+    /**
+     * Execute onStateChange hooks
+     */
+    onStateChange(state: PrinterState, previousState: PrinterState): Promise<void>;
+    /**
+     * Execute onProgress hooks
+     */
+    onProgress(sent: number, total: number): Promise<void>;
+    /**
+     * Clear all plugins
+     */
+    clear(): Promise<void>;
+}

package/dist/types/plugins/builtin/LoggingPlugin.d.ts

@@ -0,0 +1,14 @@
+import { PluginFactory, PluginOptions } from '../types';
+import { LogLevel } from '../../utils/logger';
+export interface LoggingPluginOptions extends PluginOptions {
+    /** Log level (default: DEBUG) */
+    level?: LogLevel;
+    /** Include timestamps (default: true) */
+    timestamps?: boolean;
+    /** Log progress updates (default: false, can be noisy) */
+    logProgress?: boolean;
+}
+/**
+ * Creates a logging plugin instance
+ */
+export declare const createLoggingPlugin: PluginFactory;

package/dist/types/plugins/builtin/RetryPlugin.d.ts

@@ -0,0 +1,18 @@
+import { PluginFactory, PluginOptions } from '../types';
+import { ErrorCode } from '../../errors/BluetoothError';
+export interface RetryPluginOptions extends PluginOptions {
+    /** Maximum retry attempts (default: 3) */
+    maxRetries?: number;
+    /** Initial delay in ms (default: 1000) */
+    initialDelay?: number;
+    /** Maximum delay in ms (default: 10000) */
+    maxDelay?: number;
+    /** Backoff multiplier (default: 2) */
+    backoffMultiplier?: number;
+    /** Error codes that should trigger retry */
+    retryableErrors?: ErrorCode[];
+}
+/**
+ * Creates a retry plugin instance
+ */
+export declare const createRetryPlugin: PluginFactory;

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

@@ -0,0 +1,7 @@
+/**
+ * Plugin System Exports
+ */
+export { PluginManager } from './PluginManager';
+export type { Plugin, PluginHooks, PluginOptions, PluginFactory } from './types';
+export { createLoggingPlugin } from './builtin/LoggingPlugin';
+export { createRetryPlugin } from './builtin/RetryPlugin';

package/dist/types/plugins/types.d.ts

@@ -0,0 +1,97 @@
+import { BluetoothPrintError } from '../errors/BluetoothError';
+import { PrinterState } from '../types';
+/**
+ * Plugin lifecycle hooks
+ */
+export interface PluginHooks {
+    /**
+     * Called before connecting to a device
+     * @param deviceId - Target device ID
+     * @returns Modified device ID or void
+     */
+    beforeConnect?: (deviceId: string) => string | void | Promise<string | void>;
+    /**
+     * Called after successful connection
+     * @param deviceId - Connected device ID
+     */
+    afterConnect?: (deviceId: string) => void | Promise<void>;
+    /**
+     * Called before disconnecting
+     * @param deviceId - Device ID to disconnect
+     */
+    beforeDisconnect?: (deviceId: string) => void | Promise<void>;
+    /**
+     * Called after disconnection
+     * @param deviceId - Disconnected device ID
+     */
+    afterDisconnect?: (deviceId: string) => void | Promise<void>;
+    /**
+     * Called before sending print data
+     * @param buffer - Data buffer to send
+     * @returns Modified buffer or void
+     */
+    beforePrint?: (buffer: Uint8Array) => Uint8Array | void | Promise<Uint8Array | void>;
+    /**
+     * Called after print job completes
+     * @param bytesSent - Total bytes sent
+     */
+    afterPrint?: (bytesSent: number) => void | Promise<void>;
+    /**
+     * Called when an error occurs
+     * @param error - The error that occurred
+     * @returns Whether to suppress the error (true = suppress)
+     */
+    onError?: (error: BluetoothPrintError) => boolean | void | Promise<boolean | void>;
+    /**
+     * Called when printer state changes
+     * @param state - New printer state
+     * @param previousState - Previous state
+     */
+    onStateChange?: (state: PrinterState, previousState: PrinterState) => void | Promise<void>;
+    /**
+     * Called during print progress
+     * @param sent - Bytes sent
+     * @param total - Total bytes
+     */
+    onProgress?: (sent: number, total: number) => void | Promise<void>;
+}
+/**
+ * Plugin configuration options
+ */
+export interface PluginOptions {
+    [key: string]: unknown;
+}
+/**
+ * Plugin interface
+ */
+export interface Plugin {
+    /**
+     * Unique plugin name
+     */
+    name: string;
+    /**
+     * Plugin version
+     */
+    version?: string;
+    /**
+     * Plugin description
+     */
+    description?: string;
+    /**
+     * Plugin hooks
+     */
+    hooks: PluginHooks;
+    /**
+     * Plugin initialization
+     * @param options - Plugin options
+     */
+    init?: (options?: PluginOptions) => void | Promise<void>;
+    /**
+     * Plugin cleanup
+     */
+    destroy?: () => void | Promise<void>;
+}
+/**
+ * Plugin factory function type
+ */
+export type PluginFactory = (options?: PluginOptions) => Plugin;

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

@@ -2,13 +2,13 @@ import { IPrinterDriver, IQrOptions } from '../types';
 import { ICommandBuilder } from './interfaces';
 import { TextAlign, TextStyle } from '../formatter';
 import { BarcodeOptions } from '../barcode';
-
 /**
  * Command Builder implementation
  */
 export declare class CommandBuilder implements ICommandBuilder {
     private driver;
     private buffer;
+    private _cachedBuffer;
     private readonly logger;
     private readonly formatter;
     private readonly barcodeGenerator;
@@ -18,6 +18,11 @@ export declare class CommandBuilder implements ICommandBuilder {
      * @param driver - Printer driver instance
      */
     constructor(driver?: IPrinterDriver);
+    /**
+     * Invalidates the cached combined buffer.
+     * Must be called whenever the internal buffer array is modified.
+     */
+    private invalidateCache;
     /**
      * Adds text to the print queue
      *

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

@@ -2,7 +2,6 @@ import { IPrinterAdapter, PrinterState } from '../types';
 import { IConnectionManager } from './interfaces';
 import { BluetoothPrintError } from '../errors/BluetoothError';
 import { EventEmitter } from '../core/EventEmitter';
-
 /**
  * Connection manager configuration
  */

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

@@ -1,10 +1,11 @@
 import { IAdapterOptions } from '../types';
 import { IPrintJobManager, IConnectionManager } from './interfaces';
-
 /**
  * Print Job Manager implementation
  */
 export declare class PrintJobManager implements IPrintJobManager {
+    /** 内存中的任务状态存储（可被子类或外部替换为持久化方案） */
+    private static jobStateStore;
     private adapter;
     private connectionManager;
     private jobBuffer;
@@ -62,7 +63,10 @@ export declare class PrintJobManager implements IPrintJobManager {
      */
     private generateJobId;
     /**
-     * Saves the current job state for resume later
+     * Saves the current job state for resume later.
+     *
+     * 默认实现使用内存存储。如需持久化（如 localStorage），
+     * 可通过 setSaveHandler/setLoadHandler 自定义。
      */
     private saveJobState;
     /**

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

@@ -1,7 +1,6 @@
 import { IAdapterOptions, IQrOptions, PrinterState, IPrinterAdapter } from '../../types';
 import { TextAlign, TextStyle } from '../../formatter';
 import { BarcodeOptions } from '../../barcode';
-
 /**
  * Connection Manager Interface
  *

package/dist/types/template/TemplateEngine.d.ts

@@ -1,6 +1,5 @@
 import { TextAlign } from '../formatter';
 import { BarcodeFormat } from '../barcode';
-
 /**
  * Template type
  */

package/package.json

@@ -1,16 +1,16 @@
 {
   "name": "taro-bluetooth-print",
-  "version": "2.2.0",
-  "description": "Taro 蓝牙打印库 v2.2 - 轻量级、高性能、跨平台支持微信、支付宝、百度、字节跳动小程序及H5 Web Bluetooth",
+  "version": "2.3.0",
+  "description": "Taro 蓝牙打印库 v2.3 - 轻量级、高性能、跨平台支持微信、支付宝、百度、字节跳动小程序及H5 Web Bluetooth",
   "type": "module",
   "main": "dist/index.cjs.js",
   "module": "dist/index.es.js",
   "types": "dist/types/index.d.ts",
   "exports": {
     ".": {
+      "types": "./dist/types/index.d.ts",
       "import": "./dist/index.es.js",
       "require": "./dist/index.cjs.js",
-      "types": "./dist/types/index.d.ts",
       "default": "./dist/index.umd.js"
     },
     "./package.json": "./package.json"
@@ -34,9 +34,9 @@
     "format:check": "prettier --check \"src/**/*.{ts,tsx,json,md}\"",
     "type-check": "tsc --noEmit",
     "prepublishOnly": "npm run build",
-    "test": "jest",
-    "test:watch": "jest --watch",
-    "test:coverage": "jest --coverage"
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "test:coverage": "vitest run --coverage"
   },
   "keywords": [
     "taro",
@@ -50,27 +50,25 @@
   "author": "Agions",
   "license": "MIT",
   "dependencies": {
-    "@tarojs/taro": "^3.6.0"
+    "@tarojs/taro": "^4.1.11"
   },
   "devDependencies": {
-    "@types/jest": "^29.5.11",
     "@types/node": "^20.14.8",
     "@typescript-eslint/eslint-plugin": "^6.19.0",
     "@typescript-eslint/parser": "^6.19.0",
+    "@vitest/coverage-v8": "^4.0.18",
     "eslint": "^8.56.0",
     "eslint-config-prettier": "^9.1.0",
     "eslint-plugin-prettier": "^5.1.3",
     "fast-check": "^4.5.3",
-    "jest": "^29.7.0",
-    "jest-environment-jsdom": "^29.7.0",
-    "prettier": "^3.2.4",
-    "rimraf": "^5.0.0",
-    "terser": "^5.24.0",
-    "ts-jest": "^29.1.1",
+    "prettier": "^3.8.1",
+    "rimraf": "^6.1.2",
+    "terser": "^5.46.0",
     "typescript": "^5.9.3",
-    "vite": "^5.0.0",
-    "vite-plugin-dts": "^3.9.1",
-    "vitepress": "^1.0.0"
+    "vite": "^7.3.1",
+    "vite-plugin-dts": "^4.5.4",
+    "vitepress": "^1.0.0",
+    "vitest": "^4.0.18"
   },
   "sideEffects": false
-}
+}