@ecobridge.xyz/devicemanager 3.0.2

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

@@ -0,0 +1,248 @@
+import * as plugins from '../plugins.js';
+import type { IHomeAssistantInstanceConfig, IHomeAssistantEntity, IHomeAssistantConfig, IHomeAssistantLightServiceData, IHomeAssistantClimateServiceData, IHomeAssistantFanServiceData } from '../interfaces/homeassistant.interfaces.js';
+/**
+ * Home Assistant WebSocket Protocol Handler
+ * Connects to HA via WebSocket, handles authentication, state subscriptions, and service calls
+ */
+export declare class HomeAssistantProtocol extends plugins.events.EventEmitter {
+    private ws;
+    private config;
+    private messageId;
+    private pendingRequests;
+    private isAuthenticated;
+    private haConfig;
+    private reconnectAttempt;
+    private reconnectTimer;
+    private stateSubscriptionId;
+    private entityStates;
+    private intentionalDisconnect;
+    constructor(config: IHomeAssistantInstanceConfig);
+    /**
+     * Get the WebSocket URL for this HA instance
+     */
+    private get wsUrl();
+    /**
+     * Get connection state
+     */
+    get isConnected(): boolean;
+    /**
+     * Get HA config if authenticated
+     */
+    get homeAssistantConfig(): IHomeAssistantConfig | null;
+    /**
+     * Get all cached entity states
+     */
+    get entities(): Map<string, IHomeAssistantEntity>;
+    /**
+     * Connect to Home Assistant
+     */
+    connect(): Promise<void>;
+    /**
+     * Disconnect from Home Assistant
+     */
+    disconnect(): Promise<void>;
+    /**
+     * Send authentication message
+     */
+    private sendAuth;
+    /**
+     * Handle incoming messages
+     */
+    private handleMessage;
+    /**
+     * Send a request and wait for response
+     */
+    private sendRequest;
+    /**
+     * Schedule reconnection attempt
+     */
+    private scheduleReconnect;
+    /**
+     * Get HA config
+     */
+    getConfig(): Promise<IHomeAssistantConfig>;
+    /**
+     * Subscribe to state change events
+     */
+    subscribeToStateChanges(): Promise<number>;
+    /**
+     * Get all entity states
+     */
+    getStates(): Promise<IHomeAssistantEntity[]>;
+    /**
+     * Get a specific entity state
+     */
+    getState(entityId: string): Promise<IHomeAssistantEntity | null>;
+    /**
+     * Get entities by domain
+     */
+    getEntitiesByDomain(domain: string): Promise<IHomeAssistantEntity[]>;
+    /**
+     * Call a Home Assistant service
+     */
+    callService(domain: string, service: string, target?: {
+        entity_id?: string | string[];
+        device_id?: string | string[];
+        area_id?: string | string[];
+    }, serviceData?: Record<string, unknown>): Promise<void>;
+    /**
+     * Turn on an entity
+     */
+    turnOn(entityId: string, data?: Record<string, unknown>): Promise<void>;
+    /**
+     * Turn off an entity
+     */
+    turnOff(entityId: string): Promise<void>;
+    /**
+     * Toggle an entity
+     */
+    toggle(entityId: string): Promise<void>;
+    /**
+     * Control a light
+     */
+    lightTurnOn(entityId: string, options?: IHomeAssistantLightServiceData): Promise<void>;
+    lightTurnOff(entityId: string, options?: {
+        transition?: number;
+    }): Promise<void>;
+    lightToggle(entityId: string, options?: IHomeAssistantLightServiceData): Promise<void>;
+    /**
+     * Set HVAC mode
+     */
+    climateSetHvacMode(entityId: string, hvacMode: string): Promise<void>;
+    /**
+     * Set target temperature
+     */
+    climateSetTemperature(entityId: string, options: IHomeAssistantClimateServiceData): Promise<void>;
+    /**
+     * Set fan mode
+     */
+    climateSetFanMode(entityId: string, fanMode: string): Promise<void>;
+    /**
+     * Set preset mode
+     */
+    climateSetPresetMode(entityId: string, presetMode: string): Promise<void>;
+    /**
+     * Set swing mode
+     */
+    climateSetSwingMode(entityId: string, swingMode: string): Promise<void>;
+    /**
+     * Set aux heat
+     */
+    climateSetAuxHeat(entityId: string, auxHeat: boolean): Promise<void>;
+    /**
+     * Open cover
+     */
+    coverOpen(entityId: string): Promise<void>;
+    /**
+     * Close cover
+     */
+    coverClose(entityId: string): Promise<void>;
+    /**
+     * Stop cover
+     */
+    coverStop(entityId: string): Promise<void>;
+    /**
+     * Set cover position
+     */
+    coverSetPosition(entityId: string, position: number): Promise<void>;
+    /**
+     * Set cover tilt position
+     */
+    coverSetTiltPosition(entityId: string, tiltPosition: number): Promise<void>;
+    /**
+     * Turn on fan
+     */
+    fanTurnOn(entityId: string, options?: IHomeAssistantFanServiceData): Promise<void>;
+    /**
+     * Turn off fan
+     */
+    fanTurnOff(entityId: string): Promise<void>;
+    /**
+     * Set fan percentage
+     */
+    fanSetPercentage(entityId: string, percentage: number): Promise<void>;
+    /**
+     * Set fan preset mode
+     */
+    fanSetPresetMode(entityId: string, presetMode: string): Promise<void>;
+    /**
+     * Oscillate fan
+     */
+    fanOscillate(entityId: string, oscillating: boolean): Promise<void>;
+    /**
+     * Set fan direction
+     */
+    fanSetDirection(entityId: string, direction: 'forward' | 'reverse'): Promise<void>;
+    /**
+     * Lock
+     */
+    lockLock(entityId: string): Promise<void>;
+    /**
+     * Unlock
+     */
+    lockUnlock(entityId: string): Promise<void>;
+    /**
+     * Open (if supported)
+     */
+    lockOpen(entityId: string): Promise<void>;
+    /**
+     * Turn on switch
+     */
+    switchTurnOn(entityId: string): Promise<void>;
+    /**
+     * Turn off switch
+     */
+    switchTurnOff(entityId: string): Promise<void>;
+    /**
+     * Toggle switch
+     */
+    switchToggle(entityId: string): Promise<void>;
+    /**
+     * Play media
+     */
+    mediaPlayerPlay(entityId: string): Promise<void>;
+    /**
+     * Pause media
+     */
+    mediaPlayerPause(entityId: string): Promise<void>;
+    /**
+     * Stop media
+     */
+    mediaPlayerStop(entityId: string): Promise<void>;
+    /**
+     * Next track
+     */
+    mediaPlayerNext(entityId: string): Promise<void>;
+    /**
+     * Previous track
+     */
+    mediaPlayerPrevious(entityId: string): Promise<void>;
+    /**
+     * Set volume
+     */
+    mediaPlayerSetVolume(entityId: string, volumeLevel: number): Promise<void>;
+    /**
+     * Mute/unmute
+     */
+    mediaPlayerMute(entityId: string, isMuted: boolean): Promise<void>;
+    /**
+     * Seek to position
+     */
+    mediaPlayerSeek(entityId: string, position: number): Promise<void>;
+    /**
+     * Select source
+     */
+    mediaPlayerSelectSource(entityId: string, source: string): Promise<void>;
+    /**
+     * Get camera snapshot URL
+     */
+    getCameraSnapshotUrl(entityId: string): string;
+    /**
+     * Get camera stream URL
+     */
+    getCameraStreamUrl(entityId: string): string;
+    /**
+     * Probe if a Home Assistant instance is reachable
+     */
+    static probe(host: string, port?: number, secure?: boolean, timeout?: number): Promise<boolean>;
+}