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

package/lib/server/devices/baseDeviceInterfaces/iMagnetSensor.d.ts

@@ -0,0 +1,31 @@
+import { iRoomDevice } from './iRoomDevice';
+import { MagnetPosition } from '../models';
+/**
+ * This interface represents a magnet sensor device.
+ *
+ * For devices with {@link DeviceCapability.magnetSensor} capability.
+ */
+export interface iMagnetSensor extends iRoomDevice {
+    /**
+     * The current state of the Magnet Contact
+     */
+    position: MagnetPosition;
+    /**
+     * Whether a telegram message should be sent when the magnet contact is opened
+     */
+    telegramOnOpen: boolean;
+    /**
+     * Whether to announce when the magnet contact is opened using {@link iSpeaker}
+     */
+    speakOnOpen: boolean;
+    /**
+     * Add a callback that is called when the magnet contact is opened
+     * @param pCallback - The callback to fire
+     */
+    addOpenCallback(pCallback: (pValue: boolean) => void): void;
+    /**
+     * Add a callback that is called when the magnet contact is closed
+     * @param pCallback - The callback to fire
+     */
+    addClosedCallback(pCallback: (pValue: boolean) => void): void;
+}

package/lib/server/devices/baseDeviceInterfaces/iMagnetSensor.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/lib/server/devices/baseDeviceInterfaces/iMotionSensor.d.ts

@@ -1,14 +1,34 @@
-import { MotionSensorSettings } from '../../../models';
+import { MotionSensorAction, MotionSensorSettings } from '../../../models';
 import { iRoomDevice } from './iRoomDevice';
+/**
+ * This interface represents a motion sensor device.
+ *
+ * For devices with {@link DeviceCapability.motionSensor} capability.
+ */
 export interface iMotionSensor extends iRoomDevice {
+    /**
+     * The settings of the MotionSensor
+     */
     settings: MotionSensorSettings;
+    /**
+     * Whether motion is currently detected
+     */
     readonly movementDetected: boolean;
+    /**
+     * Time since the last motion was detected in seconds
+     */
     readonly timeSinceLastMotion: number;
+    /**
+     * The number of detections today so far
+     */
     detectionsToday: number;
     /**
      * Adds a callback for when a motion state has changed.
-     * @param pCallback Function that accepts the new state as parameter
+     * @param pCallback - Function that accepts the new state as parameter
+     */
+    addMovementCallback(pCallback: (action: MotionSensorAction) => void): void;
+    /**
+     * Persists the current motion information to the database
      */
-    addMovementCallback(pCallback: (newState: boolean) => void): void;
     persistMotionSensor(): void;
 }

package/lib/server/devices/baseDeviceInterfaces/iRoomDevice.d.ts

@@ -1,5 +1,11 @@
 import { RoomBase } from '../../../models';
 import { iBaseDevice } from './iBaseDevice';
+/**
+ * This interface represents a device that is located in a single room.
+ */
 export interface iRoomDevice extends iBaseDevice {
+    /**
+     * The room the device is in (this might be undefined if the device is not yet properly initialized)
+     */
     room: RoomBase | undefined;
 }

package/lib/server/devices/baseDeviceInterfaces/iScene.d.ts

@@ -1,13 +1,43 @@
 /// <reference types="node" />
 import { iRoomDevice } from './index';
 import { SceneSettings } from '../../../models';
+/**
+ * This interface represents a scene which for simplification is considered as a device.
+ *
+ * For devices with {@link DeviceCapability.scene} capability.
+ */
 export interface iScene extends iRoomDevice {
+    /**
+     * The settings for the scene
+     */
+    settings: SceneSettings;
+    /**
+     * A description of the scene providing the user with information about what the scene does
+     */
     description: string;
+    /**
+     * Callback to be executed when the scene should be started
+     */
     readonly onSceneStart: () => void;
+    /**
+     * Callback to be executed when the scene should be ended
+     */
     readonly onSceneEnd: () => void;
+    /**
+     * Whether the scene is currently active
+     */
     readonly on: boolean;
+    /**
+     * The timeout for the automatic end of the scene
+     */
     readonly automaticEndTimeout: NodeJS.Timeout | null;
-    settings: SceneSettings;
+    /**
+     * Starts the scene for the given duration
+     * @param timeout - If set, the scene will end after the given time in ms
+     */
     startScene(timeout?: number): void;
+    /**
+     * Ends the scene --> This also stops the automatic end timeout.
+     */
     endScene(): void;
 }

package/lib/server/devices/baseDeviceInterfaces/iShutter.d.ts

@@ -1,11 +1,35 @@
 import { Window } from '../groups';
 import { iRoomDevice } from './iRoomDevice';
 import { ShutterSetLevelCommand, ShutterSettings } from '../../../models';
+/**
+ * This interface represents a shutter device.
+ *
+ * For devices with {@link DeviceCapability.shutter} capability.
+ */
 export interface iShutter extends iRoomDevice {
+    /**
+     * The settings for the shutter
+     */
     settings: ShutterSettings;
-    currentLevel: number;
+    /**
+     * The current level of the shutter (0 = closed, 100 = open)
+     */
+    readonly currentLevel: number;
+    /**
+     * The desired level of the shutter for this window (this might be different from the current level due to the desired level being set by the user)
+     */
     desiredWindowShutterLevel: number;
+    /**
+     * The window this shutter is located within
+     */
     window: Window | undefined;
+    /**
+     * Persists the current information of the shutter to the database
+     */
     persist(): void;
+    /**
+     * Sets the level of the shutter
+     * @param command - The command to execute
+     */
     setLevel(command: ShutterSetLevelCommand): void;
 }

package/lib/server/devices/baseDeviceInterfaces/iSmokeDetectorDevice.d.ts

@@ -1,5 +1,17 @@
 import { iRoomDevice } from './iRoomDevice';
+/**
+ * This interface represents a smoke detector device.
+ *
+ * For devices with {@link DeviceCapability.smokeSensor} capability.
+ */
 export interface iSmokeDetectorDevice extends iRoomDevice {
+    /**
+     * Indicates if the smoke detector is currently detecting smoke
+     */
     readonly smoke: boolean;
+    /**
+     * Stops the alarm of the smoke detector
+     * @param quiet - If true, the alarm will be stopped without announcing alarm end.
+     */
     stopAlarm(quiet: boolean): void;
 }

package/lib/server/devices/baseDeviceInterfaces/iSpeaker.d.ts

@@ -1,8 +1,38 @@
 import { iRoomDevice } from './iRoomDevice';
+/**
+ * This interface represents a speaker device.
+ *
+ * For devices with {@link DeviceCapability.speaker} capability.
+ */
 export interface iSpeaker extends iRoomDevice {
+    /**
+     * Plays an mp3 file on the device
+     * @param mp3Name - The name of the mp3 file to play
+     * @param duration - The duration of the mp3 file in seconds
+     * @param [volume] - The volume to play the mp3 file with
+     * @param [onlyWhenPlaying] - If true, the mp3 file will only be played when the device is already playing something
+     * @param [resolveAfterRevert] - If true, the promise will be resolved after the device has reverted to the previous state
+     */
     playOnDevice(mp3Name: string, duration: number, volume?: number, onlyWhenPlaying?: boolean, resolveAfterRevert?: boolean): void;
+    /**
+     * Plays a test message on the device
+     */
     playTestMessage(): void;
+    /**
+     * Plays a file from an url on the device
+     * @param url - The url to play
+     */
     playUrl(url: string): void;
+    /**
+     * Stops the current playback on the device
+     */
     stop(): void;
+    /**
+     * Speaks a message on the device using the text-to-speech engine
+     * @param pMessage - The message to speak
+     * @param [volume] - The volume to speak the message with
+     * @param [onlyWhenPlaying] - If true, the message will only be spoken when the device is already playing something
+     * @param [resolveAfterRevert] - If true, the promise will be resolved after the device has reverted to the previous state
+     */
     speakOnDevice(pMessage: string, volume?: number, onlyWhenPlaying?: boolean, resolveAfterRevert?: boolean): void;
 }

package/lib/server/devices/baseDeviceInterfaces/iTemperatureSensor.d.ts

@@ -1,12 +1,42 @@
 /// <reference types="node" />
 import { iRoomDevice } from './iRoomDevice';
+import { TemperatureSensorChangeAction } from '../../../models';
 export declare const UNDEFINED_TEMP_VALUE = -99;
+/**
+ * This interface represents a temperature sensor device.
+ *
+ * For devices with {@link DeviceCapability.temperatureSensor} capability.
+ */
 export interface iTemperatureSensor extends iRoomDevice {
+    /**
+     * The interval to persist the temperature sensor information
+     * Mainly used to enforce implementation
+     */
     readonly persistTemperatureSensorInterval: NodeJS.Timeout;
+    /**
+     * The current room temperature as a number in Celsius
+     */
     roomTemperature: number;
-    iTemperature: number;
+    /**
+     * The devices measured Temperature as a number in Celsius
+     */
+    readonly iTemperature: number;
+    /**
+     * Formatted Temperature as a string in Celsius
+     */
     sTemperature: string;
-    addTempChangeCallback(pCallback: (pValue: number) => void): void;
+    /**
+     * Adds a callback to be called when the temperature changes
+     * @param pCallback - The callback to be called
+     */
+    addTempChangeCallback(pCallback: (action: TemperatureSensorChangeAction) => void): void;
+    /**
+     * Inform the temperature sensor that the temperature in the room has changed
+     * @param newTemperatur - The new temperature in the room in Celsius
+     */
     onTemperaturChange(newTemperatur: number): void;
+    /**
+     * Persists the current temperature sensor information to the database
+     */
     persistTemperaturSensor(): void;
 }

package/lib/server/devices/baseDeviceInterfaces/iTemporaryDisableAutomatic.d.ts

@@ -1,7 +1,20 @@
 import { BlockAutomaticHandler } from '../../services/blockAutomaticHandler';
 import { iBaseDevice } from './iBaseDevice';
 import { RestoreTargetAutomaticValueCommand } from '../../../models';
+/**
+ * This interface represents a device which automatic action can be temporarily disabled.
+ * E.g. Forcing a lamp to stay on, even if the automatic would turn it off.
+ *
+ * For devices with {@link DeviceCapability.blockAutomatic} capability.
+ */
 export interface iTemporaryDisableAutomatic extends iBaseDevice {
+    /**
+     * The block automation handler containing the current block state/time, etc.
+     */
     readonly blockAutomationHandler: BlockAutomaticHandler;
+    /**
+     * Restores the automatic value/state of the device
+     * @param command - The command to restore the automatic value/state
+     */
     restoreTargetAutomaticValue(command: RestoreTargetAutomaticValueCommand): void;
 }

package/lib/server/devices/baseDeviceInterfaces/iTvDevice.d.ts

@@ -1,8 +1,28 @@
 import { iRoomDevice } from './iRoomDevice';
+/**
+ * This interface represents a TV device.
+ *
+ * For devices with {@link DeviceCapability.tv} capability.
+ */
 export interface iTvDevice extends iRoomDevice {
+    /**
+     * Whether the TV is currently on
+     */
     readonly on: boolean;
+    /**
+     * Turns the TV on
+     */
     turnOn(): void;
+    /**
+     * Turns the TV off
+     */
     turnOff(): void;
+    /**
+     * Increases the volume of the TV
+     */
     volumeUp(): void;
+    /**
+     * Decreases the volume of the TV
+     */
     volumeDown(): void;
 }

package/lib/server/devices/baseDeviceInterfaces/iVibrationSensor.d.ts

@@ -1,9 +1,28 @@
 import { iRoomDevice } from './iRoomDevice';
+/**
+ * This interface represents a vibration sensor device.
+ *
+ * For devices with {@link DeviceCapability.vibrationSensor} capability.
+ */
 export interface iVibrationSensor extends iRoomDevice {
-    vibrationBlockedByGriff: boolean;
-    vibrationBlockedByGriffTimeStamp: number;
+    /**
+     * Whether the vibration sensor is currently blocked by a handle.
+     */
+    vibrationBlockedByHandle: boolean;
+    /**
+     * The timestamp when the vibration sensor was blocked by a handle.
+     */
+    readonly vibrationBlockedByHandleTimeStamp: number;
+    /**
+     * Whether the vibration sensor is currently blocked by a motion event.
+     */
     vibrationBlockedByMotion: boolean;
-    vibrationBlockedByMotionTimeStamp: number;
-    vibration: boolean;
-    alarmCheck(): void;
+    /**
+     * The timestamp when the vibration sensor was last blocked by a motion event.
+     */
+    readonly vibrationBlockedByMotionTimeStamp: number;
+    /**
+     * Whether the vibration sensor is currently detecting a vibration.
+     */
+    readonly vibration: boolean;
 }

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

@@ -22,3 +22,4 @@ export * from './iTemperatureSensor';
 export * from './iTemporaryDisableAutomatic';
 export * from './iTvDevice';
 export * from './iVibrationSensor';
+export { iMagnetSensor } from './iMagnetSensor';

package/lib/server/devices/blueIris/cameraDevice.d.ts

@@ -1,68 +1,83 @@
-import { iCameraDevice, iRoomDevice } from '../baseDeviceInterfaces';
-import { CameraSettings, LogLevel, RoomBase } from '../../../models';
+import { iBaseDevice, iCameraDevice, iRoomDevice } from '../baseDeviceInterfaces';
+import { CameraSettings, LogLevel, MotionSensorAction, RoomBase } from '../../../models';
 import { LogDebugType } from '../../services';
 import { DeviceInfo } from '../DeviceInfo';
 import { DeviceCapability } from '../DeviceCapability';
 import { DeviceType } from '../deviceType';
 export declare class CameraDevice implements iCameraDevice {
+    /**
+     * The name of the camera in BlueIris
+     */
     readonly blueIrisName: string;
+    /** @inheritDoc */
+    settings: CameraSettings;
+    /** @inheritDoc */
+    readonly deviceCapabilities: DeviceCapability[];
+    /** @inheritDoc */
+    deviceType: DeviceType;
+    /**
+     * The human readable name of this device
+     */
+    readonly name: string;
+    /** @inheritDoc */
+    readonly mpegStreamLink: string;
+    /** @inheritDoc */
+    readonly h264IosStreamLink: string;
+    /** @inheritDoc */
+    readonly rtspStreamLink: string;
+    /** @inheritDoc */
+    readonly currentImageLink: string;
+    /** @inheritDoc */
+    detectionsToday: number;
+    protected _lastMotion: number;
     private _personDetectFallbackTimeout;
     private _movementDetectFallbackTimeout;
     private _dogDetectFallbackTimeout;
     private _personDetectedStateId;
     private _dogDetectedStateId;
     private _movementDetectedStateId;
-    get lastImage(): string;
-    settings: CameraSettings;
-    readonly deviceCapabilities: DeviceCapability[];
-    deviceType: DeviceType;
-    readonly name: string;
-    protected _lastMotion: number;
     private _initialized;
     private _movementDetectedCallback;
     private _lastImage;
     private _personDetected;
     private _dogDetected;
-    private _alarmGriffBlockCount;
-    private _alarmBlockedByGriffTimeStamp;
-    readonly mpegStreamLink: string;
-    readonly h264IosStreamLink: string;
-    readonly rtspStreamLink: string;
-    readonly currentImageLink: string;
+    private _devicesBlockingAlarmMap;
+    private _movementDetected;
+    private _info;
+    constructor(mqttName: string, roomName: string, blueIrisName: string);
+    /** @inheritDoc */
+    get lastImage(): string;
+    /** @inheritDoc */
     get dogDetected(): boolean;
+    /** @inheritDoc */
     get personDetected(): boolean;
-    get alarmBlockedByGriffTimeStamp(): number;
-    get alarmBlockedByGriff(): boolean;
-    constructor(mqttName: string, roomName: string, blueIrisName: string);
-    private _detectionsToday;
-    get detectionsToday(): number;
-    set detectionsToday(pVal: number);
-    private _movementDetected;
+    /** @inheritDoc */
+    get alarmBlockedByDevices(): boolean;
+    /** @inheritDoc */
     get movementDetected(): boolean;
-    private _info;
+    /** @inheritDoc */
     get info(): DeviceInfo;
-    set info(info: DeviceInfo);
-    /**
-     * Time since Last Motion in seconds
-     * @returns {number}
-     */
+    /** @inheritDoc */
     get timeSinceLastMotion(): number;
+    /** @inheritDoc */
     get customName(): string;
+    /** @inheritDoc */
     get id(): string;
+    /** @inheritDoc */
     get room(): RoomBase | undefined;
-    /**
-     * Adds a callback for when a motion state has changed.
-     * @param pCallback Function that accepts the new state as parameter
-     */
-    addMovementCallback(pCallback: (newState: boolean) => void): void;
-    onGriffUpdate(open: boolean): void;
+    /** @inheritDoc */
+    addMovementCallback(pCallback: (action: MotionSensorAction) => void): void;
+    /** @inheritDoc */
+    blockForDevice(device: iBaseDevice, block: boolean): void;
+    /** @inheritDoc */
     persistMotionSensor(): void;
+    /** @inheritDoc */
     update(idSplit: string[], state: ioBroker.State): void;
-    updateMovement(newState: boolean): void;
     log(level: LogLevel, message: string, debugType?: LogDebugType): void;
     toJSON(): Partial<iRoomDevice>;
     persistDeviceInfo(): void;
     loadDeviceSettings(): void;
+    private updateMovement;
     private resetPersonDetectFallbackTimer;
     private resetDogDetectFallbackTimer;
     private resetMovementFallbackTimer;