taro-bluetooth-print 2.9.0 → 2.9.2

package/dist/types/core/di/Container.d.ts

@@ -0,0 +1,84 @@
+/**
+ * 依赖注入容器
+ * 提供现代化的依赖管理和服务定位功能
+ */
+export type Constructor<T = object> = new (...args: any[]) => T;
+export type Factory<T> = (container: Container) => T;
+export type Provider<T> = Constructor<T> | Factory<T> | T;
+export interface RegistrationOptions {
+    /** 是否单例 */
+    singleton?: boolean;
+    /** 生命周期 */
+    lifecycle?: 'transient' | 'singleton' | 'scoped';
+    /** 标签，用于区分同一接口的不同实现 */
+    tag?: string;
+}
+/**
+ * Angular 风格的服务提供者配置
+ */
+export interface ServiceProviderConfig<T = unknown> {
+    /** 使用类 */
+    useClass?: Constructor<T>;
+    /** 使用工厂函数 */
+    useFactory?: Factory<T>;
+    /** 使用实例值 */
+    useValue?: T;
+    /** 生命周期 */
+    lifecycle?: 'transient' | 'singleton' | 'scoped';
+    /** 依赖项 */
+    dependencies?: (string | symbol | Constructor<unknown>)[];
+}
+export declare class Container {
+    private registrations;
+    private parent?;
+    private scopedInstances;
+    constructor(parent?: Container);
+    /**
+     * 创建子容器
+     */
+    createChild(): Container;
+    /**
+     * 注册服务
+     */
+    register<T>(token: string | symbol | Constructor<T>, provider: Provider<T> | ServiceProviderConfig<T>, options?: RegistrationOptions): this;
+    /**
+     * 注册单例服务
+     */
+    registerSingleton<T>(token: string | symbol | Constructor<T>, provider: Provider<T>): this;
+    /**
+     * 注册类型映射
+     */
+    registerType<T>(from: string | symbol | Constructor<T>, to: Constructor<T>, options?: RegistrationOptions): this;
+    /**
+     * 注册实例
+     */
+    registerInstance<T>(token: string | symbol | Constructor<T>, instance: T): this;
+    /**
+     * 解析服务
+     */
+    resolve<T>(token: string | symbol | Constructor<T>, tag?: string): T;
+    /**
+     * 解析所有注册的服务
+     */
+    resolveAll<T>(token: string | symbol | Constructor<T>): T[];
+    /**
+     * 检查是否已注册
+     */
+    isRegistered<T>(token: string | symbol | Constructor<T>): boolean;
+    /**
+     * 清除所有注册
+     */
+    clear(): void;
+    /**
+     * 创建作用域
+     */
+    createScope(): Container;
+    private getTokenKey;
+    private isConstructor;
+    private getOrCreateInstance;
+    private createProviderInstance;
+    private createInstance;
+}
+export declare const rootContainer: Container;
+export declare function injectable<T extends Constructor<object>>(constructor: T): T;
+export declare function inject(token: string | symbol): (target: any, _propertyKey: string | symbol, parameterIndex: number) => any;

package/dist/types/core/di/Tokens.d.ts

@@ -0,0 +1,29 @@
+/**
+ * 服务标识符（Tokens）
+ * 用于依赖注入的常量定义
+ */
+export declare const ADAPTER_TOKEN: unique symbol;
+export declare const ADAPTER_FACTORY_TOKEN: unique symbol;
+export declare const DRIVER_TOKEN: unique symbol;
+export declare const DRIVER_FACTORY_TOKEN: unique symbol;
+export declare const DEVICE_MANAGER_TOKEN: unique symbol;
+export declare const CONNECTION_MANAGER_TOKEN: unique symbol;
+export declare const PRINT_JOB_MANAGER_TOKEN: unique symbol;
+export declare const PRINT_QUEUE_TOKEN: unique symbol;
+export declare const OFFLINE_CACHE_TOKEN: unique symbol;
+export declare const CONFIG_MANAGER_TOKEN: unique symbol;
+export declare const COMMAND_BUILDER_TOKEN: unique symbol;
+export declare const PRINTER_STATUS_TOKEN: unique symbol;
+export declare const PRINT_HISTORY_TOKEN: unique symbol;
+export declare const PRINT_STATISTICS_TOKEN: unique symbol;
+export declare const CLOUD_PRINT_MANAGER_TOKEN: unique symbol;
+export declare const SCHEDULED_RETRY_MANAGER_TOKEN: unique symbol;
+export declare const BATCH_PRINT_MANAGER_TOKEN: unique symbol;
+export declare const LOGGER_TOKEN: unique symbol;
+export declare const ENCODING_SERVICE_TOKEN: unique symbol;
+export declare const IMAGE_PROCESSING_TOKEN: unique symbol;
+export declare const BARCODE_GENERATOR_TOKEN: unique symbol;
+export declare const TEMPLATE_ENGINE_TOKEN: unique symbol;
+export declare const EVENT_BUS_TOKEN: unique symbol;
+export declare const PLUGIN_MANAGER_TOKEN: unique symbol;
+export declare const PERFORMANCE_MONITOR_TOKEN: unique symbol;

package/dist/types/core/di/index.d.ts

@@ -0,0 +1,3 @@
+export { Container, rootContainer, injectable, inject } from './Container';
+export type { ServiceProviderConfig, RegistrationOptions } from './Container';
+export * from './Tokens';

package/dist/types/core/event/EventBus.d.ts

@@ -0,0 +1,66 @@
+/**
+ * 事件总线 - 提供强大的事件驱动能力
+ * 支持事件订阅、发布、一次性监听、异步处理等
+ */
+export type EventHandler<T = any> = (payload: T) => void | Promise<void>;
+export type EventFilter<T = any> = (payload: T) => boolean;
+export interface EventSubscription {
+    unsubscribe(): void;
+}
+export interface EventOptions {
+    /** 优先级，数字越小优先级越高 */
+    priority?: number;
+    /** 过滤器 */
+    filter?: EventFilter<any>;
+    /** 是否只监听一次 */
+    once?: boolean;
+    /** 超时时间（毫秒） */
+    timeout?: number;
+}
+export declare class EventBus {
+    private listeners;
+    private listenerIdCounter;
+    /**
+     * 订阅事件
+     */
+    on<T>(event: string | symbol, handler: EventHandler<T>, options?: EventOptions): EventSubscription;
+    /**
+     * 只监听一次
+     */
+    once<T>(event: string | symbol, handler: EventHandler<T>, options?: Omit<EventOptions, 'once'>): EventSubscription;
+    /**
+     * 取消订阅
+     */
+    off<T>(event: string | symbol, handler: EventHandler<T>): void;
+    /**
+     * 发布事件
+     */
+    emit<T>(event: string | symbol, payload: T): Promise<void>;
+    /**
+     * 同步发布事件（不等待处理完成）
+     */
+    emitSync<T>(event: string | symbol, payload: T): void;
+    /**
+     * 等待特定事件
+     */
+    waitFor<T>(event: string | symbol, timeout?: number, _filter?: EventFilter<T>): Promise<T>;
+    /**
+     * 检查是否有监听器
+     */
+    hasListeners(event: string | symbol): boolean;
+    /**
+     * 获取监听器数量
+     */
+    listenerCount(event: string | symbol): number;
+    /**
+     * 移除所有监听器
+     */
+    removeAllListeners(event?: string | symbol): void;
+    /**
+     * 获取所有事件名称
+     */
+    eventNames(): (string | symbol)[];
+    private generateListenerId;
+    private executeWithTimeout;
+}
+export declare const globalEventBus: EventBus;

package/dist/types/core/event/index.d.ts

@@ -0,0 +1,2 @@
+export { EventBus, globalEventBus } from './EventBus';
+export type { EventHandler, EventFilter, EventSubscription, EventOptions } from './EventBus';

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

@@ -1,6 +1,7 @@
 /**
- * Core Module - 核心模块
+ * 核心架构模块
+ * 提供依赖注入、事件总线、插件管理等核心能力
  */
-export { BluetoothPrinter } from './BluetoothPrinter';
-export type { PrinterEvents } from './BluetoothPrinter';
-export { EventEmitter } from './EventEmitter';
+export * from './di';
+export * from './event';
+export * from './plugin';

package/dist/types/core/plugin/PluginManager.d.ts

@@ -0,0 +1,64 @@
+import { EventBus } from '../event/EventBus';
+import { Container } from '../di/Container';
+export interface PluginContext {
+    /** 事件总线 */
+    eventBus: EventBus;
+    /** DI容器 */
+    container: Container;
+    /** 配置 */
+    config: Record<string, unknown>;
+}
+export interface Plugin {
+    /** 插件名称 */
+    name: string;
+    /** 插件版本 */
+    version: string;
+    /** 插件依赖 */
+    dependencies?: string[];
+    /** 安装插件 */
+    install(context: PluginContext): void | Promise<void>;
+    /** 卸载插件 */
+    uninstall?(context: PluginContext): void | Promise<void>;
+}
+export interface PluginRegistration {
+    plugin: Plugin;
+    config: Record<string, unknown>;
+    installed: boolean;
+}
+export declare class PluginManager {
+    private plugins;
+    private context;
+    constructor(context: PluginContext);
+    /**
+     * 注册插件
+     */
+    register(plugin: Plugin, config?: Record<string, unknown>): void;
+    /**
+     * 安装插件
+     */
+    install(pluginName: string): Promise<void>;
+    /**
+     * 卸载插件
+     */
+    uninstall(pluginName: string): Promise<void>;
+    /**
+     * 批量安装插件
+     */
+    installAll(): Promise<void>;
+    /**
+     * 获取插件
+     */
+    getPlugin(name: string): Plugin | undefined;
+    /**
+     * 检查插件是否已安装
+     */
+    isInstalled(name: string): boolean;
+    /**
+     * 获取所有已安装的插件
+     */
+    getInstalledPlugins(): Plugin[];
+    /**
+     * 获取所有已注册的插件
+     */
+    getRegisteredPlugins(): Plugin[];
+}

package/dist/types/core/plugin/index.d.ts

@@ -0,0 +1,2 @@
+export { PluginManager } from './PluginManager';
+export type { Plugin, PluginContext, PluginRegistration } from './PluginManager';

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

@@ -15,6 +15,8 @@ export interface PrinterConnection {
     connectedAt: number;
     /** Last activity timestamp */
     lastActivity?: number;
+    /** Error handler reference (for cleanup) */
+    errorHandler?: (error: Error) => void;
 }
 /**
  * Connection options

package/dist/types/factory/di-factory.d.ts

@@ -0,0 +1,52 @@
+import { BluetoothPrinter } from '../core/BluetoothPrinter';
+import { createServiceProvider, ServiceProviderOptions } from '../providers';
+import { IConnectionManager, IPrintJobManager, ICommandBuilder } from '../services/interfaces';
+/**
+ * 创建打印机实例的选项
+ */
+export interface CreatePrinterOptions extends ServiceProviderOptions {
+    /** 自定义连接管理器 */
+    connectionManager?: IConnectionManager;
+    /** 自定义打印任务管理器 */
+    printJobManager?: IPrintJobManager;
+    /** 自定义命令构建器 */
+    commandBuilder?: ICommandBuilder;
+}
+/**
+ * 使用依赖注入创建 BluetoothPrinter 实例
+ *
+ * @example
+ * ```typescript
+ * // 基本用法
+ * const printer = createPrinter();
+ *
+ * // 使用自定义配置
+ * const printer = createPrinter({
+ *   config: { debug: true },
+ *   useGlobalEventBus: true
+ * });
+ * ```
+ */
+export declare function createPrinter(options?: CreatePrinterOptions): BluetoothPrinter;
+/**
+ * 获取服务提供者（用于访问所有服务）
+ */
+export declare function getServiceProvider(options?: ServiceProviderOptions): {
+    getConnectionManager: () => unknown;
+    getPrintJobManager: () => unknown;
+    getCommandBuilder: () => unknown;
+    getDeviceManager: () => unknown;
+    getPrintQueue: () => unknown;
+    getOfflineCache: () => unknown;
+    getConfigManager: () => unknown;
+    getPrinterStatus: () => unknown;
+    getPrintHistory: () => unknown;
+    getPrintStatistics: () => unknown;
+    getCloudPrintManager: () => unknown;
+    getScheduledRetryManager: () => unknown;
+    getBatchPrintManager: () => unknown;
+    getEventBus: () => unknown;
+    getPluginManager: () => unknown;
+    getAdapter: () => unknown;
+};
+export { createServiceProvider, ServiceProviderOptions };

package/dist/types/index.d.ts

@@ -39,16 +39,20 @@ export { Logger, LogLevel } from './utils/logger';
 export { Encoding } from './utils/encoding';
 export { ImageProcessing } from './utils/image';
 export { PlatformType, detectPlatform, isPlatformSupported } from './utils/platform';
+export { truncateString, truncateForLog, batchProcess, createLimitedLogger, generateSummary, } from './utils/outputLimiter';
+export type { TruncateOptions } from './utils/outputLimiter';
 export { BluetoothPrintError, ErrorCode } from './errors/BluetoothError';
 export { ConnectionError, ConnectionErrorCode } from './errors/ConnectionError';
 export { PrintJobError, PrintJobErrorCode } from './errors/PrintJobError';
 export { CommandBuildError, CommandBuildErrorCode } from './errors/CommandBuildError';
 export { createBluetoothPrinter, createWebBluetoothPrinter, PrinterFactory, type PrinterFactoryOptions, } from './factory';
+export { createPrinter, getServiceProvider, createServiceProvider, type CreatePrinterOptions, type ServiceProviderOptions, } from './factory/di-factory';
+export { Container, rootContainer, injectable, inject, EventBus, globalEventBus, PluginManager, } from './core';
+export { ADAPTER_TOKEN, DRIVER_TOKEN, DEVICE_MANAGER_TOKEN, CONNECTION_MANAGER_TOKEN, PRINT_JOB_MANAGER_TOKEN, PRINT_QUEUE_TOKEN, OFFLINE_CACHE_TOKEN, CONFIG_MANAGER_TOKEN, LOGGER_TOKEN, EVENT_BUS_TOKEN, PLUGIN_MANAGER_TOKEN, PERFORMANCE_MONITOR_TOKEN, COMMAND_BUILDER_TOKEN, PRINTER_STATUS_TOKEN, PRINT_HISTORY_TOKEN, PRINT_STATISTICS_TOKEN, CLOUD_PRINT_MANAGER_TOKEN, SCHEDULED_RETRY_MANAGER_TOKEN, BATCH_PRINT_MANAGER_TOKEN, } from './core';
 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';
 export * from './types';

package/dist/types/providers/ServiceProvider.d.ts

@@ -0,0 +1,56 @@
+/**
+ * Service Provider Module
+ *
+ * 将现有服务层注册到 DI 容器
+ */
+/**
+ * 服务提供者配置选项
+ */
+export interface ServiceProviderOptions {
+    /** 是否启用全局事件总线 */
+    useGlobalEventBus?: boolean;
+    /** 自定义配置 */
+    config?: Record<string, unknown>;
+}
+/**
+ * 注册所有服务到 DI 容器
+ */
+export declare function registerServices(options?: ServiceProviderOptions): void;
+/**
+ * 创建配置好的服务提供者
+ */
+export declare function createServiceProvider(options?: ServiceProviderOptions): {
+    /** 获取连接管理器 */
+    getConnectionManager: () => unknown;
+    /** 获取打印任务管理器 */
+    getPrintJobManager: () => unknown;
+    /** 获取命令构建器 */
+    getCommandBuilder: () => unknown;
+    /** 获取设备管理器 */
+    getDeviceManager: () => unknown;
+    /** 获取打印队列 */
+    getPrintQueue: () => unknown;
+    /** 获取离线缓存 */
+    getOfflineCache: () => unknown;
+    /** 获取配置管理器 */
+    getConfigManager: () => unknown;
+    /** 获取打印机状态服务 */
+    getPrinterStatus: () => unknown;
+    /** 获取打印历史服务 */
+    getPrintHistory: () => unknown;
+    /** 获取打印统计服务 */
+    getPrintStatistics: () => unknown;
+    /** 获取云打印管理器 */
+    getCloudPrintManager: () => unknown;
+    /** 获取定时重试管理器 */
+    getScheduledRetryManager: () => unknown;
+    /** 获取批量打印管理器 */
+    getBatchPrintManager: () => unknown;
+    /** 获取事件总线 */
+    getEventBus: () => unknown;
+    /** 获取插件管理器 */
+    getPluginManager: () => unknown;
+    /** 获取适配器 */
+    getAdapter: () => unknown;
+};
+export type ServiceProvider = ReturnType<typeof createServiceProvider>;

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

@@ -0,0 +1,2 @@
+export { registerServices, createServiceProvider } from './ServiceProvider';
+export type { ServiceProviderOptions, ServiceProvider } from './ServiceProvider';

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

@@ -1,5 +1,19 @@
-import { TextAlign } from '../formatter';
-import { BarcodeFormat } from '../barcode';
+/**
+ * Template Engine
+ *
+ * Provides template parsing and rendering for receipts and labels.
+ * Supports variable substitution, conditional rendering, loops, and border/table drawing.
+ *
+ * @example
+ * ```typescript
+ * const engine = new TemplateEngine();
+ * const commands = engine.renderReceipt({
+ *   store: { name: 'My Store' },
+ *   items: [{ name: 'Item 1', quantity: 2, price: 10 }],
+ *   payment: { total: 20, method: 'Cash' }
+ * });
+ * ```
+ */
 /**
  * Template type
  */
@@ -64,7 +78,7 @@ export interface LabelData {
     name: string;
     price: number;
     barcode?: string;
-    barcodeFormat?: BarcodeFormat;
+    barcodeFormat?: import('../barcode').BarcodeFormat;
     spec?: string;
     productionDate?: string;
     expiryDate?: string;
@@ -155,9 +169,9 @@ export interface TableColumn {
     /** Width of column in characters */
     width: number;
     /** Text alignment for header */
-    headerAlign?: TextAlign;
+    headerAlign?: import('../formatter').TextAlign;
     /** Text alignment for cells */
-    cellAlign?: TextAlign;
+    cellAlign?: import('../formatter').TextAlign;
 }
 /**
  * Table row data
@@ -186,7 +200,7 @@ export interface TableElement {
 export type TemplateElement = {
     type: 'text';
     content: string;
-    align?: TextAlign;
+    align?: import('../formatter').TextAlign;
     size?: number;
     bold?: boolean;
 } | {
@@ -205,7 +219,7 @@ export type TemplateElement = {
 } | {
     type: 'barcode';
     content: string;
-    format: BarcodeFormat;
+    format: import('../barcode').BarcodeFormat;
     height?: number;
 } | {
     type: 'feed';
@@ -247,15 +261,13 @@ export interface ITemplateEngine {
 }
 /**
  * Template Engine class
- * Renders print templates to ESC/POS commands
+ * Facade for template parsing and rendering
  */
 export declare class TemplateEngine implements ITemplateEngine {
     private readonly logger;
-    private readonly formatter;
-    private readonly barcodeGenerator;
-    private readonly driver;
+    private readonly parser;
+    private readonly renderer;
     private readonly templates;
-    private readonly paperWidth;
     /**
      * Creates a new TemplateEngine instance
      */
@@ -284,61 +296,5 @@ export declare class TemplateEngine implements ITemplateEngine {
      * Validate template data
      */
     validate(template: TemplateDefinition, data: Record<string, unknown>): ValidationResult;
-    /**
-     * Render a single template element
-     */
-    private renderElement;
-    /**
-     * Render a loop element
-     */
-    private renderLoop;
-    /**
-     * Render a condition element
-     */
-    private renderCondition;
-    /**
-     * Evaluate a condition
-     */
-    private evaluateCondition;
-    /**
-     * Render a border element
-     */
-    private renderBorder;
-    /**
-     * Render a table element
-     */
-    private renderTable;
-    /**
-     * Align text within a specified width
-     */
-    private alignText;
-    /**
-     * Render standard elements (text, line, image, qrcode, barcode, feed, variable)
-     */
-    private renderStandardElement;
-    /**
-     * Render a separator line
-     */
-    private renderLine;
-    /**
-     * Format an item line with columns
-     */
-    private formatItemLine;
-    /**
-     * Substitute variables in a string
-     */
-    private substituteVariables;
-    /**
-     * Get nested value from object
-     */
-    private getNestedValue;
-    /**
-     * Format a value with optional format string
-     */
-    private formatValue;
-    /**
-     * Combine multiple command arrays into one
-     */
-    private combineCommands;
 }
 export declare const templateEngine: TemplateEngine;

package/dist/types/template/engines/TemplateRenderer.d.ts

@@ -0,0 +1,71 @@
+import { TextAlign } from '../../formatter';
+import { TemplateElement, LoopElement, ConditionElement, BorderElement, TableElement, ReceiptData, LabelData } from '../TemplateEngine';
+/**
+ * Template Renderer class
+ * Renders template elements to ESC/POS commands
+ */
+export declare class TemplateRenderer {
+    private readonly logger;
+    private readonly formatter;
+    private readonly barcodeGenerator;
+    private readonly driver;
+    private readonly parser;
+    private readonly paperWidth;
+    constructor(paperWidth?: number);
+    /**
+     * Render a receipt template
+     */
+    renderReceipt(data: ReceiptData): Uint8Array;
+    /**
+     * Render a label template
+     */
+    renderLabel(data: LabelData): Uint8Array;
+    /**
+     * Render a custom template
+     */
+    render(template: import('../TemplateEngine').TemplateDefinition, data: Record<string, unknown>): Uint8Array;
+    /**
+     * Render a single template element
+     */
+    renderElement(element: TemplateElement, data: Record<string, unknown>): Uint8Array[];
+    /**
+     * Render a loop element
+     */
+    renderLoop(loop: LoopElement, data: Record<string, unknown>): Uint8Array[];
+    /**
+     * Render a condition element
+     */
+    renderCondition(condition: ConditionElement, data: Record<string, unknown>): Uint8Array[];
+    /**
+     * Evaluate a condition
+     */
+    evaluateCondition(value: unknown, operator: ConditionElement['operator'], compareValue?: unknown): boolean;
+    /**
+     * Render a border element
+     */
+    renderBorder(border: BorderElement): Uint8Array[];
+    /**
+     * Render a table element
+     */
+    renderTable(table: TableElement, data: Record<string, unknown>): Uint8Array[];
+    /**
+     * Align text within a specified width
+     */
+    alignText(text: string, width: number, align: TextAlign): string;
+    /**
+     * Render standard elements (text, line, image, qrcode, barcode, feed, variable)
+     */
+    renderStandardElement(element: Exclude<TemplateElement, LoopElement | ConditionElement | BorderElement | TableElement>, data: Record<string, unknown>): Uint8Array[];
+    /**
+     * Render a separator line
+     */
+    renderLine(char?: string, length?: number): Uint8Array[];
+    /**
+     * Format an item line with columns
+     */
+    formatItemLine(name: string, qty: string, amount: string): string;
+    /**
+     * Combine multiple command arrays into one
+     */
+    combineCommands(commands: Uint8Array[]): Uint8Array;
+}

package/dist/types/template/parsers/TemplateParser.d.ts

@@ -0,0 +1,23 @@
+import { TemplateDefinition, ValidationResult } from '../TemplateEngine';
+/**
+ * Template Parser class
+ * Handles template validation and data extraction
+ */
+export declare class TemplateParser {
+    /**
+     * Validate template data
+     */
+    validate(template: TemplateDefinition, data: Record<string, unknown>): ValidationResult;
+    /**
+     * Substitute variables in a string
+     */
+    substituteVariables(template: string, data: Record<string, unknown>): string;
+    /**
+     * Get nested value from object
+     */
+    getNestedValue(obj: Record<string, unknown>, path: string): unknown;
+    /**
+     * Format a value with optional format string
+     */
+    formatValue(value: unknown, format?: string): string;
+}

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

@@ -0,0 +1,8 @@
+/**
+ * 工具函数集合
+ */
+export * from './encoding';
+export * from './image';
+export * from './logger';
+export * from './uuid';
+export * from './outputLimiter';

package/dist/types/utils/logger.d.ts

@@ -1,6 +1,3 @@
-/**
- * Logging utilities for debugging and monitoring
- */
 /**
  * Log entry structure
  */
@@ -42,6 +39,10 @@ export interface LoggerConfig {
     prefix: string;
     /** Custom log handler function */
     handler?: LogHandler;
+    /** 单条日志最大长度，防止输出被截断 */
+    maxOutputLength?: number;
+    /** 是否使用数据摘要模式（减少输出量） */
+    useSummaryMode?: boolean;
 }
 /**
  * Logger class for consistent logging across the library