matterbridge-iotas 1.0.2 → 1.1.2

package/dist/src/deviceFactory.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Device Factory - Router that maps IOTAS device categories to factory functions.
+ *
+ * Individual device factories live in src/devices/.
+ * This module provides createEndpointForDevice (the router).
+ */
+import { type Device } from 'iotas-ts';
+import type { DeviceFactoryContext, EndpointResult } from './devices/types.js';
+/**
+ * Main factory function - creates appropriate endpoint based on device category.
+ */
+export declare function createEndpointForDevice(device: Device, ctx: DeviceFactoryContext): EndpointResult | null;

package/dist/src/deviceFactory.js

@@ -0,0 +1,65 @@
+/**
+ * Device Factory - Router that maps IOTAS device categories to factory functions.
+ *
+ * Individual device factories live in src/devices/.
+ * This module provides createEndpointForDevice (the router).
+ */
+import { DeviceCategory, EventTypeName, FeatureCategory, isDeviceCategory } from 'iotas-ts';
+import { createDimmableLight, createOnOffLight } from './devices/lights.js';
+import { createOnOffOutlet } from './devices/outlet.js';
+import { createDoorLock } from './devices/lock.js';
+import { createThermostat } from './devices/thermostat.js';
+import { createHumiditySensor, createOccupancySensor, createContactSensor } from './devices/sensors.js';
+function handleSwitch(device, ctx) {
+    const isLight = device.features.some((f) => f.isLight);
+    return isLight ? createOnOffLight(device, ctx) : createOnOffOutlet(device, ctx);
+}
+function handleDimmer(device, ctx) {
+    const hasLevel = device.features.some((f) => f.eventTypeName === EventTypeName.Level);
+    if (hasLevel) {
+        return createDimmableLight(device, ctx);
+    }
+    return handleSwitch(device, ctx);
+}
+const categoryHandlers = new Map([
+    [DeviceCategory.Dimmer, handleDimmer],
+    [DeviceCategory.Switch, handleSwitch],
+    [DeviceCategory.MotionSwitch, handleSwitch],
+    [DeviceCategory.Lock, createDoorLock],
+    [DeviceCategory.Thermostat, createThermostat],
+    [DeviceCategory.Door, createContactSensor],
+]);
+/**
+ * Feature-based fallbacks for unknown categories.
+ *
+ * Precedence is defined by array order (first match wins):
+ * 1) humidity
+ * 2) motion
+ */
+const featureFallbacks = [
+    { category: FeatureCategory.Humidity, handler: createHumiditySensor },
+    { category: FeatureCategory.Motion, handler: createOccupancySensor },
+];
+/**
+ * Main factory function - creates appropriate endpoint based on device category.
+ */
+export function createEndpointForDevice(device, ctx) {
+    if (!device.paired) {
+        ctx.log.debug(`Skipping unpaired device: ${device.name}`);
+        return null;
+    }
+    if (isDeviceCategory(device.category)) {
+        const handler = categoryHandlers.get(device.category);
+        if (handler) {
+            return handler(device, ctx);
+        }
+    }
+    for (const { category, handler: fallbackHandler } of featureFallbacks) {
+        if (device.features.some((f) => f.featureTypeCategory === category)) {
+            return fallbackHandler(device, ctx);
+        }
+    }
+    ctx.log.warn(`Unsupported device category: ${device.category} for device ${device.name}`);
+    return null;
+}
+//# sourceMappingURL=deviceFactory.js.map

package/dist/src/deviceFactory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"deviceFactory.js","sourceRoot":"","sources":["../../src/deviceFactory.ts"],"names":[],"mappings":"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"}

package/dist/src/devices/helpers.d.ts

@@ -0,0 +1,18 @@
+import { bridgedNode, MatterbridgeEndpoint } from 'matterbridge';
+import type { DeviceTypeDefinition } from 'matterbridge';
+import type { Device } from 'iotas-ts';
+import { type FeatureCategory } from 'iotas-ts';
+import type { DeviceFactoryContext, EndpointResult } from './types.js';
+export { bridgedNode };
+export declare function requireFeature(device: Device, category: FeatureCategory, ctx: DeviceFactoryContext, label: string): import("iotas-ts").Feature | null;
+export declare function createBridgedEndpoint(deviceTypes: [DeviceTypeDefinition, ...DeviceTypeDefinition[]], device: Device, ctx: DeviceFactoryContext): MatterbridgeEndpoint;
+export declare function toMatterLevel(iotasLevel: number): number;
+export declare function fromMatterLevel(matterLevel: number): number;
+export declare function toMatterHumidity(iotasHumidity: number): number;
+export declare function toCelsius(fahrenheit: number): number;
+export declare function toMatterCentiCelsius(fahrenheit: number): number;
+export declare function fromMatterCentiCelsius(centiCelsius: number): number;
+export declare function addOnOffHandlers(endpoint: MatterbridgeEndpoint, featureId: number, ctx: DeviceFactoryContext): void;
+export declare function multiFeatureResult(endpoint: MatterbridgeEndpoint, handlers: Map<number, (value: number) => void>): EndpointResult;
+export declare function singleFeatureResult(endpoint: MatterbridgeEndpoint, featureId: number, onUpdate: (value: number) => void): EndpointResult;
+export declare function createSimpleOnOffDevice(deviceType: DeviceTypeDefinition, device: Device, ctx: DeviceFactoryContext, label: string): EndpointResult | null;

package/dist/src/devices/helpers.js

@@ -0,0 +1,91 @@
+import { bridgedNode, MatterbridgeEndpoint } from 'matterbridge';
+import { OnOff } from 'matterbridge/matter/clusters';
+import { findFeatureByCategory, findFeatureByEventType, getManufacturer, getModel, getSerialNumber, Temperature, } from 'iotas-ts';
+import { EventTypeName } from 'iotas-ts';
+import { VENDOR_ID } from './types.js';
+export { bridgedNode };
+function makeDeviceId(device) {
+    return `iotas-${device.id}`;
+}
+export function requireFeature(device, category, ctx, label) {
+    const feature = findFeatureByCategory(device, category);
+    if (!feature) {
+        ctx.log.warn(`Device ${device.name} missing ${category} feature for ${label}`);
+    }
+    return feature ?? null;
+}
+function requireFeatureByEventType(device, eventTypeName, ctx, label) {
+    const feature = findFeatureByEventType(device, eventTypeName);
+    if (!feature) {
+        ctx.log.warn(`Device ${device.name} missing ${eventTypeName} feature for ${label}`);
+    }
+    return feature ?? null;
+}
+export function createBridgedEndpoint(deviceTypes, device, ctx) {
+    return new MatterbridgeEndpoint(deviceTypes, { id: makeDeviceId(device) }, ctx.debug)
+        .createDefaultIdentifyClusterServer()
+        .createDefaultBridgedDeviceBasicInformationClusterServer(device.name, getSerialNumber(device), VENDOR_ID, getManufacturer(device), getModel(device));
+}
+export function toMatterLevel(iotasLevel) {
+    return Math.round(iotasLevel * 254);
+}
+export function fromMatterLevel(matterLevel) {
+    return matterLevel / 254;
+}
+export function toMatterHumidity(iotasHumidity) {
+    return Math.round(iotasHumidity * 10000);
+}
+export function toCelsius(fahrenheit) {
+    return Temperature.toCelsius(fahrenheit);
+}
+export function toMatterCentiCelsius(fahrenheit) {
+    return Math.round(Temperature.toCelsius(fahrenheit) * 100);
+}
+export function fromMatterCentiCelsius(centiCelsius) {
+    return Temperature.toFahrenheit(centiCelsius / 100);
+}
+export function addOnOffHandlers(endpoint, featureId, ctx) {
+    endpoint.addCommandHandler('on', () => {
+        ctx.onFeatureUpdate(featureId, 1);
+        endpoint.setAttribute(OnOff.Cluster.id, 'onOff', true);
+    });
+    endpoint.addCommandHandler('off', () => {
+        ctx.onFeatureUpdate(featureId, 0);
+        endpoint.setAttribute(OnOff.Cluster.id, 'onOff', false);
+    });
+}
+export function multiFeatureResult(endpoint, handlers) {
+    return {
+        endpoint,
+        featureIds: [...handlers.keys()],
+        updateAttribute(featureId, value) {
+            handlers.get(featureId)?.(value);
+        },
+    };
+}
+export function singleFeatureResult(endpoint, featureId, onUpdate) {
+    return {
+        endpoint,
+        featureIds: [featureId],
+        updateAttribute(fid, value) {
+            if (fid === featureId) {
+                onUpdate(value);
+            }
+        },
+    };
+}
+export function createSimpleOnOffDevice(deviceType, device, ctx, label) {
+    const onOffFeature = requireFeatureByEventType(device, EventTypeName.OnOff, ctx, label);
+    if (!onOffFeature) {
+        return null;
+    }
+    const isOn = (onOffFeature.value ?? 0) === 1;
+    const endpoint = createBridgedEndpoint([deviceType, bridgedNode], device, ctx)
+        .createDefaultOnOffClusterServer(isOn)
+        .addRequiredClusterServers();
+    addOnOffHandlers(endpoint, onOffFeature.id, ctx);
+    return singleFeatureResult(endpoint, onOffFeature.id, (value) => {
+        endpoint.setAttribute(OnOff.Cluster.id, 'onOff', value === 1);
+    });
+}
+//# sourceMappingURL=helpers.js.map

package/dist/src/devices/helpers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"helpers.js","sourceRoot":"","sources":["../../../src/devices/helpers.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AAEjE,OAAO,EAAE,KAAK,EAAE,MAAM,8BAA8B,CAAC;AAGrD,OAAO,EACL,qBAAqB,EACrB,sBAAsB,EACtB,eAAe,EACf,QAAQ,EACR,eAAe,EACf,WAAW,GACZ,MAAM,UAAU,CAAC;AAElB,OAAO,EAAE,aAAa,EAAwB,MAAM,UAAU,CAAC;AAC/D,OAAO,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAGvC,OAAO,EAAE,WAAW,EAAE,CAAC;AAEvB,SAAS,YAAY,CAAC,MAAc;IAClC,OAAO,SAAS,MAAM,CAAC,EAAE,EAAE,CAAC;AAC9B,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,MAAc,EAAE,QAAyB,EAAE,GAAyB,EAAE,KAAa;IAChH,MAAM,OAAO,GAAG,qBAAqB,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;IACxD,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,UAAU,MAAM,CAAC,IAAI,YAAY,QAAQ,gBAAgB,KAAK,EAAE,CAAC,CAAC;IACjF,CAAC;IACD,OAAO,OAAO,IAAI,IAAI,CAAC;AACzB,CAAC;AAED,SAAS,yBAAyB,CAChC,MAAc,EACd,aAA4B,EAC5B,GAAyB,EACzB,KAAa;IAEb,MAAM,OAAO,GAAG,sBAAsB,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC;IAC9D,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,UAAU,MAAM,CAAC,IAAI,YAAY,aAAa,gBAAgB,KAAK,EAAE,CAAC,CAAC;IACtF,CAAC;IACD,OAAO,OAAO,IAAI,IAAI,CAAC;AACzB,CAAC;AAED,MAAM,UAAU,qBAAqB,CACnC,WAA8D,EAC9D,MAAc,EACd,GAAyB;IAEzB,OAAO,IAAI,oBAAoB,CAAC,WAAW,EAAE,EAAE,EAAE,EAAE,YAAY,CAAC,MAAM,CAAC,EAAE,EAAE,GAAG,CAAC,KAAK,CAAC;SAClF,kCAAkC,EAAE;SACpC,uDAAuD,CACtD,MAAM,CAAC,IAAI,EACX,eAAe,CAAC,MAAM,CAAC,EACvB,SAAS,EACT,eAAe,CAAC,MAAM,CAAC,EACvB,QAAQ,CAAC,MAAM,CAAC,CACjB,CAAC;AACN,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,UAAkB;IAC9C,OAAO,IAAI,CAAC,KAAK,CAAC,UAAU,GAAG,GAAG,CAAC,CAAC;AACtC,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,WAAmB;IACjD,OAAO,WAAW,GAAG,GAAG,CAAC;AAC3B,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,aAAqB;IACpD,OAAO,IAAI,CAAC,KAAK,CAAC,aAAa,GAAG,KAAK,CAAC,CAAC;AAC3C,CAAC;AAED,MAAM,UAAU,SAAS,CAAC,UAAkB;IAC1C,OAAO,WAAW,CAAC,SAAS,CAAC,UAAU,CAAC,CAAC;AAC3C,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAC,UAAkB;IACrD,OAAO,IAAI,CAAC,KAAK,CAAC,WAAW,CAAC,SAAS,CAAC,UAAU,CAAC,GAAG,GAAG,CAAC,CAAC;AAC7D,CAAC;AAED,MAAM,UAAU,sBAAsB,CAAC,YAAoB;IACzD,OAAO,WAAW,CAAC,YAAY,CAAC,YAAY,GAAG,GAAG,CAAC,CAAC;AACtD,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,QAA8B,EAAE,SAAiB,EAAE,GAAyB;IAC3G,QAAQ,CAAC,iBAAiB,CAAC,IAAI,EAAE,GAAG,EAAE;QACpC,GAAG,CAAC,eAAe,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC;QAClC,QAAQ,CAAC,YAAY,CAAC,KAAK,CAAC,OAAO,CAAC,EAAE,EAAE,OAAO,EAAE,IAAI,CAAC,CAAC;IACzD,CAAC,CAAC,CAAC;IACH,QAAQ,CAAC,iBAAiB,CAAC,KAAK,EAAE,GAAG,EAAE;QACrC,GAAG,CAAC,eAAe,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC;QAClC,QAAQ,CAAC,YAAY,CAAC,KAAK,CAAC,OAAO,CAAC,EAAE,EAAE,OAAO,EAAE,KAAK,CAAC,CAAC;IAC1D,CAAC,CAAC,CAAC;AACL,CAAC;AAED,MAAM,UAAU,kBAAkB,CAChC,QAA8B,EAC9B,QAA8C;IAE9C,OAAO;QACL,QAAQ;QACR,UAAU,EAAE,CAAC,GAAG,QAAQ,CAAC,IAAI,EAAE,CAAC;QAChC,eAAe,CAAC,SAAS,EAAE,KAAK;YAC9B,QAAQ,CAAC,GAAG,CAAC,SAAS,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC;QACnC,CAAC;KACF,CAAC;AACJ,CAAC;AACD,MAAM,UAAU,mBAAmB,CACjC,QAA8B,EAC9B,SAAiB,EACjB,QAAiC;IAEjC,OAAO;QACL,QAAQ;QACR,UAAU,EAAE,CAAC,SAAS,CAAC;QACvB,eAAe,CAAC,GAAG,EAAE,KAAK;YACxB,IAAI,GAAG,KAAK,SAAS,EAAE,CAAC;gBACtB,QAAQ,CAAC,KAAK,CAAC,CAAC;YAClB,CAAC;QACH,CAAC;KACF,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,uBAAuB,CACrC,UAAgC,EAChC,MAAc,EACd,GAAyB,EACzB,KAAa;IAEb,MAAM,YAAY,GAAG,yBAAyB,CAAC,MAAM,EAAE,aAAa,CAAC,KAAK,EAAE,GAAG,EAAE,KAAK,CAAC,CAAC;IAExF,IAAI,CAAC,YAAY,EAAE,CAAC;QAClB,OAAO,IAAI,CAAC;IACd,CAAC;IAED,MAAM,IAAI,GAAG,CAAC,YAAY,CAAC,KAAK,IAAI,CAAC,CAAC,KAAK,CAAC,CAAC;IAE7C,MAAM,QAAQ,GAAG,qBAAqB,CAAC,CAAC,UAAU,EAAE,WAAW,CAAC,EAAE,MAAM,EAAE,GAAG,CAAC;SAC3E,+BAA+B,CAAC,IAAI,CAAC;SACrC,yBAAyB,EAAE,CAAC;IAE/B,gBAAgB,CAAC,QAAQ,EAAE,YAAY,CAAC,EAAE,EAAE,GAAG,CAAC,CAAC;IAEjD,OAAO,mBAAmB,CAAC,QAAQ,EAAE,YAAY,CAAC,EAAE,EAAE,CAAC,KAAK,EAAE,EAAE;QAC9D,QAAQ,CAAC,YAAY,CAAC,KAAK,CAAC,OAAO,CAAC,EAAE,EAAE,OAAO,EAAE,KAAK,KAAK,CAAC,CAAC,CAAC;IAChE,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/src/devices/lights.d.ts

@@ -0,0 +1,4 @@
+import { type Device } from 'iotas-ts';
+import type { DeviceFactoryContext, EndpointResult } from './types.js';
+export declare function createDimmableLight(device: Device, ctx: DeviceFactoryContext): EndpointResult | null;
+export declare function createOnOffLight(device: Device, ctx: DeviceFactoryContext): EndpointResult | null;

package/dist/src/devices/lights.js

@@ -0,0 +1,71 @@
+import { dimmableLight, onOffLight } from 'matterbridge';
+import { LevelControl, OnOff } from 'matterbridge/matter/clusters';
+import { EventTypeName, findFeatureByEventType } from 'iotas-ts';
+import { addOnOffHandlers, bridgedNode, createBridgedEndpoint, createSimpleOnOffDevice, fromMatterLevel, multiFeatureResult, singleFeatureResult, toMatterLevel, } from './helpers.js';
+function createStandardDimmableLight(device, ctx, onOffFeature, levelFeature, level) {
+    const isOn = (onOffFeature.value ?? 0) === 1;
+    const endpoint = createBridgedEndpoint([dimmableLight, bridgedNode], device, ctx)
+        .createDefaultOnOffClusterServer(isOn)
+        .createDefaultLevelControlClusterServer(level)
+        .addRequiredClusterServers();
+    addOnOffHandlers(endpoint, onOffFeature.id, ctx);
+    endpoint.addCommandHandler('moveToLevel', ({ request }) => {
+        const matterLevel = request.level;
+        const iotasLevel = fromMatterLevel(matterLevel);
+        ctx.onFeatureUpdate(levelFeature.id, iotasLevel);
+        endpoint.setAttribute(LevelControl.Cluster.id, 'currentLevel', matterLevel);
+    });
+    return multiFeatureResult(endpoint, new Map([
+        [onOffFeature.id, (value) => endpoint.setAttribute(OnOff.Cluster.id, 'onOff', value === 1)],
+        [
+            levelFeature.id,
+            (value) => endpoint.setAttribute(LevelControl.Cluster.id, 'currentLevel', toMatterLevel(value)),
+        ],
+    ]));
+}
+function createLevelOnlyDimmableLight(device, ctx, levelFeature, level) {
+    const isOn = (levelFeature.value ?? 0) > 0;
+    const endpoint = createBridgedEndpoint([dimmableLight, bridgedNode], device, ctx)
+        .createDefaultOnOffClusterServer(isOn)
+        .createDefaultLevelControlClusterServer(level)
+        .addRequiredClusterServers();
+    // On/off synthesized from level — send level value to the single IOTAS feature
+    endpoint.addCommandHandler('on', () => {
+        ctx.onFeatureUpdate(levelFeature.id, 1);
+        endpoint.setAttribute(OnOff.Cluster.id, 'onOff', true);
+        endpoint.setAttribute(LevelControl.Cluster.id, 'currentLevel', 254);
+    });
+    endpoint.addCommandHandler('off', () => {
+        ctx.onFeatureUpdate(levelFeature.id, 0);
+        endpoint.setAttribute(OnOff.Cluster.id, 'onOff', false);
+        endpoint.setAttribute(LevelControl.Cluster.id, 'currentLevel', 0);
+    });
+    endpoint.addCommandHandler('moveToLevel', ({ request }) => {
+        const matterLevel = request.level;
+        const iotasLevel = fromMatterLevel(matterLevel);
+        ctx.onFeatureUpdate(levelFeature.id, iotasLevel);
+        endpoint.setAttribute(LevelControl.Cluster.id, 'currentLevel', matterLevel);
+        endpoint.setAttribute(OnOff.Cluster.id, 'onOff', matterLevel > 0);
+    });
+    return singleFeatureResult(endpoint, levelFeature.id, (value) => {
+        endpoint.setAttribute(LevelControl.Cluster.id, 'currentLevel', toMatterLevel(value));
+        endpoint.setAttribute(OnOff.Cluster.id, 'onOff', value > 0);
+    });
+}
+export function createDimmableLight(device, ctx) {
+    const onOffFeature = findFeatureByEventType(device, EventTypeName.OnOff);
+    const levelFeature = findFeatureByEventType(device, EventTypeName.Level);
+    if (!levelFeature) {
+        ctx.log.warn(`Device ${device.name} missing Level feature for dimmable light`);
+        return null;
+    }
+    const level = toMatterLevel(levelFeature.value ?? 0);
+    if (onOffFeature) {
+        return createStandardDimmableLight(device, ctx, onOffFeature, levelFeature, level);
+    }
+    return createLevelOnlyDimmableLight(device, ctx, levelFeature, level);
+}
+export function createOnOffLight(device, ctx) {
+    return createSimpleOnOffDevice(onOffLight, device, ctx, 'light');
+}
+//# sourceMappingURL=lights.js.map

package/dist/src/devices/lights.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lights.js","sourceRoot":"","sources":["../../../src/devices/lights.ts"],"names":[],"mappings":"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"}

package/dist/src/devices/lock.d.ts

@@ -0,0 +1,3 @@
+import { type Device } from 'iotas-ts';
+import type { DeviceFactoryContext, EndpointResult } from './types.js';
+export declare function createDoorLock(device: Device, ctx: DeviceFactoryContext): EndpointResult | null;

package/dist/src/devices/lock.js

@@ -0,0 +1,44 @@
+import { doorLockDevice } from 'matterbridge';
+import { DoorLock, PowerSource } from 'matterbridge/matter/clusters';
+import { FeatureCategory, findFeatureByCategory } from 'iotas-ts';
+import { bridgedNode, createBridgedEndpoint, multiFeatureResult, requireFeature } from './helpers.js';
+export function createDoorLock(device, ctx) {
+    const lockFeature = requireFeature(device, FeatureCategory.Lock, ctx, 'door lock');
+    if (!lockFeature) {
+        return null;
+    }
+    const isLocked = (lockFeature.value ?? 0) === 1;
+    const lockState = isLocked ? DoorLock.LockState.Locked : DoorLock.LockState.Unlocked;
+    const endpoint = createBridgedEndpoint([doorLockDevice, bridgedNode], device, ctx)
+        .createDefaultDoorLockClusterServer(lockState)
+        .addRequiredClusterServers();
+    endpoint.addCommandHandler('lockDoor', () => {
+        ctx.onFeatureUpdate(lockFeature.id, 1);
+        endpoint.setAttribute(DoorLock.Cluster.id, 'lockState', DoorLock.LockState.Locked);
+    });
+    endpoint.addCommandHandler('unlockDoor', () => {
+        ctx.onFeatureUpdate(lockFeature.id, 0);
+        endpoint.setAttribute(DoorLock.Cluster.id, 'lockState', DoorLock.LockState.Unlocked);
+    });
+    const handlers = new Map([
+        [
+            lockFeature.id,
+            (value) => {
+                endpoint.setAttribute(DoorLock.Cluster.id, 'lockState', value === 1 ? DoorLock.LockState.Locked : DoorLock.LockState.Unlocked);
+            },
+        ],
+    ]);
+    const batteryFeature = findFeatureByCategory(device, FeatureCategory.Battery);
+    if (batteryFeature) {
+        const batteryPercent = Math.min(Math.round(batteryFeature.value ?? 0), 100);
+        const matterPercent = batteryPercent * 2; // Matter uses 0-200 (0.5% steps)
+        endpoint.createDefaultPowerSourceReplaceableBatteryClusterServer(matterPercent, batteryPercent < 20 ? PowerSource.BatChargeLevel.Critical : PowerSource.BatChargeLevel.Ok, batteryPercent * 30, 'CR123A', 1, PowerSource.BatReplaceability.UserReplaceable);
+        handlers.set(batteryFeature.id, (value) => {
+            const percent = Math.min(Math.round(value), 100);
+            endpoint.setAttribute(PowerSource.Cluster.id, 'batPercentRemaining', percent * 2);
+            endpoint.setAttribute(PowerSource.Cluster.id, 'batChargeLevel', percent < 20 ? PowerSource.BatChargeLevel.Critical : PowerSource.BatChargeLevel.Ok);
+        });
+    }
+    return multiFeatureResult(endpoint, handlers);
+}
+//# sourceMappingURL=lock.js.map

package/dist/src/devices/lock.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lock.js","sourceRoot":"","sources":["../../../src/devices/lock.ts"],"names":[],"mappings":"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"}

package/dist/src/devices/outlet.d.ts

@@ -0,0 +1,3 @@
+import type { Device } from 'iotas-ts';
+import type { DeviceFactoryContext, EndpointResult } from './types.js';
+export declare function createOnOffOutlet(device: Device, ctx: DeviceFactoryContext): EndpointResult | null;

package/dist/src/devices/outlet.js

@@ -0,0 +1,6 @@
+import { onOffOutlet } from 'matterbridge';
+import { createSimpleOnOffDevice } from './helpers.js';
+export function createOnOffOutlet(device, ctx) {
+    return createSimpleOnOffDevice(onOffOutlet, device, ctx, 'outlet');
+}
+//# sourceMappingURL=outlet.js.map

package/dist/src/devices/outlet.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"outlet.js","sourceRoot":"","sources":["../../../src/devices/outlet.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAK3C,OAAO,EAAE,uBAAuB,EAAE,MAAM,cAAc,CAAC;AAEvD,MAAM,UAAU,iBAAiB,CAAC,MAAc,EAAE,GAAyB;IACzE,OAAO,uBAAuB,CAAC,WAAW,EAAE,MAAM,EAAE,GAAG,EAAE,QAAQ,CAAC,CAAC;AACrE,CAAC"}

package/dist/src/devices/sensors.d.ts

@@ -0,0 +1,5 @@
+import { type Device } from 'iotas-ts';
+import type { DeviceFactoryContext, EndpointResult } from './types.js';
+export declare function createHumiditySensor(device: Device, ctx: DeviceFactoryContext): EndpointResult | null;
+export declare function createOccupancySensor(device: Device, ctx: DeviceFactoryContext): EndpointResult | null;
+export declare function createContactSensor(device: Device, ctx: DeviceFactoryContext): EndpointResult | null;

package/dist/src/devices/sensors.js

@@ -0,0 +1,44 @@
+import { contactSensor, humiditySensor, occupancySensor } from 'matterbridge';
+import { BooleanState, OccupancySensing, RelativeHumidityMeasurement } from 'matterbridge/matter/clusters';
+import { FeatureCategory } from 'iotas-ts';
+import { bridgedNode, createBridgedEndpoint, requireFeature, singleFeatureResult, toMatterHumidity, } from './helpers.js';
+export function createHumiditySensor(device, ctx) {
+    const humidityFeature = requireFeature(device, FeatureCategory.Humidity, ctx, 'humidity sensor');
+    if (!humidityFeature) {
+        return null;
+    }
+    const humidity = toMatterHumidity(humidityFeature.value ?? 0);
+    const endpoint = createBridgedEndpoint([humiditySensor, bridgedNode], device, ctx)
+        .createDefaultRelativeHumidityMeasurementClusterServer(humidity)
+        .addRequiredClusterServers();
+    return singleFeatureResult(endpoint, humidityFeature.id, (value) => {
+        endpoint.setAttribute(RelativeHumidityMeasurement.Cluster.id, 'measuredValue', toMatterHumidity(value));
+    });
+}
+export function createOccupancySensor(device, ctx) {
+    const motionFeature = requireFeature(device, FeatureCategory.Motion, ctx, 'occupancy sensor');
+    if (!motionFeature) {
+        return null;
+    }
+    const occupied = (motionFeature.value ?? 0) === 1;
+    const endpoint = createBridgedEndpoint([occupancySensor, bridgedNode], device, ctx)
+        .createDefaultOccupancySensingClusterServer(occupied)
+        .addRequiredClusterServers();
+    return singleFeatureResult(endpoint, motionFeature.id, (value) => {
+        endpoint.setAttribute(OccupancySensing.Cluster.id, 'occupancy', { occupied: value === 1 });
+    });
+}
+export function createContactSensor(device, ctx) {
+    const doorFeature = requireFeature(device, FeatureCategory.DoorState, ctx, 'contact sensor');
+    if (!doorFeature) {
+        return null;
+    }
+    const contactState = (doorFeature.value ?? 0) === 1;
+    const endpoint = createBridgedEndpoint([contactSensor, bridgedNode], device, ctx)
+        .createDefaultBooleanStateClusterServer(contactState)
+        .addRequiredClusterServers();
+    return singleFeatureResult(endpoint, doorFeature.id, (value) => {
+        endpoint.setAttribute(BooleanState.Cluster.id, 'stateValue', value === 1);
+    });
+}
+//# sourceMappingURL=sensors.js.map

package/dist/src/devices/sensors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sensors.js","sourceRoot":"","sources":["../../../src/devices/sensors.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAC9E,OAAO,EAAE,YAAY,EAAE,gBAAgB,EAAE,2BAA2B,EAAE,MAAM,8BAA8B,CAAC;AAE3G,OAAO,EAAE,eAAe,EAAe,MAAM,UAAU,CAAC;AAGxD,OAAO,EACL,WAAW,EACX,qBAAqB,EACrB,cAAc,EACd,mBAAmB,EACnB,gBAAgB,GACjB,MAAM,cAAc,CAAC;AAEtB,MAAM,UAAU,oBAAoB,CAAC,MAAc,EAAE,GAAyB;IAC5E,MAAM,eAAe,GAAG,cAAc,CAAC,MAAM,EAAE,eAAe,CAAC,QAAQ,EAAE,GAAG,EAAE,iBAAiB,CAAC,CAAC;IAEjG,IAAI,CAAC,eAAe,EAAE,CAAC;QACrB,OAAO,IAAI,CAAC;IACd,CAAC;IAED,MAAM,QAAQ,GAAG,gBAAgB,CAAC,eAAe,CAAC,KAAK,IAAI,CAAC,CAAC,CAAC;IAE9D,MAAM,QAAQ,GAAG,qBAAqB,CAAC,CAAC,cAAc,EAAE,WAAW,CAAC,EAAE,MAAM,EAAE,GAAG,CAAC;SAC/E,qDAAqD,CAAC,QAAQ,CAAC;SAC/D,yBAAyB,EAAE,CAAC;IAE/B,OAAO,mBAAmB,CAAC,QAAQ,EAAE,eAAe,CAAC,EAAE,EAAE,CAAC,KAAK,EAAE,EAAE;QACjE,QAAQ,CAAC,YAAY,CAAC,2BAA2B,CAAC,OAAO,CAAC,EAAE,EAAE,eAAe,EAAE,gBAAgB,CAAC,KAAK,CAAC,CAAC,CAAC;IAC1G,CAAC,CAAC,CAAC;AACL,CAAC;AAED,MAAM,UAAU,qBAAqB,CAAC,MAAc,EAAE,GAAyB;IAC7E,MAAM,aAAa,GAAG,cAAc,CAAC,MAAM,EAAE,eAAe,CAAC,MAAM,EAAE,GAAG,EAAE,kBAAkB,CAAC,CAAC;IAE9F,IAAI,CAAC,aAAa,EAAE,CAAC;QACnB,OAAO,IAAI,CAAC;IACd,CAAC;IAED,MAAM,QAAQ,GAAG,CAAC,aAAa,CAAC,KAAK,IAAI,CAAC,CAAC,KAAK,CAAC,CAAC;IAElD,MAAM,QAAQ,GAAG,qBAAqB,CAAC,CAAC,eAAe,EAAE,WAAW,CAAC,EAAE,MAAM,EAAE,GAAG,CAAC;SAChF,0CAA0C,CAAC,QAAQ,CAAC;SACpD,yBAAyB,EAAE,CAAC;IAE/B,OAAO,mBAAmB,CAAC,QAAQ,EAAE,aAAa,CAAC,EAAE,EAAE,CAAC,KAAK,EAAE,EAAE;QAC/D,QAAQ,CAAC,YAAY,CAAC,gBAAgB,CAAC,OAAO,CAAC,EAAE,EAAE,WAAW,EAAE,EAAE,QAAQ,EAAE,KAAK,KAAK,CAAC,EAAE,CAAC,CAAC;IAC7F,CAAC,CAAC,CAAC;AACL,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,MAAc,EAAE,GAAyB;IAC3E,MAAM,WAAW,GAAG,cAAc,CAAC,MAAM,EAAE,eAAe,CAAC,SAAS,EAAE,GAAG,EAAE,gBAAgB,CAAC,CAAC;IAE7F,IAAI,CAAC,WAAW,EAAE,CAAC;QACjB,OAAO,IAAI,CAAC;IACd,CAAC;IAED,MAAM,YAAY,GAAG,CAAC,WAAW,CAAC,KAAK,IAAI,CAAC,CAAC,KAAK,CAAC,CAAC;IAEpD,MAAM,QAAQ,GAAG,qBAAqB,CAAC,CAAC,aAAa,EAAE,WAAW,CAAC,EAAE,MAAM,EAAE,GAAG,CAAC;SAC9E,sCAAsC,CAAC,YAAY,CAAC;SACpD,yBAAyB,EAAE,CAAC;IAE/B,OAAO,mBAAmB,CAAC,QAAQ,EAAE,WAAW,CAAC,EAAE,EAAE,CAAC,KAAK,EAAE,EAAE;QAC7D,QAAQ,CAAC,YAAY,CAAC,YAAY,CAAC,OAAO,CAAC,EAAE,EAAE,YAAY,EAAE,KAAK,KAAK,CAAC,CAAC,CAAC;IAC5E,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/src/devices/thermostat.d.ts

@@ -0,0 +1,9 @@
+import { Thermostat } from 'matterbridge/matter/clusters';
+import { type Device } from 'iotas-ts';
+import type { DeviceFactoryContext, EndpointResult } from './types.js';
+/**
+ * Map IOTAS thermostat mode values to Matter SystemMode.
+ * ThermostatMode enum values match IOTAS indices: 0=Off, 1=Heat, 2=Cool, 3=EmergencyHeat, 4=Auto
+ */
+export declare function iotasModeToSystemMode(iotasMode: number): Thermostat.SystemMode;
+export declare function createThermostat(device: Device, ctx: DeviceFactoryContext): EndpointResult | null;

package/dist/src/devices/thermostat.js

@@ -0,0 +1,95 @@
+import { thermostatDevice } from 'matterbridge';
+import { Thermostat } from 'matterbridge/matter/clusters';
+import { FeatureCategory, ThermostatMode, findFeatureByCategory } from 'iotas-ts';
+import { bridgedNode, createBridgedEndpoint, fromMatterCentiCelsius, multiFeatureResult, requireFeature, toCelsius, toMatterCentiCelsius, } from './helpers.js';
+/**
+ * Map IOTAS thermostat mode values to Matter SystemMode.
+ * ThermostatMode enum values match IOTAS indices: 0=Off, 1=Heat, 2=Cool, 3=EmergencyHeat, 4=Auto
+ */
+export function iotasModeToSystemMode(iotasMode) {
+    const mode = iotasMode;
+    switch (mode) {
+        case ThermostatMode.Heat:
+            return Thermostat.SystemMode.Heat;
+        case ThermostatMode.Cool:
+            return Thermostat.SystemMode.Cool;
+        case ThermostatMode.EmergencyHeat:
+            return Thermostat.SystemMode.EmergencyHeat;
+        case ThermostatMode.Auto:
+            return Thermostat.SystemMode.Auto;
+        default:
+            return Thermostat.SystemMode.Off;
+    }
+}
+function systemModeToIotasMode(systemMode) {
+    switch (systemMode) {
+        case Thermostat.SystemMode.Heat:
+            return ThermostatMode.Heat;
+        case Thermostat.SystemMode.Cool:
+            return ThermostatMode.Cool;
+        case Thermostat.SystemMode.EmergencyHeat:
+            return ThermostatMode.EmergencyHeat;
+        case Thermostat.SystemMode.Auto:
+            return ThermostatMode.Auto;
+        default:
+            return ThermostatMode.Off;
+    }
+}
+export function createThermostat(device, ctx) {
+    const tempFeature = requireFeature(device, FeatureCategory.CurrentTemperature, ctx, 'thermostat');
+    const modeFeature = findFeatureByCategory(device, FeatureCategory.ThermostatMode);
+    const heatSetpointFeature = findFeatureByCategory(device, FeatureCategory.HeatSetPoint);
+    const coolSetpointFeature = findFeatureByCategory(device, FeatureCategory.CoolSetPoint);
+    if (!tempFeature) {
+        return null;
+    }
+    const currentTempC = toCelsius(tempFeature.value ?? 70);
+    const heatSetpointC = toCelsius(heatSetpointFeature?.value ?? 68);
+    const coolSetpointC = toCelsius(coolSetpointFeature?.value ?? 76);
+    const endpoint = createBridgedEndpoint([thermostatDevice, bridgedNode], device, ctx)
+        .createDefaultThermostatClusterServer(currentTempC, heatSetpointC, coolSetpointC)
+        .addRequiredClusterServers();
+    if (modeFeature) {
+        endpoint.subscribeAttribute(Thermostat.Cluster.id, 'systemMode', (newValue) => {
+            const iotasMode = systemModeToIotasMode(newValue);
+            ctx.onFeatureUpdate(modeFeature.id, iotasMode);
+        });
+    }
+    if (heatSetpointFeature) {
+        endpoint.subscribeAttribute(Thermostat.Cluster.id, 'occupiedHeatingSetpoint', (newValue) => {
+            const fahrenheit = fromMatterCentiCelsius(newValue);
+            ctx.onFeatureUpdate(heatSetpointFeature.id, fahrenheit);
+        });
+    }
+    if (coolSetpointFeature) {
+        endpoint.subscribeAttribute(Thermostat.Cluster.id, 'occupiedCoolingSetpoint', (newValue) => {
+            const fahrenheit = fromMatterCentiCelsius(newValue);
+            ctx.onFeatureUpdate(coolSetpointFeature.id, fahrenheit);
+        });
+    }
+    const handlers = new Map([
+        [
+            tempFeature.id,
+            (value) => {
+                endpoint.setAttribute(Thermostat.Cluster.id, 'localTemperature', toMatterCentiCelsius(value));
+            },
+        ],
+    ]);
+    if (modeFeature) {
+        handlers.set(modeFeature.id, (value) => {
+            endpoint.setAttribute(Thermostat.Cluster.id, 'systemMode', iotasModeToSystemMode(value));
+        });
+    }
+    if (heatSetpointFeature) {
+        handlers.set(heatSetpointFeature.id, (value) => {
+            endpoint.setAttribute(Thermostat.Cluster.id, 'occupiedHeatingSetpoint', toMatterCentiCelsius(value));
+        });
+    }
+    if (coolSetpointFeature) {
+        handlers.set(coolSetpointFeature.id, (value) => {
+            endpoint.setAttribute(Thermostat.Cluster.id, 'occupiedCoolingSetpoint', toMatterCentiCelsius(value));
+        });
+    }
+    return multiFeatureResult(endpoint, handlers);
+}
+//# sourceMappingURL=thermostat.js.map

package/dist/src/devices/thermostat.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"thermostat.js","sourceRoot":"","sources":["../../../src/devices/thermostat.ts"],"names":[],"mappings":"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"}

package/dist/src/devices/types.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Shared types for device factories.
+ */
+import type { MatterbridgeEndpoint } from 'matterbridge';
+import type { AnsiLogger } from 'matterbridge/logger';
+export declare const VENDOR_ID = 65521;
+/**
+ * Context for device creation, containing references to platform resources.
+ */
+export interface DeviceFactoryContext {
+    log: AnsiLogger;
+    debug: boolean;
+    onFeatureUpdate: (featureId: number, value: number) => void;
+}
+/**
+ * Result of creating an endpoint.
+ *
+ * Self-contained: includes the endpoint, the feature IDs it tracks,
+ * and a callback to push IOTAS value changes to Matter attributes.
+ * All per-device-kind logic is co-located in the factory that builds this.
+ */
+export interface EndpointResult {
+    endpoint: MatterbridgeEndpoint;
+    featureIds: number[];
+    updateAttribute: (featureId: number, value: number) => void;
+}

package/dist/src/devices/types.js

@@ -0,0 +1,5 @@
+/**
+ * Shared types for device factories.
+ */
+export const VENDOR_ID = 0xfff1;
+//# sourceMappingURL=types.js.map

package/dist/src/devices/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/devices/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAKH,MAAM,CAAC,MAAM,SAAS,GAAG,MAAM,CAAC"}

package/dist/src/module.d.ts

@@ -0,0 +1,24 @@
+import { MatterbridgeDynamicPlatform, PlatformConfig, PlatformMatterbridge } from 'matterbridge';
+import { AnsiLogger } from 'matterbridge/logger';
+import { FeatureCache, IotasClient } from 'iotas-ts';
+import type { SnapshotFilter } from 'iotas-ts';
+export interface IotasPluginConfig extends PlatformConfig {
+    username: string;
+    password: string;
+    unit?: string;
+    pollingInterval?: number;
+}
+export default function initializePlugin(matterbridge: PlatformMatterbridge, log: AnsiLogger, config: PlatformConfig): IotasPlatform;
+export declare class IotasPlatform extends MatterbridgeDynamicPlatform {
+    iotasClient: IotasClient;
+    featureCache: FeatureCache;
+    pollingInterval: number;
+    private deviceMap;
+    constructor(matterbridge: PlatformMatterbridge, log: AnsiLogger, config: IotasPluginConfig);
+    createSnapshotFilter(): SnapshotFilter | undefined;
+    onStart(reason?: string): Promise<void>;
+    onConfigure(): Promise<void>;
+    onShutdown(reason?: string): Promise<void>;
+    private discoverDevices;
+    private refreshStates;
+}