@ecobridge.xyz/devicemanager 3.0.2

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

@@ -0,0 +1,95 @@
+/**
+ * Camera Feature
+ * Provides control for smart cameras (snapshots, streams)
+ */
+import { Feature, type TDeviceReference } from './feature.abstract.js';
+import type { IFeatureOptions } from '../interfaces/feature.interfaces.js';
+import type { TCameraProtocol, ICameraCapabilities, ICameraState, ICameraFeatureInfo, ICameraProtocolClient } from '../interfaces/smarthome.interfaces.js';
+/**
+ * Options for creating a CameraFeature
+ */
+export interface ICameraFeatureOptions extends IFeatureOptions {
+    /** Protocol type */
+    protocol: TCameraProtocol;
+    /** Entity ID (for Home Assistant) */
+    entityId: string;
+    /** Protocol client for the camera */
+    protocolClient: ICameraProtocolClient;
+    /** Camera capabilities */
+    capabilities?: Partial<ICameraCapabilities>;
+}
+/**
+ * Camera Feature - snapshot and stream access
+ *
+ * Protocol-agnostic: works with Home Assistant, ONVIF, RTSP, etc.
+ *
+ * @example
+ * ```typescript
+ * const camera = device.getFeature<CameraFeature>('camera');
+ * if (camera) {
+ *   const snapshot = await camera.getSnapshot();
+ *   const streamUrl = await camera.getStreamUrl();
+ * }
+ * ```
+ */
+export declare class CameraFeature extends Feature {
+    readonly type: "camera";
+    readonly protocol: TCameraProtocol;
+    /** Entity ID (e.g., "camera.front_door") */
+    readonly entityId: string;
+    /** Capabilities */
+    readonly capabilities: ICameraCapabilities;
+    /** Current state */
+    protected _isRecording: boolean;
+    protected _isStreaming: boolean;
+    protected _motionDetected: boolean;
+    /** Protocol client for the camera */
+    private protocolClient;
+    constructor(device: TDeviceReference, port: number, options: ICameraFeatureOptions);
+    /**
+     * Check if recording (cached)
+     */
+    get isRecording(): boolean;
+    /**
+     * Check if streaming (cached)
+     */
+    get isStreaming(): boolean;
+    /**
+     * Check if motion detected (cached)
+     */
+    get motionDetected(): boolean;
+    protected doConnect(): Promise<void>;
+    protected doDisconnect(): Promise<void>;
+    /**
+     * Get a snapshot image from the camera
+     * @returns Buffer containing image data
+     */
+    getSnapshot(): Promise<Buffer>;
+    /**
+     * Get snapshot URL
+     * @returns URL for the snapshot image
+     */
+    getSnapshotUrl(): Promise<string>;
+    /**
+     * Get stream URL
+     * @returns URL for the video stream
+     */
+    getStreamUrl(): Promise<string>;
+    /**
+     * Get current state as object
+     */
+    getState(): ICameraState;
+    /**
+     * Refresh state from the device
+     */
+    refreshState(): Promise<ICameraState>;
+    /**
+     * Update state from external source
+     */
+    updateState(state: ICameraState): void;
+    /**
+     * Internal state update
+     */
+    private updateStateInternal;
+    getFeatureInfo(): ICameraFeatureInfo;
+}

package/dist_ts/features/feature.camera.js

@@ -0,0 +1,162 @@
+/**
+ * Camera Feature
+ * Provides control for smart cameras (snapshots, streams)
+ */
+import { Feature } from './feature.abstract.js';
+/**
+ * Camera Feature - snapshot and stream access
+ *
+ * Protocol-agnostic: works with Home Assistant, ONVIF, RTSP, etc.
+ *
+ * @example
+ * ```typescript
+ * const camera = device.getFeature<CameraFeature>('camera');
+ * if (camera) {
+ *   const snapshot = await camera.getSnapshot();
+ *   const streamUrl = await camera.getStreamUrl();
+ * }
+ * ```
+ */
+export class CameraFeature extends Feature {
+    type = 'camera';
+    protocol;
+    /** Entity ID (e.g., "camera.front_door") */
+    entityId;
+    /** Capabilities */
+    capabilities;
+    /** Current state */
+    _isRecording = false;
+    _isStreaming = false;
+    _motionDetected = false;
+    /** Protocol client for the camera */
+    protocolClient;
+    constructor(device, port, options) {
+        super(device, port, options);
+        this.protocol = options.protocol;
+        this.entityId = options.entityId;
+        this.protocolClient = options.protocolClient;
+        this.capabilities = {
+            supportsStream: options.capabilities?.supportsStream ?? true,
+            supportsPtz: options.capabilities?.supportsPtz ?? false,
+            supportsSnapshot: options.capabilities?.supportsSnapshot ?? true,
+            supportsMotionDetection: options.capabilities?.supportsMotionDetection ?? false,
+            frontendStreamType: options.capabilities?.frontendStreamType,
+            streamUrl: options.capabilities?.streamUrl,
+        };
+    }
+    // ============================================================================
+    // Properties
+    // ============================================================================
+    /**
+     * Check if recording (cached)
+     */
+    get isRecording() {
+        return this._isRecording;
+    }
+    /**
+     * Check if streaming (cached)
+     */
+    get isStreaming() {
+        return this._isStreaming;
+    }
+    /**
+     * Check if motion detected (cached)
+     */
+    get motionDetected() {
+        return this._motionDetected;
+    }
+    // ============================================================================
+    // 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
+    }
+    // ============================================================================
+    // Camera Access
+    // ============================================================================
+    /**
+     * Get a snapshot image from the camera
+     * @returns Buffer containing image data
+     */
+    async getSnapshot() {
+        if (!this.capabilities.supportsSnapshot) {
+            throw new Error('Camera does not support snapshots');
+        }
+        return this.protocolClient.getSnapshot(this.entityId);
+    }
+    /**
+     * Get snapshot URL
+     * @returns URL for the snapshot image
+     */
+    async getSnapshotUrl() {
+        if (!this.capabilities.supportsSnapshot) {
+            throw new Error('Camera does not support snapshots');
+        }
+        return this.protocolClient.getSnapshotUrl(this.entityId);
+    }
+    /**
+     * Get stream URL
+     * @returns URL for the video stream
+     */
+    async getStreamUrl() {
+        if (!this.capabilities.supportsStream) {
+            throw new Error('Camera does not support streaming');
+        }
+        return this.protocolClient.getStreamUrl(this.entityId);
+    }
+    /**
+     * Get current state as object
+     */
+    getState() {
+        return {
+            isRecording: this._isRecording,
+            isStreaming: this._isStreaming,
+            motionDetected: this._motionDetected,
+        };
+    }
+    /**
+     * 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._isRecording = state.isRecording;
+        this._isStreaming = state.isStreaming;
+        this._motionDetected = state.motionDetected;
+    }
+    // ============================================================================
+    // Feature Info
+    // ============================================================================
+    getFeatureInfo() {
+        return {
+            ...this.getBaseFeatureInfo(),
+            type: 'camera',
+            protocol: this.protocol,
+            capabilities: this.capabilities,
+            currentState: this.getState(),
+        };
+    }
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiZmVhdHVyZS5jYW1lcmEuanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi90cy9mZWF0dXJlcy9mZWF0dXJlLmNhbWVyYS50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFBQTs7O0dBR0c7QUFFSCxPQUFPLEVBQUUsT0FBTyxFQUF5QixNQUFNLHVCQUF1QixDQUFDO0FBd0J2RTs7Ozs7Ozs7Ozs7OztHQWFHO0FBQ0gsTUFBTSxPQUFPLGFBQWMsU0FBUSxPQUFPO0lBQ3hCLElBQUksR0FBRyxRQUFpQixDQUFDO0lBQ3pCLFFBQVEsQ0FBa0I7SUFFMUMsNENBQTRDO0lBQzVCLFFBQVEsQ0FBUztJQUVqQyxtQkFBbUI7SUFDSCxZQUFZLENBQXNCO0lBRWxELG9CQUFvQjtJQUNWLFlBQVksR0FBWSxLQUFLLENBQUM7SUFDOUIsWUFBWSxHQUFZLEtBQUssQ0FBQztJQUM5QixlQUFlLEdBQVksS0FBSyxDQUFDO0lBRTNDLHFDQUFxQztJQUM3QixjQUFjLENBQXdCO0lBRTlDLFlBQ0UsTUFBd0IsRUFDeEIsSUFBWSxFQUNaLE9BQThCO1FBRTlCLEtBQUssQ0FBQyxNQUFNLEVBQUUsSUFBSSxFQUFFLE9BQU8sQ0FBQyxDQUFDO1FBQzdCLElBQUksQ0FBQyxRQUFRLEdBQUcsT0FBTyxDQUFDLFFBQVEsQ0FBQztRQUNqQyxJQUFJLENBQUMsUUFBUSxHQUFHLE9BQU8sQ0FBQyxRQUFRLENBQUM7UUFDakMsSUFBSSxDQUFDLGNBQWMsR0FBRyxPQUFPLENBQUMsY0FBYyxDQUFDO1FBRTdDLElBQUksQ0FBQyxZQUFZLEdBQUc7WUFDbEIsY0FBYyxFQUFFLE9BQU8sQ0FBQyxZQUFZLEVBQUUsY0FBYyxJQUFJLElBQUk7WUFDNUQsV0FBVyxFQUFFLE9BQU8sQ0FBQyxZQUFZLEVBQUUsV0FBVyxJQUFJLEtBQUs7WUFDdkQsZ0JBQWdCLEVBQUUsT0FBTyxDQUFDLFlBQVksRUFBRSxnQkFBZ0IsSUFBSSxJQUFJO1lBQ2hFLHVCQUF1QixFQUFFLE9BQU8sQ0FBQyxZ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

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

@@ -0,0 +1,174 @@
+/**
+ * Climate Feature
+ * Provides control for thermostats and HVAC systems
+ */
+import { Feature, type TDeviceReference } from './feature.abstract.js';
+import type { IFeatureOptions } from '../interfaces/feature.interfaces.js';
+import type { TClimateProtocol, THvacMode, THvacAction, IClimateCapabilities, IClimateState, IClimateFeatureInfo, IClimateProtocolClient } from '../interfaces/smarthome.interfaces.js';
+/**
+ * Options for creating a ClimateFeature
+ */
+export interface IClimateFeatureOptions extends IFeatureOptions {
+    /** Protocol type */
+    protocol: TClimateProtocol;
+    /** Entity ID (for Home Assistant) */
+    entityId: string;
+    /** Protocol client for controlling the climate device */
+    protocolClient: IClimateProtocolClient;
+    /** Climate capabilities */
+    capabilities?: Partial<IClimateCapabilities>;
+}
+/**
+ * Climate Feature - thermostat and HVAC control
+ *
+ * Protocol-agnostic: works with Home Assistant, Nest, Ecobee, MQTT, etc.
+ *
+ * @example
+ * ```typescript
+ * const climate = device.getFeature<ClimateFeature>('climate');
+ * if (climate) {
+ *   await climate.setHvacMode('heat');
+ *   await climate.setTargetTemp(21);
+ *   console.log(`Current: ${climate.currentTemp}°C, Target: ${climate.targetTemp}°C`);
+ * }
+ * ```
+ */
+export declare class ClimateFeature extends Feature {
+    readonly type: "climate";
+    readonly protocol: TClimateProtocol;
+    /** Entity ID (e.g., "climate.living_room") */
+    readonly entityId: string;
+    /** Capabilities */
+    readonly capabilities: IClimateCapabilities;
+    /** Current state */
+    protected _currentTemp?: number;
+    protected _targetTemp?: number;
+    protected _targetTempHigh?: number;
+    protected _targetTempLow?: number;
+    protected _hvacMode: THvacMode;
+    protected _hvacAction?: THvacAction;
+    protected _presetMode?: string;
+    protected _fanMode?: string;
+    protected _swingMode?: string;
+    protected _humidity?: number;
+    protected _targetHumidity?: number;
+    protected _auxHeat?: boolean;
+    /** Protocol client for controlling the climate device */
+    private protocolClient;
+    constructor(device: TDeviceReference, port: number, options: IClimateFeatureOptions);
+    /**
+     * Get current temperature (cached)
+     */
+    get currentTemp(): number | undefined;
+    /**
+     * Get target temperature (cached)
+     */
+    get targetTemp(): number | undefined;
+    /**
+     * Get target temperature high (for heat_cool mode, cached)
+     */
+    get targetTempHigh(): number | undefined;
+    /**
+     * Get target temperature low (for heat_cool mode, cached)
+     */
+    get targetTempLow(): number | undefined;
+    /**
+     * Get current HVAC mode (cached)
+     */
+    get hvacMode(): THvacMode;
+    /**
+     * Get current HVAC action (cached)
+     */
+    get hvacAction(): THvacAction | undefined;
+    /**
+     * Get current preset mode (cached)
+     */
+    get presetMode(): string | undefined;
+    /**
+     * Get current fan mode (cached)
+     */
+    get fanMode(): string | undefined;
+    /**
+     * Get current swing mode (cached)
+     */
+    get swingMode(): string | undefined;
+    /**
+     * Get current humidity (cached)
+     */
+    get humidity(): number | undefined;
+    /**
+     * Get target humidity (cached)
+     */
+    get targetHumidity(): number | undefined;
+    /**
+     * Get aux heat state (cached)
+     */
+    get auxHeat(): boolean | undefined;
+    /**
+     * Get available HVAC modes
+     */
+    get hvacModes(): THvacMode[];
+    /**
+     * Get available preset modes
+     */
+    get presetModes(): string[] | undefined;
+    /**
+     * Get available fan modes
+     */
+    get fanModes(): string[] | undefined;
+    protected doConnect(): Promise<void>;
+    protected doDisconnect(): Promise<void>;
+    /**
+     * Set HVAC mode
+     * @param mode HVAC mode (off, heat, cool, etc.)
+     */
+    setHvacMode(mode: THvacMode): Promise<void>;
+    /**
+     * Set target temperature
+     * @param temp Target temperature
+     */
+    setTargetTemp(temp: number): Promise<void>;
+    /**
+     * Set target temperature range (for heat_cool mode)
+     * @param low Low temperature
+     * @param high High temperature
+     */
+    setTargetTempRange(low: number, high: number): Promise<void>;
+    /**
+     * Set preset mode
+     * @param preset Preset mode name
+     */
+    setPresetMode(preset: string): Promise<void>;
+    /**
+     * Set fan mode
+     * @param mode Fan mode name
+     */
+    setFanMode(mode: string): Promise<void>;
+    /**
+     * Set swing mode
+     * @param mode Swing mode name
+     */
+    setSwingMode(mode: string): Promise<void>;
+    /**
+     * Set aux heat
+     * @param enabled Whether aux heat is enabled
+     */
+    setAuxHeat(enabled: boolean): Promise<void>;
+    /**
+     * Get current state as object
+     */
+    getState(): IClimateState;
+    /**
+     * Refresh state from the device
+     */
+    refreshState(): Promise<IClimateState>;
+    /**
+     * Update state from external source
+     */
+    updateState(state: IClimateState): void;
+    /**
+     * Internal state update
+     */
+    private updateStateInternal;
+    getFeatureInfo(): IClimateFeatureInfo;
+}