@ecobridge.xyz/devicemanager 3.0.2

package/dist_ts/device/device.classes.device.js

@@ -0,0 +1,344 @@
+/**
+ * Universal Device class
+ * A device is a network endpoint that can have multiple features (capabilities)
+ */
+import * as plugins from '../plugins.js';
+import { Feature } from '../features/feature.abstract.js';
+// ============================================================================
+// Universal Device Class
+// ============================================================================
+/**
+ * Universal Device - represents any network device with composable features
+ *
+ * Instead of having separate Scanner, Printer, Speaker classes, a Device can have
+ * any combination of features (scan, print, playback, volume, etc.)
+ *
+ * @example
+ * ```typescript
+ * // A multifunction printer/scanner
+ * const mfp = new UniversalDevice('192.168.1.100', 80);
+ * mfp.addFeature(new ScanFeature(mfp, 80));
+ * mfp.addFeature(new PrintFeature(mfp, 631));
+ *
+ * // Check capabilities
+ * if (mfp.hasFeature('scan') && mfp.hasFeature('print')) {
+ *   const scanFeature = mfp.getFeature<ScanFeature>('scan');
+ *   await scanFeature.scan({ format: 'pdf' });
+ * }
+ * ```
+ */
+export class UniversalDevice extends plugins.events.EventEmitter {
+    // ============================================================================
+    // Properties
+    // ============================================================================
+    /**
+     * Unique device identifier
+     * Format: {address}:{port} or custom ID from discovery
+     */
+    id;
+    /**
+     * Human-readable device name
+     */
+    name;
+    /**
+     * Device network address (IP or hostname)
+     */
+    address;
+    /**
+     * Primary device port
+     */
+    port;
+    /**
+     * Device manufacturer
+     */
+    manufacturer;
+    /**
+     * Device model
+     */
+    model;
+    /**
+     * Device serial number
+     */
+    serialNumber;
+    /**
+     * Device firmware version
+     */
+    firmwareVersion;
+    /**
+     * Current device status
+     */
+    _status = 'unknown';
+    /**
+     * Map of features by type
+     */
+    _features = new Map();
+    /**
+     * Retry options for features
+     */
+    _retryOptions;
+    // ============================================================================
+    // Constructor
+    // ============================================================================
+    constructor(address, port, options) {
+        super();
+        this.address = address;
+        this.port = port;
+        this.id = `${address}:${port}`;
+        this.name = options?.name ?? `Device at ${address}`;
+        this.manufacturer = options?.manufacturer;
+        this.model = options?.model;
+        this.serialNumber = options?.serialNumber;
+        this.firmwareVersion = options?.firmwareVersion;
+        this._retryOptions = options?.retryOptions ?? {};
+    }
+    // ============================================================================
+    // Status Management
+    // ============================================================================
+    /**
+     * Get current device status
+     */
+    get status() {
+        return this._status;
+    }
+    /**
+     * Set device status
+     */
+    set status(value) {
+        if (this._status !== value) {
+            const oldStatus = this._status;
+            this._status = value;
+            this.emit('status:changed', { oldStatus, newStatus: value });
+        }
+    }
+    /**
+     * Check if device is online
+     */
+    get isOnline() {
+        return this._status === 'online';
+    }
+    // ============================================================================
+    // Feature Management
+    // ============================================================================
+    /**
+     * Add a feature to the device
+     */
+    addFeature(feature) {
+        if (this._features.has(feature.type)) {
+            throw new Error(`Feature '${feature.type}' already exists on device ${this.id}`);
+        }
+        this._features.set(feature.type, feature);
+        // Forward feature events
+        feature.on('connected', () => this.emit('feature:connected', feature.type));
+        feature.on('disconnected', () => this.emit('feature:disconnected', feature.type));
+        feature.on('error', (error) => this.emit('feature:error', { type: feature.type, error }));
+        feature.on('state:changed', (states) => this.emit('feature:state:changed', { type: feature.type, ...states }));
+        this.emit('feature:added', feature);
+    }
+    /**
+     * Remove a feature from the device
+     */
+    async removeFeature(type) {
+        const feature = this._features.get(type);
+        if (!feature) {
+            return false;
+        }
+        // Disconnect the feature first
+        try {
+            await feature.disconnect();
+        }
+        catch {
+            // Ignore disconnect errors
+        }
+        this._features.delete(type);
+        this.emit('feature:removed', type);
+        return true;
+    }
+    /**
+     * Check if device has a specific feature
+     */
+    hasFeature(type) {
+        return this._features.has(type);
+    }
+    /**
+     * Check if device has all specified features
+     */
+    hasFeatures(types) {
+        return types.every((type) => this._features.has(type));
+    }
+    /**
+     * Check if device has any of the specified features
+     */
+    hasAnyFeature(types) {
+        return types.some((type) => this._features.has(type));
+    }
+    /**
+     * Get a feature by type (returns undefined if not available)
+     */
+    getFeature(type) {
+        return this._features.get(type);
+    }
+    /**
+     * Select a feature by type (throws if not available).
+     * Use this when you expect the device to have this feature and want fail-fast behavior.
+     *
+     * @param type The feature type to select
+     * @returns The feature instance
+     * @throws Error if the device does not have this feature
+     *
+     * @example
+     * ```typescript
+     * const scanFeature = device.selectFeature<ScanFeature>('scan');
+     * await scanFeature.connect();
+     * const result = await scanFeature.scan({ source: 'flatbed' });
+     * ```
+     */
+    selectFeature(type) {
+        const feature = this._features.get(type);
+        if (!feature) {
+            throw new Error(`Device '${this.name}' does not have feature '${type}'`);
+        }
+        return feature;
+    }
+    /**
+     * Get all features
+     */
+    getFeatures() {
+        return Array.from(this._features.values());
+    }
+    /**
+     * Get all feature types
+     */
+    getFeatureTypes() {
+        return Array.from(this._features.keys());
+    }
+    /**
+     * Get feature count
+     */
+    get featureCount() {
+        return this._features.size;
+    }
+    // ============================================================================
+    // Connection Management
+    // ============================================================================
+    /**
+     * Connect all features
+     */
+    async connect() {
+        const features = this.getFeatures();
+        const results = await Promise.allSettled(features.map((f) => f.connect()));
+        // Check if any connected successfully
+        const anyConnected = results.some((r) => r.status === 'fulfilled');
+        if (anyConnected) {
+            this.status = 'online';
+        }
+        else if (results.length > 0) {
+            // All failed
+            this.status = 'error';
+            const errors = results
+                .filter((r) => r.status === 'rejected')
+                .map((r) => r.reason);
+            throw new AggregateError(errors, 'Failed to connect any features');
+        }
+    }
+    /**
+     * Connect a specific feature
+     */
+    async connectFeature(type) {
+        const feature = this._features.get(type);
+        if (!feature) {
+            throw new Error(`Feature '${type}' not found on device ${this.id}`);
+        }
+        await feature.connect();
+        // Update device status if this is the first connected feature
+        if (this._status !== 'online') {
+            this.status = 'online';
+        }
+    }
+    /**
+     * Disconnect all features
+     */
+    async disconnect() {
+        const features = this.getFeatures();
+        await Promise.allSettled(features.map((f) => f.disconnect()));
+        this.status = 'offline';
+    }
+    /**
+     * Disconnect a specific feature
+     */
+    async disconnectFeature(type) {
+        const feature = this._features.get(type);
+        if (feature) {
+            await feature.disconnect();
+        }
+        // Update device status if all features are disconnected
+        const anyConnected = this.getFeatures().some((f) => f.isConnected);
+        if (!anyConnected) {
+            this.status = 'offline';
+        }
+    }
+    // ============================================================================
+    // Serialization
+    // ============================================================================
+    /**
+     * Get device reference for features
+     */
+    getDeviceReference() {
+        return {
+            id: this.id,
+            name: this.name,
+            address: this.address,
+            port: this.port,
+        };
+    }
+    /**
+     * Get serializable device info
+     */
+    getDeviceInfo() {
+        return {
+            id: this.id,
+            name: this.name,
+            address: this.address,
+            port: this.port,
+            status: this._status,
+            manufacturer: this.manufacturer,
+            model: this.model,
+            serialNumber: this.serialNumber,
+            firmwareVersion: this.firmwareVersion,
+            features: this.getFeatures().map((f) => f.getFeatureInfo()),
+            featureTypes: this.getFeatureTypes(),
+        };
+    }
+    /**
+     * Get retry options for features
+     */
+    get retryOptions() {
+        return this._retryOptions;
+    }
+    // ============================================================================
+    // Static Factory Methods
+    // ============================================================================
+    /**
+     * Create a device from discovered features
+     */
+    static fromDiscovery(id, name, address, port, discoveredFeatures, options) {
+        const device = new UniversalDevice(address, port, {
+            ...options,
+            name,
+        });
+        // Override the generated ID with the discovery ID
+        device.id = id;
+        // Features will be added by the DeviceManager after creation
+        // This is because feature instances need protocol-specific initialization
+        return device;
+    }
+}
+// ============================================================================
+// Type Guards
+// ============================================================================
+/**
+ * Check if a device has a specific feature (type guard)
+ */
+export function deviceHasFeature(device, type) {
+    return device.hasFeature(type);
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiZGV2aWNlLmNsYXNzZXMuZGV2aWNlLmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vdHMvZGV2aWNlL2RldmljZS5jbGFzc2VzLmRldmljZS50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFBQTs7O0dBR0c7QUFFSCxPQUFPLEtBQUssT0FBTyxNQUFNLGVBQWUsQ0FBQztBQU96QyxPQUFPLEVBQUUsT0FBTyxFQUF5QixNQUFNLGlDQUFpQyxDQUFDO0FBbUNqRiwrRUFBK0U7QUFDL0UseUJBQXlCO0FBQ3pCLCtFQUErRTtBQUUvRTs7Ozs7Ozs7Ozs7Ozs7Ozs7OztHQW1CRztBQUNILE1BQU0sT0FBTyxlQUFnQixTQUFRLE9BQU8sQ0FBQyxNQUFNLENBQUMsWUFBWTtJQUM5RCwrRUFBK0U7SUFDL0UsYUFBYTtJQUNiLCtFQUErRTtJQUUvRTs7O09BR0c7SUFDYSxFQUFFLENBQVM7SUFFM0I7O09BRUc7SUFDSSxJQUFJLENBQVM7SUFFcEI7O09BRUc7SUFDYSxPQUFPLENBQVM7SUFFaEM7O09BRUc7SUFDYSxJQUFJLENBQVM7SUFFN0I7O09BRUc7SUFDSSxZQUFZLENBQVU7SUFFN0I7O09BRUc7SUFDSSxLQUFLLENBQVU7SUFFdEI7O09BRUc7SUFDSSxZQUFZLENBQVU7SUFFN0I7O09BRUc7SUFDSSxlQUFlLENBQVU7SUFFaEM7O09BRUc7SUFDTyxPQUFPLEdBQWtCLFNBQVMsQ0FBQztJQUU3Qzs7T0FFRztJQUNPLFNBQVMsR0FBK0IsSUFBSSxHQUFHLEVBQUUsQ0FBQztJQUU1RDs7T0FFRztJQUNPLGFBQWEsQ0FBZ0I7SUFFdkMsK0VBQStFO0lBQy9FLGNBQWM7SUFDZCwrRUFBK0U7SUFFL0UsWUFDRSxPQUFlLEVBQ2YsSUFBWSxFQUNaLE9BQThCO1FBRTlCLEtBQUssRUFBRSxDQUFDO1FBQ1IsSUFBSSxDQUFDLE9BQU8sR0FBRyxPQUFPLENBQUM7UUFDdkIsSUFBSSxDQUFDLElBQUksR0FBRyxJQUFJLENBQUM7UUFDakIsSUFBSSxDQUFD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

package/dist_ts/devicemanager.classes.devicemanager.d.ts

@@ -0,0 +1,210 @@
+/**
+ * Device Manager
+ * Unified device discovery and management using UniversalDevice with Features
+ */
+import * as plugins from './plugins.js';
+import { MdnsDiscovery, SERVICE_TYPES } from './discovery/discovery.classes.mdns.js';
+import { NetworkScanner } from './discovery/discovery.classes.networkscanner.js';
+import { SsdpDiscovery, SSDP_SERVICE_TYPES } from './discovery/discovery.classes.ssdp.js';
+import { UniversalDevice } from './device/device.classes.device.js';
+import { ScanFeature, PrintFeature, PlaybackFeature, VolumeFeature, PowerFeature, SnmpFeature } from './features/index.js';
+import type { Feature } from './features/index.js';
+import { createScanner, createPrinter, createSnmpDevice, createUpsDevice, createSpeaker, createDlnaRenderer } from './factories/index.js';
+import type { IDeviceManagerOptions, INetworkScanOptions, TFeatureType, IDeviceSelector } from './interfaces/index.js';
+/**
+ * Main Device Manager class
+ * Discovers and manages network devices using the UniversalDevice architecture
+ *
+ * Devices are deduplicated by IP address - if the same device is discovered
+ * via multiple methods (mDNS, SSDP, IP scan), features are merged into a
+ * single UniversalDevice instance.
+ */
+export declare class DeviceManager extends plugins.events.EventEmitter {
+    private mdnsDiscovery;
+    private ssdpDiscovery;
+    private _networkScanner;
+    private devicesByIp;
+    private nameSourceByIp;
+    private options;
+    private retryOptions;
+    constructor(options?: IDeviceManagerOptions);
+    /**
+     * Register or merge a device by IP address
+     * Returns the device (existing or new) and whether it's newly created
+     */
+    private registerDevice;
+    private setupDiscoveryEvents;
+    private setupSsdpDiscoveryEvents;
+    private handleMdnsDeviceFound;
+    private handleSsdpDeviceFound;
+    private handleDeviceLost;
+    private parseScanFormats;
+    private parseScanResolutions;
+    private parseScanColorModes;
+    private parseScanSources;
+    startDiscovery(): Promise<void>;
+    stopDiscovery(): Promise<void>;
+    get isDiscovering(): boolean;
+    /**
+     * Get devices matching the selector criteria.
+     * Returns all devices if no selector provided, or devices matching all criteria.
+     * @param selector Optional criteria to filter devices
+     * @returns Array of matching devices (empty if no matches)
+     */
+    getDevices(selector?: IDeviceSelector): UniversalDevice[];
+    /**
+     * Select exactly ONE device matching the criteria.
+     * Use this when you expect a specific device and want fail-fast behavior.
+     * @param selector Criteria to match the device
+     * @returns The matching device
+     * @throws Error if no device matches the selector
+     */
+    selectDevice(selector: IDeviceSelector): UniversalDevice;
+    /**
+     * Get device by ID
+     * @deprecated Use getDevices({ id }) or selectDevice({ id }) instead
+     */
+    getDevice(id: string): UniversalDevice | undefined;
+    /**
+     * Get device by address
+     * @deprecated Use getDevices({ address }) or selectDevice({ address }) instead
+     */
+    getDeviceByAddress(address: string): UniversalDevice | undefined;
+    /**
+     * Check if a device matches the selector criteria
+     */
+    private matchesSelector;
+    /**
+     * Get all devices that have a specific feature
+     */
+    getDevicesWithFeature(featureType: TFeatureType): UniversalDevice[];
+    /**
+     * Get all devices that have ALL specified features
+     */
+    getDevicesWithFeatures(featureTypes: TFeatureType[]): UniversalDevice[];
+    /**
+     * Get all devices that have ANY of the specified features
+     */
+    getDevicesWithAnyFeature(featureTypes: TFeatureType[]): UniversalDevice[];
+    /**
+     * Get all scanner devices
+     */
+    getScanners(): UniversalDevice[];
+    /**
+     * Get all printer devices
+     */
+    getPrinters(): UniversalDevice[];
+    /**
+     * Get all speaker devices (playback feature)
+     */
+    getSpeakers(): UniversalDevice[];
+    /**
+     * Get all UPS/power devices
+     */
+    getUpsDevices(): UniversalDevice[];
+    /**
+     * Get all SNMP devices
+     */
+    getSnmpDevices(): UniversalDevice[];
+    /**
+     * Add a device
+     */
+    addDevice(device: UniversalDevice): void;
+    /**
+     * Add a scanner manually
+     */
+    addScanner(address: string, port: number, protocol?: 'escl' | 'sane', name?: string): Promise<UniversalDevice>;
+    /**
+     * Add a printer manually
+     */
+    addPrinter(address: string, port?: number, name?: string, ippPath?: string): Promise<UniversalDevice>;
+    /**
+     * Add an SNMP device manually
+     */
+    addSnmpDevice(address: string, port?: number, options?: {
+        name?: string;
+        community?: string;
+    }): Promise<UniversalDevice>;
+    /**
+     * Add a UPS device manually
+     */
+    addUpsDevice(address: string, protocol: 'nut' | 'snmp', options?: {
+        name?: string;
+        port?: number;
+        upsName?: string;
+        community?: string;
+    }): Promise<UniversalDevice>;
+    /**
+     * Add a speaker manually
+     */
+    addSpeaker(address: string, protocol: 'sonos' | 'airplay' | 'chromecast' | 'dlna', options?: {
+        name?: string;
+        port?: number;
+    }): Promise<UniversalDevice>;
+    /**
+     * Get a feature from a device
+     */
+    getFeature<T extends Feature>(deviceId: string, featureType: TFeatureType): T | undefined;
+    /**
+     * Add a feature to a device
+     */
+    addFeature(deviceId: string, feature: Feature): boolean;
+    /**
+     * Remove a feature from a device
+     */
+    removeFeature(deviceId: string, featureType: TFeatureType): Promise<boolean>;
+    get networkScanner(): NetworkScanner;
+    private setupNetworkScannerEvents;
+    scanNetwork(options: INetworkScanOptions): Promise<UniversalDevice[]>;
+    /**
+     * Discover scanners in a subnet and add them to the manager.
+     * Convenience method that focuses discovery on scanner protocols only (eSCL, SANE).
+     *
+     * @param subnet CIDR notation subnet (e.g., '192.168.1.0/24')
+     * @param options Optional discovery settings
+     * @returns Array of discovered scanner devices
+     *
+     * @example
+     * ```typescript
+     * const scanners = await manager.discoverScanners('192.168.190.0/24');
+     * for (const scanner of scanners) {
+     *   console.log(`Found: ${scanner.name} at ${scanner.address}`);
+     * }
+     * ```
+     */
+    discoverScanners(subnet: string, options?: {
+        timeout?: number;
+        concurrency?: number;
+    }): Promise<UniversalDevice[]>;
+    /**
+     * Discover printers in a subnet and add them to the manager.
+     * Convenience method that focuses discovery on printer protocols only (IPP).
+     *
+     * @param subnet CIDR notation subnet (e.g., '192.168.1.0/24')
+     * @param options Optional discovery settings
+     * @returns Array of discovered printer devices
+     */
+    discoverPrinters(subnet: string, options?: {
+        timeout?: number;
+        concurrency?: number;
+    }): Promise<UniversalDevice[]>;
+    cancelNetworkScan(): Promise<void>;
+    get isNetworkScanning(): boolean;
+    /**
+     * Remove a device by ID
+     */
+    removeDevice(id: string): Promise<boolean>;
+    /**
+     * Remove a device by address
+     */
+    removeDeviceByAddress(address: string): Promise<boolean>;
+    /**
+     * Disconnect all devices
+     */
+    disconnectAll(): Promise<void>;
+    /**
+     * Stop discovery and disconnect all devices
+     */
+    shutdown(): Promise<void>;
+}
+export { MdnsDiscovery, NetworkScanner, SsdpDiscovery, SERVICE_TYPES, SSDP_SERVICE_TYPES, UniversalDevice, ScanFeature, PrintFeature, PlaybackFeature, VolumeFeature, PowerFeature, SnmpFeature, createScanner, createPrinter, createSnmpDevice, createUpsDevice, createSpeaker, createDlnaRenderer, };