@ecobridge.xyz/devicemanager 3.0.2

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

@@ -0,0 +1,45 @@
+import type { IPrinterCapabilities, IPrintOptions, IPrintJob } from '../interfaces/index.js';
+/**
+ * IPP protocol wrapper using the ipp npm package
+ */
+export declare class IppProtocol {
+    private printerUrl;
+    private printer;
+    constructor(address: string, port: number, path?: string);
+    /**
+     * Get printer attributes/capabilities
+     */
+    getAttributes(): Promise<IPrinterCapabilities>;
+    /**
+     * Print a document
+     */
+    print(data: Buffer, options?: IPrintOptions): Promise<IPrintJob>;
+    /**
+     * Get all jobs
+     */
+    getJobs(): Promise<IPrintJob[]>;
+    /**
+     * Get specific job info
+     */
+    getJobInfo(jobId: number): Promise<IPrintJob>;
+    /**
+     * Cancel a job
+     */
+    cancelJob(jobId: number): Promise<void>;
+    /**
+     * Check if printer is available
+     */
+    checkAvailability(): Promise<boolean>;
+    /**
+     * Build IPP print message from options
+     */
+    private buildPrintMessage;
+    /**
+     * Parse printer capabilities from attributes
+     */
+    private parseCapabilities;
+    /**
+     * Parse job info from attributes
+     */
+    private parseJobInfo;
+}

package/dist_ts/protocols/protocol.ipp.js

@@ -0,0 +1,284 @@
+import * as plugins from '../plugins.js';
+/**
+ * IPP protocol wrapper using the ipp npm package
+ */
+export class IppProtocol {
+    printerUrl;
+    printer;
+    constructor(address, port, path = '/ipp/print') {
+        this.printerUrl = `ipp://${address}:${port}${path}`;
+        this.printer = plugins.ipp.Printer(this.printerUrl);
+    }
+    /**
+     * Get printer attributes/capabilities
+     */
+    async getAttributes() {
+        return new Promise((resolve, reject) => {
+            this.printer.execute('Get-Printer-Attributes', null, (err, res) => {
+                if (err) {
+                    reject(err);
+                    return;
+                }
+                try {
+                    const attrs = res['printer-attributes-tag'] || {};
+                    resolve(this.parseCapabilities(attrs));
+                }
+                catch (parseErr) {
+                    reject(parseErr);
+                }
+            });
+        });
+    }
+    /**
+     * Print a document
+     */
+    async print(data, options) {
+        const msg = this.buildPrintMessage(options);
+        return new Promise((resolve, reject) => {
+            this.printer.execute('Print-Job', { ...msg, data }, (err, res) => {
+                if (err) {
+                    reject(err);
+                    return;
+                }
+                try {
+                    const jobAttrs = res['job-attributes-tag'] || {};
+                    resolve(this.parseJobInfo(jobAttrs));
+                }
+                catch (parseErr) {
+                    reject(parseErr);
+                }
+            });
+        });
+    }
+    /**
+     * Get all jobs
+     */
+    async getJobs() {
+        return new Promise((resolve, reject) => {
+            this.printer.execute('Get-Jobs', {
+                'operation-attributes-tag': {
+                    'requesting-user-name': 'devicemanager',
+                    'which-jobs': 'not-completed',
+                },
+            }, (err, res) => {
+                if (err) {
+                    reject(err);
+                    return;
+                }
+                try {
+                    const jobs = [];
+                    const jobTags = res['job-attributes-tag'];
+                    if (Array.isArray(jobTags)) {
+                        for (const jobAttrs of jobTags) {
+                            jobs.push(this.parseJobInfo(jobAttrs));
+                        }
+                    }
+                    else if (jobTags && typeof jobTags === 'object') {
+                        jobs.push(this.parseJobInfo(jobTags));
+                    }
+                    resolve(jobs);
+                }
+                catch (parseErr) {
+                    reject(parseErr);
+                }
+            });
+        });
+    }
+    /**
+     * Get specific job info
+     */
+    async getJobInfo(jobId) {
+        return new Promise((resolve, reject) => {
+            this.printer.execute('Get-Job-Attributes', {
+                'operation-attributes-tag': {
+                    'job-id': jobId,
+                },
+            }, (err, res) => {
+                if (err) {
+                    reject(err);
+                    return;
+                }
+                try {
+                    const jobAttrs = res['job-attributes-tag'] || {};
+                    resolve(this.parseJobInfo(jobAttrs));
+                }
+                catch (parseErr) {
+                    reject(parseErr);
+                }
+            });
+        });
+    }
+    /**
+     * Cancel a job
+     */
+    async cancelJob(jobId) {
+        return new Promise((resolve, reject) => {
+            this.printer.execute('Cancel-Job', {
+                'operation-attributes-tag': {
+                    'job-id': jobId,
+                },
+            }, (err, _res) => {
+                if (err) {
+                    reject(err);
+                    return;
+                }
+                resolve();
+            });
+        });
+    }
+    /**
+     * Check if printer is available
+     */
+    async checkAvailability() {
+        try {
+            await this.getAttributes();
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+    /**
+     * Build IPP print message from options
+     */
+    buildPrintMessage(options) {
+        const operationAttrs = {
+            'requesting-user-name': 'devicemanager',
+            'job-name': options?.jobName ?? 'Print Job',
+            'document-format': 'application/octet-stream',
+        };
+        const jobAttrs = {};
+        if (options?.copies && options.copies > 1) {
+            jobAttrs['copies'] = options.copies;
+        }
+        if (options?.mediaSize) {
+            jobAttrs['media'] = options.mediaSize;
+        }
+        if (options?.mediaType) {
+            jobAttrs['media-type'] = options.mediaType;
+        }
+        if (options?.sides) {
+            jobAttrs['sides'] = options.sides;
+        }
+        if (options?.quality) {
+            const qualityMap = {
+                draft: 3,
+                normal: 4,
+                high: 5,
+            };
+            jobAttrs['print-quality'] = qualityMap[options.quality] ?? 4;
+        }
+        if (options?.colorMode) {
+            jobAttrs['print-color-mode'] = options.colorMode;
+        }
+        const msg = {
+            'operation-attributes-tag': operationAttrs,
+        };
+        if (Object.keys(jobAttrs).length > 0) {
+            msg['job-attributes-tag'] = jobAttrs;
+        }
+        return msg;
+    }
+    /**
+     * Parse printer capabilities from attributes
+     */
+    parseCapabilities(attrs) {
+        const getArray = (key) => {
+            const value = attrs[key];
+            if (Array.isArray(value))
+                return value.map(String);
+            if (value !== undefined)
+                return [String(value)];
+            return [];
+        };
+        const getNumber = (key, defaultVal) => {
+            const value = attrs[key];
+            if (typeof value === 'number')
+                return value;
+            if (typeof value === 'string')
+                return parseInt(value) || defaultVal;
+            return defaultVal;
+        };
+        const getBool = (key, defaultVal) => {
+            const value = attrs[key];
+            if (typeof value === 'boolean')
+                return value;
+            if (value === 'true' || value === 1)
+                return true;
+            if (value === 'false' || value === 0)
+                return false;
+            return defaultVal;
+        };
+        // Parse resolutions
+        const resolutions = [];
+        const resSupported = attrs['printer-resolution-supported'];
+        if (Array.isArray(resSupported)) {
+            for (const res of resSupported) {
+                if (typeof res === 'object' && res !== null && 'x' in res) {
+                    resolutions.push(res.x);
+                }
+                else if (typeof res === 'number') {
+                    resolutions.push(res);
+                }
+            }
+        }
+        if (resolutions.length === 0) {
+            resolutions.push(300, 600);
+        }
+        return {
+            colorSupported: getBool('color-supported', false),
+            duplexSupported: getArray('sides-supported').some((s) => s.includes('two-sided')),
+            mediaSizes: getArray('media-supported'),
+            mediaTypes: getArray('media-type-supported'),
+            resolutions: [...new Set(resolutions)],
+            maxCopies: getNumber('copies-supported', 99),
+            sidesSupported: getArray('sides-supported'),
+            qualitySupported: getArray('print-quality-supported').map(String),
+        };
+    }
+    /**
+     * Parse job info from attributes
+     */
+    parseJobInfo(attrs) {
+        const getString = (key, defaultVal) => {
+            const value = attrs[key];
+            if (typeof value === 'string')
+                return value;
+            if (value !== undefined)
+                return String(value);
+            return defaultVal;
+        };
+        const getNumber = (key, defaultVal) => {
+            const value = attrs[key];
+            if (typeof value === 'number')
+                return value;
+            if (typeof value === 'string')
+                return parseInt(value) || defaultVal;
+            return defaultVal;
+        };
+        // Map IPP job state to our state
+        const ippState = getNumber('job-state', 3);
+        const stateMap = {
+            3: 'pending', // pending
+            4: 'pending', // pending-held
+            5: 'processing', // processing
+            6: 'processing', // processing-stopped
+            7: 'canceled', // canceled
+            8: 'aborted', // aborted
+            9: 'completed', // completed
+        };
+        const createdTime = attrs['time-at-creation'];
+        const completedTime = attrs['time-at-completed'];
+        return {
+            id: getNumber('job-id', 0),
+            name: getString('job-name', 'Unknown Job'),
+            state: stateMap[ippState] ?? 'pending',
+            stateReason: getString('job-state-reasons', undefined),
+            createdAt: createdTime ? new Date(createdTime * 1000) : new Date(),
+            completedAt: completedTime ? new Date(completedTime * 1000) : undefined,
+            pagesPrinted: getNumber('job-media-sheets-completed', undefined),
+            pagesTotal: getNumber('job-media-sheets', undefined),
+        };
+    }
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoicHJvdG9jb2wuaXBwLmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vdHMvcHJvdG9jb2xzL3Byb3RvY29sLmlwcC50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFBQSxPQUFPLEtBQUssT0FBTyxNQUFNLGVBQWUsQ0FBQztBQU96Qzs7R0FFRztBQUNILE1BQU0sT0FBTyxXQUFXO0lBQ2QsVUFBVSxDQUFTO0lBQ25CLE9BQU8sQ0FBeUM7SUFFeEQsWUFBWSxPQUFlLEVBQUUsSUFBWSxFQUFFLE9BQWUsWUFBWTtRQUNwRSxJQUFJLENBQUMsVUFBVSxHQUFHLFNBQVMsT0FBTyxJQUFJLElBQUksR0FBRyxJQUFJLEVBQUUsQ0FBQztRQUNwRCxJQUFJLENBQUMsT0FBTyxHQUFHLE9BQU8sQ0FBQyxHQUFHLENBQUMsT0FBTyxDQUFDLElBQUksQ0FBQyxVQUFVLENBQUMsQ0FBQztJQUN0RCxDQUFDO0lBRUQ7O09BRUc7SUFDSSxLQUFLLENBQUMsYUFBYTtRQUN4QixPQUFPLElBQUksT0FBTyxDQUFDLENBQUMsT0FBTyxFQUFFLE1BQU0sRUFBRSxFQUFFO1lBQ3JDLElBQUksQ0FBQyxPQUFPLENBQUMsT0FBTyxDQUNsQix3QkFBd0IsRUFDeEIsSUFBSSxFQUNKLENBQUMsR0FBaUIsRUFBRSxHQUE0QixFQUFFLEVBQUU7Z0JBQ2xELElBQUksR0FBRyxFQUFFLENBQUM7b0JBQ1IsTUFBTSxDQUFDLEdBQUcsQ0FBQyxDQUFDO29CQUNaLE9BQU87Z0JBQ1QsQ0FBQztnQkFFRCxJQUFJLENBQUM7b0JBQ0gsTUFBTSxLQUFLLEdBQUcsR0FBRyxDQUFDLHdCQUF3QixDQUE0QixJQUFJLEVBQUUsQ0FBQztvQkFDN0UsT0FBTyxDQUFDLElBQUksQ0FBQyxpQkFBaUIsQ0FBQyxLQUFLLENBQUMsQ0FBQyxDQUFDO2dCQUN6QyxDQUFDO2dCQUFDLE9BQU8sUUFBUSxFQUFFLENBQUM7b0JBQ2xCLE1BQU0sQ0FBQyxRQUFRLENBQUMsQ0FBQztnQkFDbkIsQ0FBQztZ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

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

@@ -0,0 +1,160 @@
+/**
+ * NUT Protocol variable definitions
+ */
+export declare const NUT_VARIABLES: {
+    deviceMfr: string;
+    deviceModel: string;
+    deviceSerial: string;
+    deviceType: string;
+    upsStatus: string;
+    upsAlarm: string;
+    upsTime: string;
+    upsLoad: string;
+    upsTemperature: string;
+    batteryCharge: string;
+    batteryRuntime: string;
+    batteryVoltage: string;
+    batteryVoltageNominal: string;
+    batteryType: string;
+    batteryDate: string;
+    batteryTemperature: string;
+    inputVoltage: string;
+    inputVoltageNominal: string;
+    inputFrequency: string;
+    inputFrequencyNominal: string;
+    inputTransferHigh: string;
+    inputTransferLow: string;
+    outputVoltage: string;
+    outputVoltageNominal: string;
+    outputFrequency: string;
+    outputCurrent: string;
+};
+/**
+ * NUT instant commands
+ */
+export declare const NUT_COMMANDS: {
+    testBatteryStart: string;
+    testBatteryStartQuick: string;
+    testBatteryStartDeep: string;
+    testBatteryStop: string;
+    calibrateStart: string;
+    calibrateStop: string;
+    shutdown: string;
+    shutdownStayOff: string;
+    shutdownStop: string;
+    shutdownReboot: string;
+    beeperEnable: string;
+    beeperDisable: string;
+    beeperMute: string;
+    beeperToggle: string;
+    loadOff: string;
+    loadOn: string;
+};
+/**
+ * UPS status flags from NUT
+ */
+export type TNutStatusFlag = 'OL' | 'OB' | 'LB' | 'HB' | 'RB' | 'CHRG' | 'DISCHRG' | 'BYPASS' | 'CAL' | 'OFF' | 'OVER' | 'TRIM' | 'BOOST' | 'FSD';
+/**
+ * NUT UPS information
+ */
+export interface INutUpsInfo {
+    name: string;
+    description: string;
+}
+/**
+ * NUT variable
+ */
+export interface INutVariable {
+    name: string;
+    value: string;
+}
+/**
+ * NUT Protocol handler for Network UPS Tools
+ * TCP-based text protocol on port 3493
+ */
+export declare class NutProtocol {
+    private socket;
+    private address;
+    private port;
+    private connected;
+    private responseBuffer;
+    private responseResolver;
+    private responseRejecter;
+    constructor(address: string, port?: number);
+    /**
+     * Connect to NUT server
+     */
+    connect(): Promise<void>;
+    /**
+     * Disconnect from NUT server
+     */
+    disconnect(): Promise<void>;
+    /**
+     * Check if connected
+     */
+    get isConnected(): boolean;
+    /**
+     * Handle incoming data
+     */
+    private handleData;
+    /**
+     * Send command and get response
+     */
+    private sendCommand;
+    /**
+     * List available UPS devices
+     */
+    listUps(): Promise<INutUpsInfo[]>;
+    /**
+     * Get all variables for a UPS
+     */
+    listVariables(upsName: string): Promise<INutVariable[]>;
+    /**
+     * Get a specific variable value
+     */
+    getVariable(upsName: string, varName: string): Promise<string | null>;
+    /**
+     * Get multiple variables at once
+     */
+    getVariables(upsName: string, varNames: string[]): Promise<Map<string, string>>;
+    /**
+     * Execute an instant command
+     */
+    runCommand(upsName: string, command: string): Promise<boolean>;
+    /**
+     * List available commands for a UPS
+     */
+    listCommands(upsName: string): Promise<string[]>;
+    /**
+     * Parse UPS status string into flags
+     */
+    parseStatus(statusString: string): TNutStatusFlag[];
+    /**
+     * Get comprehensive UPS status
+     */
+    getUpsStatus(upsName: string): Promise<{
+        status: TNutStatusFlag[];
+        batteryCharge: number;
+        batteryRuntime: number;
+        inputVoltage: number;
+        outputVoltage: number;
+        load: number;
+    }>;
+    /**
+     * Get device information
+     */
+    getDeviceInfo(upsName: string): Promise<{
+        manufacturer: string;
+        model: string;
+        serial: string;
+        type: string;
+    }>;
+    /**
+     * Ensure connected before command
+     */
+    private ensureConnected;
+    /**
+     * Check if a NUT server is reachable
+     */
+    static probe(address: string, port?: number, timeout?: number): Promise<boolean>;
+}