@smarthome.exchange/integrations 0.2.0 → 1.0.0

package/dist_ts/integrations/hue/hue.discovery.js

@@ -1,25 +1,62 @@
+import * as plugins from '../../plugins.js';
+import { hueBridgeId, hueContentType, normalizeHueHost } from './hue.validation.js';
 import { DiscoveryDescriptor } from '../../core/classes.discoverydescriptor.js';
 export class HueBrokerDiscoveryProbe {
     id = 'hue-broker-probe';
     source = 'broker';
     description = 'Return Hue bridge candidates from the Hue discovery broker.';
     async probe(contextArg) {
-        if (contextArg.abortSignal?.aborted) {
+        if (contextArg.abortSignal?.aborted)
             return { candidates: [] };
+        const signal = AbortSignal.any([AbortSignal.timeout(5000), ...(contextArg.abortSignal ? [contextArg.abortSignal] : [])]);
+        const response = await fetch('https://discovery.meethue.com/', { signal, redirect: 'error', cache: 'no-store' });
+        if (!response.ok || !response.body || !hueContentType(response.headers.get('content-type'), 'application/json')) {
+            await response.body?.cancel();
+            throw new Error('Hue discovery broker returned an invalid response.');
         }
-        return {
-            candidates: [
-                {
-                    source: 'broker',
-                    integrationDomain: 'hue',
-                    id: '001788fffe123456',
-                    host: '192.168.1.42',
-                    port: 443,
-                    manufacturer: 'Signify',
-                    model: 'Philips Hue Bridge',
-                },
-            ],
-        };
+        const reader = response.body.getReader();
+        const chunks = [];
+        let bytes = 0;
+        try {
+            while (true) {
+                const result = await reader.read();
+                if (result.done)
+                    break;
+                bytes += result.value.byteLength;
+                if (bytes > 262144) {
+                    await reader.cancel();
+                    throw new Error('Hue discovery broker response exceeds its size limit.');
+                }
+                chunks.push(result.value);
+            }
+        }
+        finally {
+            reader.releaseLock();
+        }
+        let payload;
+        try {
+            payload = JSON.parse(new TextDecoder('utf-8', { fatal: true }).decode(Buffer.concat(chunks)));
+        }
+        catch {
+            throw new Error('Hue discovery broker returned invalid JSON.');
+        }
+        if (!Array.isArray(payload) || payload.length > 1024)
+            throw new Error('Hue discovery broker returned invalid bridge metadata.');
+        const candidates = [];
+        const ids = new Set();
+        for (const record of payload) {
+            if (!record || typeof record !== 'object' || Array.isArray(record) || !('id' in record) || !hueBridgeId(record.id)
+                || !('internalipaddress' in record) || typeof record.internalipaddress !== 'string' || !plugins.net.isIP(record.internalipaddress)) {
+                throw new Error('Hue discovery broker returned invalid bridge metadata.');
+            }
+            const id = record.id.toLowerCase();
+            if (ids.has(id))
+                throw new Error('Hue discovery broker returned duplicate bridge identities.');
+            ids.add(id);
+            candidates.push({ source: 'broker', integrationDomain: 'hue', id, host: record.internalipaddress, port: 443,
+                manufacturer: 'Signify', model: 'Philips Hue Bridge' });
+        }
+        return { candidates };
     }
 }
 export class HueMdnsMatcher {
@@ -27,27 +64,36 @@ export class HueMdnsMatcher {
     source = 'mdns';
     description = 'Recognize Hue bridge mDNS records by bridgeid TXT data.';
     async matches(recordArg) {
+        if (!recordArg || typeof recordArg !== 'object')
+            return { matched: false, confidence: 'low', reason: 'Hue mDNS record is invalid.' };
         const bridgeId = recordArg.txt?.bridgeid;
-        if (!bridgeId) {
+        if (!hueBridgeId(bridgeId) || !recordArg.host) {
             return {
                 matched: false,
                 confidence: 'low',
                 reason: 'No Hue bridge ID found.',
             };
         }
+        let host;
+        try {
+            host = normalizeHueHost(recordArg.host);
+        }
+        catch {
+            return { matched: false, confidence: 'low', reason: 'Hue mDNS host is invalid.' };
+        }
         return {
             matched: true,
-            confidence: 'certain',
+            confidence: 'high',
             reason: 'mDNS record contains Hue bridge ID.',
-            normalizedDeviceId: bridgeId,
+            normalizedDeviceId: bridgeId.toLowerCase(),
             candidate: {
                 source: 'mdns',
                 integrationDomain: 'hue',
-                id: bridgeId,
-                host: recordArg.host,
-                port: recordArg.port,
+                id: bridgeId.toLowerCase(),
+                host,
+                port: 443,
                 manufacturer: 'Signify',
-                model: recordArg.txt?.modelid,
+                model: typeof recordArg.txt?.modelid === 'string' && recordArg.txt.modelid.length <= 128 ? recordArg.txt.modelid : undefined,
             },
         };
     }
@@ -57,19 +103,26 @@ export class HueBridgeValidator {
     description = 'Confirm a candidate has enough Hue bridge metadata to start setup.';
     async validate(candidateArg) {
         const isHue = candidateArg.integrationDomain === 'hue' || candidateArg.manufacturer === 'Signify';
-        if (!isHue || !candidateArg.host) {
+        if (!isHue || !candidateArg.host || !hueBridgeId(candidateArg.id)) {
             return {
                 matched: false,
                 confidence: 'low',
                 reason: 'Candidate lacks Hue metadata or host information.',
             };
         }
+        try {
+            normalizeHueHost(candidateArg.host);
+        }
+        catch {
+            return { matched: false, confidence: 'low', reason: 'Hue candidate host is invalid.' };
+        }
         return {
             matched: true,
-            confidence: candidateArg.id ? 'certain' : 'high',
+            confidence: 'high',
             reason: 'Candidate can be configured as a Hue bridge.',
-            candidate: candidateArg,
-            normalizedDeviceId: candidateArg.id,
+            candidate: { source: candidateArg.source, integrationDomain: 'hue', id: candidateArg.id.toLowerCase(),
+                host: normalizeHueHost(candidateArg.host), port: 443, manufacturer: 'Signify' },
+            normalizedDeviceId: candidateArg.id.toLowerCase(),
         };
     }
 }
@@ -82,4 +135,4 @@ export const createHueDiscoveryDescriptor = () => {
         .addMatcher(new HueMdnsMatcher())
         .addValidator(new HueBridgeValidator());
 };
-//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaHVlLmRpc2NvdmVyeS5qcyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uLy4uL3RzL2ludGVncmF0aW9ucy9odWUvaHVlLmRpc2NvdmVyeS50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFBQSxPQUFPLEVBQUUsbUJBQW1CLEVBQUUsTUFBTSwyQ0FBMkMsQ0FBQztBQVloRixNQUFNLE9BQU8sdUJBQXVCO0lBQzNCLEVBQUUsR0FBRyxrQkFBa0IsQ0FBQztJQUN4QixNQUFNLEdBQUcsUUFBaUIsQ0FBQztJQUMzQixXQUFXLEdBQUcsNkRBQTZELENBQUM7SUFFNUUsS0FBSyxDQUFDLEtBQUssQ0FBQyxVQUE2QjtRQUM5QyxJQUFJLFVBQVUsQ0FBQyxXQUFXLEVBQUUsT0FBTyxFQUFFLENBQUM7WUFDcEMsT0FBTyxFQUFFLFVBQVUsRUFBRSxFQUFFLEVBQUUsQ0FBQztRQUM1QixDQUFDO1FBQ0QsT0FBTztZQUNMLFVBQVUsRUFBRTtnQkFDVjtvQkFDRSxNQUFNLEVBQUUsUUFBUTtvQkFDaEIsaUJBQWlCLEVBQUUsS0FBSztvQkFDeEIsRUFBRSxFQUFFLGtCQUFrQjtvQkFDdEIsSUFBSSxFQUFFLGNBQWM7b0JBQ3BCLElBQUksRUFBRSxHQUFHO29CQUNULFlBQVksRUFBRSxTQUFTO29CQUN2QixLQUFLLEVBQUUsb0JBQW9CO2lCQUM1QjthQUNGO1NBQ0YsQ0FBQztJQUNKLENBQUM7Q0FDRjtBQUVELE1BQU0sT0FBTyxjQUFjO0lBQ2xCLEVBQUUsR0FBRyxnQkFBZ0IsQ0FBQztJQUN0QixNQUFNLEdBQUcsTUFBZSxDQUFDO0lBQ3pCLFdBQVcsR0FBRyx5REFBeUQsQ0FBQztJQUV4RSxLQUFLLENBQUMsT0FBTyxDQUFDLFNBQXlCO1FBQzVDLE1BQU0sUUFBUSxHQUFHLFNBQVMsQ0FBQyxHQUFHLEVBQUUsUUFBUSxDQUFDO1FBQ3pDLElBQUksQ0FBQyxRQUFRLEVBQUUsQ0FBQztZQUNkLE9BQU87Z0JBQ0wsT0FBTyxFQUFFLEtBQUs7Z0JBQ2QsVUFBVSxFQUFFLEtBQUs7Z0JBQ2pCLE1BQU0sRUFBRSx5QkFBeUI7YUFDbEMsQ0FBQztRQUNKLENBQUM7UUFFRCxPQUFPO1lBQ0wsT0FBTyxFQUFFLElBQUk7WUFDYixVQUFVLEVBQUUsU0FBUztZQUNyQixNQUFNLEVBQUUscUNBQXFDO1lBQzdDLGtCQUFrQixFQUFFLFFBQVE7WUFDNUIsU0FBUyxFQUFFO2dCQUNULE1BQU0sRUFBRSxNQUFNO2dCQUNkLGlCQUFpQixFQUFFLEtBQUs7Z0JBQ3hCLEVBQUUsRUFBRSxRQUFRO2dCQUNaLElBQUksRUFBRSxTQUFTLENBQUMsSUFBSTtnQkFDcEIsSUFBSSxFQUFFLFNBQVMsQ0FBQyxJQUFJO2dCQUNwQixZQUFZLEVBQUUsU0FBUztnQkFDdkIsS0FBSyxFQUFFLFNBQVMsQ0FBQyxHQUFHLEVBQUUsT0FBTzthQUM5QjtTQUNGLENBQUM7SUFDSixDQUFDO0NBQ0Y7QUFFRCxNQUFNLE9BQU8sa0JBQWtCO0lBQ3RCLEVBQUUsR0FBRyxzQkFBc0IsQ0FBQztJQUM1QixXQUFXLEdBQUcsb0VBQW9FLENBQUM7SUFFbkYsS0FBSyxDQUFDLFFBQVEsQ0FBQyxZQUFpQztRQUNyRCxNQUFNLEtBQUssR0FBRyxZQUFZLENBQUMsaUJBQWlCLEtBQUssS0FBSyxJQUFJLFlBQVksQ0FBQyxZQUFZLEtBQUssU0FBUyxDQUFDO1FBQ2xHLElBQUksQ0FBQyxLQUFLLElBQUksQ0FBQyxZQUFZLENBQUMsSUFBSSxFQUFFLENBQUM7WUFDakMsT0FBTztnQkFDTCxPQUFPLEVBQUUsS0FBSztnQkFDZCxVQUFVLEVBQUUsS0FBSztnQkFDakIsTUFBTSxFQUFFLG1EQUFtRDthQUM1RCxDQUFDO1FBQ0osQ0FBQztRQUNELE9BQU87WUFDTCxPQUFPLEVBQUUsSUFBSTtZQUNiLFVBQVUsRUFBRSxZQUFZLENBQUMsRUFBRSxDQUFDLENBQUMsQ0FBQyxTQUFTLENBQUMsQ0FBQyxDQUFDLE1BQU07WUFDaEQsTUFBTSxFQUFFLDhDQUE4QztZQUN0RCxTQUFTLEVBQUUsWUFBWTtZQUN2QixrQkFBa0IsRUFBRSxZQUFZLENBQUMsRUFBRTtTQUNwQyxDQUFDO0lBQ0osQ0FBQztDQUNGO0FBRUQsTUFBTSxDQUFDLE1BQU0sNEJBQTRCLEdBQUcsR0FBd0IsRUFBRTtJQUNwRSxPQUFPLElBQUksbUJBQW1CLENBQUM7UUFDN0IsaUJBQWlCLEVBQUUsS0FBSztRQUN4QixXQUFXLEVBQUUsYUFBYTtLQUMzQixDQUFDO1NBQ0MsUUFBUSxDQUFDLElBQUksdUJBQXVCLEVBQUUsQ0FBQztTQUN2QyxVQUFVLENBQUMsSUFBSSxjQUFjLEVBQUUsQ0FBQztTQUNoQyxZQUFZLENBQUMsSUFBSSxrQkFBa0IsRUFBRSxDQUFDLENBQUM7QUFDNUMsQ0FBQyxDQUFDIn0=
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaHVlLmRpc2NvdmVyeS5qcyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uLy4uL3RzL2ludGVncmF0aW9ucy9odWUvaHVlLmRpc2NvdmVyeS50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFBQSxPQUFPLEtBQUssT0FBTyxNQUFNLGtCQUFrQixDQUFDO0FBQzVDLE9BQU8sRUFBRSxXQUFXLEVBQUUsY0FBYyxFQUFFLGdCQUFnQixFQUFFLE1BQU0scUJBQXFCLENBQUM7QUFDcEYsT0FBTyxFQUFFLG1CQUFtQixFQUFFLE1BQU0sMkNBQTJDLENBQUM7QUFZaEYsTUFBTSxPQUFPLHVCQUF1QjtJQUMzQixFQUFFLEdBQUcsa0JBQWtCLENBQUM7SUFDeEIsTUFBTSxHQUFHLFFBQWlCLENBQUM7SUFDM0IsV0FBVyxHQUFHLDZEQUE2RCxDQUFDO0lBRTVFLEtBQUssQ0FBQyxLQUFLLENBQUMsVUFBNkI7UUFDOUMsSUFBSSxVQUFVLENBQUMsV0FBVyxFQUFFLE9BQU87WUFBRSxPQUFPLEVBQUUsVUFBVSxFQUFFLEVBQUUsRUFBRSxDQUFDO1FBQy9ELE1BQU0sTUFBTSxHQUFHLFdBQVcsQ0FBQyxHQUFHLENBQUMsQ0FBQyxXQUFXLENBQUMsT0FBTyxDQUFDLElBQUksQ0FBQyxFQUFFLEdBQUcsQ0FBQyxVQUFVLENBQUMsV0FBVyxDQUFDLENBQUMsQ0FBQyxDQUFDLFVBQVUsQ0FBQyxXQUFXLENBQUMsQ0FBQyxDQUFDLENBQUMsRUFBRSxDQUFDLENBQUMsQ0FBQyxDQUFDO1FBQ3pILE1BQU0sUUFBUSxHQUFHLE1BQU0sS0FBSyxDQUFDLGdDQUFnQyxFQUFFLEVBQUUsTUFBTSxFQUFFLFFBQVEsRUFBRSxPQUFPLEVBQUUsS0FBSyxFQUFFLFVBQVUsRUFBRSxDQUFDLENBQUM7UUFDakgsSUFBSSxDQUFDLFFBQVEsQ0FBQyxFQUFFLElBQUksQ0FBQyxRQUFRLENBQUMsSUFBSSxJQUFJLENBQUMsY0FBYyxDQUFDLFFBQVEsQ0FBQyxPQUFPLENBQUMsR0FBRyxD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

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

@@ -5,5 +5,4 @@ export declare class HueMapper {
     static toDevices(resourcesArg: IHueResourceResponse): plugins.shxInterfaces.data.IDeviceDefinition[];
     static toEntities(resourcesArg: IHueResourceResponse): IIntegrationEntity[];
     static toIntegrationEvent(eventArg: IHueEvent): IIntegrationEvent;
-    private static slug;
 }

package/dist_ts/integrations/hue/hue.mapper.js

@@ -1,73 +1,45 @@
 import * as plugins from '../../plugins.js';
 export class HueMapper {
     static toDevices(resourcesArg) {
-        const devices = [];
-        if (resourcesArg.bridge) {
-            devices.push({
+        const timestamp = new Date().toISOString();
+        const devices = [{
                 id: `hue.bridge.${resourcesArg.bridge.id}`,
-                integrationDomain: 'hue',
-                name: resourcesArg.bridge.metadata?.name || 'Hue Bridge',
-                protocol: 'hue',
-                manufacturer: resourcesArg.bridge.productData?.manufacturerName || 'Signify',
+                integrationDomain: 'hue', name: resourcesArg.bridge.metadata?.name || 'Hue Bridge', protocol: 'hue',
+                manufacturer: resourcesArg.bridge.productData?.manufacturerName,
                 model: resourcesArg.bridge.productData?.productName || resourcesArg.bridge.productData?.modelId,
                 online: true,
-                features: [
-                    { id: 'connectivity', capability: 'sensor', name: 'Connectivity', readable: true, writable: false },
-                ],
-                state: [
-                    { featureId: 'connectivity', value: 'online', updatedAt: new Date().toISOString() },
-                ],
-            });
-        }
+                features: [{ id: 'connectivity', capability: 'sensor', name: 'Connectivity', readable: true, writable: false }],
+                state: [{ featureId: 'connectivity', value: 'online', updatedAt: timestamp }],
+            }];
         for (const light of resourcesArg.lights) {
+            const owner = resourcesArg.devices.find((deviceArg) => deviceArg.id === light.owner.rid);
             devices.push({
-                id: `hue.light.${light.id}`,
-                integrationDomain: 'hue',
-                name: light.metadata?.name || `Hue Light ${light.id}`,
-                protocol: 'hue',
-                manufacturer: 'Signify',
-                model: light.metadata?.archetype,
-                online: true,
-                features: [
-                    { id: 'on', capability: 'light', name: 'Power', readable: true, writable: true },
-                    { id: 'brightness', capability: 'light', name: 'Brightness', readable: true, writable: true, unit: '%' },
-                ],
-                state: [
-                    { featureId: 'on', value: light.on?.on ?? false, updatedAt: new Date().toISOString() },
-                    { featureId: 'brightness', value: light.dimming?.brightness ?? null, updatedAt: new Date().toISOString() },
-                ],
-                metadata: {
-                    hueOwnerRid: light.owner?.rid,
-                },
+                id: `hue.light.${light.id}`, integrationDomain: 'hue',
+                name: light.metadata?.name || owner?.metadata?.name || `Hue Light ${light.id}`, protocol: 'hue',
+                manufacturer: owner?.productData?.manufacturerName,
+                model: owner?.productData?.productName || owner?.productData?.modelId,
+                online: light.available,
+                features: [{ id: 'on', capability: 'light', name: 'Power', readable: true, writable: true },
+                    ...(light.dimming ? [{ id: 'brightness', capability: 'light', name: 'Brightness', readable: true, writable: true, unit: '%' }] : [])],
+                state: [{ featureId: 'on', value: light.on.on, updatedAt: timestamp },
+                    ...(light.dimming ? [{ featureId: 'brightness', value: light.dimming.brightness, updatedAt: timestamp }] : [])],
+                metadata: { hueOwnerRid: light.owner.rid },
             });
         }
         return devices;
     }
     static toEntities(resourcesArg) {
         return resourcesArg.lights.map((lightArg) => ({
-            id: `light.${this.slug(lightArg.metadata?.name || lightArg.id)}`,
-            uniqueId: `hue_light_${lightArg.id}`,
-            integrationDomain: 'hue',
-            deviceId: `hue.light.${lightArg.id}`,
-            platform: 'light',
-            name: lightArg.metadata?.name || `Hue Light ${lightArg.id}`,
-            state: lightArg.on?.on ? 'on' : 'off',
-            attributes: {
-                brightness: lightArg.dimming?.brightness,
-            },
-            available: true,
+            id: `light.${lightArg.id}`, uniqueId: `hue_light_${lightArg.id}`, integrationDomain: 'hue',
+            deviceId: `hue.light.${lightArg.id}`, platform: 'light',
+            name: lightArg.metadata?.name || resourcesArg.devices.find((deviceArg) => deviceArg.id === lightArg.owner.rid)?.metadata?.name || `Hue Light ${lightArg.id}`,
+            state: lightArg.on.on ? 'on' : 'off',
+            attributes: lightArg.dimming ? { brightness: lightArg.dimming.brightness } : {}, available: lightArg.available,
         }));
     }
     static toIntegrationEvent(eventArg) {
-        return {
-            type: 'state_changed',
-            integrationDomain: 'hue',
-            data: eventArg,
-            timestamp: Date.now(),
-        };
-    }
-    static slug(valueArg) {
-        return valueArg.toLowerCase().replace(/[^a-z0-9]+/g, '_').replace(/^_+|_+$/g, '') || 'hue_light';
+        return { type: eventArg.type === 'delete' ? 'device_removed' : eventArg.type === 'add' ? 'device_added' : 'state_changed',
+            integrationDomain: 'hue', data: eventArg, timestamp: Date.now() };
     }
 }
-//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaHVlLm1hcHBlci5qcyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uLy4uL3RzL2ludGVncmF0aW9ucy9odWUvaHVlLm1hcHBlci50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFBQSxPQUFPLEtBQUssT0FBTyxNQUFNLGtCQUFrQixDQUFDO0FBSTVDLE1BQU0sT0FBTyxTQUFTO0lBQ2IsTUFBTSxDQUFDLFNBQVMsQ0FBQyxZQUFrQztRQUN4RCxNQUFNLE9BQU8sR0FBbUQsRUFBRSxDQUFDO1FBRW5FLElBQUksWUFBWSxDQUFDLE1BQU0sRUFBRSxDQUFDO1lBQ3hCLE9BQU8sQ0FBQyxJQUFJLENBQUM7Z0JBQ1gsRUFBRSxFQUFFLGNBQWMsWUFBWSxDQUFDLE1BQU0sQ0FBQyxFQUFFLEVBQUU7Z0JBQzFDLGlCQUFpQixFQUFFLEtBQUs7Z0JBQ3hCLElBQUksRUFBRSxZQUFZLENBQUMsTUFBTSxDQUFDLFFBQVEsRUFBRSxJQUFJLElBQUksWUFBWTtnQkFDeEQsUUFBUSxFQUFFLEtBQUs7Z0JBQ2YsWUFBWSxFQUFFLFlBQVksQ0FBQyxNQUFNLENBQUMsV0FBVyxFQUFFLGdCQUFnQixJQUFJLFNBQVM7Z0JBQzVFLEtBQUssRUFBRSxZQUFZLENBQUMsTUFBTSxDQUFDLFdBQVcsRUFBRSxXQUFXLElBQUksWUFBWSxDQUFDLE1BQU0sQ0FBQyxXQUFXLEVBQUUsT0FBTztnQkFDL0YsTUFBTSxFQUFFLElBQUk7Z0JBQ1osUUFBUSxFQUFFO29CQUNSLEVBQUUsRUFBRSxFQUFFLGNBQWMsRUFBRSxVQUFVLEVBQUUsUUFBUSxFQUFFLElBQUksRUFBRSxjQUFjLEVBQUUsUUFBUSxFQUFFLElBQUksRUFBRSxRQUFRLEVBQUUsS0FBSyxFQUFFO2lCQUNwRztnQkFDRCxLQUFLLEVBQUU7b0JBQ0wsRUFBRSxTQUFTLEVBQUUsY0FBYyxFQUFFLEtBQUssRUFBRSxRQUFRLEVBQUUsU0FBUyxFQUFFLElBQUksSUFBSSxFQUFFLENBQUMsV0FBVyxFQUFFLEVBQUU7aUJB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
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaHVlLm1hcHBlci5qcyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uLy4uL3RzL2ludGVncmF0aW9ucy9odWUvaHVlLm1hcHBlci50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFBQSxPQUFPLEtBQUssT0FBTyxNQUFNLGtCQUFrQixDQUFDO0FBSTVDLE1BQU0sT0FBTyxTQUFTO0lBQ2IsTUFBTSxDQUFDLFNBQVMsQ0FBQyxZQUFrQztRQUN4RCxNQUFNLFNBQVMsR0FBRyxJQUFJLElBQUksRUFBRSxDQUFDLFdBQVcsRUFBRSxDQUFDO1FBQzNDLE1BQU0sT0FBTyxHQUFtRCxDQUFDO2dCQUMvRCxFQUFFLEVBQUUsY0FBYyxZQUFZLENBQUMsTUFBTSxDQUFDLEVBQUUsRUFBRTtnQkFDMUMsaUJBQWlCLEVBQUUsS0FBSyxFQUFFLElBQUksRUFBRSxZQUFZLENBQUMsTUFBTSxDQUFDLFFBQVEsRUFBRSxJQUFJLElBQUksWUFBWSxFQUFFLFFBQVEsRUFBRSxLQUFLO2dCQUNuRyxZQUFZLEVBQUUsWUFBWSxDQUFDLE1BQU0sQ0FBQyxXQUFXLEVBQUUsZ0JBQWdCO2dCQUMvRCxLQUFLLEVBQUUsWUFBWSxDQUFDLE1BQU0sQ0FBQyxXQUFXLEVBQUUsV0FBVyxJQUFJLFlBQVksQ0FBQyxNQUFNLENBQUMsV0FBVyxFQUFFLE9BQU87Z0JBQy9GLE1BQU0sRUFBRSxJQUFJO2dCQUNaLFFBQVEsRUFBRSxDQUFDLEVBQUUsRUFBRSxFQUFFLGNBQWMsRUFBRSxVQUFVLEVBQUUsUUFBUSxFQUFFLElBQUksRUFBRSxjQUFjLEVBQUUsUUFBUSxFQUFFLElBQUksRUFBRSxRQUFRLEVBQUUsS0FBSyxFQUFFLENBQUM7Z0JBQy9HLEtBQUssRUFBRSxDQUFDLEVBQUUsU0FBUyxFQUFFLGNBQWMsRUFBRSxLQUFLLEVBQUUsUUFBUSxFQUFFLFNBQVMsRUFBRSxTQUFTLEVBQUUsQ0FBQzthQUM5RSxDQUFDLENBQUM7UUFDSCxLQUFLLE1BQU0sS0FBSyxJQUFJLFlBQVksQ0FB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

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

@@ -3,10 +3,13 @@ export interface IHueConfig {
     host: string;
     appKey: string;
     port?: number;
-    resources?: IHueResourceResponse;
+    /** PEM CA supplied by the operator from a trusted source. */
+    trustedCa?: string;
+    requestTimeoutMs?: number;
 }
 export interface IHueLightStatePatch {
     on?: boolean;
+    /** Hue v2 brightness is a percentage, from 0 through 100. */
     brightness?: number;
 }
 export interface IHueDeviceResource {
@@ -26,23 +29,24 @@ export interface IHueDeviceResource {
 export interface IHueLightResource {
     id: string;
     idV1?: string;
-    owner?: {
+    owner: {
         rid: string;
-        rtype: string;
+        rtype: 'device';
     };
     metadata?: {
         name?: string;
         archetype?: string;
     };
-    on?: {
+    on: {
         on: boolean;
     };
     dimming?: {
         brightness: number;
     };
+    available: boolean;
 }
 export interface IHueResourceResponse {
-    bridge?: IHueDeviceResource;
+    bridge: IHueDeviceResource;
     devices: IHueDeviceResource[];
     lights: IHueLightResource[];
 }
@@ -57,6 +61,9 @@ export interface IHueMdnsRecord {
 }
 export interface IHueEvent {
     id: string;
-    type: string;
-    data: unknown;
+    type: 'add' | 'update' | 'delete';
+    data: Array<{
+        id: string;
+        type: string;
+    }>;
 }

package/dist_ts/integrations/hue/hue.validation.d.ts

@@ -0,0 +1,11 @@
+import type { IHueConfig, IHueEvent, IHueLightStatePatch, IHueResourceResponse } from './hue.types.js';
+export declare const hueContentType: (valueArg: unknown, expectedArg: string) => boolean;
+export declare const hueUuid: (valueArg: unknown) => valueArg is string;
+export declare const hueBridgeId: (valueArg: unknown) => valueArg is string;
+export declare const hueRecord: (valueArg: unknown) => Record<string, unknown>;
+export declare const normalizeHueHost: (valueArg: unknown) => string;
+export declare const normalizeHueConfig: (configArg: IHueConfig) => Required<Pick<IHueConfig, 'bridgeId' | 'host' | 'appKey' | 'port' | 'requestTimeoutMs'>> & Pick<IHueConfig, 'trustedCa'>;
+export declare const validateHuePatch: (patchArg: IHueLightStatePatch) => void;
+export declare const parseHueEnvelope: (valueArg: unknown) => unknown[];
+export declare const parseHueResources: (dataArg: unknown[], bridgeIdArg: string) => IHueResourceResponse;
+export declare const parseHueEvents: (valueArg: unknown) => IHueEvent[];

package/dist_ts/integrations/hue/hue.validation.js

@@ -0,0 +1,160 @@
+import * as plugins from '../../plugins.js';
+export const hueContentType = (valueArg, expectedArg) => typeof valueArg === 'string' && valueArg.split(';', 1)[0].trim().toLowerCase() === expectedArg;
+export const hueUuid = (valueArg) => typeof valueArg === 'string' && /^[0-9a-f]{8}(?:-[0-9a-f]{4}){3}-[0-9a-f]{12}$/i.test(valueArg);
+export const hueBridgeId = (valueArg) => typeof valueArg === 'string' && /^[0-9a-f]{16}$/i.test(valueArg);
+export const hueRecord = (valueArg) => {
+    if (!valueArg || typeof valueArg !== 'object' || Array.isArray(valueArg)) {
+        throw new Error('Hue returned an invalid object.');
+    }
+    return valueArg;
+};
+export const normalizeHueHost = (valueArg) => {
+    if (typeof valueArg !== 'string' || valueArg.length > 253 || valueArg !== valueArg.trim()) {
+        throw new Error('Hue host must be a hostname or IP address.');
+    }
+    const host = valueArg.replace(/^\[([^\]]+)\]$/, '$1');
+    if (plugins.net.isIP(host))
+        return host;
+    if (!/^(?=.{1,253}$)[a-z0-9](?:[a-z0-9.-]*[a-z0-9])?$/i.test(host)
+        || host.split('.').some((partArg) => !/^[a-z0-9](?:[a-z0-9-]{0,61}[a-z0-9])?$/i.test(partArg))) {
+        throw new Error('Hue host must be a hostname or IP address.');
+    }
+    return host;
+};
+export const normalizeHueConfig = (configArg) => {
+    const record = hueRecord(configArg);
+    const allowed = new Set(['bridgeId', 'host', 'appKey', 'port', 'trustedCa', 'requestTimeoutMs']);
+    if (Reflect.ownKeys(record).some((keyArg) => typeof keyArg !== 'string' || !allowed.has(keyArg))) {
+        throw new Error('Hue configuration contains unsupported fields.');
+    }
+    if (!hueBridgeId(record.bridgeId))
+        throw new Error('Hue bridgeId must contain 16 hexadecimal characters.');
+    if (typeof record.appKey !== 'string' || !/^[a-z0-9_-]{1,256}$/i.test(record.appKey)) {
+        throw new Error('Hue appKey must be a nonempty application key.');
+    }
+    const port = record.port ?? 443;
+    const requestTimeoutMs = record.requestTimeoutMs ?? 10_000;
+    if (typeof port !== 'number' || !Number.isInteger(port) || port < 1 || port > 65_535)
+        throw new Error('Hue port is invalid.');
+    if (typeof requestTimeoutMs !== 'number' || !Number.isInteger(requestTimeoutMs) || requestTimeoutMs < 50 || requestTimeoutMs > 60_000) {
+        throw new Error('Hue requestTimeoutMs must be between 50 and 60000.');
+    }
+    if (record.trustedCa !== undefined && (typeof record.trustedCa !== 'string' || record.trustedCa.length > 65_536
+        || !record.trustedCa.includes('-----BEGIN CERTIFICATE-----')))
+        throw new Error('Hue trustedCa must contain a PEM certificate.');
+    return { bridgeId: record.bridgeId.toLowerCase(), host: normalizeHueHost(record.host), appKey: record.appKey, port, requestTimeoutMs,
+        trustedCa: typeof record.trustedCa === 'string' ? record.trustedCa : undefined };
+};
+export const validateHuePatch = (patchArg) => {
+    const patch = hueRecord(patchArg);
+    if (Reflect.ownKeys(patch).some((keyArg) => keyArg !== 'on' && keyArg !== 'brightness')
+        || (patch.on === undefined && patch.brightness === undefined))
+        throw new Error('Hue light state requires power or brightness.');
+    if (patch.on !== undefined && typeof patch.on !== 'boolean')
+        throw new Error('Hue power must be boolean.');
+    if (patch.brightness !== undefined && (typeof patch.brightness !== 'number' || !Number.isFinite(patch.brightness)
+        || patch.brightness < 0 || patch.brightness > 100))
+        throw new Error('Hue brightness must be between 0 and 100 percent.');
+};
+export const parseHueEnvelope = (valueArg) => {
+    const envelope = hueRecord(valueArg);
+    if (!Array.isArray(envelope.errors) || !Array.isArray(envelope.data) || envelope.data.length > 10_000) {
+        throw new Error('Hue returned an invalid API envelope.');
+    }
+    if (envelope.errors.length)
+        throw new Error('Hue bridge rejected the API request.');
+    return envelope.data;
+};
+const optionalString = (valueArg) => {
+    if (valueArg === undefined)
+        return undefined;
+    if (typeof valueArg !== 'string' || valueArg.length > 1024)
+        throw new Error('Hue returned an invalid text field.');
+    return valueArg;
+};
+const deviceResource = (resourceArg) => {
+    if (!hueUuid(resourceArg.id))
+        throw new Error('Hue device resource has an invalid UUID.');
+    const metadata = resourceArg.metadata === undefined ? undefined : hueRecord(resourceArg.metadata);
+    const product = resourceArg.product_data === undefined ? undefined : hueRecord(resourceArg.product_data);
+    return { id: resourceArg.id.toLowerCase(), idV1: optionalString(resourceArg.id_v1),
+        metadata: metadata ? { name: optionalString(metadata.name), archetype: optionalString(metadata.archetype) } : undefined,
+        productData: product ? { manufacturerName: optionalString(product.manufacturer_name), modelId: optionalString(product.model_id),
+            productName: optionalString(product.product_name), softwareVersion: optionalString(product.software_version) } : undefined };
+};
+export const parseHueResources = (dataArg, bridgeIdArg) => {
+    const devices = new Map();
+    const connectivity = new Map();
+    const lightResources = [];
+    const ids = new Set();
+    let bridgeOwner;
+    for (const item of dataArg) {
+        const resource = hueRecord(item);
+        if (!hueUuid(resource.id) || typeof resource.type !== 'string' || resource.type.length > 64 || ids.has(resource.id.toLowerCase())) {
+            throw new Error('Hue returned invalid or duplicate resource identities.');
+        }
+        ids.add(resource.id.toLowerCase());
+        if (resource.type === 'device')
+            devices.set(resource.id.toLowerCase(), deviceResource(resource));
+        if (resource.type === 'light')
+            lightResources.push(resource);
+        if (resource.type === 'bridge') {
+            if (bridgeOwner || typeof resource.bridge_id !== 'string' || resource.bridge_id.toLowerCase() !== bridgeIdArg) {
+                throw new Error('Hue bridge identity does not match the configured bridge.');
+            }
+            const owner = hueRecord(resource.owner);
+            if (!hueUuid(owner.rid) || owner.rtype !== 'device')
+                throw new Error('Hue bridge owner is invalid.');
+            bridgeOwner = owner.rid.toLowerCase();
+        }
+        if (resource.type === 'zigbee_connectivity') {
+            const owner = hueRecord(resource.owner);
+            if (!hueUuid(owner.rid) || owner.rtype !== 'device' || typeof resource.status !== 'string'
+                || !['connected', 'disconnected', 'connectivity_issue', 'unidirectional_incoming', 'pending_discovery'].includes(resource.status)
+                || connectivity.has(owner.rid.toLowerCase()))
+                throw new Error('Hue connectivity resource is invalid.');
+            connectivity.set(owner.rid.toLowerCase(), resource.status === 'connected');
+        }
+    }
+    const bridge = bridgeOwner ? devices.get(bridgeOwner) : undefined;
+    if (!bridge)
+        throw new Error('Hue response has no verified bridge device.');
+    const lights = lightResources.map((resourceArg) => {
+        const owner = hueRecord(resourceArg.owner);
+        const power = hueRecord(resourceArg.on);
+        const dimming = resourceArg.dimming === undefined ? undefined : hueRecord(resourceArg.dimming);
+        const metadata = resourceArg.metadata === undefined ? undefined : hueRecord(resourceArg.metadata);
+        if (!hueUuid(owner.rid) || owner.rtype !== 'device' || !devices.has(owner.rid.toLowerCase()) || typeof power.on !== 'boolean') {
+            throw new Error('Hue light owner or power state is invalid.');
+        }
+        if (dimming && (typeof dimming.brightness !== 'number' || !Number.isFinite(dimming.brightness)
+            || dimming.brightness < 0 || dimming.brightness > 100))
+            throw new Error('Hue light brightness is invalid.');
+        return { id: resourceArg.id.toLowerCase(), idV1: optionalString(resourceArg.id_v1), owner: { rid: owner.rid.toLowerCase(), rtype: 'device' },
+            metadata: metadata ? { name: optionalString(metadata.name), archetype: optionalString(metadata.archetype) } : undefined,
+            on: { on: power.on }, dimming: dimming ? { brightness: dimming.brightness } : undefined,
+            available: connectivity.get(owner.rid.toLowerCase()) === true };
+    });
+    return { bridge, devices: [...devices.values()], lights };
+};
+export const parseHueEvents = (valueArg) => {
+    if (!Array.isArray(valueArg) || valueArg.length > 256)
+        throw new Error('Hue event batch is invalid.');
+    return valueArg.map((itemArg) => {
+        const event = hueRecord(itemArg);
+        if (!hueUuid(event.id) || !['add', 'update', 'delete'].includes(String(event.type))
+            || !Array.isArray(event.data) || event.data.length > 10_000)
+            throw new Error('Hue event envelope is invalid.');
+        const data = [];
+        for (const resourceArg of event.data) {
+            const resource = hueRecord(resourceArg);
+            if (!hueUuid(resource.id) || typeof resource.type !== 'string')
+                throw new Error('Hue event resource identity is invalid.');
+            // Notifications cause authoritative rereads; unknown resource payloads may contain credentials.
+            if (['bridge', 'device', 'light', 'zigbee_connectivity'].includes(resource.type))
+                data.push({ id: resource.id.toLowerCase(), type: resource.type });
+        }
+        return { id: event.id.toLowerCase(), type: event.type, data };
+    }).filter((eventArg) => eventArg.data.length > 0);
+};
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaHVlLnZhbGlkYXRpb24uanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi8uLi90cy9pbnRlZ3JhdGlvbnMvaHVlL2h1ZS52YWxpZGF0aW9uLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQUFBLE9BQU8sS0FBSyxPQUFPLE1BQU0sa0JBQWtCLENBQUM7QUFHNUMsTUFBTSxDQUFDLE1BQU0sY0FBYyxHQUFHLENBQUMsUUFBaUIsRUFBRSxXQUFtQixFQUFXLEVBQUUsQ0FDaEYsT0FBTyxRQUFRLEtBQUssUUFBUSxJQUFJLFFBQVEsQ0FBQyxLQUFLLENBQUMsR0FBRyxFQUFFLENBQUMsQ0FBQyxDQUFDLENBQUMsQ0FBQyxDQUFDLElBQUksRUFBRSxDQUFDLFdBQVcsRUFBRSxLQUFLLFdBQVcsQ0FBQztBQUVqRyxNQUFNLENBQUMsTUFBTSxPQUFPLEdBQUcsQ0FBQyxRQUFpQixFQUFzQixFQUFFLENBQy9ELE9BQU8sUUFBUSxLQUFLLFFBQVEsSUFBSSxnREFBZ0QsQ0FBQyxJQUFJLENBQUMsUUFBUSxDQUFDLENBQUM7QUFFbEcsTUFBTSxDQUFDLE1BQU0sV0FBVyxHQUFHLENBQUMsUUFBaUIsRUFBc0IsRUFBRSxDQUNuRSxPQUFPLFFBQVEsS0FBSyxRQUFRLElBQUksaUJBQWlCLENBQUMsSUFBSSxDQUFDLFFBQVEsQ0FBQyxDQUFDO0FBRW5FLE1BQU0sQ0FBQyxNQUFNLFNBQVMsR0FBRyxDQUFDLFFBQWlCLEVBQTJCLEVBQUU7SUFDdEUsSUFBSSxDQUFDLFFBQVEsSUFBSSxPQUFPLFFBQVEsS0FBSyxRQUFRLElBQUksS0FBSyxDQUFDLE9BQU8sQ0FBQyxRQUFRLENBQUMsRUFBRSxDQUFDO1FBQ3pFLE1BQU0sSUFBSSxLQUFLLENBQUMsaUNBQWlDLENBQUMsQ0FBQztJQUNyRCxDQUFDO0lBQ0QsT0FBTyxRQUFtQyxDQUFDO0FBQzdDLENBQUMsQ0FBQztBQUVGLE1BQU0sQ0FBQyxNQUFNLGdCQUFnQixHQUFHLENBQUMsUUFBaUIsRUFBVSxFQUFF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