@ecobridge.xyz/devicemanager 3.0.2

package/dist_ts/features/feature.sensor.d.ts

@@ -0,0 +1,95 @@
+/**
+ * Sensor Feature
+ * Provides read-only state for sensors (temperature, humidity, power, etc.)
+ */
+import { Feature, type TDeviceReference } from './feature.abstract.js';
+import type { IFeatureOptions } from '../interfaces/feature.interfaces.js';
+import type { TSensorProtocol, TSensorDeviceClass, TSensorStateClass, ISensorCapabilities, ISensorState, ISensorFeatureInfo, ISensorProtocolClient } from '../interfaces/smarthome.interfaces.js';
+/**
+ * Options for creating a SensorFeature
+ */
+export interface ISensorFeatureOptions extends IFeatureOptions {
+    /** Protocol type */
+    protocol: TSensorProtocol;
+    /** Entity ID (for Home Assistant) */
+    entityId: string;
+    /** Protocol client for reading sensor state */
+    protocolClient: ISensorProtocolClient;
+    /** Device class (temperature, humidity, etc.) */
+    deviceClass?: TSensorDeviceClass;
+    /** State class (measurement, total, etc.) */
+    stateClass?: TSensorStateClass;
+    /** Unit of measurement */
+    unit?: string;
+    /** Precision (decimal places) */
+    precision?: number;
+}
+/**
+ * Sensor Feature - read-only state values
+ *
+ * Protocol-agnostic: works with Home Assistant, MQTT, SNMP, etc.
+ *
+ * @example
+ * ```typescript
+ * const sensor = device.getFeature<SensorFeature>('sensor');
+ * if (sensor) {
+ *   await sensor.refreshState();
+ *   console.log(`Temperature: ${sensor.value} ${sensor.unit}`);
+ * }
+ * ```
+ */
+export declare class SensorFeature extends Feature {
+    readonly type: "sensor";
+    readonly protocol: TSensorProtocol;
+    /** Entity ID (e.g., "sensor.living_room_temperature") */
+    readonly entityId: string;
+    /** Capabilities */
+    readonly capabilities: ISensorCapabilities;
+    /** Current state */
+    protected _value: string | number | boolean;
+    protected _numericValue?: number;
+    protected _unit?: string;
+    protected _lastUpdated: Date;
+    /** Protocol client for reading sensor state */
+    private protocolClient;
+    constructor(device: TDeviceReference, port: number, options: ISensorFeatureOptions);
+    /**
+     * Get current value (cached)
+     */
+    get value(): string | number | boolean;
+    /**
+     * Get numeric value if available (cached)
+     */
+    get numericValue(): number | undefined;
+    /**
+     * Get unit of measurement
+     */
+    get unit(): string | undefined;
+    /**
+     * Get device class
+     */
+    get deviceClass(): TSensorDeviceClass | undefined;
+    /**
+     * Get state class
+     */
+    get stateClass(): TSensorStateClass | undefined;
+    /**
+     * Get last updated timestamp
+     */
+    get lastUpdated(): Date;
+    protected doConnect(): Promise<void>;
+    protected doDisconnect(): Promise<void>;
+    /**
+     * Refresh state from the device
+     */
+    refreshState(): Promise<ISensorState>;
+    /**
+     * Update state from external source (e.g., state change event)
+     */
+    updateState(state: ISensorState): void;
+    /**
+     * Internal state update
+     */
+    private updateStateInternal;
+    getFeatureInfo(): ISensorFeatureInfo;
+}

package/dist_ts/features/feature.sensor.js

@@ -0,0 +1,147 @@
+/**
+ * Sensor Feature
+ * Provides read-only state for sensors (temperature, humidity, power, etc.)
+ */
+import { Feature } from './feature.abstract.js';
+/**
+ * Sensor Feature - read-only state values
+ *
+ * Protocol-agnostic: works with Home Assistant, MQTT, SNMP, etc.
+ *
+ * @example
+ * ```typescript
+ * const sensor = device.getFeature<SensorFeature>('sensor');
+ * if (sensor) {
+ *   await sensor.refreshState();
+ *   console.log(`Temperature: ${sensor.value} ${sensor.unit}`);
+ * }
+ * ```
+ */
+export class SensorFeature extends Feature {
+    type = 'sensor';
+    protocol;
+    /** Entity ID (e.g., "sensor.living_room_temperature") */
+    entityId;
+    /** Capabilities */
+    capabilities;
+    /** Current state */
+    _value = '';
+    _numericValue;
+    _unit;
+    _lastUpdated = new Date();
+    /** Protocol client for reading sensor state */
+    protocolClient;
+    constructor(device, port, options) {
+        super(device, port, options);
+        this.protocol = options.protocol;
+        this.entityId = options.entityId;
+        this.protocolClient = options.protocolClient;
+        this.capabilities = {
+            deviceClass: options.deviceClass,
+            stateClass: options.stateClass,
+            unit: options.unit,
+            precision: options.precision,
+        };
+        this._unit = options.unit;
+    }
+    // ============================================================================
+    // Properties
+    // ============================================================================
+    /**
+     * Get current value (cached)
+     */
+    get value() {
+        return this._value;
+    }
+    /**
+     * Get numeric value if available (cached)
+     */
+    get numericValue() {
+        return this._numericValue;
+    }
+    /**
+     * Get unit of measurement
+     */
+    get unit() {
+        return this._unit;
+    }
+    /**
+     * Get device class
+     */
+    get deviceClass() {
+        return this.capabilities.deviceClass;
+    }
+    /**
+     * Get state class
+     */
+    get stateClass() {
+        return this.capabilities.stateClass;
+    }
+    /**
+     * Get last updated timestamp
+     */
+    get lastUpdated() {
+        return this._lastUpdated;
+    }
+    // ============================================================================
+    // Connection
+    // ============================================================================
+    async doConnect() {
+        // Fetch initial state
+        try {
+            const state = await this.protocolClient.getState(this.entityId);
+            this.updateStateInternal(state);
+        }
+        catch {
+            // Ignore errors fetching initial state
+        }
+    }
+    async doDisconnect() {
+        // Nothing to disconnect
+    }
+    // ============================================================================
+    // Sensor Reading
+    // ============================================================================
+    /**
+     * Refresh state from the device
+     */
+    async refreshState() {
+        const state = await this.protocolClient.getState(this.entityId);
+        this.updateStateInternal(state);
+        return state;
+    }
+    /**
+     * Update state from external source (e.g., state change event)
+     */
+    updateState(state) {
+        this.updateStateInternal(state);
+        this.emit('state:changed', state);
+    }
+    /**
+     * Internal state update
+     */
+    updateStateInternal(state) {
+        this._value = state.value;
+        this._numericValue = state.numericValue;
+        this._unit = state.unit || this._unit;
+        this._lastUpdated = state.lastUpdated;
+    }
+    // ============================================================================
+    // Feature Info
+    // ============================================================================
+    getFeatureInfo() {
+        return {
+            ...this.getBaseFeatureInfo(),
+            type: 'sensor',
+            protocol: this.protocol,
+            capabilities: this.capabilities,
+            currentState: {
+                value: this._value,
+                numericValue: this._numericValue,
+                unit: this._unit,
+                lastUpdated: this._lastUpdated,
+            },
+        };
+    }
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiZmVhdHVyZS5zZW5zb3IuanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi90cy9mZWF0dXJlcy9mZWF0dXJlLnNlbnNvci50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFBQTs7O0dBR0c7QUFFSCxPQUFPLEVBQUUsT0FBTyxFQUF5QixNQUFNLHVCQUF1QixDQUFDO0FBZ0N2RTs7Ozs7Ozs7Ozs7OztHQWFHO0FBQ0gsTUFBTSxPQUFPLGFBQWMsU0FBUSxPQUFPO0lBQ3hCLElBQUksR0FBRyxRQUFpQixDQUFDO0lBQ3pCLFFBQVEsQ0FBa0I7SUFFMUMseURBQXlEO0lBQ3pDLFFBQVEsQ0FBUztJQUVqQyxtQkFBbUI7SUFDSCxZQUFZLENBQXNCO0lBRWxELG9CQUFvQjtJQUNWLE1BQU0sR0FBOEIsRUFBRSxDQUFDO0lBQ3ZDLGFBQWEsQ0FBVTtJQUN2QixLQUFLLENBQVU7SUFDZixZQUFZLEdBQVMsSUFBSSxJQUFJLEVBQUUsQ0FBQztJQUUxQywrQ0FBK0M7SUFDdkMsY0FBYyxDQUF3QjtJQUU5QyxZQUNFLE1BQXdCLEVBQ3hCLElBQVksRUFDWixPQUE4QjtRQUU5QixLQUFLLENBQUMsTUFBTSxFQUFFLElBQUksRUFBRSxPQUFPLENBQUMsQ0FBQztRQUM3QixJQUFJLENBQUMsUUFBUSxHQUFHLE9BQU8sQ0FBQyxRQUFRLENBQUM7UUFDakMsSUFBSSxDQUFDLFFBQVEsR0FBRyxPQUFPLENBQUMsUUFBUSxDQUFDO1FBQ2pDLElBQUksQ0FBQyxjQUFjLEdBQUcsT0FBTyxDQUFDLGNBQWMsQ0FBQztRQUM3QyxJQUFJLENBQUMsWUFBWSxHQUFHO1lBQ2xCLFdBQVcsRUFBRSxPQUFPLENBQUMsV0FBVztZQUNoQyxVQUFVLEVBQUUsT0FBTyxDQUFDLFVBQVU7WUFDOUIsSUFBSSxFQUFFLE9BQU8sQ0FBQyxJQUFJO1lBQ2xCLFNBQVMsRUFBRSxPQUFPLENBQUMsU0FBUztTQUM3QixDQUFDO1FBQ0YsSUFBSSxDQUFDLEtBQUssR0FBRyxPQUFPLENBQUMs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

package/dist_ts/features/feature.snmp.d.ts

@@ -0,0 +1,88 @@
+/**
+ * SNMP Feature
+ * Provides SNMP query capability for network management
+ */
+import { Feature, type TDeviceReference } from './feature.abstract.js';
+import type { TSnmpVersion, ISnmpVarbind, ISnmpFeatureInfo, IFeatureOptions } from '../interfaces/feature.interfaces.js';
+/**
+ * Options for creating an SnmpFeature
+ */
+export interface ISnmpFeatureOptions extends IFeatureOptions {
+    version?: TSnmpVersion;
+    community?: string;
+    username?: string;
+    authProtocol?: 'md5' | 'sha';
+    authKey?: string;
+    privProtocol?: 'des' | 'aes';
+    privKey?: string;
+}
+/**
+ * SNMP Feature - provides SNMP query capability
+ *
+ * Allows querying devices via SNMP for monitoring and management.
+ * Many network devices (printers, switches, UPS) support SNMP.
+ *
+ * @example
+ * ```typescript
+ * const snmp = device.getFeature<SnmpFeature>('snmp');
+ * if (snmp) {
+ *   const sysDescr = await snmp.get('1.3.6.1.2.1.1.1.0');
+ *   console.log(`System: ${sysDescr.value}`);
+ *
+ *   const interfaces = await snmp.walk('1.3.6.1.2.1.2.2.1');
+ *   console.log(`Found ${interfaces.length} interface entries`);
+ * }
+ * ```
+ */
+export declare class SnmpFeature extends Feature {
+    readonly type: "snmp";
+    readonly protocol = "snmp";
+    readonly version: TSnmpVersion;
+    readonly community: string;
+    sysDescr?: string;
+    sysObjectId?: string;
+    sysName?: string;
+    sysLocation?: string;
+    sysContact?: string;
+    sysUpTime?: number;
+    constructor(device: TDeviceReference, port: number, options?: ISnmpFeatureOptions);
+    protected doConnect(): Promise<void>;
+    protected doDisconnect(): Promise<void>;
+    /**
+     * Get a single OID value
+     */
+    get(oid: string): Promise<ISnmpVarbind>;
+    /**
+     * Get multiple OID values
+     */
+    getMultiple(oids: string[]): Promise<ISnmpVarbind[]>;
+    /**
+     * Get next OID in MIB tree
+     */
+    getNext(oid: string): Promise<ISnmpVarbind>;
+    /**
+     * Walk a subtree of the MIB
+     */
+    walk(baseOid: string): Promise<ISnmpVarbind[]>;
+    /**
+     * Bulk get (SNMPv2c/v3)
+     */
+    getBulk(oids: string[], nonRepeaters?: number, maxRepetitions?: number): Promise<ISnmpVarbind[]>;
+    /**
+     * Set an OID value
+     */
+    set(oid: string, type: number, value: unknown): Promise<ISnmpVarbind>;
+    /**
+     * Get all system info OIDs
+     */
+    getSystemInfo(): Promise<{
+        sysDescr?: string;
+        sysObjectId?: string;
+        sysName?: string;
+        sysLocation?: string;
+        sysContact?: string;
+        sysUpTime?: number;
+    }>;
+    getFeatureInfo(): ISnmpFeatureInfo;
+    static fromDiscovery(device: TDeviceReference, port: number, metadata: Record<string, unknown>): SnmpFeature;
+}

package/dist_ts/features/feature.snmp.js

@@ -0,0 +1,175 @@
+/**
+ * SNMP Feature
+ * Provides SNMP query capability for network management
+ */
+import { Feature } from './feature.abstract.js';
+/**
+ * SNMP Feature - provides SNMP query capability
+ *
+ * Allows querying devices via SNMP for monitoring and management.
+ * Many network devices (printers, switches, UPS) support SNMP.
+ *
+ * @example
+ * ```typescript
+ * const snmp = device.getFeature<SnmpFeature>('snmp');
+ * if (snmp) {
+ *   const sysDescr = await snmp.get('1.3.6.1.2.1.1.1.0');
+ *   console.log(`System: ${sysDescr.value}`);
+ *
+ *   const interfaces = await snmp.walk('1.3.6.1.2.1.2.2.1');
+ *   console.log(`Found ${interfaces.length} interface entries`);
+ * }
+ * ```
+ */
+export class SnmpFeature extends Feature {
+    type = 'snmp';
+    protocol = 'snmp';
+    // Configuration
+    version;
+    community;
+    // System info (populated after connect)
+    sysDescr;
+    sysObjectId;
+    sysName;
+    sysLocation;
+    sysContact;
+    sysUpTime;
+    constructor(device, port, options) {
+        super(device, port ?? 161, options);
+        this.version = options?.version ?? 'v2c';
+        this.community = options?.community ?? 'public';
+    }
+    // ============================================================================
+    // Connection
+    // ============================================================================
+    async doConnect() {
+        // Test connection by getting system description
+        try {
+            const result = await this.get('1.3.6.1.2.1.1.1.0'); // sysDescr
+            if (result) {
+                this.sysDescr = String(result.value);
+            }
+        }
+        catch {
+            // Connection test failed
+            throw new Error('SNMP connection failed');
+        }
+    }
+    async doDisconnect() {
+        // SNMP is connectionless, nothing to disconnect
+    }
+    // ============================================================================
+    // SNMP Operations
+    // ============================================================================
+    /**
+     * Get a single OID value
+     */
+    async get(oid) {
+        // This would use the SNMP library to perform the query
+        // Placeholder implementation
+        return {
+            oid,
+            type: 0,
+            value: null,
+        };
+    }
+    /**
+     * Get multiple OID values
+     */
+    async getMultiple(oids) {
+        const results = [];
+        for (const oid of oids) {
+            results.push(await this.get(oid));
+        }
+        return results;
+    }
+    /**
+     * Get next OID in MIB tree
+     */
+    async getNext(oid) {
+        // Placeholder
+        return {
+            oid,
+            type: 0,
+            value: null,
+        };
+    }
+    /**
+     * Walk a subtree of the MIB
+     */
+    async walk(baseOid) {
+        const results = [];
+        // This would iterate through the MIB tree using getNext
+        return results;
+    }
+    /**
+     * Bulk get (SNMPv2c/v3)
+     */
+    async getBulk(oids, nonRepeaters = 0, maxRepetitions = 10) {
+        if (this.version === 'v1') {
+            throw new Error('getBulk not supported in SNMPv1');
+        }
+        // Placeholder
+        return [];
+    }
+    /**
+     * Set an OID value
+     */
+    async set(oid, type, value) {
+        // Placeholder
+        return {
+            oid,
+            type,
+            value,
+        };
+    }
+    // ============================================================================
+    // System Info
+    // ============================================================================
+    /**
+     * Get all system info OIDs
+     */
+    async getSystemInfo() {
+        const oids = [
+            '1.3.6.1.2.1.1.1.0', // sysDescr
+            '1.3.6.1.2.1.1.2.0', // sysObjectID
+            '1.3.6.1.2.1.1.3.0', // sysUpTime
+            '1.3.6.1.2.1.1.4.0', // sysContact
+            '1.3.6.1.2.1.1.5.0', // sysName
+            '1.3.6.1.2.1.1.6.0', // sysLocation
+        ];
+        const results = await this.getMultiple(oids);
+        return {
+            sysDescr: results[0]?.value,
+            sysObjectId: results[1]?.value,
+            sysUpTime: results[2]?.value,
+            sysContact: results[3]?.value,
+            sysName: results[4]?.value,
+            sysLocation: results[5]?.value,
+        };
+    }
+    // ============================================================================
+    // Serialization
+    // ============================================================================
+    getFeatureInfo() {
+        return {
+            ...this.getBaseFeatureInfo(),
+            type: 'snmp',
+            version: this.version,
+            community: this.version !== 'v3' ? this.community : undefined,
+            sysDescr: this.sysDescr,
+            sysName: this.sysName,
+            sysLocation: this.sysLocation,
+        };
+    }
+    // ============================================================================
+    // Static Factory
+    // ============================================================================
+    static fromDiscovery(device, port, metadata) {
+        return new SnmpFeature(device, port ?? 161, {
+            version: metadata.version ?? 'v2c',
+            community: metadata.community ?? 'public',
+        });
+    }
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiZmVhdHVyZS5zbm1wLmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vdHMvZmVhdHVyZXMvZmVhdHVyZS5zbm1wLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQUFBOzs7R0FHRztBQUVILE9BQU8sRUFBRSxPQUFPLEVBQXlCLE1BQU0sdUJBQXVCLENBQUM7QUFzQnZFOzs7Ozs7Ozs7Ozs7Ozs7OztHQWlCRztBQUNILE1BQU0sT0FBTyxXQUFZLFNBQVEsT0FBTztJQUN0QixJQUFJLEdBQUcsTUFBZSxDQUFDO0lBQ3ZCLFFBQVEsR0FBRyxNQUFNLENBQUM7SUFFbEMsZ0JBQWdCO0lBQ0EsT0FBTyxDQUFlO0lBQ3RCLFNBQVMsQ0FBUztJQUVsQyx3Q0FBd0M7SUFDakMsUUFBUSxDQUFVO0lBQ2xCLFdBQVcsQ0FBVTtJQUNyQixPQUFPLENBQVU7SUFDakIsV0FBVyxDQUFVO0lBQ3JCLFVBQVUsQ0FBVTtJQUNwQixTQUFTLENBQVU7SUFFMUIsWUFDRSxNQUF3QixFQUN4QixJQUFZLEVBQ1osT0FBNkI7UUFFN0IsS0FBSyxDQUFDLE1BQU0sRUFBRSxJQUFJLElBQUksR0FBRyxFQUFFLE9BQU8sQ0FBQyxDQUFDO1FBQ3BDLElBQUksQ0FBQyxPQUFPLEdBQUcsT0FBTyxFQUFFLE9BQU8sSUFBSSxLQUFLLENBQUM7UUFDekMsSUFBSSxDQUFDLFNBQVMsR0FBRyxPQUFPLEVBQUUsU0FBUyxJQUFJLFFBQVEsQ0FBQztJQUNsRCxDQUFDO0lBRUQsK0VBQStFO0lBQy9FLGFBQWE7SUFDYiwrRUFBK0U7SUFFckUsS0FBSyxDQUFDLFNBQVM7UUFDdkIsZ0RBQWdEO1FBQ2hELElBQUksQ0FBQztZQUNILE1BQU0sTUFBTSxHQUFHLE1BQU0sSUFBSSxDQUFDLEdBQUcsQ0FBQyxtQkFBbUIsQ0FBQyxDQUFDLENBQUMsV0FBVztZQUMvRCxJQUFJLE1BQU0sRUFBRSxDQUFDO2dCQUNYLElBQUksQ0FBQyxRQUFRLEdBQUcsTUFBTSxDQUFDLE1BQU0sQ0FBQyxLQUFL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

package/dist_ts/features/feature.switch.d.ts

@@ -0,0 +1,75 @@
+/**
+ * Switch Feature
+ * Provides binary on/off control for smart switches, outlets, etc.
+ */
+import { Feature, type TDeviceReference } from './feature.abstract.js';
+import type { IFeatureOptions } from '../interfaces/feature.interfaces.js';
+import type { TSwitchProtocol, ISwitchCapabilities, ISwitchState, ISwitchFeatureInfo, ISwitchProtocolClient } from '../interfaces/smarthome.interfaces.js';
+/**
+ * Options for creating a SwitchFeature
+ */
+export interface ISwitchFeatureOptions extends IFeatureOptions {
+    /** Protocol type */
+    protocol: TSwitchProtocol;
+    /** Entity ID (for Home Assistant) */
+    entityId: string;
+    /** Protocol client for controlling the switch */
+    protocolClient: ISwitchProtocolClient;
+    /** Device class */
+    deviceClass?: 'outlet' | 'switch';
+}
+/**
+ * Switch Feature - binary on/off control
+ *
+ * Protocol-agnostic: works with Home Assistant, MQTT, Tasmota, Tuya, etc.
+ *
+ * @example
+ * ```typescript
+ * const sw = device.getFeature<SwitchFeature>('switch');
+ * if (sw) {
+ *   await sw.turnOn();
+ *   await sw.toggle();
+ *   console.log(`Switch is ${sw.isOn ? 'on' : 'off'}`);
+ * }
+ * ```
+ */
+export declare class SwitchFeature extends Feature {
+    readonly type: "switch";
+    readonly protocol: TSwitchProtocol;
+    /** Entity ID (e.g., "switch.living_room") */
+    readonly entityId: string;
+    /** Capabilities */
+    readonly capabilities: ISwitchCapabilities;
+    /** Current state */
+    protected _isOn: boolean;
+    /** Protocol client for controlling the switch */
+    private protocolClient;
+    constructor(device: TDeviceReference, port: number, options: ISwitchFeatureOptions);
+    /**
+     * Get current on/off state (cached)
+     */
+    get isOn(): boolean;
+    protected doConnect(): Promise<void>;
+    protected doDisconnect(): Promise<void>;
+    /**
+     * Turn on the switch
+     */
+    turnOn(): Promise<void>;
+    /**
+     * Turn off the switch
+     */
+    turnOff(): Promise<void>;
+    /**
+     * Toggle the switch
+     */
+    toggle(): Promise<void>;
+    /**
+     * Refresh state from the device
+     */
+    refreshState(): Promise<ISwitchState>;
+    /**
+     * Update state from external source (e.g., state change event)
+     */
+    updateState(state: ISwitchState): void;
+    getFeatureInfo(): ISwitchFeatureInfo;
+}