@ecobridge.xyz/devicemanager 3.0.2

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

@@ -0,0 +1,127 @@
+/**
+ * Fan Feature
+ * Provides control for fans (speed, oscillation, direction)
+ */
+import { Feature, type TDeviceReference } from './feature.abstract.js';
+import type { IFeatureOptions } from '../interfaces/feature.interfaces.js';
+import type { TFanProtocol, TFanDirection, IFanCapabilities, IFanState, IFanFeatureInfo, IFanProtocolClient } from '../interfaces/smarthome.interfaces.js';
+/**
+ * Options for creating a FanFeature
+ */
+export interface IFanFeatureOptions extends IFeatureOptions {
+    /** Protocol type */
+    protocol: TFanProtocol;
+    /** Entity ID (for Home Assistant) */
+    entityId: string;
+    /** Protocol client for controlling the fan */
+    protocolClient: IFanProtocolClient;
+    /** Fan capabilities */
+    capabilities?: Partial<IFanCapabilities>;
+}
+/**
+ * Fan Feature - speed, oscillation, and direction control
+ *
+ * Protocol-agnostic: works with Home Assistant, MQTT, Bond, etc.
+ *
+ * @example
+ * ```typescript
+ * const fan = device.getFeature<FanFeature>('fan');
+ * if (fan) {
+ *   await fan.turnOn(75); // 75% speed
+ *   await fan.setOscillating(true);
+ * }
+ * ```
+ */
+export declare class FanFeature extends Feature {
+    readonly type: "fan";
+    readonly protocol: TFanProtocol;
+    /** Entity ID (e.g., "fan.bedroom") */
+    readonly entityId: string;
+    /** Capabilities */
+    readonly capabilities: IFanCapabilities;
+    /** Current state */
+    protected _isOn: boolean;
+    protected _percentage?: number;
+    protected _presetMode?: string;
+    protected _oscillating?: boolean;
+    protected _direction?: TFanDirection;
+    /** Protocol client for controlling the fan */
+    private protocolClient;
+    constructor(device: TDeviceReference, port: number, options: IFanFeatureOptions);
+    /**
+     * Get current on/off state (cached)
+     */
+    get isOn(): boolean;
+    /**
+     * Get current speed percentage 0-100 (cached)
+     */
+    get percentage(): number | undefined;
+    /**
+     * Get current preset mode (cached)
+     */
+    get presetMode(): string | undefined;
+    /**
+     * Get oscillating state (cached)
+     */
+    get oscillating(): boolean | undefined;
+    /**
+     * Get direction (cached)
+     */
+    get direction(): TFanDirection | undefined;
+    /**
+     * Get available preset modes
+     */
+    get presetModes(): string[] | undefined;
+    protected doConnect(): Promise<void>;
+    protected doDisconnect(): Promise<void>;
+    /**
+     * Turn on the fan
+     * @param percentage Optional speed percentage
+     */
+    turnOn(percentage?: number): Promise<void>;
+    /**
+     * Turn off the fan
+     */
+    turnOff(): Promise<void>;
+    /**
+     * Toggle the fan
+     */
+    toggle(): Promise<void>;
+    /**
+     * Set speed percentage
+     * @param percentage Speed 0-100
+     */
+    setPercentage(percentage: number): Promise<void>;
+    /**
+     * Set preset mode
+     * @param mode Preset mode name
+     */
+    setPresetMode(mode: string): Promise<void>;
+    /**
+     * Set oscillating state
+     * @param oscillating Whether to oscillate
+     */
+    setOscillating(oscillating: boolean): Promise<void>;
+    /**
+     * Set direction
+     * @param direction forward or reverse
+     */
+    setDirection(direction: TFanDirection): Promise<void>;
+    /**
+     * Get current state as object
+     */
+    getState(): IFanState;
+    /**
+     * Refresh state from the device
+     */
+    refreshState(): Promise<IFanState>;
+    /**
+     * Update state from external source
+     */
+    updateState(state: IFanState): void;
+    /**
+     * Internal state update
+     */
+    private updateStateInternal;
+    getFeatureInfo(): IFanFeatureInfo;
+}

package/dist_ts/features/feature.fan.js

@@ -0,0 +1,235 @@
+/**
+ * Fan Feature
+ * Provides control for fans (speed, oscillation, direction)
+ */
+import { Feature } from './feature.abstract.js';
+/**
+ * Fan Feature - speed, oscillation, and direction control
+ *
+ * Protocol-agnostic: works with Home Assistant, MQTT, Bond, etc.
+ *
+ * @example
+ * ```typescript
+ * const fan = device.getFeature<FanFeature>('fan');
+ * if (fan) {
+ *   await fan.turnOn(75); // 75% speed
+ *   await fan.setOscillating(true);
+ * }
+ * ```
+ */
+export class FanFeature extends Feature {
+    type = 'fan';
+    protocol;
+    /** Entity ID (e.g., "fan.bedroom") */
+    entityId;
+    /** Capabilities */
+    capabilities;
+    /** Current state */
+    _isOn = false;
+    _percentage;
+    _presetMode;
+    _oscillating;
+    _direction;
+    /** Protocol client for controlling the fan */
+    protocolClient;
+    constructor(device, port, options) {
+        super(device, port, options);
+        this.protocol = options.protocol;
+        this.entityId = options.entityId;
+        this.protocolClient = options.protocolClient;
+        this.capabilities = {
+            supportsSpeed: options.capabilities?.supportsSpeed ?? true,
+            supportsOscillate: options.capabilities?.supportsOscillate ?? false,
+            supportsDirection: options.capabilities?.supportsDirection ?? false,
+            supportsPresetModes: options.capabilities?.supportsPresetModes ?? false,
+            presetModes: options.capabilities?.presetModes,
+            speedCount: options.capabilities?.speedCount,
+        };
+    }
+    // ============================================================================
+    // Properties
+    // ============================================================================
+    /**
+     * Get current on/off state (cached)
+     */
+    get isOn() {
+        return this._isOn;
+    }
+    /**
+     * Get current speed percentage 0-100 (cached)
+     */
+    get percentage() {
+        return this._percentage;
+    }
+    /**
+     * Get current preset mode (cached)
+     */
+    get presetMode() {
+        return this._presetMode;
+    }
+    /**
+     * Get oscillating state (cached)
+     */
+    get oscillating() {
+        return this._oscillating;
+    }
+    /**
+     * Get direction (cached)
+     */
+    get direction() {
+        return this._direction;
+    }
+    /**
+     * Get available preset modes
+     */
+    get presetModes() {
+        return this.capabilities.presetModes;
+    }
+    // ============================================================================
+    // Connection
+    // ============================================================================
+    async doConnect() {
+        try {
+            const state = await this.protocolClient.getState(this.entityId);
+            this.updateStateInternal(state);
+        }
+        catch {
+            // Ignore errors fetching initial state
+        }
+    }
+    async doDisconnect() {
+        // Nothing to disconnect
+    }
+    // ============================================================================
+    // Fan Control
+    // ============================================================================
+    /**
+     * Turn on the fan
+     * @param percentage Optional speed percentage
+     */
+    async turnOn(percentage) {
+        await this.protocolClient.turnOn(this.entityId, percentage);
+        this._isOn = true;
+        if (percentage !== undefined) {
+            this._percentage = percentage;
+        }
+        this.emit('state:changed', this.getState());
+    }
+    /**
+     * Turn off the fan
+     */
+    async turnOff() {
+        await this.protocolClient.turnOff(this.entityId);
+        this._isOn = false;
+        this.emit('state:changed', this.getState());
+    }
+    /**
+     * Toggle the fan
+     */
+    async toggle() {
+        await this.protocolClient.toggle(this.entityId);
+        this._isOn = !this._isOn;
+        this.emit('state:changed', this.getState());
+    }
+    /**
+     * Set speed percentage
+     * @param percentage Speed 0-100
+     */
+    async setPercentage(percentage) {
+        if (!this.capabilities.supportsSpeed) {
+            throw new Error('Fan does not support speed control');
+        }
+        const clamped = Math.max(0, Math.min(100, Math.round(percentage)));
+        await this.protocolClient.setPercentage(this.entityId, clamped);
+        this._percentage = clamped;
+        this._isOn = clamped > 0;
+        this.emit('state:changed', this.getState());
+    }
+    /**
+     * Set preset mode
+     * @param mode Preset mode name
+     */
+    async setPresetMode(mode) {
+        if (!this.capabilities.supportsPresetModes) {
+            throw new Error('Fan does not support preset modes');
+        }
+        await this.protocolClient.setPresetMode(this.entityId, mode);
+        this._presetMode = mode;
+        this._isOn = true;
+        this.emit('state:changed', this.getState());
+    }
+    /**
+     * Set oscillating state
+     * @param oscillating Whether to oscillate
+     */
+    async setOscillating(oscillating) {
+        if (!this.capabilities.supportsOscillate) {
+            throw new Error('Fan does not support oscillation');
+        }
+        await this.protocolClient.setOscillating(this.entityId, oscillating);
+        this._oscillating = oscillating;
+        this.emit('state:changed', this.getState());
+    }
+    /**
+     * Set direction
+     * @param direction forward or reverse
+     */
+    async setDirection(direction) {
+        if (!this.capabilities.supportsDirection) {
+            throw new Error('Fan does not support direction control');
+        }
+        await this.protocolClient.setDirection(this.entityId, direction);
+        this._direction = direction;
+        this.emit('state:changed', this.getState());
+    }
+    /**
+     * Get current state as object
+     */
+    getState() {
+        return {
+            isOn: this._isOn,
+            percentage: this._percentage,
+            presetMode: this._presetMode,
+            oscillating: this._oscillating,
+            direction: this._direction,
+        };
+    }
+    /**
+     * 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
+     */
+    updateState(state) {
+        this.updateStateInternal(state);
+        this.emit('state:changed', state);
+    }
+    /**
+     * Internal state update
+     */
+    updateStateInternal(state) {
+        this._isOn = state.isOn;
+        this._percentage = state.percentage;
+        this._presetMode = state.presetMode;
+        this._oscillating = state.oscillating;
+        this._direction = state.direction;
+    }
+    // ============================================================================
+    // Feature Info
+    // ============================================================================
+    getFeatureInfo() {
+        return {
+            ...this.getBaseFeatureInfo(),
+            type: 'fan',
+            protocol: this.protocol,
+            capabilities: this.capabilities,
+            currentState: this.getState(),
+        };
+    }
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiZmVhdHVyZS5mYW4uanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi90cy9mZWF0dXJlcy9mZWF0dXJlLmZhbi50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFBQTs7O0dBR0c7QUFFSCxPQUFPLEVBQUUsT0FBTyxFQUF5QixNQUFNLHVCQUF1QixDQUFDO0FBeUJ2RTs7Ozs7Ozs7Ozs7OztHQWFHO0FBQ0gsTUFBTSxPQUFPLFVBQVcsU0FBUSxPQUFPO0lBQ3JCLElBQUksR0FBRyxLQUFjLENBQUM7SUFDdEIsUUFBUSxDQUFlO0lBRXZDLHNDQUFzQztJQUN0QixRQUFRLENBQVM7SUFFakMsbUJBQW1CO0lBQ0gsWUFBWSxDQUFtQjtJQUUvQyxvQkFBb0I7SUFDVixLQUFLLEdBQVksS0FBSyxDQUFDO0lBQ3ZCLFdBQVcsQ0FBVTtJQUNyQixXQUFXLENBQVU7SUFDckIsWUFBWSxDQUFXO0lBQ3ZCLFVBQVUsQ0FBaUI7SUFFckMsOENBQThDO0lBQ3RDLGNBQWMsQ0FBcUI7SUFFM0MsWUFDRSxNQUF3QixFQUN4QixJQUFZLEVBQ1osT0FBMkI7UUFFM0IsS0FBSyxDQUFDLE1BQU0sRUFBRSxJQUFJLEVBQUUsT0FBTyxDQUFDLENBQUM7UUFDN0IsSUFBSSxDQUFDLFFBQVEsR0FBRyxPQUFPLENBQUMsUUFBUSxDQUFDO1FBQ2pDLElBQUksQ0FBQyxRQUFRLEdBQUcsT0FBTyxDQUFDLFFBQVEsQ0FBQztRQUNqQyxJQUFJLENBQUMsY0FBYyxHQUFHLE9BQU8sQ0FBQyxjQUFjLENBQUM7UUFFN0MsSUFBSSxDQUFDLFlBQVksR0FBRztZQUNsQixhQUFhLEVBQUUsT0FBTyxDQUFDLFlBQVksRUFBRSxhQUFhLElBQUksSUFBSTtZQUMxRCxpQkFBaUIsRUFBRSxPQUFPLENBQUMsWUFBWSxFQUFFLGlCQUFpQixJQUFJLEtBQUs7WUFDbkUsaUJBQWlCLEVBQUUsT0FBTyxDQUFDLFlBQVksRUFBRSxpQkFBaUIsSUFBSSxLQUFLO1lBQ25FLG1CQUFtQixFQUFFLE9B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

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

@@ -0,0 +1,156 @@
+/**
+ * Light Feature
+ * Provides control for smart lights (brightness, color, effects)
+ */
+import { Feature, type TDeviceReference } from './feature.abstract.js';
+import type { IFeatureOptions } from '../interfaces/feature.interfaces.js';
+import type { TLightProtocol, ILightCapabilities, ILightState, ILightFeatureInfo, ILightProtocolClient } from '../interfaces/smarthome.interfaces.js';
+/**
+ * Options for creating a LightFeature
+ */
+export interface ILightFeatureOptions extends IFeatureOptions {
+    /** Protocol type */
+    protocol: TLightProtocol;
+    /** Entity ID (for Home Assistant) */
+    entityId: string;
+    /** Protocol client for controlling the light */
+    protocolClient: ILightProtocolClient;
+    /** Light capabilities */
+    capabilities?: Partial<ILightCapabilities>;
+}
+/**
+ * Light Feature - brightness, color, and effect control
+ *
+ * Protocol-agnostic: works with Home Assistant, Hue, MQTT, Zigbee, etc.
+ *
+ * @example
+ * ```typescript
+ * const light = device.getFeature<LightFeature>('light');
+ * if (light) {
+ *   await light.turnOn({ brightness: 200 });
+ *   await light.setColorTemp(4000); // 4000K warm white
+ *   await light.setRgbColor(255, 100, 50);
+ * }
+ * ```
+ */
+export declare class LightFeature extends Feature {
+    readonly type: "light";
+    readonly protocol: TLightProtocol;
+    /** Entity ID (e.g., "light.living_room") */
+    readonly entityId: string;
+    /** Capabilities */
+    readonly capabilities: ILightCapabilities;
+    /** Current state */
+    protected _isOn: boolean;
+    protected _brightness?: number;
+    protected _colorTemp?: number;
+    protected _colorTempMireds?: number;
+    protected _rgbColor?: [number, number, number];
+    protected _hsColor?: [number, number];
+    protected _xyColor?: [number, number];
+    protected _effect?: string;
+    /** Protocol client for controlling the light */
+    private protocolClient;
+    constructor(device: TDeviceReference, port: number, options: ILightFeatureOptions);
+    /**
+     * Get current on/off state (cached)
+     */
+    get isOn(): boolean;
+    /**
+     * Get current brightness 0-255 (cached)
+     */
+    get brightness(): number | undefined;
+    /**
+     * Get current color temperature in Kelvin (cached)
+     */
+    get colorTemp(): number | undefined;
+    /**
+     * Get current color temperature in Mireds (cached)
+     */
+    get colorTempMireds(): number | undefined;
+    /**
+     * Get current RGB color (cached)
+     */
+    get rgbColor(): [number, number, number] | undefined;
+    /**
+     * Get current HS color [hue 0-360, saturation 0-100] (cached)
+     */
+    get hsColor(): [number, number] | undefined;
+    /**
+     * Get current XY color (cached)
+     */
+    get xyColor(): [number, number] | undefined;
+    /**
+     * Get current effect (cached)
+     */
+    get effect(): string | undefined;
+    /**
+     * Get available effects
+     */
+    get effects(): string[] | undefined;
+    protected doConnect(): Promise<void>;
+    protected doDisconnect(): Promise<void>;
+    /**
+     * Turn on the light
+     * @param options Optional settings to apply when turning on
+     */
+    turnOn(options?: {
+        brightness?: number;
+        colorTemp?: number;
+        rgb?: [number, number, number];
+        transition?: number;
+    }): Promise<void>;
+    /**
+     * Turn off the light
+     * @param options Optional transition time
+     */
+    turnOff(options?: {
+        transition?: number;
+    }): Promise<void>;
+    /**
+     * Toggle the light
+     */
+    toggle(): Promise<void>;
+    /**
+     * Set brightness level
+     * @param brightness Brightness 0-255
+     * @param transition Optional transition time in seconds
+     */
+    setBrightness(brightness: number, transition?: number): Promise<void>;
+    /**
+     * Set color temperature in Kelvin
+     * @param kelvin Color temperature in Kelvin (e.g., 2700 warm, 6500 cool)
+     * @param transition Optional transition time in seconds
+     */
+    setColorTemp(kelvin: number, transition?: number): Promise<void>;
+    /**
+     * Set RGB color
+     * @param r Red 0-255
+     * @param g Green 0-255
+     * @param b Blue 0-255
+     * @param transition Optional transition time in seconds
+     */
+    setRgbColor(r: number, g: number, b: number, transition?: number): Promise<void>;
+    /**
+     * Set light effect
+     * @param effect Effect name from available effects
+     */
+    setEffect(effect: string): Promise<void>;
+    /**
+     * Get current state as object
+     */
+    getState(): ILightState;
+    /**
+     * Refresh state from the device
+     */
+    refreshState(): Promise<ILightState>;
+    /**
+     * Update state from external source (e.g., state change event)
+     */
+    updateState(state: ILightState): void;
+    /**
+     * Internal state update
+     */
+    private updateStateInternal;
+    getFeatureInfo(): ILightFeatureInfo;
+}