@ecobridge.xyz/devicemanager 3.0.2

package/dist_ts/discovery/discovery.classes.ssdp.js

@@ -0,0 +1,255 @@
+import * as plugins from '../plugins.js';
+/**
+ * SSDP service types for device discovery
+ */
+export const SSDP_SERVICE_TYPES = {
+    // Root device
+    ROOT: 'upnp:rootdevice',
+    // DLNA/UPnP AV
+    MEDIA_RENDERER: 'urn:schemas-upnp-org:device:MediaRenderer:1',
+    MEDIA_SERVER: 'urn:schemas-upnp-org:device:MediaServer:1',
+    // Sonos
+    SONOS_ZONE_PLAYER: 'urn:schemas-upnp-org:device:ZonePlayer:1',
+    // Generic
+    BASIC_DEVICE: 'urn:schemas-upnp-org:device:Basic:1',
+    INTERNET_GATEWAY: 'urn:schemas-upnp-org:device:InternetGatewayDevice:1',
+};
+/**
+ * SSDP Discovery service using node-ssdp
+ */
+export class SsdpDiscovery extends plugins.events.EventEmitter {
+    client = null;
+    devices = new Map();
+    running = false;
+    searchInterval = null;
+    constructor() {
+        super();
+    }
+    /**
+     * Start SSDP discovery
+     */
+    async start(serviceTypes) {
+        if (this.running) {
+            return;
+        }
+        this.running = true;
+        this.client = new plugins.nodeSsdp.Client();
+        // Handle SSDP responses
+        this.client.on('response', (headers, statusCode, rinfo) => {
+            this.handleSsdpResponse(headers, rinfo);
+        });
+        // Search for devices
+        const typesToSearch = serviceTypes ?? [
+            SSDP_SERVICE_TYPES.ROOT,
+            SSDP_SERVICE_TYPES.MEDIA_RENDERER,
+            SSDP_SERVICE_TYPES.MEDIA_SERVER,
+            SSDP_SERVICE_TYPES.SONOS_ZONE_PLAYER,
+        ];
+        // Initial search
+        for (const st of typesToSearch) {
+            this.client.search(st);
+        }
+        // Periodic re-search (every 30 seconds)
+        this.searchInterval = setInterval(() => {
+            if (this.client) {
+                for (const st of typesToSearch) {
+                    this.client.search(st);
+                }
+            }
+        }, 30000);
+        this.emit('started');
+    }
+    /**
+     * Stop SSDP discovery
+     */
+    async stop() {
+        if (!this.running) {
+            return;
+        }
+        this.running = false;
+        if (this.searchInterval) {
+            clearInterval(this.searchInterval);
+            this.searchInterval = null;
+        }
+        if (this.client) {
+            this.client.stop();
+            this.client = null;
+        }
+        this.emit('stopped');
+    }
+    /**
+     * Check if discovery is running
+     */
+    get isRunning() {
+        return this.running;
+    }
+    /**
+     * Get all discovered devices
+     */
+    getDevices() {
+        return Array.from(this.devices.values());
+    }
+    /**
+     * Get devices by service type
+     */
+    getDevicesByType(serviceType) {
+        return this.getDevices().filter((d) => d.serviceType === serviceType);
+    }
+    /**
+     * Search for a specific service type
+     */
+    search(serviceType) {
+        if (this.client && this.running) {
+            this.client.search(serviceType);
+        }
+    }
+    /**
+     * Handle SSDP response
+     */
+    handleSsdpResponse(headers, rinfo) {
+        const usn = headers['USN'] || headers['usn'];
+        const location = headers['LOCATION'] || headers['location'];
+        const st = headers['ST'] || headers['st'];
+        if (!usn || !location) {
+            return;
+        }
+        // Parse location URL
+        let address = rinfo.address;
+        let port = 80;
+        try {
+            const url = new URL(location);
+            address = url.hostname;
+            port = parseInt(url.port) || (url.protocol === 'https:' ? 443 : 80);
+        }
+        catch {
+            // Keep rinfo address
+        }
+        const device = {
+            usn,
+            serviceType: st || 'unknown',
+            location,
+            address,
+            port,
+            headers: { ...headers },
+        };
+        const isNew = !this.devices.has(usn);
+        this.devices.set(usn, device);
+        if (isNew) {
+            // Fetch device description
+            this.fetchDeviceDescription(device).then(() => {
+                this.emit('device:found', device);
+            }).catch(() => {
+                // Still emit even without description
+                this.emit('device:found', device);
+            });
+        }
+        else {
+            this.emit('device:updated', device);
+        }
+    }
+    /**
+     * Fetch and parse device description XML
+     */
+    async fetchDeviceDescription(device) {
+        try {
+            const response = await fetch(device.location, {
+                signal: AbortSignal.timeout(5000),
+            });
+            if (!response.ok) {
+                return;
+            }
+            const xml = await response.text();
+            device.description = this.parseDeviceDescription(xml);
+        }
+        catch {
+            // Ignore fetch errors
+        }
+    }
+    /**
+     * Parse UPnP device description XML
+     */
+    parseDeviceDescription(xml) {
+        const getTagContent = (tag, source = xml) => {
+            const regex = new RegExp(`<${tag}[^>]*>([^<]*)</${tag}>`, 'i');
+            const match = source.match(regex);
+            return match?.[1]?.trim() ?? '';
+        };
+        const getTagBlock = (tag, source = xml) => {
+            const regex = new RegExp(`<${tag}[^>]*>([\\s\\S]*?)</${tag}>`, 'i');
+            const match = source.match(regex);
+            return match?.[1] ?? '';
+        };
+        // Parse services
+        const services = [];
+        const serviceListBlock = getTagBlock('serviceList');
+        const serviceMatches = serviceListBlock.match(/<service>[\s\S]*?<\/service>/gi) || [];
+        for (const serviceXml of serviceMatches) {
+            services.push({
+                serviceType: getTagContent('serviceType', serviceXml),
+                serviceId: getTagContent('serviceId', serviceXml),
+                SCPDURL: getTagContent('SCPDURL', serviceXml),
+                controlURL: getTagContent('controlURL', serviceXml),
+                eventSubURL: getTagContent('eventSubURL', serviceXml),
+            });
+        }
+        // Parse icons
+        const icons = [];
+        const iconListBlock = getTagBlock('iconList');
+        const iconMatches = iconListBlock.match(/<icon>[\s\S]*?<\/icon>/gi) || [];
+        for (const iconXml of iconMatches) {
+            icons.push({
+                mimetype: getTagContent('mimetype', iconXml),
+                width: parseInt(getTagContent('width', iconXml)) || 0,
+                height: parseInt(getTagContent('height', iconXml)) || 0,
+                depth: parseInt(getTagContent('depth', iconXml)) || 0,
+                url: getTagContent('url', iconXml),
+            });
+        }
+        return {
+            deviceType: getTagContent('deviceType'),
+            friendlyName: getTagContent('friendlyName'),
+            manufacturer: getTagContent('manufacturer'),
+            manufacturerURL: getTagContent('manufacturerURL') || undefined,
+            modelDescription: getTagContent('modelDescription') || undefined,
+            modelName: getTagContent('modelName'),
+            modelNumber: getTagContent('modelNumber') || undefined,
+            modelURL: getTagContent('modelURL') || undefined,
+            serialNumber: getTagContent('serialNumber') || undefined,
+            UDN: getTagContent('UDN'),
+            services,
+            icons: icons.length > 0 ? icons : undefined,
+        };
+    }
+    /**
+     * Make a UPnP SOAP request
+     */
+    async soapRequest(controlUrl, serviceType, action, args = {}) {
+        // Build SOAP body
+        let argsXml = '';
+        for (const [key, value] of Object.entries(args)) {
+            argsXml += `<${key}>${value}</${key}>`;
+        }
+        const soapBody = `<?xml version="1.0" encoding="utf-8"?>
+<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/" s:encodingStyle="http://schemas.xmlsoap.org/soap/encoding/">
+  <s:Body>
+    <u:${action} xmlns:u="${serviceType}">
+      ${argsXml}
+    </u:${action}>
+  </s:Body>
+</s:Envelope>`;
+        const response = await fetch(controlUrl, {
+            method: 'POST',
+            headers: {
+                'Content-Type': 'text/xml; charset=utf-8',
+                'SOAPACTION': `"${serviceType}#${action}"`,
+            },
+            body: soapBody,
+            signal: AbortSignal.timeout(10000),
+        });
+        if (!response.ok) {
+            throw new Error(`SOAP request failed: ${response.status}`);
+        }
+        return response.text();
+    }
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiZGlzY292ZXJ5LmNsYXNzZXMuc3NkcC5qcyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uL3RzL2Rpc2NvdmVyeS9kaXNjb3ZlcnkuY2xhc3Nlcy5zc2RwLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQUFBLE9BQU8sS0FBSyxPQUFPLE1BQU0sZUFBZSxDQUFDO0FBRXpDOztHQUVHO0FBQ0gsTUFBTSxDQUFDLE1BQU0sa0JBQWtCLEdBQUc7SUFDaEMsY0FBYztJQUNkLElBQUksRUFBRSxpQkFBaUI7SUFFdkIsZUFBZTtJQUNmLGNBQWMsRUFBRSw2Q0FBNkM7SUFDN0QsWUFBWSxFQUFFLDJDQUEyQztJQUV6RCxRQUFRO0lBQ1IsaUJBQWlCLEVBQUUsMENBQTBDO0lBRTdELFVBQVU7SUFDVixZQUFZLEVBQUUscUNBQXFDO0lBQ25ELGdCQUFnQixFQUFFLHFEQUFxRDtDQUN4RSxDQUFDO0FBd0RGOztHQUVHO0FBQ0gsTUFBTSxPQUFPLGFBQWMsU0FBUSxPQUFPLENBQUMsTUFBTSxDQUFDLFlBQVk7SUFDcEQsTUFBTSxHQUF3RCxJQUFJLENBQUM7SUFDbkUsT0FBTyxHQUE2QixJQUFJLEdBQUcsRUFBRSxDQUFDO0lBQzlDLE9BQU8sR0FBRyxLQUFLLENBQUM7SUFDaEIsY0FBYyxHQUEwQixJQUFJLENBQUM7SUFFckQ7UUFDRSxLQUFLLEVBQUUsQ0FBQztJQUNWLENBQUM7SUFFRDs7T0FFRztJQUNJLEtBQUssQ0FBQyxLQUFLLENBQUMsWUFBdUI7UUFDeEMsSUFBSSxJQUFJLENBQUMsT0FBTyxFQUFFLENBQUM7WUFDakIsT0FBTztRQUNULENBQUM7UUFFRCxJQUFJLENBQUMsT0FBTyxHQUFHLElBQUksQ0FBQztRQUNwQixJQUFJLENBQUMsTUFBTSxHQUFHLElBQUksT0FBTyxDQUFDLFFBQVEsQ0FBQyxNQUFNLEVBQUUsQ0FBQztRQUU1Qyx3QkFBd0I7UUFDeEIsSUFBSSxDQUFDLE1BQU0sQ0FBQyxFQUFFLENBQUMsVUFBVSxFQUFFLENBQUMsT0FBK0IsRUFBRSxVQUFrQixFQUFFLEtBQXdDLEVBQUUsRUFBRTtZQUMzSCxJQUFJLENBQUMsa0JBQWtCLENBQUMsT0FBTyxFQUFFLEtBQUssQ0FBQyxDQUFDO1FBQzFDLENBQUMsQ0FBQyxDQUFDO1FBRUgscUJBQXFCO1FBQ3JCLE1BQU0sYUFBYSxHQUFHLFlBQVksSUFBSTtZQUNwQyxrQkFBa0IsQ0FBQyxJQUFJO1lBQ3ZCLGtCQUFrQixDQUFDLGNBQWM7WUFDakMsa0JBQWtCLENBQUMsWUFBWTtZQUMvQixrQkFBa0IsQ0FBQyxpQkFBaUI7U0FDckMsQ0FBQztRQUVGLGlCQUFpQjtRQUNqQixLQUFLLE1BQU0sRUFBRSxJQUFJLGFBQWEsRUFBRSxDQUFDO1lBQy9CLElBQUksQ0FBQyxNQUFNLENBQUMsTUFBTSxDQUFDLEVBQUUsQ0FBQyxDQUFDO1FBQ3pCLENBQUM7UUFFRCx3Q0FBd0M7UUFDeEMsSUFBSSxDQUFDLGNBQWMsR0FBRyxXQUFXLENBQUMsR0FBRyxFQUFFO1lBQ3JDLElBQUksSUFBSSxDQUFDLE1BQU0sRUFBRSxDQUFDO2dCQUNoQixLQUFLLE1BQU0sRUFBRSxJQUFJLGFBQWEsRUFBRSxDQUFDO29CQUMvQixJQUFJLENBQUMsTUFBTSxDQUFDLE1BQU0sQ0FBQyxFQUFFLENBQUMsQ0FBQztnQkFDekIsQ0FBQztZQUNILENBQUM7UUFDSCxDQUFDLEVBQUUsS0FBSyxDQUFDLENBQUM7UUFFVixJQUFJLENBQUMsSUFBSSxDQUFDLFNBQVMsQ0FBQyxDQUFDO0lBQ3ZCLENBQUM7SUFFRDs7T0FFRztJQUNJLEtBQUssQ0FBQyxJQUFJO1FBQ2YsSUFBSSxDQUFDLElBQUksQ0FBQyxPQUFPLEVBQUUsQ0FBQztZQUNsQixPQUFPO1FBQ1QsQ0FBQztRQUVELElBQUksQ0FBQyxPQUFPLEdBQUcsS0FBSyxDQUFDO1FBRXJCLElBQUksSUFBSSxDQUFDLGNBQWMsRUFBRSxDQUFDO1lBQ3hCLGFBQWEsQ0FBQyxJQUFJLENBQUMsY0FBYyxDQUFDLENBQUM7WUFDbkMsSUFBSSxDQUFDLGNBQWMsR0FBRyxJQUFJLENBQUM7UUFDN0IsQ0FBQztRQUVELElBQUksSUFBSSxDQUFDLE1BQU0sRUFBRSxDQUFDO1lBQ2hCLElBQUksQ0FBQyxNQUFNLENBQUMsSUFBSSxFQUFFLENBQUM7WUFDbkIsSUFBSSxDQUFDLE1BQU0sR0FBRyxJQUFJLENBQUM7UUFDckIsQ0FBQztRQUVELElBQUksQ0FBQyxJQUFJLENBQUMsU0FBUyxDQUFDLENBQUM7SUFDdkIsQ0FBQztJQUVEOztPQUVHO0lBQ0gsSUFBVyxTQUFTO1FBQ2xCLE9BQU8sSUFBSSxDQUFDLE9BQU8sQ0FBQztJQUN0QixDQUFDO0lBRUQ7O09BRUc7SUFDSSxVQUFVO1FBQ2YsT0FBTyxLQUFLLENBQUMsSUFBSSxDQUFDLElBQUksQ0FBQyxPQUFPLENBQUMsTUFBTSxFQUFFLENBQUMsQ0FBQztJQUMzQyxDQUFDO0lBRUQ7O09BRUc7SUFDSSxnQkFBZ0IsQ0FBQyxXQUFtQjtRQUN6QyxPQUFPLElBQUksQ0FBQyxVQUFVLEVBQUUsQ0FBQyxNQUFNLENBQUMsQ0FBQyxDQUFDLEVBQUUsRUFBRSxDQUFDLENBQUMsQ0FBQyxXQUFXLEtBQUssV0FBVyxDQUFDLENBQUM7SUFDeEUsQ0FBQztJQUVEOztPQUVHO0lBQ0ksTUFBTSxDQUFDLFdBQW1CO1FBQy9CLElBQUksSUFBSSxDQUFDLE1BQU0sSUFBSSxJQUFJLENBQUMsT0FBTyxFQUFFLENBQUM7WUFDaEMsSUFBSSxDQUFDLE1BQU0sQ0FBQyxNQUFNLENBQUMsV0FBVyxDQUFDLENBQUM7UUFDbEMsQ0FBQztJQUNILENBQUM7SUFFRDs7T0FFRztJQUNLLGtCQUFrQixDQUN4QixPQUErQixFQUMvQixLQUF3QztRQUV4QyxNQUFNLEdBQUcsR0FBRyxPQUFPLENBQUMsS0FBSyxDQUFDLElBQUksT0FBTyxDQUFDLEtBQUssQ0FBQyxDQUFDO1FBQzdDLE1BQU0sUUFBUSxHQUFHLE9BQU8sQ0FBQyxVQUFVLENBQUMsSUFBSSxPQUFPLENBQUMsVUFBVSxDQUFDLENBQUM7UUFDNUQsTUFBTSxFQUFFLEdBQUcsT0FBTyxDQUFDLElBQUksQ0FBQyxJQUFJLE9BQU8sQ0FBQyxJQUFJLENBQUMsQ0FBQztRQUUxQyxJQUFJLENBQUMsR0FBRyxJQUFJLENBQUMsUUFBUSxFQUFFLENBQUM7WUFDdEIsT0FBTztRQUNULENBQUM7UUFFRCxxQkFBcUI7UUFDckIsSUFBSSxPQUFPLEdBQUcsS0FBSyxDQUFDLE9BQU8sQ0FBQztRQUM1QixJQUFJLElBQUksR0FBRyxFQUFFLENBQUM7UUFFZCxJQUFJLENBQUM7WUFDSCxNQUFNLEdBQUcsR0FBRyxJQUFJLEdBQUcsQ0FBQyxRQUFRLENBQUMsQ0FBQztZQUM5QixPQUFPLEdBQUcsR0FBRyxDQUFDLFFBQVEsQ0FBQztZQUN2QixJQUFJLEdBQUcsUUFBUSxDQUFDLEdBQUcsQ0FBQyxJQUFJLENBQUMsSUFBSSxDQUFDLEdBQUcsQ0FBQyxRQUFRLEtBQUssUUFBUSxDQUFDLENBQUMsQ0FBQyxHQUFHLENBQUMsQ0FBQyxDQUFDLEVBQUUsQ0FBQyxDQUFDO1FBQ3RFLENBQUM7UUFBQyxNQUFNLENBQUM7WUFDUCxxQkFBcUI7UUFDdkIsQ0FBQztRQUVELE1BQU0sTUFBTSxHQUFnQjtZQUMxQixHQUFHO1lBQ0gsV0FBVyxFQUFFLEVBQUUsSUFBSSxTQUFTO1lBQzVCLFFBQVE7WUFDUixPQUFPO1lBQ1AsSUFBSTtZQUNKLE9BQU8sRUFBRSxFQUFFLEdBQUcsT0FBTyxFQUFFO1NBQ3hCLENBQUM7UUFFRixNQUFNLEtBQUssR0FBRyxDQUFDLElBQUksQ0FBQyxPQUFPLENBQUMsR0FBRyxDQUFDLEdBQUcsQ0FBQyxDQUFDO1FBQ3JDLElBQUksQ0FBQyxPQUFPLENBQUMsR0FBRyxDQUFDLEdBQUcsRUFBRSxNQUFNLENBQUMsQ0FBQztRQUU5QixJQUFJLEtBQUssRUFBRSxDQUFDO1lBQ1YsMkJBQTJCO1lBQzNCLElBQUksQ0FBQyxzQkFBc0IsQ0FBQyxNQUFNLENBQUMsQ0FBQyxJQUFJLENBQUMsR0FBRyxFQUFFO2dCQUM1QyxJQUFJLENBQUMsSUFBSSxDQUFDLGNBQWMsRUFBRSxNQUFNLENBQUMsQ0FBQztZQUNwQyxDQUFDLENBQUMsQ0FBQyxLQUFLLENBQUMsR0FBRyxFQUFFO2dCQUNaLHNDQUFzQztnQkFDdEMsSUFBSSxDQUFDLElBQUksQ0FBQyxjQUFjLEVBQUUsTUFBTSxDQUFDLENBQUM7WUFDcEMsQ0FBQyxDQUFDLENBQUM7UUFDTCxDQUFDO2FBQU0sQ0FBQztZQUNOLElBQUksQ0FBQyxJQUFJLENBQUMsZ0JBQWdCLEVBQUUsTUFBTSxDQUFDLENBQUM7UUFDdEMsQ0FBQztJQUNILENBQUM7SUFFRDs7T0FFRztJQUNLLEtBQUssQ0FBQyxzQkFBc0IsQ0FBQyxNQUFtQjtRQUN0RCxJQUFJLENBQUM7WUFDSCxNQUFNLFFBQVEsR0FBRyxNQUFNLEtBQUssQ0FBQyxNQUFNLENBQUMsUUFBUSxFQUFFO2dCQUM1QyxNQUFNLEVBQUUsV0FBVyxDQUFDLE9BQU8sQ0FBQyxJQUFJLENBQUM7YUFDbEMsQ0FBQyxDQUFDO1lBRUgsSUFBSSxDQUFDLFFBQVEsQ0FBQyxFQUFFLEVBQUUsQ0FBQztnQkFDakIsT0FBTztZQUNULENBQUM7WUFFRCxNQUFNLEdBQUcsR0FBRyxNQUFNLFFBQVEsQ0FBQyxJQUFJLEVBQUUsQ0FBQztZQUNsQyxNQUFNLENBQUMsV0FBVyxHQUFHLElBQUksQ0FBQyxzQkFBc0IsQ0FBQyxHQUFHLENBQUMsQ0FBQztRQUN4RCxDQUFDO1FBQUMsTUFBTSxDQUFDO1lBQ1Asc0JBQXNCO1FBQ3hCLENBQUM7SUFDSCxDQUFDO0lBRUQ7O09BRUc7SUFDSyxzQkFBc0IsQ0FBQyxHQUFXO1FBQ3hDLE1BQU0sYUFBYSxHQUFHLENBQUMsR0FBVyxFQUFFLFNBQWlCLEdBQUcsRUFBVSxFQUFFO1lBQ2xFLE1BQU0sS0FBSyxHQUFHLElBQUksTUFBTSxDQUFDLElBQUksR0FBRyxrQkFBa0IsR0FBRyxHQUFHLEVBQUUsR0FBRyxDQUFDLENBQUM7WUFDL0QsTUFBTSxLQUFLLEdBQUcsTUFBTSxDQUFDLEtBQUssQ0FBQyxLQUFLLENBQUMsQ0FBQztZQUNsQyxPQUFPLEtBQUssRUFBRSxDQUFDLENBQUMsQ0FBQyxFQUFFLElBQUksRUFBRSxJQUFJLEVBQUUsQ0FBQztRQUNsQyxDQUFDLENBQUM7UUFFRixNQUFNLFdBQVcsR0FBRyxDQUFDLEdBQVcsRUFBRSxTQUFpQixHQUFHLEVBQVUsRUFBRTtZQUNoRSxNQUFNLEtBQUssR0FBRyxJQUFJLE1BQU0sQ0FBQyxJQUFJLEdBQUcsdUJBQXVCLEdBQUcsR0FBRyxFQUFFLEdBQUcsQ0FBQyxDQUFDO1lBQ3BFLE1BQU0sS0FBSyxHQUFHLE1BQU0sQ0FBQyxLQUFLLENBQUMsS0FBSyxDQUFDLENBQUM7WUFDbEMsT0FBTyxLQUFLLEVBQUUsQ0FBQyxDQUFDLENBQUMsSUFBSSxFQUFFLENBQUM7UUFDMUIsQ0FBQyxDQUFDO1FBRUYsaUJBQWlCO1FBQ2pCLE1BQU0sUUFBUSxHQUFtQixFQUFFLENBQUM7UUFDcEMsTUFBTSxnQkFBZ0IsR0FBRyxXQUFXLENBQUMsYUFBYSxDQUFDLENBQUM7UUFDcEQsTUFBTSxjQUFjLEdBQUcsZ0JBQWdCLENBQUMsS0FBSyxDQUFDLGdDQUFnQyxDQUFDLElBQUksRUFBRSxDQUFDO1FBRXRGLEtBQUssTUFBTSxVQUFVLElBQUksY0FBYyxFQUFFLENBQUM7WUFDeEMsUUFBUSxDQUFDLElBQUksQ0FBQztnQkFDWixXQUFXLEVBQUUsYUFBYSxDQUFDLGFBQWEsRUFBRSxVQUFVLENBQUM7Z0JBQ3JELFNBQVMsRUFBRSxhQUFhLENBQUMsV0FBVyxFQUFFLFVBQVUsQ0FBQztnQkFDakQsT0FBTyxFQUFFLGFBQWEsQ0FBQyxTQUFTLEVBQUUsVUFBVSxDQUFDO2dCQUM3QyxVQUFVLEVBQUUsYUFBYSxDQUFDLFlBQVksRUFBRSxVQUFVLENBQUM7Z0JBQ25ELFdBQVcsRUFBRSxhQUFhLENBQUMsYUFBYSxFQUFFLFVBQVUsQ0FBQzthQUN0RCxDQUFDLENBQUM7UUFDTCxDQUFDO1FBRUQsY0FBYztRQUNkLE1BQU0sS0FBSyxHQUFnQixFQUFFLENBQUM7UUFDOUIsTUFBTSxhQUFhLEdBQUcsV0FBVyxDQUFDLFVBQVUsQ0FBQyxDQUFDO1FBQzlDLE1BQU0sV0FBVyxHQUFHLGFBQWEsQ0FBQyxLQUFLLENBQUMsMEJBQTBCLENBQUMsSUFBSSxFQUFFLENBQUM7UUFFMUUsS0FBSyxNQUFNLE9BQU8sSUFBSSxXQUFXLEVBQUUsQ0FBQztZQUNsQyxLQUFLLENBQUMsSUFBSSxDQUFDO2dCQUNULFFBQVEsRUFBRSxhQUFhLENBQUMsVUFBVSxFQUFFLE9BQU8sQ0FBQztnQkFDNUMsS0FBSyxFQUFFLFFBQVEsQ0FBQyxhQUFhLENBQUMsT0FBTyxFQUFFLE9BQU8sQ0FBQyxDQUFDLElBQUksQ0FBQztnQkFDckQsTUFBTSxFQUFFLFFBQVEsQ0FBQyxhQUFhLENBQUMsUUFBUSxFQUFFLE9BQU8sQ0FBQyxDQUFDLElBQUksQ0FBQztnQkFDdkQsS0FBSyxFQUFFLFFBQVEsQ0FBQyxhQUFhLENBQUMsT0FBTyxFQUFFLE9BQU8sQ0FBQyxDQUFDLElBQUksQ0FBQztnQkFDckQsR0FBRyxFQUFFLGFBQWEsQ0FBQyxLQUFLLEVBQUUsT0FBTyxDQUFDO2FBQ25DLENBQUMsQ0FBQztRQUNMLENBQUM7UUFFRCxPQUFPO1lBQ0wsVUFBVSxFQUFFLGFBQWEsQ0FBQyxZQUFZLENBQUM7WUFDdkMsWUFBWSxFQUFFLGFBQWEsQ0FBQyxjQUFjLENBQUM7WUFDM0MsWUFBWSxFQUFFLGFBQWEsQ0FBQyxjQUFjLENBQUM7WUFDM0MsZUFBZSxFQUFFLGFBQWEsQ0FBQyxpQkFBaUIsQ0FBQyxJQUFJLFNBQVM7WUFDOUQsZ0JBQWdCLEVBQUUsYUFBYSxDQUFDLGtCQUFrQixDQUFDLElBQUksU0FBUztZQUNoRSxTQUFTLEVBQUUsYUFBYSxDQUFDLFdBQVcsQ0FBQztZQUNyQyxXQUFXLEVBQUUsYUFBYSxDQUFDLGFBQWEsQ0FBQyxJQUFJLFNBQVM7WUFDdEQsUUFBUSxFQUFFLGFBQWEsQ0FBQyxVQUFVLENBQUMsSUFBSSxTQUFTO1lBQ2hELFlBQVksRUFBRSxhQUFhLENBQUMsY0FBYyxDQUFDLElBQUksU0FBUztZQUN4RCxHQUFHLEVBQUUsYUFBYSxDQUFDLEtBQUssQ0FBQztZQUN6QixRQUFRO1lBQ1IsS0FBSyxFQUFFLEtBQUssQ0FBQyxNQUFNLEdBQUcsQ0FBQyxDQUFDLENBQUMsQ0FBQyxLQUFLLENBQUMsQ0FBQyxDQUFDLFNBQVM7U0FDNUMsQ0FBQztJQUNKLENBQUM7SUFFRDs7T0FFRztJQUNJLEtBQUssQ0FBQyxXQUFXLENBQ3RCLFVBQWtCLEVBQ2xCLFdBQW1CLEVBQ25CLE1BQWMsRUFDZCxPQUF3QyxFQUFFO1FBRTFDLGtCQUFrQjtRQUNsQixJQUFJLE9BQU8sR0FBRyxFQUFFLENBQUM7UUFDakIsS0FBSyxNQUFNLENBQUMsR0FBRyxFQUFFLEtBQUssQ0FBQyxJQUFJLE1BQU0sQ0FBQyxPQUFPLENBQUMsSUFBSSxDQUFDLEVBQUUsQ0FBQztZQUNoRCxPQUFPLElBQUksSUFBSSxHQUFHLElBQUksS0FBSyxLQUFLLEdBQUcsR0FBRyxDQUFDO1FBQ3pDLENBQUM7UUFFRCxNQUFNLFFBQVEsR0FBRzs7O1NBR1osTUFBTSxhQUFhLFdBQVc7UUFDL0IsT0FBTztVQUNMLE1BQU07O2NBRUYsQ0FBQztRQUVYLE1BQU0sUUFBUSxHQUFHLE1BQU0sS0FBSyxDQUFDLFVBQVUsRUFBRTtZQUN2QyxNQUFNLEVBQUUsTUFBTTtZQUNkLE9BQU8sRUFBRTtnQkFDUCxjQUFjLEVBQUUseUJBQXlCO2dCQUN6QyxZQUFZLEVBQUUsSUFBSSxXQUFXLElBQUksTUFBTSxHQUFHO2FBQzNDO1lBQ0QsSUFBSSxFQUFFLFFBQVE7WUFDZCxNQUFNLEVBQUUsV0FBVyxDQUFDLE9BQU8sQ0FBQyxLQUFLLENBQUM7U0FDbkMsQ0FBQyxDQUFDO1FBRUgsSUFBSSxDQUFDLFFBQVEsQ0FBQyxFQUFFLEVBQUUsQ0FBQztZQUNqQixNQUFNLElBQUksS0FBSyxDQUFDLHdCQUF3QixRQUFRLENBQUMsTUFBTSxFQUFFLENBQUMsQ0FBQztRQUM3RCxDQUFDO1FBRUQsT0FBTyxRQUFRLENBQUMsSUFBSSxFQUFFLENBQUM7SUFDekIsQ0FBQztDQUNGIn0=

package/dist_ts/factories/index.d.ts

@@ -0,0 +1,190 @@
+/**
+ * Device Factory Functions
+ * Create UniversalDevice instances with appropriate features
+ */
+import { UniversalDevice } from '../device/device.classes.device.js';
+import { ScanFeature } from '../features/feature.scan.js';
+import { PrintFeature } from '../features/feature.print.js';
+import { PlaybackFeature } from '../features/feature.playback.js';
+import { VolumeFeature } from '../features/feature.volume.js';
+import { PowerFeature } from '../features/feature.power.js';
+import { SnmpFeature } from '../features/feature.snmp.js';
+import type { TScannerProtocol, IRetryOptions } from '../interfaces/index.js';
+export interface IScannerDiscoveryInfo {
+    id: string;
+    name: string;
+    address: string;
+    port: number;
+    protocol: TScannerProtocol | 'ipp';
+    txtRecords: Record<string, string>;
+}
+/**
+ * Create a scanner device (UniversalDevice with ScanFeature)
+ */
+export declare function createScanner(info: IScannerDiscoveryInfo, retryOptions?: IRetryOptions): UniversalDevice;
+export interface IPrinterDiscoveryInfo {
+    id: string;
+    name: string;
+    address: string;
+    port: number;
+    txtRecords: Record<string, string>;
+}
+/**
+ * Create a printer device (UniversalDevice with PrintFeature)
+ */
+export declare function createPrinter(info: IPrinterDiscoveryInfo, retryOptions?: IRetryOptions): UniversalDevice;
+export interface ISnmpDiscoveryInfo {
+    id: string;
+    name: string;
+    address: string;
+    port: number;
+    community?: string;
+}
+/**
+ * Create an SNMP device (UniversalDevice with SnmpFeature)
+ */
+export declare function createSnmpDevice(info: ISnmpDiscoveryInfo, retryOptions?: IRetryOptions): UniversalDevice;
+export interface IUpsDiscoveryInfo {
+    id: string;
+    name: string;
+    address: string;
+    port: number;
+    protocol: 'nut' | 'snmp';
+    upsName?: string;
+    community?: string;
+}
+/**
+ * Create a UPS device (UniversalDevice with PowerFeature)
+ */
+export declare function createUpsDevice(info: IUpsDiscoveryInfo, retryOptions?: IRetryOptions): UniversalDevice;
+export interface ISpeakerDiscoveryInfo {
+    id: string;
+    name: string;
+    address: string;
+    port: number;
+    protocol: 'sonos' | 'airplay' | 'chromecast' | 'dlna';
+    roomName?: string;
+    modelName?: string;
+    features?: number;
+    deviceId?: string;
+    friendlyName?: string;
+}
+/**
+ * Create a speaker device (UniversalDevice with PlaybackFeature and VolumeFeature)
+ */
+export declare function createSpeaker(info: ISpeakerDiscoveryInfo, retryOptions?: IRetryOptions): UniversalDevice;
+export interface IDlnaRendererDiscoveryInfo {
+    id: string;
+    name: string;
+    address: string;
+    port: number;
+    controlUrl: string;
+    friendlyName: string;
+    modelName?: string;
+    manufacturer?: string;
+}
+/**
+ * Create a DLNA renderer device (UniversalDevice with PlaybackFeature)
+ */
+export declare function createDlnaRenderer(info: IDlnaRendererDiscoveryInfo, retryOptions?: IRetryOptions): UniversalDevice;
+import { SwitchFeature } from '../features/feature.switch.js';
+import { SensorFeature } from '../features/feature.sensor.js';
+import { LightFeature } from '../features/feature.light.js';
+import { CoverFeature } from '../features/feature.cover.js';
+import { LockFeature } from '../features/feature.lock.js';
+import { FanFeature } from '../features/feature.fan.js';
+import { ClimateFeature } from '../features/feature.climate.js';
+import { CameraFeature } from '../features/feature.camera.js';
+import type { TSwitchProtocol, TSensorProtocol, TLightProtocol, TCoverProtocol, TLockProtocol, TFanProtocol, TClimateProtocol, TCameraProtocol, ISwitchProtocolClient, ISensorProtocolClient, ILightProtocolClient, ICoverProtocolClient, ILockProtocolClient, IFanProtocolClient, IClimateProtocolClient, ICameraProtocolClient, ILightCapabilities, ICoverCapabilities, IFanCapabilities, IClimateCapabilities, ICameraCapabilities, TSensorDeviceClass, TSensorStateClass, TCoverDeviceClass } from '../interfaces/smarthome.interfaces.js';
+export interface ISmartSwitchDiscoveryInfo {
+    id: string;
+    name: string;
+    address: string;
+    port: number;
+    entityId: string;
+    protocol: TSwitchProtocol;
+    protocolClient: ISwitchProtocolClient;
+    deviceClass?: 'outlet' | 'switch';
+}
+export declare function createSmartSwitch(info: ISmartSwitchDiscoveryInfo, retryOptions?: IRetryOptions): UniversalDevice;
+export interface ISmartSensorDiscoveryInfo {
+    id: string;
+    name: string;
+    address: string;
+    port: number;
+    entityId: string;
+    protocol: TSensorProtocol;
+    protocolClient: ISensorProtocolClient;
+    deviceClass?: TSensorDeviceClass;
+    stateClass?: TSensorStateClass;
+    unit?: string;
+}
+export declare function createSmartSensor(info: ISmartSensorDiscoveryInfo, retryOptions?: IRetryOptions): UniversalDevice;
+export interface ISmartLightDiscoveryInfo {
+    id: string;
+    name: string;
+    address: string;
+    port: number;
+    entityId: string;
+    protocol: TLightProtocol;
+    protocolClient: ILightProtocolClient;
+    capabilities?: Partial<ILightCapabilities>;
+}
+export declare function createSmartLight(info: ISmartLightDiscoveryInfo, retryOptions?: IRetryOptions): UniversalDevice;
+export interface ISmartCoverDiscoveryInfo {
+    id: string;
+    name: string;
+    address: string;
+    port: number;
+    entityId: string;
+    protocol: TCoverProtocol;
+    protocolClient: ICoverProtocolClient;
+    deviceClass?: TCoverDeviceClass;
+    capabilities?: Partial<ICoverCapabilities>;
+}
+export declare function createSmartCover(info: ISmartCoverDiscoveryInfo, retryOptions?: IRetryOptions): UniversalDevice;
+export interface ISmartLockDiscoveryInfo {
+    id: string;
+    name: string;
+    address: string;
+    port: number;
+    entityId: string;
+    protocol: TLockProtocol;
+    protocolClient: ILockProtocolClient;
+    supportsOpen?: boolean;
+}
+export declare function createSmartLock(info: ISmartLockDiscoveryInfo, retryOptions?: IRetryOptions): UniversalDevice;
+export interface ISmartFanDiscoveryInfo {
+    id: string;
+    name: string;
+    address: string;
+    port: number;
+    entityId: string;
+    protocol: TFanProtocol;
+    protocolClient: IFanProtocolClient;
+    capabilities?: Partial<IFanCapabilities>;
+}
+export declare function createSmartFan(info: ISmartFanDiscoveryInfo, retryOptions?: IRetryOptions): UniversalDevice;
+export interface ISmartClimateDiscoveryInfo {
+    id: string;
+    name: string;
+    address: string;
+    port: number;
+    entityId: string;
+    protocol: TClimateProtocol;
+    protocolClient: IClimateProtocolClient;
+    capabilities?: Partial<IClimateCapabilities>;
+}
+export declare function createSmartClimate(info: ISmartClimateDiscoveryInfo, retryOptions?: IRetryOptions): UniversalDevice;
+export interface ISmartCameraDiscoveryInfo {
+    id: string;
+    name: string;
+    address: string;
+    port: number;
+    entityId: string;
+    protocol: TCameraProtocol;
+    protocolClient: ICameraProtocolClient;
+    capabilities?: Partial<ICameraCapabilities>;
+}
+export declare function createSmartCamera(info: ISmartCameraDiscoveryInfo, retryOptions?: IRetryOptions): UniversalDevice;
+export { UniversalDevice, ScanFeature, PrintFeature, PlaybackFeature, VolumeFeature, PowerFeature, SnmpFeature, SwitchFeature, SensorFeature, LightFeature, CoverFeature, LockFeature, FanFeature, ClimateFeature, CameraFeature, };