hoffmation-base 3.0.0-alpha.4 → 3.0.0-alpha.41

package/lib/server/devices/blueIris/cameraDevice.js

@@ -14,45 +14,37 @@ const DeviceCapability_1 = require("../DeviceCapability");
 const deviceType_1 = require("../deviceType");
 const ioBroker_1 = require("../../ioBroker");
 class CameraDevice {
-    get lastImage() {
-        return this._lastImage;
-    }
-    get dogDetected() {
-        return this._dogDetected;
-    }
-    get personDetected() {
-        return this._personDetected;
-    }
-    get alarmBlockedByGriffTimeStamp() {
-        return this._alarmBlockedByGriffTimeStamp;
-    }
-    get alarmBlockedByGriff() {
-        return this._alarmGriffBlockCount > 0;
-    }
     constructor(mqttName, roomName, blueIrisName) {
         var _a;
+        /** @inheritDoc */
+        this.settings = new models_1.CameraSettings();
+        /** @inheritDoc */
+        this.deviceCapabilities = [DeviceCapability_1.DeviceCapability.camera, DeviceCapability_1.DeviceCapability.motionSensor];
+        /** @inheritDoc */
+        this.deviceType = deviceType_1.DeviceType.Camera;
+        /** @inheritDoc */
+        this.mpegStreamLink = '';
+        /** @inheritDoc */
+        this.h264IosStreamLink = '';
+        /** @inheritDoc */
+        this.rtspStreamLink = '';
+        /** @inheritDoc */
+        this.currentImageLink = '';
+        /** @inheritDoc */
+        this.detectionsToday = 0;
+        this._lastMotion = 0;
         this._personDetectFallbackTimeout = null;
         this._movementDetectFallbackTimeout = null;
         this._dogDetectFallbackTimeout = null;
         this._personDetectedStateId = undefined;
         this._dogDetectedStateId = undefined;
         this._movementDetectedStateId = undefined;
-        this.settings = new models_1.CameraSettings();
-        this.deviceCapabilities = [DeviceCapability_1.DeviceCapability.camera, DeviceCapability_1.DeviceCapability.motionSensor];
-        this.deviceType = deviceType_1.DeviceType.Camera;
-        this._lastMotion = 0;
         this._initialized = false;
         this._movementDetectedCallback = [];
         this._lastImage = '';
         this._personDetected = false;
         this._dogDetected = false;
-        this._alarmGriffBlockCount = 0;
-        this._alarmBlockedByGriffTimeStamp = 0;
-        this.mpegStreamLink = '';
-        this.h264IosStreamLink = '';
-        this.rtspStreamLink = '';
-        this.currentImageLink = '';
-        this._detectionsToday = 0;
+        this._devicesBlockingAlarmMap = new Map();
         this._movementDetected = false;
         this.blueIrisName = blueIrisName;
         this.name = mqttName;
@@ -87,59 +79,67 @@ class CameraDevice {
             });
         }
     }
-    get detectionsToday() {
-        return this._detectionsToday;
+    /** @inheritDoc */
+    get lastImage() {
+        return this._lastImage;
+    }
+    /** @inheritDoc */
+    get dogDetected() {
+        return this._dogDetected;
+    }
+    /** @inheritDoc */
+    get personDetected() {
+        return this._personDetected;
     }
-    set detectionsToday(pVal) {
-        this._detectionsToday = pVal;
+    /** @inheritDoc */
+    get alarmBlockedByDevices() {
+        return this._devicesBlockingAlarmMap.size > 0;
     }
+    /** @inheritDoc */
     get movementDetected() {
         return this._movementDetected;
     }
+    /** @inheritDoc */
     get info() {
         return this._info;
     }
-    set info(info) {
-        this._info = info;
-    }
-    /**
-     * Time since Last Motion in seconds
-     * @returns {number}
-     */
+    /** @inheritDoc */
     get timeSinceLastMotion() {
         return Math.round((services_1.Utils.nowMS() - this._lastMotion) / 1000);
     }
+    /** @inheritDoc */
     get customName() {
         return this.info.customName;
     }
+    /** @inheritDoc */
     get id() {
         var _a;
         return (_a = this.info.allDevicesKey) !== null && _a !== void 0 ? _a : `camera-${this.info.room}-${this.info.customName}`;
     }
+    /** @inheritDoc */
     get room() {
         return services_1.API.getRoom(this.info.room);
     }
-    /**
-     * Adds a callback for when a motion state has changed.
-     * @param pCallback Function that accepts the new state as parameter
-     */
+    /** @inheritDoc */
     addMovementCallback(pCallback) {
         this._movementDetectedCallback.push(pCallback);
     }
-    onGriffUpdate(open) {
-        this._alarmGriffBlockCount += open ? 1 : -1;
-        if (this._alarmGriffBlockCount < 0) {
-            this._alarmGriffBlockCount = 0;
+    /** @inheritDoc */
+    blockForDevice(device, block) {
+        if (block) {
+            this._devicesBlockingAlarmMap.set(device.id, device);
         }
-        if (this._alarmGriffBlockCount == 1) {
-            this._alarmBlockedByGriffTimeStamp = new Date().getTime();
+        else {
+            this._devicesBlockingAlarmMap.delete(device.id);
         }
-        this.log(models_1.LogLevel.Debug, `Handle change to open (${open}), new open amount: ${this._alarmGriffBlockCount}`);
+        this.log(models_1.LogLevel.Debug, `Handle device ${block ? 'block' : 'unblock'}, new blocking amount: ${this._devicesBlockingAlarmMap.size}`);
     }
+    /** @inheritDoc */
     persistMotionSensor() {
         var _a;
         (_a = services_1.Utils.dbo) === null || _a === void 0 ? void 0 : _a.persistMotionSensor(this);
     }
+    /** @inheritDoc */
     update(idSplit, state) {
         const stateName = idSplit[4];
         switch (stateName) {
@@ -160,7 +160,7 @@ class CameraDevice {
                 const newValue = state.val === 1;
                 this.log(models_1.LogLevel.Debug, `Update for "${stateName}" to value: ${state.val}`);
                 if (newValue) {
-                    this.log(models_1.LogLevel.Info, `Person Detected`);
+                    this.log(models_1.LogLevel.Info, 'Person Detected');
                     this.resetPersonDetectFallbackTimer();
                 }
                 this._personDetected = newValue;
@@ -173,7 +173,7 @@ class CameraDevice {
                 const newDogDetectionVal = state.val === 1;
                 this.log(models_1.LogLevel.Debug, `Update for "${stateName}" to value: ${state.val}`);
                 if (newDogDetectionVal) {
-                    this.log(models_1.LogLevel.Info, `Dog Detected`);
+                    this.log(models_1.LogLevel.Info, 'Dog Detected');
                     this.resetDogDetectFallbackTimer();
                 }
                 this._dogDetected = newDogDetectionVal;
@@ -185,36 +185,12 @@ class CameraDevice {
                 this._lastImage = state.val;
                 services_1.Utils.guardedTimeout(() => {
                     // Give Person Detected Update some time, as otherwise personDetected might still be false
-                    if (this.settings.alertPersonOnTelegram && this._personDetected && !this.alarmBlockedByGriff) {
+                    if (this.settings.alertPersonOnTelegram && this._personDetected && !this.alarmBlockedByDevices) {
                         services_1.TelegramService.sendImage(`${this.name} detected Person`, new models_1.Base64Image(this._lastImage, 'person_alert'));
                     }
                 }, 1000);
         }
     }
-    updateMovement(newState) {
-        if (!this._initialized && newState) {
-            this.log(models_1.LogLevel.Trace, `Movement recognized, but database initialization has not finished yet --> delay.`);
-            services_1.Utils.guardedTimeout(() => {
-                this.updateMovement(newState);
-            }, 1000, this);
-            return;
-        }
-        if (newState === this.movementDetected) {
-            this.log(models_1.LogLevel.Debug, `Skip movement because state is already ${newState}`, services_1.LogDebugType.SkipUnchangedMovementState);
-            return;
-        }
-        this._lastMotion = services_1.Utils.nowMS();
-        this._movementDetected = newState;
-        this.persistMotionSensor();
-        this.log(models_1.LogLevel.Debug, `New movement state: ${newState}`, services_1.LogDebugType.NewMovementState);
-        if (newState) {
-            this.detectionsToday++;
-            this.log(models_1.LogLevel.Trace, `This is movement no. ${this.detectionsToday}`);
-        }
-        for (const c of this._movementDetectedCallback) {
-            c(newState);
-        }
-    }
     log(level, message, debugType = services_1.LogDebugType.None) {
         var _a, _b;
         services_1.ServerLogService.writeLog(level, `${this.name}: ${message}`, {
@@ -240,6 +216,30 @@ class CameraDevice {
         var _a;
         (_a = this.settings) === null || _a === void 0 ? void 0 : _a.initializeFromDb(this);
     }
+    updateMovement(newState) {
+        if (!this._initialized && newState) {
+            this.log(models_1.LogLevel.Trace, 'Movement recognized, but database initialization has not finished yet --> delay.');
+            services_1.Utils.guardedTimeout(() => {
+                this.updateMovement(newState);
+            }, 1000, this);
+            return;
+        }
+        if (newState === this.movementDetected) {
+            this.log(models_1.LogLevel.Debug, `Skip movement because state is already ${newState}`, services_1.LogDebugType.SkipUnchangedMovementState);
+            return;
+        }
+        this._lastMotion = services_1.Utils.nowMS();
+        this._movementDetected = newState;
+        this.persistMotionSensor();
+        this.log(models_1.LogLevel.Debug, `New movement state: ${newState}`, services_1.LogDebugType.NewMovementState);
+        if (newState) {
+            this.detectionsToday++;
+            this.log(models_1.LogLevel.Trace, `This is movement no. ${this.detectionsToday}`);
+        }
+        for (const c of this._movementDetectedCallback) {
+            c(new models_1.MotionSensorAction(this));
+        }
+    }
     resetPersonDetectFallbackTimer() {
         if (this._personDetectFallbackTimeout !== null) {
             clearTimeout(this._personDetectFallbackTimeout);

package/lib/server/devices/button/button.d.ts

@@ -7,7 +7,6 @@ export declare class Button {
     private _callbacksMap;
     private _timeouts;
     constructor(name: string, buttonCapabilities: ButtonCapabilities);
-    getState(type: ButtonPressType): boolean;
     addCb(buttonType: ButtonPressType, pCallback: (pValue: boolean) => void, description?: string): void;
     isPressActive(type: ButtonPressType): boolean | undefined;
     getDescription(): string;

package/lib/server/devices/button/button.js

@@ -32,10 +32,6 @@ class Button {
             this._statesMap.set(buttonPressType_1.ButtonPressType.triple, false);
         }
     }
-    getState(type) {
-        var _a;
-        return (_a = this._statesMap.get(type)) !== null && _a !== void 0 ? _a : false;
-    }
     addCb(buttonType, pCallback, description = 'Not described') {
         const cbArr = this._callbacksMap.get(buttonType);
         if (cbArr === undefined) {

package/lib/server/devices/button/buttonCallback.d.ts

@@ -0,0 +1,5 @@
+export declare class ButtonCallback {
+    readonly cb: (pValue: boolean) => void;
+    readonly description: string;
+    constructor(cb: (pValue: boolean) => void, description: string);
+}

package/lib/server/devices/button/buttonCallback.js

@@ -0,0 +1,10 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ButtonCallback = void 0;
+class ButtonCallback {
+    constructor(cb, description) {
+        this.cb = cb;
+        this.description = description;
+    }
+}
+exports.ButtonCallback = ButtonCallback;

package/lib/server/devices/button/buttonCapabilities.d.ts

@@ -1,6 +1,18 @@
 export declare class ButtonCapabilities {
+    /**
+     * Whether the button supports short press
+     */
     shortPress: boolean;
+    /**
+     * Whether the button supports double press
+     */
     doublePress: boolean;
+    /**
+     * Whether the button supports triple press
+     */
     triplePress: boolean;
+    /**
+     * Whether the button supports long press
+     */
     longPress: boolean;
 }

package/lib/server/devices/button/buttonCapabilities.js

@@ -3,9 +3,21 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.ButtonCapabilities = void 0;
 class ButtonCapabilities {
     constructor() {
+        /**
+         * Whether the button supports short press
+         */
         this.shortPress = true;
+        /**
+         * Whether the button supports double press
+         */
         this.doublePress = true;
+        /**
+         * Whether the button supports triple press
+         */
         this.triplePress = true;
+        /**
+         * Whether the button supports long press
+         */
         this.longPress = true;
     }
 }

package/lib/server/devices/button/index.d.ts

@@ -2,3 +2,4 @@ export * from './button';
 export * from './buttonCapabilities';
 export * from './buttonPressType';
 export * from './buttonPosition';
+export { ButtonCallback } from './buttonCallback';

package/lib/server/devices/button/index.js

@@ -14,7 +14,10 @@ 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 });
+exports.ButtonCallback = void 0;
 __exportStar(require("./button"), exports);
 __exportStar(require("./buttonCapabilities"), exports);
 __exportStar(require("./buttonPressType"), exports);
 __exportStar(require("./buttonPosition"), exports);
+var buttonCallback_1 = require("./buttonCallback");
+Object.defineProperty(exports, "ButtonCallback", { enumerable: true, get: function () { return buttonCallback_1.ButtonCallback; } });

package/lib/server/devices/dachs/dachs.d.ts

@@ -4,44 +4,66 @@ import { DeviceCapability } from '../DeviceCapability';
 import { LogDebugType, OwnSonosDevice } from '../../services';
 import { iDachsSettings } from '../../config/iDachsSettings';
 import { DachsDeviceSettings } from '../../../models/deviceSettings/dachsSettings';
-import { iFlattenedCompleteResponse } from './interfaces';
 import { DachsTemperatureSensor } from './dachsTemperatureSensor';
 import { BlockAutomaticHandler } from '../../services/blockAutomaticHandler';
 export declare class Dachs implements iBaseDevice, iActuator {
+    /** @inheritDoc */
     settings: DachsDeviceSettings;
+    /** @inheritDoc */
     readonly blockAutomationHandler: BlockAutomaticHandler;
+    /** @inheritDoc */
     readonly deviceType: DeviceType;
+    /** @inheritDoc */
     readonly deviceCapabilities: DeviceCapability[];
+    /**
+     * A reference to the Temperature measuring warm water temperature
+     */
     readonly warmWaterSensor: DachsTemperatureSensor;
+    /**
+     * A reference to the Temperature measuring heat storage temperature
+     */
     readonly heatStorageTempSensor: DachsTemperatureSensor;
     private readonly client;
     private readonly config;
-    fetchedData: iFlattenedCompleteResponse | undefined;
+    /** @inheritDoc */
     queuedValue: boolean | null;
+    /** @inheritDoc */
+    targetAutomaticState: boolean;
     private readonly _influxClient;
     private _dachsOn;
     private _tempWarmWater;
     private _tempHeatStorage;
-    targetAutomaticState: boolean;
+    private fetchedData;
+    /** @inheritDoc */
     get customName(): string;
+    /** @inheritDoc */
     get actuatorOn(): boolean;
-    get tempWarmWater(): number;
-    get tempHeatStorage(): number;
     constructor(options: iDachsSettings);
-    restoreTargetAutomaticValue(c: RestoreTargetAutomaticValueCommand): void;
-    protected _info: DeviceInfo;
+    /** @inheritDoc */
     get info(): DeviceInfo;
-    set info(info: DeviceInfo);
+    protected _info: DeviceInfo;
+    /** @inheritDoc */
     get id(): string;
-    get name(): string;
+    /** @inheritDoc */
     get room(): RoomBase | undefined;
+    get name(): string;
+    /** @inheritDoc */
+    restoreTargetAutomaticValue(c: RestoreTargetAutomaticValueCommand): void;
+    /** @inheritDoc */
     log(level: LogLevel, message: string, debugType?: LogDebugType): void;
+    /** @inheritDoc */
     toJSON(): Partial<OwnSonosDevice>;
+    /** @inheritDoc */
     persistDeviceInfo(): void;
+    /** @inheritDoc */
     loadDeviceSettings(): void;
     private loadData;
+    /** @inheritDoc */
     persist(): void;
+    /** @inheritDoc */
     setActuator(c: ActuatorSetStateCommand): void;
+    /** @inheritDoc */
     toggleActuator(c: ActuatorToggleCommand): boolean;
+    /** @inheritDoc */
     writeActuatorStateToDevice(c: ActuatorWriteStateToDeviceCommand): void;
 }

package/lib/server/devices/dachs/dachs.js

@@ -14,30 +14,31 @@ const lib_1 = require("./lib");
 const dachsTemperatureSensor_1 = require("./dachsTemperatureSensor");
 const blockAutomaticHandler_1 = require("../../services/blockAutomaticHandler");
 class Dachs {
+    /** @inheritDoc */
     get customName() {
         return this.info.customName;
     }
+    /** @inheritDoc */
     get actuatorOn() {
         return this._dachsOn;
     }
-    get tempWarmWater() {
-        return this._tempWarmWater;
-    }
-    get tempHeatStorage() {
-        return this._tempHeatStorage;
-    }
     constructor(options) {
+        /** @inheritDoc */
         this.settings = new dachsSettings_1.DachsDeviceSettings();
+        /** @inheritDoc */
         this.deviceType = devices_1.DeviceType.Dachs;
+        /** @inheritDoc */
         this.deviceCapabilities = [];
+        /** @inheritDoc */
         this.queuedValue = null;
+        /** @inheritDoc */
+        this.targetAutomaticState = false;
         this._dachsOn = false;
         this._tempWarmWater = 0;
         this._tempHeatStorage = 0;
-        this.targetAutomaticState = false;
         this.deviceCapabilities.push(DeviceCapability_1.DeviceCapability.actuator);
         this._info = new devices_1.DeviceInfo();
-        this._info.fullName = `Dachs`;
+        this._info.fullName = 'Dachs';
         this._info.customName = `Dachs ${options.roomName}`;
         this._info.allDevicesKey = `dachs-${options.roomName}`;
         this._info.room = options.roomName;
@@ -56,28 +57,30 @@ class Dachs {
         this.warmWaterSensor = new dachsTemperatureSensor_1.DachsTemperatureSensor(this.config.roomName, 'ww', 'Water Temperature');
         this.heatStorageTempSensor = new dachsTemperatureSensor_1.DachsTemperatureSensor(this.config.roomName, 'hs', 'Heat Storage Temperature');
         services_1.Utils.guardedInterval(this.loadData, this.config.refreshInterval, this);
-        this.blockAutomationHandler = new blockAutomaticHandler_1.BlockAutomaticHandler(this.restoreTargetAutomaticValue.bind(this));
-    }
-    restoreTargetAutomaticValue(c) {
-        this.log(models_1.LogLevel.Debug, `Restore Target Automatic value`);
-        this.setActuator(new models_1.ActuatorSetStateCommand(c, this.targetAutomaticState, 'Restore Target Automatic value'));
+        this.blockAutomationHandler = new blockAutomaticHandler_1.BlockAutomaticHandler(this.restoreTargetAutomaticValue.bind(this), this.log.bind(this));
     }
+    /** @inheritDoc */
     get info() {
         return this._info;
     }
-    set info(info) {
-        this._info = info;
-    }
+    /** @inheritDoc */
     get id() {
         var _a;
         return (_a = this.info.allDevicesKey) !== null && _a !== void 0 ? _a : `sonos-${this.info.room}-${this.info.customName}`;
     }
+    /** @inheritDoc */
+    get room() {
+        return services_1.API.getRoom(this.info.room);
+    }
     get name() {
         return this.info.customName;
     }
-    get room() {
-        return services_1.API.getRoom(this.info.room);
+    /** @inheritDoc */
+    restoreTargetAutomaticValue(c) {
+        this.log(models_1.LogLevel.Debug, 'Restore Target Automatic value');
+        this.setActuator(new models_1.ActuatorSetStateCommand(c, this.targetAutomaticState, 'Restore Target Automatic value'));
     }
+    /** @inheritDoc */
     log(level, message, debugType = services_1.LogDebugType.None) {
         services_1.ServerLogService.writeLog(level, `${this.name}: ${message}`, {
             debugType: debugType,
@@ -86,15 +89,18 @@ class Dachs {
             deviceName: this.name,
         });
     }
+    /** @inheritDoc */
     toJSON() {
         return services_1.Utils.jsonFilter(lodash_1.default.omit(this, ['room', 'client', 'config', '_influxClient', 'warmWaterSensor', 'heatStorageTempSensor']));
     }
+    /** @inheritDoc */
     persistDeviceInfo() {
         services_1.Utils.guardedTimeout(() => {
             var _a;
             (_a = services_1.Utils.dbo) === null || _a === void 0 ? void 0 : _a.addDevice(this);
         }, 5000, this);
     }
+    /** @inheritDoc */
     loadDeviceSettings() {
         this.settings.initializeFromDb(this);
     }
@@ -128,18 +134,22 @@ class Dachs {
             this.log(models_1.LogLevel.Error, `Error while fetching data: ${error}`);
         });
     }
+    /** @inheritDoc */
     persist() {
         var _a;
         (_a = services_1.Utils.dbo) === null || _a === void 0 ? void 0 : _a.persistActuator(this);
     }
+    /** @inheritDoc */
     setActuator(c) {
         devices_1.LampUtils.setActuator(this, c);
     }
+    /** @inheritDoc */
     toggleActuator(c) {
         const setActuatorCommand = models_1.ActuatorSetStateCommand.byActuatorAndToggleCommand(this, c);
         this.setActuator(setActuatorCommand);
         return setActuatorCommand.on;
     }
+    /** @inheritDoc */
     writeActuatorStateToDevice(c) {
         this.log(models_1.LogLevel.Debug, c.logMessage, services_1.LogDebugType.SetActuator);
         if (!c.stateValue) {

package/lib/server/devices/dachs/dachsTemperatureSensor.d.ts

@@ -4,35 +4,54 @@ import { LogDebugType, OwnSonosDevice } from '../../services';
 import { DeviceCapability } from '../DeviceCapability';
 import { DeviceType } from '../deviceType';
 import { DeviceInfo } from '../DeviceInfo';
-import { DeviceSettings, LogLevel, RoomBase } from '../../../models';
+import { DeviceSettings, LogLevel, RoomBase, TemperatureSensorChangeAction } from '../../../models';
 export declare class DachsTemperatureSensor implements iTemperatureSensor {
+    /** @inheritDoc */
     settings: DeviceSettings | undefined;
+    /** @inheritDoc */
     readonly deviceType: DeviceType;
+    /** @inheritDoc */
     readonly deviceCapabilities: DeviceCapability[];
+    /** @inheritDoc */
     readonly persistTemperatureSensorInterval: NodeJS.Timeout;
     private _temperaturCallbacks;
     private _roomTemperature;
     protected _info: DeviceInfo;
     constructor(roomName: string, shortKey: string, longKey: string);
+    /** @inheritDoc */
     get customName(): string;
+    /** @inheritDoc */
     get info(): DeviceInfo;
-    set info(info: DeviceInfo);
+    /** @inheritDoc */
     get id(): string;
     get name(): string;
+    /** @inheritDoc */
     get room(): RoomBase | undefined;
+    /** @inheritDoc */
     get roomTemperature(): number;
+    /** @inheritDoc */
     set roomTemperature(value: number);
+    /** @inheritDoc */
     get iTemperature(): number;
+    /** @inheritDoc */
     get sTemperature(): string;
     private _temperature;
     private set temperature(value);
     update(newTemp: number): void;
-    addTempChangeCallback(pCallback: (pValue: number) => void): void;
+    /** @inheritDoc */
+    addTempChangeCallback(pCallback: (action: TemperatureSensorChangeAction) => void): void;
+    /** @inheritDoc */
     onTemperaturChange(newTemperatur: number): void;
+    /** @inheritDoc */
     persistTemperaturSensor(): void;
+    /** @inheritDoc */
     log(level: LogLevel, message: string, debugType?: LogDebugType): void;
+    /** @inheritDoc */
     toJSON(): Partial<OwnSonosDevice>;
+    /** @inheritDoc */
     persistDeviceInfo(): void;
+    /** @inheritDoc */
     loadDeviceSettings(): void;
+    /** @inheritDoc */
     dispose(): void;
 }