@hardwarebridge/client 1.0.0

package/dist/index.d.ts

@@ -0,0 +1,349 @@
+interface DeviceInfo {
+    id: string;
+    name: string;
+    type: 'printer' | 'serial' | 'usbhid';
+    status: 'available' | 'connected' | 'error';
+    manufacturer: string;
+    model: string;
+    serialNumber: string;
+    properties: Record<string, any>;
+    lastSeen: Date;
+    isConnected: boolean;
+    connectionId?: string;
+}
+interface PrinterDevice extends DeviceInfo {
+    supportedProtocols: string[];
+    maxPrintWidth: number;
+    supportsColor: boolean;
+    supportsDuplex: boolean;
+    maxResolution: number;
+    currentStatus: string;
+    jobsInQueue: number;
+}
+interface SerialPortDevice extends DeviceInfo {
+    portName: string;
+    baudRate: number;
+    parity: string;
+    dataBits: number;
+    stopBits: string;
+    flowControl: string;
+    isOpen: boolean;
+    bytesToRead: number;
+    bytesToWrite: number;
+}
+interface UsbHidDevice extends DeviceInfo {
+    vendorId: number;
+    productId: number;
+    version: number;
+    devicePath: string;
+    inputReportLength: number;
+    outputReportLength: number;
+    featureReportLength: number;
+    isOpen: boolean;
+}
+interface ConnectionConfig {
+    url: string;
+    protocols?: string[];
+    reconnectInterval?: number;
+    maxReconnectAttempts?: number;
+    timeout?: number;
+}
+interface JsonRpcRequest {
+    jsonrpc: '2.0';
+    method: string;
+    params?: any;
+    id?: string | number | null;
+}
+interface JsonRpcResponse {
+    jsonrpc: '2.0';
+    result?: any;
+    error?: JsonRpcError;
+    id?: string | number | null;
+}
+interface JsonRpcError {
+    code: number;
+    message: string;
+    data?: any;
+}
+interface PrintJob {
+    id: string;
+    deviceId: string;
+    data: string;
+    format: 'raw' | 'escpos' | 'zpl' | 'epl';
+    status: 'pending' | 'processing' | 'completed' | 'failed';
+    createdAt: Date;
+    startedAt?: Date;
+    completedAt?: Date;
+    error?: string;
+    retryCount: number;
+    options?: Record<string, any>;
+}
+interface PrintResult {
+    success: boolean;
+    jobId?: string;
+    bytesPrinted?: number;
+    error?: string;
+    timestamp: Date;
+}
+interface SerialPortConfig {
+    baudRate: number;
+    parity: 'None' | 'Odd' | 'Even' | 'Mark' | 'Space';
+    dataBits: 7 | 8;
+    stopBits: '1' | '1.5' | '2';
+    flowControl: 'None' | 'XOnXOff' | 'RequestToSend' | 'RequestToSendXOnXOff';
+}
+interface SerialData {
+    deviceId: string;
+    data: string;
+    timestamp: Date;
+    direction: 'send' | 'receive';
+    bytesTransferred: number;
+}
+interface UsbHidReport {
+    deviceId: string;
+    reportId: number;
+    data: string;
+    timestamp: Date;
+    reportType: 'input' | 'output' | 'feature';
+}
+interface QueueJob {
+    id: string;
+    deviceId: string;
+    deviceType: string;
+    operation: string;
+    status: 'pending' | 'processing' | 'completed' | 'failed' | 'cancelled';
+    createdAt: Date;
+    startedAt?: Date;
+    completedAt?: Date;
+    error?: string;
+    retryCount: number;
+    parameters?: Record<string, any>;
+}
+interface QueueStatus {
+    totalJobs: number;
+    pendingJobs: number;
+    processingJobs: number;
+    completedJobs: number;
+    failedJobs: number;
+    lastProcessed: Date;
+    averageProcessingTime: number;
+}
+interface SystemHealth {
+    status: 'healthy' | 'warning' | 'error' | 'no_devices';
+    timestamp: Date;
+    totalDevices: number;
+    connectedDevices: number;
+    activeConnections: number;
+    jobsInQueue: number;
+    cpuUsage: number;
+    memoryUsage: number;
+    deviceHealth: Record<string, any>;
+}
+interface ConnectionState {
+    connected: boolean;
+    connecting: boolean;
+    error?: string;
+    reconnectAttempts: number;
+    lastConnectionTime?: Date;
+}
+interface DeviceEvent {
+    eventType: 'connected' | 'disconnected' | 'discovered' | 'removed' | 'status_changed' | 'error' | 'data';
+    deviceId: string;
+    deviceType: string;
+    timestamp: Date;
+    data?: Record<string, any>;
+}
+interface ClientOptions {
+    autoReconnect?: boolean;
+    reconnectInterval?: number;
+    maxReconnectAttempts?: number;
+    timeout?: number;
+    debug?: boolean;
+    protocols?: string[];
+    headers?: Record<string, string>;
+}
+type DeviceType = 'printer' | 'serial' | 'usbhid';
+type PrintFormat = 'raw' | 'escpos' | 'zpl' | 'epl';
+type JobStatus = 'pending' | 'processing' | 'completed' | 'failed' | 'cancelled';
+type ConnectionStatus = 'connecting' | 'connected' | 'disconnected' | 'error' | 'reconnecting';
+
+declare class HardwareBridgeClient {
+    private wsClient;
+    private options;
+    constructor(config: ConnectionConfig, options?: ClientOptions);
+    private setupEventHandlers;
+    connect(): Promise<void>;
+    disconnect(): void;
+    get isConnected(): boolean;
+    get isConnecting(): boolean;
+    getConnectionStatus(): string;
+    onConnectionStateChange(listener: (connected: boolean) => void): void;
+    enumerateDevices(): Promise<DeviceInfo[]>;
+    getDevice(deviceId: string): Promise<DeviceInfo>;
+    watchDevices(): Promise<void>;
+    unwatchDevices(): Promise<void>;
+    print(deviceId: string, data: string, format?: PrintFormat): Promise<PrintResult>;
+    getPrinterStatus(deviceId: string): Promise<{
+        isConnected: boolean;
+        status: string;
+        isReady: boolean;
+        isBusy: boolean;
+        isPaused: boolean;
+        jobsInQueue: number;
+        error?: string;
+        timestamp: Date;
+    }>;
+    getPrinterCapabilities(deviceId: string): Promise<{
+        supportedProtocols: string[];
+        maxPrintWidth: number;
+        supportsColor: boolean;
+        supportsDuplex: boolean;
+        maxResolution: number;
+        maxJobSize: number;
+        error?: string;
+    }>;
+    openSerialPort(deviceId: string, config: SerialPortConfig): Promise<{
+        success: boolean;
+        portName?: string;
+        config?: SerialPortConfig;
+        openedAt?: Date;
+        error?: string;
+    }>;
+    closeSerialPort(deviceId: string): Promise<{
+        success: boolean;
+        portName?: string;
+        closedAt?: Date;
+        error?: string;
+    }>;
+    sendSerialData(deviceId: string, data: string): Promise<{
+        success: boolean;
+        bytesTransferred: number;
+        data: string;
+        error?: string;
+        timestamp: Date;
+    }>;
+    receiveSerialData(deviceId: string, maxBytes?: number, timeout?: number): Promise<{
+        success: boolean;
+        bytesTransferred: number;
+        data: string;
+        error?: string;
+        timestamp: Date;
+    }>;
+    getSerialPortStatus(deviceId: string): Promise<{
+        isConnected: boolean;
+        status: string;
+        portName?: string;
+        baudRate?: number;
+        parity?: string;
+        dataBits?: number;
+        stopBits?: string;
+        flowControl?: string;
+        bytesToRead?: number;
+        bytesToWrite?: number;
+        isOpen?: boolean;
+        cdHolding?: boolean;
+        ctsHolding?: boolean;
+        dsrHolding?: boolean;
+        connectedAt?: Date;
+        lastActivity?: Date;
+        error?: string;
+    }>;
+    openUsbDevice(deviceId: string): Promise<{
+        success: boolean;
+        deviceId: string;
+        vendorId?: number;
+        productId?: number;
+        openedAt?: Date;
+        error?: string;
+    }>;
+    closeUsbDevice(deviceId: string): Promise<{
+        success: boolean;
+        deviceId: string;
+        closedAt?: Date;
+        error?: string;
+    }>;
+    sendUsbReport(deviceId: string, reportId: number, data: string): Promise<{
+        success: boolean;
+        reportId: number;
+        bytesTransferred: number;
+        data: string;
+        error?: string;
+        timestamp: Date;
+    }>;
+    receiveUsbReport(deviceId: string, reportId: number, timeout?: number): Promise<{
+        success: boolean;
+        reportId: number;
+        bytesTransferred: number;
+        data: string;
+        error?: string;
+        timestamp: Date;
+    }>;
+    getUsbDeviceStatus(deviceId: string): Promise<{
+        isConnected: boolean;
+        status: string;
+        deviceId: string;
+        vendorId?: number;
+        productId?: number;
+        version?: number;
+        isOpen?: boolean;
+        inputReportLength?: number;
+        outputReportLength?: number;
+        featureReportLength?: number;
+        connectedAt?: Date;
+        lastActivity?: Date;
+        error?: string;
+    }>;
+    getQueueStatus(): Promise<QueueStatus>;
+    getQueueJobs(deviceId?: string, status?: string, limit?: number): Promise<QueueJob[]>;
+    cancelQueueJob(jobId: string): Promise<boolean>;
+    getSystemInfo(): Promise<{
+        version: string;
+        platform: string;
+        timestamp: Date;
+        uptime: number;
+    }>;
+    getSystemHealth(): Promise<SystemHealth>;
+    onDeviceEvent(event: DeviceEvent): void;
+    waitForConnection(timeout?: number): Promise<void>;
+    dispose(): void;
+}
+
+declare class WebSocketClient {
+    private ws;
+    private config;
+    private options;
+    private connectionState;
+    private connectionListeners;
+    private messageListeners;
+    private deviceEventListeners;
+    private reconnectTimer;
+    private pingTimer;
+    private messageId;
+    private pendingRequests;
+    constructor(config: ConnectionConfig, options?: ClientOptions);
+    onConnectionStateChange(listener: (state: ConnectionState) => void): void;
+    onMessage(listener: (message: JsonRpcResponse) => void): void;
+    onDeviceEvent(listener: (event: DeviceEvent) => void): void;
+    get isConnected(): boolean;
+    get isConnecting(): boolean;
+    getConnectionStatus(): ConnectionStatus;
+    connect(): Promise<void>;
+    disconnect(): void;
+    sendRequest<T = any>(method: string, params?: any): Promise<T>;
+    sendNotification(method: string, params?: any): void;
+    private createWebSocket;
+    private handleMessage;
+    private handleDisconnect;
+    private scheduleReconnect;
+    private startPingTimer;
+    private cleanup;
+    private sendMessage;
+    private updateConnectionState;
+    private log;
+    dispose(): void;
+}
+
+declare const VERSION = "1.0.0";
+
+export { HardwareBridgeClient, VERSION, WebSocketClient };
+export type { ClientOptions, ConnectionConfig, ConnectionState, ConnectionStatus, ConnectionStatus as ConnectionStatusType, DeviceEvent, DeviceInfo, DeviceType, JobStatus, JsonRpcError, JsonRpcRequest, JsonRpcResponse, PrintFormat, PrintJob, PrintResult, PrinterDevice, QueueJob, QueueStatus, SerialData, SerialPortConfig, SerialPortDevice, SystemHealth, UsbHidDevice, UsbHidReport };