@smarthome.exchange/integrations 0.2.0 → 2.0.0

package/dist_ts/integrations/sonos/sonos.discovery.d.ts

@@ -1,27 +1,3 @@
 import { DiscoveryDescriptor } from '../../core/classes.discoverydescriptor.js';
-import type { IDiscoveryCandidate, IDiscoveryMatch, IDiscoveryMatcher, IDiscoveryValidator } from '../../core/types.js';
-import type { ISonosManualEntry, ISonosMdnsRecord, ISonosSsdpRecord } from './sonos.types.js';
-export declare class SonosSsdpMatcher implements IDiscoveryMatcher<ISonosSsdpRecord> {
-    id: string;
-    source: "ssdp";
-    description: string;
-    matches(recordArg: ISonosSsdpRecord): Promise<IDiscoveryMatch>;
-}
-export declare class SonosMdnsMatcher implements IDiscoveryMatcher<ISonosMdnsRecord> {
-    id: string;
-    source: "mdns";
-    description: string;
-    matches(recordArg: ISonosMdnsRecord): Promise<IDiscoveryMatch>;
-}
-export declare class SonosManualMatcher implements IDiscoveryMatcher<ISonosManualEntry> {
-    id: string;
-    source: "manual";
-    description: string;
-    matches(inputArg: ISonosManualEntry): Promise<IDiscoveryMatch>;
-}
-export declare class SonosCandidateValidator implements IDiscoveryValidator {
-    id: string;
-    description: string;
-    validate(candidateArg: IDiscoveryCandidate): Promise<IDiscoveryMatch>;
-}
+export * from './sonos.matchers.js';
 export declare const createSonosDiscoveryDescriptor: () => DiscoveryDescriptor;

package/dist_ts/integrations/sonos/sonos.discovery.js

@@ -1,115 +1,7 @@
 import { DiscoveryDescriptor } from '../../core/classes.discoverydescriptor.js';
-const sonosUpnpSt = 'urn:schemas-upnp-org:device:ZonePlayer:1';
-export class SonosSsdpMatcher {
-    id = 'sonos-ssdp-match';
-    source = 'ssdp';
-    description = 'Recognize Sonos ZonePlayer SSDP advertisements.';
-    async matches(recordArg) {
-        const st = recordArg.st || recordArg.headers?.st || recordArg.headers?.ST;
-        const usn = recordArg.usn || recordArg.headers?.usn || recordArg.headers?.USN;
-        const location = recordArg.location || recordArg.headers?.location || recordArg.headers?.LOCATION;
-        const matched = st === sonosUpnpSt || Boolean(usn?.includes('RINCON_'));
-        if (!matched) {
-            return { matched: false, confidence: 'low', reason: 'SSDP record is not a Sonos ZonePlayer.' };
-        }
-        const url = location ? new URL(location) : undefined;
-        const id = usn?.match(/RINCON_[^:\s]+/)?.[0];
-        return {
-            matched: true,
-            confidence: id ? 'certain' : 'high',
-            reason: 'SSDP record matches Sonos ZonePlayer metadata.',
-            normalizedDeviceId: id,
-            candidate: {
-                source: 'ssdp',
-                integrationDomain: 'sonos',
-                id,
-                host: url?.hostname,
-                port: url?.port ? Number(url.port) : 1400,
-                manufacturer: 'Sonos',
-                model: 'ZonePlayer',
-                metadata: { st, usn, location },
-            },
-        };
-    }
-}
-export class SonosMdnsMatcher {
-    id = 'sonos-mdns-match';
-    source = 'mdns';
-    description = 'Recognize Sonos mDNS advertisements.';
-    async matches(recordArg) {
-        const type = recordArg.type?.toLowerCase() || '';
-        const name = recordArg.name?.toLowerCase() || '';
-        const matched = type === '_sonos._tcp.local.' || name.startsWith('sonos');
-        if (!matched) {
-            return { matched: false, confidence: 'low', reason: 'mDNS record is not a Sonos advertisement.' };
-        }
-        const id = recordArg.txt?.id || recordArg.txt?.uid || recordArg.name;
-        return {
-            matched: true,
-            confidence: id ? 'certain' : 'high',
-            reason: 'mDNS record matches Sonos metadata.',
-            normalizedDeviceId: id,
-            candidate: {
-                source: 'mdns',
-                integrationDomain: 'sonos',
-                id,
-                host: recordArg.host,
-                port: recordArg.port || 1400,
-                manufacturer: 'Sonos',
-                metadata: { mdnsName: recordArg.name, mdnsType: recordArg.type, txt: recordArg.txt },
-            },
-        };
-    }
-}
-export class SonosManualMatcher {
-    id = 'sonos-manual-match';
-    source = 'manual';
-    description = 'Recognize manual Sonos setup entries.';
-    async matches(inputArg) {
-        const matched = Boolean(inputArg.host || inputArg.model?.toLowerCase().includes('sonos') || inputArg.metadata?.sonos);
-        if (!matched) {
-            return { matched: false, confidence: 'low', reason: 'Manual entry does not contain Sonos setup hints.' };
-        }
-        return {
-            matched: true,
-            confidence: inputArg.host ? 'high' : 'medium',
-            reason: 'Manual entry can start Sonos setup.',
-            normalizedDeviceId: inputArg.id,
-            candidate: {
-                source: 'manual',
-                integrationDomain: 'sonos',
-                id: inputArg.id,
-                host: inputArg.host,
-                port: inputArg.port || 1400,
-                name: inputArg.name,
-                manufacturer: 'Sonos',
-                model: inputArg.model,
-                metadata: inputArg.metadata,
-            },
-        };
-    }
-}
-export class SonosCandidateValidator {
-    id = 'sonos-candidate-validator';
-    description = 'Validate Sonos candidate metadata.';
-    async validate(candidateArg) {
-        const manufacturer = candidateArg.manufacturer?.toLowerCase() || '';
-        const model = candidateArg.model?.toLowerCase() || '';
-        const matched = candidateArg.integrationDomain === 'sonos' || manufacturer === 'sonos' || model.includes('zoneplayer') || model.includes('sonos');
-        return {
-            matched,
-            confidence: matched && candidateArg.host ? 'high' : matched ? 'medium' : 'low',
-            reason: matched ? 'Candidate has Sonos metadata.' : 'Candidate is not Sonos.',
-            candidate: matched ? candidateArg : undefined,
-            normalizedDeviceId: candidateArg.id,
-        };
-    }
-}
-export const createSonosDiscoveryDescriptor = () => {
-    return new DiscoveryDescriptor({ integrationDomain: 'sonos', displayName: 'Sonos' })
-        .addMatcher(new SonosSsdpMatcher())
-        .addMatcher(new SonosMdnsMatcher())
-        .addMatcher(new SonosManualMatcher())
-        .addValidator(new SonosCandidateValidator());
-};
-//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoic29ub3MuZGlzY292ZXJ5LmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vLi4vdHMvaW50ZWdyYXRpb25zL3Nvbm9zL3Nvbm9zLmRpc2NvdmVyeS50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFBQSxPQUFPLEVBQUUsbUJBQW1CLEVBQUUsTUFBTSwyQ0FBMkMsQ0FBQztBQUloRixNQUFNLFdBQVcsR0FBRywwQ0FBMEMsQ0FBQztBQUUvRCxNQUFNLE9BQU8sZ0JBQWdCO0lBQ3BCLEVBQUUsR0FBRyxrQkFBa0IsQ0FBQztJQUN4QixNQUFNLEdBQUcsTUFBZSxDQUFDO0lBQ3pCLFdBQVcsR0FBRyxpREFBaUQsQ0FBQztJQUVoRSxLQUFLLENBQUMsT0FBTyxDQUFDLFNBQTJCO1FBQzlDLE1BQU0sRUFBRSxHQUFHLFNBQVMsQ0FBQyxFQUFFLElBQUksU0FBUyxDQUFDLE9BQU8sRUFBRSxFQUFFLElBQUksU0FBUyxDQUFDLE9BQU8sRUFBRSxFQUFFLENBQUM7UUFDMUUsTUFBTSxHQUFHLEdBQUcsU0FBUyxDQUFDLEdBQUcsSUFBSSxTQUFTLENBQUMsT0FBTyxFQUFFLEdBQUcsSUFBSSxTQUFTLENBQUMsT0FBTyxFQUFFLEdBQUcsQ0FBQztRQUM5RSxNQUFNLFFBQVEsR0FBRyxTQUFTLENBQUMsUUFBUSxJQUFJLFNBQVMsQ0FBQyxPQUFPLEVBQUUsUUFBUSxJQUFJLFNBQVMsQ0FBQyxPQUFPLEVBQUUsUUFBUSxDQUFDO1FBQ2xHLE1BQU0sT0FBTyxHQUFHLEVBQUUsS0FBSyxXQUFXLElBQUksT0FBTyxDQUFDLEdBQUcsRUFBRSxRQUFRLENBQUMsU0FBUyxDQUFDLENBQUMsQ0FBQztRQUN4RSxJQUFJLENBQUMsT0FBTyxFQUFFLENBQUM7WUFDYixPQUFPLEVBQUUsT0FBTyxFQUFFLEtBQUssRUFBRSxVQUFVLEVBQUUsS0FBSyxFQUFFLE1BQU0sRUFBRSx3Q0FBd0MsRUFBRSxDQUFDO1FBQ2pHLENBQUM7UUFDRCxNQUFNLEdBQUcsR0FBRyxRQUFR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
+import { SonosCandidateValidator, SonosManualMatcher, SonosMdnsMatcher, SonosSsdpMatcher } from './sonos.matchers.js';
+import { SonosSsdpProbe } from './sonos.classes.ssdpprobe.js';
+export * from './sonos.matchers.js';
+export const createSonosDiscoveryDescriptor = () => new DiscoveryDescriptor({ integrationDomain: 'sonos', displayName: 'Sonos' })
+    .addProbe(new SonosSsdpProbe()).addMatcher(new SonosSsdpMatcher()).addMatcher(new SonosMdnsMatcher()).addMatcher(new SonosManualMatcher()).addValidator(new SonosCandidateValidator());
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoic29ub3MuZGlzY292ZXJ5LmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vLi4vdHMvaW50ZWdyYXRpb25zL3Nvbm9zL3Nvbm9zLmRpc2NvdmVyeS50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFBQSxPQUFPLEVBQUUsbUJBQW1CLEVBQUUsTUFBTSwyQ0FBMkMsQ0FBQztBQUNoRixPQUFPLEVBQUUsdUJBQXVCLEVBQUUsa0JBQWtCLEVBQUUsZ0JBQWdCLEVBQUUsZ0JBQWdCLEVBQUUsTUFBTSxxQkFBcUIsQ0FBQztBQUN0SCxPQUFPLEVBQUUsY0FBYyxFQUFFLE1BQU0sOEJBQThCLENBQUM7QUFFOUQsY0FBYyxxQkFBcUIsQ0FBQztBQUVwQyxNQUFNLENBQUMsTUFBTSw4QkFBOEIsR0FBRyxHQUF3QixFQUFFLENBQUMsSUFBSSxtQkFBbUIsQ0FBQyxFQUFFLGlCQUFpQixFQUFFLE9BQU8sRUFBRSxXQUFXLEVBQUUsT0FBTyxFQUFFLENBQUM7S0FDbkosUUFBUSxDQUFDLElBQUksY0FBYyxFQUFFLENBQUMsQ0FBQyxVQUFVLENBQUMsSUFBSSxnQkFBZ0IsRUFBRSxDQUFDLENBQUMsVUFBVSxDQUFDLElBQUksZ0JBQWdCLEVBQUUsQ0FBQyxDQUFDLFVBQVUsQ0FBQyxJQUFJLGtCQUFrQixFQUFFLENBQUMsQ0FBQyxZQUFZLENBQUMsSUFBSSx1QkFBdUIsRUFBRSxDQUFDLENBQUMifQ==

package/dist_ts/integrations/sonos/sonos.mapper.d.ts

@@ -5,6 +5,7 @@ export declare class SonosMapper {
     static toDevices(snapshotArg: ISonosSnapshot): plugins.shxInterfaces.data.IDeviceDefinition[];
     static toEntities(snapshotArg: ISonosSnapshot): IIntegrationEntity[];
     private static playbackState;
-    private static deviceId;
+    static deviceId(snapshotArg: ISonosSnapshot): string;
+    static entityId(uid: string): string;
     private static slug;
 }

package/dist_ts/integrations/sonos/sonos.mapper.js

@@ -1,17 +1,18 @@
 import * as plugins from '../../plugins.js';
 export class SonosMapper {
     static toDevices(snapshotArg) {
-        const updatedAt = new Date().toISOString();
+        const updatedAt = snapshotArg.observedAt;
         const deviceId = this.deviceId(snapshotArg);
         const features = [
-            { id: 'playback', capability: 'media', name: 'Playback', readable: true, writable: true },
+            { id: 'playback', capability: 'media', name: 'Playback', readable: true,
+                writable: snapshotArg.group.coordinatorUid === snapshotArg.speakerInfo.uid },
             { id: 'volume', capability: 'media', name: 'Volume', readable: true, writable: true, unit: '%' },
             { id: 'muted', capability: 'media', name: 'Muted', readable: true, writable: true },
         ];
         const state = [
             { featureId: 'playback', value: this.playbackState(snapshotArg), updatedAt },
-            { featureId: 'volume', value: snapshotArg.volume ?? null, updatedAt },
-            { featureId: 'muted', value: snapshotArg.muted ?? null, updatedAt },
+            { featureId: 'volume', value: snapshotArg.volume, updatedAt },
+            { featureId: 'muted', value: snapshotArg.muted, updatedAt },
         ];
         if (snapshotArg.positionInfo.title) {
             features.push({ id: 'current_title', capability: 'media', name: 'Current title', readable: true, writable: false });
@@ -32,12 +33,16 @@ export class SonosMapper {
                     serialNumber: snapshotArg.speakerInfo.serialNumber,
                     softwareVersion: snapshotArg.speakerInfo.softwareVersion,
                     householdId: snapshotArg.speakerInfo.householdId,
+                    groupId: snapshotArg.group.id,
+                    coordinatorUid: snapshotArg.group.coordinatorUid,
+                    groupMemberUids: [...snapshotArg.group.memberUids],
+                    stateSource: 'local_poll',
                 },
             }];
     }
     static toEntities(snapshotArg) {
         return [{
-                id: `media_player.${this.slug(snapshotArg.speakerInfo.zoneName)}`,
+                id: this.entityId(snapshotArg.speakerInfo.uid),
                 uniqueId: `sonos_${this.slug(snapshotArg.speakerInfo.uid)}`,
                 integrationDomain: 'sonos',
                 deviceId: this.deviceId(snapshotArg),
@@ -45,7 +50,7 @@ export class SonosMapper {
                 name: snapshotArg.speakerInfo.zoneName,
                 state: this.playbackState(snapshotArg),
                 attributes: {
-                    volumeLevel: typeof snapshotArg.volume === 'number' ? snapshotArg.volume / 100 : undefined,
+                    volumeLevel: snapshotArg.volume / 100,
                     muted: snapshotArg.muted,
                     mediaTitle: snapshotArg.positionInfo.title,
                     mediaArtist: snapshotArg.positionInfo.artist,
@@ -54,28 +59,43 @@ export class SonosMapper {
                     mediaPosition: snapshotArg.positionInfo.relativeTime,
                     mediaUri: snapshotArg.positionInfo.trackUri,
                     albumArtUri: snapshotArg.positionInfo.albumArtUri,
+                    groupId: snapshotArg.group.id,
+                    coordinatorUid: snapshotArg.group.coordinatorUid,
+                    groupMemberUids: [...snapshotArg.group.memberUids],
+                    observedAt: snapshotArg.observedAt,
+                    stateSource: 'local_poll',
                 },
                 available: true,
             }];
     }
     static playbackState(snapshotArg) {
         const state = snapshotArg.transportInfo.currentTransportState;
-        if (state === 'PLAYING' || state === 'TRANSITIONING') {
+        if (state === 'PLAYING') {
             return 'playing';
         }
+        if (state === 'TRANSITIONING')
+            return 'buffering';
         if (state === 'PAUSED_PLAYBACK') {
-            return snapshotArg.positionInfo.title ? 'paused' : 'idle';
+            return 'paused';
         }
-        if (state === 'STOPPED') {
-            return snapshotArg.positionInfo.title ? 'paused' : 'idle';
-        }
-        return 'idle';
+        if (state === 'STOPPED')
+            return 'stopped';
+        if (state === 'NO_MEDIA_PRESENT')
+            return 'idle';
+        if (state === 'RECORDING')
+            return 'recording';
+        if (state === 'PAUSED_RECORDING')
+            return 'paused_recording';
+        return 'unknown';
     }
     static deviceId(snapshotArg) {
         return `sonos.player.${this.slug(snapshotArg.speakerInfo.uid)}`;
     }
+    static entityId(uid) {
+        return `media_player.sonos_${this.slug(uid)}`;
+    }
     static slug(valueArg) {
         return valueArg.toLowerCase().replace(/[^a-z0-9]+/g, '_').replace(/^_+|_+$/g, '') || 'sonos';
     }
 }
-//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoic29ub3MubWFwcGVyLmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vLi4vdHMvaW50ZWdyYXRpb25zL3Nvbm9zL3Nvbm9zLm1hcHBlci50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFBQSxPQUFPLEtBQUssT0FBTyxNQUFNLGtCQUFrQixDQUFDO0FBSTVDLE1BQU0sT0FBTyxXQUFXO0lBQ2YsTUFBTSxDQUFDLFNBQVMsQ0FBQyxXQUEyQjtRQUNqRCxNQUFNLFNBQVMsR0FBRyxJQUFJLElBQUksRUFBRSxDQUFDLFdBQVcsRUFBRSxDQUFDO1FBQzNDLE1BQU0sUUFBUSxHQUFHLElBQUksQ0FBQyxRQUFRLENBQUMsV0FBVyxDQUFDLENBQUM7UUFDNUMsTUFBTSxRQUFRLEdBQWdEO1lBQzVELEVBQUUsRUFBRSxFQUFFLFVBQVUsRUFBRSxVQUFVLEVBQUUsT0FBTyxFQUFFLElBQUksRUFBRSxVQUFVLEVBQUUsUUFBUSxFQUFFLElBQUksRUFBRSxRQUFRLEVBQUUsSUFBSSxFQUFFO1lBQ3pGLEVBQUUsRUFBRSxFQUFFLFFBQVEsRUFBRSxVQUFVLEVBQUUsT0FBTyxFQUFFLElBQUksRUFBRSxRQUFRLEVBQUUsUUFBUSxFQUFFLElBQUksRUFBRSxRQUFRLEVBQUUsSUFBSSxFQUFFLElBQUksRUFBRSxHQUFHLEVBQUU7WUFDaEcsRUFBRSxFQUFFLEVBQUUsT0FBTyxFQUFFLFVBQVUsRUFBRSxPQUFPLEVBQUUsSUFBSSxFQUFFLE9BQU8sRUFBRSxRQUFRLEVBQUUsSUFBSSxFQUFFLFFBQVEsRUFBRSxJQUFJLEVBQUU7U0FDcEYsQ0FBQztRQUNGLE1BQU0sS0FBSyxHQUE4QztZQUN2RCxFQUFFLFNBQVMsRUFBRSxVQUFVLEVBQUUsS0FBSyxFQUFFLElBQUksQ0FBQyxhQUFhLENBQUMsV0FBVyxDQUFDLEVBQUUsU0FBUyxFQUFFO1lBQzVFLEVBQUUsU0FBUyxFQUFFLFFBQVEsRUFBRSxLQUFLLEVBQUUsV0FBVyxDQUFDLE1BQU0sSUFBSSxJQUFJLEVB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
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoic29ub3MubWFwcGVyLmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vLi4vdHMvaW50ZWdyYXRpb25zL3Nvbm9zL3Nvbm9zLm1hcHBlci50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFBQSxPQUFPLEtBQUssT0FBTyxNQUFNLGtCQUFrQixDQUFDO0FBSTVDLE1BQU0sT0FBTyxXQUFXO0lBQ2YsTUFBTSxDQUFDLFNBQVMsQ0FBQyxXQUEyQjtRQUNqRCxNQUFNLFNBQVMsR0FBRyxXQUFXLENBQUMsVUFBVSxDQUFDO1FBQ3pDLE1BQU0sUUFBUSxHQUFHLElBQUksQ0FBQyxRQUFRLENBQUMsV0FBVyxDQUFDLENBQUM7UUFDNUMsTUFBTSxRQUFRLEdBQWdEO1lBQzVELEVBQUUsRUFBRSxFQUFFLFVBQVUsRUFBRSxVQUFVLEVBQUUsT0FBTyxFQUFFLElBQUksRUFBRSxVQUFVLEVBQUUsUUFBUSxFQUFFLElBQUk7Z0JBQ3JFLFFBQVEsRUFBRSxXQUFXLENBQUMsS0FBSyxDQUFDLGNBQWMsS0FBSyxXQUFXLENBQUMsV0FBVyxDQUFDLEdBQUcsRUFBRTtZQUM5RSxFQUFFLEVBQUUsRUFBRSxRQUFRLEVBQUUsVUFBVSxFQUFFLE9BQU8sRUFBRSxJQUFJLEVBQUUsUUFBUSxFQUFFLFFBQVEsRUFBRSxJQUFJLEVBQUUsUUFBUSxFQUFFLElBQUksRUFBRSxJQUFJLEVBQUUsR0FBRyxFQUFFO1lBQ2hHLEVBQUUsRUFBRSxFQUFFLE9BQU8sRUFBRSxVQUFVLEVBQUUsT0FBTyxFQUFFLElBQUksRUFBRSxPQUFPLEVBQUUsUUFBUSxFQUFFLElBQUksRUFBRSxRQUFRLEVBQUUsSUFBSSxFQUFFO1NBQ3BGLENBQUM7UUFDRixNQUFNLEtBQUssR0FBOEM7WUFDdkQsRUFBRSxTQUFTLEVBQUUsVUFBVSxFQUFFLEtBQUssRUFBRSxJQUFJLENBQUMsYUFBYSxDQUFDLFdBQVcsQ0FBQyxFQUFFLFNBQVMsRUFBRTtZQUM1RSxFQUFFLFNBQVMsRUFBRSxRQUFRLEVBQUUs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

package/dist_ts/integrations/sonos/sonos.matchers.d.ts

@@ -0,0 +1,25 @@
+import type { IDiscoveryCandidate, IDiscoveryMatch, IDiscoveryMatcher, IDiscoveryValidator } from '../../core/types.js';
+import type { ISonosManualEntry, ISonosMdnsRecord, ISonosSsdpRecord } from './sonos.types.js';
+export declare class SonosSsdpMatcher implements IDiscoveryMatcher<ISonosSsdpRecord> {
+    readonly id = "sonos-ssdp-match";
+    readonly source: 'ssdp';
+    readonly description = "Recognize Sonos ZonePlayer SSDP advertisements.";
+    matches(record: ISonosSsdpRecord): Promise<IDiscoveryMatch>;
+}
+export declare class SonosMdnsMatcher implements IDiscoveryMatcher<ISonosMdnsRecord> {
+    readonly id = "sonos-mdns-match";
+    readonly source: 'mdns';
+    readonly description = "Recognize explicit Sonos mDNS services.";
+    matches(record: ISonosMdnsRecord): Promise<IDiscoveryMatch>;
+}
+export declare class SonosManualMatcher implements IDiscoveryMatcher<ISonosManualEntry> {
+    readonly id = "sonos-manual-match";
+    readonly source: 'manual';
+    readonly description = "Recognize explicit manual Sonos setup entries.";
+    matches(input: ISonosManualEntry): Promise<IDiscoveryMatch>;
+}
+export declare class SonosCandidateValidator implements IDiscoveryValidator {
+    readonly id = "sonos-candidate-validator";
+    readonly description = "Validate and allowlist Sonos candidate fields.";
+    validate(candidate: IDiscoveryCandidate): Promise<IDiscoveryMatch>;
+}

package/dist_ts/integrations/sonos/sonos.matchers.js

@@ -0,0 +1,82 @@
+import { isSonosDataRecord, normalizeSonosConfig, normalizeSonosUid } from './sonos.config.js';
+const sonosUpnpSt = 'urn:schemas-upnp-org:device:ZonePlayer:1';
+const noMatch = (reason) => ({ matched: false, confidence: 'low', reason });
+function candidateMatch(source, host, port, uid) {
+    try {
+        if (typeof host !== 'string' || typeof port !== 'number' || (uid !== undefined && typeof uid !== 'string'))
+            throw new Error('Sonos candidate fields are invalid.');
+        const config = normalizeSonosConfig({ host, port, ...(uid ? { expectedUid: uid } : {}) });
+        return {
+            matched: true, confidence: uid ? 'high' : 'medium', reason: 'Candidate identifies a local Sonos endpoint; setup verifies the renderer.',
+            normalizedDeviceId: config.expectedUid,
+            candidate: { source, integrationDomain: 'sonos', host: config.host, port: config.port,
+                ...(config.expectedUid ? { id: config.expectedUid } : {}), manufacturer: 'Sonos' },
+        };
+    }
+    catch {
+        return noMatch('Sonos candidate has an invalid endpoint or player identity.');
+    }
+}
+export class SonosSsdpMatcher {
+    id = 'sonos-ssdp-match';
+    source = 'ssdp';
+    description = 'Recognize Sonos ZonePlayer SSDP advertisements.';
+    async matches(record) {
+        if (!isSonosDataRecord(record) || (record.headers !== undefined && !isSonosDataRecord(record.headers)))
+            return noMatch('SSDP record contains invalid fields.');
+        const st = record.st ?? record.headers?.st ?? record.headers?.ST;
+        const usn = record.usn ?? record.headers?.usn ?? record.headers?.USN;
+        const location = record.location ?? record.headers?.location ?? record.headers?.LOCATION;
+        if (st !== sonosUpnpSt || typeof usn !== 'string' || typeof location !== 'string')
+            return noMatch('SSDP record is not a Sonos ZonePlayer.');
+        try {
+            const identity = usn.match(/^uuid:([^:]+)(?:::urn:schemas-upnp-org:device:ZonePlayer:1)?$/i)?.[1];
+            const uid = normalizeSonosUid(identity);
+            const url = new URL(location);
+            if (url.protocol !== 'http:' || url.username || url.password || url.search || url.hash || url.pathname !== '/xml/device_description.xml') {
+                return noMatch('Sonos SSDP description must use an uncredentialed local HTTP device-description URL.');
+            }
+            return candidateMatch('ssdp', url.hostname, Number(url.port || 80), uid);
+        }
+        catch {
+            return noMatch('Sonos SSDP advertisement has an invalid URL or UUID.');
+        }
+    }
+}
+export class SonosMdnsMatcher {
+    id = 'sonos-mdns-match';
+    source = 'mdns';
+    description = 'Recognize explicit Sonos mDNS services.';
+    async matches(record) {
+        if (!isSonosDataRecord(record) || (record.txt !== undefined && !isSonosDataRecord(record.txt)))
+            return noMatch('mDNS record contains invalid fields.');
+        if (typeof record.type !== 'string' || record.type.toLowerCase() !== '_sonos._tcp.local.' || !record.host)
+            return noMatch('mDNS service is not Sonos.');
+        return candidateMatch('mdns', record.host, record.port ?? 1400, record.txt?.id ?? record.txt?.uid);
+    }
+}
+export class SonosManualMatcher {
+    id = 'sonos-manual-match';
+    source = 'manual';
+    description = 'Recognize explicit manual Sonos setup entries.';
+    async matches(input) {
+        if (!isSonosDataRecord(input) || (input.metadata !== undefined && !isSonosDataRecord(input.metadata)))
+            return noMatch('Manual record contains invalid fields.');
+        if (!input.host || !((typeof input.model === 'string' && input.model.toLowerCase().includes('sonos')) || input.metadata?.sonos === true || (typeof input.id === 'string' && input.id.startsWith('RINCON_')))) {
+            return noMatch('Manual entry requires an explicit Sonos hint and endpoint.');
+        }
+        return candidateMatch('manual', input.host, input.port ?? 1400, input.id);
+    }
+}
+export class SonosCandidateValidator {
+    id = 'sonos-candidate-validator';
+    description = 'Validate and allowlist Sonos candidate fields.';
+    async validate(candidate) {
+        if (!isSonosDataRecord(candidate) || !['manual', 'ssdp', 'mdns'].includes(candidate.source))
+            return noMatch('Sonos candidate contains invalid fields or source.');
+        if (candidate.integrationDomain !== 'sonos' || !candidate.host)
+            return noMatch('Candidate does not belong to Sonos or lacks an endpoint.');
+        return candidateMatch(candidate.source, candidate.host, candidate.port ?? 1400, candidate.id);
+    }
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoic29ub3MubWF0Y2hlcnMuanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi8uLi90cy9pbnRlZ3JhdGlvbnMvc29ub3Mvc29ub3MubWF0Y2hlcnMudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBQ0EsT0FBTyxFQUFFLGlCQUFpQixFQUFFLG9CQUFvQixFQUFFLGlCQUFpQixFQUFFLE1BQU0sbUJBQW1CLENBQUM7QUFHL0YsTUFBTSxXQUFXLEdBQUcsMENBQTBDLENBQUM7QUFDL0QsTUFBTSxPQUFPLEdBQUcsQ0FBQyxNQUFjLEVBQW1CLEVBQUUsQ0FBQyxDQUFDLEVBQUUsT0FBTyxFQUFFLEtBQUssRUFBRSxVQUFVLEVBQUUsS0FBSyxFQUFFLE1BQU0sRUFBRSxDQUFDLENBQUM7QUFFckcsU0FBUyxjQUFjLENBQUMsTUFBcUMsRUFBRSxJQUFhLEVBQUUsSUFBYSxFQUFFLEdBQWE7SUFDeEcsSUFBSSxDQUFDO1FBQ0gsSUFBSSxPQUFPLElBQUksS0FBSyxRQUFRLElBQUksT0FBTyxJQUFJLEtBQUssUUFBUSxJQUFJLENBQUMsR0FBRyxLQUFLLFNBQVMsSUFBSSxPQUFPLEdBQUcsS0FBSyxRQUFRLENBQUM7WUFBRSxNQUFNLElBQUksS0FBSyxDQUFDLHFDQUFxQyxDQUFDLENBQUM7UUFDbkssTUFBTSxNQUFNLEdBQUcsb0JBQW9CLENBQUMsRUFBRSxJQUFJLEVBQUUsSUFBSSxFQUFFLEdBQUcsQ0FBQyxHQUFHLENBQUMsQ0FBQyxDQUFDLEVBQUUsV0FBVyxFQUFFLEdBQUcsRUFBRSxDQUFDLENBQUMsQ0FBQyxFQUFFLENBQUMsRUFBRSxDQUFDLENBQUM7UUFDMUYsT0FBTztZQUNMLE9BQU8sRUFBRSxJQUFJLEVBQUUsVUFBVSxFQUFFLEdBQUcsQ0FBQyxDQUFDLENBQUMsTUFBTSxDQUFDLENBQUMsQ0FBQyxRQUFRLEVBQUUsTUFBTSxFQUFFLDJFQUEyRTtZQUN2SSxrQkFBa0IsRUFBRSxNQUFNLENBQUMsV0FBVztZQUN0QyxTQUFTLEVBQUUs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

package/dist_ts/integrations/sonos/sonos.topology.d.ts

@@ -0,0 +1,2 @@
+import type { ISonosGroup } from './sonos.types.js';
+export declare function parseSonosGroup(document: Record<string, unknown>, selectedUid: string): ISonosGroup;

package/dist_ts/integrations/sonos/sonos.topology.js

@@ -0,0 +1,59 @@
+import { normalizeSonosUid } from './sonos.config.js';
+import { readSonosXmlElement } from './sonos.xml.js';
+export function parseSonosGroup(document, selectedUid) {
+    selectedUid = normalizeSonosUid(selectedUid);
+    const root = readSonosXmlElement(readSonosXmlElement(document, 'topology document').ZoneGroupState, 'ZoneGroupState');
+    const container = readSonosXmlElement(root.ZoneGroups, 'ZoneGroups');
+    const groups = list(container.ZoneGroup);
+    if (!groups.length || groups.length > 128)
+        throw new Error('Sonos topology must contain from 1 to 128 groups.');
+    const knownMembers = new Set();
+    const groupIds = new Set();
+    let selected;
+    for (const value of groups) {
+        const group = readSonosXmlElement(value, 'ZoneGroup');
+        const id = text(group['@_ID'], 'group ID');
+        if (id.length > 128 || /[\s\x00-\x1f]/.test(id) || groupIds.has(id))
+            throw new Error('Sonos group ID is invalid or duplicated.');
+        groupIds.add(id);
+        const coordinatorUid = normalizeSonosUid(group['@_Coordinator']);
+        const members = list(group.ZoneGroupMember);
+        if (!members.length || members.length > 128)
+            throw new Error('Sonos group must contain from 1 to 128 members.');
+        const memberUids = [];
+        for (const value of members) {
+            const member = readSonosXmlElement(value, 'ZoneGroupMember');
+            const uid = normalizeSonosUid(member['@_UUID']);
+            addMember(uid, memberUids, knownMembers);
+            for (const value of list(member.Satellite)) {
+                const satellite = readSonosXmlElement(value, 'Satellite');
+                const satelliteUid = normalizeSonosUid(satellite['@_UUID']);
+                if (satelliteUid === selectedUid)
+                    throw new Error('Select the parent Sonos renderer instead of a bonded satellite.');
+                addMember(satelliteUid, memberUids, knownMembers);
+            }
+        }
+        if (!memberUids.includes(coordinatorUid))
+            throw new Error('Sonos group coordinator is not a member.');
+        if (memberUids.includes(selectedUid))
+            selected = { id, coordinatorUid, memberUids: memberUids.sort() };
+    }
+    if (!selected)
+        throw new Error('Selected Sonos renderer is absent from the topology.');
+    return selected;
+}
+function addMember(uid, members, known) {
+    if (known.has(uid) || known.size >= 128)
+        throw new Error('Sonos topology contains a duplicate or too many players.');
+    known.add(uid);
+    members.push(uid);
+}
+function list(value) {
+    return value === undefined ? [] : Array.isArray(value) ? value : [value];
+}
+function text(value, name) {
+    if (typeof value !== 'string' || !value.trim())
+        throw new Error(`Sonos ${name} must be nonempty text.`);
+    return value;
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoic29ub3MudG9wb2xvZ3kuanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi8uLi90cy9pbnRlZ3JhdGlvbnMvc29ub3Mvc29ub3MudG9wb2xvZ3kudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBQUEsT0FBTyxFQUFFLGlCQUFpQixFQUFFLE1BQU0sbUJBQW1CLENBQUM7QUFFdEQsT0FBTyxFQUFFLG1CQUFtQixFQUFFLE1BQU0sZ0JBQWdCLENBQUM7QUFFckQsTUFBTSxVQUFVLGVBQWUsQ0FBQyxRQUFpQyxFQUFFLFdBQW1CO0lBQ3BGLFdBQVcsR0FBRyxpQkFBaUIsQ0FBQyxXQUFXLENBQUMsQ0FBQztJQUM3QyxNQUFNLElBQUksR0FBRyxtQkFBbUIsQ0FBQyxtQkFBbUIsQ0FBQyxRQUFRLEVBQUUsbUJBQW1CLENBQUMsQ0FBQyxjQUFjLEVBQUUsZ0JBQWdCLENBQUMsQ0FBQztJQUN0SCxNQUFNLFNBQVMsR0FBRyxtQkFBbUIsQ0FBQyxJQUFJLENBQUMsVUFBVSxFQUFFLFlBQVksQ0FBQyxDQUFDO0lBQ3JFLE1BQU0sTUFBTSxHQUFHLElBQUksQ0FBQyxTQUFTLENBQUMsU0FBUyxDQUFDLENBQUM7SUFDekMsSUFBSSxDQUFDLE1BQU0sQ0FBQyxNQUFNLElBQUksTUFBTSxDQUFDLE1BQU0sR0FBRyxHQUFHO1FBQUUsTUFBTSxJQUFJLEtBQUssQ0FBQyxtREFBbUQsQ0FBQyxDQUFDO0lBQ2hILE1BQU0sWUFBWSxHQUFHLElBQUksR0FBRyxFQUFVLENBQUM7SUFDdkMsTUFBTSxRQUFRLEdBQUcsSUFBSSxHQUFHLEVBQVUsQ0FBQztJQUNuQyxJQUFJLFFBQWlDLENBQUM7SUFDdEMsS0FBSyxNQUFNLEtBQUssSUFBSSxNQUFNLEVBQUUsQ0FBQztRQUMzQixNQUFNLEtBQUssR0FBRyxtQkFBbUIsQ0FBQyxLQUFLLEVBQUUsV0FBVyxDQUFDLENBQUM7UUFDdEQsTUFBTSxFQUFFLEdBQUcsSUFBSSxDQUFDLEtBQUssQ0FBQyxNQUFNLENBQUMsRUFB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

package/dist_ts/integrations/sonos/sonos.types.d.ts

@@ -1,11 +1,10 @@
 export interface ISonosConfig {
-    host?: string;
+    host: string;
     port?: number;
-    speakerInfo?: ISonosSpeakerInfo;
-    transportInfo?: ISonosTransportInfo;
-    positionInfo?: ISonosPositionInfo;
-    volume?: number;
-    muted?: boolean;
+    expectedUid?: string;
+    timeoutMs?: number;
+    maxResponseBytes?: number;
+    pollIntervalMs?: number;
 }
 export interface ISonosSpeakerInfo {
     uid: string;
@@ -37,8 +36,19 @@ export interface ISonosSnapshot {
     speakerInfo: ISonosSpeakerInfo;
     transportInfo: ISonosTransportInfo;
     positionInfo: ISonosPositionInfo;
-    volume?: number;
-    muted?: boolean;
+    volume: number;
+    muted: boolean;
+    group: ISonosGroup;
+    observedAt: string;
+}
+export interface ISonosGroup {
+    id: string;
+    coordinatorUid: string;
+    memberUids: string[];
+}
+export interface ISonosMediaOptions {
+    title?: string;
+    mimeType?: string;
 }
 export interface ISonosSsdpRecord {
     st?: string;

package/dist_ts/integrations/sonos/sonos.xml.d.ts

@@ -0,0 +1,3 @@
+export declare function readSonosXmlElement(value: unknown, name: string): Record<string, unknown>;
+export declare function readSonosOptionalText(value: Record<string, unknown>, name: string): string | undefined;
+export declare function readSonosText(value: Record<string, unknown>, name: string): string;

package/dist_ts/integrations/sonos/sonos.xml.js

@@ -0,0 +1,21 @@
+import { isSonosDataRecord } from './sonos.config.js';
+export function readSonosXmlElement(value, name) {
+    if (!isSonosDataRecord(value))
+        throw new Error(`Sonos ${name} must be an XML element.`);
+    return value;
+}
+export function readSonosOptionalText(value, name) {
+    const text = value[name];
+    if (text === undefined)
+        return undefined;
+    if (typeof text !== 'string')
+        throw new Error(`Sonos ${name} must be text.`);
+    return text;
+}
+export function readSonosText(value, name) {
+    const text = readSonosOptionalText(value, name);
+    if (!text?.trim())
+        throw new Error(`Sonos ${name} is missing.`);
+    return text.trim();
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoic29ub3MueG1sLmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vLi4vdHMvaW50ZWdyYXRpb25zL3Nvbm9zL3Nvbm9zLnhtbC50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFBQSxPQUFPLEVBQUUsaUJBQWlCLEVBQUUsTUFBTSxtQkFBbUIsQ0FBQztBQUV0RCxNQUFNLFVBQVUsbUJBQW1CLENBQUMsS0FBYyxFQUFFLElBQVk7SUFDOUQsSUFBSSxDQUFDLGlCQUFpQixDQUFDLEtBQUssQ0FBQztRQUFFLE1BQU0sSUFBSSxLQUFLLENBQUMsU0FBUyxJQUFJLDBCQUEwQixDQUFDLENBQUM7SUFDeEYsT0FBTyxLQUFLLENBQUM7QUFDZixDQUFDO0FBRUQsTUFBTSxVQUFVLHFCQUFxQixDQUFDLEtBQThCLEVBQUUsSUFBWTtJQUNoRixNQUFNLElBQUksR0FBRyxLQUFLLENBQUMsSUFBSSxDQUFDLENBQUM7SUFDekIsSUFBSSxJQUFJLEtBQUssU0FBUztRQUFFLE9BQU8sU0FBUyxDQUFDO0lBQ3pDLElBQUksT0FBTyxJQUFJLEtBQUssUUFBUTtRQUFFLE1BQU0sSUFBSSxLQUFLLENBQUMsU0FBUyxJQUFJLGdCQUFnQixDQUFDLENBQUM7SUFDN0UsT0FBTyxJQUFJLENBQUM7QUFDZCxDQUFDO0FBRUQsTUFBTSxVQUFVLGFBQWEsQ0FBQyxLQUE4QixFQUFFLElBQVk7SUFDeEUsTUFBTSxJQUFJLEdBQUcscUJBQXFCLENBQUMsS0FBSyxFQUFFLElBQUksQ0FBQyxDQUFDO0lBQ2hELElBQUksQ0FBQyxJQUFJLEVBQUUsSUFBSSxFQUFFO1FBQUUsTUFBTSxJQUFJLEtBQUssQ0FBQyxTQUFTLElBQUksY0FBYyxDQUFDLENBQUM7SUFDaEUsT0FBTyxJQUFJLENBQUMsSUFBSSxFQUFFLENBQUM7QUFDckIsQ0FBQyJ9

package/dist_ts/integrations/soundtouch/soundtouch.classes.client.d.ts

@@ -1,39 +1,16 @@
-import type { ISoundtouchCommandRequest, ISoundtouchConfig, ISoundtouchSnapshot } from './soundtouch.types.js';
+import * as plugins from '../../plugins.js';
+import type { ISoundtouchConfig, ISoundtouchSetupContext, ISoundtouchSnapshot, TSoundtouchClientEvent } from './soundtouch.types.js';
+/** Owns one selected published protocol and a bounded logical operation lifetime. */
 export declare class SoundtouchClient {
-    private readonly config;
-    constructor(config: ISoundtouchConfig);
-    getSnapshot(): Promise<ISoundtouchSnapshot>;
-    validateConnection(): Promise<ISoundtouchSnapshot>;
-    execute(requestArg: ISoundtouchCommandRequest): Promise<unknown>;
+    #private;
+    constructor(configArg: ISoundtouchConfig, contextArg: ISoundtouchSetupContext);
+    isHealthy(): boolean;
+    getSnapshot(signalArg?: AbortSignal): Promise<ISoundtouchSnapshot>;
+    setVolume(valueArg: number, signalArg?: AbortSignal): Promise<plugins.ecobridgeDeviceManager.IBoseSoundTouchControlResult>;
+    setMuted(valueArg: boolean, signalArg?: AbortSignal): Promise<plugins.ecobridgeDeviceManager.IBoseSoundTouchControlResult>;
+    writeFeature(idArg: string, valueArg: plugins.shxInterfaces.data.TDeviceStateValue, signalArg?: AbortSignal): Promise<plugins.ecobridgeDeviceManager.IBoseSoundTouchControlResult>;
+    subscribe(handlerArg: (eventArg: TSoundtouchClientEvent) => void, signalArg?: AbortSignal): () => void;
     destroy(): Promise<void>;
-    private setPower;
-    private setVolume;
-    private setMute;
-    private selectSource;
-    private playPreset;
-    private playMedia;
-    private playUrl;
-    private sendKey;
-    private sendSelectXml;
-    private findPreset;
-    private contentItemXml;
-    private fetchText;
-    private optionalText;
-    private requestText;
-    private rawRequest;
-    private parseDeviceInfo;
-    private parseStatus;
-    private parseContentItem;
-    private parseVolume;
-    private parsePresets;
-    private parseZoneStatus;
-    private normalizeSnapshot;
-    private manualSnapshot;
-    private ensureCommandTransport;
-    private executorResultToText;
-    private volumePercent;
-    private port;
-    private dlnaPort;
-    private baseUrl;
-    private cloneValue;
+    /** Explicit cleanup retry only; never repeats an HTTP control or observation. */
+    retryCleanup(): Promise<void>;
 }