@ecobridge.xyz/devicemanager 3.0.2

package/dist_ts/features/feature.playback.js

@@ -0,0 +1,191 @@
+/**
+ * Playback Feature
+ * Provides media playback control capability
+ */
+import { Feature } from './feature.abstract.js';
+/**
+ * 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 class PlaybackFeature extends Feature {
+    type = 'playback';
+    protocol;
+    // Capabilities
+    supportsQueue = true;
+    supportsSeek = true;
+    // Current state
+    _playbackState = 'stopped';
+    _currentTrack = null;
+    _position = 0;
+    _duration = 0;
+    // Protocol client (set by subclass or passed in options)
+    protocolClient = null;
+    constructor(device, port, options) {
+        super(device, port, options);
+        this.protocol = options.protocol;
+        if (options.supportsQueue !== undefined)
+            this.supportsQueue = options.supportsQueue;
+        if (options.supportsSeek !== undefined)
+            this.supportsSeek = options.supportsSeek;
+        if (options.protocolClient)
+            this.protocolClient = options.protocolClient;
+    }
+    // ============================================================================
+    // Properties
+    // ============================================================================
+    get playbackState() {
+        return this._playbackState;
+    }
+    get currentTrack() {
+        return this._currentTrack;
+    }
+    get position() {
+        return this._position;
+    }
+    get duration() {
+        return this._duration;
+    }
+    get isPlaying() {
+        return this._playbackState === 'playing';
+    }
+    // ============================================================================
+    // Connection (to be overridden by protocol-specific subclasses)
+    // ============================================================================
+    async doConnect() {
+        // Base implementation - protocol-specific subclasses should override
+        // and establish their protocol connection
+    }
+    async doDisconnect() {
+        // Base implementation - protocol-specific subclasses should override
+        this.protocolClient = null;
+    }
+    // ============================================================================
+    // Playback Control
+    // ============================================================================
+    /**
+     * Start playback
+     * @param uri Optional URI to play. If not provided, resumes current playback.
+     */
+    async play(uri) {
+        this.emit('playback:play', { uri });
+        // Protocol-specific implementation should be provided by subclass
+        this._playbackState = 'playing';
+        this.emit('playback:state:changed', this._playbackState);
+    }
+    /**
+     * Pause playback
+     */
+    async pause() {
+        this.emit('playback:pause');
+        this._playbackState = 'paused';
+        this.emit('playback:state:changed', this._playbackState);
+    }
+    /**
+     * Stop playback
+     */
+    async stop() {
+        this.emit('playback:stop');
+        this._playbackState = 'stopped';
+        this._position = 0;
+        this.emit('playback:state:changed', this._playbackState);
+    }
+    /**
+     * Skip to next track
+     */
+    async next() {
+        this.emit('playback:next');
+    }
+    /**
+     * Go to previous track
+     */
+    async previous() {
+        this.emit('playback:previous');
+    }
+    /**
+     * Seek to position
+     * @param seconds Position in seconds
+     */
+    async seek(seconds) {
+        if (!this.supportsSeek) {
+            throw new Error('Seek not supported');
+        }
+        this._position = seconds;
+        this.emit('playback:seek', seconds);
+    }
+    // ============================================================================
+    // Status
+    // ============================================================================
+    /**
+     * Get current track info
+     */
+    async getCurrentTrack() {
+        return this._currentTrack;
+    }
+    /**
+     * Get playback status
+     */
+    async getPlaybackStatus() {
+        return {
+            state: this._playbackState,
+            position: this._position,
+            duration: this._duration,
+            track: this._currentTrack ?? undefined,
+        };
+    }
+    /**
+     * Update track info (called by protocol-specific implementations)
+     */
+    updateTrack(track) {
+        const oldTrack = this._currentTrack;
+        this._currentTrack = track;
+        if (track?.title !== oldTrack?.title || track?.uri !== oldTrack?.uri) {
+            this.emit('playback:track:changed', track);
+        }
+    }
+    /**
+     * Update position (called by protocol-specific implementations)
+     */
+    updatePosition(position, duration) {
+        this._position = position;
+        this._duration = duration;
+        this.emit('playback:position:changed', { position, duration });
+    }
+    // ============================================================================
+    // Serialization
+    // ============================================================================
+    getFeatureInfo() {
+        return {
+            ...this.getBaseFeatureInfo(),
+            type: 'playback',
+            protocol: this.protocol,
+            supportsQueue: this.supportsQueue,
+            supportsSeek: this.supportsSeek,
+        };
+    }
+    // ============================================================================
+    // Static Factory
+    // ============================================================================
+    /**
+     * Create from discovery metadata
+     */
+    static fromDiscovery(device, port, protocol, metadata) {
+        return new PlaybackFeature(device, port, {
+            protocol,
+            supportsQueue: metadata.supportsQueue ?? true,
+            supportsSeek: metadata.supportsSeek ?? true,
+        });
+    }
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiZmVhdHVyZS5wbGF5YmFjay5qcyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uL3RzL2ZlYXR1cmVzL2ZlYXR1cmUucGxheWJhY2sudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBQUE7OztHQUdHO0FBRUgsT0FBTyxFQUFFLE9BQU8sRUFBeUIsTUFBTSx1QkFBdUIsQ0FBQztBQXFCdkU7Ozs7Ozs7Ozs7Ozs7OztHQWVHO0FBQ0gsTUFBTSxPQUFPLGVBQWdCLFNBQVEsT0FBTztJQUMxQixJQUFJLEdBQUcsVUFBbUIsQ0FBQztJQUMzQixRQUFRLENBQW9CO0lBRTVDLGVBQWU7SUFDUixhQUFhLEdBQVksSUFBSSxDQUFDO0lBQzlCLFlBQVksR0FBWSxJQUFJLENBQUM7SUFFcEMsZ0JBQWdCO0lBQ04sY0FBYyxHQUFtQixTQUFTLENBQUM7SUFDM0MsYUFBYSxHQUFzQixJQUFJLENBQUM7SUFDeEMsU0FBUyxHQUFXLENBQUMsQ0FBQztJQUN0QixTQUFTLEdBQVcsQ0FBQyxDQUFDO0lBRWhDLHlEQUF5RDtJQUMvQyxjQUFjLEdBQVksSUFBSSxDQUFDO0lBRXpDLFlBQ0UsTUFBd0IsRUFDeEIsSUFBWSxFQUNaLE9BQWdDO1FBRWhDLEtBQUssQ0FBQyxNQUFNLEVBQUUsSUFBSSxFQUFFLE9BQU8sQ0FBQyxDQUFDO1FBQzdCLElBQUksQ0FBQyxRQUFRLEdBQUcsT0FBTyxDQUFDLFFBQVEsQ0FBQztRQUNqQyxJQUFJLE9BQU8sQ0FBQyxhQUFhLEtBQUssU0FBUztZQUFFLElBQUksQ0FBQyxhQUFhLEdBQUcsT0FBTyxDQUFDLGFBQWEsQ0FBQztRQUNwRixJQUFJLE9BQU8sQ0FBQyxZQUFZLEtBQUssU0FBUztZQUFFLElBQUksQ0FBQyxZQUFZLEdBQUcsT0FBTyxDQUFDLFlBQVksQ0FBQztRQUNqRixJQUFJLE9BQU8sQ0FBQyxjQUFjO1lBQUUsSUFBSSxDQUFDLGNBQWMsR0FBRyxPQUFPLENBQUMsY0FBYyxDQUFDO0lBQzNFLENBQUM7SUFFRCwrRUFBK0U7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

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

@@ -0,0 +1,79 @@
+/**
+ * Power Feature
+ * Provides UPS/power monitoring and control capability
+ */
+import { Feature, type TDeviceReference } from './feature.abstract.js';
+import type { TPowerProtocol, TPowerStatus, IBatteryInfo, IPowerInfo, IPowerFeatureInfo, IFeatureOptions } from '../interfaces/feature.interfaces.js';
+/**
+ * Options for creating a PowerFeature
+ */
+export interface IPowerFeatureOptions extends IFeatureOptions {
+    protocol: TPowerProtocol;
+    hasBattery?: boolean;
+    supportsShutdown?: boolean;
+    supportsTest?: boolean;
+    /** For NUT protocol: UPS name */
+    upsName?: string;
+    /** For SNMP: community string */
+    community?: string;
+}
+/**
+ * Power Feature - provides UPS/power monitoring and control
+ *
+ * Supports NUT (Network UPS Tools) and SNMP protocols for monitoring
+ * UPS devices and smart power equipment.
+ *
+ * @example
+ * ```typescript
+ * const power = device.getFeature<PowerFeature>('power');
+ * if (power) {
+ *   const status = await power.getStatus();
+ *   const battery = await power.getBatteryInfo();
+ *   console.log(`Status: ${status}, Battery: ${battery.charge}%`);
+ * }
+ * ```
+ */
+export declare class PowerFeature extends Feature {
+    readonly type: "power";
+    readonly protocol: TPowerProtocol;
+    readonly upsName: string;
+    readonly community: string;
+    readonly hasBattery: boolean;
+    readonly supportsShutdown: boolean;
+    readonly supportsTest: boolean;
+    protected _status: TPowerStatus;
+    protected _batteryCharge: number;
+    protected _batteryRuntime: number;
+    protected _load: number;
+    constructor(device: TDeviceReference, port: number, options: IPowerFeatureOptions);
+    get powerStatus(): TPowerStatus;
+    get batteryCharge(): number;
+    get batteryRuntime(): number;
+    get load(): number;
+    protected doConnect(): Promise<void>;
+    protected doDisconnect(): Promise<void>;
+    /**
+     * Get current power status
+     */
+    getStatus(): Promise<TPowerStatus>;
+    /**
+     * Get battery information
+     */
+    getBatteryInfo(): Promise<IBatteryInfo>;
+    /**
+     * Get power information
+     */
+    getPowerInfo(): Promise<IPowerInfo>;
+    /**
+     * Initiate shutdown
+     */
+    shutdown(delay?: number): Promise<void>;
+    /**
+     * Start battery test
+     */
+    testBattery(): Promise<void>;
+    protected updateStatus(status: TPowerStatus): void;
+    protected updateBattery(charge: number, runtime: number): void;
+    getFeatureInfo(): IPowerFeatureInfo;
+    static fromDiscovery(device: TDeviceReference, port: number, protocol: TPowerProtocol, metadata: Record<string, unknown>): PowerFeature;
+}

package/dist_ts/features/feature.power.js

@@ -0,0 +1,173 @@
+/**
+ * Power Feature
+ * Provides UPS/power monitoring and control capability
+ */
+import { Feature } from './feature.abstract.js';
+/**
+ * Power Feature - provides UPS/power monitoring and control
+ *
+ * Supports NUT (Network UPS Tools) and SNMP protocols for monitoring
+ * UPS devices and smart power equipment.
+ *
+ * @example
+ * ```typescript
+ * const power = device.getFeature<PowerFeature>('power');
+ * if (power) {
+ *   const status = await power.getStatus();
+ *   const battery = await power.getBatteryInfo();
+ *   console.log(`Status: ${status}, Battery: ${battery.charge}%`);
+ * }
+ * ```
+ */
+export class PowerFeature extends Feature {
+    type = 'power';
+    protocol;
+    // Configuration
+    upsName;
+    community;
+    // Capabilities
+    hasBattery;
+    supportsShutdown;
+    supportsTest;
+    // Current state
+    _status = 'unknown';
+    _batteryCharge = 0;
+    _batteryRuntime = 0;
+    _load = 0;
+    constructor(device, port, options) {
+        super(device, port, options);
+        this.protocol = options.protocol;
+        this.upsName = options.upsName ?? 'ups';
+        this.community = options.community ?? 'public';
+        this.hasBattery = options.hasBattery ?? true;
+        this.supportsShutdown = options.supportsShutdown ?? false;
+        this.supportsTest = options.supportsTest ?? false;
+    }
+    // ============================================================================
+    // Properties
+    // ============================================================================
+    get powerStatus() {
+        return this._status;
+    }
+    get batteryCharge() {
+        return this._batteryCharge;
+    }
+    get batteryRuntime() {
+        return this._batteryRuntime;
+    }
+    get load() {
+        return this._load;
+    }
+    // ============================================================================
+    // Connection
+    // ============================================================================
+    async doConnect() {
+        // Protocol-specific connection would be implemented here
+        // For now, just verify the port is reachable
+    }
+    async doDisconnect() {
+        // Protocol-specific disconnection
+    }
+    // ============================================================================
+    // Status Monitoring
+    // ============================================================================
+    /**
+     * Get current power status
+     */
+    async getStatus() {
+        // Protocol-specific implementation would fetch status
+        return this._status;
+    }
+    /**
+     * Get battery information
+     */
+    async getBatteryInfo() {
+        return {
+            charge: this._batteryCharge,
+            runtime: this._batteryRuntime,
+        };
+    }
+    /**
+     * Get power information
+     */
+    async getPowerInfo() {
+        return {
+            load: this._load,
+        };
+    }
+    // ============================================================================
+    // Control Commands
+    // ============================================================================
+    /**
+     * Initiate shutdown
+     */
+    async shutdown(delay) {
+        if (!this.supportsShutdown) {
+            throw new Error('Shutdown not supported');
+        }
+        this.emit('power:shutdown', { delay });
+    }
+    /**
+     * Start battery test
+     */
+    async testBattery() {
+        if (!this.supportsTest) {
+            throw new Error('Battery test not supported');
+        }
+        this.emit('power:test:started');
+    }
+    // ============================================================================
+    // State Updates
+    // ============================================================================
+    updateStatus(status) {
+        const oldStatus = this._status;
+        this._status = status;
+        if (oldStatus !== status) {
+            this.emit('power:status:changed', { oldStatus, newStatus: status });
+            // Emit specific events
+            if (status === 'onbattery') {
+                this.emit('power:onbattery');
+            }
+            else if (status === 'online' && oldStatus === 'onbattery') {
+                this.emit('power:restored');
+            }
+            else if (status === 'lowbattery') {
+                this.emit('power:lowbattery');
+            }
+        }
+    }
+    updateBattery(charge, runtime) {
+        const oldCharge = this._batteryCharge;
+        this._batteryCharge = charge;
+        this._batteryRuntime = runtime;
+        if (oldCharge !== charge) {
+            this.emit('battery:changed', { charge, runtime });
+        }
+    }
+    // ============================================================================
+    // Serialization
+    // ============================================================================
+    getFeatureInfo() {
+        return {
+            ...this.getBaseFeatureInfo(),
+            type: 'power',
+            protocol: this.protocol,
+            hasBattery: this.hasBattery,
+            supportsShutdown: this.supportsShutdown,
+            supportsTest: this.supportsTest,
+        };
+    }
+    // ============================================================================
+    // Static Factory
+    // ============================================================================
+    static fromDiscovery(device, port, protocol, metadata) {
+        return new PowerFeature(device, port, {
+            protocol,
+            upsName: metadata.upsName,
+            hasBattery: metadata.hasBattery ?? true,
+            supportsShutdown: metadata.supportsShutdown ?? false,
+            supportsTest: metadata.supportsTest ?? false,
+        });
+    }
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiZmVhdHVyZS5wb3dlci5qcyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uL3RzL2ZlYXR1cmVzL2ZlYXR1cmUucG93ZXIudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBQUE7OztHQUdHO0FBRUgsT0FBTyxFQUFFLE9BQU8sRUFBeUIsTUFBTSx1QkFBdUIsQ0FBQztBQXdCdkU7Ozs7Ozs7Ozs7Ozs7OztHQWVHO0FBQ0gsTUFBTSxPQUFPLFlBQWEsU0FBUSxPQUFPO0lBQ3ZCLElBQUksR0FBRyxPQUFnQixDQUFDO0lBQ3hCLFFBQVEsQ0FBaUI7SUFFekMsZ0JBQWdCO0lBQ0EsT0FBTyxDQUFTO0lBQ2hCLFNBQVMsQ0FBUztJQUVsQyxlQUFlO0lBQ0MsVUFBVSxDQUFVO0lBQ3BCLGdCQUFnQixDQUFVO0lBQzFCLFlBQVksQ0FBVTtJQUV0QyxnQkFBZ0I7SUFDTixPQUFPLEdBQWlCLFNBQVMsQ0FBQztJQUNsQyxjQUFjLEdBQVcsQ0FBQyxDQUFDO0lBQzNCLGVBQWUsR0FBVyxDQUFDLENBQUM7SUFDNUIsS0FBSyxHQUFXLENBQUMsQ0FBQztJQUU1QixZQUNFLE1BQXdCLEVBQ3hCLElBQVksRUFDWixPQUE2QjtRQUU3QixLQUFLLENBQUMsTUFBTSxFQUFFLElBQUksRUFBRSxPQUFPLENBQUMsQ0FBQztRQUM3QixJQUFJLENBQUMsUUFBUSxHQUFHLE9BQU8sQ0FBQyxRQUFRLENBQUM7UUFDakMsSUFBSSxDQUFDLE9BQU8sR0FBRyxPQUFPLENBQUMsT0FBTyxJQUFJLEtBQUssQ0FBQztRQUN4QyxJQUFJLENBQUMsU0FBUyxHQUFHLE9BQU8sQ0FBQyxTQUFTLElBQUksUUFBUSxDQUFDO1FBQy9DLElBQUksQ0FBQyxVQUFVLEdBQUcsT0FBTyxDQUFDLFVBQVUsSUFBSSxJQUFJLENBQUM7UUFDN0MsSUFBSSxDQUFDLGdCQUFnQixHQUFHLE9BQU8sQ0FBQyxnQkFBZ0IsSUFBSSxLQUFLLENBQUM7UUFDMUQsSUFBSSxDQUFDLFlBQVksR0FBRyxPQUFPLENB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

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

@@ -0,0 +1,78 @@
+/**
+ * Print Feature
+ * Provides document printing capability using IPP protocol
+ */
+import { Feature, type TDeviceReference } from './feature.abstract.js';
+import type { TPrintProtocol, TPrintSides, TPrintQuality, IPrintCapabilities, IPrintOptions, IPrintJob, IPrintFeatureInfo, IFeatureOptions } from '../interfaces/feature.interfaces.js';
+/**
+ * Options for creating a PrintFeature
+ */
+export interface IPrintFeatureOptions extends IFeatureOptions {
+    protocol?: TPrintProtocol;
+    uri?: string;
+    supportsColor?: boolean;
+    supportsDuplex?: boolean;
+    supportedMediaSizes?: string[];
+    supportedMediaTypes?: string[];
+    maxCopies?: number;
+}
+/**
+ * Print Feature - provides document printing capability
+ *
+ * Wraps the IPP protocol to provide a unified printing interface.
+ *
+ * @example
+ * ```typescript
+ * const printFeature = device.getFeature<PrintFeature>('print');
+ * if (printFeature) {
+ *   await printFeature.connect();
+ *   const job = await printFeature.print(pdfBuffer, { copies: 2 });
+ *   console.log(`Print job ${job.id} created`);
+ * }
+ * ```
+ */
+export declare class PrintFeature extends Feature {
+    readonly type: "print";
+    readonly protocol: TPrintProtocol;
+    private ippClient;
+    readonly uri: string;
+    supportsColor: boolean;
+    supportsDuplex: boolean;
+    supportedMediaSizes: string[];
+    supportedMediaTypes: string[];
+    maxCopies: number;
+    supportedSides: TPrintSides[];
+    supportedQualities: TPrintQuality[];
+    constructor(device: TDeviceReference, port: number, options?: IPrintFeatureOptions);
+    protected doConnect(): Promise<void>;
+    protected doDisconnect(): Promise<void>;
+    /**
+     * Get printer capabilities
+     */
+    getCapabilities(): Promise<IPrintCapabilities>;
+    /**
+     * Print a document
+     */
+    print(data: Buffer, options?: IPrintOptions): Promise<IPrintJob>;
+    /**
+     * Get active print jobs
+     */
+    getJobs(): Promise<IPrintJob[]>;
+    /**
+     * Get info about a specific job
+     */
+    getJobInfo(jobId: number): Promise<IPrintJob>;
+    /**
+     * Cancel a print job
+     */
+    cancelJob(jobId: number): Promise<void>;
+    private printWithIpp;
+    private updateCapabilitiesFromIpp;
+    private qualityToIpp;
+    private mapIppJob;
+    getFeatureInfo(): IPrintFeatureInfo;
+    /**
+     * Create from discovery metadata
+     */
+    static fromDiscovery(device: TDeviceReference, port: number, protocol: TPrintProtocol, metadata: Record<string, unknown>): PrintFeature;
+}