@ecobridge.xyz/devicemanager 3.0.2

package/dist_ts/protocols/protocol.upssnmp.js

@@ -0,0 +1,263 @@
+import { SnmpProtocol, SNMP_OIDS } from '../protocols/index.js';
+/**
+ * Extended UPS-MIB OIDs (RFC 1628)
+ */
+export const UPS_SNMP_OIDS = {
+    // Identity
+    upsIdentManufacturer: '1.3.6.1.2.1.33.1.1.1.0',
+    upsIdentModel: '1.3.6.1.2.1.33.1.1.2.0',
+    upsIdentUPSSoftwareVersion: '1.3.6.1.2.1.33.1.1.3.0',
+    upsIdentAgentSoftwareVersion: '1.3.6.1.2.1.33.1.1.4.0',
+    upsIdentName: '1.3.6.1.2.1.33.1.1.5.0',
+    upsIdentAttachedDevices: '1.3.6.1.2.1.33.1.1.6.0',
+    // Battery group
+    upsBatteryStatus: '1.3.6.1.2.1.33.1.2.1.0',
+    upsSecondsOnBattery: '1.3.6.1.2.1.33.1.2.2.0',
+    upsEstimatedMinutesRemaining: '1.3.6.1.2.1.33.1.2.3.0',
+    upsEstimatedChargeRemaining: '1.3.6.1.2.1.33.1.2.4.0',
+    upsBatteryVoltage: '1.3.6.1.2.1.33.1.2.5.0',
+    upsBatteryCurrent: '1.3.6.1.2.1.33.1.2.6.0',
+    upsBatteryTemperature: '1.3.6.1.2.1.33.1.2.7.0',
+    // Input group
+    upsInputLineBads: '1.3.6.1.2.1.33.1.3.1.0',
+    upsInputNumLines: '1.3.6.1.2.1.33.1.3.2.0',
+    upsInputLineIndex: '1.3.6.1.2.1.33.1.3.3.1.1',
+    upsInputFrequency: '1.3.6.1.2.1.33.1.3.3.1.2',
+    upsInputVoltage: '1.3.6.1.2.1.33.1.3.3.1.3',
+    upsInputCurrent: '1.3.6.1.2.1.33.1.3.3.1.4',
+    upsInputTruePower: '1.3.6.1.2.1.33.1.3.3.1.5',
+    // Output group
+    upsOutputSource: '1.3.6.1.2.1.33.1.4.1.0',
+    upsOutputFrequency: '1.3.6.1.2.1.33.1.4.2.0',
+    upsOutputNumLines: '1.3.6.1.2.1.33.1.4.3.0',
+    upsOutputLineIndex: '1.3.6.1.2.1.33.1.4.4.1.1',
+    upsOutputVoltage: '1.3.6.1.2.1.33.1.4.4.1.2',
+    upsOutputCurrent: '1.3.6.1.2.1.33.1.4.4.1.3',
+    upsOutputPower: '1.3.6.1.2.1.33.1.4.4.1.4',
+    upsOutputPercentLoad: '1.3.6.1.2.1.33.1.4.4.1.5',
+    // Bypass group
+    upsBypassFrequency: '1.3.6.1.2.1.33.1.5.1.0',
+    upsBypassNumLines: '1.3.6.1.2.1.33.1.5.2.0',
+    // Alarm group
+    upsAlarmsPresent: '1.3.6.1.2.1.33.1.6.1.0',
+    // Test group
+    upsTestId: '1.3.6.1.2.1.33.1.7.1.0',
+    upsTestSpinLock: '1.3.6.1.2.1.33.1.7.2.0',
+    upsTestResultsSummary: '1.3.6.1.2.1.33.1.7.3.0',
+    upsTestResultsDetail: '1.3.6.1.2.1.33.1.7.4.0',
+    upsTestStartTime: '1.3.6.1.2.1.33.1.7.5.0',
+    upsTestElapsedTime: '1.3.6.1.2.1.33.1.7.6.0',
+    // Control group
+    upsShutdownType: '1.3.6.1.2.1.33.1.8.1.0',
+    upsShutdownAfterDelay: '1.3.6.1.2.1.33.1.8.2.0',
+    upsStartupAfterDelay: '1.3.6.1.2.1.33.1.8.3.0',
+    upsRebootWithDuration: '1.3.6.1.2.1.33.1.8.4.0',
+    upsAutoRestart: '1.3.6.1.2.1.33.1.8.5.0',
+    // Config group
+    upsConfigInputVoltage: '1.3.6.1.2.1.33.1.9.1.0',
+    upsConfigInputFreq: '1.3.6.1.2.1.33.1.9.2.0',
+    upsConfigOutputVoltage: '1.3.6.1.2.1.33.1.9.3.0',
+    upsConfigOutputFreq: '1.3.6.1.2.1.33.1.9.4.0',
+    upsConfigOutputVA: '1.3.6.1.2.1.33.1.9.5.0',
+    upsConfigOutputPower: '1.3.6.1.2.1.33.1.9.6.0',
+    upsConfigLowBattTime: '1.3.6.1.2.1.33.1.9.7.0',
+    upsConfigAudibleStatus: '1.3.6.1.2.1.33.1.9.8.0',
+    upsConfigLowVoltageTransferPoint: '1.3.6.1.2.1.33.1.9.9.0',
+    upsConfigHighVoltageTransferPoint: '1.3.6.1.2.1.33.1.9.10.0',
+};
+/**
+ * UPS SNMP handler for querying UPS devices via SNMP
+ */
+export class UpsSnmpHandler {
+    protocol;
+    constructor(address, options) {
+        this.protocol = new SnmpProtocol(address, options);
+    }
+    /**
+     * Close SNMP session
+     */
+    close() {
+        this.protocol.close();
+    }
+    /**
+     * Get UPS identity information
+     */
+    async getIdentity() {
+        const varbinds = await this.protocol.getMultiple([
+            UPS_SNMP_OIDS.upsIdentManufacturer,
+            UPS_SNMP_OIDS.upsIdentModel,
+            UPS_SNMP_OIDS.upsIdentUPSSoftwareVersion,
+            UPS_SNMP_OIDS.upsIdentName,
+        ]);
+        const getValue = (oid) => {
+            const vb = varbinds.find((v) => v.oid === oid);
+            return String(vb?.value || '');
+        };
+        return {
+            manufacturer: getValue(UPS_SNMP_OIDS.upsIdentManufacturer),
+            model: getValue(UPS_SNMP_OIDS.upsIdentModel),
+            softwareVersion: getValue(UPS_SNMP_OIDS.upsIdentUPSSoftwareVersion),
+            name: getValue(UPS_SNMP_OIDS.upsIdentName),
+        };
+    }
+    /**
+     * Get battery status
+     */
+    async getBatteryStatus() {
+        const varbinds = await this.protocol.getMultiple([
+            UPS_SNMP_OIDS.upsBatteryStatus,
+            UPS_SNMP_OIDS.upsSecondsOnBattery,
+            UPS_SNMP_OIDS.upsEstimatedMinutesRemaining,
+            UPS_SNMP_OIDS.upsEstimatedChargeRemaining,
+            UPS_SNMP_OIDS.upsBatteryVoltage,
+            UPS_SNMP_OIDS.upsBatteryTemperature,
+        ]);
+        const getValue = (oid) => {
+            const vb = varbinds.find((v) => v.oid === oid);
+            return Number(vb?.value || 0);
+        };
+        const statusMap = {
+            1: 'unknown',
+            2: 'batteryNormal',
+            3: 'batteryLow',
+            4: 'batteryDepleted',
+        };
+        return {
+            status: statusMap[getValue(UPS_SNMP_OIDS.upsBatteryStatus)] || 'unknown',
+            secondsOnBattery: getValue(UPS_SNMP_OIDS.upsSecondsOnBattery),
+            estimatedMinutesRemaining: getValue(UPS_SNMP_OIDS.upsEstimatedMinutesRemaining),
+            estimatedChargeRemaining: getValue(UPS_SNMP_OIDS.upsEstimatedChargeRemaining),
+            voltage: getValue(UPS_SNMP_OIDS.upsBatteryVoltage) / 10, // Typically in 0.1V units
+            temperature: getValue(UPS_SNMP_OIDS.upsBatteryTemperature),
+        };
+    }
+    /**
+     * Get input status
+     */
+    async getInputStatus() {
+        const varbinds = await this.protocol.getMultiple([
+            UPS_SNMP_OIDS.upsInputFrequency + '.1', // Line 1
+            UPS_SNMP_OIDS.upsInputVoltage + '.1', // Line 1
+            UPS_SNMP_OIDS.upsInputLineBads,
+        ]);
+        const getValue = (oid) => {
+            const vb = varbinds.find((v) => v.oid === oid);
+            return Number(vb?.value || 0);
+        };
+        return {
+            frequency: getValue(UPS_SNMP_OIDS.upsInputFrequency + '.1') / 10, // 0.1 Hz units
+            voltage: getValue(UPS_SNMP_OIDS.upsInputVoltage + '.1'),
+            lineBads: getValue(UPS_SNMP_OIDS.upsInputLineBads),
+        };
+    }
+    /**
+     * Get output status
+     */
+    async getOutputStatus() {
+        const varbinds = await this.protocol.getMultiple([
+            UPS_SNMP_OIDS.upsOutputSource,
+            UPS_SNMP_OIDS.upsOutputFrequency,
+            UPS_SNMP_OIDS.upsOutputVoltage + '.1', // Line 1
+            UPS_SNMP_OIDS.upsOutputCurrent + '.1', // Line 1
+            UPS_SNMP_OIDS.upsOutputPower + '.1', // Line 1
+            UPS_SNMP_OIDS.upsOutputPercentLoad + '.1', // Line 1
+        ]);
+        const getValue = (oid) => {
+            const vb = varbinds.find((v) => v.oid === oid);
+            return Number(vb?.value || 0);
+        };
+        const sourceMap = {
+            1: 'other',
+            2: 'none',
+            3: 'normal',
+            4: 'bypass',
+            5: 'battery',
+            6: 'booster',
+            7: 'reducer',
+        };
+        return {
+            source: sourceMap[getValue(UPS_SNMP_OIDS.upsOutputSource)] || 'other',
+            frequency: getValue(UPS_SNMP_OIDS.upsOutputFrequency) / 10, // 0.1 Hz units
+            voltage: getValue(UPS_SNMP_OIDS.upsOutputVoltage + '.1'),
+            current: getValue(UPS_SNMP_OIDS.upsOutputCurrent + '.1') / 10, // 0.1 A units
+            power: getValue(UPS_SNMP_OIDS.upsOutputPower + '.1'),
+            percentLoad: getValue(UPS_SNMP_OIDS.upsOutputPercentLoad + '.1'),
+        };
+    }
+    /**
+     * Get full UPS status
+     */
+    async getFullStatus() {
+        const [battery, input, output] = await Promise.all([
+            this.getBatteryStatus(),
+            this.getInputStatus(),
+            this.getOutputStatus(),
+        ]);
+        // Get alarms separately
+        let alarmsPresent = 0;
+        try {
+            const alarmVb = await this.protocol.get(UPS_SNMP_OIDS.upsAlarmsPresent);
+            alarmsPresent = Number(alarmVb.value || 0);
+        }
+        catch {
+            // Ignore alarm fetch errors
+        }
+        return {
+            batteryStatus: battery.status,
+            secondsOnBattery: battery.secondsOnBattery,
+            estimatedMinutesRemaining: battery.estimatedMinutesRemaining,
+            estimatedChargeRemaining: battery.estimatedChargeRemaining,
+            batteryVoltage: battery.voltage,
+            batteryTemperature: battery.temperature,
+            outputSource: output.source,
+            outputFrequency: output.frequency,
+            outputVoltage: output.voltage,
+            outputCurrent: output.current,
+            outputPower: output.power,
+            outputPercentLoad: output.percentLoad,
+            inputFrequency: input.frequency,
+            inputVoltage: input.voltage,
+            alarmsPresent,
+        };
+    }
+    /**
+     * Check if UPS-MIB is supported on device
+     */
+    async isUpsDevice() {
+        try {
+            const vb = await this.protocol.get(UPS_SNMP_OIDS.upsBatteryStatus);
+            return vb.value !== null && vb.value !== undefined;
+        }
+        catch {
+            return false;
+        }
+    }
+    /**
+     * Get configuration info
+     */
+    async getConfiguration() {
+        const varbinds = await this.protocol.getMultiple([
+            UPS_SNMP_OIDS.upsConfigInputVoltage,
+            UPS_SNMP_OIDS.upsConfigInputFreq,
+            UPS_SNMP_OIDS.upsConfigOutputVoltage,
+            UPS_SNMP_OIDS.upsConfigOutputFreq,
+            UPS_SNMP_OIDS.upsConfigOutputVA,
+            UPS_SNMP_OIDS.upsConfigOutputPower,
+            UPS_SNMP_OIDS.upsConfigLowBattTime,
+        ]);
+        const getValue = (oid) => {
+            const vb = varbinds.find((v) => v.oid === oid);
+            return Number(vb?.value || 0);
+        };
+        return {
+            inputVoltage: getValue(UPS_SNMP_OIDS.upsConfigInputVoltage),
+            inputFrequency: getValue(UPS_SNMP_OIDS.upsConfigInputFreq) / 10,
+            outputVoltage: getValue(UPS_SNMP_OIDS.upsConfigOutputVoltage),
+            outputFrequency: getValue(UPS_SNMP_OIDS.upsConfigOutputFreq) / 10,
+            outputVA: getValue(UPS_SNMP_OIDS.upsConfigOutputVA),
+            outputPower: getValue(UPS_SNMP_OIDS.upsConfigOutputPower),
+            lowBatteryTime: getValue(UPS_SNMP_OIDS.upsConfigLowBattTime),
+        };
+    }
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoicHJvdG9jb2wudXBzc25tcC5qcyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uL3RzL3Byb3RvY29scy9wcm90b2NvbC51cHNzbm1wLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQUFBLE9BQU8sRUFBRSxZQUFZLEVBQUUsU0FBUyxFQUFxQixNQUFNLHVCQUF1QixDQUFDO0FBRW5GOztHQUVHO0FBQ0gsTUFBTSxDQUFDLE1BQU0sYUFBYSxHQUFHO0lBQzNCLFdBQVc7SUFDWCxvQkFBb0IsRUFBRSx3QkFBd0I7SUFDOUMsYUFBYSxFQUFFLHdCQUF3QjtJQUN2QywwQkFBMEIsRUFBRSx3QkFBd0I7SUFDcEQsNEJBQTRCLEVBQUUsd0JBQXdCO0lBQ3RELFlBQVksRUFBRSx3QkFBd0I7SUFDdEMsdUJBQXVCLEVBQUUsd0JBQXdCO0lBRWpELGdCQUFnQjtJQUNoQixnQkFBZ0IsRUFBRSx3QkFBd0I7SUFDMUMsbUJBQW1CLEVBQUUsd0JBQXdCO0lBQzdDLDRCQUE0QixFQUFFLHdCQUF3QjtJQUN0RCwyQkFBMkIsRUFBRSx3QkFBd0I7SUFDckQsaUJBQWlCLEVBQUUsd0JBQXdCO0lBQzNDLGlCQUFpQixFQUFFLHdCQUF3QjtJQUMzQyxxQkFBcUIsRUFBRSx3QkFBd0I7SUFFL0MsY0FBYztJQUNkLGdCQUFnQixFQUFFLHdCQUF3QjtJQUMxQyxnQkFBZ0IsRUFBRSx3QkFBd0I7SUFDMUMsaUJBQWlCLEVBQUUsMEJBQTBCO0lBQzdDLGlCQUFpQixFQUFFLDBCQUEwQjtJQUM3QyxlQUFlLEVBQUUsMEJBQTBCO0lBQzNDLGVBQWUsRUFBRSwwQkFBMEI7SUFDM0MsaUJBQWlCLEVBQUUsMEJBQTBCO0lBRTdDLGVBQWU7SUFDZixlQUFlLEVBQUUsd0JBQXdCO0lBQ3pDLGtCQUFrQixFQUFFLHdCQUF3QjtJQUM1QyxpQkFBaUIsRUFBRSx3QkFBd0I7SUFDM0Msa0JBQWtCLEVBQUUsMEJBQTBCO0lBQzlDLGdCQUFnQixFQUFFLDBCQUEwQjtJQUM1QyxnQkFBZ0Is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

package/npmextra.json

@@ -0,0 +1,24 @@
+{
+  "@git.zone/cli": {
+    "projectType": "npm",
+    "module": {
+      "githost": "code.foss.global",
+      "gitscope": "ecobridge.xyz",
+      "gitrepo": "devicemanager",
+      "description": "a device manager for talking to devices on network and over usb",
+      "npmPackagename": "@ecobridge.xyz/devicemanager",
+      "license": "MIT",
+      "projectDomain": "ecobridge.xyz"
+    },
+    "release": {
+      "accessLevel": "public",
+      "registries": [
+        "https://verdaccio.lossless.digital",
+        "https://registry.npmjs.org"
+      ]
+    }
+  },
+  "@ship.zone/szci": {
+    "npmGlobalTools": []
+  }
+}

package/package.json

@@ -0,0 +1,39 @@
+{
+  "name": "@ecobridge.xyz/devicemanager",
+  "version": "3.0.2",
+  "private": false,
+  "description": "a device manager for talking to devices on network and over usb",
+  "main": "dist_ts/index.js",
+  "typings": "dist_ts/index.d.ts",
+  "type": "module",
+  "author": "Task Venture Capital GmbH",
+  "license": "MIT",
+  "scripts": {
+    "test": "(tstest test/ --verbose)",
+    "build": "(tsbuild --web --allowimplicitany)",
+    "buildDocs": "(tsdoc)"
+  },
+  "devDependencies": {
+    "@git.zone/tsbuild": "^4.1.0",
+    "@git.zone/tsrun": "^2.0.0",
+    "@git.zone/tstest": "^3.1.3",
+    "@types/node": "^25.0.3",
+    "@types/ws": "^8.18.1"
+  },
+  "dependencies": {
+    "@push.rocks/smartdelay": "^3.0.5",
+    "@push.rocks/smartevent": "^2.0.5",
+    "@push.rocks/smartnetwork": "^4.4.0",
+    "@push.rocks/smartpath": "^6.0.0",
+    "@push.rocks/smartpromise": "^4.2.3",
+    "@push.rocks/smartrequest": "^5.0.1",
+    "@push.rocks/smartxml": "^2.0.0",
+    "bonjour-service": "^1.3.0",
+    "castv2-client": "^1.2.0",
+    "ipp": "^2.0.1",
+    "net-snmp": "^3.26.0",
+    "node-ssdp": "^4.0.1",
+    "sonos": "^1.14.2",
+    "ws": "^8.19.0"
+  }
+}

package/readme.hints.md

@@ -0,0 +1,115 @@
+# Device Manager - Implementation Notes
+
+## Architecture Overview
+
+The device manager uses a **UniversalDevice** architecture with composable features.
+
+### Key Concepts
+
+- **UniversalDevice**: A single device class that can have multiple features attached
+- **Features**: Composable capabilities (scan, print, playback, volume, power, snmp, smart home, etc.)
+- **Protocols**: Low-level protocol implementations (eSCL, SANE, IPP, SNMP, NUT, UPnP, Home Assistant)
+
+## Key Files
+
+### Core (`ts/`)
+- `devicemanager.classes.devicemanager.ts` - Main DeviceManager class with discovery and device registry
+- `device/device.classes.device.ts` - UniversalDevice class with feature management
+
+### Features (`ts/features/`)
+- `feature.abstract.ts` - Base Feature class with connection management and retry logic
+- `feature.scan.ts` - Scanning via eSCL/SANE protocols
+- `feature.print.ts` - Printing via IPP protocol
+- `feature.playback.ts` - Media playback (Sonos, AirPlay, Chromecast, DLNA)
+- `feature.volume.ts` - Volume control (separate from playback)
+- `feature.power.ts` - UPS/power monitoring via NUT/SNMP
+- `feature.snmp.ts` - SNMP queries
+- `feature.light.ts` - Smart light control
+- `feature.switch.ts` - Smart switch control
+- `feature.sensor.ts` - Smart sensors
+- `feature.climate.ts` - Climate/HVAC control
+- `feature.cover.ts` - Blinds, garage doors
+- `feature.lock.ts` - Smart locks
+- `feature.fan.ts` - Fan control
+- `feature.camera.ts` - Camera control
+
+### Protocols (`ts/protocols/`)
+- `protocol.escl.ts` - eSCL/AirScan scanner protocol
+- `protocol.sane.ts` - SANE network scanner protocol
+- `protocol.ipp.ts` - IPP printer protocol
+- `protocol.snmp.ts` - SNMP queries
+- `protocol.nut.ts` - Network UPS Tools protocol
+- `protocol.upnp.ts` - UPnP/SOAP client
+- `protocol.upssnmp.ts` - UPS-specific SNMP
+- `protocol.homeassistant.ts` - Home Assistant WebSocket API
+
+### Discovery (`ts/discovery/`)
+- `discovery.classes.mdns.ts` - mDNS discovery (Bonjour)
+- `discovery.classes.ssdp.ts` - SSDP/UPnP discovery
+- `discovery.classes.networkscanner.ts` - Active network scanning
+- `discovery.classes.homeassistant.ts` - Home Assistant instance discovery
+
+### Factories (`ts/factories/`)
+- `index.ts` - Device factory functions for creating pre-configured devices:
+  - `createScanner`, `createPrinter`, `createSpeaker`, `createDlnaRenderer`
+  - `createSnmpDevice`, `createUpsDevice`
+  - Smart home: `createSmartLight`, `createSmartSwitch`, `createSmartSensor`, etc.
+
+### Interfaces (`ts/interfaces/`)
+- `feature.interfaces.ts` - All feature-related types and interfaces
+- `smarthome.interfaces.ts` - Smart home specific interfaces
+- `homeassistant.interfaces.ts` - Home Assistant API types
+- `index.ts` - Re-exports all interfaces
+
+## Feature Types
+
+```typescript
+type TFeatureType =
+  | 'scan' | 'print' | 'fax' | 'copy'
+  | 'playback' | 'volume' | 'power' | 'snmp'
+  | 'dlna-render' | 'dlna-serve'
+  | 'light' | 'climate' | 'sensor' | 'camera'
+  | 'cover' | 'switch' | 'lock' | 'fan';
+```
+
+## DeviceManager API
+
+```typescript
+// Query by features
+dm.getDevices();                              // All devices
+dm.getDevices({ hasFeature: 'scan' });        // Devices with scan feature
+dm.getDevices({ name: 'Brother' });           // Devices matching name
+dm.getDevicesWithFeatures(['scan', 'print']); // Devices with ALL features
+dm.getDevicesWithAnyFeature(['playback', 'volume']); // Devices with ANY feature
+
+// Select (throws if not found)
+dm.selectDevice({ address: '192.168.1.100' });
+
+// Discovery
+dm.discoverScanners('192.168.1.0/24');
+dm.discoverPrinters('192.168.1.0/24');
+dm.scanNetwork({ ipRange: '...', probeEscl: true, ... });
+dm.startDiscovery();  // mDNS/SSDP
+dm.stopDiscovery();
+```
+
+## UniversalDevice API
+
+```typescript
+// Feature access
+device.hasFeature('scan');
+device.getFeature<ScanFeature>('scan');       // Returns undefined if not found
+device.selectFeature<ScanFeature>('scan');    // Throws if not found
+device.getFeatureTypes();                      // ['scan', 'print', ...]
+
+// Connection
+await device.connect();      // Connect all features
+await device.disconnect();   // Disconnect all features
+```
+
+## Testing Notes
+
+- Test files use `@git.zone/tstest` with tap-based assertions
+- Import `expect` from `@git.zone/tstest/tapbundle`
+- Tests are in `test/` directory
+- Run with `pnpm test` or `tstest test/test.some.ts --verbose`