hoffmation-base 3.6.0 → 3.7.0

package/lib/action/airQualitySensorChangeAction.d.ts

@@ -0,0 +1,16 @@
+import { BaseAction } from './baseAction';
+import { CommandType } from '../enums';
+import { iAirQualityCollector, iAirQualityReadings } from '../interfaces';
+export declare class AirQualitySensorChangeAction extends BaseAction {
+    /** @inheritDoc */
+    type: CommandType;
+    /**
+     * The new readings of the sensor
+     */
+    readonly newReadings: iAirQualityReadings;
+    /**
+     * The sensor that triggered the action
+     */
+    readonly sensor: iAirQualityCollector;
+    constructor(sensor: iAirQualityCollector, newReadings: iAirQualityReadings);
+}

package/lib/action/airQualitySensorChangeAction.js

@@ -0,0 +1,15 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AirQualitySensorChangeAction = void 0;
+const baseAction_1 = require("./baseAction");
+const enums_1 = require("../enums");
+class AirQualitySensorChangeAction extends baseAction_1.BaseAction {
+    constructor(sensor, newReadings) {
+        super(enums_1.CommandSource.Automatic, `${sensor.customName} detected an air quality index of ${newReadings.aqi}`);
+        /** @inheritDoc */
+        this.type = enums_1.CommandType.AirQualitySensorChangeAction;
+        this.newReadings = newReadings;
+        this.sensor = sensor;
+    }
+}
+exports.AirQualitySensorChangeAction = AirQualitySensorChangeAction;

package/lib/action/index.d.ts

@@ -1,3 +1,4 @@
+export { AirQualitySensorChangeAction } from './airQualitySensorChangeAction';
 export { BaseAction } from './baseAction';
 export { HumiditySensorChangeAction } from './humiditySensorChangeAction';
 export { MotionSensorAction } from './motionSensorAction';

package/lib/action/index.js

@@ -1,6 +1,8 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.DingSensorAction = exports.HandleChangeAction = exports.PresenceGroupAnyMovementAction = exports.BatteryLevelChangeAction = exports.ActuatorChangeAction = exports.TemperatureSensorChangeAction = exports.ShutterPositionChangedAction = exports.PresenceGroupFirstEnterAction = exports.PresenceGroupLastLeftAction = exports.MotionSensorAction = exports.HumiditySensorChangeAction = exports.BaseAction = void 0;
+exports.DingSensorAction = exports.HandleChangeAction = exports.PresenceGroupAnyMovementAction = exports.BatteryLevelChangeAction = exports.ActuatorChangeAction = exports.TemperatureSensorChangeAction = exports.ShutterPositionChangedAction = exports.PresenceGroupFirstEnterAction = exports.PresenceGroupLastLeftAction = exports.MotionSensorAction = exports.HumiditySensorChangeAction = exports.BaseAction = exports.AirQualitySensorChangeAction = void 0;
+var airQualitySensorChangeAction_1 = require("./airQualitySensorChangeAction");
+Object.defineProperty(exports, "AirQualitySensorChangeAction", { enumerable: true, get: function () { return airQualitySensorChangeAction_1.AirQualitySensorChangeAction; } });
 var baseAction_1 = require("./baseAction");
 Object.defineProperty(exports, "BaseAction", { enumerable: true, get: function () { return baseAction_1.BaseAction; } });
 var humiditySensorChangeAction_1 = require("./humiditySensorChangeAction");

package/lib/devices/sharedFunctions/airQualitySensor.d.ts

@@ -0,0 +1,27 @@
+import { iAirQualityCollector, iAirQualityReadings, iAirQualitySensor } from '../../interfaces';
+import { AirQualitySensorChangeAction } from '../../action';
+export declare class AirQualitySensor implements iAirQualitySensor {
+    private readonly _device;
+    /** @inheritDoc */
+    readonly jsonOmitKeys: string[];
+    /** @inheritDoc */
+    lastSeen: number;
+    private readonly _readings;
+    private _airQualityCallbacks;
+    private readonly _persistAirQualitySensorInterval;
+    constructor(_device: iAirQualityCollector);
+    /** @inheritDoc */
+    get readings(): iAirQualityReadings;
+    /** @inheritDoc */
+    update(readings: Partial<iAirQualityReadings>): void;
+    /** @inheritDoc */
+    reports(metric: keyof iAirQualityReadings): boolean;
+    /** @inheritDoc */
+    persist(): void;
+    /** @inheritDoc */
+    addAirQualityCallback(pCallback: (action: AirQualitySensorChangeAction) => void): void;
+    /** @inheritDoc */
+    dispose(): void;
+    /** @inheritDoc */
+    toJSON(): Partial<AirQualitySensor>;
+}

package/lib/devices/sharedFunctions/airQualitySensor.js

@@ -0,0 +1,87 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AirQualitySensor = void 0;
+const interfaces_1 = require("../../interfaces");
+const action_1 = require("../../action");
+const utils_1 = require("../../utils");
+const services_1 = require("../../services");
+class AirQualitySensor {
+    constructor(_device) {
+        this._device = _device;
+        /** @inheritDoc */
+        this.jsonOmitKeys = ['_device'];
+        /** @inheritDoc */
+        this.lastSeen = 0;
+        this._readings = {
+            aqi: interfaces_1.UNDEFINED_AIR_QUALITY_VALUE,
+            co2: interfaces_1.UNDEFINED_AIR_QUALITY_VALUE,
+            nox: interfaces_1.UNDEFINED_AIR_QUALITY_VALUE,
+            pm1p0: interfaces_1.UNDEFINED_AIR_QUALITY_VALUE,
+            pm2p5: interfaces_1.UNDEFINED_AIR_QUALITY_VALUE,
+            pm4p0: interfaces_1.UNDEFINED_AIR_QUALITY_VALUE,
+            pm10p0: interfaces_1.UNDEFINED_AIR_QUALITY_VALUE,
+            tvoc: interfaces_1.UNDEFINED_AIR_QUALITY_VALUE,
+            vape: interfaces_1.UNDEFINED_AIR_QUALITY_VALUE,
+            voc: interfaces_1.UNDEFINED_AIR_QUALITY_VALUE,
+        };
+        this._airQualityCallbacks = [];
+        this._persistAirQualitySensorInterval = utils_1.Utils.guardedInterval(() => {
+            this.persist();
+        }, 5 * 60 * 1000, this, false);
+    }
+    /** @inheritDoc */
+    get readings() {
+        return { ...this._readings };
+    }
+    /** @inheritDoc */
+    update(readings) {
+        this.lastSeen = utils_1.Utils.nowMS();
+        let changed = false;
+        for (const [key, value] of Object.entries(readings)) {
+            if (value === undefined || this._readings[key] === value) {
+                continue;
+            }
+            this._readings[key] = value;
+            changed = true;
+        }
+        if (!changed) {
+            // The controller repeats unchanged readings every few seconds --> don't bother the consumers with those.
+            return;
+        }
+        const snapshot = this.readings;
+        for (const cb of this._airQualityCallbacks) {
+            cb(new action_1.AirQualitySensorChangeAction(this._device, snapshot));
+        }
+    }
+    /** @inheritDoc */
+    reports(metric) {
+        return this._readings[metric] !== interfaces_1.UNDEFINED_AIR_QUALITY_VALUE;
+    }
+    /** @inheritDoc */
+    persist() {
+        var _a;
+        if (this.lastSeen === 0) {
+            // Nothing was ever reported --> persisting would only write a row of undefined values.
+            return;
+        }
+        (_a = services_1.Persistence.dbo) === null || _a === void 0 ? void 0 : _a.persistAirQualitySensor(this._device);
+    }
+    /** @inheritDoc */
+    addAirQualityCallback(pCallback) {
+        this._airQualityCallbacks.push(pCallback);
+        if (this.lastSeen > 0) {
+            pCallback(new action_1.AirQualitySensorChangeAction(this._device, this.readings));
+        }
+    }
+    /** @inheritDoc */
+    dispose() {
+        if (this._persistAirQualitySensorInterval) {
+            clearInterval(this._persistAirQualitySensorInterval);
+        }
+    }
+    /** @inheritDoc */
+    toJSON() {
+        return utils_1.Utils.jsonFilter(this, this.jsonOmitKeys);
+    }
+}
+exports.AirQualitySensor = AirQualitySensor;

package/lib/devices/sharedFunctions/index.d.ts

@@ -1,3 +1,4 @@
+export * from './airQualitySensor';
 export * from './battery';
 export * from './handleSensor';
 export * from './humiditySensor';

package/lib/devices/sharedFunctions/index.js

@@ -14,6 +14,7 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
     for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
 };
 Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./airQualitySensor"), exports);
 __exportStar(require("./battery"), exports);
 __exportStar(require("./handleSensor"), exports);
 __exportStar(require("./humiditySensor"), exports);

package/lib/devices/unifi/index.d.ts

@@ -1,3 +1,4 @@
+export * from './own-unifi-air-quality-sensor';
 export * from './own-unifi-camera';
 export * from './unifi-protect';
 export * from './unifi-access';

package/lib/devices/unifi/index.js

@@ -14,6 +14,7 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
     for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
 };
 Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./own-unifi-air-quality-sensor"), exports);
 __exportStar(require("./own-unifi-camera"), exports);
 __exportStar(require("./unifi-protect"), exports);
 __exportStar(require("./unifi-access"), exports);

package/lib/devices/unifi/own-unifi-air-quality-sensor.d.ts

@@ -0,0 +1,81 @@
+import type { ProtectSensorConfig, Sensor } from 'unifi-protect';
+import { iAirQualityCollector, iAirQualityReadings, iAirQualitySensor, iHumidityCollector, iHumiditySensor, iTemperatureCollector } from '../../interfaces';
+import { AirQualitySensorChangeAction, HumiditySensorChangeAction, TemperatureSensorChangeAction } from '../../action';
+import { TemperatureSensor } from '../sharedFunctions';
+import { RoomBaseDevice } from '../RoomBaseDevice';
+/**
+ * A UniFi Protect "UP Air Quality" sensor.
+ *
+ * The device reports temperature and humidity alongside its air quality metrics, so it acts as all three
+ * collectors at once and its temperature/humidity history lands in the database like any other sensor.
+ */
+export declare class OwnUnifiAirQualitySensor extends RoomBaseDevice implements iTemperatureCollector, iHumidityCollector, iAirQualityCollector {
+    /**
+     * The name of the sensor as written in Unifi-Protect
+     */
+    readonly unifiSensorName: string;
+    /**
+     * The human readable name of this device
+     */
+    readonly name: string;
+    /** @inheritDoc */
+    temperatureSensor: TemperatureSensor;
+    /** @inheritDoc */
+    humiditySensor: iHumiditySensor;
+    /** @inheritDoc */
+    airQualitySensor: iAirQualitySensor;
+    protected _lastUpdate: Date;
+    private _sensor;
+    private _lastReportedTemperature;
+    private _lastReportedHumidity;
+    constructor(name: string, roomName: string, unifiSensorName: string);
+    /**
+     * The point in time this device last reported a reading.
+     * @returns The timestamp of the last reading
+     */
+    get lastUpdate(): Date;
+    /** @inheritDoc */
+    get airQuality(): iAirQualityReadings;
+    /** @inheritDoc */
+    get roomTemperature(): number;
+    /** @inheritDoc */
+    set roomTemperature(value: number);
+    /** @inheritDoc */
+    get humidity(): number;
+    /** @inheritDoc */
+    get iTemperature(): number;
+    /** @inheritDoc */
+    get sTemperature(): string;
+    /**
+     * Binds this device to its live Unifi-Protect projection and applies the current readings.
+     * @param sensor - The projection of the matching Unifi sensor
+     */
+    initialize(sensor: Sensor): void;
+    /**
+     * Applies the readings of the given sensor configuration.
+     * @param config - The current configuration of the Unifi sensor
+     */
+    update(config: ProtectSensorConfig): void;
+    /** @inheritDoc */
+    addAirQualityCallback(pCallback: (action: AirQualitySensorChangeAction) => void): void;
+    /** @inheritDoc */
+    addHumidityCallback(pCallback: (action: HumiditySensorChangeAction) => void): void;
+    /** @inheritDoc */
+    addTempChangeCallback(pCallback: (action: TemperatureSensorChangeAction) => void): void;
+    /** @inheritDoc */
+    onTemperaturChange(newTemperatur: number): void;
+    /** @inheritDoc */
+    dispose(): void;
+    /**
+     * Reads a single metric out of the controllers air quality readings.
+     *
+     * Kept structural on purpose: the controller reports `nox`, which the library types do not name,
+     * and a metric the device does not measure arrives with a `null` value. The value is rounded to one
+     * decimal, as the last digits of the raw reading are sensor jitter that would count as a change on
+     * every single update.
+     * @param airQuality - The air quality readings of the sensor
+     * @param metric - The name of the metric to read
+     * @returns The measured value, or undefined if the device does not report it
+     */
+    private static metricValue;
+}

package/lib/devices/unifi/own-unifi-air-quality-sensor.js

@@ -0,0 +1,164 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.OwnUnifiAirQualitySensor = void 0;
+const sharedFunctions_1 = require("../sharedFunctions");
+const enums_1 = require("../../enums");
+const DeviceInfo_1 = require("../DeviceInfo");
+const devices_1 = require("../devices");
+const RoomBaseDevice_1 = require("../RoomBaseDevice");
+const utils_1 = require("../../utils");
+/**
+ * A UniFi Protect "UP Air Quality" sensor.
+ *
+ * The device reports temperature and humidity alongside its air quality metrics, so it acts as all three
+ * collectors at once and its temperature/humidity history lands in the database like any other sensor.
+ */
+class OwnUnifiAirQualitySensor extends RoomBaseDevice_1.RoomBaseDevice {
+    constructor(name, roomName, unifiSensorName) {
+        const info = new DeviceInfo_1.DeviceInfo();
+        info.fullName = `Air Quality ${roomName} ${name}`;
+        info.customName = `Air Quality ${name}`;
+        info.room = roomName;
+        const allDevicesKey = `unifi-air-quality-${roomName}-${name}`;
+        info.allDevicesKey = allDevicesKey;
+        super(info, enums_1.DeviceType.UnifiAirQualitySensor);
+        /** @inheritDoc */
+        this.temperatureSensor = new sharedFunctions_1.TemperatureSensor(this);
+        /** @inheritDoc */
+        this.humiditySensor = new sharedFunctions_1.HumiditySensor(this);
+        /** @inheritDoc */
+        this.airQualitySensor = new sharedFunctions_1.AirQualitySensor(this);
+        this._lastUpdate = new Date(0);
+        // @ts-expect-error Sensor-Projektion wird später verwendet
+        this._sensor = null;
+        this._lastReportedTemperature = undefined;
+        this._lastReportedHumidity = undefined;
+        this.deviceCapabilities.push(enums_1.DeviceCapability.temperatureSensor);
+        this.deviceCapabilities.push(enums_1.DeviceCapability.humiditySensor);
+        this.deviceCapabilities.push(enums_1.DeviceCapability.airQualitySensor);
+        this.name = name;
+        this.unifiSensorName = unifiSensorName;
+        devices_1.Devices.alLDevices[allDevicesKey] = this;
+    }
+    /**
+     * The point in time this device last reported a reading.
+     * @returns The timestamp of the last reading
+     */
+    get lastUpdate() {
+        return this._lastUpdate;
+    }
+    /** @inheritDoc */
+    get airQuality() {
+        return this.airQualitySensor.readings;
+    }
+    /** @inheritDoc */
+    get roomTemperature() {
+        return this.temperatureSensor.roomTemperature;
+    }
+    /** @inheritDoc */
+    set roomTemperature(value) {
+        this.temperatureSensor.roomTemperature = value;
+    }
+    /** @inheritDoc */
+    get humidity() {
+        return this.humiditySensor.humidity;
+    }
+    /** @inheritDoc */
+    get iTemperature() {
+        return this.temperatureSensor.temperature;
+    }
+    /** @inheritDoc */
+    get sTemperature() {
+        return `${this.temperatureSensor.temperature}°C`;
+    }
+    /**
+     * Binds this device to its live Unifi-Protect projection and applies the current readings.
+     * @param sensor - The projection of the matching Unifi sensor
+     */
+    initialize(sensor) {
+        this._sensor = sensor;
+        this.update(sensor.config);
+    }
+    /**
+     * Applies the readings of the given sensor configuration.
+     * @param config - The current configuration of the Unifi sensor
+     */
+    update(config) {
+        const airQuality = config.airQuality;
+        this._lastUpdate = new Date();
+        // The controller repeats unchanged readings every few seconds, so only a real change wakes the consumers.
+        const temperature = OwnUnifiAirQualitySensor.metricValue(airQuality, 'temperature');
+        if (temperature !== undefined) {
+            if (temperature !== this._lastReportedTemperature) {
+                this._lastReportedTemperature = temperature;
+                this.temperatureSensor.temperature = temperature;
+            }
+            else {
+                // Only the setter refreshes lastSeen, and a stale one makes the sensor discard its value after an hour.
+                this.temperatureSensor.lastSeen = utils_1.Utils.nowMS();
+            }
+        }
+        const humidity = OwnUnifiAirQualitySensor.metricValue(airQuality, 'humidity');
+        if (humidity !== undefined && humidity !== this._lastReportedHumidity) {
+            this._lastReportedHumidity = humidity;
+            this.humiditySensor.humidity = humidity;
+        }
+        this.airQualitySensor.update({
+            aqi: OwnUnifiAirQualitySensor.metricValue(airQuality, 'aqi'),
+            co2: OwnUnifiAirQualitySensor.metricValue(airQuality, 'co2'),
+            nox: OwnUnifiAirQualitySensor.metricValue(airQuality, 'nox'),
+            pm1p0: OwnUnifiAirQualitySensor.metricValue(airQuality, 'pm1p0'),
+            pm2p5: OwnUnifiAirQualitySensor.metricValue(airQuality, 'pm2p5'),
+            pm4p0: OwnUnifiAirQualitySensor.metricValue(airQuality, 'pm4p0'),
+            pm10p0: OwnUnifiAirQualitySensor.metricValue(airQuality, 'pm10p0'),
+            tvoc: OwnUnifiAirQualitySensor.metricValue(airQuality, 'tvoc'),
+            vape: OwnUnifiAirQualitySensor.metricValue(airQuality, 'vape'),
+            voc: OwnUnifiAirQualitySensor.metricValue(airQuality, 'voc'),
+        });
+    }
+    /** @inheritDoc */
+    addAirQualityCallback(pCallback) {
+        this.airQualitySensor.addAirQualityCallback(pCallback);
+    }
+    /** @inheritDoc */
+    addHumidityCallback(pCallback) {
+        this.humiditySensor.addHumidityCallback(pCallback);
+    }
+    /** @inheritDoc */
+    addTempChangeCallback(pCallback) {
+        this.temperatureSensor.addTempChangeCallback(pCallback);
+    }
+    /** @inheritDoc */
+    onTemperaturChange(newTemperatur) {
+        this.roomTemperature = newTemperatur;
+    }
+    /** @inheritDoc */
+    dispose() {
+        this.temperatureSensor.dispose();
+        this.humiditySensor.dispose();
+        this.airQualitySensor.dispose();
+    }
+    /**
+     * Reads a single metric out of the controllers air quality readings.
+     *
+     * Kept structural on purpose: the controller reports `nox`, which the library types do not name,
+     * and a metric the device does not measure arrives with a `null` value. The value is rounded to one
+     * decimal, as the last digits of the raw reading are sensor jitter that would count as a change on
+     * every single update.
+     * @param airQuality - The air quality readings of the sensor
+     * @param metric - The name of the metric to read
+     * @returns The measured value, or undefined if the device does not report it
+     */
+    static metricValue(airQuality, metric) {
+        if (typeof airQuality !== 'object' || airQuality === null) {
+            return undefined;
+        }
+        const reading = Reflect.get(airQuality, metric);
+        if (typeof reading !== 'object' || reading === null) {
+            return undefined;
+        }
+        const value = Reflect.get(reading, 'value');
+        return typeof value === 'number' ? utils_1.Utils.round(value, 1) : undefined;
+    }
+}
+exports.OwnUnifiAirQualitySensor = OwnUnifiAirQualitySensor;

package/lib/devices/unifi/own-unifi-camera.d.ts

@@ -1,5 +1,5 @@
 import { CameraDevice } from '../index';
-import { ProtectCameraConfig, ProtectEventAdd, ProtectEventPacket } from 'unifi-protect';
+import type { Camera, TypedEvent } from 'unifi-protect';
 export declare class OwnUnifiCamera extends CameraDevice {
     /**
      * The name of the camera in Unifi
@@ -13,14 +13,15 @@ export declare class OwnUnifiCamera extends CameraDevice {
     rtspStreamLink: string;
     /** @inheritDoc */
     readonly currentImageLink: string;
-    private _config;
+    private _camera;
     constructor(name: string, roomName: string, unifiCameraName: string);
     /**
-     * @inheritDoc
+     * Handles a realtime event the NVR attributed to this camera.
+     * @param event - The typed event as classified by the NVR client
      */
-    update(packet: ProtectEventPacket, baseEvent?: ProtectEventAdd): void;
+    update(event: TypedEvent): void;
     private checkForMotionUpdate;
-    initialize(data: ProtectCameraConfig): void;
+    initialize(camera: Camera): void;
     protected resetPersonDetectedState(): void;
     protected resetDogDetectedState(): void;
     protected resetMovementDetectedState(): void;

package/lib/devices/unifi/own-unifi-camera.js

@@ -14,38 +14,28 @@ class OwnUnifiCamera extends index_1.CameraDevice {
         this.rtspStreamLink = '';
         /** @inheritDoc */
         this.currentImageLink = '';
-        // @ts-expect-error Config wird später verwendet
-        this._config = null;
+        // @ts-expect-error Kamera-Projektion wird später verwendet
+        this._camera = null;
         this.unifiCameraName = unifiCameraName;
     }
     /**
-     * @inheritDoc
+     * Handles a realtime event the NVR attributed to this camera.
+     * @param event - The typed event as classified by the NVR client
      */
-    update(packet, baseEvent) {
-        this.checkForMotionUpdate(packet, baseEvent);
+    update(event) {
+        this.checkForMotionUpdate(event);
         this._lastUpdate = new Date();
     }
-    checkForMotionUpdate(packet, baseEvent) {
-        var _a, _b;
-        const payload = packet.payload;
-        const eventAddInfo = baseEvent !== null && baseEvent !== void 0 ? baseEvent : payload;
-        const payloadAsEventAdd = payload;
-        if (packet.header.modelKey !== 'smartDetectObject' &&
-            (packet.header.modelKey !== 'event' ||
-                !['smartDetectLine', 'smartDetectZone'].includes(eventAddInfo.type) ||
-                !((_a = payloadAsEventAdd.smartDetectTypes) !== null && _a !== void 0 ? _a : []).length)) {
-            // this.log(LogLevel.Debug, `Ignored event: ${JSON.stringify(packet)}`);
-            // this.log(LogLevel.Debug, `Ignored event initial Info: ${JSON.stringify(baseEvent)}`);
+    checkForMotionUpdate(event) {
+        if (event.kind !== 'smartDetect' || !event.objectTypes.length) {
+            // this.log(LogLevel.Debug, `Ignored event: ${JSON.stringify(event)}`);
             return;
         }
-        this.log(enums_1.LogLevel.Debug, `Update for "${packet.header.modelKey}" to value: ${JSON.stringify(payload)}`);
-        const detectedTypes = packet.header.modelKey === 'smartDetectObject'
-            ? [payloadAsEventAdd.type]
-            : ((_b = payloadAsEventAdd === null || payloadAsEventAdd === void 0 ? void 0 : payloadAsEventAdd.smartDetectTypes) !== null && _b !== void 0 ? _b : []);
-        for (const smartDetectType of detectedTypes) {
+        this.log(enums_1.LogLevel.Debug, `Update for "${event.kind}" to value: ${event.objectTypes.join(', ')}`);
+        for (const smartDetectType of event.objectTypes) {
             switch (smartDetectType) {
                 case 'licensePlate':
-                    this.log(enums_1.LogLevel.Debug, `Detected "licensePlate" Data: ${JSON.stringify(payloadAsEventAdd)}`);
+                    this.log(enums_1.LogLevel.Debug, `Detected "licensePlate" Data: ${JSON.stringify(event.metadata)}`);
                     break;
                 case 'person':
                     this.onNewPersonDetectedValue(true, enums_1.CommandSource.Automatic);
@@ -53,8 +43,8 @@ class OwnUnifiCamera extends index_1.CameraDevice {
             }
         }
     }
-    initialize(data) {
-        this._config = data;
+    initialize(camera) {
+        this._camera = camera;
     }
     resetPersonDetectedState() {
         // Nothing

package/lib/devices/unifi/protect-module.d.ts

@@ -0,0 +1,11 @@
+type ProtectModule = typeof import('unifi-protect');
+/**
+ * Loads the ESM-only `unifi-protect` package.
+ *
+ * Since v5 the package exposes an "import" condition only, so `require()` fails with
+ * ERR_PACKAGE_PATH_NOT_EXPORTED. The `Function` indirection keeps TypeScript from downleveling
+ * the dynamic import into a `require()` call while this project still emits CommonJS.
+ * @returns The module namespace, loaded once and cached.
+ */
+export declare function loadProtectModule(): Promise<ProtectModule>;
+export {};

package/lib/devices/unifi/protect-module.js

@@ -0,0 +1,16 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.loadProtectModule = loadProtectModule;
+let modulePromise = null;
+/**
+ * Loads the ESM-only `unifi-protect` package.
+ *
+ * Since v5 the package exposes an "import" condition only, so `require()` fails with
+ * ERR_PACKAGE_PATH_NOT_EXPORTED. The `Function` indirection keeps TypeScript from downleveling
+ * the dynamic import into a `require()` call while this project still emits CommonJS.
+ * @returns The module namespace, loaded once and cached.
+ */
+function loadProtectModule() {
+    modulePromise !== null && modulePromise !== void 0 ? modulePromise : (modulePromise = Function('specifier', 'return import(specifier)')('unifi-protect'));
+    return modulePromise;
+}

package/lib/devices/unifi/unifi-logger.d.ts

@@ -1,10 +1,10 @@
-import { ProtectLogging } from 'unifi-protect';
+import type { ProtectLogging } from 'unifi-protect';
 import { LogSource } from '../../enums';
 export declare class UnifiLogger implements ProtectLogging {
     private readonly source;
     constructor(source: LogSource);
-    debug(message: string, ..._parameters: unknown[]): void;
-    error(message: string, ..._parameters: unknown[]): void;
-    info(message: string, ..._parameters: unknown[]): void;
-    warn(message: string, ..._parameters: unknown[]): void;
+    debug(message: string, ...parameters: unknown[]): void;
+    error(message: string, ...parameters: unknown[]): void;
+    info(message: string, ...parameters: unknown[]): void;
+    warn(message: string, ...parameters: unknown[]): void;
 }

package/lib/devices/unifi/unifi-logger.js

@@ -1,29 +1,30 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.UnifiLogger = void 0;
+const node_util_1 = require("node:util");
 const logging_1 = require("../../logging");
 const enums_1 = require("../../enums");
 class UnifiLogger {
     constructor(source) {
         this.source = source;
     }
-    debug(message, ..._parameters) {
-        logging_1.ServerLogService.writeLog(enums_1.LogLevel.Debug, message, {
+    debug(message, ...parameters) {
+        logging_1.ServerLogService.writeLog(enums_1.LogLevel.Debug, (0, node_util_1.format)(message, ...parameters), {
             source: this.source,
         });
     }
-    error(message, ..._parameters) {
-        logging_1.ServerLogService.writeLog(enums_1.LogLevel.Error, message, {
+    error(message, ...parameters) {
+        logging_1.ServerLogService.writeLog(enums_1.LogLevel.Error, (0, node_util_1.format)(message, ...parameters), {
             source: this.source,
         });
     }
-    info(message, ..._parameters) {
-        logging_1.ServerLogService.writeLog(enums_1.LogLevel.Info, message, {
+    info(message, ...parameters) {
+        logging_1.ServerLogService.writeLog(enums_1.LogLevel.Info, (0, node_util_1.format)(message, ...parameters), {
             source: this.source,
         });
     }
-    warn(message, ..._parameters) {
-        logging_1.ServerLogService.writeLog(enums_1.LogLevel.Warn, message, {
+    warn(message, ...parameters) {
+        logging_1.ServerLogService.writeLog(enums_1.LogLevel.Warn, (0, node_util_1.format)(message, ...parameters), {
             source: this.source,
         });
     }