hoffmation-base 3.0.0-alpha.23 → 3.0.0-alpha.25

package/lib/server/services/govee/govee-service.js

@@ -9,8 +9,7 @@ class GooveeService {
         this.ownDevices = gvDevice;
     }
     static initialize() {
-        log_service_1.ServerLogService.writeLog(models_1.LogLevel.Debug, `Initializing Goovee-Service`);
-        this.all = [];
+        log_service_1.ServerLogService.writeLog(models_1.LogLevel.Debug, 'Initializing Goovee-Service');
         this.goveeApi = new govee_lan_controller_1.Govee({
             discover: true,
             discoverInterval: 300000,
@@ -19,7 +18,7 @@ class GooveeService {
             log_service_1.ServerLogService.writeLog(models_1.LogLevel.Info, `GoveeDevice ${data.ip} scanned`);
         });
         this.goveeApi.on(govee_lan_controller_1.GoveeEventTypes.Ready, () => {
-            log_service_1.ServerLogService.writeLog(models_1.LogLevel.Info, `Govee ready`);
+            log_service_1.ServerLogService.writeLog(models_1.LogLevel.Info, 'Govee ready');
         });
         this.goveeApi.on(govee_lan_controller_1.GoveeEventTypes.Error, (err) => {
             log_service_1.ServerLogService.writeLog(models_1.LogLevel.Error, `Govee-Error: ${err}`);
@@ -29,7 +28,7 @@ class GooveeService {
             GooveeService.initializeDevice(device);
         });
         this.goveeApi.on(govee_lan_controller_1.GoveeEventTypes.UnknownDevice, (_data) => {
-            log_service_1.ServerLogService.writeLog(models_1.LogLevel.Warn, `GoveeDevice unknown`);
+            log_service_1.ServerLogService.writeLog(models_1.LogLevel.Warn, 'GoveeDevice unknown');
         });
         this.goveeApi.on(govee_lan_controller_1.GoveeEventTypes.UnknownMessage, (data) => {
             log_service_1.ServerLogService.writeLog(models_1.LogLevel.Warn, `GoveeDevice unknown message: ${data}`);
@@ -60,6 +59,5 @@ class GooveeService {
     }
 }
 exports.GooveeService = GooveeService;
-GooveeService.all = [];
 GooveeService.devicesDict = {};
 GooveeService.ownDevices = {};

package/lib/server/services/govee/own-govee-device.d.ts

@@ -8,41 +8,46 @@ import { BlockAutomaticHandler } from '../blockAutomaticHandler';
 import { DeviceState as GoveeDeviceState } from '@j3lte/govee-lan-controller/build/types/device';
 export declare class OwnGoveeDevice implements iLedRgbCct, iTemporaryDisableAutomatic {
     device: GoveeDevice | undefined;
+    /** @inheritDoc */
     settings: LedSettings;
+    /** @inheritDoc */
     readonly deviceType: DeviceType;
+    /**
+     * The id of the device
+     */
     readonly deviceId: string;
+    /** @inheritDoc */
     readonly deviceCapabilities: DeviceCapability[];
+    /** @inheritDoc */
     readonly blockAutomationHandler: BlockAutomaticHandler;
-    on: boolean;
+    /** @inheritDoc */
     queuedValue: boolean | null;
+    /** @inheritDoc */
     brightness: number;
+    /** @inheritDoc */
     targetAutomaticState: boolean;
-    constructor(deviceId: string, ownDeviceName: string, roomName: string, device: GoveeDevice | undefined);
+    protected _info: DeviceInfo;
+    private _on;
     private _color;
-    get color(): string;
     private _colortemp;
-    get colortemp(): number;
     private _room;
+    constructor(deviceId: string, ownDeviceName: string, roomName: string, device: GoveeDevice | undefined);
+    get color(): string;
+    get colortemp(): number;
     get room(): RoomBase;
     get customName(): string;
     get actuatorOn(): boolean;
     get lightOn(): boolean;
-    protected _info: DeviceInfo;
     get info(): DeviceInfo;
-    set info(info: DeviceInfo);
     get id(): string;
     get name(): string;
     log(level: LogLevel, message: string, debugType?: LogDebugType): void;
     toJSON(): Partial<OwnGoveeDevice>;
     persistDeviceInfo(): void;
     loadDeviceSettings(): void;
-    /**
-     * @inheritDoc
-     */
+    /** @inheritDoc */
     setTimeBased(c: LampSetTimeBasedCommand): void;
-    /**
-     * @inheritDoc
-     */
+    /** @inheritDoc */
     setLight(c: LedSetLightCommand): void;
     setActuator(c: ActuatorSetStateCommand): void;
     restoreTargetAutomaticValue(c: RestoreTargetAutomaticValueCommand): void;

package/lib/server/services/govee/own-govee-device.js

@@ -15,18 +15,24 @@ const blockAutomaticHandler_1 = require("../blockAutomaticHandler");
 class OwnGoveeDevice {
     constructor(deviceId, ownDeviceName, roomName, device) {
         this.device = device;
+        /** @inheritDoc */
         this.settings = new models_1.LedSettings();
+        /** @inheritDoc */
         this.deviceType = devices_1.DeviceType.GoveeLed;
+        /** @inheritDoc */
         this.deviceCapabilities = [
             DeviceCapability_1.DeviceCapability.ledLamp,
             DeviceCapability_1.DeviceCapability.lamp,
             DeviceCapability_1.DeviceCapability.dimmablelamp,
             DeviceCapability_1.DeviceCapability.blockAutomatic,
         ];
-        this.on = false;
+        /** @inheritDoc */
         this.queuedValue = null;
+        /** @inheritDoc */
         this.brightness = -1;
+        /** @inheritDoc */
         this.targetAutomaticState = false;
+        this._on = false;
         this._color = '#fcba32';
         this._colortemp = 500;
         this._room = undefined;
@@ -57,17 +63,14 @@ class OwnGoveeDevice {
         return this.info.customName;
     }
     get actuatorOn() {
-        return this.on;
+        return this._on;
     }
     get lightOn() {
-        return this.on;
+        return this._on;
     }
     get info() {
         return this._info;
     }
-    set info(info) {
-        this._info = info;
-    }
     get id() {
         var _a;
         return (_a = this.info.allDevicesKey) !== null && _a !== void 0 ? _a : `govee-${this.info.room}-${this.info.customName}`;
@@ -96,15 +99,11 @@ class OwnGoveeDevice {
     loadDeviceSettings() {
         this.settings.initializeFromDb(this);
     }
-    /**
-     * @inheritDoc
-     */
+    /** @inheritDoc */
     setTimeBased(c) {
         this.setLight(models_1.LedSetLightCommand.byTimeBased(this.settings, c));
     }
-    /**
-     * @inheritDoc
-     */
+    /** @inheritDoc */
     setLight(c) {
         if (c.on && c.brightness === -1 && this.brightness < 10) {
             c.brightness = 10;
@@ -129,8 +128,8 @@ class OwnGoveeDevice {
         else {
             this.turnOff();
         }
-        if (c.timeout > -1 && !dontBlock) {
-            this.blockAutomationHandler.disableAutomatic(new models_1.BlockAutomaticCommand(c, c.timeout));
+        if (c.disableAutomaticCommand && !dontBlock) {
+            this.blockAutomationHandler.disableAutomatic(c.disableAutomaticCommand);
         }
     }
     setActuator(c) {
@@ -162,7 +161,7 @@ class OwnGoveeDevice {
     }
     update(data) {
         this.queuedValue = null;
-        this.on = data.onOff === 1;
+        this._on = data.onOff === 1;
         this.brightness = data.brightness;
         this._color = `#${data.color.r.toString(16)}${data.color.g.toString(16)}${data.color.b.toString(16)}`;
         this._colortemp = data.colorTemInKelvin;
@@ -193,12 +192,12 @@ class OwnGoveeDevice {
     }
     turnOn() {
         var _a;
-        if (this.on) {
+        if (this._on) {
             return;
         }
         this.queuedValue = true;
         (_a = this.device) === null || _a === void 0 ? void 0 : _a.turnOn().then(() => {
-            this.log(models_1.LogLevel.Debug, `Govee turned on`, log_service_1.LogDebugType.SetActuator);
+            this.log(models_1.LogLevel.Debug, 'Govee turned on', log_service_1.LogDebugType.SetActuator);
         }).catch((error) => {
             this.log(models_1.LogLevel.Error, `Govee turn on resulted in error: ${error}`);
         });
@@ -207,7 +206,7 @@ class OwnGoveeDevice {
         var _a;
         this.queuedValue = false;
         (_a = this.device) === null || _a === void 0 ? void 0 : _a.turnOff().then(() => {
-            this.log(models_1.LogLevel.Debug, `Govee turned off`, log_service_1.LogDebugType.SetActuator);
+            this.log(models_1.LogLevel.Debug, 'Govee turned off', log_service_1.LogDebugType.SetActuator);
         }).catch((error) => {
             this.log(models_1.LogLevel.Error, `Govee turn off resulted in error: ${error}`);
         });

package/lib/server/services/govee/own-govee-devices.d.ts

@@ -1,5 +1,8 @@
 import { OwnGoveeDevice } from './own-govee-device';
 export declare class OwnGoveeDevices {
+    /**
+     * A Dictionary of all own Govee devices
+     */
     static ownDevices: {
         [name: string]: OwnGoveeDevice;
     };

package/lib/server/services/govee/own-govee-devices.js

@@ -10,4 +10,7 @@ class OwnGoveeDevices {
     }
 }
 exports.OwnGoveeDevices = OwnGoveeDevices;
+/**
+ * A Dictionary of all own Govee devices
+ */
 OwnGoveeDevices.ownDevices = {};

package/lib/server/services/https-service.js

@@ -54,7 +54,7 @@ class HTTPSService {
                 }, 100);
             }
             else {
-                log_service_1.ServerLogService.writeLog(models_1.LogLevel.Error, `HTTPS request failed after retries`);
+                log_service_1.ServerLogService.writeLog(models_1.LogLevel.Error, 'HTTPS request failed after retries');
             }
         });
         if (postData !== '') {

package/lib/server/services/index.d.ts

@@ -19,3 +19,4 @@ export * from './ShutterService';
 export * from './tibber-service';
 export * from './victron/index';
 export * from './time-callback-service';
+export { FileInfo } from './file-info';

package/lib/server/services/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 });
+exports.FileInfo = void 0;
 __exportStar(require("./ac/index"), exports);
 __exportStar(require("./api/index"), exports);
 __exportStar(require("./calendar/index"), exports);
@@ -35,3 +36,5 @@ __exportStar(require("./ShutterService"), exports);
 __exportStar(require("./tibber-service"), exports);
 __exportStar(require("./victron/index"), exports);
 __exportStar(require("./time-callback-service"), exports);
+var file_info_1 = require("./file-info");
+Object.defineProperty(exports, "FileInfo", { enumerable: true, get: function () { return file_info_1.FileInfo; } });

package/lib/server/services/log-service/index.d.ts

@@ -1,3 +1,4 @@
 export * from './log-service';
 export * from './log-object';
 export * from './log-filter-data';
+export { LogDebugType } from './log-debug-type';

package/lib/server/services/log-service/index.js

@@ -14,6 +14,9 @@ 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.LogDebugType = void 0;
 __exportStar(require("./log-service"), exports);
 __exportStar(require("./log-object"), exports);
 __exportStar(require("./log-filter-data"), exports);
+var log_debug_type_1 = require("./log-debug-type");
+Object.defineProperty(exports, "LogDebugType", { enumerable: true, get: function () { return log_debug_type_1.LogDebugType; } });

package/lib/server/services/log-service/log-debug-type.d.ts

@@ -0,0 +1,12 @@
+export declare enum LogDebugType {
+    None = 0,
+    SkipUnchangedActuatorCommand = 1,
+    SkipUnchangedRolloPosition = 2,
+    SetActuator = 3,
+    ShutterPositionChange = 4,
+    NewMovementState = 5,
+    SkipUnchangedMovementState = 6,
+    DaikinSuccessfullControlInfo = 7,
+    EuroHeaterValveLogging = 8,
+    Trilateration = 9
+}

package/lib/server/services/log-service/log-debug-type.js

@@ -0,0 +1,16 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LogDebugType = void 0;
+var LogDebugType;
+(function (LogDebugType) {
+    LogDebugType[LogDebugType["None"] = 0] = "None";
+    LogDebugType[LogDebugType["SkipUnchangedActuatorCommand"] = 1] = "SkipUnchangedActuatorCommand";
+    LogDebugType[LogDebugType["SkipUnchangedRolloPosition"] = 2] = "SkipUnchangedRolloPosition";
+    LogDebugType[LogDebugType["SetActuator"] = 3] = "SetActuator";
+    LogDebugType[LogDebugType["ShutterPositionChange"] = 4] = "ShutterPositionChange";
+    LogDebugType[LogDebugType["NewMovementState"] = 5] = "NewMovementState";
+    LogDebugType[LogDebugType["SkipUnchangedMovementState"] = 6] = "SkipUnchangedMovementState";
+    LogDebugType[LogDebugType["DaikinSuccessfullControlInfo"] = 7] = "DaikinSuccessfullControlInfo";
+    LogDebugType[LogDebugType["EuroHeaterValveLogging"] = 8] = "EuroHeaterValveLogging";
+    LogDebugType[LogDebugType["Trilateration"] = 9] = "Trilateration";
+})(LogDebugType || (exports.LogDebugType = LogDebugType = {}));

package/lib/server/services/log-service/log-filter-data.d.ts

@@ -1,21 +1,30 @@
 import { LogSource } from '../../../models/logSource';
-export declare enum LogDebugType {
-    None = 0,
-    SkipUnchangedActuatorCommand = 1,
-    SkipUnchangedRolloPosition = 2,
-    SetActuator = 3,
-    ShutterPositionChange = 4,
-    NewMovementState = 5,
-    SkipUnchangedMovementState = 6,
-    DaikinSuccessfullControlInfo = 7,
-    EuroHeaterValveLogging = 8,
-    Trilateration = 9
-}
+import { LogDebugType } from './log-debug-type';
 export declare class LogFilterData {
+    /**
+     * If given, the room this log-item is related to
+     */
     room?: string;
+    /**
+     * If given, the device this log-item is related to identified by its ID
+     */
     deviceId?: string;
+    /**
+     * If given, the name of the device this log-item is related to
+     */
     deviceName?: string;
+    /**
+     * If given, the group this log-item can be associated with
+     * @example WindowGroup
+     */
     groupType?: string;
+    /**
+     * If given, a source identifying the origin of the log-item
+     * TODO: Add further sources
+     */
     source?: LogSource;
+    /**
+     * If given, the debug-type which in accordance to {@link iLogSettings} might result in this being filtered out
+     */
     debugType?: LogDebugType;
 }

package/lib/server/services/log-service/log-filter-data.js

@@ -1,22 +1,13 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.LogFilterData = exports.LogDebugType = void 0;
-var LogDebugType;
-(function (LogDebugType) {
-    LogDebugType[LogDebugType["None"] = 0] = "None";
-    LogDebugType[LogDebugType["SkipUnchangedActuatorCommand"] = 1] = "SkipUnchangedActuatorCommand";
-    LogDebugType[LogDebugType["SkipUnchangedRolloPosition"] = 2] = "SkipUnchangedRolloPosition";
-    LogDebugType[LogDebugType["SetActuator"] = 3] = "SetActuator";
-    LogDebugType[LogDebugType["ShutterPositionChange"] = 4] = "ShutterPositionChange";
-    LogDebugType[LogDebugType["NewMovementState"] = 5] = "NewMovementState";
-    LogDebugType[LogDebugType["SkipUnchangedMovementState"] = 6] = "SkipUnchangedMovementState";
-    LogDebugType[LogDebugType["DaikinSuccessfullControlInfo"] = 7] = "DaikinSuccessfullControlInfo";
-    LogDebugType[LogDebugType["EuroHeaterValveLogging"] = 8] = "EuroHeaterValveLogging";
-    LogDebugType[LogDebugType["Trilateration"] = 9] = "Trilateration";
-})(LogDebugType || (exports.LogDebugType = LogDebugType = {}));
+exports.LogFilterData = void 0;
+const log_debug_type_1 = require("./log-debug-type");
 class LogFilterData {
     constructor() {
-        this.debugType = LogDebugType.None;
+        /**
+         * If given, the debug-type which in accordance to {@link iLogSettings} might result in this being filtered out
+         */
+        this.debugType = log_debug_type_1.LogDebugType.None;
     }
 }
 exports.LogFilterData = LogFilterData;

package/lib/server/services/log-service/log-service.d.ts

@@ -1,13 +1,26 @@
 import { LogLevel } from '../../../models';
 import { DeviceType } from '../../devices';
 import { iLogSettings } from '../../config';
-import { ringStorage } from '../utils';
+import { RingStorage } from '../utils';
 import { LogObject } from './log-object';
 import { LogFilterData } from './log-filter-data';
 export declare class ServerLogService {
+    /**
+     * The level at which messages are sent to telegram
+     * @remarks defined at {@link iConfig.telegram.logLevel}
+     */
     static telegramLevel: number;
+    /**
+     * The threshold above which messages are stored in the ring-storage to be retrieved e.g. using {@link API.getLog}
+     */
     static storageLevel: number;
-    static storage: ringStorage<LogObject>;
+    /**
+     * The storage for the log messages
+     */
+    static storage: RingStorage<LogObject>;
+    /**
+     * The settings for the logging system.
+     */
     static settings: iLogSettings;
     static getLog(amount?: number): LogObject[];
     static initialize(logSettings: iLogSettings): void;

package/lib/server/services/log-service/log-service.js

@@ -6,9 +6,9 @@ const models_1 = require("../../../models");
 const devices_1 = require("../../devices");
 const utils_1 = require("../utils");
 const log_object_1 = require("./log-object");
-const log_filter_data_1 = require("./log-filter-data");
 const logSource_1 = require("../../../models/logSource");
 const settings_service_1 = require("../settings-service");
+const log_debug_type_1 = require("./log-debug-type");
 class ServerLogService {
     static getLog(amount = 5000) {
         return this.storage.readAmount(amount);
@@ -44,7 +44,7 @@ class ServerLogService {
             console.log(message);
             if (pLevel <= ServerLogService.telegramLevel) {
                 const title = models_1.LogLevel[pLevel];
-                Telegram_1.TelegramService.sendMessage(Telegram_1.TelegramService.subscribedIDs, `${title}: ${message}`);
+                Telegram_1.TelegramService.sendMessageToSubscriber(`${title}: ${message}`);
             }
         }
     }
@@ -66,49 +66,49 @@ class ServerLogService {
     static checkDebugLogSkip(debugType) {
         var _a, _b, _c, _d, _e, _f, _g, _h, _j;
         switch (debugType) {
-            case log_filter_data_1.LogDebugType.None:
+            case log_debug_type_1.LogDebugType.None:
                 return false;
-            case log_filter_data_1.LogDebugType.SkipUnchangedActuatorCommand:
+            case log_debug_type_1.LogDebugType.SkipUnchangedActuatorCommand:
                 if (((_a = settings_service_1.SettingsService.settings.logSettings) === null || _a === void 0 ? void 0 : _a.debugUnchangedActuator) === true) {
                     return false;
                 }
                 break;
-            case log_filter_data_1.LogDebugType.SkipUnchangedRolloPosition:
+            case log_debug_type_1.LogDebugType.SkipUnchangedRolloPosition:
                 if (((_b = settings_service_1.SettingsService.settings.logSettings) === null || _b === void 0 ? void 0 : _b.debugUchangedShutterPosition) === true) {
                     return false;
                 }
                 break;
-            case log_filter_data_1.LogDebugType.SetActuator:
+            case log_debug_type_1.LogDebugType.SetActuator:
                 if (((_c = settings_service_1.SettingsService.settings.logSettings) === null || _c === void 0 ? void 0 : _c.debugActuatorChange) === true) {
                     return false;
                 }
                 break;
-            case log_filter_data_1.LogDebugType.ShutterPositionChange:
+            case log_debug_type_1.LogDebugType.ShutterPositionChange:
                 if (((_d = settings_service_1.SettingsService.settings.logSettings) === null || _d === void 0 ? void 0 : _d.debugShutterPositionChange) === true) {
                     return false;
                 }
                 break;
-            case log_filter_data_1.LogDebugType.NewMovementState:
+            case log_debug_type_1.LogDebugType.NewMovementState:
                 if (((_e = settings_service_1.SettingsService.settings.logSettings) === null || _e === void 0 ? void 0 : _e.debugNewMovementState) === true) {
                     return false;
                 }
                 break;
-            case log_filter_data_1.LogDebugType.SkipUnchangedMovementState:
+            case log_debug_type_1.LogDebugType.SkipUnchangedMovementState:
                 if (((_f = settings_service_1.SettingsService.settings.logSettings) === null || _f === void 0 ? void 0 : _f.debugNewMovementState) === true) {
                     return false;
                 }
                 break;
-            case log_filter_data_1.LogDebugType.DaikinSuccessfullControlInfo:
+            case log_debug_type_1.LogDebugType.DaikinSuccessfullControlInfo:
                 if (((_g = settings_service_1.SettingsService.settings.logSettings) === null || _g === void 0 ? void 0 : _g.debugDaikinSuccessfullControlInfo) === true) {
                     return false;
                 }
                 break;
-            case log_filter_data_1.LogDebugType.EuroHeaterValveLogging:
+            case log_debug_type_1.LogDebugType.EuroHeaterValveLogging:
                 if (((_h = settings_service_1.SettingsService.settings.logSettings) === null || _h === void 0 ? void 0 : _h.debugEuroHeaterValve) === true) {
                     return false;
                 }
                 break;
-            case log_filter_data_1.LogDebugType.Trilateration:
+            case log_debug_type_1.LogDebugType.Trilateration:
                 if (((_j = settings_service_1.SettingsService.settings.logSettings) === null || _j === void 0 ? void 0 : _j.debugTrilateration) === true) {
                     return false;
                 }
@@ -118,10 +118,23 @@ class ServerLogService {
     }
 }
 exports.ServerLogService = ServerLogService;
+/**
+ * The level at which messages are sent to telegram
+ * @remarks defined at {@link iConfig.telegram.logLevel}
+ */
 ServerLogService.telegramLevel = -1; // Controlled from within Config File
-ServerLogService.storageLevel = 5; // Controlled from within Config File
-ServerLogService.storage = new utils_1.ringStorage(10000);
+/**
+ * The threshold above which messages are stored in the ring-storage to be retrieved e.g. using {@link API.getLog}
+ */
+ServerLogService.storageLevel = models_1.LogLevel.Trace; // Controlled from within Config File
+/**
+ * The storage for the log messages
+ */
+ServerLogService.storage = new utils_1.RingStorage(10000);
+/**
+ * The settings for the logging system.
+ */
 ServerLogService.settings = {
-    logLevel: 4,
+    logLevel: models_1.LogLevel.Debug,
     useTimestamp: false,
 };

package/lib/server/services/news-service.d.ts

@@ -1,6 +1,9 @@
 import { iNewsSettings } from '../config';
 import { iSpeaker } from '../devices';
 export declare class NewsService {
+    /**
+     * Path to the most recently downloaded news audio file
+     */
     static lastNewsAudioFile: string;
     private static readonly newsFilePrefix;
     private static interval;
@@ -11,7 +14,7 @@ export declare class NewsService {
     static initialize(config?: Partial<iNewsSettings>): void;
     /**
      * Stops the regular check for new news feed items.
-     * @deprecated Use stopInterval instead
+     * @deprecated Use {@link stopInterval} instead
      */
     static stopHourlyInterval(): void;
     static startInterval(): void;

package/lib/server/services/news-service.js

@@ -41,7 +41,7 @@ class NewsService {
     static initialize(config) {
         var _a, _b;
         if (config === undefined) {
-            log_service_1.ServerLogService.writeLog(models_1.LogLevel.Warn, `Service disabled.`, { source: logSource_1.LogSource.News });
+            log_service_1.ServerLogService.writeLog(models_1.LogLevel.Warn, 'Service disabled.', { source: logSource_1.LogSource.News });
             return;
         }
         NewsService.keepMaxAge = (_a = config.keepMaxAge) !== null && _a !== void 0 ? _a : 120;
@@ -51,7 +51,7 @@ class NewsService {
     }
     /**
      * Stops the regular check for new news feed items.
-     * @deprecated Use stopInterval instead
+     * @deprecated Use {@link stopInterval} instead
      */
     static stopHourlyInterval() {
         NewsService.stopInterval();
@@ -80,14 +80,14 @@ class NewsService {
      */
     static getLatestNews() {
         if (settings_service_1.SettingsService.settings.mp3Server === undefined) {
-            log_service_1.ServerLogService.writeLog(models_1.LogLevel.Warn, `Not checking for newest news file, no download directory defined.`, {
+            log_service_1.ServerLogService.writeLog(models_1.LogLevel.Warn, 'Not checking for newest news file, no download directory defined.', {
                 source: logSource_1.LogSource.News,
             });
             return;
         }
         NewsService.cleanOldFiles(settings_service_1.SettingsService.settings.mp3Server.path, NewsService.keepMaxAge);
         if (NewsService.rssUrl === undefined) {
-            log_service_1.ServerLogService.writeLog(models_1.LogLevel.Warn, `No rss feed set, not searching for new news.`, {
+            log_service_1.ServerLogService.writeLog(models_1.LogLevel.Warn, 'No rss feed set, not searching for new news.', {
                 source: logSource_1.LogSource.News,
             });
             return;
@@ -111,7 +111,7 @@ class NewsService {
                 }, 1000);
             }
             else {
-                log_service_1.ServerLogService.writeLog(models_1.LogLevel.Error, `Service not ready despite waiting --> Abort.`, {
+                log_service_1.ServerLogService.writeLog(models_1.LogLevel.Error, 'Service not ready despite waiting --> Abort.', {
                     source: logSource_1.LogSource.News,
                 });
             }
@@ -128,7 +128,7 @@ class NewsService {
                 const currentFeedItem = feed.items[0];
                 log_service_1.ServerLogService.writeLog(models_1.LogLevel.Debug, `Most recent news on ${feed.title} is "${currentFeedItem.title}"`);
                 if (currentFeedItem.enclosure === undefined) {
-                    log_service_1.ServerLogService.writeLog(models_1.LogLevel.Warn, `Couldn't find audio in last item of the rss feed.`, {
+                    log_service_1.ServerLogService.writeLog(models_1.LogLevel.Warn, "Couldn't find audio in last item of the rss feed.", {
                         source: logSource_1.LogSource.News,
                     });
                     return;
@@ -137,14 +137,14 @@ class NewsService {
                 // check for both path and pubdate in case the file name is always the same one
                 if (fs.existsSync(filePath) && NewsService.lastFetchedPubDate == currentFeedItem.pubDate) {
                     NewsService.lastNewsAudioFile = path_1.default.basename(filePath);
-                    log_service_1.ServerLogService.writeLog(models_1.LogLevel.Debug, `Newest file already downloaded.`, { source: logSource_1.LogSource.News });
+                    log_service_1.ServerLogService.writeLog(models_1.LogLevel.Debug, 'Newest file already downloaded.', { source: logSource_1.LogSource.News });
                     return;
                 }
                 log_service_1.ServerLogService.writeLog(models_1.LogLevel.Debug, `Current news download Link: "${currentFeedItem.enclosure.url}"`);
                 https_service_1.HTTPSService.downloadFile(currentFeedItem.enclosure.url, filePath)
                     .then((success) => {
                     if (!success) {
-                        log_service_1.ServerLogService.writeLog(models_1.LogLevel.Debug, `Error while downloading audio file.`, {
+                        log_service_1.ServerLogService.writeLog(models_1.LogLevel.Debug, 'Error while downloading audio file.', {
                             source: logSource_1.LogSource.News,
                         });
                         return;
@@ -204,4 +204,4 @@ class NewsService {
 }
 exports.NewsService = NewsService;
 // prefix for all downloaded files of the news service
-NewsService.newsFilePrefix = `news$`;
+NewsService.newsFilePrefix = 'news$';

package/lib/server/services/room-service/room-service.d.ts

@@ -1,12 +1,27 @@
-import { ringStorage } from '../utils';
+import { RingStorage } from '../utils';
 import { ActuatorSetStateCommand, FloorSetAllShuttersCommand, iRoomBase, RoomBase } from '../../../models';
 import { BaseGroup, iRoomDevice } from '../../devices';
 export declare class RoomService {
+    /**
+     * A Map containing all rooms in the house identified by their name
+     */
     static Rooms: Map<string, RoomBase>;
+    /**
+     * A Map containing all groups in the house identified by {@link BaseGroup.id}
+     */
     static Groups: Map<string, BaseGroup>;
+    /**
+     * A boolean indicating if the away mode is active, which triggers certain alarms on movement
+     */
     static awayModeActive: boolean;
+    /**
+     * A boolean indicating if the night mode is active, which triggers certain alarms on movement in rooms included in night alarm
+     */
     static nightAlarmActive: boolean;
-    static movementHistory: ringStorage<string>;
+    /**
+     * A ring storage containing the last 15 detected movements in the house
+     */
+    static movementHistory: RingStorage<string>;
     private static _awayModeTimeout;
     private static _nightModeTimeout;
     private static _intrusionAlarmActive;