@ecobridge.xyz/devicemanager 3.0.2

package/dist_ts/features/feature.light.js

@@ -0,0 +1,296 @@
+/**
+ * Light Feature
+ * Provides control for smart lights (brightness, color, effects)
+ */
+import { Feature } from './feature.abstract.js';
+/**
+ * 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 class LightFeature extends Feature {
+    type = 'light';
+    protocol;
+    /** Entity ID (e.g., "light.living_room") */
+    entityId;
+    /** Capabilities */
+    capabilities;
+    /** Current state */
+    _isOn = false;
+    _brightness;
+    _colorTemp;
+    _colorTempMireds;
+    _rgbColor;
+    _hsColor;
+    _xyColor;
+    _effect;
+    /** Protocol client for controlling the light */
+    protocolClient;
+    constructor(device, port, options) {
+        super(device, port, options);
+        this.protocol = options.protocol;
+        this.entityId = options.entityId;
+        this.protocolClient = options.protocolClient;
+        // Set capabilities with defaults
+        this.capabilities = {
+            supportsBrightness: options.capabilities?.supportsBrightness ?? false,
+            supportsColorTemp: options.capabilities?.supportsColorTemp ?? false,
+            supportsRgb: options.capabilities?.supportsRgb ?? false,
+            supportsHs: options.capabilities?.supportsHs ?? false,
+            supportsXy: options.capabilities?.supportsXy ?? false,
+            supportsEffects: options.capabilities?.supportsEffects ?? false,
+            supportsTransition: options.capabilities?.supportsTransition ?? true,
+            effects: options.capabilities?.effects,
+            minMireds: options.capabilities?.minMireds,
+            maxMireds: options.capabilities?.maxMireds,
+            minColorTempKelvin: options.capabilities?.minColorTempKelvin,
+            maxColorTempKelvin: options.capabilities?.maxColorTempKelvin,
+        };
+    }
+    // ============================================================================
+    // Properties
+    // ============================================================================
+    /**
+     * Get current on/off state (cached)
+     */
+    get isOn() {
+        return this._isOn;
+    }
+    /**
+     * Get current brightness 0-255 (cached)
+     */
+    get brightness() {
+        return this._brightness;
+    }
+    /**
+     * Get current color temperature in Kelvin (cached)
+     */
+    get colorTemp() {
+        return this._colorTemp;
+    }
+    /**
+     * Get current color temperature in Mireds (cached)
+     */
+    get colorTempMireds() {
+        return this._colorTempMireds;
+    }
+    /**
+     * Get current RGB color (cached)
+     */
+    get rgbColor() {
+        return this._rgbColor;
+    }
+    /**
+     * Get current HS color [hue 0-360, saturation 0-100] (cached)
+     */
+    get hsColor() {
+        return this._hsColor;
+    }
+    /**
+     * Get current XY color (cached)
+     */
+    get xyColor() {
+        return this._xyColor;
+    }
+    /**
+     * Get current effect (cached)
+     */
+    get effect() {
+        return this._effect;
+    }
+    /**
+     * Get available effects
+     */
+    get effects() {
+        return this.capabilities.effects;
+    }
+    // ============================================================================
+    // 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
+    }
+    // ============================================================================
+    // Light Control
+    // ============================================================================
+    /**
+     * Turn on the light
+     * @param options Optional settings to apply when turning on
+     */
+    async turnOn(options) {
+        await this.protocolClient.turnOn(this.entityId, options);
+        this._isOn = true;
+        if (options?.brightness !== undefined) {
+            this._brightness = options.brightness;
+        }
+        if (options?.colorTemp !== undefined) {
+            this._colorTemp = options.colorTemp;
+        }
+        if (options?.rgb !== undefined) {
+            this._rgbColor = options.rgb;
+        }
+        this.emit('state:changed', this.getState());
+    }
+    /**
+     * Turn off the light
+     * @param options Optional transition time
+     */
+    async turnOff(options) {
+        await this.protocolClient.turnOff(this.entityId, options);
+        this._isOn = false;
+        this.emit('state:changed', this.getState());
+    }
+    /**
+     * Toggle the light
+     */
+    async toggle() {
+        await this.protocolClient.toggle(this.entityId);
+        this._isOn = !this._isOn;
+        this.emit('state:changed', this.getState());
+    }
+    /**
+     * Set brightness level
+     * @param brightness Brightness 0-255
+     * @param transition Optional transition time in seconds
+     */
+    async setBrightness(brightness, transition) {
+        if (!this.capabilities.supportsBrightness) {
+            throw new Error('Light does not support brightness control');
+        }
+        const clamped = Math.max(0, Math.min(255, Math.round(brightness)));
+        await this.protocolClient.setBrightness(this.entityId, clamped, transition);
+        this._brightness = clamped;
+        if (clamped > 0) {
+            this._isOn = true;
+        }
+        this.emit('state:changed', this.getState());
+    }
+    /**
+     * Set color temperature in Kelvin
+     * @param kelvin Color temperature in Kelvin (e.g., 2700 warm, 6500 cool)
+     * @param transition Optional transition time in seconds
+     */
+    async setColorTemp(kelvin, transition) {
+        if (!this.capabilities.supportsColorTemp) {
+            throw new Error('Light does not support color temperature');
+        }
+        // Clamp to supported range if available
+        let clamped = kelvin;
+        if (this.capabilities.minColorTempKelvin && this.capabilities.maxColorTempKelvin) {
+            clamped = Math.max(this.capabilities.minColorTempKelvin, Math.min(this.capabilities.maxColorTempKelvin, kelvin));
+        }
+        await this.protocolClient.setColorTemp(this.entityId, clamped, transition);
+        this._colorTemp = clamped;
+        this._colorTempMireds = Math.round(1000000 / clamped);
+        this._isOn = true;
+        this.emit('state:changed', this.getState());
+    }
+    /**
+     * 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
+     */
+    async setRgbColor(r, g, b, transition) {
+        if (!this.capabilities.supportsRgb) {
+            throw new Error('Light does not support RGB color');
+        }
+        const clampedR = Math.max(0, Math.min(255, Math.round(r)));
+        const clampedG = Math.max(0, Math.min(255, Math.round(g)));
+        const clampedB = Math.max(0, Math.min(255, Math.round(b)));
+        await this.protocolClient.setRgbColor(this.entityId, clampedR, clampedG, clampedB, transition);
+        this._rgbColor = [clampedR, clampedG, clampedB];
+        this._isOn = true;
+        this.emit('state:changed', this.getState());
+    }
+    /**
+     * Set light effect
+     * @param effect Effect name from available effects
+     */
+    async setEffect(effect) {
+        if (!this.capabilities.supportsEffects) {
+            throw new Error('Light does not support effects');
+        }
+        await this.protocolClient.setEffect(this.entityId, effect);
+        this._effect = effect;
+        this._isOn = true;
+        this.emit('state:changed', this.getState());
+    }
+    /**
+     * Get current state as object
+     */
+    getState() {
+        return {
+            isOn: this._isOn,
+            brightness: this._brightness,
+            colorTemp: this._colorTemp,
+            colorTempMireds: this._colorTempMireds,
+            rgbColor: this._rgbColor,
+            hsColor: this._hsColor,
+            xyColor: this._xyColor,
+            effect: this._effect,
+        };
+    }
+    /**
+     * 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._isOn = state.isOn;
+        this._brightness = state.brightness;
+        this._colorTemp = state.colorTemp;
+        this._colorTempMireds = state.colorTempMireds;
+        this._rgbColor = state.rgbColor;
+        this._hsColor = state.hsColor;
+        this._xyColor = state.xyColor;
+        this._effect = state.effect;
+    }
+    // ============================================================================
+    // Feature Info
+    // ============================================================================
+    getFeatureInfo() {
+        return {
+            ...this.getBaseFeatureInfo(),
+            type: 'light',
+            protocol: this.protocol,
+            capabilities: this.capabilities,
+            currentState: this.getState(),
+        };
+    }
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiZmVhdHVyZS5saWdodC5qcyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uL3RzL2ZlYXR1cmVzL2ZlYXR1cmUubGlnaHQudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBQUE7OztHQUdHO0FBRUgsT0FBTyxFQUFFLE9BQU8sRUFBeUIsTUFBTSx1QkFBdUIsQ0FBQztBQXdCdkU7Ozs7Ozs7Ozs7Ozs7O0dBY0c7QUFDSCxNQUFNLE9BQU8sWUFBYSxTQUFRLE9BQU87SUFDdkIsSUFBSSxHQUFHLE9BQWdCLENBQUM7SUFDeEIsUUFBUSxDQUFpQjtJQUV6Qyw0Q0FBNEM7SUFDNUIsUUFBUSxDQUFTO0lBRWpDLG1CQUFtQjtJQUNILFlBQVksQ0FBcUI7SUFFakQsb0JBQW9CO0lBQ1YsS0FBSyxHQUFZLEtBQUssQ0FBQztJQUN2QixXQUFXLENBQVU7SUFDckIsVUFBVSxDQUFVO0lBQ3BCLGdCQUFnQixDQUFVO0lBQzFCLFNBQVMsQ0FBNEI7SUFDckMsUUFBUSxDQUFvQjtJQUM1QixRQUFRLENBQW9CO0lBQzVCLE9BQU8sQ0FBVTtJQUUzQixnREFBZ0Q7SUFDeEMsY0FBYyxDQUF1QjtJQUU3QyxZQUNFLE1BQXdCLEVBQ3hCLElBQVksRUFDWixPQUE2QjtRQUU3QixLQUFLLENBQUMsTUFBTSxFQUFFLElBQUksRUFBRSxPQUFPLENBQUMsQ0FBQztRQUM3QixJQUFJLENBQUMsUUFBUSxHQUFHLE9BQU8sQ0FBQyxRQUFRLENBQUM7UUFDakMsSUFBSSxDQUFDLFFBQVEsR0FBRyxPQUFPLENBQUMsUUFBUSxDQUFDO1FBQ2pDLElBQUksQ0FBQyxjQUFjLEdBQUcsT0FBTyxDQUFDLGNBQWMsQ0FBQztRQUU3QyxpQ0FBaUM7UUFDakMsSUFBSSxDQUFDLFlBQVksR0FBRztZQUNsQixrQkFBa0IsRUFBRSxPQUFPLENBQUMsWUFBWSxFQUFFLGtCQUFrQixJQUFJLEtBQUs7WUFDckUsaUJBQWlCLEVBQUUsT0FBTyxDQUFDLFlBQVksRUFBRSxpQkFBaUIsSUFBSSxLQUFL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

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

@@ -0,0 +1,103 @@
+/**
+ * Lock Feature
+ * Provides control for smart locks
+ */
+import { Feature, type TDeviceReference } from './feature.abstract.js';
+import type { IFeatureOptions } from '../interfaces/feature.interfaces.js';
+import type { TLockProtocol, TLockState, ILockCapabilities, ILockStateInfo, ILockFeatureInfo, ILockProtocolClient } from '../interfaces/smarthome.interfaces.js';
+/**
+ * Options for creating a LockFeature
+ */
+export interface ILockFeatureOptions extends IFeatureOptions {
+    /** Protocol type */
+    protocol: TLockProtocol;
+    /** Entity ID (for Home Assistant) */
+    entityId: string;
+    /** Protocol client for controlling the lock */
+    protocolClient: ILockProtocolClient;
+    /** Whether the lock supports physical open */
+    supportsOpen?: boolean;
+}
+/**
+ * Lock Feature - control for smart locks
+ *
+ * Protocol-agnostic: works with Home Assistant, MQTT, August, Yale, etc.
+ *
+ * @example
+ * ```typescript
+ * const lock = device.getFeature<LockFeature>('lock');
+ * if (lock) {
+ *   await lock.lock();
+ *   console.log(`Lock is ${lock.isLocked ? 'locked' : 'unlocked'}`);
+ * }
+ * ```
+ */
+export declare class LockFeature extends Feature {
+    readonly type: "lock";
+    readonly protocol: TLockProtocol;
+    /** Entity ID (e.g., "lock.front_door") */
+    readonly entityId: string;
+    /** Capabilities */
+    readonly capabilities: ILockCapabilities;
+    /** Current state */
+    protected _lockState: TLockState;
+    protected _isLocked: boolean;
+    /** Protocol client for controlling the lock */
+    private protocolClient;
+    constructor(device: TDeviceReference, port: number, options: ILockFeatureOptions);
+    /**
+     * Get current lock state (cached)
+     */
+    get lockState(): TLockState;
+    /**
+     * Check if locked (cached)
+     */
+    get isLocked(): boolean;
+    /**
+     * Check if unlocked
+     */
+    get isUnlocked(): boolean;
+    /**
+     * Check if currently locking
+     */
+    get isLocking(): boolean;
+    /**
+     * Check if currently unlocking
+     */
+    get isUnlocking(): boolean;
+    /**
+     * Check if jammed
+     */
+    get isJammed(): boolean;
+    protected doConnect(): Promise<void>;
+    protected doDisconnect(): Promise<void>;
+    /**
+     * Lock the lock
+     */
+    lock(): Promise<void>;
+    /**
+     * Unlock the lock
+     */
+    unlock(): Promise<void>;
+    /**
+     * Open the lock (physically open the door if supported)
+     */
+    open(): Promise<void>;
+    /**
+     * Get current state as object
+     */
+    getState(): ILockStateInfo;
+    /**
+     * Refresh state from the device
+     */
+    refreshState(): Promise<ILockStateInfo>;
+    /**
+     * Update state from external source
+     */
+    updateState(state: ILockStateInfo): void;
+    /**
+     * Internal state update
+     */
+    private updateStateInternal;
+    getFeatureInfo(): ILockFeatureInfo;
+}

package/dist_ts/features/feature.lock.js

@@ -0,0 +1,170 @@
+/**
+ * Lock Feature
+ * Provides control for smart locks
+ */
+import { Feature } from './feature.abstract.js';
+/**
+ * Lock Feature - control for smart locks
+ *
+ * Protocol-agnostic: works with Home Assistant, MQTT, August, Yale, etc.
+ *
+ * @example
+ * ```typescript
+ * const lock = device.getFeature<LockFeature>('lock');
+ * if (lock) {
+ *   await lock.lock();
+ *   console.log(`Lock is ${lock.isLocked ? 'locked' : 'unlocked'}`);
+ * }
+ * ```
+ */
+export class LockFeature extends Feature {
+    type = 'lock';
+    protocol;
+    /** Entity ID (e.g., "lock.front_door") */
+    entityId;
+    /** Capabilities */
+    capabilities;
+    /** Current state */
+    _lockState = 'unknown';
+    _isLocked = false;
+    /** Protocol client for controlling the lock */
+    protocolClient;
+    constructor(device, port, options) {
+        super(device, port, options);
+        this.protocol = options.protocol;
+        this.entityId = options.entityId;
+        this.protocolClient = options.protocolClient;
+        this.capabilities = {
+            supportsOpen: options.supportsOpen ?? false,
+        };
+    }
+    // ============================================================================
+    // Properties
+    // ============================================================================
+    /**
+     * Get current lock state (cached)
+     */
+    get lockState() {
+        return this._lockState;
+    }
+    /**
+     * Check if locked (cached)
+     */
+    get isLocked() {
+        return this._isLocked;
+    }
+    /**
+     * Check if unlocked
+     */
+    get isUnlocked() {
+        return this._lockState === 'unlocked';
+    }
+    /**
+     * Check if currently locking
+     */
+    get isLocking() {
+        return this._lockState === 'locking';
+    }
+    /**
+     * Check if currently unlocking
+     */
+    get isUnlocking() {
+        return this._lockState === 'unlocking';
+    }
+    /**
+     * Check if jammed
+     */
+    get isJammed() {
+        return this._lockState === 'jammed';
+    }
+    // ============================================================================
+    // 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
+    }
+    // ============================================================================
+    // Lock Control
+    // ============================================================================
+    /**
+     * Lock the lock
+     */
+    async lock() {
+        await this.protocolClient.lock(this.entityId);
+        this._lockState = 'locking';
+        this.emit('state:changed', this.getState());
+    }
+    /**
+     * Unlock the lock
+     */
+    async unlock() {
+        await this.protocolClient.unlock(this.entityId);
+        this._lockState = 'unlocking';
+        this.emit('state:changed', this.getState());
+    }
+    /**
+     * Open the lock (physically open the door if supported)
+     */
+    async open() {
+        if (!this.capabilities.supportsOpen) {
+            throw new Error('Lock does not support physical open');
+        }
+        await this.protocolClient.open(this.entityId);
+        this._lockState = 'unlocked';
+        this._isLocked = false;
+        this.emit('state:changed', this.getState());
+    }
+    /**
+     * Get current state as object
+     */
+    getState() {
+        return {
+            state: this._lockState,
+            isLocked: this._isLocked,
+        };
+    }
+    /**
+     * 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._lockState = state.state;
+        this._isLocked = state.isLocked;
+    }
+    // ============================================================================
+    // Feature Info
+    // ============================================================================
+    getFeatureInfo() {
+        return {
+            ...this.getBaseFeatureInfo(),
+            type: 'lock',
+            protocol: this.protocol,
+            capabilities: this.capabilities,
+            currentState: this.getState(),
+        };
+    }
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiZmVhdHVyZS5sb2NrLmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vdHMvZmVhdHVyZXMvZmVhdHVyZS5sb2NrLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQUFBOzs7R0FHRztBQUVILE9BQU8sRUFBRSxPQUFPLEVBQXlCLE1BQU0sdUJBQXVCLENBQUM7QUF5QnZFOzs7Ozs7Ozs7Ozs7O0dBYUc7QUFDSCxNQUFNLE9BQU8sV0FBWSxTQUFRLE9BQU87SUFDdEIsSUFBSSxHQUFHLE1BQWUsQ0FBQztJQUN2QixRQUFRLENBQWdCO0lBRXhDLDBDQUEwQztJQUMxQixRQUFRLENBQVM7SUFFakMsbUJBQW1CO0lBQ0gsWUFBWSxDQUFvQjtJQUVoRCxvQkFBb0I7SUFDVixVQUFVLEdBQWUsU0FBUyxDQUFDO0lBQ25DLFNBQVMsR0FBWSxLQUFLLENBQUM7SUFFckMsK0NBQStDO0lBQ3ZDLGNBQWMsQ0FBc0I7SUFFNUMsWUFDRSxNQUF3QixFQUN4QixJQUFZLEVBQ1osT0FBNEI7UUFFNUIsS0FBSyxDQUFDLE1BQU0sRUFBRSxJQUFJLEVBQUUsT0FBTyxDQUFDLENBQUM7UUFDN0IsSUFBSSxDQUFDLFFBQVEsR0FBRyxPQUFPLENBQUMsUUFBUSxDQUFDO1FBQ2pDLElBQUksQ0FBQyxRQUFRLEdBQUcsT0FBTyxDQUFDLFFBQVEsQ0FBQztRQUNqQyxJQUFJLENBQUMsY0FBYyxHQUFHLE9BQU8sQ0FBQyxjQUFjLENBQUM7UUFFN0MsSUFBSSxDQUFDLFlBQVksR0FBRztZQUNsQixZQUFZLEVBQUUsT0FBTyxDQUFDLFlBQVksSUFBSSxLQUFLO1NBQzVDLENBQUM7SUFDSixDQUFDO0lBRUQsK0VBQStFO0lBQy9FLGFBQWE7SUFDYiwrRUFBK0U7SUFFL0U7O09BRUc7SUFDSCxJQUFXLFNBQVM7UUFDbEIsT0FBTyxJQUFJLENBQUMsVUFBVSxDQUFDO0lBQ3pCLENBQUM7SUFFRDs7T0FFRztJQUNILElBQVcsUUFBUTtRQUNqQixPQUFPLElBQUksQ0FBQyxTQUFT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

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

@@ -0,0 +1,98 @@
+/**
+ * Playback Feature
+ * Provides media playback control capability
+ */
+import { Feature, type TDeviceReference } from './feature.abstract.js';
+import type { TPlaybackProtocol, TPlaybackState, ITrackInfo, IPlaybackStatus, IPlaybackFeatureInfo, IFeatureOptions } from '../interfaces/feature.interfaces.js';
+/**
+ * Options for creating a PlaybackFeature
+ */
+export interface IPlaybackFeatureOptions extends IFeatureOptions {
+    protocol: TPlaybackProtocol;
+    supportsQueue?: boolean;
+    supportsSeek?: boolean;
+    /** Protocol-specific client instance (Sonos, AirPlay, etc.) */
+    protocolClient?: unknown;
+}
+/**
+ * Playback Feature - provides media playback control
+ *
+ * Abstract feature that can be backed by different protocols (Sonos, AirPlay, Chromecast, DLNA).
+ * Concrete implementations should extend this class for protocol-specific behavior.
+ *
+ * @example
+ * ```typescript
+ * const playback = device.getFeature<PlaybackFeature>('playback');
+ * if (playback) {
+ *   await playback.play('spotify:track:123');
+ *   const status = await playback.getPlaybackStatus();
+ *   console.log(`Playing: ${status.track?.title}`);
+ * }
+ * ```
+ */
+export declare class PlaybackFeature extends Feature {
+    readonly type: "playback";
+    readonly protocol: TPlaybackProtocol;
+    supportsQueue: boolean;
+    supportsSeek: boolean;
+    protected _playbackState: TPlaybackState;
+    protected _currentTrack: ITrackInfo | null;
+    protected _position: number;
+    protected _duration: number;
+    protected protocolClient: unknown;
+    constructor(device: TDeviceReference, port: number, options: IPlaybackFeatureOptions);
+    get playbackState(): TPlaybackState;
+    get currentTrack(): ITrackInfo | null;
+    get position(): number;
+    get duration(): number;
+    get isPlaying(): boolean;
+    protected doConnect(): Promise<void>;
+    protected doDisconnect(): Promise<void>;
+    /**
+     * Start playback
+     * @param uri Optional URI to play. If not provided, resumes current playback.
+     */
+    play(uri?: string): Promise<void>;
+    /**
+     * Pause playback
+     */
+    pause(): Promise<void>;
+    /**
+     * Stop playback
+     */
+    stop(): Promise<void>;
+    /**
+     * Skip to next track
+     */
+    next(): Promise<void>;
+    /**
+     * Go to previous track
+     */
+    previous(): Promise<void>;
+    /**
+     * Seek to position
+     * @param seconds Position in seconds
+     */
+    seek(seconds: number): Promise<void>;
+    /**
+     * Get current track info
+     */
+    getCurrentTrack(): Promise<ITrackInfo | null>;
+    /**
+     * Get playback status
+     */
+    getPlaybackStatus(): Promise<IPlaybackStatus>;
+    /**
+     * Update track info (called by protocol-specific implementations)
+     */
+    protected updateTrack(track: ITrackInfo | null): void;
+    /**
+     * Update position (called by protocol-specific implementations)
+     */
+    protected updatePosition(position: number, duration: number): void;
+    getFeatureInfo(): IPlaybackFeatureInfo;
+    /**
+     * Create from discovery metadata
+     */
+    static fromDiscovery(device: TDeviceReference, port: number, protocol: TPlaybackProtocol, metadata: Record<string, unknown>): PlaybackFeature;
+}