@ecobridge.xyz/devicemanager 3.0.2

package/dist_ts/protocols/protocol.nut.js

@@ -0,0 +1,364 @@
+import * as plugins from '../plugins.js';
+/**
+ * NUT Protocol variable definitions
+ */
+export const NUT_VARIABLES = {
+    // Device info
+    deviceMfr: 'device.mfr',
+    deviceModel: 'device.model',
+    deviceSerial: 'device.serial',
+    deviceType: 'device.type',
+    // UPS status
+    upsStatus: 'ups.status',
+    upsAlarm: 'ups.alarm',
+    upsTime: 'ups.time',
+    upsLoad: 'ups.load',
+    upsTemperature: 'ups.temperature',
+    // Battery
+    batteryCharge: 'battery.charge',
+    batteryRuntime: 'battery.runtime',
+    batteryVoltage: 'battery.voltage',
+    batteryVoltageNominal: 'battery.voltage.nominal',
+    batteryType: 'battery.type',
+    batteryDate: 'battery.date',
+    batteryTemperature: 'battery.temperature',
+    // Input
+    inputVoltage: 'input.voltage',
+    inputVoltageNominal: 'input.voltage.nominal',
+    inputFrequency: 'input.frequency',
+    inputFrequencyNominal: 'input.frequency.nominal',
+    inputTransferHigh: 'input.transfer.high',
+    inputTransferLow: 'input.transfer.low',
+    // Output
+    outputVoltage: 'output.voltage',
+    outputVoltageNominal: 'output.voltage.nominal',
+    outputFrequency: 'output.frequency',
+    outputCurrent: 'output.current',
+};
+/**
+ * NUT instant commands
+ */
+export const NUT_COMMANDS = {
+    testBatteryStart: 'test.battery.start',
+    testBatteryStartQuick: 'test.battery.start.quick',
+    testBatteryStartDeep: 'test.battery.start.deep',
+    testBatteryStop: 'test.battery.stop',
+    calibrateStart: 'calibrate.start',
+    calibrateStop: 'calibrate.stop',
+    shutdown: 'shutdown.return',
+    shutdownStayOff: 'shutdown.stayoff',
+    shutdownStop: 'shutdown.stop',
+    shutdownReboot: 'shutdown.reboot',
+    beeperEnable: 'beeper.enable',
+    beeperDisable: 'beeper.disable',
+    beeperMute: 'beeper.mute',
+    beeperToggle: 'beeper.toggle',
+    loadOff: 'load.off',
+    loadOn: 'load.on',
+};
+/**
+ * NUT Protocol handler for Network UPS Tools
+ * TCP-based text protocol on port 3493
+ */
+export class NutProtocol {
+    socket = null;
+    address;
+    port;
+    connected = false;
+    responseBuffer = '';
+    responseResolver = null;
+    responseRejecter = null;
+    constructor(address, port = 3493) {
+        this.address = address;
+        this.port = port;
+    }
+    /**
+     * Connect to NUT server
+     */
+    async connect() {
+        if (this.connected) {
+            return;
+        }
+        return new Promise((resolve, reject) => {
+            this.socket = new plugins.net.Socket();
+            const timeout = setTimeout(() => {
+                if (this.socket) {
+                    this.socket.destroy();
+                    this.socket = null;
+                }
+                reject(new Error(`Connection timeout to ${this.address}:${this.port}`));
+            }, 5000);
+            this.socket.on('connect', () => {
+                clearTimeout(timeout);
+                this.connected = true;
+                resolve();
+            });
+            this.socket.on('error', (err) => {
+                clearTimeout(timeout);
+                this.connected = false;
+                if (this.responseRejecter) {
+                    this.responseRejecter(err);
+                    this.responseRejecter = null;
+                    this.responseResolver = null;
+                }
+                reject(err);
+            });
+            this.socket.on('data', (data) => {
+                this.handleData(data);
+            });
+            this.socket.on('close', () => {
+                this.connected = false;
+                if (this.responseRejecter) {
+                    this.responseRejecter(new Error('Connection closed'));
+                    this.responseRejecter = null;
+                    this.responseResolver = null;
+                }
+            });
+            this.socket.connect(this.port, this.address);
+        });
+    }
+    /**
+     * Disconnect from NUT server
+     */
+    async disconnect() {
+        if (!this.connected || !this.socket) {
+            return;
+        }
+        try {
+            await this.sendCommand('LOGOUT');
+        }
+        catch {
+            // Ignore logout errors
+        }
+        this.socket.destroy();
+        this.socket = null;
+        this.connected = false;
+    }
+    /**
+     * Check if connected
+     */
+    get isConnected() {
+        return this.connected;
+    }
+    /**
+     * Handle incoming data
+     */
+    handleData(data) {
+        this.responseBuffer += data.toString();
+        // Check for complete response (ends with newline)
+        const lines = this.responseBuffer.split('\n');
+        // Check if we have a complete response
+        if (this.responseBuffer.endsWith('\n')) {
+            const responseLines = lines.filter((l) => l.trim().length > 0);
+            this.responseBuffer = '';
+            if (this.responseResolver) {
+                this.responseResolver(responseLines);
+                this.responseResolver = null;
+                this.responseRejecter = null;
+            }
+        }
+    }
+    /**
+     * Send command and get response
+     */
+    async sendCommand(command) {
+        if (!this.socket || !this.connected) {
+            throw new Error('Not connected to NUT server');
+        }
+        return new Promise((resolve, reject) => {
+            this.responseResolver = resolve;
+            this.responseRejecter = reject;
+            const timeout = setTimeout(() => {
+                this.responseResolver = null;
+                this.responseRejecter = null;
+                reject(new Error(`Command timeout: ${command}`));
+            }, 10000);
+            this.responseResolver = (lines) => {
+                clearTimeout(timeout);
+                resolve(lines);
+            };
+            this.responseRejecter = (err) => {
+                clearTimeout(timeout);
+                reject(err);
+            };
+            this.socket.write(`${command}\n`);
+        });
+    }
+    /**
+     * List available UPS devices
+     */
+    async listUps() {
+        await this.ensureConnected();
+        const response = await this.sendCommand('LIST UPS');
+        const upsList = [];
+        for (const line of response) {
+            // Format: UPS <name> "<description>"
+            const match = line.match(/^UPS\s+(\S+)\s+"([^"]*)"/);
+            if (match) {
+                upsList.push({
+                    name: match[1],
+                    description: match[2],
+                });
+            }
+        }
+        return upsList;
+    }
+    /**
+     * Get all variables for a UPS
+     */
+    async listVariables(upsName) {
+        await this.ensureConnected();
+        const response = await this.sendCommand(`LIST VAR ${upsName}`);
+        const variables = [];
+        for (const line of response) {
+            // Format: VAR <ups> <name> "<value>"
+            const match = line.match(/^VAR\s+\S+\s+(\S+)\s+"([^"]*)"/);
+            if (match) {
+                variables.push({
+                    name: match[1],
+                    value: match[2],
+                });
+            }
+        }
+        return variables;
+    }
+    /**
+     * Get a specific variable value
+     */
+    async getVariable(upsName, varName) {
+        await this.ensureConnected();
+        const response = await this.sendCommand(`GET VAR ${upsName} ${varName}`);
+        for (const line of response) {
+            // Format: VAR <ups> <name> "<value>"
+            const match = line.match(/^VAR\s+\S+\s+\S+\s+"([^"]*)"/);
+            if (match) {
+                return match[1];
+            }
+            // Handle error responses
+            if (line.startsWith('ERR')) {
+                return null;
+            }
+        }
+        return null;
+    }
+    /**
+     * Get multiple variables at once
+     */
+    async getVariables(upsName, varNames) {
+        const results = new Map();
+        for (const varName of varNames) {
+            const value = await this.getVariable(upsName, varName);
+            if (value !== null) {
+                results.set(varName, value);
+            }
+        }
+        return results;
+    }
+    /**
+     * Execute an instant command
+     */
+    async runCommand(upsName, command) {
+        await this.ensureConnected();
+        const response = await this.sendCommand(`INSTCMD ${upsName} ${command}`);
+        for (const line of response) {
+            if (line === 'OK') {
+                return true;
+            }
+            if (line.startsWith('ERR')) {
+                return false;
+            }
+        }
+        return false;
+    }
+    /**
+     * List available commands for a UPS
+     */
+    async listCommands(upsName) {
+        await this.ensureConnected();
+        const response = await this.sendCommand(`LIST CMD ${upsName}`);
+        const commands = [];
+        for (const line of response) {
+            // Format: CMD <ups> <command>
+            const match = line.match(/^CMD\s+\S+\s+(\S+)/);
+            if (match) {
+                commands.push(match[1]);
+            }
+        }
+        return commands;
+    }
+    /**
+     * Parse UPS status string into flags
+     */
+    parseStatus(statusString) {
+        return statusString.split(/\s+/).filter((s) => s.length > 0);
+    }
+    /**
+     * Get comprehensive UPS status
+     */
+    async getUpsStatus(upsName) {
+        const vars = await this.getVariables(upsName, [
+            NUT_VARIABLES.upsStatus,
+            NUT_VARIABLES.batteryCharge,
+            NUT_VARIABLES.batteryRuntime,
+            NUT_VARIABLES.inputVoltage,
+            NUT_VARIABLES.outputVoltage,
+            NUT_VARIABLES.upsLoad,
+        ]);
+        return {
+            status: this.parseStatus(vars.get(NUT_VARIABLES.upsStatus) || ''),
+            batteryCharge: parseFloat(vars.get(NUT_VARIABLES.batteryCharge) || '0'),
+            batteryRuntime: parseFloat(vars.get(NUT_VARIABLES.batteryRuntime) || '0'),
+            inputVoltage: parseFloat(vars.get(NUT_VARIABLES.inputVoltage) || '0'),
+            outputVoltage: parseFloat(vars.get(NUT_VARIABLES.outputVoltage) || '0'),
+            load: parseFloat(vars.get(NUT_VARIABLES.upsLoad) || '0'),
+        };
+    }
+    /**
+     * Get device information
+     */
+    async getDeviceInfo(upsName) {
+        const vars = await this.getVariables(upsName, [
+            NUT_VARIABLES.deviceMfr,
+            NUT_VARIABLES.deviceModel,
+            NUT_VARIABLES.deviceSerial,
+            NUT_VARIABLES.deviceType,
+        ]);
+        return {
+            manufacturer: vars.get(NUT_VARIABLES.deviceMfr) || '',
+            model: vars.get(NUT_VARIABLES.deviceModel) || '',
+            serial: vars.get(NUT_VARIABLES.deviceSerial) || '',
+            type: vars.get(NUT_VARIABLES.deviceType) || '',
+        };
+    }
+    /**
+     * Ensure connected before command
+     */
+    async ensureConnected() {
+        if (!this.connected) {
+            await this.connect();
+        }
+    }
+    /**
+     * Check if a NUT server is reachable
+     */
+    static async probe(address, port = 3493, timeout = 3000) {
+        return new Promise((resolve) => {
+            const socket = new plugins.net.Socket();
+            const timer = setTimeout(() => {
+                socket.destroy();
+                resolve(false);
+            }, timeout);
+            socket.on('connect', () => {
+                clearTimeout(timer);
+                socket.destroy();
+                resolve(true);
+            });
+            socket.on('error', () => {
+                clearTimeout(timer);
+                resolve(false);
+            });
+            socket.connect(port, address);
+        });
+    }
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoicHJvdG9jb2wubnV0LmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vdHMvcHJvdG9jb2xzL3Byb3RvY29sLm51dC50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFBQSxPQUFPLEtBQUssT0FBTyxNQUFNLGVBQWUsQ0FBQztBQUV6Qzs7R0FFRztBQUNILE1BQU0sQ0FBQyxNQUFNLGFBQWEsR0FBRztJQUMzQixjQUFjO0lBQ2QsU0FBUyxFQUFFLFlBQVk7SUFDdkIsV0FBVyxFQUFFLGNBQWM7SUFDM0IsWUFBWSxFQUFFLGVBQWU7SUFDN0IsVUFBVSxFQUFFLGFBQWE7SUFFekIsYUFBYTtJQUNiLFNBQVMsRUFBRSxZQUFZO0lBQ3ZCLFFBQVEsRUFBRSxXQUFXO0lBQ3JCLE9BQU8sRUFBRSxVQUFVO0lBQ25CLE9BQU8sRUFBRSxVQUFVO0lBQ25CLGNBQWMsRUFBRSxpQkFBaUI7SUFFakMsVUFBVTtJQUNWLGFBQWEsRUFBRSxnQkFBZ0I7SUFDL0IsY0FBYyxFQUFFLGlCQUFpQjtJQUNqQyxjQUFjLEVBQUUsaUJBQWlCO0lBQ2pDLHFCQUFxQixFQUFFLHlCQUF5QjtJQUNoRCxXQUFXLEVBQUUsY0FBYztJQUMzQixXQUFXLEVBQUUsY0FBYztJQUMzQixrQkFBa0IsRUFBRSxxQkFBcUI7SUFFekMsUUFBUTtJQUNSLFlBQVksRUFBRSxlQUFlO0lBQzdCLG1CQUFtQixFQUFFLHVCQUF1QjtJQUM1QyxjQUFjLEVBQUUsaUJBQWlCO0lBQ2pDLHFCQUFxQixFQUFFLHlCQUF5QjtJQUNoRCxpQkFBaUIsRUFBRSxxQkFBcUI7SUFDeEMsZ0JBQWdCLEVBQUUsb0JBQW9CO0lBRXRDLFNBQVM7SUFDVCxhQUFhLEVBQUUsZ0JBQWdCO0lBQy9CLG9CQUFvQixFQUFFLHdCQUF3QjtJQUM5QyxlQUFlLEVBQUUsa0JBQWtCO0lBQ25DLGFBQWEsRUFBRSxnQkFBZ0I7Q0FDaEMsQ0FBQztBQUVGOztHQUVHO0FBQ0gsTUFBTSxDQUFDLE1BQU0sWUFBWSxHQUFHO0lBQzFC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

package/dist_ts/protocols/protocol.sane.d.ts

@@ -0,0 +1,104 @@
+import type { ISaneDevice, ISaneParameters, IScanOptions, IScanResult } from '../interfaces/index.js';
+/**
+ * SANE network protocol client
+ */
+export declare class SaneProtocol {
+    private socket;
+    private address;
+    private port;
+    private handle;
+    private options;
+    private readBuffer;
+    constructor(address: string, port?: number);
+    /**
+     * Connect to SANE daemon
+     */
+    connect(): Promise<void>;
+    /**
+     * Disconnect from SANE daemon
+     */
+    disconnect(): Promise<void>;
+    /**
+     * Initialize connection (SANE_NET_INIT)
+     */
+    private init;
+    /**
+     * Get available devices (SANE_NET_GET_DEVICES)
+     */
+    getDevices(): Promise<ISaneDevice[]>;
+    /**
+     * Open a device (SANE_NET_OPEN)
+     */
+    open(deviceName: string): Promise<void>;
+    /**
+     * Close the current device (SANE_NET_CLOSE)
+     */
+    close(): Promise<void>;
+    /**
+     * Exit connection (SANE_NET_EXIT)
+     */
+    private exit;
+    /**
+     * Get option descriptors (SANE_NET_GET_OPTION_DESCRIPTORS)
+     */
+    private getOptionDescriptors;
+    /**
+     * Set an option value
+     */
+    setOption(name: string, value: unknown): Promise<void>;
+    /**
+     * Get scan parameters (SANE_NET_GET_PARAMETERS)
+     */
+    getParameters(): Promise<ISaneParameters>;
+    /**
+     * Start scanning (SANE_NET_START)
+     */
+    start(): Promise<{
+        port: number;
+        byteOrder: 'little' | 'big';
+    }>;
+    /**
+     * Cancel scanning (SANE_NET_CANCEL)
+     */
+    cancel(): Promise<void>;
+    /**
+     * Perform a complete scan
+     */
+    scan(options: IScanOptions): Promise<IScanResult>;
+    /**
+     * Configure scan options based on IScanOptions
+     */
+    private configureOptions;
+    /**
+     * Read image data from data port
+     */
+    private readImageData;
+    /**
+     * Map color mode to SANE mode string
+     */
+    private mapColorMode;
+    /**
+     * Map SANE format code to string
+     */
+    private mapFormat;
+    /**
+     * Map value type code to string
+     */
+    private mapValueType;
+    /**
+     * Map unit code to string
+     */
+    private mapUnit;
+    /**
+     * Map constraint type code to string
+     */
+    private mapConstraintType;
+    private buildRequest;
+    private writeWord;
+    private writeString;
+    private sendRequest;
+    private readResponse;
+    private waitForData;
+    private readWord;
+    private readString;
+}